Function: org-match-sparse-tree

org-match-sparse-tree is an interactive and byte-compiled function defined in org.el.gz.

Signature

(org-match-sparse-tree &optional TODO-ONLY MATCH)

Documentation

Create a sparse tree according to tags string MATCH.

MATCH is a string with match syntax. It can contain a selection of tags ("+work+urgent-boss"), properties ("LEVEL>3"), and TODO keywords ("TODO=\\"WAITING\"") or a combination of those. See the manual for details.

If optional argument TODO-ONLY is non-nil, only select lines that are also TODO tasks.

Key Bindings

Aliases

org-tags-sparse-tree

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defun org-match-sparse-tree (&optional todo-only match)
  "Create a sparse tree according to tags string MATCH.

MATCH is a string with match syntax.  It can contain a selection
of tags (\"+work+urgent-boss\"), properties (\"LEVEL>3\"), and
TODO keywords (\"TODO=\\\"WAITING\\\"\") or a combination of
those.  See the manual for details.

If optional argument TODO-ONLY is non-nil, only select lines that
are also TODO tasks."
  (interactive "P")
  (org-agenda-prepare-buffers (list (current-buffer)))
  (let ((org--matcher-tags-todo-only todo-only))
    (org-scan-tags 'sparse-tree (cdr (org-make-tags-matcher match t))
		   org--matcher-tags-todo-only)))