Add: (property) :inherit argument

This commit is contained in:
Adam Porter 2022-10-07 18:33:35 -05:00
parent e41cdb4591
commit e54ba0102c
3 changed files with 94 additions and 64 deletions

View file

@ -476,12 +476,13 @@ Arguments are listed next to predicate names, where applicable.
predicate (while Org itself considers items without a cookie to
have the default priority, which, by default, is equal to priority
B).
property (property &optional value)
property (property &optional value &key inherit)
Return non-nil if current entry has PROPERTY (a string), and
optionally VALUE (a string). Note that property inheritance is
currently _not_ enabled for this predicate. If you need to test
with inheritance, you could use a custom predicate form, like
(org-entry-get (point) "PROPERTY" 'inherit).
optionally VALUE (a string). If INHERIT is nil, only match
entries with PROPERTY set on the entry; if t, also match entries
with inheritance. If INHERIT is not specified, use the Boolean
value of org-use-property-inheritance, which see (i.e. it is
only interpreted as nil or non-nil).
regexp (&rest regexps)
Return non-nil if current entry matches all of REGEXPS (regexp
strings). Matches against entire entry, from beginning of its
@ -1034,6 +1035,10 @@ File: README.info, Node: 07-pre, Next: 062, Up: Changelog
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.
*Changed*
• Give more useful error message for invalid queries.
@ -1672,51 +1677,51 @@ Node: org-ql-sparse-tree8579
Node: Queries9379
Node: Non-sexp query syntax10496
Node: General predicates12255
Node: Ancestor/descendant predicates18997
Node: Date/time predicates20125
Node: Functions / Macros23249
Node: Agenda-like views23547
Ref: Function org-ql-block23709
Node: Listing / acting-on results24970
Ref: Caching25178
Ref: Function org-ql-select26091
Ref: Function org-ql-query28517
Ref: Macro org-ql (deprecated)30291
Node: Custom predicates30606
Ref: Macro org-ql-defpred30830
Node: Dynamic block34271
Node: Links36995
Node: Tips37682
Node: Changelog38006
Node: 07-pre38774
Node: 06240347
Node: 06140655
Node: 0641223
Node: 05244277
Node: 05144577
Node: 0545000
Node: 04946529
Node: 04846809
Node: 04747156
Node: 04647565
Node: 04547973
Node: 04448334
Node: 04348693
Node: 04248896
Node: 04149057
Node: 0449304
Node: 03253405
Node: 03153808
Node: 0354005
Node: 02357305
Node: 02257539
Node: 02157819
Node: 0258024
Node: 0162102
Node: Notes62203
Node: Comparison with Org Agenda searches62365
Node: org-sidebar63254
Node: License63533
Node: Ancestor/descendant predicates19085
Node: Date/time predicates20213
Node: Functions / Macros23337
Node: Agenda-like views23635
Ref: Function org-ql-block23797
Node: Listing / acting-on results25058
Ref: Caching25266
Ref: Function org-ql-select26179
Ref: Function org-ql-query28605
Ref: Macro org-ql (deprecated)30379
Node: Custom predicates30694
Ref: Macro org-ql-defpred30918
Node: Dynamic block34359
Node: Links37083
Node: Tips37770
Node: Changelog38094
Node: 07-pre38862
Node: 06240672
Node: 06140980
Node: 0641548
Node: 05244602
Node: 05144902
Node: 0545325
Node: 04946854
Node: 04847134
Node: 04747481
Node: 04647890
Node: 04548298
Node: 04448659
Node: 04349018
Node: 04249221
Node: 04149382
Node: 0449629
Node: 03253730
Node: 03154133
Node: 0354330
Node: 02357630
Node: 02257864
Node: 02158144
Node: 0258349
Node: 0162427
Node: Notes62528
Node: Comparison with Org Agenda searches62690
Node: org-sidebar63579
Node: License63858

End Tag Table