[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
- [O] Doc suggestion: Clarify subtree export properties,
James Harkins <=