From mboxrd@z Thu Jan  1 00:00:00 1970
From: Antti Kaihola <akaihola@gmail.com>
Subject: [PATCH] documentation for clocktable :tags syntax
Date: Mon, 2 May 2011 09:58:27 +0300
Message-ID: <BANLkTi=N+u_L0mCXY95AsRg2r1RSC_i1Wg@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([140.186.70.92]:55375)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <akaihola@gmail.com>) id 1QGn5R-0004z1-Nt
	for emacs-orgmode@gnu.org; Mon, 02 May 2011 02:58:30 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <akaihola@gmail.com>) id 1QGn5R-0005Po-0n
	for emacs-orgmode@gnu.org; Mon, 02 May 2011 02:58:29 -0400
Received: from mail-fx0-f41.google.com ([209.85.161.41]:49770)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <akaihola@gmail.com>) id 1QGn5Q-0005PZ-RR
	for emacs-orgmode@gnu.org; Mon, 02 May 2011 02:58:28 -0400
Received: by fxm18 with SMTP id 18so4451534fxm.0
	for <emacs-orgmode@gnu.org>; Sun, 01 May 2011 23:58:27 -0700 (PDT)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: </archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: emacs-orgmode <emacs-orgmode@gnu.org>

After some trial and error I had to dig the mailing lists to figure
out the syntax of the :tags clock table option. I propose an addition
to the documentation along these lines:

diff --git a/doc/org.texi b/doc/org.texi
index 7142ce0..bec1123 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -5892,7 +5892,8 @@ be selected:
              @r{To use this, @code{:block} or @code{:tstart},
@code{:tend} are needed.}
 :stepskip0   @r{Do not show steps that have zero time.}
 :fileskip0   @r{Do not show table sections from files which did not
contribute.}
-:tags        @r{A tags match to select entries that should contribute}.
+:tags        @r{A tags match to select entries that should contribute.}
+             @r{See @ref{Matching tags and properties} for the match syntax.}
 @end example

 Then there are options which determine the formatting of the table.  There