Releases: alphapapa/org-ql
Releases · alphapapa/org-ql
v0.8
Additions
- Function
org-ql-completing-read
, used by commandorg-ql-find
, now specifies the completion category asorg-heading
, providing compatibility with Embark. (This is a powerful feature, as it means anyorg-ql-find
result can be acted on from inside the search results with Embark, which provides common actions from Org Agenda and Org speed keys bindings.) (#299. Thanks to Omar Antolín Camarena, Daniel Mendler, and Akira Komamura.)- Command
org-ql-completing-read-export
, bound toC-c C-e
orembark-export
while in anorg-ql-completing-read
session, exits and shows anorg-ql-view
buffer for the current search.
- Command
- Command
org-ql-find
may be called in anorg-agenda
ororg-ql-view
buffer to search the buffers which contributed to the agenda/view buffer. - Command
org-ql-find-path
, which searches outline paths in the current buffer. - Command
org-ql-open-link
, which finds links in entries matching the given query, and opens the selected one withorg-open-at-point
. (This is helpful when a collection of links are kept in Org files: rather than having to first visit the entry containing the desired link, then locate it within the entry, and then open it, the user can simply select the link and open it directly.) - Items in
org-ql-view
buffers now include theorg-category
text property, like Org Agenda buffers, which allows grouping withorg-super-agenda
's category-related selectors. (#363. Thanks to Gabriele Mongiano for reporting.)
Fixes
- Predicate
property
correctly uses the value oforg-use-property-inheritance
when not specified. (#346, #356. Thanks to Bram Schoenmakers.)
Compatibility
- Emacs 27.1 or later is now required.
- Org v9.7's
org-element
API changes required some adjustments. (#364. Thanks to several users for reporting, and to Ihor Radchenko for his feedback.)
v0.7.3
Fixes
- Disable
case-fold-search
when collecting headings in outline paths. (Headings that started with a word that is also a to-do keyword but with different capitalization would be matched incorrectly.) - Saving of
org-ql-view
views. (#378. Thanks to Pentaquark1 for reporting.) - Command
org-ql-find
didn't move point to the selected entry. (#380. Thanks to Omar Antolín Camarena for reporting.)
v0.7.2
Fixes
- Timestamp predicates are more tolerant of partial input (e.g. preventing errors while the user is typing a query into
org-ql-find
). - Query parser ignores leading whitespace (e.g. preventing errors while the user is typing a query into
org-ql-find
). - Use of
org-ql-find
with:query-prefix
argument prevented selection of results. (#351. Thanks to Daniel Fleischer for reporting.) - Handle narrowed buffers correctly in
org-ql-find
. - Warn about empty headings in
org-ql-completing-read
(the Org format allows a heading line to have no text, but it's useless for this purpose, and usually indicates unnoticed corruption).
v0.7.1
Fixes
- Function
org-ql-completing-read
is more compatible with default Emacs completion. (See #338. Thanks to arozbiz for reporting.) - Function
org-ql-completing-read
would sometimes stop updating with changes in input. (See #350. Thanks to Ankit Raj Pandey for reporting and fixing, and to Daniel Mendler for advising.) - In
org-ql-completing-read
, format links for display, and useorg-entry-get
internally rather thanorg-get-heading
.
v0.7
Added
- Commands
org-ql-find
,org-ql-find-heading
, andorg-ql-find-path
, which jump to entries selected using Emacs's built-in completion facilities and Org QL queries (likehelm-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 oforg-rifle
. In fact, the results are so useful that it's now the default predicate for plain-string query tokens. (It is also aliased tosmart
, since it's so "smart," and not all users have usedorg-rifle
.) - Option
org-ql-default-predicate
, applied to plain-string query tokens (before, theregexp
predicate was always used, but now it may be customized). - Alias
c
for predicatecategory
. - Predicate
property
now accepts the argument:inherit
to match entries with property inheritance, and when unspecified, the optionorg-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 ofbuffer-modified-tick
. (Thanks to Ihor Radchenko.) - Implemented tests for
src
predicate.
Credits
- Thanks to Caleb Chase for help with #285, fixed in 9190818.