From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: Language identifiers Date: Sun, 20 May 2012 07:31:41 -1000 Message-ID: References: <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]:33399) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SW9z1-0007rE-VE for emacs-orgmode@gnu.org; Sun, 20 May 2012 13:31:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SW9yz-00060u-Ma for emacs-orgmode@gnu.org; Sun, 20 May 2012 13:31:55 -0400 Received: from oproxy8-pub.bluehost.com ([69.89.22.20]:39005) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1SW9yz-00060X-DB for emacs-orgmode@gnu.org; Sun, 20 May 2012 13:31:53 -0400 In-Reply-To: <86r4uf9d5f.fsf@mercure.progiciels-bpi.ca> (=?utf-8?Q?=22Fran?= =?utf-8?Q?=C3=A7ois?= Pinard"'s message of "Sun, 20 May 2012 09:48:28 -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: =?utf-8?Q?Fran=C3=A7ois?= Pinard Cc: emacs-orgmode@gnu.org Aloha Fran=C3=A7ois, Fran=C3=A7ois Pinard writes: > 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 | "The core Babel functions (viewing, export, tangling, etc=E2=80=A6) are lan= guage agnostic and will work even for languages that are not explicitly supported. Explicit language-specific support is required only for evaluation of code blocks in a language." See http://orgmode.org/worg/org-contrib/babel/languages.html. > > - 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. > See above. Suggested revisions to the sentence are welcome. I believe I wrote the sentence, but Eric S. will review and decide whether or not to make changes. > 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. > I totally agree. Do you know how to do this in texinfo? Can you propose a patch? All the best, Tom > Fran=C3=A7ois > > > --=20 Thomas S. Dye http://www.tsdye.com