From: Arni Magnusson <arnima@hafro.is>
To: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Cc: emacs-orgmode@gnu.org
Subject: Re: Warning about section named "Footnotes"
Date: Sat, 29 Nov 2014 18:40:12 +0000 (UTC) [thread overview]
Message-ID: <alpine.LFD.2.11.1411291820330.52834@hafstokkur.hafro.is> (raw)
In-Reply-To: <87a93annfi.fsf@nicolasgoaziou.fr>
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
>
next prev parent reply other threads:[~2014-11-29 18:40 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-11-28 19:04 Warning about section named "Footnotes" Arni Magnusson
2014-11-29 13:31 ` Nicolas Goaziou
2014-11-29 18:40 ` Arni Magnusson [this message]
-- strict thread matches above, loose matches on Subject: below --
2014-11-29 18:48 Arni Magnusson
2014-12-02 11:23 ` Nicolas Goaziou
2014-12-08 1:37 ` Arni Magnusson
2014-12-09 8:56 ` Nicolas Goaziou
2015-02-21 16:36 ` Arni Magnusson
2015-02-21 17:33 ` Nicolas Goaziou
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=alpine.LFD.2.11.1411291820330.52834@hafstokkur.hafro.is \
--to=arnima@hafro.is \
--cc=emacs-orgmode@gnu.org \
--cc=mail@nicolasgoaziou.fr \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.