From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Fran=C3=A7ois_Pinard?= Subject: Language identifiers Date: Sun, 20 May 2012 09:48:28 -0400 Message-ID: <86r4uf9d5f.fsf@mercure.progiciels-bpi.ca> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:33965) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SW6Uq-00040n-UJ for emacs-orgmode@gnu.org; Sun, 20 May 2012 09:48:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SW6Up-0001tF-9P for emacs-orgmode@gnu.org; Sun, 20 May 2012 09:48:32 -0400 Received: from 206-248-137-202.dsl.teksavvy.com ([206.248.137.202]:62923 helo=mercure.progiciels-bpi.ca) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SW6Up-0001t9-3u for emacs-orgmode@gnu.org; Sun, 20 May 2012 09:48:31 -0400 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: emacs-orgmode@gnu.org Hello, Org people. Seeing again the (org) Languages node in the manual, I decided to check all my #+BEGIN_SRC for language tags, which I too often improvise, for normalizing them. I noticed a few things, and wonder if the manual should be amended, or if I should change my habits instead. - I was using lower case "c" and "r", while the manual suggests upper case "C" and "R" instead. Both seem to work (in Emacs at least). Should the manual be amended to say that case does not matter? If then, should the manual stick uniformly to lower case? - The identifier in the left column did not work, but if I change it to the identifier in the right column, the content highlights (in Emacs). The manual does not list it. | config | conf | | email | mail | | make | makefile | | postscript | ps | - I was using "elisp" instead of "emacs-lisp" and "javascript" instead of "js". Both seem to work (in Emacs at least). If there are many alternate languages identifiers for a language, should the manual list all acceptable identifiers? - Tag "xml" seems to work nicely (within Emacs). The manual does not list it. I wonder what "are supported" really means, in the first sentence. Maybe the fact that Emacs supports a language tag does not mean that Org supports it? Maybe exporters would fail to render them nicely? Maybe a few more words could be added to the page for explaining what users should expect, or not expect. Currently, I do not know whether if the list is missing a few identifiers, or if I'm not using them properly. Other tiny details about the table at the beginning of this Info page. It would be clearer if there was a separating line between the title line and the table contents. A vertical line separating both halves would be welcome too, one has to take a few seconds to understand that this is a two column table, each column itself holding two columns. Finally, the sorted entries are presented row wise in this two column table; the table would be easier to consult if the sorted entries were presented column wise instead. Fran=C3=A7ois