From mboxrd@z Thu Jan  1 00:00:00 1970
From: Eric Schulte <eric.schulte@gmx.com>
Subject: Re: Capitalisation and good taste ?
Date: Wed, 11 Jan 2012 13:47:04 -0700
Message-ID: <878vlenf03.fsf@gmx.com>
References: <87k4509rc1.fsf@iro.umontreal.ca> <87aa5wcitv.fsf@norang.ca>
	<23144.1326172391@gamaville.dokosmarshall.org>
	<8762gk9l27.fsf@iro.umontreal.ca> <87wr8zwdz1.fsf@gnu.org>
	<87pqergxf6.fsf@gmx.com> <87ehv7wcx5.fsf@gnu.org>
	<87fwfmntan.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([140.186.70.92]:41664)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eric.schulte@gmx.com>) id 1Rl54q-0007bx-Jx
	for emacs-orgmode@gnu.org; Wed, 11 Jan 2012 15:47:21 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <eric.schulte@gmx.com>) id 1Rl54o-0003Qd-OQ
	for emacs-orgmode@gnu.org; Wed, 11 Jan 2012 15:47:20 -0500
Received: from mailout-us.gmx.com ([74.208.5.67]:51604)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <eric.schulte@gmx.com>) id 1Rl54o-0003QY-Ar
	for emacs-orgmode@gnu.org; Wed, 11 Jan 2012 15:47:18 -0500
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=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: Bastien <bzg@altern.org>
Cc: Bernt Hansen <bernt@norang.ca>, =?utf-8?Q?Fran=C3=A7ois?= Pinard <pinard@iro.umontreal.ca>, nicholas.dokos@hp.com, emacs-orgmode@gnu.org

Bastien <bzg@altern.org> writes:

> Bastien <bzg@altern.org> writes:
>
>> Actually, I'm thinking of another solution:
>>
>> - keep one-line option/environment keywords uppercase
>>   #+NAME
>>   #+HTML
>>   #+TITLE
>>   #+...
>>
>> - use lowercase for multi-lines environments keywords
>>   #+begin_ascii
>>   #+begin_html
>>   #+results
>>
>> This is the only good criterium I can think of, and that
>> way people using easy templates will not be surprised to
>> see #+begin_xxx in the manual.
>
> I tried this and I find the lowercase #+begin_xxx really
> not readable enough in the manual.   So I use #+RESULTS:
> and explained this convention in the manual.

Sounds good.

While I like the proposed distinction above, I'd just as soon have
Org-mode default to all caps in the manual and in practice.  As noted
before individual users can use lower case at the mercy of their (our)
potentially changing whims.

I'm going to push up a patch which will change to inserting #+RESULTS:
by default as well as a user-configurable variable which can be used to
customize this behavior.

-- 
Eric Schulte
http://cs.unm.edu/~eschulte/