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:40:12 +0000 (UTC) Message-ID: References: <87a93annfi.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33493) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XumwR-0006xm-EA for emacs-orgmode@gnu.org; Sat, 29 Nov 2014 13:40:31 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XumwJ-0004FK-To for emacs-orgmode@gnu.org; Sat, 29 Nov 2014 13:40:23 -0500 Received: from hafgarpur.hafro.is ([130.208.64.48]:50819) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XumwJ-0004FB-Ls for emacs-orgmode@gnu.org; Sat, 29 Nov 2014 13:40:15 -0500 In-Reply-To: <87a93annfi.fsf@nicolasgoaziou.fr> 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 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 >