Org Ql Versions Save

Added

• Commands org-ql-find, org-ql-find-heading, and org-ql-find-path, which jump to entries selected using Emacs's built-in completion facilities and Org QL queries (like helm-org-ql, but doesn't require Helm.).
• Command org-ql-refile, which refiles the entry at point to one selected using Org QL completion.
• Predicate rifle, which matches an entry if each of the given arguments is found in either the entry's contents or its outline path. This provides very intuitive results, mimicing the behavior of org-rifle. In fact, the results are so useful that it's now the default predicate for plain-string query tokens. (It is also aliased to smart, since it's so "smart," and not all users have used org-rifle.)
• Option org-ql-default-predicate, applied to plain-string query tokens (before, the regexp predicate was always used, but now it may be customized).
• Alias c for predicate category.
• Predicate property now accepts the argument :inherit to match entries with property inheritance, and when unspecified, the option org-use-property-inheritance controls whether inheritance is used.
• Predicate blocked. (Thanks to Akira Komamura.)

Changed

• Give more useful error message for invalid queries.
• Predicate src now matches case-insensitively.
• Command org-ql-sparse-tree accepts both string and sexp queries. (Thanks to Akira Komamura.)

Fixed

• Predicate link matches links whose descriptions contain escaped brackets (changed in Org 9.3). (Thanks to Daniel Borchmann for reporting.)
• Predicate src's matching of begin/end block lines, normalization of arguments, and handling in non-sexp queries. (Thanks to Akira Komamura for reporting.)
• Predicate src's behavior with various arguments.
• Various compilation warnings.

Internal

• Certain query predicates, when called multiple times in an and sub-expression, are optimized to a single call.
• Use buffer-chars-modified-tick instead of buffer-modified-tick. (Thanks to Ihor Radchenko.)
• Implemented tests for src predicate.

Credits

• Thanks to Caleb Chase for help with #285, fixed in 9190818.

Note: The next release, 0.5, may include changes which will require minor updates to written queries (e.g. a few predicates may be renamed). Users who wish to avoid those changes happening unexpectedly in their configs should avoid upgrading org-ql beyond 0.4 automatically, as they will be pushed to the master branch when ready.

Added

• Commands
  • helm-org-ql-views, which shows one of org-ql-views selected with Helm.
  • org-ql-search can search files in org-directory; customization options are available in the org-ql-search group.
  • org-ql-view-refresh can be called with a prefix argument to adjust search parameters.
• Queries
  • Negation of terms in plain queries using !. For example, tags:space !moon to exclude entries which contain moon.
  • Predicates outline-path (alias olp) and outline-path-segment (alias olps).
  • Predicate src, which matches Org Babel source blocks.
  • Predicates parent and ancestors. (Thanks to Josh Moller-Mara.)
  • Alias h for heading predicate.
  • Alias r for regexp predicate. (Thanks to Feng Shu.)
• Info manual.
• Function helm-org-ql-source, which returns a Helm source that searches given buffers/files with helm-org-ql. It can be used for custom Helm commands that search certain files.
• Display a message when views are refreshed. (Thanks to xeijin.)
• Respect Org Agenda restriction in org-ql-block. (Thanks to Ihor Radchenko for reporting.)
• Option org-ql-view-sidebar-sort-views.
• Mouseover help-echo text for org-ql-views default view names.
• "Dangling tasks" default view in org-ql-views. (Users who have modified org-ql-views from the default will not see the new view unless they copy it into their config.)

Changed

• Some default org-ql-view views (users who have modified org-ql-views from the default will not see the new views unless they copy them into their config):
  • Rename some views.
  • "Stuck projects" view (now uses descendants instead of children, which is more useful.

Fixed

• Inherit file tags when org-tag-inheritance is enabled. (Fixes #55. Thanks to Mikhail Skorzhinskiy.)
• Call helm-make-source directly instead of using helm-build-sync-source macro. (Fixes #60. Thanks to Matt Huszagh for reporting.)
• Search/view buffers now always end with a newline, which prevents side-scrolling of the window when calling end-of-buffer.
• Face for done to-do keywords in org-ql-view buffers. (Thanks to Yiming Chen.)
• Make view buffers read-only. (Fixes #72. Thanks to xeijin.)
• Sorting with single sorter specified as an atom. (Thanks to Jeff Filipovits.)
• Autoload for org-ql-block agenda block. (Fixes #53. Thanks to reports from Gus Cantieni, Karl Voit, rieje, and Jake | Junxuan.)

Internal

• Added generic node data cache to speed up recursive, tree-based queries.