Re: Discrepancy between documentation and implementation regarding comments

[Robert Pluim <rpluim@gmail.com>]

>>>>> 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 one
    >> ‘#’ 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ʼs 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ʼs some possible inconsistency there.

FWIW, Iʼd vote for expressing it as 'zero or more whitespace followed
by one # followed by zero or more whitespace'

Robert