From mboxrd@z Thu Jan 1 00:00:00 1970 From: Niall Dooley Subject: Question on org-agenda-custom-commands tags-todo match syntax Date: Sat, 12 Jan 2019 08:42:16 +0000 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="00000000000019a9fc057f3eccee" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:49540) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1giEsc-000056-0g for emacs-orgmode@gnu.org; Sat, 12 Jan 2019 03:42:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1giEsa-0006nR-2S for emacs-orgmode@gnu.org; Sat, 12 Jan 2019 03:42:57 -0500 Received: from mail-qk1-x72c.google.com ([2607:f8b0:4864:20::72c]:40897) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1giEsZ-0006lH-TI for emacs-orgmode@gnu.org; Sat, 12 Jan 2019 03:42:55 -0500 Received: by mail-qk1-x72c.google.com with SMTP id y16so7943727qki.7 for ; Sat, 12 Jan 2019 00:42:53 -0800 (PST) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org --00000000000019a9fc057f3eccee Content-Type: text/plain; charset="UTF-8" Firstly, I've searched online and even posted to both the emacs and orgmode subreddits but to no avail. Consider the following snippet: (setq org-agenda-custom-commands '(("p" "List Non-done projects" tags-todo "-CANCELLED+PROJECT/!+TODO"))) My understanding is that in the tags-todo match that entries to the left of the "/" are the tags, those to the right are the todo keywords and that you use a "+" to indicate a condition should be satisfied and a "-" when it should not be satisfied. Is this correct? So in the above snippet the search matches headlines with the tag :PROJECT: and not :CANCELLED: and a todo keyword of TODO. With this I have the following questions which I would appreciate if someone could answer. Is the "+" on the right hand side before the TODO strictly necessary? I've seen snippets which have it and others which do not. Perhaps it is only necessary between multiple todo keywords on the right hand side? What is the significance of the "!" on the right hand side? Should it always be present? Again, I've seen snippets with it present and others with it absent though it is present more often than not. Would it ever appear on the left hand side? Thank you. --00000000000019a9fc057f3eccee Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Firstly, I've searched online an= d even posted to both the emacs and orgmode
subreddits but to no = avail.

Consider the following snippet:
<= br>
(setq org-agenda-custom-commands
'(("p&quo= t; "List Non-done projects"
tags-todo "-CANCELLED+= PROJECT/!+TODO")))

My understanding is that i= n the tags-todo match that entries to the left of
the "/&quo= t; are the tags, those to the right are the todo keywords and that you
use a "+" to indicate a condition should be satisfied and a= "-" when it should
not be satisfied. Is this correct?<= /div>

So in the above snippet the search matches headlin= es with the tag :PROJECT:
and not :CANCELLED: and a todo keyword = of TODO. With this I have the following
questions which I would a= ppreciate if someone could answer.

Is the "+&= quot; on the right hand side before the TODO strictly necessary? I've
seen snippets which have it and others which do not. Perhaps it is= only
necessary between multiple todo keywords on the right hand = side?

What is the significance of the "!"= ; on the right hand side? Should it always
be present? Again, I&#= 39;ve seen snippets with it present and others with it
absent tho= ugh it is present more often than not. Would it ever appear on the left=C2= =A0
hand side?

Thank you.
--00000000000019a9fc057f3eccee--