diff options
| author | Carsten Dominik <dominik@science.uva.nl> | 2009-01-31 05:30:14 +0000 |
|---|---|---|
| committer | Carsten Dominik <dominik@science.uva.nl> | 2009-01-31 05:30:14 +0000 |
| commit | 2e461fc1b885396170036cba8f01f8c7cc34c054 (patch) | |
| tree | a9482c8247184f34ce88ac335260713e877996a9 | |
| parent | 6c817206c8f8b23f86da63bd21450c2cd22bb2b0 (diff) | |
| download | emacs-2e461fc1b885396170036cba8f01f8c7cc34c054.tar.gz | |
2009-01-31 Carsten Dominik <carsten.dominik@gmail.com>
* org.texi (TODO dependencies): Document TODO dependencies on
checkboxes.
| -rw-r--r-- | doc/misc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/misc/org.texi | 20 |
2 files changed, 21 insertions, 4 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 6fb00d810f5..b552e5d3749 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,3 +1,8 @@ +2009-01-31 Carsten Dominik <carsten.dominik@gmail.com> + + * org.texi (TODO dependencies): Document TODO dependencies on + checkboxes. + 2009-01-30 Carsten Dominik <dominik@science.uva.nl> * org.texi (TODO dependencies): Document key binding for toggling diff --git a/doc/misc/org.texi b/doc/misc/org.texi index 113c22fd230..9f951bb7fc2 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi @@ -3,7 +3,7 @@ @setfilename ../../info/org @settitle The Org Manual -@set VERSION 6.20g +@set VERSION 6.20h @set DATE January 2009 @dircategory Emacs @@ -3310,6 +3310,8 @@ necessary, define a special face and use that. @node TODO dependencies, , Faces for TODO keywords, TODO extensions @subsection TODO dependencies +@cindex TODO dependencies +@cindex dependencies, of TODO states 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 @@ -3317,9 +3319,10 @@ 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: +from changing state to DONE 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: @example * TODO Blocked until (two) is done @@ -3339,12 +3342,21 @@ blocked until all earlier siblings are marked DONE. Here is an example: @kindex C-c C-x o @item C-c C-x o Toggle the @code{ORDERED} property of the current entry. +@kindex C-u C-u C-u C-c C-t +@item C-u C-u C-u C-c C-t +Change TODO state, circumventin any state blocking. @end table 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}). +@cindex checkboxes and TODO dependencies +You can also block changes of TODO states by looking at checkboxes +(@pxref{Checkboxes}). If you set the variable +@code{org-enforce-todo-checkbox-dependencies}, an entry that has unchecked +checkboxes will be blocked from switching to DONE. + 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}. |