From: "Gustav Wikström" <gustav.erik@gmail.com>
To: Bastien <bzg@gnu.org>
Cc: Org Mode List <emacs-orgmode@gnu.org>
Subject: Re: "Special Properties" when matching for Properties in a search
Date: Wed, 3 Jul 2013 21:10:52 +0200 [thread overview]
Message-ID: <CA+SyOP-JZWumohs40R8OHZsYAEPp+wD-eoNUe5X0GXJJN_-t=g@mail.gmail.com> (raw)
In-Reply-To: <8761wvp6j4.fsf@bzg.ath.cx>
[-- Attachment #1: Type: text/plain, Size: 1019 bytes --]
Ok thanks!
As I brought this up, I might just as well provide a way of clarifying
this for the manual.
On Mon, Jul 1, 2013 at 12:04 AM, Bastien <bzg@gnu.org> wrote:
> Hi Gustav,
>
> Gustav Wikström <gustav.erik@gmail.com> writes:
>
>> When matching for tags and properties using C-c / m there is the
>> option to match for Special Properties. Is there a complete list of
>> these special properties somewhere?
>>
>> I was thinking that "7.2 Special Properties" in the manual would be
>> that list, but then noticed a property possible to use for searches,
>> but not available in that list (the LEVEL-property). Is that property
>> just missing from there?
>
> Mhhh... no, AFAIK the "LEVEL" property is a special-special property:
> you can use it in search constructs, but not in column view (which is
> the primary context for the 7.2 manual section.)
>
> But I'd say that's the only property missing here. I'm short of good
> ideas on how to improve the manual here.
>
> --
> Bastien
[-- Attachment #2: manual-diff.txt --]
[-- Type: text/plain, Size: 1695 bytes --]
Modified doc/org.texi
diff --git a/doc/org.texi b/doc/org.texi
index 5f50ef6..64553e1 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -8045,15 +8045,18 @@ You may also test for properties (@pxref{Properties and Columns}) at the same
time as matching tags. The properties may be real properties, or special
properties that represent other metadata (@pxref{Special properties}). For
example, the ``property'' @code{TODO} represents the TODO keyword of the
-entry. Or, the ``property'' @code{LEVEL} represents the level of an entry.
-So a search @samp{+LEVEL=3+boss-TODO="DONE"} lists all level three headlines
-that have the tag @samp{boss} and are @emph{not} marked with the TODO keyword
-DONE@. In buffers with @code{org-odd-levels-only} set, @samp{LEVEL} does not
-count the number of stars, but @samp{LEVEL=2} will correspond to 3 stars etc.
-The ITEM special property cannot currently be used in tags/property
+entry and the ``propety'' @code{PRIORITY} represents the PRIORITY keyword of
+the entry. The ITEM special property cannot currently be used in tags/property
searches@footnote{But @pxref{x-agenda-skip-entry-regexp,
,skipping entries based on regexp}.}.
+Except the @pxref{Special properties}, one other ``property'' can also be
+used. @code{LEVEL} represents the level of an entry. So a search
+@samp{+LEVEL=3+boss-TODO="DONE"} lists all level three headlines that have
+the tag @samp{boss} and are @emph{not} marked with the TODO keyword DONE@.
+In buffers with @code{org-odd-levels-only} set, @samp{LEVEL} does not count
+the number of stars, but @samp{LEVEL=2} will correspond to 3 stars etc.
+
Here are more examples:
@table @samp
next prev parent reply other threads:[~2013-07-03 19:11 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-06-30 15:00 "Special Properties" when matching for Properties in a search Gustav Wikström
2013-06-30 22:04 ` Bastien
2013-07-03 19:10 ` Gustav Wikström [this message]
2013-07-03 23:36 ` Bastien
2013-06-30 22:25 ` Nick Dokos
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CA+SyOP-JZWumohs40R8OHZsYAEPp+wD-eoNUe5X0GXJJN_-t=g@mail.gmail.com' \
--to=gustav.erik@gmail.com \
--cc=bzg@gnu.org \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).