emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Loris Bennett" <loris.bennett@fu-berlin.de>
To: emacs-orgmode@gnu.org
Subject: Re: the opposite of the noexport tag
Date: Mon, 23 Oct 2023 15:23:07 +0200	[thread overview]
Message-ID: <87fs21322s.fsf@zedat.fu-berlin.de> (raw)
In-Reply-To: 87lebtije9.fsf@mat.ucm.es

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



  reply	other threads:[~2023-10-23 13:24 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-10-22 15:23 the opposite of the noexport tag Uwe Brauer
2023-10-22 16:18 ` Bruno Barbier
2023-10-22 16:33   ` Uwe Brauer
2023-10-22 16:42     ` Ihor Radchenko
2023-10-22 17:03       ` Uwe Brauer
2023-10-22 17:22         ` Ihor Radchenko
2023-10-22 19:38           ` Uwe Brauer
2023-10-23  8:19             ` Ihor Radchenko
2023-10-23 12:16               ` Uwe Brauer
2023-10-23 12:32                 ` Ihor Radchenko
2023-10-23 12:34                   ` Uwe Brauer
2023-10-23 12:59                   ` Uwe Brauer
2023-10-23 13:23                     ` Loris Bennett [this message]
2023-10-24  9:01                     ` Ihor Radchenko
2023-10-24  9:40                       ` Loris Bennett
2023-10-24 11:06                         ` Ihor Radchenko
2023-10-25  8:27                           ` Ihor Radchenko
2023-10-24 12:22                       ` Uwe Brauer
2023-10-22 16:58     ` Bruno Barbier
2023-10-22 17:06       ` Uwe Brauer
2023-10-22 17:19         ` Bruno Barbier
2023-10-22 19:35           ` Uwe Brauer

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87fs21322s.fsf@zedat.fu-berlin.de \
    --to=loris.bennett@fu-berlin.de \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).