diff options
author | Carsten Dominik <carsten.dominik@gmail.com> | 2010-07-22 09:11:12 +0200 |
---|---|---|
committer | Carsten Dominik <carsten.dominik@gmail.com> | 2010-07-22 09:11:12 +0200 |
commit | 22567f5ea0c79d39bfdc96b60956139bf3092b4c (patch) | |
tree | 5c476c25e0420ded19039b137aa57d890ba2a5e3 | |
parent | a9f0f3438829dec9653ddd1dfc8ecde1315ff518 (diff) | |
download | org-mode-22567f5ea0c79d39bfdc96b60956139bf3092b4c.tar.gz |
Agenda: Document the limitation of the filter preset
* lisp/org-agenda.el (org-agenda-filter-preset): Document the limitation
for the filter preset - it can only be used for an entire agenda view,
not in an individual block in a block agenda.
* doc/org.texi (Agenda commands): Document the limitation
for the filter preset - it can only be used for an entire agenda view,
not in an individual block in a block agenda.
-rw-r--r-- | doc/org.texi | 4 | ||||
-rw-r--r-- | lisp/org-agenda.el | 5 |
2 files changed, 7 insertions, 2 deletions
diff --git a/doc/org.texi b/doc/org.texi index 639abf1..e4135d0 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -7603,7 +7603,9 @@ very fast, so that you can switch quickly between different filters without having to recreate the agenda@footnote{Custom commands can preset a filter by binding the variable @code{org-agenda-filter-preset} as an option. This filter will then be applied to the view and persist as a basic filter through -refreshes and more secondary filtering.} +refreshes and more secondary filtering. The filter is a global property of +the entire agenda view - in a block agenda, you should only set this in the +global options section, not in the section of an individual block.} You will be prompted for a tag selection letter, SPC will mean any tag at all. Pressing @key{TAB} at that prompt will offer use completion to select a diff --git a/lisp/org-agenda.el b/lisp/org-agenda.el index b11b32d..bfb155f 100644 --- a/lisp/org-agenda.el +++ b/lisp/org-agenda.el @@ -2717,7 +2717,10 @@ removed from the entry content. Currently only `planning' is allowed here." This must be a list of strings, each string must be a single tag preceded by \"+\" or \"-\". This variable should not be set directly, but agenda custom commands can -bind it in the options section.") +bind it in the options section. The preset filter is a global property of +the entire agenda view. In a block agenda, it will not work reliably to +define a filter for one of the individual blocks. You need to set it in +the global options and expect it to be applied to the entire view.") (defun org-prepare-agenda (&optional name) (setq org-todo-keywords-for-agenda nil) |