From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Inserting a comma as prefix of headlines (in Org code blocks) Date: Thu, 28 Feb 2013 11:52:37 +0100 Message-ID: <87ehg0pv62.fsf@gmail.com> References: <86fw0i9lu4.fsf@somewhere.org> <87sj4irt1y.fsf@gmail.com> <87r4k2eyub.fsf@bzg.ath.cx> <87obf5syru.fsf@gmail.com> <878v69nz7u.fsf@bzg.ath.cx> <87vc9dpc7r.fsf@gmail.com> <87fw0gg6o3.fsf@bzg.ath.cx> <87mwuopxru.fsf@gmail.com> <87y5e8d9rx.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:38912) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UB16b-0006m4-1w for emacs-orgmode@gnu.org; Thu, 28 Feb 2013 05:52:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UB16Z-0001Wv-SO for emacs-orgmode@gnu.org; Thu, 28 Feb 2013 05:52:52 -0500 Received: from mail-wg0-f50.google.com ([74.125.82.50]:33055) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UB16Z-0001Vx-Jc for emacs-orgmode@gnu.org; Thu, 28 Feb 2013 05:52:51 -0500 Received: by mail-wg0-f50.google.com with SMTP id es5so1290888wgb.17 for ; Thu, 28 Feb 2013 02:52:50 -0800 (PST) In-Reply-To: <87y5e8d9rx.fsf@bzg.ath.cx> (Bastien's message of "Thu, 28 Feb 2013 11:15:30 +0100") 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: Bastien Cc: OrgMode ML , Sebastien Vauban Bastien writes: > But be prepared for dealing with some stubbornness on my side: > documenting the parser does not mean every issue should be solved > thinking in terms of the parser. Sometimes there should be a > tradeoff between what the parser can parse and what the UI should > offer. Obviously, it depends on the tradeoff. For example, `org-fill-paragraph' contains one. Here is an excerpt of its docstring: For convenience, when point is at a plain list, an item or a footnote definition, try to fill the first paragraph within. This is perfectly fine because it doesn't go against the parser. It merely acts as if the point was elsewhere in the buffer. But it doesn't pretend that the buffer is different. Another possible kind of tradeoff is commands working on a region. Regions don't mean anything for the parser, so commands acting of them may ignore what the parser knows about the buffer. Nevertheless, in other cases, I highly suggest to never discard the output from the parser. A command ought to always consider that the parser is correct. So, if it means to go against it, it should be specified explicitly somewhere (e.g. C-S-up can clearly break the syntax). Commands activated through simple keys (i.e. TAB) on basic syntax (i.e. an headline) shouldn't, IMO, belong to that category, as it would confuse users even more. Regards, -- Nicolas Goaziou