diff options
| author | Carsten Dominik | 2009-01-31 05:30:14 +0000 |
|---|---|---|
| committer | Carsten Dominik | 2009-01-31 05:30:14 +0000 |
| commit | 2e461fc1b885396170036cba8f01f8c7cc34c054 (patch) | |
| tree | a9482c8247184f34ce88ac335260713e877996a9 /doc/misc | |
| parent | 6c817206c8f8b23f86da63bd21450c2cd22bb2b0 (diff) | |
| download | emacs-2e461fc1b885396170036cba8f01f8c7cc34c054.tar.gz emacs-2e461fc1b885396170036cba8f01f8c7cc34c054.zip | |
2009-01-31 Carsten Dominik <carsten.dominik@gmail.com>
* org.texi (TODO dependencies): Document TODO dependencies on
checkboxes.
Diffstat (limited to 'doc/misc')
| -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 @@ | |||
| 1 | 2009-01-31 Carsten Dominik <carsten.dominik@gmail.com> | ||
| 2 | |||
| 3 | * org.texi (TODO dependencies): Document TODO dependencies on | ||
| 4 | checkboxes. | ||
| 5 | |||
| 1 | 2009-01-30 Carsten Dominik <dominik@science.uva.nl> | 6 | 2009-01-30 Carsten Dominik <dominik@science.uva.nl> |
| 2 | 7 | ||
| 3 | * org.texi (TODO dependencies): Document key binding for toggling | 8 | * 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 @@ | |||
| 3 | @setfilename ../../info/org | 3 | @setfilename ../../info/org |
| 4 | @settitle The Org Manual | 4 | @settitle The Org Manual |
| 5 | 5 | ||
| 6 | @set VERSION 6.20g | 6 | @set VERSION 6.20h |
| 7 | @set DATE January 2009 | 7 | @set DATE January 2009 |
| 8 | 8 | ||
| 9 | @dircategory Emacs | 9 | @dircategory Emacs |
| @@ -3310,6 +3310,8 @@ necessary, define a special face and use that. | |||
| 3310 | 3310 | ||
| 3311 | @node TODO dependencies, , Faces for TODO keywords, TODO extensions | 3311 | @node TODO dependencies, , Faces for TODO keywords, TODO extensions |
| 3312 | @subsection TODO dependencies | 3312 | @subsection TODO dependencies |
| 3313 | @cindex TODO dependencies | ||
| 3314 | @cindex dependencies, of TODO states | ||
| 3313 | 3315 | ||
| 3314 | The structure of Org files (hierarchy and lists) makes it easy to define TODO | 3316 | The structure of Org files (hierarchy and lists) makes it easy to define TODO |
| 3315 | dependencies. Usually, a parent TODO task should not be marked DONE until | 3317 | 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 | |||
| 3317 | there is a logical sequence to a number of (sub)tasks, so that one task | 3319 | there is a logical sequence to a number of (sub)tasks, so that one task |
| 3318 | cannot be acted upon before all siblings above it are done. If you customize | 3320 | cannot be acted upon before all siblings above it are done. If you customize |
| 3319 | the variable @code{org-enforce-todo-dependencies}, Org will block entries | 3321 | the variable @code{org-enforce-todo-dependencies}, Org will block entries |
| 3320 | from changing state while they have children that are not DONE. Furthermore, | 3322 | from changing state to DONE while they have children that are not DONE. |
| 3321 | if an entry has a property @code{ORDERED}, each of its children will be | 3323 | Furthermore, if an entry has a property @code{ORDERED}, each of its children |
| 3322 | blocked until all earlier siblings are marked DONE. Here is an example: | 3324 | will be blocked until all earlier siblings are marked DONE. Here is an |
| 3325 | example: | ||
| 3323 | 3326 | ||
| 3324 | @example | 3327 | @example |
| 3325 | * TODO Blocked until (two) is done | 3328 | * TODO Blocked until (two) is done |
| @@ -3339,12 +3342,21 @@ blocked until all earlier siblings are marked DONE. Here is an example: | |||
| 3339 | @kindex C-c C-x o | 3342 | @kindex C-c C-x o |
| 3340 | @item C-c C-x o | 3343 | @item C-c C-x o |
| 3341 | Toggle the @code{ORDERED} property of the current entry. | 3344 | Toggle the @code{ORDERED} property of the current entry. |
| 3345 | @kindex C-u C-u C-u C-c C-t | ||
| 3346 | @item C-u C-u C-u C-c C-t | ||
| 3347 | Change TODO state, circumventin any state blocking. | ||
| 3342 | @end table | 3348 | @end table |
| 3343 | 3349 | ||
| 3344 | If you set the variable @code{org-agenda-dim-blocked-tasks}, TODO entries | 3350 | If you set the variable @code{org-agenda-dim-blocked-tasks}, TODO entries |
| 3345 | that cannot be closed because of such dependencies will be shown in a dimmed | 3351 | that cannot be closed because of such dependencies will be shown in a dimmed |
| 3346 | font or even made invisible in agenda views (@pxref{Agenda Views}). | 3352 | font or even made invisible in agenda views (@pxref{Agenda Views}). |
| 3347 | 3353 | ||
| 3354 | @cindex checkboxes and TODO dependencies | ||
| 3355 | You can also block changes of TODO states by looking at checkboxes | ||
| 3356 | (@pxref{Checkboxes}). If you set the variable | ||
| 3357 | @code{org-enforce-todo-checkbox-dependencies}, an entry that has unchecked | ||
| 3358 | checkboxes will be blocked from switching to DONE. | ||
| 3359 | |||
| 3348 | If you need more complex dependency structures, for example dependencies | 3360 | If you need more complex dependency structures, for example dependencies |
| 3349 | between entries in different trees or files, check out the contributed | 3361 | between entries in different trees or files, check out the contributed |
| 3350 | module @file{org-depend.el}. | 3362 | module @file{org-depend.el}. |