summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2009-09-16 21:33:17 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2009-09-16 21:33:17 +0000
commit277442550fa3a4103d0ac49b4fb91a5352983bbf (patch)
treed8428d848b7674b8d78a50fef44914f7734cf0dc /docs
parentd03b18e2e7b27def24b35a91e3b1f490fe45004d (diff)
downloaddocutils-277442550fa3a4103d0ac49b4fb91a5352983bbf.tar.gz
Bugfix for combination of "footnote-references=brackets"
with "use-latex-footnotes". git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk/docutils@6132 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docs')
-rw-r--r--docs/dev/todo.txt29
-rw-r--r--docs/user/docutils-05-compat.sty.txt11
2 files changed, 15 insertions, 25 deletions
diff --git a/docs/dev/todo.txt b/docs/dev/todo.txt
index 4b1d223f6..e922e0874 100644
--- a/docs/dev/todo.txt
+++ b/docs/dev/todo.txt
@@ -1967,26 +1967,19 @@ Which packages do we want to use?
+ True footnotes with LaTeX auto-numbering? (as option?)
- The `hyperref` manual says:
+ Might need adaption and a separate counter for symbol footnotes.
+
+ .. Quote:
- hyperfootnotes: Makes the footnote marks into hyperlinks to the
- footnote text. Easily broken ...
+ If the symbol you want is not one of the ones listed, you'll need to
+ redefine ``\@fnsymbol`` and add it, e.g. perhaps like::
- the `hyperref` README says:
+ \def\@fnsymbol#1{\ifcase#1\hbox{}\or *\or \dagger\or \ddagger\or
+ \mathchar "278\or \mathchar "27B\or \|\or **\or \dagger\dagger \or
+ \ddagger\ddagger \or \mathchar"27C \else\@ctrerr\fi\relax}
- The footnote support is rather limited. It is beyond the scope to use
- \footnotemark and \footnotetext out of order or reusing \footnotemark.
- Here you can either disable hyperref's footnote
-
- And provides an example which is built on in `this thread
- <http://www.latex-community.org/forum/viewtopic.php?f=5&t=2846>`__.
-
- + disable or properly support ``--footnote-references=bracket``
-
- When supplying the command line options --footnote-references=brackets
- and --use-latex-footnotes with the LaTeX writer (which might very well
- happen when using configuration files), the spaces in front of footnote
- references aren't trimmed.
+ which would allow \symbolfootnote[10]{footnote} to have a club as its
+ mark.
.. Footnote packages:
@@ -2026,7 +2019,7 @@ Which packages do we want to use?
footnotes so that they softly and silently vanish away if used in a
moving argument.
- `Footnotes numbered \u201cper page\u201d
+ `Footnotes numbered per page
<http://www.tex.ac.uk/cgi-bin/texfaq2html?label=footnpp>`__
* perpage provides a general mechanism for resetting counters per page
diff --git a/docs/user/docutils-05-compat.sty.txt b/docs/user/docutils-05-compat.sty.txt
index ce0857841..805b9a138 100644
--- a/docs/user/docutils-05-compat.sty.txt
+++ b/docs/user/docutils-05-compat.sty.txt
@@ -88,7 +88,8 @@ __ ../ref/rst/directives.html#document-header-footer
``--literal-block-env=lstlistings`` fail with literal or doctest
blocks nested in an admonition.
-* Support symbol footnotes with ``--use-latex-footnotes``.
+* Two-way hyperlinked footnotes and support for symbol footnotes and
+ ``--footnote-references=brackets`` with ``--use-latex-footnotes``.
Backwards compatibility:
"Bug for bug compatibility" is not provided.
@@ -642,12 +643,8 @@ New Feature:
``DUsubtitle`` commands,
:topic: ``\DUtopic`` and ``\DUtitle`` commands,
:transition: ``\DUtransition`` command.
-
- Auxiliary LaTeX commands
-
- :footnotes: ``\DUfootnotemark`` and ``\DUfootnotetext`` commands with
- hyperlink support and choice of footnotemark format (symbol or
- numeric).
+ :footnotes: ``\DUfootnotemark`` and ``\DUfootnotetext`` commands with
+ hyperlink support using the Docutils-provided footnote label.
Backwards compatibility:
In most cases, the default definition corresponds to the previously used