summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/hyperref/doc/manual.html
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/hyperref/doc/manual.html')
-rw-r--r--macros/latex/contrib/hyperref/doc/manual.html410
1 files changed, 141 insertions, 269 deletions
diff --git a/macros/latex/contrib/hyperref/doc/manual.html b/macros/latex/contrib/hyperref/doc/manual.html
index 4a4f4ab6d8..5dc0901e62 100644
--- a/macros/latex/contrib/hyperref/doc/manual.html
+++ b/macros/latex/contrib/hyperref/doc/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>&#x00A0;file&#8212;the
-<span class="TEX">T<span
-class="E">E</span>X</span>&#x00A0;commands between the two ends of a pair form an <span
+class="ec-lmri-10">end </span>command later in the TeX&#x00A0;file&#8212;the
+TeX&#x00A0;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>&#x00A0;guidelines (i.e.&#x00A0;<span
+class="description">DVI processors conforming to the HyperTeX&#x00A0;guidelines (i.e.&#x00A0;<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&#8217;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&#8217;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&amp;Y&#8217;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&#8217; HTML and PDF-producing <span class="TEX">T<span
-class="E">E</span>X</span>&#x00A0;variants
+class="ec-lmvtt-10">\special</span></span></span> commands that MicroPress&#8217; HTML and PDF-producing TeX&#x00A0;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>&#x00A0;<span
+HyperTeX&#x00A0;<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>&#x00A0;and
+class="ec-lmss-10">vtexpdfmark</span>) are recognized from within TeX&#x00A0;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>&#x00A0;run is finished. Thus it cannot be detected at <span class="TEX">T<span
-class="E">E</span>X</span>&#x00A0;macro level. Then package
+ after the TeX&#x00A0;run is finished. Thus it cannot be detected at TeX&#x00A0;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>&#x00A0;document by specifying in the
-document preamble
+<!--l. 304--><p class="noindent" >This package can be used with more or less any normal LaTeX&#x00A0;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>&#x00A0;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&#x00A0;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, &#x2026;) 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>&#x00A0;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>&#x00A0;strips spaces in options. Especially option &#8216;pdfborder&#8217; 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&#x00A0;expands the values of these options prematurely. Also LaTeX&#x00A0;strips
+spaces in options. Especially option &#8216;pdfborder&#8217; 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>.
&#x00A0;<br />\hypersetup{pdfborder=0&#x00A0;0&#x00A0;0}
</div>
<!--l. 380--><p class="nopar" >
-<!--l. 382--><p class="indent" > Package &#8216;kvoptions-patch&#8217; patches <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
-class="E">E</span>X</span></span>&#x00A0;to make it aware of key value options and to prevent
+<!--l. 382--><p class="indent" > Package &#8216;kvoptions-patch&#8217; patches LaTeX&#x00A0;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>&#x00A0;internals </td>
+class="td11"> redefines LaTeX&#x00A0;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>&#x00A0;processors can be detected at <span class="TEX">T<span
-class="E">E</span>X</span>&#x00A0;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&#x00A0;processors can be detected at TeX&#x00A0;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>&#8217;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>&#x00A0;(using backend for dvipdfm). </td>
+ <!--l. 615--><p class="noindent" >For use with XeTeX&#x00A0;(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>&#x00A0;<span
+LaTeX&#x00A0;<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>&#x00A0;codes, since
+ be needed to translate LaTeX&#x00A0;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>&#x00A0;if it is edited to contain a line
+ by LaTeX&#x00A0;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>&#x00A0;so any markup is passed through. You can postprocess this file as needed; as an aid
+LaTeX&#x00A0;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>&#x00A0;run if it is edited to contain the
+class="ec-lmvtt-10">.out </span>file is not overwritten on the next TeX&#x00A0;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>&#8217;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&#8217;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>&#x00A0;works by supplying default values for <span
+href="#x1-180004.2">47<!--tex4ht:ref: hypercalcbp --></a>. pdfTeX&#x00A0;works by supplying default values for <span
class="ec-lmvtt-10">XYZ </span>(horizontal <span
class="lmsy-10">&#x00D7;</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>&#x00A0;internals </td>
+ <!--l. 947--><p class="noindent" >redefine LaTeX&#x00A0;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">\&amp;</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>&#8217;s font commands like <span class="obeylines-h"><span class="verb"><span
+ <li class="itemize">LaTeX&#8217;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&#8217;s Euro<span class="TEX">T<span
-class="E">E</span>X</span>&#x00A0;paper distributed with
+the PDF string. For further details, see Heiko Oberdiek&#8217;s EuroTeX&#x00A0;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>&#8217;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>&#x00A0;run is needed.
+ <li class="itemize">Usually only one LaTeX&#x00A0;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>&#x00A0;dimen specification and converts it to bp and returns the number
+class="ec-lmvtt-10">\hypercalcbp</span></span></span> takes a TeX&#x00A0;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&#x00A0;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@&#x003C;name&#x003E;</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&#x00A0;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 &#x003E; 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">&#x00A0;to</span><span
class="ec-lmvtt-10">&#x00A0;convert</span><span
@@ -6866,42 +6760,20 @@ class="ec-lmvtt-10">&#x00A0;input</span><span
class="ec-lmvtt-10">&#x00A0;string</span><span
class="ec-lmvtt-10">&#x00A0;to</span><span
class="ec-lmvtt-10">&#x00A0;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 &#8216;pdfencoding=auto&#8217; 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 &#8220;tainted key&#8221; of xdvipdfmx
-(<span class="obeylines-h"><span class="verb"><span
-class="ec-lmvtt-10">spc_pdfm.c:</span><span
-class="ec-lmvtt-10">&#x00A0;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">&#x00A0;HyPsd@XeTeXBigCharstrue\endcsname</span></span></span>. Example: package bookmark.
-<!--l. 3029--><p class="noindent" >
+class="ec-lmvtt-10">&#x00A0;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 &#8220;optimized&#8221; by TeX, thus there are missing break
+ <!--l. 3020--><p class="noindent" >Another limitation: some penalties are &#8220;optimized&#8221; 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 &#8220;hyperref.sty, breaklinks and url.sty 3.2&#8221; 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&#8217;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">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage[pdfborder=0&#x00A0;0&#x00A0;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">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;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">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage[pdfborder={0&#x00A0;0&#x00A0;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">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\hypersetup{pdfborder=0&#x00A0;0&#x00A0;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&#8217;s option handling system can be adapted to key value options by one of the
+<!--l. 3076--><p class="indent" > Alternatively, LaTeX&#8217;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
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;...
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\index{Some&#x00A0;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 &#8220;?&#8221;:
<div class="verbatim" id="verbatim-76">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\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
&#x00A0;<br />encap_suffix&#x00A0;"}"
&#x00A0;<br />%%%&#x00A0;cut&#x00A0;%%%&#x00A0;hyperindex.ist&#x00A0;%%%&#x00A0;cut&#x00A0;%%%
</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 &#x003C;foobar&#x003E; 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 &#x003C;foobar&#x003E; defaults
&#x00A0;<br />\providecommand*{\toclevel@&#x003C;foobar&#x003E;}{0}
&#x00A0;<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}
&#x00A0;<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>):
&#x00A0;&#x00A0;&#x00A0;&#x00A0;0227;LATIN&#x00A0;SMALL&#x00A0;LETTER&#x00A0;A&#x00A0;WITH&#x00A0;DOT&#x00A0;ABOVE;...
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;1EA1;LATIN&#x00A0;SMALL&#x00A0;LETTER&#x00A0;A&#x00A0;WITH&#x00A0;DOT&#x00A0;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.)
&#x00A0;&#x00A0;&#x00A0;&#x00A0;0227&#x00A0;-&#x003E;&#x00A0;\002\047
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;1EA1&#x00A0;-&#x003E;&#x00A0;\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):
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\002\047&#x00A0;-&#x003E;&#x00A0;\9002\047
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\036\241&#x00A0;-&#x003E;&#x00A0;\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:
&#x00A0;<br />
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\9002\047&#x00A0;-&#x003E;&#x00A0;\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:
&#x00A0;<br />\end{document}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;
</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
&#x00A0;<br />
&#x00A0;<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&#8217;s additions. Then the companion counter macro
<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\theH&#x003C;counter&#x003E;</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:
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\newtheorem{corA}{CorollaryA}[section]
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 3321--><p class="nopar" > Solution a)
+<!--l. 3291--><p class="nopar" > Solution a)
<div class="verbatim" id="verbatim-87">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\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:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\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.&#x00A0;V.&#x00A0;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>&#x00A0;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&#x00A0;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.&#x00A0;V.&#x00A0;Raman, for encouragement, support and
+<!--l. 3336--><p class="indent" > The forms creation section owes a great deal to: T.&#x00A0;V.&#x00A0;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.&#x00A0;P.&#x00A0;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>&#x00A0;2000,2001,2002 Free Software Foundation, Inc.<br
+class="ts1-lmr10-">©</span>&#x00A0;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 &#8220;Transparent&#8221; is called
&#8220;Opaque&#8221;.
<!--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>&#x00A0;input format, SGML or XML using a publicly available DTD, and
+input format, LaTeX&#x00A0;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>&#x00A0;YEAR YOUR NAME. Permission is granted to copy, distribute and/or
+class="ts1-lmr10-">©</span>&#x00A0;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