From mboxrd@z Thu Jan 1 00:00:00 1970 From: Arni Magnusson Subject: Re: Warning about section named "Footnotes" Date: Sat, 29 Nov 2014 18:48:01 +0000 (UTC) Message-ID: Mime-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34857) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xun3z-0000F9-0K for emacs-orgmode@gnu.org; Sat, 29 Nov 2014 13:48:18 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xun3r-0006Nk-HT for emacs-orgmode@gnu.org; Sat, 29 Nov 2014 13:48:10 -0500 Received: from hafgarpur.hafro.is ([130.208.64.48]:50838) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xun3r-0006NN-A9 for emacs-orgmode@gnu.org; Sat, 29 Nov 2014 13:48:03 -0500 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: Nicolas Goaziou Cc: emacs-orgmode@gnu.org The location of the second patch (in orgguide.texi) is line 348: 348c348,351 Arni ---------- Forwarded message ---------- Sure. I suggest inserting a short paragraph into section 2.2, both in the manual and the compact guide. Working from today's snapshot of the repository, the two patches are as follows. $ diff org-before.texi org-after.texi 1212c1212,1217 < @noindent Some people find the many stars too noisy and would prefer an --- > @ vindex org-footnote-section > @ noindent Note that the headline @samp{Footnotes} is a @emph{reserved} > name. A subtree with this headline will be silently ignored by exporting > functions, unless the value of @code{org-footnote-section} is modified. > > Some people find the many stars too noisy and would prefer an $ diff orgguide-before.texi orgguide-after.texi < @noindent --- > @ noindent Note that the headline @samp{Footnotes} is a @emph{reserved} > name. A subtree with this headline will be silently ignored by exporting > functions, unless the value of @code{org-footnote-section} is modified. > Best regards, Arni On Sat, 29 Nov 2014, Nicolas Goaziou wrote: >> I think it would help Org users if: >> >> 1. Org export (to LaTeX, HTML, etc.) emits an error or a prominent >> warning when it ignores an entire section like this. > > It shouldn't. This is the expected behaviour. > >> 2. The manual would warn the user about this behavior with a prominent >> warning. > > Would you mind suggesting a change to the manual? > > > Regards, > > -- > Nicolas Goaziou >