From mboxrd@z Thu Jan 1 00:00:00 1970 From: James Harkins Subject: Doc suggestion: Clarify subtree export properties Date: Thu, 09 Jul 2015 21:10:02 +0800 Message-ID: <87vbdtlbo5.wl-jamshark70@qq.com> Mime-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") Content-Type: text/plain; charset=ISO-8859-7 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40622) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZDBaj-0006Ck-Rt for emacs-orgmode@gnu.org; Thu, 09 Jul 2015 09:10:18 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZDBag-0003WC-AQ for emacs-orgmode@gnu.org; Thu, 09 Jul 2015 09:10:17 -0400 Received: from smtpbgau1.qq.com ([54.206.16.166]:49325) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZDBaf-0003QN-Bh for emacs-orgmode@gnu.org; Thu, 09 Jul 2015 09:10:14 -0400 Received: from hjh-e431.qq.com (unknown [219.136.163.40]) by esmtp4.qq.com (ESMTP) with SMTP id 0 for ; Thu, 09 Jul 2015 21:10:02 +0800 (CST) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: orgmode I think the manual could be a bit clearer on one point of the use of :EXPOR= T_*: properties. http://orgmode.org/manual/Export-settings.html#Export-settings ~~ When exporting only a subtree, each of the previous keywords3 can be overri= dden locally by special node properties. These begin with =A1EXPORT_=A2, fo= llowed by the name of the keyword they supplant. For example, =A1DATE=A2 an= d =A1OPTIONS=A2 keywords become, respectively, =A1EXPORT_DATE=A2 and =A1EXP= ORT_OPTIONS=A2 properties. ~~ And... ~~ [2] If you want to configure many options this way, you can use several #+O= PTIONS 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 do= ing, then you might simply convert the default block of options (inserted b= y C-c C-e # default RET) into multiple lines of properties, and then get an= noyed when many of them are ignored. Perhaps add this? ~~ ... become, respectively, =A1EXPORT_DATE=A2 and =A1EXPORT_OPTIONS=A2 proper= ties. Note that multiple EXPORT_OPTIONS lines are not supported, because no= de properties must have unique identifiers. ~~ hjh