From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 4AgcLR1YMmPdRwAAbAwnHQ (envelope-from ) for ; Tue, 27 Sep 2022 03:55:41 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 8AsiLR1YMmNSTwEAauVa8A (envelope-from ) for ; Tue, 27 Sep 2022 03:55:41 +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 6CCDE17DE5 for ; Tue, 27 Sep 2022 03:55:41 +0200 (CEST) Received: from localhost ([::1]:40234 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oczoy-0000xf-4j for larch@yhetil.org; Mon, 26 Sep 2022 21:55:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38626) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oczo2-0000xR-8b for emacs-orgmode@gnu.org; Mon, 26 Sep 2022 21:54:43 -0400 Received: from mail-pf1-x429.google.com ([2607:f8b0:4864:20::429]:41774) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oczo0-0007JW-7s for emacs-orgmode@gnu.org; Mon, 26 Sep 2022 21:54:41 -0400 Received: by mail-pf1-x429.google.com with SMTP id l65so8388086pfl.8 for ; Mon, 26 Sep 2022 18:54:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date; bh=iY4ZUsx+mLJUN2L0QDrmN33b+QZUsKZrC/70EW+Q3so=; b=av51J/AXdS4CiGPSOj7XdgK/dCPhxDvlLUU+YbpjHx9R+8+AKD2pGBtrSE2C0zEZJN avDVwdMZ/HFqW9pTFfbOee5e+mH5OXf0Fw5h9zSqLZllPKdt+ydz1+KuDRV0svDIhOD0 CTfOfLjDkDmQRSxm3Wb9b6oOeJcjKCIge3MCtSI+5BfGd6Ca6C7dlI3IHs4xPIIFomXD UJGvd66W0vmVg1xQrz3XRb4T3PTz1RXj1k9m9bEtyzU38SrsVzGJUkyuarUMYv1x6ICX 3Wd0mWIQS6ixFUs6W4iKXyYGQmblqC6OotT5TdsHWiKZsKRnCCu5cLyhJ6jt6XtK9nSc Y2Lw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date; bh=iY4ZUsx+mLJUN2L0QDrmN33b+QZUsKZrC/70EW+Q3so=; b=XrDVlEMJQLjRmRgCoa+BqHJSBUKth6V0TycdRL0b4J0VXY+9ydY9ALaHUqILIBS0O8 iF7h9i494iCZHSc+5V+lp3VUrkfgQhfxYuHRxlM8cnraCtSFBrFxgP5qlXTxC0XRYzL9 oJaV8cmzLqoHqgzYa18F+55ajtdXQ9lkOWZmmZw/Msj/r+4BLLg05uqKEyR70hjVABDS JHue0py5j6gzqAveH15JyWATDnDvRjt3Sxx3dOfXvzDaTg6605OZ7I8p5UoMt96PmWUO r/DlK95+g88l/OIws3u34ceF4aAjOgOmBkvfZY1qRLNW1s5o91eaPldYnXUZ90MQdowP U5Nw== X-Gm-Message-State: ACrzQf2HaFXf3w4bREPdkCfCSmqeti6/g4b0ruqAIRdjQo2Dh89rwg4P Tg2ZtDheRaVk++VbHRHaEaI= X-Google-Smtp-Source: AMsMyM7jERdRz/UtvJPRmT0qRkO56Ao7wpwCN8LNofSkAYe/sDZDfBdIQmFsn6qQtHujSkYzpm1EpQ== X-Received: by 2002:a63:ff50:0:b0:439:ae51:503c with SMTP id s16-20020a63ff50000000b00439ae51503cmr22768034pgk.158.1664243678755; Mon, 26 Sep 2022 18:54:38 -0700 (PDT) Received: from localhost ([115.154.175.57]) by smtp.gmail.com with ESMTPSA id c34-20020a17090a492500b002006428f01esm5305204pjh.55.2022.09.26.18.54.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Sep 2022 18:54:38 -0700 (PDT) From: Ihor Radchenko To: alain.cochard@unistra.fr Cc: emacs-orgmode@gnu.org Subject: Re: Confused about what the COMMENT keyword means In-Reply-To: <25393.61240.135445.401251@gargle.gargle.HOWL> References: <25393.61240.135445.401251@gargle.gargle.HOWL> Date: Tue, 27 Sep 2022 09:55:31 +0800 Message-ID: <87leq5pomk.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::429; envelope-from=yantar92@gmail.com; helo=mail-pf1-x429.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 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, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1664243741; 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: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=iY4ZUsx+mLJUN2L0QDrmN33b+QZUsKZrC/70EW+Q3so=; b=mb/z9ibi7pbXk7OxEv/bd7uVrndfnTNStfpux7xf3wd+I1wnJm22+Xddni9JHXvJEKYXtj eg0Vo9YDEDmre65NwONAaZBxdmYFSUfabftvNQJkFPg9kNKNsuc0HPtphGTqaYfH3ul0aa 0ss2UfTXRCEqEiQFichlnQWXnsJYAg3hhZ3Twix4odxfYUU4VNa1M4Ur/hgQ+WlJjpLH3w VLm2JvCQXVG9fHJ6IFg7TUk9Ii+YtJSwjfXvs7plGMwUWXcjVXEc1hhanrqgCkjiM9wYEH U1HzXsZcRFvVjQL5lZhKlQq0xL0HJVBIpF5//xJ9xxKRvGfPlZkmnL16FyNNEA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664243741; a=rsa-sha256; cv=none; b=p4Js3v03KkW0pbRze9+c0Y6WF/oWiznxN0Rt3/JlprNLk+foQE+MKVdMYMitz5SEbjuqKx KdFzdIOC56pVCRGFb8fHM/QVimo4H/OyJVg92nTw8SyQdTeZU7ca+EUqi4QmIhYhkfzidP hNeFC2UW7N+xZDuj/QS3CGYONAPZzCHaQpzIz6PNXhW6ZhEaHrO5T5NqgSVkzv4AHeWYal 8w9fKrDTXqfCpnDOtwmlSKJ/fda3unAuwcrMQz1NBemhpolmm/vyQFxNfEpi1UUKSn1dbw uXEhpm9QFyh0HV7QJ79UrbYYpEOnmHWCHMrugg0nreBBj84pPd0jpYERa9T+Vw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="av51J/AX"; dmarc=pass (policy=none) header.from=gmail.com; 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" X-Migadu-Spam-Score: -1.84 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="av51J/AX"; dmarc=pass (policy=none) header.from=gmail.com; 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" X-Migadu-Queue-Id: 6CCDE17DE5 X-Spam-Score: -1.84 X-Migadu-Scanner: scn1.migadu.com X-TUID: PhLAerNnJM+J Alain.Cochard@unistra.fr writes: > Hello. I have the file: > > * COMMENT foo > #+EXPORT_FILE_NAME: foo.pdf > #+TITLE: foot > fofoo > * bar > #+EXPORT_FILE_NAME: bar.pdf > #+TITLE: bart > babar #+EXPORT_FILE_NAME is an in-buffer export setting with global effect. According to 13.2 Export Settings section of the Org manual, In-buffer settings may appear anywhere in the file, either directly or indirectly through a file included using =E2=80=98#+SETUPFILE: filen= ame or URL=E2=80=99 syntax. Because export settings are global, they have higher priority over the COMMENTed heading. Further, you have two instances of the #+EXPORT_FILE_NAME in your buffer. The behaviour of Org is undefined in such scenario, but the current implementation detail makes Org use the first instance found in the file during export. Do note that usage of #+EXPORT_FILE_NAME and #+TITLE like in your example is erroneous - they do not apply to their subtrees. Please use heading properties instead for the desired effect. > By contrast, with this file >=20 > # * foo > # #+EXPORT_FILE_NAME: foo.pdf > # #+TITLE: foot > # fofoo > * bar > #+EXPORT_FILE_NAME: bar.pdf > #+TITLE: bart > babar This file contains no export settings. # #+EXPORT_FILE_NAME: foo.pdf line is not an export setting. It does not matter that it is a comment, blah#+EXPORT_FILE_NAME: foo.pdf would not work either. -------- I think that the manual is not clear enough about applying in-buffer settings and keywords. We may want to clarify this detail. --=20 Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92