emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Robert Pluim <rpluim@gmail.com>
To: Thibault Polge <thibault@thb.lt>
Cc: emacs-orgmode@gnu.org
Subject: Re: Discrepancy between documentation and implementation regarding comments
Date: Sun, 27 Oct 2019 17:13:19 +0100	[thread overview]
Message-ID: <m2lft6p3og.fsf@gmail.com> (raw)
In-Reply-To: <87eeyyy013.fsf@thb.lt> (Thibault Polge's message of "Sun, 27 Oct 2019 11:07:20 +0100")

>>>>> 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

  reply	other threads:[~2019-10-27 16:13 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-10-27 10:07 Discrepancy between documentation and implementation regarding comments Thibault Polge
2019-10-27 16:13 ` Robert Pluim [this message]
2019-10-27 20:09   ` Adam Porter
2019-10-27 21:02     ` Samuel Wales
2019-10-28 11:05 ` Nicolas Goaziou
2019-10-28 11:42   ` Thibault Polge
2019-10-28 16:16     ` Nicolas Goaziou
2019-10-29 13:52       ` Robert Pluim
2019-10-29 14:14         ` Thibault Polge
2019-10-29 14:34           ` Robert Pluim

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m2lft6p3og.fsf@gmail.com \
    --to=rpluim@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=thibault@thb.lt \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).