[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/misc org.texi
From: |
Carsten Dominik |
Subject: |
[Emacs-diffs] emacs/doc/misc org.texi |
Date: |
Wed, 28 Jan 2009 14:33:36 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Carsten Dominik <cdominik> 09/01/28 14:33:36
Modified files:
doc/misc : org.texi
Log message:
2009-01-28 Carsten Dominik <address@hidden>
* org.texi (TODO dependencies): New section.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/org.texi?cvsroot=emacs&r1=1.38&r2=1.39
Patches:
Index: org.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/org.texi,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -b -r1.38 -r1.39
--- org.texi 27 Jan 2009 18:19:36 -0000 1.38
+++ org.texi 28 Jan 2009 14:33:36 -0000 1.39
@@ -3,7 +3,7 @@
@setfilename ../../info/org
@settitle The Org Manual
address@hidden VERSION 6.19e
address@hidden VERSION 6.20c
@set DATE January 2009
@dircategory Emacs
@@ -181,6 +181,7 @@
* Fast access to TODO states:: Single letter selection of a state
* Per-file keywords:: Different files, different requirements
* Faces for TODO keywords:: Highlighting states
+* TODO dependencies:: When one tasks needs to wait for others
Progress logging
@@ -3100,6 +3101,7 @@
* Fast access to TODO states:: Single letter selection of a state
* Per-file keywords:: Different files, different requirements
* Faces for TODO keywords:: Highlighting states
+* TODO dependencies:: When one tasks needs to wait for others
@end menu
@node Workflow states, TODO types, TODO extensions, TODO extensions
@@ -3282,7 +3284,7 @@
cursor in a line starting with @samp{#+} is simply restarting Org mode
for the current buffer.}.
address@hidden Faces for TODO keywords, , Per-file keywords, TODO extensions
address@hidden Faces for TODO keywords, TODO dependencies, Per-file keywords,
TODO extensions
@subsection Faces for TODO keywords
@cindex faces, for TODO keywords
@@ -3306,6 +3308,41 @@
@emph{should} work, this does not aways seem to be the case. If
necessary, define a special face and use that.
address@hidden TODO dependencies, , Faces for TODO keywords, TODO extensions
address@hidden TODO dependencies
+
+The structure of Org files (hierarchy and lists) makes it easy to define TODO
+dependencies. Usually, a parent TODO task should not be marked DONE until
+all subtasks (defined as children tasks) are marked as DONE. And sometimes
+there is a logical sequence to a number of (sub)tasks, so that one task
+cannot be acted upon before all siblings above it are done. If you customize
+the variable @code{org-enforce-todo-dependencies}, Org will block entries
+from changing state while they have children that are not DONE. Furthermore,
+if an entry has a property @code{ORDERED}, each of its children will be
+blocked until all earlier siblings are marked DONE. Here is an example:
+
address@hidden
+* TODO Blocked until (two) is done
+** DONE one
+** TODO two
+
+* Parent
+ :PROPERTIES:
+ :ORDERED: t
+ :END:
+** TODO a
+** TODO b, needs to wait for (a)
+** TODO c, needs to wait for (a) and (b)
address@hidden example
+
+If you set the variable @code{org-agenda-dim-blocked-tasks}, TODO entries
+that cannot be closed because of such dependencies will be shown in a dimmed
+font or even made invisible in agenda views (@pxref{Agenda Views}).
+
+If you need more complex dependency structures, for example dependencies
+between entries in different trees or files, check out the contributed
+module @file{org-depend.el}.
+
@page
@node Progress logging, Priorities, TODO extensions, TODO Items
@section Progress logging
@@ -3564,13 +3601,12 @@
which is considered to be an intermediate state.
@kindex C-c C-x C-b
@item C-c C-x C-b
-Toggle checkbox at point.
+Toggle checkbox status or (with prefix arg) checkbox presence at point.
@itemize @minus
@item
If there is an active region, toggle the first checkbox in the region
-and set all remaining boxes to the same status as the first. If you
-want to toggle all boxes in the region independently, use a prefix
-argument.
+and set all remaining boxes to the same status as the first. With a prefix
+arg, add or remove the checkbox for all items in the region.
@item
If the cursor is in a headline, toggle checkboxes in the region between
this headline and the next (so @emph{not} the entire subtree).
@@ -10252,7 +10288,7 @@
A special thanks goes to @i{Bastien Guerry} who has not only written a large
number of extensions to Org (most of them integrated into the core by now),
but has also helped the development and maintenance of Org so much that he
-should be considered co-author of this package.
+should be considered the main co-contributor to this package.
Since the first release, literally thousands of emails to me or on
@code{emacs-orgmode@@gnu.org} have provided a constant stream of bug
@@ -10427,13 +10463,13 @@
system.
@item
@i{John Wiegley} wrote @file{emacs-wiki.el}, @file{planner.el}, and
address@hidden, which have similar goals as Org. Initially the
-development of Org was fully independent because I was not aware of the
-existence of these packages. But with time I have occasionally looked
-at John's code and learned a lot from it. John has also contributed a
-number of great ideas and patches directly to Org, including the attachment
-system (@file{org-attach.el}) and integration with Apple Mail
-(@file{org-mac-message.el}).
address@hidden, which have some overlap with Org. Initially the development
+of Org was fully independent because I was not aware of the existence of
+these packages. But with time I have occasionally looked at John's code and
+learned a lot from it. John has also contributed a number of great ideas and
+patches directly to Org, including the attachment system
+(@file{org-attach.el}), integration with Apple Mail
+(@file{org-mac-message.el}), and hierarchical dependencies of TODO items.
@item
@i{Carsten Wimmer} suggested some changes and helped fix a bug in
linking to Gnus.