Function: org-agenda-filter-by-top-headline

org-agenda-filter-by-top-headline is an interactive and byte-compiled function defined in org-agenda.el.gz.

Signature

(org-agenda-filter-by-top-headline STRIP)

Documentation

Keep only those lines that are descendants from the same top headline.

The top headline is that of the current line. With prefix arg STRIP, hide all lines of the category at point.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-agenda.el.gz
(defun org-agenda-filter-by-top-headline (strip)
  "Keep only those lines that are descendants from the same top headline.
The top headline is that of the current line.  With prefix arg STRIP, hide
all lines of the category at point."
  (interactive "P")
  (if org-agenda-filtered-by-top-headline
      (progn
        (setq org-agenda-filtered-by-top-headline nil
	      org-agenda-top-headline-filter nil)
        (org-agenda-filter-show-all-top-filter))
    (let ((toph (org-find-top-headline (org-get-at-bol 'org-hd-marker))))
      (if toph (org-agenda-filter-top-headline-apply toph strip)
        (error "No top-level headline at point")))))