This is the official manual for the latest Org-mode release.
An important feature of Org mode is the ability to construct sparse trees for selected information in an outline tree, so that the entire document is folded as much as possible, but the selected information is made visible along with the headline structure above it1. Just try it out and you will see immediately how it works.
Org mode contains several commands creating such trees, all these commands can be accessed through a dispatcher:
org-sparse-tree
)org-occur
)next-error
)previous-error
)For frequently used sparse trees of specific search strings, you can
use the option org-agenda-custom-commands
to define fast
keyboard access to specific sparse trees. These commands will then be
accessible through the agenda dispatcher (see Agenda dispatcher).
For example:
(setq org-agenda-custom-commands '(("f" occur-tree "FIXME")))
will define the key C-c a f as a shortcut for creating a sparse tree matching the string ‘FIXME’.
The other sparse tree commands select headings based on TODO keywords, tags, or properties and will be discussed later in this manual.
To print a sparse tree, you can use the Emacs command
ps-print-buffer-with-faces
which does not print invisible parts
of the document 3.
Or you can use C-c C-e C-v to export only the visible part of
the document and print the resulting file.
[1] See also the
variables org-show-hierarchy-above
, org-show-following-heading
,
org-show-siblings
, and org-show-entry-below
for detailed
control on how much context is shown around each match.
[2] This depends on the option
org-remove-highlights-with-change
[3] This does not work under XEmacs, because XEmacs uses selective display for outlining, not text properties.