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 via email to