Add: org-ql-block-header

Closes #32.
This commit is contained in:
Adam Porter 2019-09-06 12:26:06 -05:00
parent 8a624bdf0d
commit eb722649c5
3 changed files with 25 additions and 13 deletions

View file

@ -270,7 +270,8 @@ For use as a custom agenda block type in ~org-agenda-custom-commands~. For exam
'(("ces" "Custom: Agenda and Emacs SOMEDAY [#A] items"
((org-ql-block '(and (todo "SOMEDAY")
(tags "Emacs")
(priority "A")))
(priority "A"))
((org-ql-block-header "SOMEDAY :Emacs: High-priority")))
(agenda)))))
#+END_SRC
@ -285,6 +286,8 @@ Which would be equivalent to a ~tags-todo~ search like this:
However, the ~org-ql-block~ version runs in about 1/5th the time.
The variable =org-ql-block-header= may be bound to a string to use as the block header, otherwise the header is formed automatically.
**** Macro: ~org-ql-agenda~
This macro is like ~org-ql~, but it presents matching entries in an Agenda-like view. It's compatible with [[https://github.com/alphapapa/org-super-agenda][org-super-agenda]], which provides grouping. For example:
@ -464,6 +467,7 @@ Expands into a call to ~org-ql-select~ with the same arguments. For convenience
- For inherited tags: =tags-inherited=, =inherited-tags=, =tags-i=, =itags=.
- For heading-local tags: =tags-local=, =local-tags=, =tags-l=, =ltags=.
- =tags-all=, =tags&=: Matches all given tags using boolean =AND= (rather than boolean =OR=, which the =tags= predicate uses).
+ Variable =org-ql-block-header=, which overrides the default header in =org-ql-block= agenda blocks.
*Changed*
+ Predicate =heading= now accepts multiple regexps.