>>> "IR" == Ihor Radchenko <yanta...@posteo.net> writes:

> Uwe Brauer <o...@mat.ucm.es> writes:
>> I recommend then to clarify this is in the manual: the expression in the 
>> manual is 
>> `("export")'

> What about the attached patch?

I added some lines, and run rediff and I hoper therefore the modified patch is 
ok.


Feel free to use it


-- 
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/
From f94d0c8dfa875983332dfe9432e6ec896c62bf59 Mon Sep 17 00:00:00 2001
Message-ID: <f94d0c8dfa875983332dfe9432e6ec896c62bf59.1698064304.git.yanta...@posteo.net>
From: Ihor Radchenko <yanta...@posteo.net>
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....@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

Attachment: smime.p7s
Description: S/MIME cryptographic signature

Reply via email to