From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Should comments break paragraphs? Date: Tue, 16 Jul 2013 09:40:13 +0200 Message-ID: <87ehazymua.fsf@gmail.com> References: <51E443F6.2050104@arfer.net> <87mwpnfybn.fsf@gmail.com> <51E47BC1.7010808@gmail.com> <87ip0byoqg.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38481) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uyzrd-0002G2-QU for emacs-orgmode@gnu.org; Tue, 16 Jul 2013 03:40:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Uyzrc-0003AB-9N for emacs-orgmode@gnu.org; Tue, 16 Jul 2013 03:40:01 -0400 Received: from mail-wi0-x234.google.com ([2a00:1450:400c:c05::234]:33592) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uyzrc-0003A2-3V for emacs-orgmode@gnu.org; Tue, 16 Jul 2013 03:40:00 -0400 Received: by mail-wi0-f180.google.com with SMTP id c10so308501wiw.1 for ; Tue, 16 Jul 2013 00:39:59 -0700 (PDT) In-Reply-To: (Rainer M. Krug's message of "Tue, 16 Jul 2013 09:09:26 +0200") 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: Rainer M Krug Cc: emacs-orgmode@gnu.org Hello, Rainer M Krug writes: > I see comments as "entities which do not have any impact on the final > product". > > If you regard the org file as the final product, then I > completely agree (I use org mainly for literate programming, and I don't > use any comments unless in linger code blocks, but that is not in > org). But if I use org for writing e.g. presentations in beamer, I might want > to add comments which should not be on the product (slides, article, > handout, ...) but which contain info in the org file. > > So we are talking different levels here. Comments do not alter the final product: they are ignored during export. But there are places where you cannot have comments, at all. If we look at the following example, similar to OP's: Some text # comment Some other text comment do not split the paragraph: there were two paragraphs since the beginning (but still no spoon). It's only disturbing if you think comments can be inserted within paragraphs, which is not the case. This may not be perfect, but, as for me, it's good enough. Another option would be to remove every comment line before parsing the buffer (which is, IIRC, what previous exporter did), but it would only hide the situation for a while. After all I could expect to have comments anywhere, including some places like * Headline # Between an headline and planning info. Update org-agenda.el. SCHEDULED: <2013-07-16 Tue> - item 1 # Some comment between items. Update org-list.el - item 2 #+HEADER: var=2 # A comment between affiliated keywords and true data. Update ob-core.el. #+RESULTS: some-table | a | | a | b | # Comments within rows. Update org-table.el | c | d | And then, the situation would appear again: it's not just about the parser or the exporter. Every part of Org would have to handle comments differently. Again, I think comments are acceptable, once you are aware about their limitations. But, I don't prevent you from opening that can of worms. Regards, -- Nicolas Goaziou