Problem with pdflatex/hyperref: no math in \section{}
Charlie Zender
My system is a stock RedHat 7.0 Intel tetex installation:
TeX, Version 3.14159 (Web2C 7.3.1)
pdfTeX, Version 3.14159-13d (Web2C 7.3.1)
LaTeX2e <1999/12/01> patch level 1
When using pdflatex with hyperref, I get lots of warnings like the
following:
Package hyperref Warning: Token not allowed in a PDFDocEncoded string,
(hyperref) removing `math shift' on input line 6096.
These appear to be caused by using math symbols in \section commands,
e.g.,
\subsubsection[Measurements of $\mssuptcffttl$]{Laboratory Measurements
of $\mssuptcffttl$}
Is this really not allowed with pdflatex/hyperref?
Or is there a workaround?
Thanks,
Charlie
--
Charlie Zender zen...@uci.edu (949) 824-2987/FAX-3256, Department of
Earth System Science, University of California, Irvine CA 92697-3100
Michael J Downes
> Package hyperref Warning: Token not allowed in a PDFDocEncoded string,
> (hyperref) removing `math shift' on input line 6096.
>
> These appear to be caused by using math symbols in \section commands,
> e.g.,
>
> \subsubsection[Measurements of $\mssuptcffttl$]{Laboratory Measurements
> of $\mssuptcffttl$}
>
> Is this really not allowed with pdflatex/hyperref?
Yes it is allowed to use math in the section titles. That message is a
warning in case you think that the math symbols will show up in the PDF
bookmarks. Adobe specified that bookmark text has to be limited to a
particular encoding "PDFDocEncoding" that does not support unusual
symbols of any kind, including math symbols. Therefore Acrobat Reader
will not show your math symbols in the bookmarks, regardless of anything
that hyperref can do. In the main text the math formulas will view fine.
Charlie Zender
That being the case, is there any way to turn off the warnings?
> Yes it is allowed to use math in the section titles. That message is a
> warning in case you think that the math symbols will show up in the PDF
> bookmarks. Adobe specified that bookmark text has to be limited to a
> particular encoding "PDFDocEncoding" that does not support unusual
> symbols of any kind, including math symbols. Therefore Acrobat Reader
> will not show your math symbols in the bookmarks, regardless of anything
> that hyperref can do. In the main text the math formulas will view fine.
--
Jochen Küpper
CZ> That being the case, is there any way to turn off the warnings?
Yes, use \texorpdfstring{tex}{pdfbookmark} in the short caption.
Look up the hyperref documentation for its value.
[quoting snipped]
Please write your text *below* the quote it refers to.
Jochen
--
Einigkeit und Recht und Freiheit http://www.Jochen-Kuepper.de
Liberté, Égalité, Fraternité GnuPG key: 44BCCD8E
Sex, drugs and rock-n-roll
Heiko Oberdiek
>That being the case, is there any way to turn off the warnings?
The hyperref documentation contains the paper of
my talk at EuroTeX'99, that describes the problem
with possible methods to handle it.
Yours sincerely
Heiko <ober...@ruf.uni-freiburg.de>
Charlie Zender
I downloaded the hyperref package. It comes with a 250 page
document, hyperref.dvi. I understood < 1% of that document,
and saw nothing about how to squelch warning messages.
I get the impression you are speaking about a different,
more user friendly document. If so, what is it named, exactly?
Thanks,
Charlie
Robin Fairbairns
>>That being the case, is there any way to turn off the warnings?
(which is self-quotation; what he's complaining about is heiko's
assertion about the documentation of hyperref.)
>I downloaded the hyperref package. It comes with a 250 page
>document, hyperref.dvi. I understood < 1% of that document,
>and saw nothing about how to squelch warning messages.
>I get the impression you are speaking about a different,
>more user friendly document. If so, what is it named, exactly?
heiko talked about the documentation. you claim you downloaded the
package, which to my mind says you acquired something like
macros/latex/contrib/supported/hyperref.tar.gz (or .zip or whatever)
in that lot there's
1999/06/28 | 184049 | macros/latex/contrib/supported/hyperref/doc/manual.pdf
1999/10/13 | 4163 | macros/latex/contrib/supported/hyperref/doc/options.tex
1999/10/13 | 161506 | macros/latex/contrib/supported/hyperref/doc/paper.pdf
1999/10/13 | 346068 | macros/latex/contrib/supported/hyperref/doc/slides.pdf
which is what heiko was talking about when he said the problem was
covered in "documentation". as you observe, the code of hyperref is
painfully large (in the order of 30% of the size of latex itself).
heiko and (earlier) sebastian worked hard to produce "documentation"
rather than mere commented code. they are, imo, to be praised for
that effort.
--
Robin Fairbairns, Cambridge
Heiko Oberdiek
>>That being the case, is there any way to turn off the warnings?
>
>I downloaded the hyperref package. It comes with a 250 page
>document, hyperref.dvi. I understood < 1% of that document,
>and saw nothing about how to squelch warning messages.
>I get the impression you are speaking about a different,
>more user friendly document. If so, what is it named, exactly?
Sorry, I cannot help you reading the documents in
the subdirectory `doc' (CTAN or hyperdoc.zip on the
TUG server).
Yours sincerely
Heiko <ober...@ruf.uni-freiburg.de>
Charlie Zender
> heiko talked about the documentation. you claim you downloaded the
> package, which to my mind says you acquired something like
>
> macros/latex/contrib/supported/hyperref.tar.gz (or .zip or whatever)
I got hyperref.dtx and ran make on it and hyperref.dvi was the only
document I noticed. Perhaps it created a doc subdirectory, but I did not
notice it (I'm on a different computer now). I was under the (mistaken,
I gather) impression that the *.dtx or *.ins files contained everything
in a LaTeX package. I'll use the .tar.gz files from now on.
> in that lot there's
>
> 1999/06/28 | 184049 | macros/latex/contrib/supported/hyperref/doc/manual.pdf
> 1999/10/13 | 4163 | macros/latex/contrib/supported/hyperref/doc/options.tex
> 1999/10/13 | 161506 | macros/latex/contrib/supported/hyperref/doc/paper.pdf
> 1999/10/13 | 346068 | macros/latex/contrib/supported/hyperref/doc/slides.pdf
Yes, I just installed hyperref.zip and got these docs
> which is what heiko was talking about when he said the problem was
> covered in "documentation". as you observe, the code of hyperref is
> painfully large (in the order of 30% of the size of latex itself).
> heiko and (earlier) sebastian worked hard to produce "documentation"
> rather than mere commented code. they are, imo, to be praised for
> that effort.
Absolutely. hyperref.dvi is written (and written well) for developers.
But I just can't seem to understand LaTeX internals well enough to
benefit from that effort. manual.pdf and paper.pdf have examples
and are written (partially, at least) with dumb users in mind.
Charlie Zender
> Sorry, I cannot help you reading the documents in
> the subdirectory `doc' (CTAN or hyperdoc.zip on the
> TUG server).
I had the wrong document.
Found the right ones, including your paper and the part
about avoiding error messages with \texorpdfstring,
with Robin's help,
Thanks everybody,