summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/hyperref/manual.html
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-12-01 22:48:59 +0000
committerKarl Berry <karl@freefriends.org>2018-12-01 22:48:59 +0000
commit023a233b9dc96748a3e537d5c05ff278f707213a (patch)
tree0375ab59e7c0c7813974e174cf90d47526e827d2 /Master/texmf-dist/doc/latex/hyperref/manual.html
parentfc3da097573ddf3cfa4cdd34e2e9220419a020c5 (diff)
hyperref (1dec18)
git-svn-id: svn://tug.org/texlive/trunk@49299 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref/manual.html')
-rw-r--r--Master/texmf-dist/doc/latex/hyperref/manual.html730
1 files changed, 372 insertions, 358 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.html b/Master/texmf-dist/doc/latex/hyperref/manual.html
index b568eec95b0..d8287aac8a1 100644
--- a/Master/texmf-dist/doc/latex/hyperref/manual.html
+++ b/Master/texmf-dist/doc/latex/hyperref/manual.html
@@ -3447,7 +3447,8 @@ class="ec-lmvtt-10">}</span></span></span> </td>
class="ec-lmri-10">text </span>is made a hyperlink to the <span
class="ec-lmri-10">URL</span>; this must be a full URL (relative to the base URL, if that is
defined). The special characters # and &#x02DC; do <span
-class="ec-lmri-10">not </span>need to be escaped in any way.
+class="ec-lmri-10">not </span>need to be escaped in any way (unless the command is
+used in the argument of another command).
<!--l. 990--><p class="indent" > The optional argument <span
class="ec-lmri-10">options </span>recognizes the hyperref options <span
class="ec-lmvtt-10">pdfremotestartview</span>, <span
@@ -3463,13 +3464,15 @@ class="ec-lmvtt-10">1</span></span></span>.
<span
class="ec-lmvtk-10">ismap</span><span
class="ec-lmbx-10">:</span> </dt><dd
-class="description">Boolean key, if set to |true|, the URL should appended by the coordinates as query
+class="description">Boolean key, if set to <span class="obeylines-h"><span class="verb"><span
+class="ec-lmvtt-10">true</span></span></span>, the URL should appended by the coordinates as query
parameters by the PDF viewer.
</dd><dt class="description">
<span
class="ec-lmvtk-10">nextactionraw</span><span
class="ec-lmbx-10">:</span> </dt><dd
-class="description">The value of key |/Next| of action dictionaries, see PDF specification.</dd></dl>
+class="description">The value of key <span class="obeylines-h"><span class="verb"><span
+class="ec-lmvtt-10">/Next</span></span></span> of action dictionaries, see PDF specification.</dd></dl>
<!--l. 1003--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-14" class="tabular"
cellspacing="0" cellpadding="0"
@@ -4273,26 +4276,37 @@ class="description">
<li class="itemize">Settings have global effect.</li></ul>
</dd><dt class="description">
<span
-class="ec-lmbx-10">Other drivers</span> </dt><dd
-class="description">Unsupported.</dd></dl>
+class="ec-lmbx-10">xetex</span> </dt><dd
+class="description">
-<!--l. 1406--><p class="noindent" >
+ <ul class="itemize1">
+ <li class="itemize">Settings must be done in the preamble or the first page and then have global effect.
+ The key inserts the new (x)dvipdfmx special <span class="obeylines-h"><span class="verb"><span
+class="ec-lmvtt-10">\special{dvipdfmx:config</span><span
+class="ec-lmvtt-10">&#x00A0;g</span><span
+class="ec-lmvtt-10">&#x00A0;#1}</span></span></span> (with
+ the unit removed).</li></ul>
+ </dd><dt class="description">
+<span
+class="ec-lmbx-10">Other drivers</span> </dt><dd
+class="description">Unsupported.</dd></dl>
+<!--l. 1412--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.2 </span> <a
id="x1-210005.2"></a>Field option &#8216;calculatesortkey&#8217;</h4>
-<!--l. 1408--><p class="noindent" >Fields with calculated values are calculated in document order by default. If calculated field values
+<!--l. 1414--><p class="noindent" >Fields with calculated values are calculated in document order by default. If calculated field values
depend on other calculated fields that appear later in the document, then the correct calculation order
can be specified with option &#8216;calculatesortkey&#8217;. Its value is used as key to lexicographically sort the
calculated fields. The sort key do not need to be unique. Fields that share the same key are sorted in
document order.
-<!--l. 1418--><p class="indent" > Currently the field option &#8216;calculatesortkey&#8217; is only supported by the driver for pdfTeX.
-<!--l. 1422--><p class="noindent" >
+<!--l. 1424--><p class="indent" > Currently the field option &#8216;calculatesortkey&#8217; is only supported by the driver for pdfTeX.
+<!--l. 1428--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.3 </span> <a
id="x1-220005.3"></a>Option &#8216;localanchorname&#8217;</h4>
-<!--l. 1424--><p class="noindent" >When an anchor is set (e.g. via <span class="obeylines-h"><span class="verb"><span
+<!--l. 1430--><p class="noindent" >When an anchor is set (e.g. via <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\refstepcounter</span></span></span>, then the anchor name is globally set to the current
anchor name.
-<!--l. 1428--><p class="indent" > For example:
+<!--l. 1434--><p class="indent" > For example:
<div class="verbatim" id="verbatim-22">
@@ -4300,25 +4314,25 @@ anchor name.
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\begin{equation}\end{equation}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\label{sec:foobar}
</div>
-<!--l. 1433--><p class="nopar" > With the default global setting (localanchorname=false) a reference to &#8216;sec:foobar&#8217; jumps to the
+<!--l. 1439--><p class="nopar" > With the default global setting (localanchorname=false) a reference to &#8216;sec:foobar&#8217; jumps to the
equation before. With option &#8216;localanchorname&#8217; the anchor of the equation is forgotten after the
environment and the reference &#8216;sec:foobar&#8217; jumps to the section title.
-<!--l. 1441--><p class="indent" > Option &#8216;localanchorname&#8217; is an experimental option, there might be situations, where the anchor
+<!--l. 1447--><p class="indent" > Option &#8216;localanchorname&#8217; is an experimental option, there might be situations, where the anchor
name is not available as expected.
-<!--l. 1446--><p class="noindent" >
+<!--l. 1452--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.4 </span> <a
id="x1-230005.4"></a>Option &#8216;customdriver&#8217;</h4>
-<!--l. 1448--><p class="noindent" >The value of option &#8216;customdriver&#8217; is the name of an external driver file without extension &#8216;.def&#8217;. The file
+<!--l. 1454--><p class="noindent" >The value of option &#8216;customdriver&#8217; is the name of an external driver file without extension &#8216;.def&#8217;. The file
must have <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\ProvidesFile</span></span></span> with a version date and number that match the date and number of &#8216;hyperref&#8217;,
otherwise a warning is given.
-<!--l. 1453--><p class="indent" > Because the interface, what needs to be defined in the driver, is not well defined and
+<!--l. 1459--><p class="indent" > Because the interface, what needs to be defined in the driver, is not well defined and
quite messy, the option is mainly intended to ease developing, testing, debugging the driver
part.
-<!--l. 1458--><p class="noindent" >
+<!--l. 1464--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.5 </span> <a
id="x1-240005.5"></a>Option &#8216;psdextra&#8217;</h4>
-<!--l. 1460--><p class="noindent" >LaTeX&#8217;s NFSS is used to assist the conversion of arbitrary TeX strings to PDF strings (bookmarks, PDF
+<!--l. 1466--><p class="noindent" >LaTeX&#8217;s NFSS is used to assist the conversion of arbitrary TeX strings to PDF strings (bookmarks, PDF
information entries). Many math command names (<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\geq</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\notin</span></span></span>, ...) are not in control of NFSS,
@@ -4332,17 +4346,17 @@ on means that the short names are available. Then <span class="obeylines-h"><spa
class="ec-lmvtt-10">\geq</span></span></span> can directly be used instead of
<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\textgeq</span></span></span>.
-<!--l. 1474--><p class="noindent" >
+<!--l. 1480--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.6 </span> <a
id="x1-250005.6"></a>\XeTeXLinkBox</h4>
-<!--l. 1476--><p class="noindent" >When XeTeX generates a link annotation, it does not look at the boxes (as the other drivers), but only
+<!--l. 1482--><p class="noindent" >When XeTeX generates a link annotation, it does not look at the boxes (as the other drivers), but only
at the character glyphs. If there are no glyphs (images, rules, ...), then it does not generate a link
annotation. Macro <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\XeTeXLinkBox</span></span></span> puts its argument in a box and adds spaces at the lower left and
upper right corners. An additional margin can be specified by setting it to the dimen register
<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\XeTeXLinkMargin</span></span></span>. The default is 2pt.
-<!--l. 1485--><p class="indent" > Example:
+<!--l. 1491--><p class="indent" > Example:
<div class="verbatim" id="verbatim-23">
@@ -4359,8 +4373,8 @@ class="ec-lmvtt-10">\XeTeXLinkMargin</span></span></span>. The default is 2pt.
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\end{document}
</div>
-<!--l. 1501--><p class="nopar" >
-<!--l. 1503--><p class="noindent" >
+<!--l. 1507--><p class="nopar" >
+<!--l. 1509--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.7 </span> <a
id="x1-260005.7"></a>\IfHyperBooleanExists and \IfHyperBoolean</h4>
@@ -4368,7 +4382,7 @@ class="ec-lmvtt-10">\XeTeXLinkMargin</span></span></span>. The default is 2pt.
<div class="verbatim" id="verbatim-24">
&#x00A0;\IfHyperBooleanExists{OPTION}{YES}{NO}
</div>
-<!--l. 1506--><p class="nopar" > If a hyperref OPTION is a boolean, that means it takes values &#8216;true&#8217; or &#8216;false&#8217;, then <span class="obeylines-h"><span class="verb"><span
+<!--l. 1512--><p class="nopar" > If a hyperref OPTION is a boolean, that means it takes values &#8216;true&#8217; or &#8216;false&#8217;, then <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\IfHyperBooleanExists</span></span></span>
calls YES, otherwise NO.
@@ -4376,23 +4390,23 @@ calls YES, otherwise NO.
<div class="verbatim" id="verbatim-25">
&#x00A0;\IfHyperBoolean{OPTION}{YES}{NO}
</div>
-<!--l. 1513--><p class="nopar" > Macro <span class="obeylines-h"><span class="verb"><span
+<!--l. 1519--><p class="nopar" > Macro <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\IfHyperBoolean</span></span></span> calls YES, if OPTION exists as boolean and is enabled. Otherwise NO is
executed.
-<!--l. 1519--><p class="indent" > Both macros are expandable. Additionally option &#8216;stoppedearly&#8217; is available. It is enabled if
+<!--l. 1525--><p class="indent" > Both macros are expandable. Additionally option &#8216;stoppedearly&#8217; is available. It is enabled if
<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\MaybeStopEarly</span></span></span> or <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\MaybeStopNow</span></span></span> end hyperref prematurely.
-<!--l. 1524--><p class="noindent" >
+<!--l. 1530--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.8 </span> <a
id="x1-270005.8"></a>\unichar</h4>
-<!--l. 1526--><p class="noindent" >If a Unicode character is not supported by puenc.def, it can be given by using <span class="obeylines-h"><span class="verb"><span
+<!--l. 1532--><p class="noindent" >If a Unicode character is not supported by puenc.def, it can be given by using <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\unichar</span></span></span>. Its name
and syntax is inherited from package &#8216;ucs&#8217;. However it is defined independently for use in
hyperref&#8217;s <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\pdfstringdef</span></span></span> (that converts arbitrary TeX code to PDF strings or tries to do
this).
-<!--l. 1534--><p class="indent" > Macro <span class="obeylines-h"><span class="verb"><span
+<!--l. 1540--><p class="indent" > Macro <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\unichar</span></span></span> takes a TeX number as argument, examples for U+263A (WHITE SMILING
FACE):
@@ -4401,7 +4415,7 @@ FACE):
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\unichar{"263A}%&#x00A0;hexadecimal&#x00A0;notation
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\unichar{9786}%&#x00A0;decimal&#x00A0;notation
</div>
-<!--l. 1539--><p class="nopar" > &#8216;"&#8217; must not be a babel shorthand character or otherwise active. Otherwise prefix it with
+<!--l. 1545--><p class="nopar" > &#8216;"&#8217; must not be a babel shorthand character or otherwise active. Otherwise prefix it with
<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\string</span></span></span>:
@@ -4409,18 +4423,18 @@ class="ec-lmvtt-10">\string</span></span></span>:
<div class="verbatim" id="verbatim-27">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\unichar{\string"263A}%&#x00A0;converts&#x00A0;&#8216;"&#8217;&#x00A0;to&#x00A0;&#8216;"&#8217;&#x00A0;with&#x00A0;catcode&#x00A0;12&#x00A0;(other)
</div>
-<!--l. 1544--><p class="nopar" > Users of (n)german packages or babel options may use <span class="obeylines-h"><span class="verb"><span
+<!--l. 1550--><p class="nopar" > Users of (n)german packages or babel options may use <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\dq</span></span></span> instead:
<div class="verbatim" id="verbatim-28">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\unichar{\dq&#x00A0;263A}%&#x00A0;\dq&#x00A0;is&#x00A0;double&#x00A0;quote&#x00A0;with&#x00A0;catcode&#x00A0;12&#x00A0;(other)
</div>
-<!--l. 1548--><p class="nopar" >
-<!--l. 1551--><p class="noindent" >
+<!--l. 1554--><p class="nopar" >
+<!--l. 1557--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.9 </span> <a
id="x1-280005.9"></a>\ifpdfstringunicode</h4>
-<!--l. 1553--><p class="noindent" >Some features of the PDF specification needs PDF strings. Examples are bookmarks or the entries in the
+<!--l. 1559--><p class="noindent" >Some features of the PDF specification needs PDF strings. Examples are bookmarks or the entries in the
information dictionary. The PDF specification allows two encodings &#8216;PDFDocEncoding&#8217; (8-bit encoding)
and &#8216;Unicode&#8217; (UTF-16). The user can help using <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\texorpdfstring</span></span></span> to replace complicate TeX constructs
@@ -4431,7 +4445,7 @@ class="ec-lmvtt-10">\ifpdfstringunicode</span></span></span>. It is only allowed
class="ec-lmvtt-10">\texorpdfstring</span></span></span> and
takes two arguments, the first allows the full range of Unicode. The second is limited to the characters
available in PDFDocEncoding.
-<!--l. 1567--><p class="indent" > As example we take a macro definition for the Vietnamese name of Han The Thanh. Correctly
+<!--l. 1573--><p class="indent" > As example we take a macro definition for the Vietnamese name of Han The Thanh. Correctly
written it needs some accented characters, one character even with a double accent. Class &#8216;tugboat.cls&#8217;
defines a macro for the typesetted name:
@@ -4443,9 +4457,9 @@ defines a macro for the typesetted name:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;~Th\&#8216;anh%
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;}
</div>
-<!--l. 1577--><p class="nopar" > It&#8217;s not entirely correct, the second accent over the &#8216;e&#8217; is not an acute, but a hook. However standard
+<!--l. 1583--><p class="nopar" > It&#8217;s not entirely correct, the second accent over the &#8216;e&#8217; is not an acute, but a hook. However standard
LaTeX does not provide such an accent.
-<!--l. 1582--><p class="indent" > Now we can extend the defintion to support hyperref. The first and the last word are already
+<!--l. 1588--><p class="indent" > Now we can extend the defintion to support hyperref. The first and the last word are already
supported automatically. Characters with two or more accents are a difficult business in LaTeX, because
the NFSS2 macros of the LaTeX kernel do not support more than one accent. Therefore also puenc.def
misses support for them. But we can provide it using <span class="obeylines-h"><span class="verb"><span
@@ -4456,7 +4470,7 @@ is:
<div class="verbatim" id="verbatim-30">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;%&#x00A0;U+1EC3&#x00A0;LATIN&#x00A0;SMALL&#x00A0;LETTER&#x00A0;E&#x00A0;WITH&#x00A0;CIRCUMFLEX&#x00A0;AND&#x00A0;HOOK&#x00A0;ABOVE
</div>
-<!--l. 1591--><p class="nopar" > Thus we can put this together:
+<!--l. 1597--><p class="nopar" > Thus we can put this together:
<div class="verbatim" id="verbatim-31">
@@ -4467,7 +4481,7 @@ is:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;~Th\&#8216;anh%
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;}
</div>
-<!--l. 1600--><p class="nopar" > For PDFDocEncoding (PD1) the variant above has dropped the second accent. Alternatively we could
+<!--l. 1606--><p class="nopar" > For PDFDocEncoding (PD1) the variant above has dropped the second accent. Alternatively we could
provide a representation without accents instead of wrong accents:
@@ -4486,12 +4500,12 @@ provide a representation without accents instead of wrong accents:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;}%
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;}
</div>
-<!--l. 1618--><p class="nopar" >
-<!--l. 1620--><p class="noindent" >
+<!--l. 1624--><p class="nopar" >
+<!--l. 1626--><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. 1622--><p class="noindent" >Since version 2008/08/14 v6.78f.
-<!--l. 1626--><p class="indent" > For hyperlink support in the index, hyperref inserts <span class="obeylines-h"><span class="verb"><span
+<!--l. 1628--><p class="noindent" >Since version 2008/08/14 v6.78f.
+<!--l. 1632--><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
class="ec-lmvtt-10">\hyperpage</span></span></span> analyzes its argument to detect page ranges and page comma
@@ -4502,7 +4516,7 @@ lists. However, only the standard settings are supported directly:
&#x00A0;&#x00A0;&#x00A0;&#x00A0;delim_r&#x00A0;"--"
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;delim_n&#x00A0;",&#x00A0;"
</div>
-<!--l. 1633--><p class="nopar" > (See manual page/documentation of Makeindex that explains the keys that can be used in style files for
+<!--l. 1639--><p class="nopar" > (See manual page/documentation of Makeindex that explains the keys that can be used in style files for
Makeindex.) Customized versions of <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">delim_r,</span><span
class="ec-lmvtt-10">&#x00A0;delim_n,</span><span
@@ -4521,15 +4535,15 @@ e.g.:
&#x00A0;&#x00A0;&#x00A0;&#x00A0;suffix_2p&#x00A0;"\\nohyperpage{f.}"
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;suffix_3p&#x00A0;"\\nohyperpage{ff.}"
</div>
-<!--l. 1645--><p class="nopar" > (Depending on the typesetting tradition some space "<span class="obeylines-h"><span class="verb"><span
+<!--l. 1651--><p class="nopar" > (Depending on the typesetting tradition some space "<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\\</span></span></span>," or "<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">~</span></span></span>" should be put before the first f inside
<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\nohyperpage</span></span></span>.)
-<!--l. 1650--><p class="noindent" >
+<!--l. 1656--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.11 </span> <a
id="x1-300005.11"></a>Experimental option &#8216;ocgcolorlinks&#8217;</h4>
-<!--l. 1652--><p class="noindent" >The idea are colored links, when viewed, but printed without colors. This new experimental option
+<!--l. 1658--><p class="noindent" >The idea are colored links, when viewed, but printed without colors. This new experimental option
&#8216;ocgcolorlinks&#8217; uses Optional Content Groups, a feature introduced in PDF 1.5.
<ul class="itemize1">
<li class="itemize">The option must be given for package loading: <span class="obeylines-h"><span class="verb"><span
@@ -4546,13 +4560,13 @@ class="ec-lmvtt-10">\hypersetup{ocgcolorlinks=false}</span></span></span> inside
</li>
<li class="itemize">The PDF version should be at least 1.5. It is automatically set for pdfTeX. Users of dvipdfmx
set the version on the command line: dvipdfmx -V 5</li></ul>
-<!--l. 1672--><p class="noindent" >
+<!--l. 1678--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.12 </span> <a
id="x1-310005.12"></a>Option &#8216;pdfa&#8217;</h4>
-<!--l. 1674--><p class="noindent" >The new option &#8216;pdfa&#8217; tries to avoid violations of PDF/A in code generated by hyperref. However, the
+<!--l. 1680--><p class="noindent" >The new option &#8216;pdfa&#8217; tries to avoid violations of PDF/A in code generated by hyperref. However, the
result is usually not in PDF/A, because many features aren&#8217;t controlled by hyperref (XMP metadata,
fonts, colors, driver dependend low level stuff, ...).
-<!--l. 1681--><p class="indent" > Currently, option &#8216;pdfa&#8217; sets and disables the following items:
+<!--l. 1687--><p class="indent" > Currently, option &#8216;pdfa&#8217; sets and disables the following items:
<ul class="itemize1">
<li class="itemize">Enabled annotation flags: Print, NoZoom, NoRotate [PDF/A 6.5.3].
</li>
@@ -4576,13 +4590,13 @@ href="run:..." >[</a>PDF/A 6.6.1].
<li class="itemize">Interactive Forms: Flag NeedAppearances is the default &#8216;false&#8217; (Because of this,
hyperref&#8217;s implementation of Forms looks ugly). [PDF/A 6.9]</li></ul>
</li></ul>
-<!--l. 1701--><p class="indent" > The default value of the new option &#8216;pdfa&#8217; is &#8216;false&#8217;. It influences the loading of the package and
+<!--l. 1707--><p class="indent" > The default value of the new option &#8216;pdfa&#8217; is &#8216;false&#8217;. It influences the loading of the package and
cannot be changed after hyperref is loaded (<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\usepackage{hyperref}</span></span></span>).
-<!--l. 1707--><p class="noindent" >
+<!--l. 1713--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.13 </span> <a
id="x1-320005.13"></a>Option &#8216;linktoc&#8217; added</h4>
-<!--l. 1709--><p class="noindent" >The new option &#8216;linktoc&#8217; allows more control which part of an entry in the table of contents is made into
+<!--l. 1715--><p class="noindent" >The new option &#8216;linktoc&#8217; allows more control which part of an entry in the table of contents is made into
a link:
<ul class="itemize1">
<li class="itemize">&#8216;linktoc=none&#8217; (no links)
@@ -4592,17 +4606,17 @@ a link:
<li class="itemize">&#8216;linktoc=page&#8217; (same as &#8216;linktocpage=true&#8217;)
</li>
<li class="itemize">&#8216;linktoc=all&#8217; (both the section and page part are links)</li></ul>
-<!--l. 1718--><p class="noindent" >
+<!--l. 1724--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.14 </span> <a
id="x1-330005.14"></a>Option &#8216;pdfnewwindow&#8217; changed</h4>
-<!--l. 1720--><p class="noindent" >Before 6.77b:
+<!--l. 1726--><p class="noindent" >Before 6.77b:
<ul class="itemize1">
<li class="itemize">pdfnewwindow=true &#8211;&#x003E; /NewWindow true
</li>
<li class="itemize">pdfnewwindow=false &#8211;&#x003E; (absent)
</li>
<li class="itemize">unused pdfnewwindow &#8211;&#x003E; (absent)</li></ul>
-<!--l. 1726--><p class="noindent" >Since 6.77b:
+<!--l. 1732--><p class="noindent" >Since 6.77b:
<ul class="itemize1">
<li class="itemize">pdfnewwindow=true &#8211;&#x003E; /NewWindow true
@@ -4612,26 +4626,26 @@ a link:
<li class="itemize">pdfnewwindow= &#8211;&#x003E; (absent)
</li>
<li class="itemize">unused pdfnewwindow &#8211;&#x003E; (absent)</li></ul>
-<!--l. 1736--><p class="indent" > Rationale: There is a difference between setting to &#8216;false&#8217; and an absent entry. In the former case the
+<!--l. 1742--><p class="indent" > Rationale: There is a difference between setting to &#8216;false&#8217; and an absent entry. In the former case the
new document replaces the old one, in the latter case the PDF viewer application should respect the user
preference.
-<!--l. 1742--><p class="noindent" >
+<!--l. 1748--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.15 </span> <a
id="x1-340005.15"></a>Flag options for PDF forms</h4>
-<!--l. 1744--><p class="noindent" >PDF form field macros (<span class="obeylines-h"><span class="verb"><span
+<!--l. 1750--><p class="noindent" >PDF form field macros (<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\TextField</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\CheckBox</span></span></span>, ...) support boolean flag options. The option name is
the lowercase version of the names in the PDF specification (1.7):
-<!--l. 1748--><p class="indent" > <a
+<!--l. 1754--><p class="indent" > <a
href="http://www.adobe.com/devnet/pdf/pdf_reference.html" class="url" ><span
class="ec-lmvtt-10">http://www.adobe.com/devnet/pdf/pdf_reference.html</span></a>
-<!--l. 1750--><p class="indent" > <a
+<!--l. 1756--><p class="indent" > <a
href="http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf" class="url" ><span
class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</span></a>
-<!--l. 1752--><p class="indent" > Options (convert to lowercase) except flags in square brackets:
+<!--l. 1758--><p class="indent" > Options (convert to lowercase) except flags in square brackets:
<ul class="itemize1">
<li class="itemize">Table 8.16 Annotation flags (page 608):
- <!--l. 1757--><p class="noindent" ><div class="obeylines-v">
+ <!--l. 1763--><p class="noindent" ><div class="obeylines-v">
1 Invisible
<br />2 Hidden (PDF 1.2)
<br />3 Print (PDF 1.2)
@@ -4644,13 +4658,13 @@ class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</
<br />10 LockedContents (PDF 1.7)</div>
</li>
<li class="itemize">Table 8.70 Field flags common to all field types (page 676):
- <!--l. 1771--><p class="noindent" ><div class="obeylines-v">
+ <!--l. 1777--><p class="noindent" ><div class="obeylines-v">
1 ReadOnly
<br />2 Required
<br />3 NoExport</div>
</li>
<li class="itemize">Table 8.75 Field flags specific to button fields (page 686):
- <!--l. 1778--><p class="noindent" ><div class="obeylines-v">
+ <!--l. 1784--><p class="noindent" ><div class="obeylines-v">
15 NoToggleToOff (Radio buttons only)
<br />16 Radio (set: radio buttons, clear: check box, pushbutton: clear)
@@ -4658,7 +4672,7 @@ class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</
<br />26 RadiosInUniso (PDF 1.5)</div>
</li>
<li class="itemize">Table 8.77 Field flags specific to text fields (page 691):
- <!--l. 1786--><p class="noindent" ><div class="obeylines-v">
+ <!--l. 1792--><p class="noindent" ><div class="obeylines-v">
13 Multiline
<br />14 Password
<br />21 FileSelect (PDF 1.4)
@@ -4668,7 +4682,7 @@ class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</
<br />26 RichText (PDF 1.5)</div>
</li>
<li class="itemize">Table 8.79 Field flags specific to choice fields (page 693):
- <!--l. 1797--><p class="noindent" ><div class="obeylines-v">
+ <!--l. 1803--><p class="noindent" ><div class="obeylines-v">
18 Combo (set: combo box, clear: list box)
<br />19 Edit (only useful if Combo is set)
<br />20 (Sort) for authoring tools, not PDF viewers
@@ -4677,7 +4691,7 @@ class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</
<br />27 CommitOnSelChange (PDF 1.5)</div>
</li>
<li class="itemize">Table 8.86 Flags for submit-form actions (page 704):
- <!--l. 1807--><p class="noindent" ><div class="obeylines-v">
+ <!--l. 1813--><p class="noindent" ><div class="obeylines-v">
[1 Include/Exclude] unsupported, use &#8216;noexport&#8217; (table 8.70) instead
<br />2 IncludeNoValueFields
<br />[3 ExportFormat] handled by option &#8216;export&#8217;
@@ -4694,7 +4708,7 @@ class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</
</li></ul>
-<!--l. 1824--><p class="indent" > New option &#8216;export&#8217; sets the export format of a submit action. Valid values are (upper- or
+<!--l. 1830--><p class="indent" > New option &#8216;export&#8217; sets the export format of a submit action. Valid values are (upper- or
lowercase):
<ul class="itemize1">
<li class="itemize">FDF
@@ -4704,16 +4718,16 @@ lowercase):
<li class="itemize">XFDF
</li>
<li class="itemize">PDF (not supported by Acrobat Reader)</li></ul>
-<!--l. 1833--><p class="noindent" >
+<!--l. 1839--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.16 </span> <a
id="x1-350005.16"></a>Option &#8216;pdfversion&#8217;</h4>
-<!--l. 1835--><p class="noindent" >This is an experimental option. It notifies &#8216;hyperref&#8217; about the intended PDF version. Currently this is
+<!--l. 1841--><p class="noindent" >This is an experimental option. It notifies &#8216;hyperref&#8217; about the intended PDF version. Currently this is
used in code for PDF forms (implementation notes 116 and 122 of PDF spec 1.7).
-<!--l. 1841--><p class="indent" > Values: 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. Values below 1.2 are not supported, because most drivers expect
+<!--l. 1847--><p class="indent" > Values: 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. Values below 1.2 are not supported, because most drivers expect
higher PDF versions.
-<!--l. 1846--><p class="indent" > The option must be used early, not after <span class="obeylines-h"><span class="verb"><span
+<!--l. 1852--><p class="indent" > The option must be used early, not after <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\usepackage{hyperref}</span></span></span>.
-<!--l. 1849--><p class="indent" > In theory this option should also set the PDF version, but this is not generally supported.
+<!--l. 1855--><p class="indent" > In theory this option should also set the PDF version, but this is not generally supported.
<ul class="itemize1">
<li class="itemize">pdfTeX below 1.10a:
unsupported. pdfTeX &#x003E;= 1.10a and &#x003C; 1.30: <span class="obeylines-h"><span class="verb"><span
@@ -4728,25 +4742,25 @@ class="ec-lmvtt-10">\pdfminorversion</span></span></span>
&#8216;V 4&#8217;.
</li>
<li class="itemize">Ghostscript: option -dCompatibilityLevel (this is set in &#8216;ps2pdf12&#8217;, &#8216;ps2pdf13&#8217;, &#8216;ps2pdf14&#8217;).</li></ul>
-<!--l. 1864--><p class="indent" > The current PDF version is used as default if this version can be detected (only pdfTeX &#x003E;= 1.10a).
+<!--l. 1870--><p class="indent" > The current PDF version is used as default if this version can be detected (only pdfTeX &#x003E;= 1.10a).
Otherwise the lowest version 1.2 is assumed. Thus &#8216;hyperref&#8217; tries to avoid PDF code that breaks this
version, but is free to use ignorable higher PDF features.
-<!--l. 1871--><p class="noindent" >
+<!--l. 1877--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.17 </span> <a
id="x1-360005.17"></a>Field option &#8216;name&#8217;</h4>
-<!--l. 1873--><p class="noindent" >Many form objects uses the label argument for several purposes:
+<!--l. 1879--><p class="noindent" >Many form objects uses the label argument for several purposes:
<ul class="itemize1">
<li class="itemize">Layouted label.
</li>
<li class="itemize">As name in HTML structures.</li></ul>
-<!--l. 1879--><p class="noindent" >Code that is suitable for layouting with TeX can break in the structures of the output format. If option
+<!--l. 1885--><p class="noindent" >Code that is suitable for layouting with TeX can break in the structures of the output format. If option
&#8216;name&#8217; is given, then its value is used as name in the different output structures. Thus the value should
consist of letters only.
-<!--l. 1886--><p class="noindent" >
+<!--l. 1892--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.18 </span> <a
id="x1-370005.18"></a>Option &#8216;pdfencoding&#8217;</h4>
-<!--l. 1888--><p class="noindent" >The PDF format allows two encodings for bookmarks and entries in the information dictionary:
+<!--l. 1894--><p class="noindent" >The PDF format allows two encodings for bookmarks and entries in the information dictionary:
PDFDocEncoding and Unicode as UTF-16BE. Option "pdfencoding" selects between these
encodings:
<ul class="itemize1">
@@ -4758,35 +4772,35 @@ encodings:
</li>
<li class="itemize">"auto" PDFDocEncoding if the string does not contain characters outside the encoding and
Unicode otherwise.</li></ul>
-<!--l. 1900--><p class="noindent" >
+<!--l. 1906--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.19 </span> <a
id="x1-380005.19"></a>Color options/package hycolor</h4>
-<!--l. 1902--><p class="noindent" >See documentation of package &#8216;hycolor&#8217;.
-<!--l. 1905--><p class="noindent" >
+<!--l. 1908--><p class="noindent" >See documentation of package &#8216;hycolor&#8217;.
+<!--l. 1911--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.20 </span> <a
id="x1-390005.20"></a>Option pdfusetitle</h4>
-<!--l. 1907--><p class="noindent" >If option pdfusetitle is set then hyperref tries to derive the values for pdftitle and pdfauthor
+<!--l. 1913--><p class="noindent" >If option pdfusetitle is set then hyperref tries to derive the values for pdftitle and pdfauthor
from <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\title</span></span></span> and <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\author</span></span></span>. An optional argument for <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\title</span></span></span> and <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\author</span></span></span> is supported (class
amsart).
-<!--l. 1913--><p class="noindent" >
+<!--l. 1919--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.21 </span> <a
id="x1-400005.21"></a>Starred form of \autoref</h4>
-<!--l. 1915--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span
+<!--l. 1921--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\autoref*</span></span></span> generates a reference without link as <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\ref*</span></span></span> or <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\pageref*</span></span></span>.
-<!--l. 1918--><p class="noindent" >
+<!--l. 1924--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.22 </span> <a
id="x1-410005.22"></a>Link border style</h4>
-<!--l. 1920--><p class="noindent" >Links can be underlined instead of the default rectangle or options "colorlinks", "frenchlinks". This is
+<!--l. 1926--><p class="noindent" >Links can be underlined instead of the default rectangle or options "colorlinks", "frenchlinks". This is
done by option <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">pdfborderstyle={/S/U/W</span><span
class="ec-lmvtt-10">&#x00A0;1}</span></span></span>
-<!--l. 1924--><p class="indent" > Some remarks:
+<!--l. 1930--><p class="indent" > Some remarks:
<ul class="itemize1">
<li class="itemize">AR7/Linux seems to have a bug, that don&#8217;t use the default value "1" for the width, but zero,
thus that the underline is not visible without "/W 1". The same applies for dashed boxes,
@@ -4800,21 +4814,21 @@ class="ec-lmvtt-10">&#x00A0;1}</span></span></span>
colorlinks is enabled.
</li>
<li class="itemize">Be aware that not all PDF viewers support this feature, not even Acrobat Reader itself:
- <!--l. 1945--><p class="noindent" >Some support:
+ <!--l. 1951--><p class="noindent" >Some support:
<ul class="itemize2">
<li class="itemize">AR7/Linux: "underline" and "dashed", but the border width must be given.
</li>
<li class="itemize">xpdf 3.00: "underline" and "dashed"</li></ul>
- <!--l. 1952--><p class="noindent" >Unsupported:
+ <!--l. 1958--><p class="noindent" >Unsupported:
<ul class="itemize2">
<li class="itemize">AR5/Linux
</li>
<li class="itemize">ghostscript 8.50</li></ul>
</li></ul>
-<!--l. 1959--><p class="noindent" >
+<!--l. 1965--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.23 </span> <a
id="x1-420005.23"></a>Option "bookmarksdepth"</h4>
-<!--l. 1961--><p class="noindent" >The depth of the bookmarks can be controlled by the new option "bookmarksdepth". The option acts
+<!--l. 1967--><p class="noindent" >The depth of the bookmarks can be controlled by the new option "bookmarksdepth". The option acts
globally and distinguishes three cases:
<ul class="itemize1">
<li class="itemize">"bookmarksdepth" without value Then hyperref uses the current value of counter "tocdepth".
@@ -4834,18 +4848,18 @@ class="ec-lmvtt-10">\toclevel@&#x003C;name&#x003E;</span></span></span>". Exampl
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\hypersetup{bookmarksdepth=4}&#x00A0;%&#x00A0;same&#x00A0;as&#x00A0;before
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\hypersetup{bookmarksdepth}&#x00A0;%&#x00A0;counter&#x00A0;"tocdepth"&#x00A0;is&#x00A0;used
</div>
- <!--l. 1980--><p class="nopar" ></li></ul>
-<!--l. 1983--><p class="noindent" >
+ <!--l. 1986--><p class="nopar" ></li></ul>
+<!--l. 1989--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.24 </span> <a
id="x1-430005.24"></a>Option "pdfescapeform"</h4>
-<!--l. 1985--><p class="noindent" >There are many places where arbitrary strings end up as PS or PDF strings. The PS/PDF strings in
+<!--l. 1991--><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
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
code.
-<!--l. 1997--><p class="indent" > Therefore a new option pdfescapeform was introduced:
+<!--l. 2003--><p class="indent" > Therefore a new option pdfescapeform was introduced:
<ul class="itemize1">
<li class="itemize">pdfescapeform=false Escaping for the formulars are disabled, this is the compatibility
behaviour, therefore this is the default.
@@ -4853,10 +4867,10 @@ code.
<li class="itemize">pdfescapeform=true Then the PS/PDF drivers do all the necessary escaping. This is the
logical choice and the recommended setting. For example, the user writes JavaScript as
JavaScript and do not care about escaping characters for PS/PDF output.</li></ul>
-<!--l. 2010--><p class="noindent" >
+<!--l. 2016--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.25 </span> <a
id="x1-440005.25"></a>Default driver setting</h4>
-<!--l. 2012--><p class="noindent" >(hyperref &#x003E;= 6.72s) If no driver is given, hyperref tries its best to guess the most suitable
+<!--l. 2018--><p class="noindent" >(hyperref &#x003E;= 6.72s) If no driver is given, hyperref tries its best to guess the most suitable
driver. Thus it loads "hpdftex", if pdfTeX is detected running in PDF mode. Or it loads the
corresponding VTeX driver for VTeX&#8217;s working modes. Unhappily many driver programs run
after the TeX compiler, so hyperref does not have a chance (dvips, dvipdfm, ...). In this
@@ -4868,18 +4882,18 @@ xdvi for example. This behaviour, however, can easily be changed in the configur
<div class="verbatim" id="verbatim-36">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\providecommand*{\Hy@defaultdriver}{hdvips}
</div>
-<!--l. 2025--><p class="nopar" > for dvips, or
+<!--l. 2031--><p class="nopar" > for dvips, or
<div class="verbatim" id="verbatim-37">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;\providecommand*{\Hy@defaultdriver}{hypertex}
</div>
-<!--l. 2029--><p class="nopar" > for the default behaviour of hyperref.
-<!--l. 2032--><p class="indent" > See also the new option &#8216;driverfallback&#8217;.
-<!--l. 2034--><p class="noindent" >
+<!--l. 2035--><p class="nopar" > for the default behaviour of hyperref.
+<!--l. 2038--><p class="indent" > See also the new option &#8216;driverfallback&#8217;.
+<!--l. 2040--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.26 </span> <a
id="x1-450005.26"></a>Backref entries</h4>
-<!--l. 2036--><p class="noindent" >Alternative interface for formatting of backref entries, example:
+<!--l. 2042--><p class="noindent" >Alternative interface for formatting of backref entries, example:
<div class="verbatim" id="verbatim-38">
@@ -4972,11 +4986,11 @@ xdvi for example. This behaviour, however, can easily be changed in the configur
&#x00A0;<br />
&#x00A0;<br />\end{document}
</div>
-<!--l. 2125--><p class="nopar" >
-<!--l. 2127--><p class="noindent" >
+<!--l. 2131--><p class="nopar" >
+<!--l. 2133--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">5.27 </span> <a
id="x1-460005.27"></a>\phantomsection</h4>
-<!--l. 2129--><p class="noindent" >Set an anchor at this location. It is often used in conjunction with <span class="obeylines-h"><span class="verb"><span
+<!--l. 2135--><p class="noindent" >Set an anchor at this location. It is often used in conjunction with <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\addcontentsline</span></span></span> for sectionlike things
(index, bibliography, preface). <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\addcontentsline</span></span></span> refers to the latest previous location where an anchor is
@@ -4989,15 +5003,15 @@ set.
&#x00A0;<br />&#x00A0;&#x00A0;\addcontentsline{toc}{chapter}{\indexname}
&#x00A0;<br />&#x00A0;&#x00A0;\printindex
</div>
-<!--l. 2139--><p class="nopar" >
-<!--l. 2141--><p class="indent" > Now the entry in the table of contents (and bookmarks) for the index points to the start of the index
+<!--l. 2145--><p class="nopar" >
+<!--l. 2147--><p class="indent" > Now the entry in the table of contents (and bookmarks) for the index points to the start of the index
page, not to a location before this page.
-<!--l. 2147--><p class="noindent" >
+<!--l. 2153--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">6 </span> <a
id="x1-470006"></a>Acrobat-specific behavior</h3>
-<!--l. 2148--><p class="noindent" >If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided
+<!--l. 2154--><p class="noindent" >If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided
in the appropriate drivers:
-<!--l. 2151--><p class="noindent" >
+<!--l. 2157--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-39" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-39-1g"><col
@@ -5011,13 +5025,13 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2155--><p class="noindent" >The <span
+<!--l. 2161--><p class="noindent" >The <span
class="ec-lmri-10">text </span>is used to create a button which activates the appropriate <span
class="ec-lmri-10">menuoption</span>. The following table lists
the option names you can use&#8212;comparison of this with the menus in Acrobat Reader or Exchange will
show what they do. Obviously some are only appropriate to Exchange.
<a
- id="x1-47001r13"></a> <!--l. 2159--><div class="longtable"> <table id="TBL-40" class="longtable"
+ id="x1-47001r13"></a> <!--l. 2165--><div class="longtable"> <table id="TBL-40" class="longtable"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-40-1g"><col
id="TBL-40-1"><col
@@ -5026,7 +5040,7 @@ id="TBL-40-2"></colgroup>
style="vertical-align:baseline;" id="TBL-40-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-1-1"
class="td01">File </td><td style="white-space:wrap; text-align:left;" id="TBL-40-1-2"
class="td10">
- <!--l. 2159--><p class="noindent" >Open,
+ <!--l. 2165--><p class="noindent" >Open,
Close,
Scan,
Save,
@@ -5040,7 +5054,7 @@ class="td10">
class="td01">File<span
class="lmsy-10">&#x2192;</span>Import </td><td style="white-space:wrap; text-align:left;" id="TBL-40-2-2"
class="td10">
- <!--l. 2160--><p class="noindent" >ImportImage,
+ <!--l. 2166--><p class="noindent" >ImportImage,
ImportNotes,
AcroForm:ImportFDF </td>
</tr><tr
@@ -5048,14 +5062,14 @@ class="td10">
class="td01">File<span
class="lmsy-10">&#x2192;</span>Export </td><td style="white-space:wrap; text-align:left;" id="TBL-40-3-2"
class="td10">
- <!--l. 2161--><p class="noindent" >ExportNotes,
+ <!--l. 2167--><p class="noindent" >ExportNotes,
AcroForm:ExportFDF </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-40-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-4-1"
class="td01">File<span
class="lmsy-10">&#x2192;</span>DocumentInfo </td><td style="white-space:wrap; text-align:left;" id="TBL-40-4-2"
class="td10">
- <!--l. 2162--><p class="noindent" >GeneralInfo,
+ <!--l. 2168--><p class="noindent" >GeneralInfo,
OpenInfo,
FontsInfo,
SecurityInfo,
@@ -5068,7 +5082,7 @@ class="td10">
class="td01">File<span
class="lmsy-10">&#x2192;</span>Preferences </td><td style="white-space:wrap; text-align:left;" id="TBL-40-5-2"
class="td10">
- <!--l. 2163--><p class="noindent" >GeneralPrefs,
+ <!--l. 2169--><p class="noindent" >GeneralPrefs,
NotePrefs,
FullScreenPrefs,
Weblink:Prefs,
@@ -5080,7 +5094,7 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-6-1"
class="td01">Edit </td><td style="white-space:wrap; text-align:left;" id="TBL-40-6-2"
class="td10">
- <!--l. 2165--><p class="noindent" >Undo,
+ <!--l. 2171--><p class="noindent" >Undo,
Cut,
Copy,
Paste,
@@ -5096,19 +5110,19 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-7-1"
class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-40-7-2"
class="td10">
- <!--l. 2168--><p class="noindent" >Properties </td>
+ <!--l. 2174--><p class="noindent" >Properties </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-40-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-8-1"
class="td01">Edit<span
class="lmsy-10">&#x2192;</span>Fields </td><td style="white-space:wrap; text-align:left;" id="TBL-40-8-2"
class="td10">
- <!--l. 2169--><p class="noindent" >AcroForm:Duplicate,
+ <!--l. 2175--><p class="noindent" >AcroForm:Duplicate,
AcroForm:TabOrder </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-40-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-9-1"
class="td01">Document </td><td style="white-space:wrap; text-align:left;" id="TBL-40-9-2"
class="td10">
- <!--l. 2170--><p class="noindent" >Cpt:CapturePages,
+ <!--l. 2176--><p class="noindent" >Cpt:CapturePages,
AcroForm:Actions,
CropPages,
RotatePages,
@@ -5126,7 +5140,7 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-10-1"
class="td01">View </td><td style="white-space:wrap; text-align:left;" id="TBL-40-10-2"
class="td10">
- <!--l. 2173--><p class="noindent" >ActualSize,
+ <!--l. 2179--><p class="noindent" >ActualSize,
FitVisible,
FitWidth,
FitPage,
@@ -5150,7 +5164,7 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-11-1"
class="td01">Tools </td><td style="white-space:wrap; text-align:left;" id="TBL-40-11-2"
class="td10">
- <!--l. 2176--><p class="noindent" >Hand,
+ <!--l. 2182--><p class="noindent" >Hand,
ZoomIn,
ZoomOut,
SelectText,
@@ -5170,7 +5184,7 @@ class="td10">
class="td01">Tools<span
class="lmsy-10">&#x2192;</span>Search </td><td style="white-space:wrap; text-align:left;" id="TBL-40-12-2"
class="td10">
- <!--l. 2179--><p class="noindent" >AcroSrch:Query,
+ <!--l. 2185--><p class="noindent" >AcroSrch:Query,
AcroSrch:Indexes,
AcroSrch:Results,
AcroSrch:Assist,
@@ -5184,7 +5198,7 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-13-1"
class="td01">Window </td><td style="white-space:wrap; text-align:left;" id="TBL-40-13-2"
class="td10">
- <!--l. 2181--><p class="noindent" >ShowHideToolBar,
+ <!--l. 2187--><p class="noindent" >ShowHideToolBar,
ShowHideMenuBar,
ShowHideClipboard,
Cascade,
@@ -5195,7 +5209,7 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-14-1"
class="td01">Help </td><td style="white-space:wrap; text-align:left;" id="TBL-40-14-2"
class="td10">
- <!--l. 2183--><p class="noindent" >HelpUserGuide,
+ <!--l. 2189--><p class="noindent" >HelpUserGuide,
HelpTutorial,
HelpExchange,
HelpScan,
@@ -5210,7 +5224,7 @@ class="td10">
style="vertical-align:baseline;" id="TBL-40-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-15-1"
class="td01">Help(Windows) </td><td style="white-space:wrap; text-align:left;" id="TBL-40-15-2"
class="td10">
- <!--l. 2185--><p class="noindent" >About </td>
+ <!--l. 2191--><p class="noindent" >About </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-40-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-16-1"
class="td01"> </td>
@@ -5225,13 +5239,13 @@ class="td01"> </td>
class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-40-19-2"
class="td10"></td></tr>
</table></div>
-<!--l. 2188--><p class="noindent" >
+<!--l. 2194--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">7 </span> <a
id="x1-480007"></a>PDF and HTML forms</h3>
-<!--l. 2189--><p class="noindent" >You must put your fields inside a <span
+<!--l. 2195--><p class="noindent" >You must put your fields inside a <span
class="ec-lmvtt-10">Form </span>environment (only one per file).
-<!--l. 2191--><p class="indent" > There are six macros to prepare fields:
-<!--l. 2193--><p class="noindent" >
+<!--l. 2197--><p class="indent" > There are six macros to prepare fields:
+<!--l. 2199--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-41" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-41-1g"><col
@@ -5245,7 +5259,7 @@ class="ec-lmvtt-10">]{</span></span></span><span
class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2197--><p class="noindent" >
+<!--l. 2203--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-42" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-42-1g"><col
@@ -5259,7 +5273,7 @@ class="ec-lmvtt-10">]{</span></span></span><span
class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2201--><p class="noindent" >
+<!--l. 2207--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-43" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-43-1g"><col
@@ -5275,7 +5289,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">choices</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2205--><p class="noindent" >
+<!--l. 2211--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-44" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-44-1g"><col
@@ -5289,7 +5303,7 @@ class="ec-lmvtt-10">]{</span></span></span><span
class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2209--><p class="noindent" >
+<!--l. 2215--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-45" class="tabular"
@@ -5305,7 +5319,7 @@ class="ec-lmvtt-10">]{</span></span></span><span
class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2213--><p class="noindent" >
+<!--l. 2219--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-46" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-46-1g"><col
@@ -5319,8 +5333,8 @@ class="ec-lmvtt-10">]{</span></span></span><span
class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2217--><p class="indent" > The way forms and their labels are laid out is determined by:
-<!--l. 2218--><p class="noindent" >
+<!--l. 2223--><p class="indent" > The way forms and their labels are laid out is determined by:
+<!--l. 2224--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-47" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-47-1g"><col
@@ -5334,7 +5348,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2222--><p class="noindent" >
+<!--l. 2228--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-48" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-48-1g"><col
@@ -5348,7 +5362,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2226--><p class="noindent" >
+<!--l. 2232--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-49" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-49-1g"><col
@@ -5362,9 +5376,9 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2230--><p class="indent" > These macros default to #1 #2
-<!--l. 2232--><p class="indent" > What is actually shown in as the field is determined by:
-<!--l. 2233--><p class="noindent" >
+<!--l. 2236--><p class="indent" > These macros default to #1 #2
+<!--l. 2238--><p class="indent" > What is actually shown in as the field is determined by:
+<!--l. 2239--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-50" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-50-1g"><col
@@ -5378,7 +5392,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2237--><p class="noindent" >
+<!--l. 2243--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-51" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-51-1g"><col
@@ -5392,7 +5406,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2240--><p class="noindent" >
+<!--l. 2246--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-52" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-52-1g"><col
@@ -5406,7 +5420,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2243--><p class="noindent" >
+<!--l. 2249--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-53" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-53-1g"><col
@@ -5420,7 +5434,7 @@ class="ec-lmvtt-10">}{</span></span></span><span
class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td>
</tr></table> </div></span>
-<!--l. 2247--><p class="noindent" >
+<!--l. 2253--><p class="noindent" >
<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-54" class="tabular"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-54-1g"><col
@@ -5431,7 +5445,7 @@ class="ec-lmvtt-10">\MakeButtonField</span><span class="obeylines-h"><span class
class="ec-lmvtt-10">{</span></span></span><span
class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span>
-<!--l. 2251--><p class="indent" > These macros default to <span class="obeylines-h"><span class="verb"><span
+<!--l. 2257--><p class="indent" > These macros default to <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\vbox</span><span
class="ec-lmvtt-10">&#x00A0;to</span><span
class="ec-lmvtt-10">&#x00A0;#2{\hbox</span><span
@@ -5440,7 +5454,7 @@ class="ec-lmvtt-10">&#x00A0;#1{\hfill}\vfill}</span></span></span>, except the l
to #1; it is used for buttons, and the special <span
class="ec-lmvtt-10">\Submit </span>and <span
class="ec-lmvtt-10">\Reset </span>macros.
-<!--l. 2255--><p class="indent" > You may also want to redefine the following macros:
+<!--l. 2261--><p class="indent" > You may also want to redefine the following macros:
<div class="verbatim" id="verbatim-40">
@@ -5456,12 +5470,12 @@ class="ec-lmvtt-10">\Reset </span>macros.
&#x00A0;<br />\def\DefaultHeightofTextMultiline{4\baselineskip}
&#x00A0;<br />\def\DefaultWidthofText{3cm}
</div>
-<!--l. 2268--><p class="nopar" >
-<!--l. 2270--><p class="noindent" >
+<!--l. 2274--><p class="nopar" >
+<!--l. 2276--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">7.1 </span> <a
id="x1-490007.1"></a>Forms environment parameters</h4>
<a
- id="x1-49001r14"></a> <!--l. 2274--><div class="longtable"> <table id="TBL-55" class="longtable"
+ id="x1-49001r14"></a> <!--l. 2280--><div class="longtable"> <table id="TBL-55" class="longtable"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-55-1g"><col
id="TBL-55-1"><col
@@ -5474,7 +5488,7 @@ class="ec-lmvtt-10">action </span></td><td style="white-space:nowrap; text-
class="td11"> <span
class="ec-lmri-10">URL </span></td><td style="white-space:wrap; text-align:left;" id="TBL-55-1-3"
class="td10">
- <!--l. 2274--><p class="noindent" >The URL that will receive the form data if a <span
+ <!--l. 2280--><p class="noindent" >The URL that will receive the form data if a <span
class="ec-lmss-10">Submit </span>button
is included in the form </td>
</tr><tr
@@ -5484,7 +5498,7 @@ class="ec-lmvtt-10">encoding </span></td><td style="white-space:nowrap; text-a
class="td11"> <span
class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-55-2-3"
class="td10">
- <!--l. 2275--><p class="noindent" >The encoding for the string set to the URL; FDF-encoding
+ <!--l. 2281--><p class="noindent" >The encoding for the string set to the URL; FDF-encoding
is usual, and <span
class="ec-lmvtt-10">html </span>is the only valid value </td>
</tr><tr
@@ -5494,7 +5508,7 @@ class="ec-lmvtt-10">method </span></td><td style="white-space:nowrap; text-al
class="td11"> <span
class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-55-3-3"
class="td10">
- <!--l. 2277--><p class="noindent" >Used only when generating HTML; values can be <span
+ <!--l. 2283--><p class="noindent" >Used only when generating HTML; values can be <span
class="ec-lmvtt-10">post </span>or
<span
class="ec-lmvtt-10">get</span> </td>
@@ -5516,15 +5530,15 @@ class="td01"> </td><td style="white-space:nowrap; text-align:left;" id=
class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-55-8-3"
class="td10"></td></tr>
</table></div>
-<!--l. 2280--><p class="noindent" >
+<!--l. 2286--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a
id="x1-500007.2"></a>Forms optional parameters</h4>
-<!--l. 2281--><p class="noindent" >Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e.&#x00A0;<span
+<!--l. 2287--><p class="noindent" >Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e.&#x00A0;<span
class="ec-lmvtt-10">color=0 0</span>
<span
class="ec-lmvtt-10">0.5</span>)
<a
- id="x1-50001r15"></a> <!--l. 2286--><div class="longtable"> <table id="TBL-56" class="longtable"
+ id="x1-50001r15"></a> <!--l. 2292--><div class="longtable"> <table id="TBL-56" class="longtable"
cellspacing="0" cellpadding="0"
><colgroup id="TBL-56-1g"><col
id="TBL-56-1"><col
@@ -5996,29 +6010,29 @@ class="td01"> </td>
style="vertical-align:baseline;" id="TBL-56-67-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-67-1"
class="td01"> </td></tr>
</table></div>
-<!--l. 2345--><p class="noindent" >
+<!--l. 2351--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">8 </span> <a
id="x1-510008"></a>Defining a new driver</h3>
-<!--l. 2346--><p class="noindent" >A hyperref driver has to provide definitions for eight macros:
-<!--l. 2349--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2352--><p class="noindent" >A hyperref driver has to provide definitions for eight macros:
+<!--l. 2355--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@anchor</span></span></span>
-<!--l. 2351--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2357--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@link</span></span></span>
-<!--l. 2353--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2359--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@linkfile</span></span></span>
-<!--l. 2355--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2361--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@linkurl</span></span></span>
-<!--l. 2357--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2363--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@anchorstart</span></span></span>
-<!--l. 2359--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2365--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@anchorend</span></span></span>
-<!--l. 2361--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2367--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@linkstart</span></span></span>
-<!--l. 2363--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span
+<!--l. 2369--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\hyper@linkend</span></span></span>
-<!--l. 2366--><p class="indent" > The draft option defines the macros as follows
+<!--l. 2372--><p class="indent" > The draft option defines the macros as follows
<div class="verbatim" id="verbatim-41">
@@ -6031,11 +6045,11 @@ class="ec-lmvtt-10">\hyper@linkend</span></span></span>
&#x00A0;<br />\let\hyper@linkstart\@gobbletwo
&#x00A0;<br />\let\hyper@linkend\@empty
</div>
-<!--l. 2376--><p class="nopar" >
-<!--l. 2378--><p class="noindent" >
+<!--l. 2382--><p class="nopar" >
+<!--l. 2384--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">9 </span> <a
id="x1-520009"></a>Special support for other packages</h3>
-<!--l. 2380--><p class="noindent" >Package <span
+<!--l. 2386--><p class="noindent" >Package <span
class="ec-lmss-10">hyperref </span>aims to cooperate with other packages, but there are several possible sources for
conflict, such as
<ul class="itemize1">
@@ -6058,7 +6072,7 @@ class="ec-lmvtt-10">implicit=false </span>for these packages
to work.
</li>
<li class="itemize">Packages that do anything serious with the index.</li></ul>
-<!--l. 2400--><p class="indent" > The <span
+<!--l. 2406--><p class="indent" > The <span
class="ec-lmss-10">hyperref </span>package is distributed with variants on two useful packages designed to work especially
well with it. These are <span
class="ec-lmss-10">xr </span>and <span
@@ -6066,14 +6080,14 @@ class="ec-lmss-10">minitoc</span>, which support crossdocument links using <span
<span
class="ec-lmvtt-10">\label</span>/<span
class="ec-lmvtt-10">\ref </span>mechanisms and per-chapter tables of contents, respectively.
-<!--l. 2407--><p class="noindent" >
+<!--l. 2413--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">9.1 </span> <a
id="x1-530009.1"></a>Package Compatibility</h4>
-<!--l. 2409--><p class="noindent" >Currently only package loading orders are available:
-<!--l. 2413--><p class="indent" > Note: hyperref loads package "nameref" at <span class="obeylines-h"><span class="verb"><span
+<!--l. 2415--><p class="noindent" >Currently only package loading orders are available:
+<!--l. 2419--><p class="indent" > Note: hyperref loads package "nameref" at <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\begin{document}</span></span></span>. Sometimes this is too late, thus this
package must be loaded earlier.
-<!--l. 2418--><p class="noindent" >
+<!--l. 2424--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.1 </span> <a
id="x1-540009.1.1"></a>algorithm</h5>
@@ -6083,11 +6097,11 @@ package must be loaded earlier.
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage[chapter]{algorithm}%&#x00A0;eg.
</div>
-<!--l. 2423--><p class="nopar" >
-<!--l. 2425--><p class="noindent" >
+<!--l. 2429--><p class="nopar" >
+<!--l. 2431--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.2 </span> <a
id="x1-550009.1.2"></a>amsmath</h5>
-<!--l. 2427--><p class="noindent" >The environments equation and eqnarray are not supported too well. For example, there might be
+<!--l. 2433--><p class="noindent" >The environments equation and eqnarray are not supported too well. For example, there might be
spacing problems (eqnarray isn&#8217;t recommended anyway, see CTAN:info/l2tabu/, the situation for
equation is unclear, because nobody is interested in investigating). Consider using the environments that
package amsmath provide, e.g. gather for equation. The environment equation can even redefined to use
@@ -6099,22 +6113,22 @@ gather:
&#x00A0;<br />&#x00A0;&#x00A0;\let\equation\gather
&#x00A0;<br />&#x00A0;&#x00A0;\let\endequation\endgather
</div>
-<!--l. 2438--><p class="nopar" >
-<!--l. 2440--><p class="noindent" >
+<!--l. 2444--><p class="nopar" >
+<!--l. 2446--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.3 </span> <a
id="x1-560009.1.3"></a>amsrefs</h5>
-<!--l. 2442--><p class="noindent" >Package loading order:
+<!--l. 2448--><p class="noindent" >Package loading order:
<div class="verbatim" id="verbatim-44">
&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{amsrefs}
</div>
-<!--l. 2447--><p class="nopar" >
-<!--l. 2449--><p class="noindent" >
+<!--l. 2453--><p class="nopar" >
+<!--l. 2455--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.4 </span> <a
id="x1-570009.1.4"></a>arydshln, longtable</h5>
-<!--l. 2451--><p class="noindent" >Package longtable must be put before hyperref and arydshln, hyperref after arydshln generates an error,
+<!--l. 2457--><p class="noindent" >Package longtable must be put before hyperref and arydshln, hyperref after arydshln generates an error,
thus the resulting package order is then:
@@ -6123,16 +6137,16 @@ thus the resulting package order is then:
&#x00A0;<br />&#x00A0;&#x00A0;\usepacakge{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{arydshln}
</div>
-<!--l. 2459--><p class="nopar" >
-<!--l. 2461--><p class="noindent" >
+<!--l. 2465--><p class="nopar" >
+<!--l. 2467--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.5 </span> <a
id="x1-580009.1.5"></a>babel/magyar.ldf</h5>
-<!--l. 2463--><p class="noindent" >The old version 2005/03/30 v1.4j will not work. You need at least version 1.5, maintained by Péter
+<!--l. 2469--><p class="noindent" >The old version 2005/03/30 v1.4j will not work. You need at least version 1.5, maintained by Péter
Szabó, see CTAN:language/hungarian/babel/.
-<!--l. 2468--><p class="noindent" >
+<!--l. 2474--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.6 </span> <a
id="x1-590009.1.6"></a>babel/spanish.ldf</h5>
-<!--l. 2470--><p class="noindent" >Babel&#8217;s spanish.ldf redefines &#8216;<span class="obeylines-h"><span class="verb"><span
+<!--l. 2476--><p class="noindent" >Babel&#8217;s spanish.ldf redefines &#8216;<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\.</span></span></span>&#8217; to support &#8216;<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\...</span></span></span>&#8217;. In bookmarks (<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\pdfstringdef</span></span></span>) only &#8216;<span class="obeylines-h"><span class="verb"><span
@@ -6140,10 +6154,10 @@ class="ec-lmvtt-10">\.</span></span></span>&#8217; is supported. If
&#8216;<span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\...</span></span></span>&#8217; is needed, <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\texorpdfstring{\...}{\dots}</span></span></span> can be used instead.
-<!--l. 2477--><p class="noindent" >
+<!--l. 2483--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.7 </span> <a
id="x1-600009.1.7"></a>bibentry</h5>
-<!--l. 2479--><p class="noindent" >Workaround:
+<!--l. 2485--><p class="noindent" >Workaround:
<div class="verbatim" id="verbatim-46">
@@ -6162,16 +6176,16 @@ class="ec-lmvtt-10">\texorpdfstring{\...}{\dots}</span></span></span> can be use
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\nobibliography{database}
&#x00A0;<br />&#x00A0;&#x00A0;\endgroup
</div>
-<!--l. 2496--><p class="nopar" >
-<!--l. 2498--><p class="noindent" >
+<!--l. 2502--><p class="nopar" >
+<!--l. 2504--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.8 </span> <a
id="x1-610009.1.8"></a>bigfoot</h5>
-<!--l. 2500--><p class="noindent" >Hyperref does not support package &#8216;bigfoot&#8217;. And package &#8216;bigfoot&#8217; does not support hyperref&#8217;s footnotes
+<!--l. 2506--><p class="noindent" >Hyperref does not support package &#8216;bigfoot&#8217;. And package &#8216;bigfoot&#8217; does not support hyperref&#8217;s footnotes
and disables them (hyperfootnotes=false).
-<!--l. 2505--><p class="noindent" >
+<!--l. 2511--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.9 </span> <a
id="x1-620009.1.9"></a>chappg</h5>
-<!--l. 2507--><p class="noindent" >Package &#8216;chappg&#8217; uses <span class="obeylines-h"><span class="verb"><span
+<!--l. 2513--><p class="noindent" >Package &#8216;chappg&#8217; uses <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\@addtoreset</span></span></span> that is redefined by &#8216;hyperref&#8217;. The package order is
therefore:
@@ -6180,11 +6194,11 @@ therefore:
&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{chappg}
</div>
-<!--l. 2513--><p class="nopar" >
-<!--l. 2515--><p class="noindent" >
+<!--l. 2519--><p class="nopar" >
+<!--l. 2521--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.10 </span> <a
id="x1-630009.1.10"></a>cite</h5>
-<!--l. 2517--><p class="noindent" >This is from Mike Shell: cite.sty cannot currently be used with hyperref. However, I can do a workaround
+<!--l. 2523--><p class="noindent" >This is from Mike Shell: cite.sty cannot currently be used with hyperref. However, I can do a workaround
via:
@@ -6195,14 +6209,14 @@ via:
&#x00A0;<br />
&#x00A0;<br />&#x00A0;\usepackage[hypertex]{hyperref}
</div>
-<!--l. 2527--><p class="nopar" >
-<!--l. 2529--><p class="indent" > so that hyperref will not redefine any of the biblabel stuff - so cite.sty will work as normal -
+<!--l. 2533--><p class="nopar" >
+<!--l. 2535--><p class="indent" > so that hyperref will not redefine any of the biblabel stuff - so cite.sty will work as normal -
although the citations will not be hyperlinked, of course (But this may not be an issue for many
people).
-<!--l. 2534--><p class="noindent" >
+<!--l. 2540--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.11 </span> <a
id="x1-640009.1.11"></a>count1to</h5>
-<!--l. 2536--><p class="noindent" >Package &#8216;count1to&#8217; adds several <span class="obeylines-h"><span class="verb"><span
+<!--l. 2542--><p class="noindent" >Package &#8216;count1to&#8217; adds several <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\@addtoreset</span></span></span> commands that confuse &#8216;hyperref&#8217;. Therefore <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\theH&#x003C;...&#x003E;</span></span></span>
has to be fixed:
@@ -6218,26 +6232,26 @@ has to be fixed:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\renewcommand*{\theHsubparagraph}{\theHparagraph.\arabic{subparagraph}}%
&#x00A0;<br />&#x00A0;&#x00A0;}
</div>
-<!--l. 2548--><p class="nopar" >
-<!--l. 2550--><p class="noindent" >
+<!--l. 2554--><p class="nopar" >
+<!--l. 2556--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.12 </span> <a
id="x1-650009.1.12"></a>dblaccnt</h5>
-<!--l. 2552--><p class="noindent" >pd1enc.def or puenc.def should be loaded before:
+<!--l. 2558--><p class="noindent" >pd1enc.def or puenc.def should be loaded before:
<div class="verbatim" id="verbatim-50">
&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{dblaccnt}
</div>
-<!--l. 2556--><p class="nopar" > or see entry for "vietnam".
-<!--l. 2560--><p class="noindent" >
+<!--l. 2562--><p class="nopar" > or see entry for "vietnam".
+<!--l. 2566--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.13 </span> <a
id="x1-660009.1.13"></a>easyeqn</h5>
-<!--l. 2561--><p class="noindent" >Not compatible, breaks.
-<!--l. 2564--><p class="noindent" >
+<!--l. 2567--><p class="noindent" >Not compatible, breaks.
+<!--l. 2570--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.14 </span> <a
id="x1-670009.1.14"></a>ellipsis</h5>
-<!--l. 2566--><p class="noindent" >This packages redefines <span class="obeylines-h"><span class="verb"><span
+<!--l. 2572--><p class="noindent" >This packages redefines <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\textellipsis</span></span></span> after package hyperref (pd1enc.def/puenc.def should be loaded
before):
@@ -6246,8 +6260,8 @@ before):
&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{ellipsis}
</div>
-<!--l. 2571--><p class="nopar" >
-<!--l. 2573--><p class="noindent" >
+<!--l. 2577--><p class="nopar" >
+<!--l. 2579--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.15 </span> <a
id="x1-680009.1.15"></a>float</h5>
@@ -6256,35 +6270,35 @@ before):
&#x00A0;\usepackage{float}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2577--><p class="nopar" >
+<!--l. 2583--><p class="nopar" >
<ul class="itemize1">
<li class="itemize">Several <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\caption</span></span></span> commands are not supported inside one float object.
</li>
<li class="itemize">Anchor are set at top of the float object, if its style is controlled by float.sty.</li></ul>
-<!--l. 2584--><p class="noindent" >
+<!--l. 2590--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.16 </span> <a
id="x1-690009.1.16"></a>endnotes</h5>
-<!--l. 2585--><p class="noindent" >Unsupported.
-<!--l. 2587--><p class="noindent" >
+<!--l. 2591--><p class="noindent" >Unsupported.
+<!--l. 2593--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.17 </span> <a
id="x1-700009.1.17"></a>foiltex</h5>
-<!--l. 2588--><p class="noindent" >Update to version 2008/01/28 v2.1.4b: Since version 6.77a hyperref does not hack into <span class="obeylines-h"><span class="verb"><span
+<!--l. 2594--><p class="noindent" >Update to version 2008/01/28 v2.1.4b: Since version 6.77a hyperref does not hack into <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\@begindvi</span></span></span>, it
uses package &#8216;atbegshi&#8217; instead, that hooks into <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\shipout</span></span></span>. Thus the patch of &#8216;foils.cls&#8217; regarding hyperref
is now obsolete and causes an undefined error message about <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\@hyperfixhead</span></span></span>. This is fixed in FoilTeX
2.1.4b.
-<!--l. 2596--><p class="noindent" >
+<!--l. 2602--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.18 </span> <a
id="x1-710009.1.18"></a>footnote</h5>
-<!--l. 2598--><p class="noindent" >This package is not supported, you have to disable hyperref&#8217;s footnote support by using option
+<!--l. 2604--><p class="noindent" >This package is not supported, you have to disable hyperref&#8217;s footnote support by using option
"hyperfootnotes=false".
-<!--l. 2602--><p class="noindent" >
+<!--l. 2608--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.19 </span> <a
id="x1-720009.1.19"></a>geometry</h5>
-<!--l. 2604--><p class="noindent" >Driver &#8216;dvipdfm&#8217; and program &#8216;dvipdfm&#8217; might generate a warning: Sorry. Too late to change page size
+<!--l. 2610--><p class="noindent" >Driver &#8216;dvipdfm&#8217; and program &#8216;dvipdfm&#8217; might generate a warning: Sorry. Too late to change page size
Then prefer the program &#8216;dvipdfmx&#8217; or use one of the following workarounds to move the <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\special</span></span></span> of
geometry to an earlier location:
@@ -6317,22 +6331,22 @@ geometry to an earlier location:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;]{geometry}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2636--><p class="nopar" >
-<!--l. 2638--><p class="noindent" >
+<!--l. 2642--><p class="nopar" >
+<!--l. 2644--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.20 </span> <a
id="x1-730009.1.20"></a>IEEEtran.cls</h5>
-<!--l. 2640--><p class="noindent" >version &#x003E;= V1.6b (because of <span class="obeylines-h"><span class="verb"><span
+<!--l. 2646--><p class="noindent" >version &#x003E;= V1.6b (because of <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\@makecaption</span></span></span>, see ChangeLog)
-<!--l. 2643--><p class="noindent" >
+<!--l. 2649--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.21 </span> <a
id="x1-740009.1.21"></a>index</h5>
-<!--l. 2645--><p class="noindent" >version &#x003E;= 1995/09/28 v4.1 (because of <span class="obeylines-h"><span class="verb"><span
+<!--l. 2651--><p class="noindent" >version &#x003E;= 1995/09/28 v4.1 (because of <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\addcontentsline</span></span></span> redefinition)
-<!--l. 2648--><p class="noindent" >
+<!--l. 2654--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.22 </span> <a
id="x1-750009.1.22"></a>lastpage</h5>
-<!--l. 2650--><p class="noindent" >Compatible.
-<!--l. 2653--><p class="noindent" >
+<!--l. 2656--><p class="noindent" >Compatible.
+<!--l. 2659--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.23 </span> <a
id="x1-760009.1.23"></a>linguex</h5>
@@ -6341,8 +6355,8 @@ class="ec-lmvtt-10">\addcontentsline</span></span></span> redefinition)
&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{linguex}
</div>
-<!--l. 2657--><p class="nopar" >
-<!--l. 2659--><p class="noindent" >
+<!--l. 2663--><p class="nopar" >
+<!--l. 2665--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.24 </span> <a
id="x1-770009.1.24"></a>ltabptch</h5>
@@ -6352,20 +6366,20 @@ class="ec-lmvtt-10">\addcontentsline</span></span></span> redefinition)
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{ltabptch}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2664--><p class="nopar" >
-<!--l. 2666--><p class="noindent" >
+<!--l. 2670--><p class="nopar" >
+<!--l. 2672--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.25 </span> <a
id="x1-780009.1.25"></a>mathenv</h5>
-<!--l. 2668--><p class="noindent" >Unsupported.
-<!--l. 2672--><p class="indent" > Both &#8216;mathenv&#8217; and &#8216;hyperref&#8217; messes around with environment &#8216;eqnarray&#8217;. You can load &#8216;mathenv&#8217;
+<!--l. 2674--><p class="noindent" >Unsupported.
+<!--l. 2678--><p class="indent" > Both &#8216;mathenv&#8217; and &#8216;hyperref&#8217; messes around with environment &#8216;eqnarray&#8217;. You can load &#8216;mathenv&#8217;
after &#8216;hyperref&#8217; to avoid an error message. But <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\label</span></span></span> will not work inside environment &#8216;eqnarray&#8217;
properly, for example.
-<!--l. 2679--><p class="noindent" >
+<!--l. 2685--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.26 </span> <a
id="x1-790009.1.26"></a>minitoc-hyper</h5>
-<!--l. 2681--><p class="noindent" >This package is obsolete, use the uptodate original package minitoc instead.
-<!--l. 2685--><p class="noindent" >
+<!--l. 2687--><p class="noindent" >This package is obsolete, use the uptodate original package minitoc instead.
+<!--l. 2691--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.27 </span> <a
id="x1-800009.1.27"></a>multind</h5>
@@ -6374,8 +6388,8 @@ properly, for example.
&#x00A0;\usepackage{multind}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2689--><p class="nopar" >
-<!--l. 2691--><p class="noindent" >
+<!--l. 2695--><p class="nopar" >
+<!--l. 2697--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.28 </span> <a
id="x1-810009.1.28"></a>natbib</h5>
@@ -6384,18 +6398,18 @@ properly, for example.
&#x00A0;\usepackage{natbib}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2695--><p class="nopar" >
-<!--l. 2697--><p class="noindent" >
+<!--l. 2701--><p class="nopar" >
+<!--l. 2703--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.29 </span> <a
id="x1-820009.1.29"></a>nomencl</h5>
-<!--l. 2698--><p class="noindent" >Example for introducing links for the page numbers:
+<!--l. 2704--><p class="noindent" >Example for introducing links for the page numbers:
<div class="verbatim" id="verbatim-58">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\renewcommand*{\pagedeclaration}[1]{\unskip,&#x00A0;\hyperpage{#1}}
</div>
-<!--l. 2701--><p class="nopar" >
-<!--l. 2704--><p class="indent" > For equations the following might work:
+<!--l. 2707--><p class="nopar" >
+<!--l. 2710--><p class="indent" > For equations the following might work:
<div class="verbatim" id="verbatim-59">
@@ -6405,8 +6419,8 @@ properly, for example.
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;But&#x00A0;the&#x00A0;mapping&#x00A0;from&#x00A0;the&#x00A0;equation&#x00A0;number&#x00A0;to&#x00A0;the&#x00A0;anchor&#x00A0;name
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;is&#x00A0;not&#x00A0;available&#x00A0;in&#x00A0;general.
</div>
-<!--l. 2711--><p class="nopar" >
-<!--l. 2713--><p class="noindent" >
+<!--l. 2717--><p class="nopar" >
+<!--l. 2719--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.30 </span> <a
id="x1-830009.1.30"></a>parskip</h5>
@@ -6415,10 +6429,10 @@ properly, for example.
&#x00A0;\usepackage{parskip}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}[2012/08/20]
</div>
-<!--l. 2717--><p class="nopar" >
-<!--l. 2720--><p class="indent" > Both packages want to redefine <span class="obeylines-h"><span class="verb"><span
+<!--l. 2723--><p class="nopar" >
+<!--l. 2726--><p class="indent" > Both packages want to redefine <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\@starttoc</span></span></span>.
-<!--l. 2723--><p class="noindent" >
+<!--l. 2729--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.31 </span> <a
id="x1-840009.1.31"></a>prettyref</h5>
@@ -6443,8 +6457,8 @@ class="ec-lmvtt-10">\@starttoc</span></span></span>.
&#x00A0;<br />%%%&#x00A0;example&#x00A0;for&#x00A0;prettyref&#x00A0;%%%
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;
</div>
-<!--l. 2742--><p class="nopar" >
-<!--l. 2744--><p class="noindent" >
+<!--l. 2748--><p class="nopar" >
+<!--l. 2750--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.32 </span> <a
id="x1-850009.1.32"></a>ntheorem</h5>
@@ -6456,8 +6470,8 @@ class="ec-lmvtt-10">\@starttoc</span></span></span>.
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage[hyperref]{ntheorem}
&#x00A0;<br />&#x00A0;&#x00A0;But&#x00A0;there&#x00A0;are&#x00A0;still&#x00A0;unsolved&#x00A0;problems&#x00A0;(options&#x00A0;thref,&#x00A0;...).
</div>
-<!--l. 2751--><p class="nopar" >
-<!--l. 2753--><p class="noindent" >
+<!--l. 2757--><p class="nopar" >
+<!--l. 2759--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.33 </span> <a
id="x1-860009.1.33"></a>setspace</h5>
@@ -6466,8 +6480,8 @@ class="ec-lmvtt-10">\@starttoc</span></span></span>.
&#x00A0;\usepackage{setspace}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2757--><p class="nopar" >
-<!--l. 2759--><p class="noindent" >
+<!--l. 2763--><p class="nopar" >
+<!--l. 2765--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.34 </span> <a
id="x1-870009.1.34"></a>sidecap</h5>
@@ -6478,8 +6492,8 @@ class="ec-lmvtt-10">\@starttoc</span></span></span>.
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{hyperref}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{sidecap}
</div>
-<!--l. 2765--><p class="nopar" >
-<!--l. 2767--><p class="noindent" >
+<!--l. 2771--><p class="nopar" >
+<!--l. 2773--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.35 </span> <a
id="x1-880009.1.35"></a>subfigure</h5>
@@ -6503,8 +6517,8 @@ class="ec-lmvtt-10">\@starttoc</span></span></span>.
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{subfigure}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;or&#x00A0;vice&#x00A0;versa?
</div>
-<!--l. 2786--><p class="nopar" >
-<!--l. 2788--><p class="noindent" >
+<!--l. 2792--><p class="nopar" >
+<!--l. 2794--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.36 </span> <a
id="x1-890009.1.36"></a>titleref</h5>
@@ -6514,23 +6528,23 @@ class="ec-lmvtt-10">\@starttoc</span></span></span>.
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{titleref}%&#x00A0;without&#x00A0;usetoc
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2793--><p class="nopar" >
-<!--l. 2795--><p class="noindent" >
+<!--l. 2799--><p class="nopar" >
+<!--l. 2801--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.37 </span> <a
id="x1-900009.1.37"></a>tabularx</h5>
-<!--l. 2797--><p class="noindent" >Linked footnotes are not supported inside environment &#8216;tabularx&#8217;, because they uses the optional
+<!--l. 2803--><p class="noindent" >Linked footnotes are not supported inside environment &#8216;tabularx&#8217;, because they uses the optional
argument of <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\footnotetext</span></span></span>, see section &#8216;Limitations&#8217;. Before version 2011/09/28 6.82i hyperref had
disabled footnotes entirely by &#8216;hyperfootnotes=false&#8217;.
-<!--l. 2803--><p class="noindent" >
+<!--l. 2809--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.38 </span> <a
id="x1-910009.1.38"></a>titlesec</h5>
-<!--l. 2805--><p class="noindent" >"nameref" supports titlesec, but hyperref does not (unsolved is the anchor setting, missing with
+<!--l. 2811--><p class="noindent" >"nameref" supports titlesec, but hyperref does not (unsolved is the anchor setting, missing with
unnumbered section, perhaps problems with page breaks with numbered ones).
-<!--l. 2810--><p class="noindent" >
+<!--l. 2816--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.39 </span> <a
id="x1-920009.1.39"></a>ucs/utf8x.def</h5>
-<!--l. 2812--><p class="noindent" >The first time a multibyte UTF8 sequence is called, it does some calculations and stores the result in a
+<!--l. 2818--><p class="noindent" >The first time a multibyte UTF8 sequence is called, it does some calculations and stores the result in a
macro for speeding up the next calls of that UTF8 sequence. However this makes the first call
non-expandable and will break if used in information entries or bookmarks. Package "ucs" offers
<span class="obeylines-h"><span class="verb"><span
@@ -6545,14 +6559,14 @@ class="ec-lmvtt-10">\PreloadUnicodePage</span></span></span> to solve this:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\PrerenderUnicode{^^c3^^b6}%&#x00A0;or&#x00A0;\PrerenderUnicodePage{1}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\hypersetup{pdftitle={Umlaut&#x00A0;example:&#x00A0;^^c3^^b6}}
</div>
-<!--l. 2825--><p class="nopar" > The notation with two carets avoids trouble with 8-bit bytes for the README file, you can use the
+<!--l. 2831--><p class="nopar" > The notation with two carets avoids trouble with 8-bit bytes for the README file, you can use the
characters directly.
-<!--l. 2830--><p class="noindent" >
+<!--l. 2836--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.40 </span> <a
id="x1-930009.1.40"></a>varioref</h5>
-<!--l. 2831--><p class="noindent" >There are too many problems with varioref. Nobody has time to sort them out. Therefore this package is
+<!--l. 2837--><p class="noindent" >There are too many problems with varioref. Nobody has time to sort them out. Therefore this package is
now unsupported.
-<!--l. 2835--><p class="indent" > Perhaps you are lucky and some of the features of varioref works with the following loading
+<!--l. 2841--><p class="indent" > Perhaps you are lucky and some of the features of varioref works with the following loading
order:
@@ -6561,10 +6575,10 @@ order:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{varioref}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2841--><p class="nopar" >
-<!--l. 2844--><p class="indent" > Also some babel versions can be problematic. For exmample, 2005/05/21 v3.8g contains a patch for
+<!--l. 2847--><p class="nopar" >
+<!--l. 2850--><p class="indent" > Also some babel versions can be problematic. For exmample, 2005/05/21 v3.8g contains a patch for
varioref that breaks the hyperref support for varioref.
-<!--l. 2850--><p class="indent" > Also unsupported:
+<!--l. 2856--><p class="indent" > Also unsupported:
<ul class="itemize1">
<li class="itemize"><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\Ref</span></span></span>, <span class="obeylines-h"><span class="verb"><span
@@ -6572,11 +6586,11 @@ class="ec-lmvtt-10">\Vref</span></span></span> do not uppercase the first letter
</li>
<li class="itemize"><span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\vpageref[]{...}</span></span></span> On the same page a previous space is not suppressed.</li></ul>
-<!--l. 2857--><p class="noindent" >
+<!--l. 2863--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.41 </span> <a
id="x1-940009.1.41"></a>verse</h5>
-<!--l. 2859--><p class="noindent" >Version 2005/08/22 v2.22 contains support for hyperref.
-<!--l. 2861--><p class="indent" > For older versions see example from de.comp.text.tex (2005/08/11, slightly modified):
+<!--l. 2865--><p class="noindent" >Version 2005/08/22 v2.22 contains support for hyperref.
+<!--l. 2867--><p class="indent" > For older versions see example from de.comp.text.tex (2005/08/11, slightly modified):
<div class="verbatim" id="verbatim-69">
@@ -6621,8 +6635,8 @@ class="ec-lmvtt-10">\vpageref[]{...}</span></span></span> On the same page a pre
&#x00A0;<br />
&#x00A0;<br />&#x00A0;&#x00A0;\end{document}
</div>
-<!--l. 2905--><p class="nopar" >
-<!--l. 2907--><p class="noindent" >
+<!--l. 2911--><p class="nopar" >
+<!--l. 2913--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.42 </span> <a
id="x1-950009.1.42"></a>vietnam</h5>
@@ -6633,37 +6647,37 @@ class="ec-lmvtt-10">\vpageref[]{...}</span></span></span> On the same page a pre
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{vietnam}
&#x00A0;<br />&#x00A0;&#x00A0;\usepackage{hyperref}
</div>
-<!--l. 2913--><p class="nopar" >
-<!--l. 2915--><p class="noindent" >
+<!--l. 2919--><p class="nopar" >
+<!--l. 2921--><p class="noindent" >
<h5 class="subsubsectionHead"><span class="titlemark">9.1.43 </span> <a
id="x1-960009.1.43"></a>XeTeX</h5>
-<!--l. 2917--><p class="noindent" >Default for the encoding of bookmarks is &#8216;pdfencoding=auto&#8217;. That means the strings are always treated
+<!--l. 2923--><p class="noindent" >Default for the encoding of bookmarks is &#8216;pdfencoding=auto&#8217;. That means the strings are always treated
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. 2925--><p class="indent" > XeTeX uses the program xdvipdfmx for PDF output generation. This program behaves a little
+<!--l. 2931--><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. 2934--><p class="indent" > "Failed to convert input string to UTF16..."
-<!--l. 2936--><p class="indent" > The best way would be, if xdvipdfm could detect the byte order marker (<span class="obeylines-h"><span class="verb"><span
+<!--l. 2940--><p class="indent" > "Failed to convert input string to UTF16..."
+<!--l. 2942--><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. 2940--><p class="indent" > For the time being I added the following to hyperref, when option &#8216;pdfencoding=auto&#8217; is set (default
+<!--l. 2946--><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. 2947--><p class="indent" > a) The string is converted back to big characters for the "tainted keys" of xdvipdfmx
+<!--l. 2953--><p class="indent" > a) The string is converted back to big characters for the "tainted keys" 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. 2953--><p class="indent" > b) Without conversion for the other strings , providing UTF16be directly. Examples: Prefix of page
+<!--l. 2959--><p class="indent" > b) Without conversion for the other strings , providing UTF16be directly. Examples: Prefix of page
labels, some elements of formulars.
-<!--l. 2957--><p class="indent" > Thus <span
+<!--l. 2963--><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
@@ -6671,16 +6685,16 @@ class="ec-lmvtt-10">\pdfstringdef</span></span></span> should be preceded by
"<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. 2965--><p class="noindent" >
+<!--l. 2971--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">10 </span> <a
id="x1-9700010"></a>Limitations<span class="footnote-mark"><a
href="manual5.html#fn4x0"><sup class="textsuperscript">4</sup></a></span><a
id="x1-97001f4"></a> </h3>
<h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a
id="x1-9800010.1"></a>Wrapped/broken link support</h4>
-<!--l. 2968--><p class="noindent" >Only few drivers support automatically wrapped/broken links, e.g. pdftex, dvipdfm, hypertex. Other
+<!--l. 2974--><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. 2972--><p class="indent" > Workarounds:
+<!--l. 2978--><p class="indent" > Workarounds:
<ul class="itemize1">
@@ -6695,23 +6709,23 @@ class="ec-lmvtt-10">\url</span></span></span>"s are caught by package "breakurl"
<li class="itemize">The option "breaklinks" 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. 2986--><p class="noindent" >Another limitation: some penalties are "optimized" by TeX, thus there are missing break
+ <!--l. 2992--><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. 2992--><p class="noindent" >
+<!--l. 2998--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a
id="x1-9900010.2"></a>Links across pages</h4>
-<!--l. 2994--><p class="noindent" >In general they have problems:
+<!--l. 3000--><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. 3002--><p class="noindent" >
+<!--l. 3008--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a
id="x1-10000010.3"></a>Footnotes</h4>
-<!--l. 3004--><p class="noindent" >LaTeX allows the separation of the footnote mark and the footnote text (<span class="obeylines-h"><span class="verb"><span
+<!--l. 3010--><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
@@ -6727,14 +6741,14 @@ Thus the implementation of hyperref does not support the optional argument of <s
class="ec-lmvtt-10">\footnotemark\verb</span></span></span>
and <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\footnotetext</span></span></span>.
-<!--l. 3015--><p class="noindent" >
+<!--l. 3021--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">11 </span> <a
id="x1-10100011"></a>Hints<span class="footnote-mark"><a
href="manual6.html#fn5x0"><sup class="textsuperscript">5</sup></a></span><a
id="x1-101001f5"></a> </h3>
<h4 class="subsectionHead"><span class="titlemark">11.1 </span> <a
id="x1-10200011.1"></a>Spaces in option values</h4>
-<!--l. 3019--><p class="noindent" >Unhappily LaTeX strips spaces from options if they are given in <span class="obeylines-h"><span class="verb"><span
+<!--l. 3025--><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
@@ -6744,33 +6758,32 @@ 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. 3023--><p class="nopar" > Package hyperref now gets
+<!--l. 3029--><p class="nopar" > Package hyperref now gets
<div class="verbatim" id="verbatim-72">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;pdfborder=001
</div>
-<!--l. 3027--><p class="nopar" > and the result is an invalid PDF file. As workaround braces can be used:
+<!--l. 3033--><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. 3032--><p class="nopar" > Some options can also be given in
+<!--l. 3038--><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|
-&#x00A0;<br />\begin{verbatim}
-&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\hypersetup{pdfborder=0&#x00A0;0&#x00A0;1}
+&#x00A0;&#x00A0;&#x00A0;&#x00A0;\hypersetup{pdfborder=0&#x00A0;0&#x00A0;1}
</div>
-<!--l. 3036--><p class="nopar" > In <span class="obeylines-h"><span class="verb"><span
+<!--l. 3042--><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. 3042--><p class="indent" > Alternatively, LaTeX&#8217;s option handling system can be adapted to key value options by
+<!--l. 3048--><p class="indent" > Alternatively, LaTeX&#8217;s option handling system can be adapted to key value options by
one of the packages "kvoptions-patch" (from project "kvoptions") or "xkvltxp" (from project
"xsetkeys").
-<!--l. 3047--><p class="noindent" >
+<!--l. 3053--><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">
@@ -6799,7 +6812,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. 3071--><p class="nopar" >
+ <!--l. 3077--><p class="nopar" >
</li>
<li class="itemize">Scientic Word/Scientific WorkPlace users can use package robustindex with hyperindex=false.
</li>
@@ -6809,7 +6822,7 @@ class="ec-lmvtt-10">\hyperpage</span></span></span> command. With
<div class="verbatim" id="verbatim-76">
&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;\usepackage[encap=?]{hyperref}
</div>
- <!--l. 3078--><p class="nopar" >
+ <!--l. 3084--><p class="nopar" >
</li>
<li class="itemize">An other 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,
@@ -6830,11 +6843,11 @@ class="ec-lmvtt-10">\hyperpage</span></span></span> will be defined regardless
&#x00A0;<br />encap_suffix&#x00A0;"}"
&#x00A0;<br />%%%&#x00A0;cut&#x00A0;%%%&#x00A0;hyperindex.ist&#x00A0;%%%&#x00A0;cut&#x00A0;%%%
</div>
- <!--l. 3094--><p class="nopar" ></li></ul>
-<!--l. 3097--><p class="noindent" >
+ <!--l. 3100--><p class="nopar" ></li></ul>
+<!--l. 3103--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">11.3 </span> <a
id="x1-10400011.3"></a>Warning "bookmark level for unknown &#x003C;foobar&#x003E; defaults to 0"</h4>
-<!--l. 3099--><p class="noindent" >Getting rid of it:
+<!--l. 3105--><p class="noindent" >Getting rid of it:
<div class="verbatim" id="verbatim-78">
@@ -6842,15 +6855,15 @@ class="ec-lmvtt-10">\hyperpage</span></span></span> will be defined regardless
&#x00A0;<br />\providecommand*{\toclevel@&#x003C;foobar&#x003E;}{0}
&#x00A0;<br />\makeatother
</div>
-<!--l. 3104--><p class="nopar" >
-<!--l. 3106--><p class="noindent" >
+<!--l. 3110--><p class="nopar" >
+<!--l. 3112--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">11.4 </span> <a
id="x1-10500011.4"></a>Link anchors in figures</h4>
-<!--l. 3108--><p class="noindent" >The caption command increments the counter and here is the place where hyperref set the corresponding
+<!--l. 3114--><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 "hypcap.sty" that implements a method to circumvent the
problem.
-<!--l. 3116--><p class="noindent" >
+<!--l. 3122--><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>
@@ -6859,14 +6872,14 @@ problem.
\documentclass[pdftex]{article}
&#x00A0;<br />\usepackage[unicode]{hyperref}
</div>
-<!--l. 3120--><p class="nopar" >
-<!--l. 3122--><p class="indent" > Support for additional unicode characters:
-<!--l. 3124--><p class="indent" > Example: <span class="obeylines-h"><span class="verb"><span
+<!--l. 3126--><p class="nopar" >
+<!--l. 3128--><p class="indent" > Support for additional unicode characters:
+<!--l. 3130--><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. 3126--><p class="indent" > 1. Get a list with unicode data, eg:
-<!--l. 3128--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt
-<!--l. 3130--><p class="indent" > 2. Identify the characters (<span class="obeylines-h"><span class="verb"><span
+<!--l. 3132--><p class="indent" > 1. Get a list with unicode data, eg:
+<!--l. 3134--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt
+<!--l. 3136--><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>):
@@ -6875,9 +6888,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. 3134--><p class="nopar" >
-<!--l. 3136--><p class="indent" > 3. Calculate the octal code:
-<!--l. 3138--><p class="indent" > The first characters of the line in the file are hex values, convert each byte and prepend them with a
+<!--l. 3140--><p class="nopar" >
+<!--l. 3142--><p class="indent" > 3. Calculate the octal code:
+<!--l. 3144--><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.)
@@ -6885,9 +6898,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. 3145--><p class="nopar" >
-<!--l. 3147--><p class="indent" > 4. Transform into a form understood by hyperref:
-<!--l. 3149--><p class="indent" > Hyperref must know where the first byte starts, this is marked by "9" (8 and 9 cannot occur in octal
+<!--l. 3151--><p class="nopar" >
+<!--l. 3153--><p class="indent" > 4. Transform into a form understood by hyperref:
+<!--l. 3155--><p class="indent" > Hyperref must know where the first byte starts, this is marked by "9" (8 and 9 cannot occur in octal
numbers):
@@ -6895,8 +6908,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. 3156--><p class="nopar" >
-<!--l. 3158--><p class="indent" > Optional: "8" is used for abbreviations:
+<!--l. 3162--><p class="nopar" >
+<!--l. 3164--><p class="indent" > Optional: "8" is used for abbreviations:
<div class="verbatim" id="verbatim-83">
@@ -6904,8 +6917,8 @@ numbers):
&#x00A0;<br />
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;\9002\047&#x00A0;-&#x003E;&#x00A0;\82\047
</div>
-<!--l. 3164--><p class="nopar" >
-<!--l. 3166--><p class="indent" > 5. Declare the character with LaTeX:
+<!--l. 3170--><p class="nopar" >
+<!--l. 3172--><p class="indent" > 5. Declare the character with LaTeX:
<div class="verbatim" id="verbatim-84">
@@ -6917,11 +6930,11 @@ numbers):
&#x00A0;<br />\end{document}
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;
</div>
-<!--l. 3175--><p class="nopar" >
-<!--l. 3177--><p class="noindent" >
+<!--l. 3181--><p class="nopar" >
+<!--l. 3183--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">11.6 </span> <a
id="x1-10700011.6"></a>Footnotes</h4>
-<!--l. 3179--><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. 3185--><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
@@ -6978,12 +6991,12 @@ class="ec-lmvtt-10">\footnotemark</span></span></span>. Here you can either disa
&#x00A0;<br />
&#x00A0;<br />\end{document}
</div>
-<!--l. 3233--><p class="nopar" >
+<!--l. 3239--><p class="nopar" >
-<!--l. 3235--><p class="noindent" >
+<!--l. 3241--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">11.7 </span> <a
id="x1-10800011.7"></a>Subordinate counters</h4>
-<!--l. 3237--><p class="noindent" >Some counters do not have unique values and require the value of other counters to be unique. For
+<!--l. 3243--><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
@@ -6992,13 +7005,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. 3247--><p class="indent" > However, if the definition of subordinate counters take place before hyperref is loaded, the old
+<!--l. 3253--><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. 3253--><p class="indent" > Example for <span class="obeylines-h"><span class="verb"><span
+<!--l. 3259--><p class="indent" > Example for <span class="obeylines-h"><span class="verb"><span
class="ec-lmvtt-10">\newtheorem</span></span></span>, problematic case:
@@ -7006,14 +7019,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. 3257--><p class="nopar" > Solution a)
+<!--l. 3263--><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. 3262--><p class="nopar" > Solution b)
+<!--l. 3268--><p class="nopar" > Solution b)
<div class="verbatim" id="verbatim-88">
@@ -7021,11 +7034,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. 3268--><p class="nopar" >
-<!--l. 3270--><p class="noindent" >
+<!--l. 3274--><p class="nopar" >
+<!--l. 3276--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">12 </span> <a
id="x1-10900012"></a>History and acknowledgments</h3>
-<!--l. 3272--><p class="noindent" >The original authors of <span
+<!--l. 3278--><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
@@ -7038,13 +7051,13 @@ 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. 3285--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has
+<!--l. 3291--><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
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. 3293--><p class="indent" > Berthold Horn provided help, encouragement and sponsorship for the <span
+<!--l. 3299--><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
@@ -7058,14 +7071,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. 3302--><p class="indent" > The forms creation section owes a great deal to: T.&#x00A0;V.&#x00A0;Raman, for encouragement, support and
+<!--l. 3308--><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. 3308--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost.
-<!--l. 3311--><p class="indent" > Especial extra thanks to David Carlisle for the <span
+<!--l. 3314--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost.
+<!--l. 3317--><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
@@ -7336,9 +7349,10 @@ of the documents in all other respects.
License, provided you insert a copy of this License into the extracted document, and follow this License
in all other respects regarding verbatim copying of that document.
<!--l. 317--><p class="noindent" >
- <h4 class="subsectionHead"><span class="titlemark">13.7 </span> <a
- id="x1-11800013.7"></a>Aggregation with independent works</h4>
+
+ <h4 class="subsectionHead"><span class="titlemark">13.7 </span> <a
+ id="x1-11800013.7"></a>Aggregation with independent works</h4>
<!--l. 320--><p class="noindent" >A compilation of the Document or its derivatives with other separate and independent documents or
works, in or on a volume of a storage or distribution medium, is called an &#8220;aggregate&#8221; if the copyright
resulting from the compilation is not used to limit the legal rights of the compilation&#8217;s users beyond what