From mboxrd@z Thu Jan 1 00:00:00 1970 From: Eric Schulte Subject: Re: [ANN] BREAKING CHANGE -- removing #+BABEL file-wide property lines Date: Thu, 20 Oct 2011 15:54:35 -0600 Message-ID: <8762jjgwbw.fsf@gmail.com> References: <87pqhrih3s.fsf@gmail.com> <30891.1319141196@alphaville.dokosmarshall.org> <87fwinifqu.fsf@gmail.com> <32184.1319143892@alphaville.dokosmarshall.org> <87zkgvgxe7.fsf@gmail.com> <804nz3wd14.fsf@somewhere.org> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([140.186.70.92]:38800) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH0cU-0008S2-QT for emacs-orgmode@gnu.org; Thu, 20 Oct 2011 17:57:48 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RH0cS-0004e4-JB for emacs-orgmode@gnu.org; Thu, 20 Oct 2011 17:57:46 -0400 Received: from mail-pz0-f47.google.com ([209.85.210.47]:45626) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH0cS-0004do-DZ for emacs-orgmode@gnu.org; Thu, 20 Oct 2011 17:57:44 -0400 Received: by pzd13 with SMTP id 13so8764528pzd.6 for ; Thu, 20 Oct 2011 14:57:43 -0700 (PDT) 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: Sebastien Vauban Cc: emacs-orgmode@gnu.org "Sebastien Vauban" writes: > Hi Eric, > > Eric Schulte wrote: >> Nick Dokos writes: >>> Eric Schulte wrote: >>>> Nick Dokos writes: >>>> > Eric Schulte wrote: >>>> > >>>> >> I have just pushed up a change to the Org-mode git repository which >>>> >> removes support for #+BABEL lines. Please use the more general >>>> >> #+PROPERTIES lines instead. >>>> > >>>> > Coming late to the dance - sorry. I think that's very confusing. >>>> > "Property" is an overloaded term in org: we now have the :PROPERTIES: >>>> > drawer, the #+PROPERTY line and the #+PROPERTIES line (singular and >>>> > plural forms are already pretty bad). >>>> >>>> Do the #+PROPERTY and #+PROPERTIES lines have different semantics? >>> >>> I think so: see section 7.1 for a use of the former. AFAICT, the latter >>> only applies to code block header arguments. >> >> Oh! >> >> Thank you for making this clear, I had assumed that #+PROPERTIES: lines >> were an integral part of Org-mode which code block header arguments were >> simply making use of. Having read the section of the info manual you >> point out above I see that I was mistaken. I've just pushed up what I >> consider to be a clean implementation. Put briefly the new behavior is >> that "properties may be used to specify header arguments". More >> completely... >> >> 1. The #+PROPERTIES: (and #+BABEL:) directives no longer exist. >> >> 2. The existing #+PROPERTY: line may now be used to specify values for >> header arguments, e.g., >> >> #+PROPERTY: results silent >> >> would silence all results in the current buffer. >> >> I think this should be simple, easy to remember, and it certainly >> cleaned up the code base. Please let me know what you think of this new >> setup. > > I just have one question, as I'm puzzled by the lack of `:' in front of the > "properties": how do we distinguish the argument "value" from the argument > "name"? > > For example, how do we translate, in the new syntax, > > #+BABEL: :results output code append > > (where `:results' is the "name", and `output', `code' and `append' are > "values")? > The above would become #+PROPERTY: results output code append Since only one property may be specified per property line there is no need for colons. This mirrors exactly the way the properties are saved under subtrees in :PROPERTY: blocks. Multiple lines may be used to specify multiple properties. e.g., #+PROPERTY: results silent #+PROPERTY: cache yes Best -- Eric > > Best regards, > Seb -- Eric Schulte http://cs.unm.edu/~eschulte/