From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mark Edgington Subject: Re: [PATCH] Export: Override headline numbering via properties Date: Mon, 13 May 2013 05:42:52 -0400 Message-ID: References: <87ppwvtnbw.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Return-path: Received: from eggs.gnu.org ([208.118.235.92]:35671) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UbpHm-0001gC-Kd for emacs-orgmode@gnu.org; Mon, 13 May 2013 05:43:17 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UbpHl-0003H7-H2 for emacs-orgmode@gnu.org; Mon, 13 May 2013 05:43:14 -0400 Received: from mail-ob0-x22b.google.com ([2607:f8b0:4003:c01::22b]:60758) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UbpHl-0003Gx-C3 for emacs-orgmode@gnu.org; Mon, 13 May 2013 05:43:13 -0400 Received: by mail-ob0-f171.google.com with SMTP id ef5so3531583obb.16 for ; Mon, 13 May 2013 02:43:12 -0700 (PDT) In-Reply-To: <87ppwvtnbw.fsf@gmail.com> 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: Nicolas Goaziou Cc: emacs-orgmode@gnu.org Hello Nicolas, I'm sorry for not having provided more explanation of the patch's purpose. The motivation is basically to permit any kind of "manual" (in contrast to "automatic") control over the section-numbering behavior connected with a particular headline. In LaTeX, for example, you are able to make any section numbered or un-numbered, however in org-mode, there is an artificial restriction when using numbering that sections of a particular depth must be either all numbered, or all un-numbered. A couple possible use-cases: 1. a document (or chapter of a document) where the first headline contains general "introduction" information explaining what the rest of the document (chapter) is about (similar to an abstract, but not identical -- something that might contain sub-headings, lists, tables, etc.), and the remainder of the document (chapter) is the "real" content of the document -- the place where you want the numbering to begin. 2. a document where only one of the headlines and its child-headlines halfway through the document should be un-numbered (maybe they represent an "example docoument" embedded within an instruction-manual). The reason there are two different properties (a normal, and an "inherited" version) is because use-case #2 could be painful if you had to add a ":NUMBERED: n" property to every node of the sub-document. There are probably several other use-cases to be discovered that this allows. Simply put, the patch makes it possible to control the numbering for a single headline (one specific headline, not a headline-level), or to set a manual default numbering behavior for a sub-tree of headlines. All other headlines behave according to the current org-mode numbering rules. Regards, Mark