From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rafael Laboissiere Subject: Contradiction between code and doc as regards commented lines Date: Sat, 27 Oct 2012 21:04:05 +0200 Message-ID: <20121027190405.GL31999@laboissiere.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed Return-path: Received: from eggs.gnu.org ([208.118.235.92]:48760) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TSCAL-0005hb-Hu for emacs-orgmode@gnu.org; Sat, 27 Oct 2012 15:35:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TSCAK-0001K2-HA for emacs-orgmode@gnu.org; Sat, 27 Oct 2012 15:35:29 -0400 Received: from xvm-168-252.ghst.net ([95.142.168.252]:33560 helo=laboissiere.net) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TSCAK-0001Jg-A8 for emacs-orgmode@gnu.org; Sat, 27 Oct 2012 15:35:28 -0400 Content-Disposition: inline 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: emacs-orgmode@gnu.org Before Git commit e8046d2, lines like this were treated as comments in org-mode: ### This used to be a comment At present, lines as the above are not highlighted as comments and will be exported verbatim. Only lines like the following are considered to be comments, currently: # Only this is now a comment This behavior is clearly in contradiction with the documentation, according to this relevant part of doc/org.texi: @node Comment lines, , Horizontal rules, Structural markup elements [snip] Lines starting with zero or more whitespace characters followed by @samp{#} are treated as comments and will never be exported. Please, fix the documentation (or restore the previous behavior, if the documentation is meant to be correct). Cheers, Rafael