From 5c6d1741519e02a3b9d2774faf511b0b90a4c788 Mon Sep 17 00:00:00 2001 Message-ID: <5c6d1741519e02a3b9d2774faf511b0b90a4c788.1698145210.git.yantar92@posteo.net> From: Ihor Radchenko Date: Mon, 23 Oct 2023 15:30:42 +0300 Subject: [PATCH v3] * 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 | 38 +++++++++++++++++++++++++++----------- 1 file changed, 27 insertions(+), 11 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index c0e9c8d7e..85568e7ab 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -12053,22 +12053,38 @@ ** 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, if present, 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. + + When selectively exporting files with =export= tags set, Org does + not export any text that appears before the first headline. + + Note that a file without the =export= tags will export all its + sections. + + 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 of tags that will be excluded from export. The default value is + ~org-export-exclude-tags~ =("noexport")=. 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