From f94d0c8dfa875983332dfe9432e6ec896c62bf59 Mon Sep 17 00:00:00 2001 Message-ID: From: Ihor Radchenko Date: Mon, 23 Oct 2023 15:30:42 +0300 Subject: [PATCH] * doc/org-manual.org: Improve documentation for #+SELECT_TAGS and #+EXCLUDE_TAGS (Export Settings): Clarify how to define multiple tags per-document. Reword. Link: https://orgmode.org/list/87y1ftilf3.fsf@mat.ucm.es --- doc/org-manual.org | 31 ++++++++++++++++++++----------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index c0e9c8d7e..29845f309 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -12053,23 +12053,37 @@ ** Export Settings #+cindex: @samp{SELECT_TAGS}, keyword #+vindex: org-export-select-tags - The default value is =("export")=. When a tree is tagged with - =export= (~org-export-select-tags~), Org selects that tree and its - subtrees for export. Org excludes trees with =noexport= tags, see - below. When selectively exporting files with =export= tags set, Org - does not export any text that appears before the first headline. + List of tags that will *only* be selected for export. The default + value is ~org-export-select-tags~ =("export")=. When a tree is + tagged with =export=, Org selects that tree and its subtrees for + export, ignoring all the other sections, that do not possess the + =export= tag. + Please recall, that a file without the =export= or the =noexport= + tag will export all its sections. + When selectively exporting files with =export= tags set, + Org does not export any text that appears before the first headline. + + To select non-default tags for export, customize + ~org-export-select-tags~ (globally) or add + =#+SELECT_TAGS: tag1 tag2= to the document. - =EXCLUDE_TAGS= :: #+cindex: @samp{EXCLUDE_TAGS}, keyword #+vindex: org-export-exclude-tags - The default value is =("noexport")=. When a tree is tagged with - =noexport= (~org-export-exclude-tags~), Org excludes that tree and - its subtrees from export. Entries tagged with =noexport= are - unconditionally excluded from the export, even if they have an - =export= tag. Even if a subtree is not exported, Org executes any - code blocks contained there. + List o tags that will be excluded from export. The default value is + ~org-export-exclude-tags~ =("noexport")=. + This tag is useful, if the =export= tag is not used on other sections. + When a tree is tagged + with =noexport=, Org excludes that tree and its subtrees from + export. Entries tagged with =noexport= are unconditionally excluded + from the export, even if they have an =export= tag. Even if a + subtree is not exported, Org executes any code blocks contained + there. + + To select non-default tags for the exclusion, customize + ~org-export-exclude-tags~ (globally) or add =#+EXCLUDE_TAGS: tag1 + tag2= to the document. - =TITLE= :: -- 2.42.0