From 8a5e54f1cc8aa87a52efe0beca85e778f264085d Mon Sep 17 00:00:00 2001 From: Nicolas Goaziou Date: Sun, 13 Nov 2016 18:08:15 +0100 Subject: [PATCH 1/2] Small fix to documentation * doc/org.texi (Setting tags): Remove misleading information. * lisp/org.el (org-tag-alist): Fix consistency with `org-tag-persistent-alist'. --- doc/org.texi | 18 ++++++++++++------ lisp/org.el | 12 ++++++------ 2 files changed, 18 insertions(+), 12 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 054d82c6d..98322ba5c 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -5055,14 +5055,15 @@ If at least one tag has a selection key then pressing @kbd{C-c C-c} will automatically present you with a special interface, listing inherited tags, the tags of the current headline, and a list of all valid tags with corresponding keys@footnote{Keys will automatically be assigned to tags which -have no configured keys.}. In this interface, you can use the following -keys: +have no configured keys.}. + +Pressing keys assigned to tags will add or remove them from the list of tags +in the current line. Selecting a tag in a group of mutually exclusive tags +will turn off any other tags from that group. + +In this interface, you can also use the following special keys: @table @kbd -@item a-zA-Z... -Pressing keys assigned to tags will add or remove them from the list of -tags in the current line. Selecting a tag in a group of mutually -exclusive tags will turn off any other tags from that group. @kindex @key{TAB} @item @key{TAB} Enter a tag in the minibuffer, even if the tag is not in the predefined @@ -5072,16 +5073,21 @@ You can also add several tags: just separate them with a comma. @kindex @key{SPC} @item @key{SPC} Clear all tags for this line. + @kindex @key{RET} @item @key{RET} Accept the modified set. + @item C-g Abort without installing changes. + @item q If @kbd{q} is not assigned to a tag, it aborts like @kbd{C-g}. + @item ! Turn off groups of mutually exclusive tags. Use this to (as an exception) assign several tags from such a group. + @item C-c Toggle auto-exit after the next change (see below). If you are using expert mode, the first @kbd{C-c} will display the diff --git a/lisp/org.el b/lisp/org.el index 1cac27650..b4f7ad258 100644 --- a/lisp/org.el +++ b/lisp/org.el @@ -3553,12 +3553,12 @@ The value of this variable is an alist. Associations either: (TAG . SELECT) (SPECIAL) -where TAG is a tag as a string, SELECT is a case-sensitive -letter, used to select that tag through the fast tag selection -interface, and SPECIAL is one of the following keywords: -`:startgroup', `:startgrouptag', `:grouptags', `:engroup', -`:endgrouptag' or `:newline'. These keywords are used to define -a hierarchy of tags. See manual for details. +where TAG is a tag as a string, SELECT is character, used to +select that tag through the fast tag selection interface, and +SPECIAL is one of the following keywords: `:startgroup', +`:startgrouptag', `:grouptags', `:engroup', `:endgrouptag' or +`:newline'. These keywords are used to define a hierarchy of +tags. See manual for details. When this variable is nil, Org mode bases tag input on what is already in the buffer. The value can be overridden locally by From 928e18dff9637314e2a5cce5f62be1e3b4971500 Mon Sep 17 00:00:00 2001 From: Nicolas Goaziou Date: Sun, 13 Nov 2016 18:10:25 +0100 Subject: [PATCH 2/2] org.texi: Fix typo * doc/org.texi (External links): Fix typo. --- doc/org.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/org.texi b/doc/org.texi index 98322ba5c..577e4a7b5 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -3551,7 +3551,7 @@ exact headline will be matched, ignoring spaces and cookies. If the value is @code{query-to-create}, then an exact headline will be searched; if it is not found, then the user will be queried to create it.} file:projects.org::*task title @r{heading search in Org -file}@footnote{ Headline searches always match the exact headline, ignoring +file}@footnote{Headline searches always match the exact headline, ignoring spaces and cookies. If the headline is not found and the value of the option @code{org-link-search-must-match-exact-headline} is @code{query-to-create}, then the user will be queried to create it.}