Re: Confused about what the COMMENT keyword means

[Alain . Cochard]

Thanks for answering.

Ihor Radchenko writes on Tue 27 Sep 2022 09:55:
 > 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 ‘#+SETUPFILE: filename or
 >     URL’ syntax.
 > 
 > Because export settings are global, they have higher priority over the
 > COMMENTed heading.

OK, I can understand that but if, as I now see in 13.2, both TITLE and
EXPORT_FILE_NAME are export settings, why does it behaves as I expect
for TITLE (the title I get is indeed 'bart') but not for
EXPORT_FILE_NAME?

 > [...]
 
 > > By contrast, with this file
 > > 
 > >    # * foo
 > >    # #+EXPORT_FILE_NAME: foo.pdf
 > >    # #+TITLE: foot
 > >    # fofoo
 > >    * bar
 > >    #+EXPORT_FILE_NAME: bar.pdf
 > >    #+TITLE: bart
 > >    babar
 > 
 > This file contains no export settings.

I don't understand that: what about the line '#+EXPORT_FILE_NAME:
bar.pdf'??

 > # #+EXPORT_FILE_NAME: foo.pdf line is not an export setting. It
 > does not matter that it is a comment,

Yes, of course; if it is a comment, it is as if it were not here at
all, correct?

 > I think that the manual is not clear enough about applying
 > in-buffer settings and keywords. We may want to clarify this
 > detail.

How about adding a sentence in 13.6, perhaps in the footnote?
Something like "Also note that, as mentioned in 13.2, export
settings, being global, take precedence over the 'COMMENT' keyword."

Finally, I'd appreciate a "SUPERCOMMENT" keyword, which would be
equivalent (when exporting) to removing the tree altogether (or, as I
understand, prepending '# ' to each line of the tree).




-- 
EOST (École et Observatoire des Sciences de la Terre) 
ITE (Institut Terre & Environnement) | alain.cochard@unistra.fr
5 rue René Descartes   [bureau 106]  | Phone: +33 (0)3 68 85 50 44 
F-67084 Strasbourg Cedex, France     | [ slot available for rent ]