From mboxrd@z Thu Jan  1 00:00:00 1970
From: Bernt Hansen <bernt@norang.ca>
Subject: Confusion about tags-todo matches and TODO keywords
Date: Mon, 21 Jun 2010 19:39:38 -0400
Message-ID: <87fx0ggdl1.fsf@gollum.intra.norang.ca>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from [140.186.70.92] (port=36303 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1OQqap-0007gp-4p
	for emacs-orgmode@gnu.org; Mon, 21 Jun 2010 19:39:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69)
	(envelope-from <bernt@norang.ca>) id 1OQqan-0007vE-TS
	for emacs-orgmode@gnu.org; Mon, 21 Jun 2010 19:39:55 -0400
Received: from mho-01-ewr.mailhop.org ([204.13.248.71]:53967)
	by eggs.gnu.org with esmtp (Exim 4.69)
	(envelope-from <bernt@norang.ca>) id 1OQqan-0007uo-Qy
	for emacs-orgmode@gnu.org; Mon, 21 Jun 2010 19:39:53 -0400
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Carsten Dominik <carsten@orgmode.org>
Cc: emacs-orgmode@gnu.org, jeff stern <jas@uci.edu>

Hi Carsten,

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 :)

Thanks,
Bernt