From mboxrd@z Thu Jan 1 00:00:00 1970 From: Thibault Polge Subject: Discrepancy between documentation and implementation regarding comments Date: Sun, 27 Oct 2019 11:07:20 +0100 Message-ID: <87eeyyy013.fsf@thb.lt> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:45905) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iOfSZ-00060G-9E for emacs-orgmode@gnu.org; Sun, 27 Oct 2019 06:07:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iOfSX-0000x9-TM for emacs-orgmode@gnu.org; Sun, 27 Oct 2019 06:07:42 -0400 Received: from 8.mo69.mail-out.ovh.net ([46.105.56.233]:56244) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iOfSX-0000uY-NR for emacs-orgmode@gnu.org; Sun, 27 Oct 2019 06:07:41 -0400 Received: from player695.ha.ovh.net (unknown [10.109.160.39]) by mo69.mail-out.ovh.net (Postfix) with ESMTP id 9BBA76CCB7 for ; Sun, 27 Oct 2019 11:07:32 +0100 (CET) Received: from thb.lt (85-170-54-226.rev.numericable.fr [85.170.54.226]) (Authenticated sender: thibault@thb.lt) by player695.ha.ovh.net (Postfix) with ESMTPSA id 1C252B559D9D for ; Sun, 27 Oct 2019 10:07:31 +0000 (UTC) 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" To: emacs-orgmode@gnu.org --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hello, According to Org-Mode documentation[1], > Lines starting with zero or more whitespace characters followed by one > =E2=80=98#=E2=80=99 and a whitespace are treated as comments and, as such= , are not > exported. The actual implementation differs on a subtle detail: Org-Mode will treat a line where the pound sign is immediatly followed by \n as a comment. I believe this is expected behavior, since it allows to comment out multiple paragraphs, and behaves as expected even when using `delete-trailing-whitespace`. I'm asking this because Pandoc follows strictly the org documentation, and treats a line containing only a pound sign as text. I opened a bug about this[2], where I've been asked =E2=80=93reasonably=E2=80=93 to first = make sure the bug isn't actually in Org Mode. [1] https://orgmode.org/manual/Comment-lines.html [2] https://github.com/jgm/pandoc/issues/5856 All the best, =2D- Thibault --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEExwXquOM8bWb4Q2zVGxM2FxoLkGQFAl21bFgACgkQGxM2FxoL kGROjw//S1Xn6r8oQMrvHqkqLuQHxQKJ2hcM6JpaRa240s8E9PA1aAqb6tKH7yNl VSQ62blZtjKsrQQZEAGU2G1IM77cgl1822RzzmWYQeJRtCS7c635rG2k75EcQj3G pRzTA+2KFchqOjUFQzgNdLbEhdmHJTz2RF/acGgTlnH3n8/TbGzYm8E2YaJZe3Ds ZCn1LTtSRM4Nn5HdsgADKjHxebhCD3P0HAGN1U4yG90rNqKm+0JpAXPFvax9dAtm BIWCS53Az2P9h8b3RdEFkgyuVHaMkkMWGpbfUZNV6CBGKJolOER70Qw8mp2vBcvO 62HiQtJc/TS4cNkYYXf3C8nsurZjwUzIzxQXY2XwfvHJx1jnKu7GnA15Mlc4PC4t fpc6LqDlasZNn5QAninCL9tCw0zoY27IjzaAbNNATpWeTiC27HpZ+DY9Otm+3+Qr 6eUnWgPHkZHmqqeWhF0kzviPvtH8VxYzGd4fWgoBDPfL8SGzR2maRFmJw/4H5zYO sZLNSgbBSAB1ioFjrAcZgN6js+8emxWkcJrxsY7iK0rPVeqx3AI/nJhHGsRVIiFw M4xsbtAQMceVUiQpb/13yIEUcoVXkwshXEXHWE/0+msjrxoUH0CrzhjJIzZ6JdRH 5+FLGxLfxCNy4dhH6poHNsjefAs81/KNzKseAfBWbmUG6Hc1vPQ= =nBVq -----END PGP SIGNATURE----- --=-=-=--