emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Uwe Brauer <oub@mat.ucm.es>
To: Ihor Radchenko <yantar92@posteo.net>
Cc: Uwe Brauer <oub@mat.ucm.es>, emacs-orgmode@gnu.org
Subject: Re: the opposite of the noexport tag
Date: Mon, 23 Oct 2023 14:34:24 +0200	[thread overview]
Message-ID: <87sf61ikkv.fsf@mat.ucm.es> (raw)
In-Reply-To: 87il6x8qoy.fsf@localhost

[-- Attachment #1: Type: text/plain, Size: 3735 bytes --]

>>> "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?

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


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/

[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]

  reply	other threads:[~2023-10-23 12:59 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 [this message]
2023-10-23 12:59                   ` Uwe Brauer
2023-10-23 13:23                     ` Loris Bennett
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=87sf61ikkv.fsf@mat.ucm.es \
    --to=oub@mat.ucm.es \
    --cc=emacs-orgmode@gnu.org \
    --cc=yantar92@posteo.net \
    /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).