From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id OHBAF0ORN2U1CQEA9RJhRA:P1 (envelope-from ) for ; Tue, 24 Oct 2023 11:41:23 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id OHBAF0ORN2U1CQEA9RJhRA (envelope-from ) for ; Tue, 24 Oct 2023 11:41:23 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D37F16C0D3 for ; Tue, 24 Oct 2023 11:41:22 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1698140483; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=4ckFFmVm1Zzl50cAYFQG5x8cD7/LREAp1tC6D6vLujg=; b=C2N2tNDkJBkPINSJ7LzYtXthyHZ8bkoxLJhU2y5NBWgNeFQGA5j45BffIUC2jdwOL6ri9H XpqA12Ch1iPXcrT08KfoBYCGTIT6w+qH02mEAvUO+dUio0B+uEb7oYCZHmCqSVwTT9l7+x JMw5RWOfWTY/r/HMK0Twc+0O4V7TeEpbe2cF8lO6QRZ+gaMmbnn11wlHjl/gmDGJNtnc2w 9C0XTHbvAe1XylZAr9mYFQcytLjmMa46aX+bUp5aaWB0q5BvKX8trpEuqUgPIUAr2PpAaO b3tw4iDSfOCKiPRSzjgdzvVGS/togVaQPQpeAg6CFq8qUXEP6aiBNHkpied/+A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1698140483; a=rsa-sha256; cv=none; b=HpGcxkrbcu3CCZjKvgpIIseuOJGBsRvXdZddcwc1mYNGy5gH/3yX/tY7CNCZv+hZtDQ0u2 jv0/cStJFQHum7SdxgPM4xux/1X44Koql6FZp9aK+I/QB+k61xYXAZX1X2SXkPQgYUCKQe ewcMWWQXreSxcvkCHIcoXTnU3F+x38O4au7Xq+ELKYbLrM+HA8rhsnq73ttQVBuAnBRSnm ju8RD6OwqDas5chXnDZScumfmV25VL7QqtjigS1DXcupzacqzjFWgwc30N+tpS82SeRZju qNBf7BzfQZAoleXra2h2p30zeMmhiVzmQU7J2noOySbvi+JAJrAQgLPtt6vygw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=none Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qvDtu-0006FZ-NJ; Tue, 24 Oct 2023 05:40:38 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qvDts-00061p-1E for emacs-orgmode@gnu.org; Tue, 24 Oct 2023 05:40:36 -0400 Received: from ciao.gmane.io ([116.202.254.214]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qvDtp-0000Qt-Vw for emacs-orgmode@gnu.org; Tue, 24 Oct 2023 05:40:35 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1qvDto-0003AU-28 for emacs-orgmode@gnu.org; Tue, 24 Oct 2023 11:40:32 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: "Loris Bennett" Subject: Re: the opposite of the noexport tag Date: Tue, 24 Oct 2023 11:40:24 +0200 Organization: ZEDAT, Freie =?utf-8?Q?Universit=C3=A4t?= Berlin Message-ID: <87y1fsicjb.fsf@zedat.fu-berlin.de> References: <87sf62lm03.fsf@mat.ucm.es> <65354b3c.df0a0220.36680.b681@mx.google.com> <87mswaboqy.fsf@mat.ucm.es> <87h6mia9se.fsf@localhost> <87pm16oahw.fsf@mat.ucm.es> <87edhma7xm.fsf@localhost> <878r7uo3bh.fsf@mat.ucm.es> <878r7tagzp.fsf@localhost> <87y1ftilf3.fsf@mat.ucm.es> <87il6x8qoy.fsf@localhost> <87lebtije9.fsf@mat.ucm.es> <871qdk8kd9.fsf@localhost> Mime-Version: 1.0 Content-Type: text/plain User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) Cancel-Lock: sha1:K+4VsAp7OSUbpHz8DlAB3Bs1310= Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: -15 X-Spam_score: -1.6 X-Spam_bar: - X-Spam_report: (-1.6 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.25, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Spam-Score: -5.62 X-Migadu-Queue-Id: D37F16C0D3 X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -5.62 X-TUID: 9OmNTqaCSqZF Ihor Radchenko writes: > Uwe Brauer 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? >> >> I added some lines, and run rediff and I hoper therefore the modified patch is ok. >> >> >> Feel free to use it >> + 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. > > I find this part confusing - we first talk about no "export" tags at all > and then immediately about using with "export" tags. I dropped it in the > attached patch. Maybe there is a better way to formulate the same? > > In the attached patch, I incorporated your other changes, the grammar > remarks from Loris, and reworded a bit more. > > From c82ec6139269cfc5dabf0e2e4d3601143843c782 Mon Sep 17 00:00:00 2001 > Message-ID: > From: Ihor Radchenko > Date: Mon, 23 Oct 2023 15:30:42 +0300 > Subject: [PATCH v2] * 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 | 38 +++++++++++++++++++++++++++----------- > 1 file changed, 27 insertions(+), 11 deletions(-) > > diff --git a/doc/org-manual.org b/doc/org-manual.org > index c0e9c8d7e..7e4553668 100644 > --- a/doc/org-manual.org > +++ b/doc/org-manual.org > @@ -12053,22 +12053,38 @@ ** 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 I find the emphasised 'only' confusing here, since it implies to me there the tags might have some other function. I would find, in analogy to the corresponding text regarding exclude tags, the following text better: List of tags that will be included in the export. I assume that 'only' was meant to imply that the list of tags is exclusive in the sense that no other tags will be exported. However, talking about an 'exclusive list' the context of what will be included in the export is probably not going to be helpful. Note that the keywords SELECT_TAGS and EXCLUDE_TAGS are not proper antonyms, which might be a possible source of confusion. I don't know how feasible it would be to replace (at least in the sense of an alias), these terms with, say, EXPORT_INCLUDE_TAGS EXPORT_EXCLUDE_TAGS > + 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. > + > + When selectively exporting files with =export= tags set, Org does > + not export any text that appears before the first headline. > + > + Note that a file without the =export= or the =noexport= tag will > + export all its sections. > + > + 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 There is an 'f' missing in List o tags (or an apostrophe in Pirate English). > + ~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 -- This signature is currently under constuction.