emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[O] Doc suggestion: Clarify subtree export properties


From: James Harkins
Subject: [O] Doc suggestion: Clarify subtree export properties
Date: Thu, 09 Jul 2015 21:10:02 +0800
User-agent: Wanderlust/2.15.9 (Almost Unreal) SEMI-EPG/1.14.7 (Harue) FLIM/1.14.9 (Gojō) APEL/10.8 EasyPG/1.0.0 Emacs/24.3 (x86_64-pc-linux-gnu) MULE/6.0 (HANACHIRUSATO)

I think the manual could be a bit clearer on one point of the use of :EXPORT_*: 
properties.

http://orgmode.org/manual/Export-settings.html#Export-settings

~~
When exporting only a subtree, each of the previous keywords3 can be overridden 
locally by special node properties. These begin with ‘EXPORT_’, followed by the 
name of the keyword they supplant. For example, ‘DATE’ and ‘OPTIONS’ keywords 
become, respectively, ‘EXPORT_DATE’ and ‘EXPORT_OPTIONS’ properties.
~~

And...

~~
[2] If you want to configure many options this way, you can use several 
#+OPTIONS lines.
~~

*If* you already know what you're doing, then you know that you can't have 
multiple properties of the same name in the same PROPERTIES drawer.

If you are reading the manual because you don't already know what you're doing, 
then you might simply convert the default block of options (inserted by C-c C-e 
# default RET) into multiple lines of properties, and then get annoyed when 
many of them are ignored.

Perhaps add this?

~~
... become, respectively, ‘EXPORT_DATE’ and ‘EXPORT_OPTIONS’ properties. Note 
that multiple EXPORT_OPTIONS lines are not supported, because node properties 
must have unique identifiers.
~~

hjh





reply via email to

[Prev in Thread] Current Thread [Next in Thread]