aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorCarsten Dominik2009-01-31 05:30:14 +0000
committerCarsten Dominik2009-01-31 05:30:14 +0000
commit2e461fc1b885396170036cba8f01f8c7cc34c054 (patch)
treea9482c8247184f34ce88ac335260713e877996a9 /doc/misc
parent6c817206c8f8b23f86da63bd21450c2cd22bb2b0 (diff)
downloademacs-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/ChangeLog5
-rw-r--r--doc/misc/org.texi20
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 @@
12009-01-31 Carsten Dominik <carsten.dominik@gmail.com>
2
3 * org.texi (TODO dependencies): Document TODO dependencies on
4 checkboxes.
5
12009-01-30 Carsten Dominik <dominik@science.uva.nl> 62009-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
3314The structure of Org files (hierarchy and lists) makes it easy to define TODO 3316The structure of Org files (hierarchy and lists) makes it easy to define TODO
3315dependencies. Usually, a parent TODO task should not be marked DONE until 3317dependencies. 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
3317there is a logical sequence to a number of (sub)tasks, so that one task 3319there is a logical sequence to a number of (sub)tasks, so that one task
3318cannot be acted upon before all siblings above it are done. If you customize 3320cannot be acted upon before all siblings above it are done. If you customize
3319the variable @code{org-enforce-todo-dependencies}, Org will block entries 3321the variable @code{org-enforce-todo-dependencies}, Org will block entries
3320from changing state while they have children that are not DONE. Furthermore, 3322from changing state to DONE while they have children that are not DONE.
3321if an entry has a property @code{ORDERED}, each of its children will be 3323Furthermore, if an entry has a property @code{ORDERED}, each of its children
3322blocked until all earlier siblings are marked DONE. Here is an example: 3324will be blocked until all earlier siblings are marked DONE. Here is an
3325example:
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
3341Toggle the @code{ORDERED} property of the current entry. 3344Toggle 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
3347Change TODO state, circumventin any state blocking.
3342@end table 3348@end table
3343 3349
3344If you set the variable @code{org-agenda-dim-blocked-tasks}, TODO entries 3350If you set the variable @code{org-agenda-dim-blocked-tasks}, TODO entries
3345that cannot be closed because of such dependencies will be shown in a dimmed 3351that cannot be closed because of such dependencies will be shown in a dimmed
3346font or even made invisible in agenda views (@pxref{Agenda Views}). 3352font or even made invisible in agenda views (@pxref{Agenda Views}).
3347 3353
3354@cindex checkboxes and TODO dependencies
3355You 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
3358checkboxes will be blocked from switching to DONE.
3359
3348If you need more complex dependency structures, for example dependencies 3360If you need more complex dependency structures, for example dependencies
3349between entries in different trees or files, check out the contributed 3361between entries in different trees or files, check out the contributed
3350module @file{org-depend.el}. 3362module @file{org-depend.el}.