From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jon Kristensen <info@jonkri.com>
Subject: Stuck projects documentation suggestion
Date: Sun, 13 Nov 2016 21:29:30 +0100
Message-ID: <787fc2d8-c1c3-217b-2cd5-ba81f8ce5590@jonkri.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47063)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <info@jonkri.com>) id 1c61PQ-0003yT-81
	for emacs-orgmode@gnu.org; Sun, 13 Nov 2016 15:29:49 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <info@jonkri.com>) id 1c61PM-0006kQ-9q
	for emacs-orgmode@gnu.org; Sun, 13 Nov 2016 15:29:48 -0500
Received: from mail.jonkri.se ([78.47.58.242]:44764 helo=jonkri.org)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <info@jonkri.com>) id 1c61PL-0006jy-WD
	for emacs-orgmode@gnu.org; Sun, 13 Nov 2016 15:29:44 -0500
Received: from 78-67-128-104-no247.tbcn.telia.com ([78.67.128.104]
	helo=localhost.localdomain)
	by jonkri.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
	(Exim 4.84_2) (envelope-from <info@jonkri.com>) id 1c61PD-00022f-Os
	for emacs-orgmode@gnu.org; Sun, 13 Nov 2016 21:29:35 +0100
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: <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: <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"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: emacs-orgmode@gnu.org

Hi!

Looking at http://orgmode.org/manual/Stuck-projects.html>, it wasn't 
clear to me that "+PROJECT/-MAYBE-DONE" was something called a "match 
syntax". If the documentation could be extended to include this 
information, and a link to the matching tags and properties page, it 
would be more understandable for new users. (Of course, it would also 
make the page more verbose, but I think the length of this page is short 
enough that it could probably be an acceptable trade-off.)

The docstring for "org-stuck-projects" does include a reference to the 
match syntax. (However, "C-h v" (describe variable) didn't work for 
"org-stuck-projects" for me until I loaded "org-agenda", which was 
surprising from my perspective as a newbie.)

All the best,
Jon