From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id sGRbNSGlN2Xy+AAA9RJhRA:P1 (envelope-from ) for ; Tue, 24 Oct 2023 13:06:10 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id sGRbNSGlN2Xy+AAA9RJhRA (envelope-from ) for ; Tue, 24 Oct 2023 13:06:09 +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 4AD7B5D80A for ; Tue, 24 Oct 2023 13:06:09 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=pzlm9LHl; dmarc=pass (policy=none) header.from=posteo.net; 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" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1698145569; a=rsa-sha256; cv=none; b=uGUSyuCjHOfm5F7YFSMhUOPDxfaptVoYKng7i8hldSn3i2ziFKSX0zINFHdROHte4h2uVk 4kQnFMo2cSKCKD46vzwAd6C/EPvz6RO2POAPaNxsIZvczaGl5PPZDV+lAXju78BsolwPIV A1zTIEOcdZXJ+vWnLousMSdjkp/q0mcZW5wNHy61KLZDsgBoWtJLFn9i16ZAEjJFJnOv6k 2mkoXNp90/celS2XnkLAlHbv+Rbxg3rEgk+ywXs5u55kf54plWr3vT/hm4ahB3GoM9CZCV u/OCq2wpjSvEgCZ4G5QddF0IdddI7kdPxpD9Y7RI+tdevjkY95kc6mIoKYxU4g== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=pzlm9LHl; dmarc=pass (policy=none) header.from=posteo.net; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1698145569; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=3i8Q4Q4SnjvIrn8eLKKHsSDlWdQRV0ipcLNT8DM0ubM=; b=aUMMITyHSO0oG4QARWHhRAR1H+ra7vrUsV3VqDNyenVQrW/317nDtj/7MQ7ohVwUCxQMxR bpto4AS1elKlpH3JFR6xtXhW/9N22Hy4XXFlDS+sD62thDkDHmwTHYpad7r2fBc4cTrlFk GEEEaAIPizeo3EcoVlCUrieHLTKiAG4EhuGbscfu0BKC5DFex2THsUR1mrrRwo1zkiRXDM EQ3MrLtLshCZApTq3FxZ46rxPFKLjvw5CxnNK9sR743eaN5JoZNKI4pK6WSoU9JGmWuFNN qQya5a+hCoV9APAvEBMIKu4OUM3XTjrCAxrMcEzZhTyAP/hvBBZDTOmrKidpEg== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qvFDp-0002pY-Dz; Tue, 24 Oct 2023 07:05:17 -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 1qvFDj-0002oa-BW for emacs-orgmode@gnu.org; Tue, 24 Oct 2023 07:05:11 -0400 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qvFDb-0005Bs-Nm for emacs-orgmode@gnu.org; Tue, 24 Oct 2023 07:05:09 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id C8F19240028 for ; Tue, 24 Oct 2023 13:05:00 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1698145500; bh=Ip1tZWl+6ld+LdRlJoyYSh2QjrDVsWGw3G6G3dFKFIA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:From; b=pzlm9LHlAVO/RRYp1KW60iTlLt2xYCPfkw5gTNmCP89GytMTZH+9HTyCkTxUkK4m9 6q5RzZsFmXvCYrYAzSXgVgBpXTA8N19pmyAlrH1hSxdaBwJ133PxSVtMnIv39Bjead 3GhkkqC+wG9lvLjfgE9qd86GWYVIeusUzGT1YyWPdyy3DoQyGKzLfsQWG/JykWu1mI YyucgRN2j2/v4MCtHub3ewQGvxupmjXyZksXdD2QINJcY6mgz8pqXDhzcMX+bndNeq jUCdtEEuwXUvHre8rHHYnynpsx5pRzfrQWW+ggjmpVNiYjpx2GXWK+RjRB9ZrTox+z l0R4vm8sIDung== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4SF8ND1b5Jz6twL; Tue, 24 Oct 2023 13:05:00 +0200 (CEST) From: Ihor Radchenko To: Loris Bennett Cc: emacs-orgmode@gnu.org Subject: Re: the opposite of the noexport tag In-Reply-To: <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> <87y1fsicjb.fsf@zedat.fu-berlin.de> Date: Tue, 24 Oct 2023 11:06:44 +0000 Message-ID: <87bkco6zzv.fsf@localhost> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Scanner: mx1.migadu.com X-Migadu-Spam-Score: -9.34 X-Spam-Score: -9.34 X-Migadu-Queue-Id: 4AD7B5D80A X-TUID: 65N+qlWe4m2f --=-=-= Content-Type: text/plain "Loris Bennett" writes: >> + 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. What about List of tags that will, if present, 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. 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= tags will export all its sections. > 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 They are not exactly antonyms, because there is also the default behavior with neither export nor noexport tags. With "export" tags, everything but what is tagged "export" is dropped, including subtrees without "export" tag. With "noexport" tags, only the subtrees explicitly tagged "noexport" are dropped. The subtrees with no "noexport"/"export" tags will still be exported. As for EXPORT_... prefix, we do not use it, except in heading properties. It is by convention. In any case, I do not see a big problem with the current terminology. It is to late too change it, unless there is a stronger reason. >> + List o tags that will be excluded from export. The default value is > > There is an 'f' missing in > > List o tags Fixed New version of the patch attached. --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=v3-0001-doc-org-manual.org-Improve-documentation-for-SELE.patch >From 5c6d1741519e02a3b9d2774faf511b0b90a4c788 Mon Sep 17 00:00:00 2001 Message-ID: <5c6d1741519e02a3b9d2774faf511b0b90a4c788.1698145210.git.yantar92@posteo.net> From: Ihor Radchenko Date: Mon, 23 Oct 2023 15:30:42 +0300 Subject: [PATCH v3] * 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..85568e7ab 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, if present, 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. + + 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= tags 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 of 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 --=-=-= Content-Type: text/plain -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at --=-=-=--