0
0
Fork 1
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git synced 2024-08-26 23:02:52 +00:00
org-mode/doc
Carsten Dominik 2e73ce2177 Clarify that TODO matches only match not-DONE states by default
Bernt Hansen writes:

> I was talking to Jeff Stern about tags todo matching offlist and we
> think the documentation for tags-todo matching can probably be improved.
>
> The description of C-c a M at
> http://orgmode.org/manual/Matching-tags-and-properties.html
> states
>
> C-c a M
>
>    Like C-c a m, but only select headlines that are also TODO items and
>    force checking subitems (see variable
>    org-tags-match-list-sublevels). To exclude scheduled/deadline items,
>    see the variable org-agenda-tags-todo-honor-ignore-options. Matching
>    specific TODO keywords together with a tags match is also possible,
>    see Tag searches.
>
> When I read this I think TODO items is any todo keyword but this isn't
> the case.  It is only non-done TODO state keywords.  This makes
> tags-todo matching not work for finding tasks to archive (normally
> DONE | CANCELLED keywords in my setup)
>
> Should we explicitly state that 'headlines that are also TODO items'
> does not match DONE state keywords?  Or alternatively should TODO items
> and DONE items be separate (and explicitly defined) in the documentation
> -- like org-todo-keywords and org-done-keywords?
>
> I still think 'TODO keyword' matches any todo keyword defined in
> org-todo-keywords and maybe I need to be re-educated :)

Bernt is right, and this patch tries to clarify the issue.
2010-06-22 14:47:37 +02:00
..
.aspell.org.conf Track support files useful in checking Org documentation. 2008-04-01 15:59:35 +02:00
.nosearch Add .nosearch file to the doc/ subdirectory. 2008-12-17 17:25:31 +01:00
ChangeLog Add documentation for TaskJuggler export 2010-06-08 09:20:34 +02:00
dir Split out a number of files from org.el, and reorganize the 2008-03-28 09:57:14 +01:00
Documentation_Standards.org Fix some typos 2009-11-15 10:04:23 +01:00
org.texi Clarify that TODO matches only match not-DONE states by default 2010-06-22 14:47:37 +02:00
orgcard.tex Implement pretty display of sub- and superscripts. 2010-06-03 00:06:19 +02:00
orgguide.texi Free up the `C-c C-v' key for Org Babel 2010-05-12 08:04:27 +02:00
pdflayout.sty Change refcard processing to pdftex, using pdflayout.sty 2010-03-05 08:28:01 +01:00
texinfo.tex Split out a number of files from org.el, and reorganize the 2008-03-28 09:57:14 +01:00