Re: the opposite of the noexport tag

[Loris Bennett]

Hi,

Below are some minor comma niggles.

Cheers,

Loris

Uwe Brauer <oub@mat.ucm.es> writes:

>>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
>
>> Uwe Brauer <oub@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.yantar92@posteo.net>
> From: Ihor Radchenko <yantar92@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: 87y1ftilf3.fsf@mat.ucm.es">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

No comma between 'sections' and 'that'.  English does not have a comma
before a restrictive relative pronoun.

> +  =export= tag.
> +  Please recall, that a file without the =export= or the  =noexport=

No comma between 'recall' and 'that'.  English does not have comma after
'that' used as a conjunction.

> +  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.

No comma between 'useful' and 'if.  The comma is usually only placed
between the clauses when the if-clause precedes the main clause.

> +  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= ::

-- 
This signature is currently under constuction.