Documentation improvements

This commit is contained in:
Carsten Dominik 2009-03-06 17:57:41 +01:00
parent a6d10bc848
commit 071f87e143
1 changed files with 27 additions and 19 deletions

View File

@ -3116,13 +3116,14 @@ with @code{shift-selection-mode}.
@item C-c C-v @item C-c C-v
@itemx C-c / t @itemx C-c / t
@vindex org-todo-keywords @vindex org-todo-keywords
View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}). Folds View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}). Folds the
the entire buffer, but shows all TODO items and the headings hierarchy entire buffer, but shows all TODO items and the headings hierarchy above
above them. With a prefix argument, search for a specific TODO. You will be them. With a prefix argument, search for a specific TODO. You will be
prompted for the keyword, and you can also give a list of keywords like prompted for the keyword, and you can also give a list of keywords like
@code{KWD1|KWD2|...}. With numeric prefix argument N, show the tree for the @code{KWD1|KWD2|...} to list entries that match any one of these keywords.
Nth keyword in the variable @code{org-todo-keywords}. With two prefix With numeric prefix argument N, show the tree for the Nth keyword in the
arguments, find all TODO and DONE entries. variable @code{org-todo-keywords}. With two prefix arguments, find all TODO
and DONE entries.
@kindex C-c a t @kindex C-c a t
@item C-c a t @item C-c a t
Show the global TODO list. Collects the TODO items from all agenda Show the global TODO list. Collects the TODO items from all agenda
@ -4028,8 +4029,13 @@ only TODO items and force checking subitems (see variable
@code{org-tags-match-list-sublevels}). @code{org-tags-match-list-sublevels}).
@end table @end table
The syntax for matching tags is described in @ref{Matching tags and These commands all prompt for a match string which allows basic Boolean logic
properties}. like @samp{+boss+urgent-project1}, to find entries with tags @samp{boss} and
@samp{urgent}, but not @samp{project1}, or @samp{Kathy|Sally} to find entries
which are tagged @samp{Kathy} or @samp{Sally}. The full syntax of the search
string is rich and allows also matching against TODO keywords, entry levels
and properties. For a complete description with many examples, see
@ref{Matching tags and properties}.
@node Properties and Columns, Dates and Times, Tags, Top @node Properties and Columns, Dates and Times, Tags, Top
@ -4515,6 +4521,14 @@ instructions in front of the table - these will survive an update of the
block. If there is a @code{#+TBLFM:} after the table, the table will block. If there is a @code{#+TBLFM:} after the table, the table will
actually be recalculated automatically after an update. actually be recalculated automatically after an update.
An alternative way to capture and process property values into a table is
provided by Eric Schulte's @file{org-collector.el} which is a contributed
package@footnote{Contributed packages are not part of Emacs, but are
distributed with the main distribution of Org (see
@uref{http://orgmode.org}).}. It provides a general API to collect
properties from entries in a certain scope, and arbitrary Lisp expressions to
process these values before inserting them into a table or a dynamic block.
@node Property API, , Column view, Properties and Columns @node Property API, , Column view, Properties and Columns
@section The Property API @section The Property API
@cindex properties, API @cindex properties, API
@ -6012,13 +6026,11 @@ in an Org or Diary file.
@cindex @file{appt.el} @cindex @file{appt.el}
@cindex appointment reminders @cindex appointment reminders
Org can interact with Emacs appointments notification facility. Org can interact with Emacs appointments notification facility. To add all
the appointments of your agenda files, use the command
To add all the appointments of your agenda files, use the command @code{org-agenda-to-appt}. This commands also lets you filter through the
@code{org-agenda-to-appt}. This commands also lets you filter through list of your appointments and add only those belonging to a specific category
the list of your appointments and add only those belonging to a specific or matching a regular expression. See the docstring for details.
category or matching a regular expression. See the docstring for
details.
@node Global TODO list, Matching tags and properties, Weekly/daily agenda, Built-in agenda views @node Global TODO list, Matching tags and properties, Weekly/daily agenda, Built-in agenda views
@subsection The global TODO list @subsection The global TODO list
@ -7329,7 +7341,6 @@ For example, here is a Perl program that gets the TODO list from
Emacs/Org and prints all the items, preceded by a checkbox: Emacs/Org and prints all the items, preceded by a checkbox:
@example @example
@group
#!/usr/bin/perl #!/usr/bin/perl
# define the Emacs command to run # define the Emacs command to run
@ -7340,15 +7351,12 @@ $agenda = qx@{$cmd 2>/dev/null@};
# loop over all lines # loop over all lines
foreach $line (split(/\n/,$agenda)) @{ foreach $line (split(/\n/,$agenda)) @{
# get the individual values # get the individual values
($category,$head,$type,$todo,$tags,$date,$time,$extra, ($category,$head,$type,$todo,$tags,$date,$time,$extra,
$priority_l,$priority_n) = split(/,/,$line); $priority_l,$priority_n) = split(/,/,$line);
# process and print # process and print
print "[ ] $head\n"; print "[ ] $head\n";
@} @}
@end group
@end example @end example
@node Agenda column view, , Custom agenda views, Agenda Views @node Agenda column view, , Custom agenda views, Agenda Views