emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed

From: James Harkins <jamshark70@qq.com>
To: orgmode <emacs-orgmode@gnu.org>
Subject: Doc suggestion: Clarify subtree export properties
Date: Thu, 09 Jul 2015 21:10:02 +0800	[thread overview]
Message-ID: <87vbdtlbo5.wl-jamshark70@qq.com> (raw)

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

next             reply	other threads:[~2015-07-09 13:10 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-07-09 13:10 James Harkins [this message]
2015-07-22  8:27 ` Doc suggestion: Clarify subtree export properties Nicolas Goaziou

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87vbdtlbo5.wl-jamshark70@qq.com \
    --to=jamshark70@qq.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).