>>> "IR" == Ihor Radchenko writes: > Uwe Brauer writes: >> I recommend then to clarify this is in the manual: the expression in the manual is >> `("export")' > What about the attached patch? > 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. Thanks, this is better, but please give me some minutes and I will try to add my suggestions. > 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,22 +12053,31 @@ ** 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. 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")=. 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 -- Warning: Content may be disturbing to some audiences I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms. I strongly condemn Putin's war of aggression against Ukraine. I support to deliver weapons to Ukraine's military. I support the NATO membership of Ukraine. I support the EU membership of Ukraine. https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/