branch: externals/org
commit bbd008217d01d779b7d3401c6a9844170bce8a14
Author: Morgan Smith <[email protected]>
Commit: Ihor Radchenko <[email protected]>
org-tags-completion-function: Link to info page in docstring
* lisp/org.el (org-tags-completion-function): Add link to info page.
Also add FIXME to add property support.
---
lisp/org.el | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/lisp/org.el b/lisp/org.el
index 0da0388980..55351fe478 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -12261,9 +12261,15 @@ This works in the agenda, and also in an Org buffer."
(defun org-tags-completion-function (string _predicate &optional flag)
"Complete tag STRING.
+
+The format for tag string is described in the
+Info node `(org) Matching tags and properties'.
+
FLAG specifies the type of completion operation to perform. This
function is passed as a collection function to `completing-read',
which see."
+ ;; FIXME: This function is used to complete a tag string which can
+ ;; include properties but does not know anything about properties
(let ((completion-ignore-case nil) ;tags are case-sensitive
(confirm (lambda (x) (stringp (car x))))
(prefix "")
