From mboxrd@z Thu Jan  1 00:00:00 1970
From: Robert Pluim <rpluim@gmail.com>
Subject: Re: Discrepancy between documentation and implementation regarding
 comments
Date: Sun, 27 Oct 2019 17:13:19 +0100
Message-ID: <m2lft6p3og.fsf@gmail.com>
References: <87eeyyy013.fsf@thb.lt>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:45559)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <rpluim@gmail.com>) id 1iOlAR-0007nL-Jv
 for emacs-orgmode@gnu.org; Sun, 27 Oct 2019 12:13:24 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <rpluim@gmail.com>) id 1iOlAQ-00061Q-H9
 for emacs-orgmode@gnu.org; Sun, 27 Oct 2019 12:13:23 -0400
Received: from mail-wr1-x429.google.com ([2a00:1450:4864:20::429]:43243)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <rpluim@gmail.com>) id 1iOlAQ-000614-4m
 for emacs-orgmode@gnu.org; Sun, 27 Oct 2019 12:13:22 -0400
Received: by mail-wr1-x429.google.com with SMTP id c2so7346486wrr.10
 for <emacs-orgmode@gnu.org>; Sun, 27 Oct 2019 09:13:22 -0700 (PDT)
In-Reply-To: <87eeyyy013.fsf@thb.lt> (Thibault Polge's message of "Sun, 27 Oct
 2019 11:07:20 +0100")
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: <https://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"
 <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Thibault Polge <thibault@thb.lt>
Cc: emacs-orgmode@gnu.org

>>>>> On Sun, 27 Oct 2019 11:07:20 +0100, Thibault Polge <thibault@thb.lt> =
said:

    Thibault> Hello,
    Thibault> According to Org-Mode documentation[1],

    >> Lines starting with zero or more whitespace characters followed by o=
ne
    >> =E2=80=98#=E2=80=99 and a whitespace are treated as comments and, as=
 such, are not
    >> exported.

'whitespace' in emacs normally covers newline as well. Of course org
might mean 'at least one space or tab', but as you say, that=CA=BCs not
what the implementation does. eg in org 9.2.6, org-fill-element does

    (re-search-backward "^[ \t]*#[ \t]*$" begin t)

However org-at-comment-p does

    (looking-at "^[ \t]*# ")

so there=CA=BCs some possible inconsistency there.

FWIW, I=CA=BCd vote for expressing it as 'zero or more whitespace followed
by one # followed by zero or more whitespace'

Robert