emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
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
>

  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]
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

  List information: https://www.orgmode.org/

* 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 public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).