diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref/manual.html')
| -rw-r--r-- | Master/texmf-dist/doc/latex/hyperref/manual.html | 410 |
1 files changed, 141 insertions, 269 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.html b/Master/texmf-dist/doc/latex/hyperref/manual.html index 4a4f4ab6d86..5dc0901e62e 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual.html @@ -3,8 +3,8 @@ <html > <head><title>Hypertext marks in LATEX: a manual for hyperref</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> -<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)"> -<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> <!-- html --> <meta name="src" content="manual.tex"> <link rel="stylesheet" type="text/css" href="manual.css"> @@ -20,19 +20,12 @@ <div class="author" ><span class="ec-lmr-12">Sebastian Rahtz (deceased)</span><br class="and" /><span class="ec-lmr-12">Heiko Oberdiek (inactive)</span><br class="and" /><span -class="ec-lmr-12">The </span><span class="LATEX"><span -class="ec-lmr-12">L</span><span class="A"><span -class="ec-lmr-12">A</span></span><span class="TEX"><span -class="ec-lmr-12">T</span><span -class="E"><span -class="ec-lmr-12">E</span></span><span -class="ec-lmr-12">X</span></span></span><span -class="ec-lmr-12">3 Project (</span><a +class="ec-lmr-12">The LaTeX3 Project (</span><a href="https://github.com/latex3/hyperref/issues" class="url" ><span class="ec-lmvtt-10x-x-120">https://github.com/latex3/hyperref/issues</span></a><span class="ec-lmr-12">)</span></div><br /> <div class="date" ><span -class="ec-lmr-12">January 2020</span></div> +class="ec-lmr-12">2020-05-15 v7.00e</span></div> </div> <h3 class="likesectionHead"><a id="x1-1000"></a>Contents</h3> @@ -372,10 +365,8 @@ correctly. <!--l. 231--><p class="indent" > The <span class="ec-lmri-10">href </span>and <span class="ec-lmri-10">name </span>commands must be paired with an <span -class="ec-lmri-10">end </span>command later in the <span class="TEX">T<span -class="E">E</span>X</span> file—the -<span class="TEX">T<span -class="E">E</span>X</span> commands between the two ends of a pair form an <span +class="ec-lmri-10">end </span>command later in the TeX file—the +TeX commands between the two ends of a pair form an <span class="ec-lmri-10">anchor </span>in the document. In the case of an <span class="ec-lmri-10">href</span> command, the <span @@ -405,17 +396,12 @@ options; at present, the following drivers are supported: <dl class="description"><dt class="description"> <span class="ec-lmbx-10">hypertex</span> </dt><dd -class="description">DVI processors conforming to the Hyper<span class="TEX">T<span -class="E">E</span>X</span> guidelines (i.e. <span +class="description">DVI processors conforming to the HyperTeX guidelines (i.e. <span class="ec-lmss-10">xdvi</span>, <span class="ec-lmss-10">dvips </span>(with the <span class="ec-lmss-10">-z</span> option), <span -class="ec-lmss-10">Oz</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span>, and <span +class="ec-lmss-10">OzTeX</span>, and <span class="ec-lmss-10">Textures</span>) </dd><dt class="description"> <span @@ -441,24 +427,16 @@ class="ec-lmss-10">dvips</span>, but a few variations remained before <span class="ec-lmbx-10">tex4ht</span> </dt><dd class="description">produces <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\special</span></span></span> commands for use with <span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span><span -class="ec-lmss-10">4ht</span> +class="ec-lmvtt-10">\special</span></span></span> commands for use with <span +class="ec-lmss-10">TeX4ht</span> </dd><dt class="description"> <span class="ec-lmbx-10">pdftex</span> </dt><dd -class="description">pdf<span class="TEX">T<span -class="E">E</span>X</span>, Hàn Thê´ Thành’s <span class="TEX">T<span -class="E">E</span>X</span> variant that writes PDF directly +class="description">pdfTeX, Hàn Thê´ Thành’s TeX variant that writes PDF directly </dd><dt class="description"> <span class="ec-lmbx-10">luatex</span> </dt><dd -class="description">lua<span class="TEX">T<span -class="E">E</span>X</span>, Unicode <span class="TEX">T<span -class="E">E</span>X</span> variant that writes PDF directly +class="description">luaTeX, Unicode TeX variant that writes PDF directly </dd><dt class="description"> <span class="ec-lmbx-10">dvipdfm</span> </dt><dd @@ -482,8 +460,7 @@ class="ec-lmvtt-10">\special</span></span></span> commands that Y&Y’s <span class="ec-lmbx-10">vtex</span> </dt><dd class="description">produces <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\special</span></span></span> commands that MicroPress’ HTML and PDF-producing <span class="TEX">T<span -class="E">E</span>X</span> variants +class="ec-lmvtt-10">\special</span></span></span> commands that MicroPress’ HTML and PDF-producing TeX variants interpret as hypertext jumps within the previewer </dd><dt class="description"> <span @@ -496,8 +473,7 @@ class="ec-lmss-10">Textures </span>interprets as hypertext jumps within the <span class="ec-lmbx-10">xetex</span> </dt><dd class="description">produces <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\special</span></span></span> commands for Xe<span class="TEX">T<span -class="E">E</span>X</span></dd></dl> +class="ec-lmvtt-10">\special</span></span></span> commands for XeTeX</dd></dl> <!--l. 273--><p class="indent" > Output from <span class="ec-lmss-10">dvips </span>or <span class="ec-lmss-10">dvipsone </span>must be processed using Acrobat Distiller to obtain a PDF @@ -508,8 +484,7 @@ The result is generally preferable to that produced by using the <span class="ec-lmss-10">hypertex </span>driver, and then processing with <span class="ec-lmss-10">dvips -z</span>, but the DVI file is not portable. The main advantage of using the -Hyper<span class="TEX">T<span -class="E">E</span>X</span> <span +HyperTeX <span class="ec-lmvtt-10">\special </span>commands is that you can also use the document in hypertext DVI viewers, such as <span class="ec-lmss-10">xdvi</span>. @@ -526,13 +501,10 @@ class="ec-lmvtt-10">driverfallback=dvipdfm</span></div> class="ec-lmss-10">pdftex</span>, <span class="ec-lmss-10">xetex</span>, <span class="ec-lmss-10">vtex</span>, <span -class="ec-lmss-10">vtexpdfmark</span>) are recognized from within <span class="TEX">T<span -class="E">E</span>X</span> and +class="ec-lmss-10">vtexpdfmark</span>) are recognized from within TeX and therefore cannot be given as value to option <span class="ec-lmss-10">driverfallback</span>. However a DVI driver program is run - after the <span class="TEX">T<span -class="E">E</span>X</span> run is finished. Thus it cannot be detected at <span class="TEX">T<span -class="E">E</span>X</span> macro level. Then package + after the TeX run is finished. Thus it cannot be detected at TeX macro level. Then package <span class="ec-lmss-10">hyperref </span>uses the driver, given by <span class="ec-lmss-10">driverfallback</span>. If the driver is already specified or can be @@ -541,9 +513,8 @@ class="ec-lmss-10">driverfallback </span>is ignored.</dd></dl> <h3 class="sectionHead"><span class="titlemark">2 </span> <a id="x1-30002"></a>Implicit behavior</h3> -<!--l. 304--><p class="noindent" >This package can be used with more or less any normal <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document by specifying in the -document preamble +<!--l. 304--><p class="noindent" >This package can be used with more or less any normal LaTeX document by specifying in the document +preamble <div class="verbatim" id="verbatim-1"> @@ -552,11 +523,10 @@ document preamble <!--l. 309--><p class="nopar" > <!--l. 311--><p class="indent" > Make sure it comes <span class="ec-lmri-10">last </span>of your loaded packages, to give it a fighting chance of not being over-written, -since its job is to redefine many <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> commands. Hopefully you will find that all cross-references -work correctly as hypertext. For example, <span -class="ec-lmvtt-10">\section </span>commands will produce a bookmark and a link, -whereas <span +since its job is to redefine many LaTeX commands. Hopefully you will find that all cross-references work +correctly as hypertext. For example, <span +class="ec-lmvtt-10">\section </span>commands will produce a bookmark and a link, whereas +<span class="ec-lmvtt-10">\section* </span>commands will only show links when paired with a corresponding <span class="ec-lmvtt-10">\addcontentsline</span> command. @@ -621,11 +591,9 @@ class="ec-lmvtt-10">hyperref.cfg</span>: </div> <!--l. 367--><p class="nopar" ></li></ul> <!--l. 370--><p class="indent" > As seen in the previous example, information entries (pdftitle, pdfauthor, …) should be set after the -package is loaded. Otherwise <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> expands the values of these options prematurely. Also -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> strips spaces in options. Especially option ‘pdfborder’ requires some care. Curly braces protect -the value, if given as package option. They are not necessary in <span class="obeylines-h"><span class="verb"><span +package is loaded. Otherwise LaTeX expands the values of these options prematurely. Also LaTeX strips +spaces in options. Especially option ‘pdfborder’ requires some care. Curly braces protect the value, if +given as package option. They are not necessary in <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypersetup</span></span></span>. @@ -634,8 +602,7 @@ class="ec-lmvtt-10">\hypersetup</span></span></span>.  <br />\hypersetup{pdfborder=0 0 0} </div> <!--l. 380--><p class="nopar" > -<!--l. 382--><p class="indent" > Package ‘kvoptions-patch’ patches <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> to make it aware of key value options and to prevent +<!--l. 382--><p class="indent" > Package ‘kvoptions-patch’ patches LaTeX to make it aware of key value options and to prevent premature value expansions. <!--l. 385--><p class="indent" > Some options can be given at any time, but many are restricted: before <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\begin{document}</span></span></span>, only in @@ -701,8 +668,7 @@ class="ec-lmvtt-10">implicit </span></td><td style="white-space:nowrap; te class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-4" -class="td11"> redefines <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> internals </td> +class="td11"> redefines LaTeX internals </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-1" class="td11"> <span @@ -940,8 +906,7 @@ class="ec-lmvtt-10">naturalnames </span></td><td style="white-space:nowrap; class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-4" -class="td11"> use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>-computed names for links </td> +class="td11"> use LaTeX-computed names for links </td> </tr><tr style="vertical-align:baseline;" id="TBL-3-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-1" class="td11"> <span @@ -1060,13 +1025,8 @@ wrong and displaced. <!--l. 578--><p class="noindent" >If no driver is specified, the package tries to find a driver in the following order: <ol class="enumerate1" > <li - class="enumerate" id="x1-8002x1">Autodetection, some <span class="TEX">T<span -class="E">E</span>X</span> processors can be detected at <span class="TEX">T<span -class="E">E</span>X</span> macro level (pdf<span class="TEX">T<span -class="E">E</span>X</span>, - Xe<span class="TEX">T<span -class="E">E</span>X</span>, V<span class="TEX">T<span -class="E">E</span>X</span>). + class="enumerate" id="x1-8002x1">Autodetection, some TeX processors can be detected at TeX macro level (pdfTeX, XeTeX, + VTeX). </li> <li class="enumerate" id="x1-8004x2">Option <span @@ -1152,8 +1112,7 @@ class="td01"><span class="ec-lmvtt-10">hypertex </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-8-2" class="td10"> <!--l. 602--><p class="noindent" >Sets up <span -class="ec-lmss-10">hyperref </span>for use with the Hyper<span class="TEX">T<span -class="E">E</span>X</span>-compliant drivers. </td> +class="ec-lmss-10">hyperref </span>for use with the HyperTeX-compliant drivers. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-1" class="td01"><span @@ -1196,12 +1155,8 @@ class="ec-lmss-10">dvips</span>. class="td01"><span class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-14-2" class="td10"> - <!--l. 610--><p class="noindent" >For use with <span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span><span -class="ec-lmss-10">4ht</span> </td> + <!--l. 610--><p class="noindent" >For use with <span +class="ec-lmss-10">TeX4ht</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-15-1" class="td01"><span @@ -1229,8 +1184,7 @@ class="ec-lmss-10">VTeX</span>’s PostScript backend. class="td01"><span class="ec-lmvtt-10">xetex </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-18-2" class="td10"> - <!--l. 615--><p class="noindent" >For use with Xe<span class="TEX">T<span -class="E">E</span>X</span> (using backend for dvipdfm). </td> + <!--l. 615--><p class="noindent" >For use with XeTeX (using backend for dvipdfm). </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-19-1" class="td01"> </td> @@ -1518,8 +1472,7 @@ class="td01"> </td> class="td01"> </td></tr> </table></div> <!--l. 668--><p class="noindent" >Note that all color names must be defined before use, following the normal system of the standard -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> <span +LaTeX <span class="ec-lmss-10">color </span>package. <!--l. 671--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.6 </span> <a @@ -1542,17 +1495,14 @@ class="ec-lmri-10">true </span></td><td style="white-space:normal; text-ali class="td10"> <!--l. 673--><p class="noindent" >A set of Acrobat bookmarks are written, in a manner similar to the table of contents, requiring - two passes of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>. Some postprocessing of + two passes of LaTeX. Some postprocessing of the bookmark file (file extension <span class="ec-lmvtt-10">.out</span>) may - be needed to translate <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> codes, since + be needed to translate LaTeX codes, since bookmarks must be written in PDFEncoding. To aid this process, the <span class="ec-lmvtt-10">.out </span>file is not rewritten - by <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> if it is edited to contain a line + by LaTeX if it is edited to contain a line <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\let\WriteBookmarks\relax</span></span></span> </td> </tr><tr @@ -1726,8 +1676,7 @@ class="td10"></td></tr> </table></div> <!--l. 714--><p class="noindent" >Note that the color of link borders can be specified <span class="ec-lmri-10">only </span>as 3 numbers in the range 0..1, giving an RGB -color. You cannot use colors defined in <span class="TEX">T<span -class="E">E</span>X</span>. Since version 6.76a this is no longer true. Especially with +color. You cannot use colors defined in TeX. Since version 6.76a this is no longer true. Especially with the help of package <span class="ec-lmss-10">xcolor </span>the usual color specifications of package <span class="ec-lmss-10">(x)color </span>can be used. For further @@ -1738,11 +1687,9 @@ class="ec-lmss-10">hycolor</span>. <!--l. 721--><p class="indent" > The bookmark commands are stored in a file called <span class="ec-lmri-10">jobname</span><span class="ec-lmvtt-10">.out</span>. The files is not processed by -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> so any markup is passed through. You can postprocess this file as needed; as an aid +LaTeX so any markup is passed through. You can postprocess this file as needed; as an aid for this, the <span -class="ec-lmvtt-10">.out </span>file is not overwritten on the next <span class="TEX">T<span -class="E">E</span>X</span> run if it is edited to contain the +class="ec-lmvtt-10">.out </span>file is not overwritten on the next TeX run if it is edited to contain the line @@ -1896,7 +1843,8 @@ class="td11"> <span class="ec-lmri-10">1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-12-4" class="td10"> <!--l. 750--><p class="noindent" >Determines on which page the PDF file is - opened. </td> + opened. An empty value means, the entry is + not set. </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-1" class="td01"><span @@ -2275,12 +2223,10 @@ class="td01"> </td> class="td01"> </td></tr> </table></div> <!--l. 814--><p class="noindent" >Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, which -is not the same as <span class="TEX">T<span -class="E">E</span>X</span>’s. The unit is bp and the origin is in the lower left corner. See also <span class="obeylines-h"><span class="verb"><span +is not the same as TeX’s. The unit is bp and the origin is in the lower left corner. See also <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypercalcbp</span></span></span> that is explained on page <a -href="#x1-180004.2">47<!--tex4ht:ref: hypercalcbp --></a>. pdf<span class="TEX">T<span -class="E">E</span>X</span> works by supplying default values for <span +href="#x1-180004.2">47<!--tex4ht:ref: hypercalcbp --></a>. pdfTeX works by supplying default values for <span class="ec-lmvtt-10">XYZ </span>(horizontal <span class="lmsy-10">×</span> vertical <span @@ -2924,11 +2870,7 @@ class="ec-lmvtt-10">hypertex </span></td><td style="white-space:nowrap class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-37-3" class="td10"> <!--l. 945--><p class="noindent" >use <span -class="ec-lmss-10">Hyper</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span> backend </td> +class="ec-lmss-10">HyperTeX </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-38-1" class="td01"><span @@ -2944,22 +2886,15 @@ class="ec-lmvtt-10">implicit </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-12-39-3" class="td10"> - <!--l. 947--><p class="noindent" >redefine <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> internals </td> + <!--l. 947--><p class="noindent" >redefine LaTeX internals </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-40-1" class="td01"><span class="ec-lmvtt-10">latex2html </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-40-2" class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-40-3" class="td10"> - <!--l. 948--><p class="noindent" >use <span class="LATEX"><span -class="ec-lmss-10">L</span><span class="A"><span -class="ec-lmss-10">A</span></span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span></span><span -class="ec-lmss-10">2HTML </span>backend </td> + <!--l. 948--><p class="noindent" >use <span +class="ec-lmss-10">LaTeX2HTML </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-41-1" class="td01"><span @@ -3028,8 +2963,7 @@ class="ec-lmvtt-10">naturalnames </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-12-49-3" class="td10"> - <!--l. 956--><p class="noindent" >use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>-computed names for links </td> + <!--l. 956--><p class="noindent" >use LaTeX-computed names for links </td> </tr><tr @@ -3359,11 +3293,7 @@ class="ec-lmvtt-10">pdftex </span></td><td style="white-space class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-91-3" class="td10"> <!--l. 1001--><p class="noindent" >use <span -class="ec-lmss-10">pdf</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span> backend </td> +class="ec-lmss-10">pdfTeX </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-92-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-92-1" class="td01"><span @@ -3458,11 +3388,7 @@ class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-12-102-3" class="td10"> <!--l. 1014--><p class="noindent" >raise up links (for <span -class="ec-lmss-10">Hyper</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span> backend) </td> +class="ec-lmss-10">HyperTeX </span>backend) </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-103-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-103-1" class="td01"><span @@ -3496,12 +3422,8 @@ class="td01"><span class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-107-2" class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-107-3" class="td10"> - <!--l. 1018--><p class="noindent" >use <span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span><span -class="ec-lmss-10">4ht </span>backend </td> + <!--l. 1018--><p class="noindent" >use <span +class="ec-lmss-10">TeX4ht </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-108-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-108-1" class="td01"><span @@ -3519,16 +3441,8 @@ class="ec-lmri-10">false </span></td><td style="white-space:normal; text- class="td10"> <!--l. 1020--><p class="noindent" >Unicode encoded pdf strings, by defaut true with <span -class="ec-lmss-10">Xe</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span> and <span -class="ec-lmss-10">Lu</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span> </td> +class="ec-lmss-10">XeTeX </span>and <span +class="ec-lmss-10">LuTeX</span> </td> </tr><tr @@ -3570,11 +3484,7 @@ class="ec-lmvtt-10">xetex </span></td><td style="white-space:nowrap class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-114-3" class="td10"> <!--l. 1025--><p class="noindent" >use <span -class="ec-lmss-10">Xe</span><span class="TEX"><span -class="ec-lmss-10">T</span><span -class="E"><span -class="ec-lmss-10">E</span></span><span -class="ec-lmss-10">X</span></span> backend </td> +class="ec-lmss-10">XeTeX </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-115-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-115-1" class="td01"> </td> @@ -4137,12 +4047,8 @@ class="td11"> <span class="ec-lmvtt-10">\pdfstringdef</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">macroname</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">}{</span></span></span><span class="TEX"><span -class="ec-lmri-10">T</span><span -class="E"><span -class="ec-lmri-10">E</span></span><span -class="ec-lmri-10">X</span></span><span -class="ec-lmri-10">string</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">TeXstring</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> <!--l. 1279--><p class="indent" > <span @@ -4156,8 +4062,7 @@ local: class="ec-lmvtt-10">\345</span></span></span>): <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\edef\3{\string\3}</span></span></span> </li> - <li class="itemize">Special glyphs of <span class="TEX">T<span -class="E">E</span>X</span>: <span class="obeylines-h"><span class="verb"><span + <li class="itemize">Special glyphs of TeX: <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\{</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\%</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\&</span></span></span>, <span class="obeylines-h"><span class="verb"><span @@ -4182,16 +4087,14 @@ class="ec-lmvtt-10">\discretionary</span></span></span>, <span class="obeylines- class="ec-lmvtt-10">\def</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\let</span></span></span>, etc. </li> - <li class="itemize"><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>’s font commands like <span class="obeylines-h"><span class="verb"><span + <li class="itemize">LaTeX’s font commands like <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\textbf</span></span></span>, etc. </li> <li class="itemize">Support for <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\xspace</span></span></span> provided by the <span class="ec-lmss-10">xspace </span>package</li></ul> <!--l. 1295--><p class="indent" > In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in -the PDF string. For further details, see Heiko Oberdiek’s Euro<span class="TEX">T<span -class="E">E</span>X</span> paper distributed with +the PDF string. For further details, see Heiko Oberdiek’s EuroTeX paper distributed with <span class="ec-lmss-10">hyperref</span>. <!--l. 1299--><p class="noindent" > @@ -4294,8 +4197,7 @@ class="ec-lmbx-10">Hint: </span>Package <span class="ec-lmss-10">bookmark </span>replaces <span class="ec-lmss-10">hyperref</span>’s bookmark organization by a new algorithm: <ul class="itemize1"> - <li class="itemize">Usually only one <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run is needed. + <li class="itemize">Usually only one LaTeX run is needed. </li> <li class="itemize">More control over the bookmark appearance (color, font). </li> @@ -4319,12 +4221,8 @@ id="TBL-37-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-37-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-37-1-1" class="td11"> <span class="ec-lmvtt-10">\texorpdfstring</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">{</span></span></span><span class="TEX"><span -class="ec-lmri-10">T</span><span -class="E"><span -class="ec-lmri-10">E</span></span><span -class="ec-lmri-10">X</span></span><span -class="ec-lmri-10">string</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">TeXstring</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">PDFstring</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> @@ -4386,8 +4284,7 @@ class="ec-lmri-10">dimen specification</span><span class="obeylines-h"><span cla class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> <!--l. 1401--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hypercalcbp</span></span></span> takes a <span class="TEX">T<span -class="E">E</span>X</span> dimen specification and converts it to bp and returns the number +class="ec-lmvtt-10">\hypercalcbp</span></span></span> takes a TeX dimen specification and converts it to bp and returns the number without the unit. This is useful for options <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">pdfview</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">pdfstartview</span></span></span> and <span class="obeylines-h"><span class="verb"><span @@ -4675,7 +4572,7 @@ provide a representation without accents instead of wrong accents: <!--l. 1679--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">5.10 </span> <a id="x1-290005.10"></a>Customizing index style file with \nohyperpage</h4> -<!--l. 1681--><p class="noindent" >Since version 2008/08/14 v6.78f. +<!--l. 1681--><p class="noindent" >Since version 2008/08/14 v6.78f. <!--l. 1685--><p class="indent" > For hyperlink support in the index, hyperref inserts <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyperpage</span></span></span> into the index macros. After processing with Makeindex, <span class="obeylines-h"><span class="verb"><span @@ -5061,7 +4958,7 @@ class="ec-lmvtt-10">\toclevel@<name></span></span></span>. Example class="ec-lmss-10">pdfescapeform</span></h4> <!--l. 2049--><p class="noindent" >There are many places where arbitrary strings end up as PS or PDF strings. The PS/PDF strings in parentheses form require the protection of some characters, e.g. unmatched left or right parentheses need -escaping or the escape character itself (backslash). Since 2006/02/12 v6.75a the PS/PDF driver +escaping or the escape character itself (backslash). Since 2006/02/12 v6.75a the PS/PDF driver should do this automatically. However I assume a problem with compatibility, especially regarding the form part where larger amounts of JavaScript code can be present. It would be a pain to remove all the escaping, because an additional escaping layer can falsify the @@ -6853,12 +6750,9 @@ class="ec-lmvtt-10">\vpageref[]{...}</span></span></span> On the same page a pre as unicode strings. Only if the string restricts to the printable ASCII set, it is written as ASCII string. The reason is that the <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\special</span></span></span> does not support PDFDocEncoding. -<!--l. 2989--><p class="indent" > XeTeX uses the program xdvipdfmx for PDF output generation. This program behaves a little -different from dvipdfm, because of the supported Unicode characters. Strings for bookmarks or -information entries can be output directly. The big chars (char code > 255) are written in UTF-8 and -xdvipdfmx tries to convert them to UTF-16BE. However hyperref already provides PDF strings encoded -in UTF-16BE, thus the result is a warning -<!--l. 2998--><p class="indent" > <span class="obeylines-h"><span class="verb"><span +<!--l. 2987--><p class="indent" > In older versions hyperref contained special conversion code from UTF-16BE back to UTF-8 in a +number of places for xetex to avoid the xdvipdfmx warning +<!--l. 2991--><p class="indent" > <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">Failed</span><span class="ec-lmvtt-10"> to</span><span class="ec-lmvtt-10"> convert</span><span @@ -6866,42 +6760,20 @@ class="ec-lmvtt-10"> input</span><span class="ec-lmvtt-10"> string</span><span class="ec-lmvtt-10"> to</span><span class="ec-lmvtt-10"> UTF16...</span></span></span> -<!--l. 3000--><p class="indent" > The best way would be, if xdvipdfm could detect the byte order marker (<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\376\377</span></span></span>) and skips the -conversion if that marker is present. -<!--l. 3004--><p class="indent" > For the time being I added the following to hyperref, when option ‘pdfencoding=auto’ is set (default -for XeTeX): The string is converted back to big characters thus that the string is written as UTF-8. But -I am very unhappy with this solution. Main disadvantage: Two versions of <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\pdfstringdef</span></span></span> are -needed: -<!--l. 3011--><p class="indent" > a) The string is converted back to big characters for the “tainted key” of xdvipdfmx -(<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">spc_pdfm.c:</span><span -class="ec-lmvtt-10"> default_taintkeys</span></span></span>). The subset hyperref uses is /Title, /Author, /Subject, -/Keywords, /Creator, /Producer, /T. Any changes of this set in xdvipdfmx cannot be detected by -hyperref. -<!--l. 3017--><p class="indent" > b) Without conversion for the other strings , providing UTF16be directly. Examples: Prefix of page -labels, some elements of formulars. -<!--l. 3021--><p class="indent" > Thus <span -class="ec-lmbx-10">each </span>application that uses <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\pdfstringdef</span></span></span> now must check, if it defines a string -for some of the tained keys. If yes, then the call of <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\pdfstringdef</span></span></span> should be preceded by +<!--l. 2993--><p class="indent" > This is no longer needed with a current xdvipdfmx, so this code has been removed. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\csname</span><span -class="ec-lmvtt-10"> HyPsd@XeTeXBigCharstrue\endcsname</span></span></span>. Example: package bookmark. -<!--l. 3029--><p class="noindent" > +class="ec-lmvtt-10"> HyPsd@XeTeXBigCharstrue\endcsname</span></span></span> should no longer be used. +<!--l. 2999--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">10 </span> <a id="x1-9700010"></a>Limitations<span class="footnote-mark"><a href="manual6.html#fn5x0"><sup class="textsuperscript">5</sup></a></span><a id="x1-97001f5"></a> </h3> <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a id="x1-9800010.1"></a>Wrapped/broken link support</h4> -<!--l. 3032--><p class="noindent" >Only few drivers support automatically wrapped/broken links, e.g. pdftex, dvipdfm, hypertex. Other +<!--l. 3002--><p class="noindent" >Only few drivers support automatically wrapped/broken links, e.g. pdftex, dvipdfm, hypertex. Other drivers lack this feature, e.g. dvips, dvipsone. -<!--l. 3036--><p class="indent" > Workarounds: - - +<!--l. 3006--><p class="indent" > Workarounds: <ul class="itemize1"> <li class="itemize">For long section or caption titles in the table of contents or list of figures/tables option <span @@ -6917,23 +6789,25 @@ class="ec-lmss-10">breakurl</span>. class="ec-lmss-10">breaklinks </span>is intended for internal use. But it can be used to force link wrapping, e.g. when printing a document. However, when such a document is converted to PDF and viewed with a PDF viewer, the active link area will be misplaced. - <!--l. 3050--><p class="noindent" >Another limitation: some penalties are “optimized” by TeX, thus there are missing break + <!--l. 3020--><p class="noindent" >Another limitation: some penalties are “optimized” by TeX, thus there are missing break points, especially within <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\url</span></span></span>. (See thread “hyperref.sty, breaklinks and url.sty 3.2” in comp.text.tex 2005-09).</li></ul> -<!--l. 3056--><p class="noindent" > + + +<!--l. 3026--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a id="x1-9900010.2"></a>Links across pages</h4> -<!--l. 3058--><p class="noindent" >In general they have problems: +<!--l. 3028--><p class="noindent" >In general they have problems: <ul class="itemize1"> <li class="itemize">Some driver doesn’t support them at all (see above). </li> <li class="itemize">The driver allows it, but the link result might include the footer and/or header, or an error message can occur sometimes.</li></ul> -<!--l. 3066--><p class="noindent" > +<!--l. 3036--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a id="x1-10000010.3"></a>Footnotes</h4> -<!--l. 3068--><p class="noindent" >LaTeX allows the separation of the footnote mark and the footnote text (<span class="obeylines-h"><span class="verb"><span +<!--l. 3038--><p class="noindent" >LaTeX allows the separation of the footnote mark and the footnote text (<span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotemark</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotetext</span></span></span>). This interface might be enough for visual typesetting. But the relation between @@ -6946,17 +6820,17 @@ which <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotemark</span></span></span> references which <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotetext</span></span></span>. But that is necessary to implement hyperlinking. Thus the implementation of hyperref does not support the optional argument of <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\footnotemark\verb</span></span></span> -and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> and +<span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotetext</span></span></span>. -<!--l. 3079--><p class="noindent" > +<!--l. 3049--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">11 </span> <a id="x1-10100011"></a>Hints<span class="footnote-mark"><a href="manual7.html#fn6x0"><sup class="textsuperscript">6</sup></a></span><a id="x1-101001f6"></a> </h3> <h4 class="subsectionHead"><span class="titlemark">11.1 </span> <a id="x1-10200011.1"></a>Spaces in option values</h4> -<!--l. 3083--><p class="noindent" >Unhappily LaTeX strips spaces from options if they are given in <span class="obeylines-h"><span class="verb"><span +<!--l. 3053--><p class="noindent" >Unhappily LaTeX strips spaces from options if they are given in <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\documentclass</span></span></span> or <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\usepackage</span></span></span> (or <span class="obeylines-h"><span class="verb"><span @@ -6966,35 +6840,35 @@ class="ec-lmvtt-10">\RequirePackage</span></span></span>), e.g.: <div class="verbatim" id="verbatim-71">     \usepackage[pdfborder=0 0 1]{hyperref} </div> -<!--l. 3087--><p class="nopar" > Package hyperref now gets +<!--l. 3057--><p class="nopar" > Package hyperref now gets <div class="verbatim" id="verbatim-72">     pdfborder=001 </div> -<!--l. 3091--><p class="nopar" > and the result is an invalid PDF file. As workaround braces can be used: +<!--l. 3061--><p class="nopar" > and the result is an invalid PDF file. As workaround braces can be used: <div class="verbatim" id="verbatim-73">     \usepackage[pdfborder={0 0 1}]{hyperref} </div> -<!--l. 3096--><p class="nopar" > Some options can also be given in <span class="obeylines-h"><span class="verb"><span +<!--l. 3066--><p class="nopar" > Some options can also be given in <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypersetup</span></span></span> <div class="verbatim" id="verbatim-74">     \hypersetup{pdfborder=0 0 1} </div> -<!--l. 3100--><p class="nopar" > In <span class="obeylines-h"><span class="verb"><span +<!--l. 3070--><p class="nopar" > In <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypersetup</span></span></span> the options are directly processed as key value options (see package keyval) without space stripping in the value part. -<!--l. 3106--><p class="indent" > Alternatively, LaTeX’s option handling system can be adapted to key value options by one of the +<!--l. 3076--><p class="indent" > Alternatively, LaTeX’s option handling system can be adapted to key value options by one of the packages <span class="ec-lmss-10">kvoptions-patch </span>(from project <span class="ec-lmss-10">kvoptions</span>) or <span class="ec-lmss-10">xkvltxp </span>(from project <span class="ec-lmss-10">xsetkeys</span>). -<!--l. 3111--><p class="noindent" > +<!--l. 3081--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">11.2 </span> <a id="x1-10300011.2"></a>Index with makeindex</h4> <ul class="itemize1"> @@ -7024,7 +6898,7 @@ class="ec-lmvtt-10">\hyperpage</span></span></span> command. With  <br />      ...  <br />      \index{Some example|main} </div> - <!--l. 3135--><p class="nopar" > + <!--l. 3105--><p class="nopar" > </li> <li class="itemize">Scientic Word/Scientific WorkPlace users can use package robustindex with hyperindex=false. </li> @@ -7035,7 +6909,7 @@ class="ec-lmss-10">encap</span>. Example for use of “?”: <div class="verbatim" id="verbatim-76">       \usepackage[encap=?]{hyperref} </div> - <!--l. 3142--><p class="nopar" > + <!--l. 3112--><p class="nopar" > </li> <li class="itemize">Another possibility is the insertion of <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyperpage</span></span></span> by a style file for makeindex. For this case, @@ -7057,12 +6931,12 @@ class="ec-lmvtt-10">\hyperpage</span></span></span> will be defined regardless o  <br />encap_suffix "}"  <br />%%% cut %%% hyperindex.ist %%% cut %%% </div> - <!--l. 3158--><p class="nopar" ></li></ul> -<!--l. 3161--><p class="noindent" > + <!--l. 3128--><p class="nopar" ></li></ul> +<!--l. 3131--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">11.3 </span> <a id="x1-10400011.3"></a>Warning <span class="ec-lmvtt-10">"bookmark level for unknown <foobar> defaults to 0"</span></h4> -<!--l. 3163--><p class="noindent" >Getting rid of it: +<!--l. 3133--><p class="noindent" >Getting rid of it: <div class="verbatim" id="verbatim-78"> @@ -7070,16 +6944,16 @@ class="ec-lmvtt-10">"bookmark level for unknown <foobar> defaults  <br />\providecommand*{\toclevel@<foobar>}{0}  <br />\makeatother </div> -<!--l. 3168--><p class="nopar" > -<!--l. 3170--><p class="noindent" > +<!--l. 3138--><p class="nopar" > +<!--l. 3140--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">11.4 </span> <a id="x1-10500011.4"></a>Link anchors in figures</h4> -<!--l. 3172--><p class="noindent" >The caption command increments the counter and here is the place where hyperref set the corresponding +<!--l. 3142--><p class="noindent" >The caption command increments the counter and here is the place where hyperref set the corresponding anchor. Unhappily the caption is set below the figure, so the figure is not visible if a link jumps to a figure. In this case, try package <span class="ec-lmss-10">hypcap </span>that implements a method to circumvent the problem. -<!--l. 3180--><p class="noindent" > +<!--l. 3150--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">11.5 </span> <a id="x1-10600011.5"></a>Additional unicode characters in bookmarks and pdf information entries:</h4> @@ -7088,14 +6962,14 @@ problem. \documentclass[pdftex]{article}  <br />\usepackage[unicode]{hyperref} </div> -<!--l. 3184--><p class="nopar" > -<!--l. 3186--><p class="indent" > Support for additional unicode characters: -<!--l. 3188--><p class="indent" > Example: <span class="obeylines-h"><span class="verb"><span +<!--l. 3154--><p class="nopar" > +<!--l. 3156--><p class="indent" > Support for additional unicode characters: +<!--l. 3158--><p class="indent" > Example: <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\.{a}</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\d{a}</span></span></span> -<!--l. 3190--><p class="indent" > 1. Get a list with unicode data, eg: -<!--l. 3192--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt -<!--l. 3194--><p class="indent" > 2. Identify the characters (<span class="obeylines-h"><span class="verb"><span +<!--l. 3160--><p class="indent" > 1. Get a list with unicode data, eg: +<!--l. 3162--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt +<!--l. 3164--><p class="indent" > 2. Identify the characters (<span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\.{a}</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\d{a}</span></span></span>): @@ -7104,9 +6978,9 @@ class="ec-lmvtt-10">\d{a}</span></span></span>):     0227;LATIN SMALL LETTER A WITH DOT ABOVE;...  <br />    1EA1;LATIN SMALL LETTER A WITH DOT BELOW;... </div> -<!--l. 3198--><p class="nopar" > -<!--l. 3200--><p class="indent" > 3. Calculate the octal code: -<!--l. 3202--><p class="indent" > The first characters of the line in the file are hex values, convert each byte and prepend them with a +<!--l. 3168--><p class="nopar" > +<!--l. 3170--><p class="indent" > 3. Calculate the octal code: +<!--l. 3172--><p class="indent" > The first characters of the line in the file are hex values, convert each byte and prepend them with a backslash. (This will go into the PDF file.) @@ -7114,9 +6988,9 @@ backslash. (This will go into the PDF file.)     0227 -> \002\047  <br />    1EA1 -> \036\241 </div> -<!--l. 3209--><p class="nopar" > -<!--l. 3211--><p class="indent" > 4. Transform into a form understood by hyperref: -<!--l. 3213--><p class="indent" > Hyperref must know where the first byte starts, this is marked by <span class="obeylines-h"><span class="verb"><span +<!--l. 3179--><p class="nopar" > +<!--l. 3181--><p class="indent" > 4. Transform into a form understood by hyperref: +<!--l. 3183--><p class="indent" > Hyperref must know where the first byte starts, this is marked by <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">9</span></span></span> (8 and 9 cannot occur in octal numbers): @@ -7125,8 +6999,8 @@ numbers):     \002\047 -> \9002\047  <br />    \036\241 -> \9036\241 </div> -<!--l. 3220--><p class="nopar" > -<!--l. 3222--><p class="indent" > Optional: <span class="obeylines-h"><span class="verb"><span +<!--l. 3190--><p class="nopar" > +<!--l. 3192--><p class="indent" > Optional: <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">8</span></span></span> is used for abbreviations: @@ -7135,8 +7009,8 @@ class="ec-lmvtt-10">8</span></span></span> is used for abbreviations:  <br />  <br />    \9002\047 -> \82\047 </div> -<!--l. 3228--><p class="nopar" > -<!--l. 3230--><p class="indent" > 5. Declare the character with LaTeX: +<!--l. 3198--><p class="nopar" > +<!--l. 3200--><p class="indent" > 5. Declare the character with LaTeX: <div class="verbatim" id="verbatim-84"> @@ -7148,11 +7022,11 @@ class="ec-lmvtt-10">8</span></span></span> is used for abbreviations:  <br />\end{document}  <br />       </div> -<!--l. 3239--><p class="nopar" > -<!--l. 3241--><p class="noindent" > +<!--l. 3209--><p class="nopar" > +<!--l. 3211--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">11.6 </span> <a id="x1-10700011.6"></a>Footnotes</h4> -<!--l. 3243--><p class="noindent" >The footnote support is rather limited. It is beyond the scope to use <span class="obeylines-h"><span class="verb"><span +<!--l. 3213--><p class="noindent" >The footnote support is rather limited. It is beyond the scope to use <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotemark</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\footnotetext</span></span></span> out of order or reusing <span class="obeylines-h"><span class="verb"><span @@ -7210,12 +7084,12 @@ class="ec-lmvtt-10">hyperfootnotes=false</span></span></span> or fiddle with int  <br />  <br />\end{document} </div> -<!--l. 3297--><p class="nopar" > +<!--l. 3267--><p class="nopar" > -<!--l. 3299--><p class="noindent" > +<!--l. 3269--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">11.7 </span> <a id="x1-10800011.7"></a>Subordinate counters</h4> -<!--l. 3301--><p class="noindent" >Some counters do not have unique values and require the value of other counters to be unique. For +<!--l. 3271--><p class="noindent" >Some counters do not have unique values and require the value of other counters to be unique. For example, sections or figures might be numbered within chapters or <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\newtheorem</span></span></span> is used with an optional counter argument. Internally LaTeX uses <span class="obeylines-h"><span class="verb"><span @@ -7224,13 +7098,13 @@ another counter. Package hyperref hooks into <span class="obeylines-h"><span cla class="ec-lmvtt-10">\@addtoreset</span></span></span> to catch this situation. Also <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\numberwithin</span></span></span> of package amsmath is caught by hyperref. -<!--l. 3311--><p class="indent" > However, if the definition of subordinate counters take place before hyperref is loaded, the old +<!--l. 3281--><p class="indent" > However, if the definition of subordinate counters take place before hyperref is loaded, the old meaning of <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\@addtoreset</span></span></span> is called without hyperref’s additions. Then the companion counter macro <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\theH<counter></span></span></span> can be redefined accordingly. Or move the definition of subordinate counters after hyperref is loaded. -<!--l. 3317--><p class="indent" > Example for <span class="obeylines-h"><span class="verb"><span +<!--l. 3287--><p class="indent" > Example for <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\newtheorem</span></span></span>, problematic case: @@ -7238,14 +7112,14 @@ class="ec-lmvtt-10">\newtheorem</span></span></span>, problematic case:     \newtheorem{corA}{CorollaryA}[section]  <br />    \usepackage{hyperref} </div> -<!--l. 3321--><p class="nopar" > Solution a) +<!--l. 3291--><p class="nopar" > Solution a) <div class="verbatim" id="verbatim-87">     \usepackage{hyperref}  <br />    \newtheorem{corA}{CorollaryA}[section} </div> -<!--l. 3326--><p class="nopar" > Solution b) +<!--l. 3296--><p class="nopar" > Solution b) <div class="verbatim" id="verbatim-88"> @@ -7253,11 +7127,11 @@ class="ec-lmvtt-10">\newtheorem</span></span></span>, problematic case:  <br />    \usepackage{hyperref}  <br />    \newcommand*{\theHcorA}{\theHsection.\number\value{corA}} </div> -<!--l. 3332--><p class="nopar" > -<!--l. 3334--><p class="noindent" > +<!--l. 3302--><p class="nopar" > +<!--l. 3304--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">12 </span> <a id="x1-10900012"></a>History and acknowledgments</h3> -<!--l. 3336--><p class="noindent" >The original authors of <span +<!--l. 3306--><p class="noindent" >The original authors of <span class="ec-lmss-10">hyperbasics.tex </span>and <span class="ec-lmss-10">hypertex.sty</span>, from which this package descends, are Tanmoy Bhattacharya and Thorsten Ohl. Package <span @@ -7270,13 +7144,12 @@ Carlisle, T. V. Raman and Leslie Lamport for comments, requests, t get the package into its first useable state. Various other people are mentioned at the point in the source where I had to change the code in later versions because of problems they found. -<!--l. 3349--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has -made the package more robust. The days spent on Rev<span class="TEX">T<span -class="E">E</span>X</span> are entirely due to him! The +<!--l. 3319--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has +made the package more robust. The days spent on RevTeX are entirely due to him! The investigations of Bill Moss into the later versions including native PDF support uncovered a good many bugs, and his testing is appreciated. Hans Hagen provided a lot of insight into PDF. -<!--l. 3357--><p class="indent" > Berthold Horn provided help, encouragement and sponsorship for the <span +<!--l. 3327--><p class="indent" > Berthold Horn provided help, encouragement and sponsorship for the <span class="ec-lmss-10">dvipsone </span>and <span class="ec-lmss-10">dviwindo </span>drivers. Sergey Lesenko provided the changes needed for <span @@ -7290,14 +7163,14 @@ class="ec-lmss-10">hyper </span>package (developed in parallel with <span class="ec-lmss-10">hyperref</span>) showed me solutions for some problems. Hopefully the two packages will combine one day. -<!--l. 3366--><p class="indent" > The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and +<!--l. 3336--><p class="indent" > The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and ideas; Thomas Merz, whose book <span class="ec-lmri-10">Web Publishing with Acrobat/PDF </span>provided crucial insights; D. P. Story, whose detailed article about pdfmarks and forms solved many practical problems; and Hans Hagen, who explained how to do it in <span class="ec-lmss-10">pdftex</span>. -<!--l. 3372--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost. -<!--l. 3375--><p class="indent" > Especial extra thanks to David Carlisle for the <span +<!--l. 3342--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost. +<!--l. 3345--><p class="indent" > Especial extra thanks to David Carlisle for the <span class="ec-lmss-10">backref </span>module, the ps2pdf and dviwindo support, frequent general rewrites of my bad code, and for working on changes to the <span class="ec-lmss-10">xr </span>package to suit @@ -7309,7 +7182,7 @@ class="ec-lmss-10">hyperref</span>. id="x1-11000013"></a>GNU Free Documentation License</h3> <!--l. 6--><p class="noindent" >Version 1.2, November 2002 <!--l. 9--><p class="indent" > Copyright <span -class="lmsy-10">©</span> 2000,2001,2002 Free Software Foundation, Inc.<br +class="ts1-lmr10-">©</span> 2000,2001,2002 Free Software Foundation, Inc.<br class="newline" />59 Temple Place, Suite 330, Boston, MA 02111-1307 USA<br class="newline" />Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. @@ -7371,8 +7244,7 @@ discourage subsequent modification by readers is not Transparent. An image forma Transparent if used for any substantial amount of text. A copy that is not “Transparent” is called “Opaque”. <!--l. 93--><p class="indent" > Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo -input format, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> input format, SGML or XML using a publicly available DTD, and +input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML @@ -7632,7 +7504,7 @@ put the following copyright and license notices just after the title page: <!--l. 399--><p class="indent" > <div class="quote"> <!--l. 400--><p class="noindent" >Copyright <span -class="lmsy-10">©</span> YEAR YOUR NAME. Permission is granted to copy, distribute and/or +class="ts1-lmr10-">©</span> YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the |