diff options
| author | Karl Berry <karl@freefriends.org> | 2023-07-08 19:48:01 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2023-07-08 19:48:01 +0000 |
| commit | edef208e629f021498d28b47c6c0d6ef9504e28e (patch) | |
| tree | 1e87364b59c04695dae0e9490e7a41bb455842d9 /Master/texmf-dist/doc/latex/hyperref | |
| parent | e2c0dfc86ef1373dc1905e54a6951828a2995825 (diff) | |
hyperref (8jul23)
git-svn-id: svn://tug.org/texlive/trunk@67583 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref')
17 files changed, 8814 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt index 0c9421dd128..62e2f83fa9f 100644 --- a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt +++ b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt @@ -1,3 +1,8 @@ +2023-07-07 Ulrike Fischer + * make \Hy@@SectionAnchor safe in a MakeUppercase, issue 281 + * reset also \ltx@label of amsmath (avoids problems with ntheorem and classes like svmono) + + 2023-06-25 Ulrike Fischer * define the amsmath \ifmeasuring@ always as external package depend on hyperref doing it. diff --git a/Master/texmf-dist/doc/latex/hyperref/README.md b/Master/texmf-dist/doc/latex/hyperref/README.md index 013d3d82e96..cdf76f45c76 100644 --- a/Master/texmf-dist/doc/latex/hyperref/README.md +++ b/Master/texmf-dist/doc/latex/hyperref/README.md @@ -1,6 +1,6 @@ # README for hyperref bundle -Version 2023-06-25 v7.01a +Version 2023-07-08 v7.01b ## INTRODUCTION diff --git a/Master/texmf-dist/doc/latex/hyperref/backref.pdf b/Master/texmf-dist/doc/latex/hyperref/backref.pdf Binary files differindex 10bc5158a7a..15ca607a5f5 100644 --- a/Master/texmf-dist/doc/latex/hyperref/backref.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/backref.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.css b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.css new file mode 100644 index 00000000000..328505fcb2d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.css @@ -0,0 +1,321 @@ + +/* start css.sty */ +.ec-lmr-17{font-size:170%;} +.ec-lmss-17{font-size:170%; font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmr-12{font-size:120%;} +.ec-lmvtt-10x-x-120{font-size:120%; font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-120{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmvtt-10{ font-family: monospace,monospace;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.lmsy7-{font-size:70%;} +.ec-lmr-9{font-size:90%;} +.ec-lmr-8{font-size:80%;} +.ec-lmvtt-10x-x-80{font-size:80%; font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmvtt-10x-x-80{ font-family: monospace,monospace;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmss-8{font-size:80%; font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmss-8{ font-family: sans-serif;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtto-10{ font-style: oblique; font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmvtk-10{ font-family: monospace,monospace;} +.ec-lmr-5{font-size:50%;} +p{margin-top:0;margin-bottom:0} +p.indent{text-indent:0;} +p + p{margin-top:1em;} +p + div, p + pre {margin-top:1em;} +div + p, pre + p {margin-top:1em;} +a { overflow-wrap: break-word; word-wrap: break-word; word-break: break-word; hyphens: auto; } +@media print {div.crosslinks {visibility:hidden;}} +table.tabular{border-collapse: collapse; border-spacing: 0;} +a img { border-top: 0; border-left: 0; border-right: 0; } +center { margin-top:1em; margin-bottom:1em; } +td center { margin-top:0em; margin-bottom:0em; } +.Canvas { position:relative; } +img.math{vertical-align:middle;} +div.par-math-display, div.math-display{text-align:center;} +li p.indent { text-indent: 0em } +li p:first-child{ margin-top:0em; } +li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p:first-child{ margin-bottom:0; } +li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } +.enumerate1 {list-style-type:decimal;} +.enumerate2 {list-style-type:lower-alpha;} +.enumerate3 {list-style-type:lower-roman;} +.enumerate4 {list-style-type:upper-alpha;} +div.newtheorem { margin-bottom: 2em; margin-top: 2em;} +div.newtheorem .head{font-weight: bold;} +.obeylines-h,.obeylines-v {white-space: nowrap; } +div.obeylines-v p { margin-top:0; margin-bottom:0; } +.overline{ text-decoration:overline; } +.overline img{ border-top: 1px solid black; } +td.displaylines {text-align:center; white-space:nowrap;} +.centerline {text-align:center;} +.rightline {text-align:right;} +pre.verbatim {font-family: monospace,monospace; text-align:left; clear:both; } +.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.fbox {display:table} +div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.minipage{width:100%;} +div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;} +div.center div {text-align: left;} +div.flushright, div.flushright div.flushright {text-align: right;} +div.flushright div {text-align: left;} +div.flushleft {text-align: left;} +.underline{ text-decoration:underline; } +.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; } +.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +.framebox-c {text-align:center;} +.framebox-l {text-align:left;} +.framebox-r {text-align:right;} +span.thank-mark{ vertical-align: super } +span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; } +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 0px; margin:0px; } +.hline td, .cline td{ padding: 0; } +.hline hr, .cline hr{border:none;border-top:1px solid black;} +.hline {border-top: 1px solid black;} +.hline + .vspace:last-child{display:none;} +.hline:first-child{border-bottom:1px solid black;border-top:none;} +.tabbing-right {text-align:right;} +div.float, div.figure {margin-left: auto; margin-right: auto;} +div.float img {text-align:center;} +div.figure img {text-align:center;} +.marginpar,.reversemarginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;} +.marginpar p,.reversemarginpar p{margin-top:0.4em; margin-bottom:0.4em;} +.reversemarginpar{float:left;} +table.equation {width:100%;} +.equation td{text-align:center; } +td.equation { margin-top:1em; margin-bottom:1em; } +td.equation-label { width:5%; text-align:center; } +td.eqnarray4 { width:5%; white-space: normal; } +td.eqnarray2 { width:5%; } +table.eqnarray-star, table.eqnarray {width:100%;} +div.eqnarray{text-align:center;} +div.array {text-align:center;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.pmatrix img{vertical-align:middle;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.bar-css {text-decoration:overline;} +img.cdots{vertical-align:middle;} +.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.chapterToc a, .chapterToc, .likechapterToc a, .likechapterToc, .appendixToc a, .appendixToc {line-height: 200%; font-weight:bold;} +.index-item, .index-subitem, .index-subsubitem {display:block} +div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;} +div.caption span.id{font-weight: bold; white-space: nowrap; } +h1.partHead{text-align: center} +p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +.subsubsectionHead, .likesubsubsectionHead { font-size: 1em; } +.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} +.subparagraphHead, .likesubparagraphHead { font-weight: bold;} +.verse{white-space:nowrap; margin-left:2em} +div.maketitle {text-align:center;} +h2.titleHead{text-align:center;} +div.maketitle{ margin-bottom: 2em; } +div.author, div.date {text-align:center;} +div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } +div.author{white-space: nowrap;} +div.abstract p {margin-left:5%; margin-right:5%;} +div.abstract {width:100%;} +.abstracttitle{text-align:center;margin-bottom:1em;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 0px; margin:0px; } +.hline td, .cline td{ padding: 0; } +.hline hr, .cline hr{border:none;border-top:1px solid black;} +.hline {border-top: 1px solid black;} +.hline + .vspace:last-child{display:none;} +.hline:first-child{border-bottom:1px solid black;border-top:none;} +div.array {text-align:center;} +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +table.longtable{border-collapse: collapse; border-spacing: 0;} +div.longtable{text-align:center;} +table.longtable{margin-left:auto; margin-right: auto;} +caption.longtable .id{font-weight:bold;} +span.HoLogo-LaTeX span.HoLogo-a{position:relative;top:-.5ex;margin-left:-.36em;margin-right:-.15em;font-size:85%;} +span.HoLogo-TeX span.HoLogo-e{position:relative;top:.5ex;margin-left:-.1667em;margin-right:-.125em;} +a span.HoLogo-TeX span.HoLogo-e{text-decoration:none;} +span.HoLogo-OzTeX span.HoLogo-z{margin-left:-.03em;margin-right:-.15em;} +span.HoLogo-XeTeX span.HoLogo-TeX{margin-left:-.15em;} +span.HoLogo-Xe span.HoLogo-e{position:relative;top:.5ex;left-margin:-.1em;} +span.HoLogo-LaTeX2e span.HoLogo-2{padding-left:.15em;} +span.HoLogo-LaTeX2e span.HoLogo-e{position:relative;top:.35ex;text-decoration:none;} +/* end css.sty */ + + diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.html new file mode 100644 index 00000000000..19e888b0beb --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.html @@ -0,0 +1,8332 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title>Hypertext marks in LATEX: a manual for hyperref</title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="maketitle"> + + + + + +<h2 class="titleHead">Hypertext marks in <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>: a manual for hyperref</h2> + <div class="author" ><span +class="ec-lmr-12">Sebastian Rahtz (deceased)</span><br class="and" /><span +class="ec-lmr-12">Heiko Oberdiek (inactive)</span><br class="and" /><span +class="ec-lmr-12">The LaTeX3 Project ( </span><a +href="https://github.com/latex3/hyperref/issues" class="url" ><span +class="ec-lmvtt-10x-x-120">https://github.com/latex3/hyperref/issues</span></a><span +class="ec-lmr-12">)</span></div><br /> +<div class="date" ><span +class="ec-lmr-12">2023-02-07 v7.00v</span></div> + </div> + <h3 class="likesectionHead"><a + id="x1-1000"></a>Contents</h3> + <div class="tableofcontents"> +  <span class="sectionToc" >1 <a +href="#x1-20001" id="QQ2-1-2">Preface</a></span> +<br />   <span class="subsectionToc" >1.1 <a +href="#x1-30001.1" id="QQ2-1-3">Restoring removed patches</a></span> +<br />  <span class="sectionToc" >2 <a +href="#x1-40002" id="QQ2-1-4">Introduction</a></span> +<br />  <span class="sectionToc" >3 <a +href="#x1-50003" id="QQ2-1-5">Implicit behavior</a></span> +<br />  <span class="sectionToc" >4 <a +href="#x1-60004" id="QQ2-1-6">Interfaces for class and package authors</a></span> +<br />   <span class="subsectionToc" >4.1 <a +href="#x1-70004.1" id="QQ2-1-7">Counters</a></span> +<br />   <span class="subsectionToc" >4.2 <a +href="#x1-80004.2" id="QQ2-1-8">Values of package and <span +class="ec-lmvtt-10">\hypersetup </span>options</a></span> +<br />   <span class="subsectionToc" >4.3 <a +href="#x1-90004.3" id="QQ2-1-9">Links commands</a></span> +<br />   <span class="subsectionToc" >4.4 <a +href="#x1-100004.4" id="QQ2-1-10">Creating targets</a></span> +<br />   <span class="subsectionToc" >4.5 <a +href="#x1-110004.5" id="QQ2-1-11">Patches and how to suppress them</a></span> +<br />  <span class="sectionToc" >5 <a +href="#x1-120005" id="QQ2-1-12">Package options</a></span> +<br />   <span class="subsectionToc" >5.1 <a +href="#x1-130005.1" id="QQ2-1-13">General options</a></span> +<br />   <span class="subsectionToc" >5.2 <a +href="#x1-140005.2" id="QQ2-1-14">Options for destination names</a></span> +<br />   <span class="subsectionToc" >5.3 <a +href="#x1-150005.3" id="QQ2-1-15">Configuration options</a></span> +<br />   <span class="subsectionToc" >5.4 <a +href="#x1-160005.4" id="QQ2-1-16">Backend drivers</a></span> +<br />   <span class="subsectionToc" >5.5 <a +href="#x1-170005.5" id="QQ2-1-17">Extension options</a></span> +<br />   <span class="subsectionToc" >5.6 <a +href="#x1-180005.6" id="QQ2-1-18">PDF-specific display options</a></span> +<br />   <span class="subsectionToc" >5.7 <a +href="#x1-190005.7" id="QQ2-1-19">PDF display and information options</a></span> +<br />   <span class="subsectionToc" >5.8 <a +href="#x1-200005.8" id="QQ2-1-20">Option <span +class="ec-lmvtt-10">pdfinfo</span></a></span> +<br />   <span class="subsectionToc" >5.9 <a +href="#x1-210005.9" id="QQ2-1-21">Big alphabetical list</a></span> +<br />  <span class="sectionToc" >6 <a +href="#x1-220006" id="QQ2-1-22">Additional user macros</a></span> +<br />   <span class="subsectionToc" >6.1 <a +href="#x1-230006.1" id="QQ2-1-23">Bookmark macros</a></span> +<br />    <span class="subsubsectionToc" >6.1.1 <a +href="#x1-240006.1.1" id="QQ2-1-24">Setting bookmarks</a></span> +<br />    <span class="subsubsectionToc" >6.1.2 <a +href="#x1-250006.1.2" id="QQ2-1-25">Replacement macros</a></span> +<br />   <span class="subsectionToc" >6.2 <a +href="#x1-260006.2" id="QQ2-1-26">Pagelabels</a></span> +<br />   <span class="subsectionToc" >6.3 <a +href="#x1-270006.3" id="QQ2-1-27">Utility macros</a></span> +<br />  <span class="sectionToc" >7 <a +href="#x1-280007" id="QQ2-1-28">New Features</a></span> +<br />   <span class="subsectionToc" >7.1 <a +href="#x1-290007.1" id="QQ2-1-29">Option ‘pdflinkmargin’</a></span> +<br />   <span class="subsectionToc" >7.2 <a +href="#x1-300007.2" id="QQ2-1-30">Field option ‘calculatesortkey’</a></span> +<br />   <span class="subsectionToc" >7.3 <a +href="#x1-310007.3" id="QQ2-1-31">Option ‘next-anchor’</a></span> +<br />   <span class="subsectionToc" >7.4 <a +href="#x1-320007.4" id="QQ2-1-32">Option ‘localanchorname’</a></span> +<br />   <span class="subsectionToc" >7.5 <a +href="#x1-330007.5" id="QQ2-1-33">Option ‘customdriver’</a></span> +<br />   <span class="subsectionToc" >7.6 <a +href="#x1-340007.6" id="QQ2-1-34">Option ‘psdextra’</a></span> + + +<br />   <span class="subsectionToc" >7.7 <a +href="#x1-350007.7" id="QQ2-1-35">\XeTeXLinkBox</a></span> +<br />   <span class="subsectionToc" >7.8 <a +href="#x1-360007.8" id="QQ2-1-36">\IfHyperBooleanExists and \IfHyperBoolean</a></span> +<br />   <span class="subsectionToc" >7.9 <a +href="#x1-370007.9" id="QQ2-1-37">\unichar</a></span> +<br />   <span class="subsectionToc" >7.10 <a +href="#x1-380007.10" id="QQ2-1-38">\ifpdfstringunicode</a></span> +<br />   <span class="subsectionToc" >7.11 <a +href="#x1-390007.11" id="QQ2-1-39">Customizing index style file with \nohyperpage</a></span> +<br />   <span class="subsectionToc" >7.12 <a +href="#x1-400007.12" id="QQ2-1-40">Experimental option ‘ocgcolorlinks’</a></span> +<br />   <span class="subsectionToc" >7.13 <a +href="#x1-410007.13" id="QQ2-1-41">Option ‘pdfa’</a></span> +<br />   <span class="subsectionToc" >7.14 <a +href="#x1-420007.14" id="QQ2-1-42">Option ‘linktoc’ added</a></span> +<br />   <span class="subsectionToc" >7.15 <a +href="#x1-430007.15" id="QQ2-1-43">Option ‘pdfnewwindow’ changed</a></span> +<br />   <span class="subsectionToc" >7.16 <a +href="#x1-440007.16" id="QQ2-1-44">Flag options for PDF forms</a></span> +<br />   <span class="subsectionToc" >7.17 <a +href="#x1-450007.17" id="QQ2-1-45">Option ‘pdfversion’</a></span> +<br />   <span class="subsectionToc" >7.18 <a +href="#x1-460007.18" id="QQ2-1-46">Field option ‘name’</a></span> +<br />   <span class="subsectionToc" >7.19 <a +href="#x1-470007.19" id="QQ2-1-47">Option ‘pdfencoding’</a></span> +<br />   <span class="subsectionToc" >7.20 <a +href="#x1-480007.20" id="QQ2-1-48">Color options/package hycolor</a></span> +<br />   <span class="subsectionToc" >7.21 <a +href="#x1-490007.21" id="QQ2-1-49">Option pdfusetitle</a></span> +<br />   <span class="subsectionToc" >7.22 <a +href="#x1-500007.22" id="QQ2-1-50">Starred form of \autoref</a></span> +<br />   <span class="subsectionToc" >7.23 <a +href="#x1-510007.23" id="QQ2-1-51">Link border style</a></span> +<br />   <span class="subsectionToc" >7.24 <a +href="#x1-520007.24" id="QQ2-1-52">Option <span +class="ec-lmss-10">bookmarksdepth</span></a></span> +<br />   <span class="subsectionToc" >7.25 <a +href="#x1-530007.25" id="QQ2-1-53">Option <span +class="ec-lmss-10">pdfescapeform</span></a></span> +<br />   <span class="subsectionToc" >7.26 <a +href="#x1-540007.26" id="QQ2-1-54">Default driver setting</a></span> +<br />   <span class="subsectionToc" >7.27 <a +href="#x1-550007.27" id="QQ2-1-55">Backref entries</a></span> +<br />   <span class="subsectionToc" >7.28 <a +href="#x1-560007.28" id="QQ2-1-56">\phantomsection</a></span> +<br />   <span class="subsectionToc" >7.29 <a +href="#x1-570007.29" id="QQ2-1-57">puenc encoding, puenc-greekbasic.def and puenc-extra.def</a></span> +<br />  <span class="sectionToc" >8 <a +href="#x1-580008" id="QQ2-1-58">Acrobat-specific behavior</a></span> +<br />  <span class="sectionToc" >9 <a +href="#x1-590009" id="QQ2-1-59">PDF and HTML forms</a></span> +<br />   <span class="subsectionToc" >9.1 <a +href="#x1-600009.1" id="QQ2-1-60">Forms environment parameters</a></span> +<br />   <span class="subsectionToc" >9.2 <a +href="#x1-610009.2" id="QQ2-1-61">Forms optional parameters</a></span> +<br />  <span class="sectionToc" >10 <a +href="#x1-6200010" id="QQ2-1-62">Defining a new driver</a></span> +<br />  <span class="sectionToc" >11 <a +href="#x1-6300011" id="QQ2-1-63">Special support for other packages</a></span> +<br />   <span class="subsectionToc" >11.1 <a +href="#x1-6400011.1" id="QQ2-1-64">Package Compatibility</a></span> +<br />    <span class="subsubsectionToc" >11.1.1 <a +href="#x1-6500011.1.1" id="QQ2-1-65">algorithm</a></span> +<br />    <span class="subsubsectionToc" >11.1.2 <a +href="#x1-6600011.1.2" id="QQ2-1-66">amsmath</a></span> +<br />    <span class="subsubsectionToc" >11.1.3 <a +href="#x1-6700011.1.3" id="QQ2-1-67">amsrefs</a></span> +<br />    <span class="subsubsectionToc" >11.1.4 <a +href="#x1-6800011.1.4" id="QQ2-1-68">arydshln, longtable</a></span> +<br />    <span class="subsubsectionToc" >11.1.5 <a +href="#x1-6900011.1.5" id="QQ2-1-69">babel/magyar.ldf</a></span> +<br />    <span class="subsubsectionToc" >11.1.6 <a +href="#x1-7000011.1.6" id="QQ2-1-70">babel/spanish.ldf</a></span> +<br />    <span class="subsubsectionToc" >11.1.7 <a +href="#x1-7100011.1.7" id="QQ2-1-71">bibentry</a></span> +<br />    <span class="subsubsectionToc" >11.1.8 <a +href="#x1-7200011.1.8" id="QQ2-1-72">bigfoot</a></span> +<br />    <span class="subsubsectionToc" >11.1.9 <a +href="#x1-7300011.1.9" id="QQ2-1-73">chappg</a></span> +<br />    <span class="subsubsectionToc" >11.1.10 <a +href="#x1-7400011.1.10" id="QQ2-1-74">cite</a></span> +<br />    <span class="subsubsectionToc" >11.1.11 <a +href="#x1-7500011.1.11" id="QQ2-1-75">count1to</a></span> +<br />    <span class="subsubsectionToc" >11.1.12 <a +href="#x1-7600011.1.12" id="QQ2-1-76">dblaccnt</a></span> +<br />    <span class="subsubsectionToc" >11.1.13 <a +href="#x1-7700011.1.13" id="QQ2-1-77">easyeqn</a></span> +<br />    <span class="subsubsectionToc" >11.1.14 <a +href="#x1-7800011.1.14" id="QQ2-1-78">ellipsis</a></span> +<br />    <span class="subsubsectionToc" >11.1.15 <a +href="#x1-7900011.1.15" id="QQ2-1-79">float</a></span> +<br />    <span class="subsubsectionToc" >11.1.16 <a +href="#x1-8000011.1.16" id="QQ2-1-80">endnotes</a></span> +<br />    <span class="subsubsectionToc" >11.1.17 <a +href="#x1-8100011.1.17" id="QQ2-1-81">foiltex</a></span> +<br />    <span class="subsubsectionToc" >11.1.18 <a +href="#x1-8200011.1.18" id="QQ2-1-82">footnote</a></span> +<br />    <span class="subsubsectionToc" >11.1.19 <a +href="#x1-8300011.1.19" id="QQ2-1-83">geometry</a></span> +<br />    <span class="subsubsectionToc" >11.1.20 <a +href="#x1-8400011.1.20" id="QQ2-1-84">IEEEtran.cls</a></span> +<br />    <span class="subsubsectionToc" >11.1.21 <a +href="#x1-8500011.1.21" id="QQ2-1-85">index</a></span> +<br />    <span class="subsubsectionToc" >11.1.22 <a +href="#x1-8600011.1.22" id="QQ2-1-86">lastpage</a></span> + +<br />    <span class="subsubsectionToc" >11.1.23 <a +href="#x1-8700011.1.23" id="QQ2-1-87">linguex</a></span> +<br />    <span class="subsubsectionToc" >11.1.24 <a +href="#x1-8800011.1.24" id="QQ2-1-88">ltabptch</a></span> +<br />    <span class="subsubsectionToc" >11.1.25 <a +href="#x1-8900011.1.25" id="QQ2-1-89">mathenv</a></span> +<br />    <span class="subsubsectionToc" >11.1.26 <a +href="#x1-9000011.1.26" id="QQ2-1-90">minitoc-hyper</a></span> +<br />    <span class="subsubsectionToc" >11.1.27 <a +href="#x1-9100011.1.27" id="QQ2-1-91">multind</a></span> +<br />    <span class="subsubsectionToc" >11.1.28 <a +href="#x1-9200011.1.28" id="QQ2-1-92">natbib</a></span> +<br />    <span class="subsubsectionToc" >11.1.29 <a +href="#x1-9300011.1.29" id="QQ2-1-93">nomencl</a></span> +<br />    <span class="subsubsectionToc" >11.1.30 <a +href="#x1-9400011.1.30" id="QQ2-1-94">ntheorem-hyper</a></span> +<br />    <span class="subsubsectionToc" >11.1.31 <a +href="#x1-9500011.1.31" id="QQ2-1-95">prettyref</a></span> +<br />    <span class="subsubsectionToc" >11.1.32 <a +href="#x1-9600011.1.32" id="QQ2-1-96">setspace</a></span> +<br />    <span class="subsubsectionToc" >11.1.33 <a +href="#x1-9700011.1.33" id="QQ2-1-97">sidecap</a></span> +<br />    <span class="subsubsectionToc" >11.1.34 <a +href="#x1-9800011.1.34" id="QQ2-1-98">subfigure</a></span> +<br />    <span class="subsubsectionToc" >11.1.35 <a +href="#x1-9900011.1.35" id="QQ2-1-99">titleref</a></span> +<br />    <span class="subsubsectionToc" >11.1.36 <a +href="#x1-10000011.1.36" id="QQ2-1-100">tabularx</a></span> +<br />    <span class="subsubsectionToc" >11.1.37 <a +href="#x1-10100011.1.37" id="QQ2-1-101">titlesec</a></span> +<br />    <span class="subsubsectionToc" >11.1.38 <a +href="#x1-10200011.1.38" id="QQ2-1-102">ucs/utf8x.def</a></span> +<br />    <span class="subsubsectionToc" >11.1.39 <a +href="#x1-10300011.1.39" id="QQ2-1-103">varioref</a></span> +<br />    <span class="subsubsectionToc" >11.1.40 <a +href="#x1-10400011.1.40" id="QQ2-1-104">verse</a></span> +<br />    <span class="subsubsectionToc" >11.1.41 <a +href="#x1-10500011.1.41" id="QQ2-1-105">vietnam</a></span> +<br />    <span class="subsubsectionToc" >11.1.42 <a +href="#x1-10600011.1.42" id="QQ2-1-106">XeTeX</a></span> +<br />  <span class="sectionToc" >12 <a +href="#x1-10700012" id="QQ2-1-107">Limitations</a></span> +<br />   <span class="subsectionToc" >12.1 <a +href="#x1-10800012.1" id="QQ2-1-108">Wrapped/broken link support</a></span> +<br />   <span class="subsectionToc" >12.2 <a +href="#x1-10900012.2" id="QQ2-1-109">Links across pages</a></span> +<br />   <span class="subsectionToc" >12.3 <a +href="#x1-11000012.3" id="QQ2-1-110">Footnotes</a></span> +<br />  <span class="sectionToc" >13 <a +href="#x1-11100013" id="QQ2-1-111">Hints</a></span> +<br />   <span class="subsectionToc" >13.1 <a +href="#x1-11200013.1" id="QQ2-1-112">Spaces in option values</a></span> +<br />   <span class="subsectionToc" >13.2 <a +href="#x1-11300013.2" id="QQ2-1-113">Index with makeindex</a></span> +<br />   <span class="subsectionToc" >13.3 <a +href="#x1-11400013.3" id="QQ2-1-114">Warning <span +class="ec-lmvtt-10">"bookmark level for unknown <foobar> defaults to 0"</span></a></span> +<br />   <span class="subsectionToc" >13.4 <a +href="#x1-11500013.4" id="QQ2-1-115">Link anchors in figures</a></span> +<br />   <span class="subsectionToc" >13.5 <a +href="#x1-11600013.5" id="QQ2-1-116">Additional unicode characters in bookmarks and pdf information entries:</a></span> +<br />   <span class="subsectionToc" >13.6 <a +href="#x1-11700013.6" id="QQ2-1-117">Footnotes</a></span> +<br />   <span class="subsectionToc" >13.7 <a +href="#x1-11800013.7" id="QQ2-1-118">Subordinate counters</a></span> +<br />  <span class="sectionToc" >14 <a +href="#x1-11900014" id="QQ2-1-119">History and acknowledgments</a></span> +<br />  <span class="sectionToc" >15 <a +href="#x1-12000015" id="QQ2-1-120">GNU Free Documentation License</a></span> +<br />   <span class="subsectionToc" >15.1 <a +href="#x1-12200015.1" id="QQ2-1-122">Applicability and definitions</a></span> +<br />   <span class="subsectionToc" >15.2 <a +href="#x1-12300015.2" id="QQ2-1-123">Verbatim copying</a></span> +<br />   <span class="subsectionToc" >15.3 <a +href="#x1-12400015.3" id="QQ2-1-124">Copying in quantity</a></span> +<br />   <span class="subsectionToc" >15.4 <a +href="#x1-12500015.4" id="QQ2-1-125">Modifications</a></span> +<br />   <span class="subsectionToc" >15.5 <a +href="#x1-12600015.5" id="QQ2-1-126">Combining documents</a></span> +<br />   <span class="subsectionToc" >15.6 <a +href="#x1-12700015.6" id="QQ2-1-127">Collections of documents</a></span> +<br />   <span class="subsectionToc" >15.7 <a +href="#x1-12800015.7" id="QQ2-1-128">Aggregation with independent works</a></span> +<br />   <span class="subsectionToc" >15.8 <a +href="#x1-12900015.8" id="QQ2-1-129">Translation</a></span> +<br />   <span class="subsectionToc" >15.9 <a +href="#x1-13000015.9" id="QQ2-1-130">Termination</a></span> +<br />   <span class="subsectionToc" >15.10 <a +href="#x1-13100015.10" id="QQ2-1-131">Future revisions of this license</a></span> + </div> + + +<!--l. 179--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">1 </span> <a + id="x1-20001"></a>Preface</h3> +<!--l. 180--><p class="noindent" >As can be already seen in the following introduction, <span +class="ec-lmss-10">hyperref </span>has a long history and has seen many +changes over time. The introduction mentions workflows, drivers and problems that are no longer (or +only in edge cases) relevant. The documentation reflects this varied history: changes and +extensions and explanations were and are spread over various papers and sources or have +been incorporated later and so are not always in a coherent order and in sync which each +other. +<!--l. 187--><p class="indent" > This history is continuing: If you are using the new <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> PDF management which +is currently distributed as a testphase package <span +class="ec-lmss-10">pdfmanagement-testphase </span>then <span +class="ec-lmss-10">hyperref </span>will +for the PDF output use a new generic driver which contains a number of changes and new +features. The documentation of this driver <span +class="ec-lmvtt-10">hyperref-generic.pdf </span>is currently a part of the +<span +class="ec-lmss-10">pdfmanagement-testphase </span>documentation. One important change of the new driver is that it removed +the old <span +class="ec-lmss-10">hyperref </span>code for book marks and uses the <span +class="ec-lmss-10">bookmark </span>package instead. So to learn +about options to extend the bookmarks you should consult the <span +class="ec-lmss-10">bookmark </span>documentation +too. +<!--l. 199--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.1 </span> <a + id="x1-30001.1"></a>Restoring removed patches</h4> +<!--l. 201--><p class="noindent" ><span +class="ec-lmss-10">hyperref </span>has over time patched quite a number of packages to resolve clashes and incompabilities. Many +of them are either no longer needed or should be done by the original packages. Those patches are now +slowly removed from <span +class="ec-lmss-10">hyperref</span>. It should normally not lead to problems, but in case that the patches +should be restored they can be loaded through the package <span +class="ec-lmss-10">hyperref-patches </span>which is a part of this +bundle. +<!--l. 209--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">2 </span> <a + id="x1-40002"></a>Introduction</h3> +<!--l. 211--><p class="noindent" >The package derives from, and builds on, the work of the Hyper<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> project, described at <span +class="ec-lmvtt-10">http://xxx.lanl.gov/hypertex/</span><span class="footnote-mark"><a +href="hyperref-doc2.html#fn1x0"><sup class="textsuperscript">1</sup></a></span><a + id="x1-4001f1"></a> . +It extends the functionality of all the <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> cross-referencing commands (including the table of +contents, bibliographies etc) to produce <span +class="ec-lmvtt-10">\special </span>commands which a driver can turn into hypertext links; +it also provides new commands to allow the user to write <span +class="ec-lmri-10">ad hoc </span>hypertext links, including those to +external documents and URLs. +<!--l. 219--><p class="indent" > The package is currently maintained at <a +href="https://github.com/latex3/hyperref/" class="url" ><span +class="ec-lmvtt-10">https://github.com/latex3/hyperref/</span></a> and issues should +be reported there. +<!--l. 222--><p class="indent" > This manual provides a brief overview of the <span +class="ec-lmss-10">hyperref </span>package. For more details, you should read the +additional documentation distributed with the package, as well as the complete documentation by +processing <span +class="ec-lmvtt-10">hyperref.dtx</span>. You should also read the chapter on <span +class="ec-lmss-10">hyperref </span>in <span +class="ec-lmri-10">The </span><span class="HoLogo-LaTeX"><span +class="ec-lmri-10">L</span><span class="HoLogo-a"><span +class="ec-lmri-10">A</span></span><span class="HoLogo-TeX"><span +class="ec-lmri-10">T</span><span class="HoLogo-e"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span></span> <span +class="ec-lmri-10">Web Companion</span>, +where you will find additional examples. +<!--l. 229--><p class="indent" > The Hyper<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> specification<span class="footnote-mark"><a +href="hyperref-doc3.html#fn2x0"><sup class="textsuperscript">2</sup></a></span><a + id="x1-4003f2"></a> +says that conformant viewers/translators must recognize the following set of <span +class="ec-lmvtt-10">\special </span>constructs: + <dl class="description"><dt class="description"> + + + <!--l. 234--><p class="noindent" > +<span +class="ec-lmbx-10">href:</span> </dt><dd +class="description"> + <!--l. 234--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">html:<a</span><span +class="ec-lmvtt-10"> href</span><span +class="ec-lmvtt-10"> =</span><span +class="ec-lmvtt-10"> "href_string"></span></span></span> + </dd><dt class="description"> + <!--l. 235--><p class="noindent" > +<span +class="ec-lmbx-10">name:</span> </dt><dd +class="description"> + <!--l. 235--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">html:<a</span><span +class="ec-lmvtt-10"> name</span><span +class="ec-lmvtt-10"> =</span><span +class="ec-lmvtt-10"> "name_string"></span></span></span> + </dd><dt class="description"> + <!--l. 236--><p class="noindent" > +<span +class="ec-lmbx-10">end:</span> </dt><dd +class="description"> + <!--l. 236--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">html:</a></span></span></span> + </dd><dt class="description"> + <!--l. 237--><p class="noindent" > +<span +class="ec-lmbx-10">image:</span> </dt><dd +class="description"> + <!--l. 237--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">html:<img</span><span +class="ec-lmvtt-10"> src</span><span +class="ec-lmvtt-10"> =</span><span +class="ec-lmvtt-10"> "href_string"></span></span></span> + </dd><dt class="description"> + <!--l. 238--><p class="noindent" > +<span +class="ec-lmbx-10">base_name:</span> </dt><dd +class="description"> + <!--l. 238--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">html:<base</span><span +class="ec-lmvtt-10"> href</span><span +class="ec-lmvtt-10"> =</span><span +class="ec-lmvtt-10"> "href_string"></span></span></span></dd></dl> +<!--l. 241--><p class="indent" > The <span +class="ec-lmri-10">href</span>, <span +class="ec-lmri-10">name </span>and <span +class="ec-lmri-10">end </span>commands are used to do the basic hypertext operations of establishing links +between sections of documents. The <span +class="ec-lmri-10">image </span>command is intended (as with current HTML +viewers) to place an image of arbitrary graphical format on the page in the current location. +The <span +class="ec-lmri-10">base_name </span>command is be used to communicate to the DVI viewer the full (URL) +location of the current document so that files specified by relative URLs may be retrieved +correctly. +<!--l. 250--><p class="indent" > The <span +class="ec-lmri-10">href </span>and <span +class="ec-lmri-10">name </span>commands must be paired with an <span +class="ec-lmri-10">end </span>command later in the TeX file—the +TeX commands between the two ends of a pair form an <span +class="ec-lmri-10">anchor </span>in the document. In the case of an <span +class="ec-lmri-10">href</span> +command, the <span +class="ec-lmri-10">anchor </span>is to be highlighted in the <span +class="ec-lmri-10">DVI viewer</span>, and when clicked on will cause the scene to +shift to the destination specified by <span +class="ec-lmri-10">href_string</span>. The <span +class="ec-lmri-10">anchor </span>associated with a name command represents +a possible location to which other hypertext links may refer, either as local references (of +the form <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">href="#name_string"</span></span></span> with the <span +class="ec-lmri-10">name_string </span>identical to the one in the name +command) or as part of a URL (of the form <span +class="ec-lmri-10">URL#name_string</span>). Here <span +class="ec-lmri-10">href_string </span>is a valid URL +or local identifier, while <span +class="ec-lmri-10">name_string </span>could be any string at all: the only caveat is that ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">"</span></span></span>’ +characters should be escaped with a backslash (<span +class="lmsy-10">\</span>), and if it looks like a URL name it may cause +problems. +<!--l. 266--><p class="indent" > However, the drivers intended to produce <span +class="ec-lmri-10">only </span>PDF use literal PostScript or PDF <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> +commands. The commands are defined in configuration files for different drivers, selected by package +options; at present, the following drivers are supported: + <dl class="description"><dt class="description"> + <!--l. 272--><p class="noindent" > +<span +class="ec-lmbx-10">hypertex</span> </dt><dd +class="description"> + <!--l. 272--><p class="noindent" >DVI processors conforming to the HyperTeX guidelines (i.e. <span +class="ec-lmss-10">xdvi</span>, <span +class="ec-lmss-10">dvips </span>(with the <span +class="ec-lmss-10">-z </span>option), + <span class="HoLogo-OzTeX"><span +class="ec-lmss-10">O</span><span class="HoLogo-z"><span +class="ec-lmss-10">z</span></span><span class="HoLogo-TeX"><span +class="ec-lmss-10">T</span><span class="HoLogo-e"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span></span>, and <span +class="ec-lmss-10">Textures</span>) + + + </dd><dt class="description"> + <!--l. 274--><p class="noindent" > +<span +class="ec-lmbx-10">dvips</span> </dt><dd +class="description"> + <!--l. 274--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands tailored for <span +class="ec-lmss-10">dvips</span> + </dd><dt class="description"> + <!--l. 275--><p class="noindent" > +<span +class="ec-lmbx-10">dvipsone</span> </dt><dd +class="description"> + <!--l. 275--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands tailored for <span +class="ec-lmss-10">dvipsone</span> + </dd><dt class="description"> + <!--l. 276--><p class="noindent" > +<span +class="ec-lmbx-10">ps2pdf</span> </dt><dd +class="description"> + <!--l. 276--><p class="noindent" >a special case of output suitable for processing by earlier versions of Ghostscript’s PDF + writer; this is basically the same as that for <span +class="ec-lmss-10">dvips</span>, but a few variations remained before + version 5.21 + </dd><dt class="description"> + <!--l. 278--><p class="noindent" > +<span +class="ec-lmbx-10">tex4ht</span> </dt><dd +class="description"> + <!--l. 278--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands for use with <span +class="ec-lmss-10">TeX4ht</span> + </dd><dt class="description"> + <!--l. 279--><p class="noindent" > +<span +class="ec-lmbx-10">pdftex</span> </dt><dd +class="description"> + <!--l. 279--><p class="noindent" >pdfTeX, Hàn Thế Thành’s TeX variant that writes PDF directly + </dd><dt class="description"> + <!--l. 280--><p class="noindent" > +<span +class="ec-lmbx-10">luatex</span> </dt><dd +class="description"> + <!--l. 280--><p class="noindent" >luaTeX, Unicode TeX variant that writes PDF directly + </dd><dt class="description"> + <!--l. 281--><p class="noindent" > +<span +class="ec-lmbx-10">dvipdfm</span> </dt><dd +class="description"> + <!--l. 281--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands for Mark Wicks’ DVI to PDF driver <span +class="ec-lmss-10">dvipdfm</span> + </dd><dt class="description"> + <!--l. 282--><p class="noindent" > +<span +class="ec-lmbx-10">dvipdfmx</span> </dt><dd +class="description"> + <!--l. 282--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands for driver <span +class="ec-lmss-10">dvipdfmx</span>, a successor of <span +class="ec-lmss-10">dvipdfm</span> + </dd><dt class="description"> + <!--l. 284--><p class="noindent" > +<span +class="ec-lmbx-10">dviwindo</span> </dt><dd +class="description"> + <!--l. 284--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands that Y&Y’s Windows previewer interprets as hypertext jumps + within the previewer + + + </dd><dt class="description"> + <!--l. 285--><p class="noindent" > +<span +class="ec-lmbx-10">vtex</span> </dt><dd +class="description"> + <!--l. 285--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands that MicroPress’ HTML and PDF-producing TeX variants + interpret as hypertext jumps within the previewer + </dd><dt class="description"> + <!--l. 288--><p class="noindent" > +<span +class="ec-lmbx-10">textures</span> </dt><dd +class="description"> + <!--l. 288--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands that <span +class="ec-lmss-10">Textures </span>interprets as hypertext jumps within the + previewer + </dd><dt class="description"> + <!--l. 289--><p class="noindent" > +<span +class="ec-lmbx-10">xetex</span> </dt><dd +class="description"> + <!--l. 289--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands for XeTeX</dd></dl> +<!--l. 292--><p class="indent" > Output from <span +class="ec-lmss-10">dvips </span>or <span +class="ec-lmss-10">dvipsone </span>must be processed using Acrobat Distiller to obtain a PDF +file.<span class="footnote-mark"><a +href="hyperref-doc4.html#fn3x0"><sup class="textsuperscript">3</sup></a></span><a + id="x1-4005f3"></a> +The result is generally preferable to that produced by using the <span +class="ec-lmss-10">hypertex </span>driver, and then +processing with <span +class="ec-lmss-10">dvips -z</span>, but the DVI file is not portable. The main advantage of using the +HyperTeX <span +class="ec-lmvtt-10">\special </span>commands is that you can also use the document in hypertext DVI viewers, such as +<span +class="ec-lmss-10">xdvi</span>. + <dl class="description"><dt class="description"> + <!--l. 303--><p class="noindent" > +<span +class="ec-lmbx-10">driverfallback</span> </dt><dd +class="description"> + <!--l. 303--><p class="noindent" >If a driver is not given and cannot be autodetected, then use the driver option, given as value to + this option <span +class="ec-lmss-10">driverfallback</span>. Example: + <blockquote class="quote"> + <!--l. 308--><p class="noindent" ><span +class="ec-lmvtt-10">driverfallback=dvipdfm</span></blockquote> + <!--l. 310--><p class="noindent" >Autodetected drivers (<span +class="ec-lmss-10">pdftex</span>, <span +class="ec-lmss-10">xetex</span>, <span +class="ec-lmss-10">vtex</span>, <span +class="ec-lmss-10">vtexpdfmark</span>) are recognized from within TeX and + therefore cannot be given as value to option <span +class="ec-lmss-10">driverfallback</span>. However a DVI driver program is run + after the TeX run is finished. Thus it cannot be detected at TeX macro level. Then package + <span +class="ec-lmss-10">hyperref </span>uses the driver, given by <span +class="ec-lmss-10">driverfallback</span>. If the driver is already specified or can be + autodetected, then option <span +class="ec-lmss-10">driverfallback </span>is ignored.</dd></dl> + <h3 class="sectionHead"><span class="titlemark">3 </span> <a + id="x1-50003"></a>Implicit behavior</h3> +<!--l. 323--><p class="noindent" >This package can be used with more or less any normal LaTeX document by specifying in the document +preamble + + + <pre class="verbatim" id="verbatim-1"> +\usepackage{hyperref} +</pre> +<!--l. 328--><p class="nopar" > +<!--l. 330--><p class="indent" > Make sure it comes <span +class="ec-lmri-10">last </span>of your loaded packages, to give it a fighting +chance of not being over-written, since its job is to redefine many +LaTeX commands.<span class="footnote-mark"><a +href="hyperref-doc5.html#fn4x0"><sup class="textsuperscript">4</sup></a></span><a + id="x1-5001f4"></a> +<!--l. 335--><p class="indent" > <span +class="ec-lmri-10">Do not load it in </span><span +class="ec-lmvtto-10">\AtBeginDocument </span><span +class="ec-lmri-10">or the </span><span +class="ec-lmvtto-10">begindocument </span><span +class="ec-lmri-10">hook! </span>While this often worked in the +past this is not officially supported. As <span +class="ec-lmss-10">hyperref </span>and <span +class="ec-lmss-10">nameref </span>use this hook too to initialize commands, +timing of code execution is tricky and fragile if the packages are loaded there. If you want to delay the +loading, use the <span +class="ec-lmvtt-10">begindocument/before </span>hook. +<!--l. 341--><p class="indent" > Hopefully you will find that all cross-references work correctly as hypertext. For example, <span +class="ec-lmvtt-10">\section</span> +commands will produce a bookmark and a link, whereas <span +class="ec-lmvtt-10">\section* </span>commands will only show links when +paired with a corresponding <span +class="ec-lmvtt-10">\addcontentsline </span>command. +<!--l. 347--><p class="indent" > In addition, the <span +class="ec-lmvtt-10">hyperindex </span>option (see below) attempts to make items in the index by hyperlinked +back to the text, and the option <span +class="ec-lmvtt-10">backref </span>inserts extra ‘back’ links into the bibliography for each entry. +Other options control the appearance of links, and give extra control over PDF output. For example, +<span +class="ec-lmvtt-10">colorlinks</span>, as its name well implies, colors the links instead of using boxes; this is the option used in this +document. + <h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-60004"></a>Interfaces for class and package authors</h3> +<!--l. 357--><p class="noindent" >hyperlink features are nowadays a common requirement. <span +class="ec-lmss-10">hyperref </span>patches quite a number of +commands from the LaTeX core and from packages to add such features. But this is rather +fragile and it add dependencies on the loading order and can break if the external packages +changes. It is therefore much better if packages add suitable support to their commands +directly. Quite a lot packages actually did this, but due to missing documentation of the +interface they often looked into the code and then used internal commands not meant as public +command. +<!--l. 365--><p class="indent" > The following tries to describe the existing variables and commands that can be viewed as public +interfaces or which should or can be set by packages to stay compatible with the <span +class="ec-lmss-10">hyperref </span>command. +Documented user commands are naturally interfaces too, they are not explicitly mentioned here +again. +<!--l. 370--><p class="indent" > This section is work in progress. Suggestions or comments are welcome. +<!--l. 373--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-70004.1"></a>Counters</h4> +<!--l. 374--><p class="noindent" >Counters play an important part in the code. They are used to create destination names and to +define hierarchies like the bookmarks. To work correctly often they require some additional +setups. +<!--l. 378--><p class="indent" > + <dl class="description"><dt class="description"> + <!--l. 380--><p class="noindent" > +<span +class="ec-lmvtk-10">\theH<counter></span> </dt><dd +class="description"> + + <!--l. 380--><p class="noindent" ><span +class="ec-lmss-10">hyperref </span>creates destination names for link anchor typically out of the name of the counter + and the <span +class="ec-lmvtt-10">\the<counter> </span>value. This can fail, e.g. if <span +class="ec-lmvtt-10">\the<counter> </span>is not unique through the + document, or if it is not expandable. In such cases <span +class="ec-lmvtt-10">\theH<counter> </span>should be defined so + that it gives a unique, expandable value. It doesn’t harm to define it even if <span +class="ec-lmss-10">hyperref </span>is not + loaded. + </dd><dt class="description"> + <!--l. 387--><p class="noindent" > +<span +class="ec-lmvtk-10">\toclevel@<counter></span> </dt><dd +class="description"> + <!--l. 387--><p class="noindent" >This is a variable which should contain a number. It is used for the level in the bookmarks. + It should be defined for all counters which are used in toc like lists and <span +class="ec-lmvtt-10">\addcontentsline</span>. + Typical values are + + + <pre class="verbatim" id="verbatim-2"> + \def\toclevel@part{-1} + \def\toclevel@chapter{0} + \def\toclevel@section{1} + \def\toclevel@subsection{2} + \def\toclevel@subsubsection{3} + \def\toclevel@paragraph{4} + \def\toclevel@subparagraph{5} + \def\toclevel@figure{0} +</pre> + <!--l. 400--><p class="nopar" > + </dd></dl> +<!--l. 404--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a + id="x1-80004.2"></a>Values of package and <span +class="ec-lmvtt-10">\hypersetup </span>options</h4> +<!--l. 405--><p class="noindent" >When<span class="marginpar"><span +class="ec-lmr-5">New in version 7.00s</span></span> a key is set either in the package options or with <span +class="ec-lmvtt-10">\hypersetup </span><span +class="ec-lmss-10">hyperref </span>typically +stores the result in internal variables, or executes some code or sets a internal boolean. Package and class +authors should here <span +class="ec-lmri-10">not </span>rely on the names or the details of the key processing. +<!--l. 413--><p class="indent" > But as other packages sometimes need to know which value has been set, some values can be +retrieved with the expandable <span +class="ec-lmvtt-10">\GetDocumentProperties</span>. The values are given back surrounded by +<span +class="ec-lmvtt-10">\exp_not:n</span>, so can be used safely in an <span +class="ec-lmvtt-10">\edef</span>. So for example to get the pdfauthor you can +do. + + + <pre class="verbatim" id="verbatim-3"> +\edef\mypdfauthor{\GetDocumentProperties{hyperref/pdfauthor}} +</pre> +<!--l. 421--><p class="nopar" > +<!--l. 423--><p class="indent" > The values are given back as entered by the user! If they should be used in a PDF context +<span +class="ec-lmvtt-10">\pdfstringdef </span>or something equivalent must still be applied. +<!--l. 426--><p class="indent" > Currently this interface can be used for the keys <span +class="ec-lmvtt-10">pdfauthor</span>, <span +class="ec-lmvtt-10">pdftitle</span>, <span +class="ec-lmvtt-10">pdfproducer</span>, <span +class="ec-lmvtt-10">pdfcreator</span>, +<span +class="ec-lmvtt-10">pdfsubject </span>and <span +class="ec-lmvtt-10">pdfkeywords</span>. If used with a unknown key an empty value is returned. The interface +works also if the new PDF management is loaded with <span +class="ec-lmvtt-10">\DocumentMetadata</span>, in this case more keys +gives back their value. +<!--l. 434--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.3 </span> <a + id="x1-90004.3"></a>Links commands</h4> +<!--l. 435--><p class="noindent" >The following commands are provided by all drivers to create links. They can be used by packages if the +user commands are not sufficient. New drivers must provide this commands with similar +arguments. + + + <pre class="verbatim" id="verbatim-4"> + \hyper@anchor {destination name} + \hyper@anchorstart {destination name} + \hyper@anchorend + \hyper@link   {context}{destination name}{link text}  %GoTo + \hyper@linkstart {context} {destination name}         %GoTo + \hyper@linkend                                        %GoTo + \hyper@linkfile  {link text} {filename} {destname}    %GoToR + \hyper@linkurl   {link text}{url}                     %URI + \hyper@linklaunch{filename} {link text} {Parameters}  %Launch, only with new generic driver + \hyper@linknamed {action}{link text}                  %Named, only with new generic driver +</pre> +<!--l. 450--><p class="nopar" > +<!--l. 452--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.4 </span> <a + id="x1-100004.4"></a>Creating targets</h4> +<!--l. 454--><p class="noindent" >Internal links and bookmarks need something they can jump to. In a PDF this is normally called a +<span +class="ec-lmri-10">destination </span>(and the primitive is therefor called <span +class="ec-lmvtt-10">\pdfdest</span>), in HTML it is more common to call this an +<span +class="ec-lmri-10">anchor </span>(and the <span +class="ec-lmss-10">hyperref </span>uses therefor <span +class="ec-lmvtt-10">\hyper@anchor</span>). History can not be undone but future +commands and descriptions will use the generic <span +class="ec-lmri-10">target </span>unless the PDF specific destination is +meant. +<!--l. 460--><p class="indent" > Targets are created automatically when <span +class="ec-lmvtt-10">\refstepcounter </span>is used and in many cases this does the right +thing and nothing more is needed. But there are exceptions: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 464--><p class="noindent" >A needed target can be missing for example if a sectioning command doesn’t have a number + as the starred version is used or due to the setting of <span +class="ec-lmvtt-10">secnumdepth</span>. + </li> + <li class="itemize"> + <!--l. 467--><p class="noindent" >The target created by the <span +class="ec-lmvtt-10">\refstepcounter </span>can be in the wrong place. + </li> + <li class="itemize"> + <!--l. 468--><p class="noindent" >The target created by the <span +class="ec-lmvtt-10">\refstepcounter </span>can affect spacing. + </li> + <li class="itemize"> + <!--l. 469--><p class="noindent" >The target name created by the <span +class="ec-lmvtt-10">\refstepcounter </span>is not usable, e.g. in <span +class="ec-lmvtt-10">\bibitem </span>where you + need a target name bases on the bib-key.</li></ul> +<!--l. 473--><p class="indent" > Package authors and users can use the following commands to create and manipulate targets. The +commands are described in more detail in <span +class="ec-lmvtt-10">hyperref-linktarget.pdf</span>. + + + <pre class="verbatim" id="verbatim-5"> + \MakeLinkTarget + \LinkTargetOff + \LinkTargetOn + \NextLinkTarget + \SetLinkTargetFilter +</pre> +<!--l. 482--><p class="nopar" > +<!--l. 484--><p class="indent" > The first four commands will be defined also in LaTeX directly as no-op and so can be used even if +<span +class="ec-lmss-10">hyperref </span>is not loaded. +<!--l. 487--><p class="indent" > Until LaTeX is updated package authors can also provide these definitions directly: + + + <pre class="verbatim" id="verbatim-6"> +\ProvideDocumentCommand\MakeLinkTarget{sO{}m}{} +\ProvideDocumentCommand\LinkTargetOn{}{} +\ProvideDocumentCommand\LinkTargetOff{}{} +\ProvideDocumentCommand\NextLinkTarget{m}{} +</pre> +<!--l. 494--><p class="nopar" > +<!--l. 496--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.5 </span> <a + id="x1-110004.5"></a>Patches and how to suppress them</h4> +<!--l. 498--><p class="noindent" >The patches to external commands made by <span +class="ec-lmss-10">hyperref </span>can be avoided completely by loading <span +class="ec-lmss-10">hyperref </span>with +the option <span +class="ec-lmvtt-10">implicit=false</span>. But suppressing everything is often too drastic. There is a work in +progress to classify the patches and to offer interfaces to suppress them in a more granular +way. +<!--l. 505--><p class="indent" > + <dl class="description"><dt class="description"> + <!--l. 506--><p class="noindent" > +<span +class="ec-lmbx-10">sectioning commands</span> </dt><dd +class="description"> + <!--l. 506--><p class="noindent" > + <ul class="itemize1"> + <li class="itemize"> + <!--l. 508--><p class="noindent" >hyperref patches <span +class="ec-lmvtt-10">\@sect</span>, <span +class="ec-lmvtt-10">\@ssect</span>, <span +class="ec-lmvtt-10">\@chapter</span>, <span +class="ec-lmvtt-10">\@schapter</span>, <span +class="ec-lmvtt-10">\@part</span>, <span +class="ec-lmvtt-10">\@spart</span>. + </li> + <li class="itemize"> + <!--l. 511--><p class="noindent" >It adds to the starred commands a target for a link (with the prefix <span +class="ec-lmvtt-10">chapter* </span>for + chapters and <span +class="ec-lmvtt-10">section* </span>otherwise). To the other commands it adds a target for a link if + the sectioning is unnumbered, e.g. because of the <span +class="ec-lmvtt-10">secnumdepth </span>setting or in the front + matter. + </li> + <li class="itemize"> + <!--l. 517--><p class="noindent" >The patch can be suppressed by defining the command <span +class="ec-lmvtt-10">\hyper@nopatch@sectioning</span>. + This should normally be done only by a class or a package which provides sectioning + commands and adds the targets itself. Targets have a location on the page and e.g. the + section commands should take indents into account. Targets are needed for bookmarks + and the table of contents, so <span +class="ec-lmvtt-10">\@currentHref </span>should get the correct meaning before + <span +class="ec-lmvtt-10">\addcontentsline </span>is used. + </li> + <li class="itemize"> + <!--l. 525--><p class="noindent" >Note that the <span +class="ec-lmss-10">nameref </span>package patches these commands too to add commands to store + the title text in <span +class="ec-lmvtt-10">\@currentlabelname</span>. Check the <span +class="ec-lmss-10">nameref </span>documentation about a way + to suppress these patches.</li></ul> + </dd><dt class="description"> + <!--l. 530--><p class="noindent" > +<span +class="ec-lmbx-10">footnotes</span> </dt><dd +class="description"> + + <!--l. 530--><p class="noindent" >To enable (partly) the linking of footnotes hyperref redefines or patches various commands, in part + package dependant. + <ul class="itemize1"> + <li class="itemize"> + <!--l. 532--><p class="noindent" >hyperref redefines <span +class="ec-lmvtt-10">\@xfootnotenext</span>, <span +class="ec-lmvtt-10">\@xfootnotemark</span>, + <span +class="ec-lmvtt-10">\@mpfootnotetext</span>, <span +class="ec-lmvtt-10">\@footnotetext</span>, <span +class="ec-lmvtt-10">\@footnotemark</span>. If <span +class="ec-lmss-10">tabularx </span>is loaded it changes + <span +class="ec-lmvtt-10">\TX@endtabularx</span>. If <span +class="ec-lmss-10">longtable </span>is loaded it changes <span +class="ec-lmvtt-10">\LT@p@ftntext</span>. If <span +class="ec-lmss-10">fancyvfb </span>is + loaded it redefines <span +class="ec-lmvtt-10">\V@@footnotetext</span>. It also redefines <span +class="ec-lmvtt-10">\footref </span>and <span +class="ec-lmvtt-10">\maketitle</span>. + </li> + <li class="itemize"> + <!--l. 537--><p class="noindent" ><span +class="ec-lmri-10">All </span>those redefinitions can be suppressed by defining <span +class="ec-lmvtt-10">\hyper@nopatch@footnote</span>. Be + aware that this can suppress links but also make unwanted links appear.</li></ul> + </dd><dt class="description"> + <!--l. 540--><p class="noindent" > +<span +class="ec-lmbx-10">amsmath tags</span> </dt><dd +class="description"> + <!--l. 540--><p class="noindent" >hyperref redefines two internal commands of amsmath related the <span +class="ec-lmvtt-10">\tag </span>command to add an anchor. + This code can be suppressed by defining <span +class="ec-lmvtt-10">\hyper@nopatch@amsmath@tag</span>. (This normally makes + no sense in packages but will probably be needed when math environments are changed to allow + tagging.) + </dd><dt class="description"> + <!--l. 546--><p class="noindent" > +<span +class="ec-lmbx-10">counters</span> </dt><dd +class="description"> + <!--l. 546--><p class="noindent" >hyperref patches the kernel command <span +class="ec-lmvtt-10">\@definecounter</span>, <span +class="ec-lmvtt-10">\@newctr</span>, <span +class="ec-lmvtt-10">\@addtoreset </span>and + the amsmath command <span +class="ec-lmvtt-10">\numberwithin </span>to ensure that for every counter the correct + <span +class="ec-lmvtt-10">\theHcounter </span>representation is created or reset. This code can be suppressed by defining + <span +class="ec-lmvtt-10">\hyper@nopatch@counter</span>. (This normally makes no sense in packages but will probably be needed + when kernel commands are changed to allow tagging.) + </dd><dt class="description"> + <!--l. 554--><p class="noindent" > +<span +class="ec-lmbx-10">math environments</span> </dt><dd +class="description"> + <!--l. 554--><p class="noindent" >hyperref patches <span +class="ec-lmvtt-10">\equation</span>/<span +class="ec-lmvtt-10">\endequation</span>, <span +class="ec-lmvtt-10">\eqnarray</span>, <span +class="ec-lmvtt-10">\endeqnarray</span>. This code can be suppressed + by defining <span +class="ec-lmvtt-10">\hyper@nopatch@mathenv</span>. + </dd><dt class="description"> + <!--l. 558--><p class="noindent" > +<span +class="ec-lmbx-10">table of contents</span> </dt><dd +class="description"> + <!--l. 558--><p class="noindent" >hyperref redefines <span +class="ec-lmvtt-10">\contentsline </span>to be able to add links to toc entries. It redefines <span +class="ec-lmvtt-10">\addcontentsline</span> + to create the bookmarks and pass the destination names to the toc entries. This code can be + suppressed by defining <span +class="ec-lmvtt-10">\hyper@nopatch@toc</span>.</dd></dl> +<!--l. 563--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">5 </span> <a + id="x1-120005"></a>Package options</h3> + + +<!--l. 565--><p class="noindent" >All user-configurable aspects of <span +class="ec-lmss-10">hyperref </span>are set using a single ‘key=value’ scheme (using the <span +class="ec-lmss-10">keyval</span> +package) with the key <span +class="ec-lmvtt-10">Hyp</span>. The options can be set either in the optional argument to the +<span +class="ec-lmvtt-10">\usepackage </span>command, or using the <span +class="ec-lmvtt-10">\hypersetup </span>macro. When the package is loaded, a file +<span +class="ec-lmvtt-10">hyperref.cfg </span>is read if it can be found, and this is a convenient place to set options on a site-wide +basis. +<!--l. 573--><p class="indent" > Note however that some options (for example <span +class="ec-lmvtt-10">unicode</span>) can only be used as package options, and not +in <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypersetup</span></span></span> as the option settings are processed as the package is read. The following +tabular lists (hopefully all) these options. Be aware that some of the option do nothing or +have changed behaviour if the new pdfmanagement and so the new generic hyperref driver is +used. + + + <div class="tabular"> <table id="TBL-2" class="tabular" + +><colgroup id="TBL-2-1g"><col +id="TBL-2-1"><col +id="TBL-2-2"></colgroup><tr + style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-1" +class="td11"> <span +class="ec-lmvtt-10">option </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-1-2" +class="td11"> <!--l. 580--><p class="noindent" >remark </td> +</tr><tr +class="hline"><td><hr></td><td><hr></td></tr><tr + style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-1" +class="td11"> <span +class="ec-lmvtt-10">all driver options, e.g. pdftex </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-2-2" +class="td11"> <!--l. 581--><p class="noindent" >often + not + needed, + as + detected + automatically </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-1" +class="td11"> <span +class="ec-lmvtt-10">implicit </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-4-1" +class="td11"> <span +class="ec-lmvtt-10">pdfa </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-4-2" +class="td11"> <!--l. 583--><p class="noindent" >no-op + with + new + pdfmanagement, + set + the + standard + in + <span +class="ec-lmvtt-10">\DeclareDocumentMetadata</span>. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-5-1" +class="td11"> <span +class="ec-lmvtt-10">unicode </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-5-2" +class="td11"> <!--l. 584--><p class="noindent" >is + the + default + now + anyway </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-1" +class="td11"> <span +class="ec-lmvtt-10">pdfversion </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-6-2" +class="td11"> <!--l. 585--><p class="noindent" >no-op + with + new + pdfmanagement, + set + the + version + in + <span +class="ec-lmvtt-10">\DeclareDocumentMetadata</span>. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-1" +class="td11"> <span +class="ec-lmvtt-10">bookmarks </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-7-2" +class="td11"> <!--l. 586--><p class="noindent" >this + will + probably + change + at + some + time. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-8-1" +class="td11"> <span +class="ec-lmvtt-10">backref </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-8-2" +class="td11"> <!--l. 588--><p class="noindent" > </td></tr><tr + style="vertical-align:baseline;" id="TBL-2-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-9-1" +class="td11"> <span +class="ec-lmvtt-10">pagebackref </span></td> <td style="white-space:normal; text-align:left;" id="TBL-2-9-2" +class="td11"> <!--l. 589--><p class="noindent" ></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-10-1" +class="td11"> <span +class="ec-lmvtt-10">destlabel </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-10-2" +class="td11"> <!--l. 590--><p class="noindent" > </td></tr><tr + style="vertical-align:baseline;" id="TBL-2-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-11-1" +class="td11"> <span +class="ec-lmvtt-10">pdfusetitle </span></td> <td style="white-space:normal; text-align:left;" id="TBL-2-11-2" +class="td11"> <!--l. 591--><p class="noindent" ></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-12-1" +class="td11"> <span +class="ec-lmvtt-10">pdfpagelabels </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-12-2" +class="td11"> <!--l. 592--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-13-1" +class="td11"> <span +class="ec-lmvtt-10">hyperfootnotes </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-13-2" +class="td11"> <!--l. 593--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-14-1" +class="td11"> <span +class="ec-lmvtt-10">hyperfigures </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-14-2" +class="td11"> <!--l. 594--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-15-1" +class="td11"> <span +class="ec-lmvtt-10">hyperindex </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-15-2" +class="td11"> <!--l. 595--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-16-1" +class="td11"> <span +class="ec-lmvtt-10">encap </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-16-2" +class="td11"> <!--l. 596--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-17-1" +class="td11"> <span +class="ec-lmvtt-10">CJKbookmarks </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-17-2" +class="td11"> <!--l. 596--><p class="noindent" >only + with + the + new + pdfmanagement, + in + other + cases + it + can + be + used + in + <span +class="ec-lmvtt-10">\hypersetup</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-18-1" +class="td11"> <span +class="ec-lmvtt-10">psdextra </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-18-2" +class="td11"> <!--l. 597--><p class="noindent" >only + with + the + new + pdfmanagement, + in + other + cases + it + can + be + used + in + <span +class="ec-lmvtt-10">\hypersetup</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-19-1" +class="td11"> <span +class="ec-lmvtt-10">nesting </span></td><td style="white-space:normal; text-align:left;" id="TBL-2-19-2" +class="td11"> <!--l. 598--><p class="noindent" >only + with + the + new + pdfmanagement, + in + other + cases + it + can + be + used + in + <span +class="ec-lmvtt-10">\hypersetup</span> + (but + is + quite + unclear + if + it + has + any + use) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-20-1" +class="td11"> </td> </tr></table> </div> + + +<!--l. 603--><p class="indent" > As an example, the behavior of a particular file could be controlled by: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 606--><p class="noindent" >a site-wide <span +class="ec-lmvtt-10">hyperref.cfg </span>setting up the look of links, adding backreferencing, and setting a + PDF display default: + + + <pre class="verbatim" id="verbatim-7"> + \hypersetup{backref, + pdfpagemode=FullScreen, + colorlinks=true} +</pre> + <!--l. 613--><p class="nopar" > + </li> + <li class="itemize"> + <!--l. 615--><p class="noindent" >A global option in the file, which is passed down to <span +class="ec-lmss-10">hyperref</span>: + + + <pre class="verbatim" id="verbatim-8"> + \documentclass[dvips]{article} +</pre> + <!--l. 620--><p class="nopar" > + </li> + <li class="itemize"> + <!--l. 622--><p class="noindent" >File-specific options in the <span +class="ec-lmvtt-10">\usepackage </span>commands, which override the ones set in + <span +class="ec-lmvtt-10">hyperref.cfg</span>: + + + <pre class="verbatim" id="verbatim-9"> + \usepackage[colorlinks=false]{hyperref} + \hypersetup{pdftitle={A Perfect Day}} +</pre> + <!--l. 628--><p class="nopar" ></li></ul> +<!--l. 631--><p class="indent" > As seen in the previous example, information entries (pdftitle, pdfauthor, …) should be set after the +package is loaded. Otherwise LaTeX expands the values of these options prematurely. Also LaTeX strips +spaces in options. Especially option ‘pdfborder’ requires some care. Curly braces protect the value, if +given as package option. They are not necessary in <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypersetup</span></span></span>. + + + <pre class="verbatim" id="verbatim-10"> +\usepackage[pdfborder={0 0 0}]{hyperref} +\hypersetup{pdfborder=0 0 0} +</pre> +<!--l. 641--><p class="nopar" > +<!--l. 643--><p class="indent" > Some options can be given at any time, but many are restricted: before <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\begin{document}</span></span></span>, only in +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\usepackage[...]{hyperref}</span></span></span>, before first use, etc. +<!--l. 647--><p class="indent" > In the key descriptions that follow, many options do not need a value, as they default to the value +true if used. These are the ones classed as ‘boolean’. The values true and false can always be specified, +however. +<!--l. 652--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.1 </span> <a + id="x1-130005.1"></a>General options</h4> +<!--l. 654--><p class="noindent" >Firstly, the options to specify general behavior and page size. +<!--l. 657--><p class="indent" > +<a + id="x1-13001r1"></a> <!--l. 658--><div class="longtable"> <table id="TBL-3" class="longtable" + +><colgroup id="TBL-3-1g"><col +id="TBL-3-1"><col +id="TBL-3-2"><col +id="TBL-3-3"><col +id="TBL-3-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-3-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-1" +class="td11"> <span +class="ec-lmvtt-10">draft </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-4" +class="td11"> all hypertext options are turned off </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1" +class="td11"> <span +class="ec-lmvtt-10">final </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-4" +class="td11"> all hypertext options are turned on </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-1" +class="td11"> <span +class="ec-lmvtt-10">debug </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-4" +class="td11"> extra diagnostic messages are printed in </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-4" +class="td11"> the log file </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-1" +class="td11"> <span +class="ec-lmvtt-10">verbose </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-4" +class="td11"> same as debug </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-1" +class="td11"> <span +class="ec-lmvtt-10">implicit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-4" +class="td11"> redefines LaTeX internals </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-1" +class="td11"> <span +class="ec-lmvtt-10">setpagesize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-4" +class="td11"> sets page size by special driver commands </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-10-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-4" +class="td11"></td></tr> + </table></div> +<!--l. 667--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.2 </span> <a + id="x1-140005.2"></a>Options for destination names</h4> +<!--l. 669--><p class="noindent" >Destinations names (also anchor, target or link names) are internal names that identify a position on a +page in the document. They are used in link targets for inner document links or the bookmarks, for +example. +<!--l. 674--><p class="indent" > Usually anchor are set, if <span +class="ec-lmvtt-10">\refstepcounter </span>is called. Thus there is a counter name and value. Both are +used to construct the destination name. By default the counter value follows the counter name separated +by a dot. Example for the fourth chapter: + <blockquote class="quote"> + <!--l. 680--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">chapter.4</span></span></span></blockquote> +<!--l. 682--><p class="noindent" >This scheme is used by: + <dl class="description"><dt class="description"> + <!--l. 684--><p class="noindent" > +<span +class="ec-lmvtk-10">\autoref</span> </dt><dd +class="description"> + <!--l. 684--><p class="noindent" >displays the description label for the reference depending on the counter name. + + + </dd><dt class="description"> + <!--l. 686--><p class="noindent" > +<span +class="ec-lmvtk-10">\hyperpage</span> </dt><dd +class="description"> + <!--l. 686--><p class="noindent" >is used by the index to get page links. Page anchor setting (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pageanchor</span></span></span>) must not be turned + off.</dd></dl> +<!--l. 691--><p class="indent" > It is very important that the destination names are unique, because two destinations must not share +the same name. The counter value <span +class="ec-lmvtt-10">\the<counter> </span>is not always unique for the counter. For example, +table and figures can be numbered inside the chapter without having the chapter number in their +number. Therefore <span +class="ec-lmss-10">hyperref </span>has introduced <span +class="ec-lmvtt-10">\theH<counter> </span>that allows a unique counter value without +messing up with the appearance of the counter number. For example, the number of the +second table in the third chapter might be printed as <span +class="ec-lmvtt-10">2</span>, the result of <span +class="ec-lmvtt-10">\thetable</span>. But the +destination name <span +class="ec-lmvtt-10">table.2.4 </span>is unique because it has used <span +class="ec-lmvtt-10">\theHtable </span>that gives <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">2.4</span></span></span> in this +case. +<!--l. 704--><p class="indent" > Often the user do not need to set <span +class="ec-lmvtt-10">\theH<counter></span>. Defaults for standard cases (chapter, …) are +provided. And after <span +class="ec-lmss-10">hyperref </span>is loaded, new counters with parent counters also define <span +class="ec-lmvtt-10">\theH<counter></span> +automatically, if <span +class="ec-lmvtt-10">\newcounter</span>, <span +class="ec-lmvtt-10">\@addtoreset </span>or <span +class="ec-lmvtt-10">\numberwithin </span>of package <span +class="ec-lmss-10">amsmath </span>are +used. +<!--l. 710--><p class="indent" > Usually problems with duplicate destination names can be solved by an appropriate definition of +<span +class="ec-lmvtt-10">\theH<counter></span>. If option <span +class="ec-lmvtt-10">hypertexnames </span>is disabled, then a unique artificial number is used instead of +the counter value. In case of page anchors the absolute page anchor is used. With option <span +class="ec-lmvtt-10">plainpages </span>the +page anchors use the arabic form. In both latter cases <span +class="ec-lmvtt-10">\hyperpage </span>for index links is affected and might +not work properly. +<!--l. 718--><p class="indent" > If an unnumbered entity gets an anchor (starred forms of chapters, sections, …) or <span +class="ec-lmvtt-10">\phantomsection </span>is +used, then the dummy counter name <span +class="ec-lmvtt-10">section* </span>and an artificial unique number is used. +<!--l. 723--><p class="indent" > If the final PDF file is going to be merged with another file, than the destination names might clash, +because both documents might contain <span +class="ec-lmvtt-10">chapter.1 </span>or <span +class="ec-lmvtt-10">page.1</span>. Also <span +class="ec-lmss-10">hyperref </span>sets anchor with name +<span +class="ec-lmvtt-10">Doc-Start </span>at the begin of the document. This can be resolved by redefining <span +class="ec-lmvtt-10">\HyperDestNameFilter</span>. +Package <span +class="ec-lmss-10">hyperref </span>calls this macro each time, it uses a destination name. The macro must be expandable +and expects the destination name as only argument. As example, the macro is redefined to add a prefix +to all destination names: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-11"> +\renewcommand*{\HyperDestNameFilter}[1]{\jobname-#1} +</pre> + <!--l. 736--><p class="nopar" ></blockquote> +<!--l. 738--><p class="noindent" >In document <span +class="ec-lmvtt-10">docA </span>the destination name <span +class="ec-lmvtt-10">chapter.2 </span>becomes <span +class="ec-lmvtt-10">docA-chapter.2</span>. +<!--l. 741--><p class="indent" > Destination names can also be used from the outside in URIs(, if the driver has not removed or +changed them), for example: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-12"> +http://somewhere/path/file.pdf#nameddest=chapter.4 +</pre> + <!--l. 746--><p class="nopar" ></blockquote> +<!--l. 748--><p class="noindent" >However using a number seems unhappy. If another chapter is added before, the number changes. But it is +very difficult to pass a new name for the destination to the anchor setting process that is usually +deep hidden in the internals. The first name of <span +class="ec-lmvtt-10">\label </span>after the anchor setting seems a good +approximation: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-13"> +  \section{Introduction} +  \label{intro} +</pre> + <!--l. 757--><p class="nopar" ></blockquote> +<!--l. 759--><p class="noindent" >Option <span +class="ec-lmvtt-10">destlabel </span>checks for each <span +class="ec-lmvtt-10">\label</span>, if there is a new destination name active and replaces the +destination name by the label name. Because the destination name is already in use because of the +anchor setting, the new name is recorded in the <span +class="ec-lmvtt-10">.aux </span>file and used in the subsequent <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> +run. The renaming is done by a redefinition of <span +class="ec-lmvtt-10">\HyperDestNameFilter</span>. That leaves the old +destination names intact (e.g., they are needed for <span +class="ec-lmvtt-10">\autoref</span>). This redefinition is also available as +<span +class="ec-lmvtt-10">\HyperDestLabelReplace</span>, thus that an own redefinition can use it. The following example also adds a +prefix for <span +class="ec-lmri-10">all </span>destination names: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-14"> +\renewcommand*{\HyperDestNameFilter}[1]{% +  \jobname-\HyperDestLabelReplace{#1}% +} +</pre> + <!--l. 774--><p class="nopar" ></blockquote> +<!--l. 776--><p class="noindent" >The other case that only files prefixed that do not have a corresponding <span +class="ec-lmvtt-10">\label </span>is more complicate, because +<span +class="ec-lmvtt-10">\HyperDestLabelReplace </span>needs the unmodified destination name as argument. This is solved by an +expandable string test (<span +class="ec-lmvtt-10">\pdfstrcmp </span>of pdf<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> or <span +class="ec-lmvtt-10">\strcmp </span>of <span class="HoLogo-XeTeX"><span class="HoLogo-Xe">X<span class="HoLogo-e">Ǝ</span></span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>, package <span +class="ec-lmss-10">pdftexcmds </span>also supports +Lua<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span>): + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-15"> +\usepackage{pdftexcmds} +\makeatletter +\renewcommand*{\HyperDestNameFilter}[1]{% +  \ifcase\pdf@strcmp{#1}{\HyperDestLabelReplace{#1}} % +    \jobname-#1% +  \else +    \HyperDestLabelReplace{#1}% +  \fi +} +\makeatother +</pre> + <!--l. 794--><p class="nopar" ></blockquote> +<!--l. 797--><p class="indent" > With option <span +class="ec-lmvtt-10">destlabel </span>destinations can also named manually, if the destination is not yet +renamed: + <blockquote class="quote"> + <!--l. 800--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\HyperDestRename{</span></span></span><span +class="lmsy-10">⟨</span><span +class="ec-lmvtto-10">destination</span><span +class="lmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="lmsy-10">⟨</span><span +class="ec-lmvtto-10">newname</span><span +class="lmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span></blockquote> +<!--l. 803--><p class="indent" > Hint: Anchors can also be named and set by <span +class="ec-lmvtt-10">\hypertarget</span>. +<!--l. 806--><p class="indent" > +<a + id="x1-14001r2"></a> <!--l. 807--><div class="longtable"> <table id="TBL-4" class="longtable" + +><colgroup id="TBL-4-1g"><col +id="TBL-4-1"><col +id="TBL-4-2"><col +id="TBL-4-3"><col +id="TBL-4-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-4-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-1" +class="td11"> <span +class="ec-lmvtt-10">destlabel </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-4" +class="td11"> destinations are named by first <span +class="ec-lmvtt-10">\label </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-4" +class="td11"> after anchor creation </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-1" +class="td11"> <span +class="ec-lmvtt-10">hypertexnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-4" +class="td11"> use guessable names for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-1" +class="td11"> <span +class="ec-lmvtt-10">naturalnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-4" +class="td11"> use LaTeX-computed names for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-1" +class="td11"> <span +class="ec-lmvtt-10">plainpages </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-4" +class="td11"> Forces page anchors to be named by the Arabic form </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-4" +class="td11"> of the page number, rather than the formatted form. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-7-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-8-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-9-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-10-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-11-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-11-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-11-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-11-4" +class="td11"></td></tr> + </table></div> +<!--l. 815--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.3 </span> <a + id="x1-150005.3"></a>Configuration options</h4> +<!--l. 817--><p class="noindent" > +<a + id="x1-15001r3"></a> <!--l. 818--><div class="longtable"> <table id="TBL-5" class="longtable" + +><colgroup id="TBL-5-1g"><col +id="TBL-5-1"><col +id="TBL-5-2"><col +id="TBL-5-3"><col +id="TBL-5-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-5-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-1" +class="td11"> <span +class="ec-lmvtt-10">raiselinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-1-4" +class="td11"> + <!--l. 818--><p class="noindent" >In the hypertex driver, the height of links is normally + calculated by the driver as simply the base line of contained + text; this options forces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> commands to reflect the + real height of the link (which could contain a graphic) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-1" +class="td11"> <span +class="ec-lmvtt-10">breaklinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-3" +class="td11"> <span +class="ec-lmri-10">both </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-2-4" +class="td11"> + <!--l. 821--><p class="noindent" >This option is in hyperref only used in the dviwindo driver, + in all other cases it doesn’t do anything sensible—it neither + allows nor prevents links to be broken. The ocgx2 package + checks the state of the boolean. </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-5-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-1" +class="td11"> <span +class="ec-lmvtt-10">pageanchor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-3-4" +class="td11"> + <!--l. 823--><p class="noindent" >Determines whether every page is given an implicit anchor + at the top left corner. If this is turned off, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\printindex</span></span></span> will + not contain valid hyperlinks. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-1" +class="td11"> <span +class="ec-lmvtt-10">nesting </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-5-4-4" +class="td11"> + <!--l. 826--><p class="noindent" >Allows links to be nested; no drivers currently support this. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-5-8-4" +class="td11"></td></tr> + </table></div> +<!--l. 829--><p class="noindent" >Note for option <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">breaklinks</span></span></span>: The correct value is automatically set according to the driver features. It can +be overwritten for drivers that do not support broken links. However, at any case, the link area will be +wrong and displaced. +<!--l. 834--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.4 </span> <a + id="x1-160005.4"></a>Backend drivers</h4> +<!--l. 836--><p class="noindent" >If no driver is specified, the package tries to find a driver in the following order: + <ol class="enumerate1" > +<li + class="enumerate" id="x1-16002x1"> + <!--l. 839--><p class="noindent" >Autodetection, some TeX processors can be detected at TeX macro level (pdfTeX, XeTeX, + VTeX). + </li> +<li + class="enumerate" id="x1-16004x2"> + <!--l. 841--><p class="noindent" >Option <span +class="ec-lmss-10">driverfallback</span>. If this option is set, its value is taken as driver option. + </li> +<li + class="enumerate" id="x1-16006x3"> + <!--l. 843--><p class="noindent" >Macro <span +class="ec-lmvtt-10">\Hy@defaultdriver</span>. The macro takes a driver file name (without file extension). + </li> +<li + class="enumerate" id="x1-16008x4"> + <!--l. 845--><p class="noindent" >Package default is <span +class="ec-lmss-10">hypertex</span>.</li></ol> +<!--l. 847--><p class="noindent" >Many distributions are using a driver file <span +class="ec-lmvtt-10">hypertex.cfg </span>that define <span +class="ec-lmvtt-10">\Hy@defaultdriver </span>with <span +class="ec-lmvtt-10">hdvips</span>. This +is recommended because driver <span +class="ec-lmss-10">dvips </span>provides much more features than <span +class="ec-lmss-10">hypertex </span>for PDF +generation. +<!--l. 852--><p class="indent" > +<a + id="x1-16009r4"></a> <!--l. 853--><div class="longtable"> <table id="TBL-6" class="longtable" + +><colgroup id="TBL-6-1g"><col +id="TBL-6-1"><col +id="TBL-6-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-6-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-1" +class="td01"><span +class="ec-lmvtt-10">driverfallback </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-1-2" +class="td10"> + <!--l. 853--><p class="noindent" >Its value is used as driver option </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-6-2-2" +class="td10"> + <!--l. 854--><p class="noindent" >if the driver is not given or autodetected. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-1" +class="td01"><span +class="ec-lmvtt-10">dvipdfm </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-3-2" +class="td10"> + <!--l. 855--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the <span +class="ec-lmss-10">dvipdfm </span>driver. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-1" +class="td01"><span +class="ec-lmvtt-10">dvipdfmx </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-4-2" +class="td10"> + <!--l. 856--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the <span +class="ec-lmss-10">dvipdfmx </span>driver. </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-6-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-1" +class="td01"><span +class="ec-lmvtt-10">dvips </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-5-2" +class="td10"> + <!--l. 857--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the <span +class="ec-lmss-10">dvips </span>driver. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-1" +class="td01"><span +class="ec-lmvtt-10">dvipsone </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-6-2" +class="td10"> + <!--l. 858--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the <span +class="ec-lmss-10">dvipsone </span>driver. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-1" +class="td01"><span +class="ec-lmvtt-10">dviwindo </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-7-2" +class="td10"> + <!--l. 859--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the <span +class="ec-lmss-10">dviwindo </span>Windows previewer. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-1" +class="td01"><span +class="ec-lmvtt-10">hypertex </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-8-2" +class="td10"> + <!--l. 860--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the HyperTeX-compliant drivers. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-1" +class="td01"><span +class="ec-lmvtt-10">latex2html </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-9-2" +class="td10"> + <!--l. 861--><p class="noindent" >Redefines a few macros for compatibility with <span +class="ec-lmss-10">latex2html</span>. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-1" +class="td01"><span +class="ec-lmvtt-10">nativepdf </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-10-2" +class="td10"> + <!--l. 862--><p class="noindent" >An alias for <span +class="ec-lmss-10">dvips</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-1" +class="td01"><span +class="ec-lmvtt-10">pdfmark </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-11-2" +class="td10"> + <!--l. 863--><p class="noindent" >An alias for <span +class="ec-lmss-10">dvips</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-1" +class="td01"><span +class="ec-lmvtt-10">pdftex </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-12-2" +class="td10"> + <!--l. 864--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the <span +class="ec-lmss-10">pdftex </span>program. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-1" +class="td01"><span +class="ec-lmvtt-10">ps2pdf </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-13-2" +class="td10"> + <!--l. 865--><p class="noindent" >Redefines a few macros for compatibility with Ghostscript’s PDF writer, + otherwise identical to <span +class="ec-lmss-10">dvips</span>. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-1" +class="td01"><span +class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-14-2" +class="td10"> + <!--l. 868--><p class="noindent" >For use with <span +class="ec-lmss-10">TeX4ht</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-1" +class="td01"><span +class="ec-lmvtt-10">textures </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-15-2" +class="td10"> + <!--l. 869--><p class="noindent" >For use with <span +class="ec-lmss-10">Textures</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-16-1" +class="td01"><span +class="ec-lmvtt-10">vtex </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-16-2" +class="td10"> + <!--l. 870--><p class="noindent" >For use with MicroPress’ <span +class="ec-lmss-10">VTeX</span>; the PDF and HTML backends are detected + automatically. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-17-1" +class="td01"><span +class="ec-lmvtt-10">vtexpdfmark </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-17-2" +class="td10"> + <!--l. 872--><p class="noindent" >For use with <span +class="ec-lmss-10">VTeX</span>’s PostScript backend. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-18-1" +class="td01"><span +class="ec-lmvtt-10">xetex </span></td><td style="white-space:normal; text-align:left;" id="TBL-6-18-2" +class="td10"> + <!--l. 873--><p class="noindent" >For use with XeTeX (using backend for dvipdfm). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-19-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-20-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-21-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-22-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-6-22-2" +class="td10"></td></tr> + </table></div> +<!--l. 877--><p class="indent" > If you use <span +class="ec-lmss-10">dviwindo</span>, you may need to redefine the macro <span +class="ec-lmvtt-10">\wwwbrowser </span>(the default is +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">C:\netscape\netscape</span></span></span>) to tell <span +class="ec-lmss-10">dviwindo </span>what program to launch. Thus, users of Internet Explorer might +add something like this to hyperref.cfg: + + + <pre class="verbatim" id="verbatim-16"> +\renewcommand{\wwwbrowser}{C:\string\Program\space +  Files\string\Plus!\string\Microsoft\space +  Internet\string\iexplore.exe} +</pre> +<!--l. 886--><p class="nopar" > +<!--l. 888--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.5 </span> <a + id="x1-170005.5"></a>Extension options</h4> +<!--l. 889--><p class="noindent" > +<a + id="x1-17001r5"></a> <!--l. 890--><div class="longtable"> <table id="TBL-7" class="longtable" + +><colgroup id="TBL-7-1g"><col +id="TBL-7-1"><col +id="TBL-7-2"><col +id="TBL-7-3"><col +id="TBL-7-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-7-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-1" +class="td01"><span +class="ec-lmvtt-10">extension </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-7-1-4" +class="td10"> + <!--l. 890--><p class="noindent" >Set the file extension (e.g. <span +class="ec-lmss-10">dvi</span>) which will be + appended to file links created if you use the <span +class="ec-lmss-10">xr</span> + package. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-1" +class="td01"><span +class="ec-lmvtt-10">hyperfigures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-7-2-4" +class="td10"> + <!--l. 893--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-1" +class="td01"><span +class="ec-lmvtt-10">backref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-3-4" +class="td10"> + <!--l. 893--><p class="noindent" >Adds ‘backlink’ text to the end of each item in the + bibliography, as a list of section numbers. This can + only work properly <span +class="ec-lmri-10">if </span>there is a blank line after each + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\bibitem</span></span></span>. Supported values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">section</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">slide</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">page</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">none</span></span></span>, or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">false</span></span></span>. If no value is given, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">section</span></span></span> is taken + as default. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-1" +class="td01"><span +class="ec-lmvtt-10">pagebackref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-4-4" +class="td10"> + <!--l. 897--><p class="noindent" >Adds ‘backlink’ text to the end of each item in the + bibliography, as a list of page numbers. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-1" +class="td01"><span +class="ec-lmvtt-10">hyperindex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-5-4" +class="td10"> + <!--l. 899--><p class="noindent" >Makes the page + numbers of index entries into hyperlinks. Relays on + unique page anchors (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pageanchor</span></span></span>, …) <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pageanchors</span></span></span> + and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">plainpages=false</span></span></span>. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-1" +class="td01"><span +class="ec-lmvtt-10">hyperfootnotes </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-6-4" +class="td10"> + <!--l. 902--><p class="noindent" >Makes the footnote marks into hyperlinks to the + footnote text. Easily broken … </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-1" +class="td01"><span +class="ec-lmvtt-10">encap </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-7-7-4" +class="td10"> + <!--l. 904--><p class="noindent" >Sets encap character for hyperindex </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-1" +class="td01"><span +class="ec-lmvtt-10">linktoc </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-3" +class="td11"> <span +class="ec-lmri-10">section </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-8-4" +class="td10"> + <!--l. 905--><p class="noindent" >make text (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">section</span></span></span>), page number (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">page</span></span></span>), both (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">all</span></span></span>) + or nothing (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">none</span></span></span>) be link on TOC, LOF and LOT </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-1" +class="td01"><span +class="ec-lmvtt-10">linktocpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-9-4" +class="td10"> + <!--l. 906--><p class="noindent" >make page number, not text, be link on TOC, LOF + and LOT </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-1" +class="td01"><span +class="ec-lmvtt-10">breaklinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-10-4" +class="td10"> + <!--l. 907--><p class="noindent" >allow links to break over lines by making links over + multiple lines into PDF links to the same target </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-7-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-1" +class="td01"><span +class="ec-lmvtt-10">colorlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-11-4" +class="td10"> + <!--l. 909--><p class="noindent" >Colors the text of links and anchors. The colors + chosen depend on the the type of link. At present + the only types of link distinguished are citations, + page references, URLs, local file references, and other + links. Unlike colored boxes, the colored text remains + when printing. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-1" +class="td01"><span +class="ec-lmvtt-10">linkcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-3" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-12-4" +class="td10"> + <!--l. 914--><p class="noindent" >Color for normal internal links. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-1" +class="td01"><span +class="ec-lmvtt-10">anchorcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-3" +class="td11"> <span +class="ec-lmri-10">black </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-13-4" +class="td10"> + <!--l. 915--><p class="noindent" >Color for anchor text. Ignored by most drivers. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-1" +class="td01"><span +class="ec-lmvtt-10">citecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-3" +class="td11"> <span +class="ec-lmri-10">green </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-14-4" +class="td10"> + <!--l. 916--><p class="noindent" >Color for bibliographical citations in text. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-1" +class="td01"><span +class="ec-lmvtt-10">filecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-3" +class="td11"> <span +class="ec-lmri-10">cyan </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-15-4" +class="td10"> + <!--l. 917--><p class="noindent" >Color for URLs which open local files. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-1" +class="td01"><span +class="ec-lmvtt-10">menucolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-3" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-16-4" +class="td10"> + <!--l. 918--><p class="noindent" >Color for Acrobat menu items. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-1" +class="td01"><span +class="ec-lmvtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-3" +class="td11"> <span +class="ec-lmri-10">filecolor </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-17-4" +class="td10"> + <!--l. 919--><p class="noindent" >Color for run links (launch annotations). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-18-1" +class="td01"><span +class="ec-lmvtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-18-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-18-3" +class="td11"> <span +class="ec-lmri-10">magenta </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-18-4" +class="td10"> + <!--l. 920--><p class="noindent" >Color for linked URLs. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-19-1" +class="td01"><span +class="ec-lmvtt-10">allcolors </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-19-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-19-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-7-19-4" +class="td10"> + <!--l. 921--><p class="noindent" >Set all color options (without border and field + options). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-20-1" +class="td01"><span +class="ec-lmvtt-10">frenchlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-20-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-20-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-7-20-4" +class="td10"> + <!--l. 922--><p class="noindent" >Use small caps instead of color for links. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-21-1" +class="td01"><span +class="ec-lmvtt-10">hidelinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-21-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-21-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-7-21-4" +class="td10"> + <!--l. 923--><p class="noindent" >Hide links (removing color and border). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-22-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-23-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-24-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-25-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-26-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-26-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-26-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-7-26-4" +class="td10"></td></tr> + </table></div> +<!--l. 926--><p class="noindent" >Note that all color names must be defined before use, following the normal system of the standard +LaTeX <span +class="ec-lmss-10">color </span>package. +<!--l. 929--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.6 </span> <a + id="x1-180005.6"></a>PDF-specific display options</h4> +<!--l. 930--><p class="noindent" > +<a + id="x1-18001r6"></a> <!--l. 931--><div class="longtable"> <table id="TBL-8" class="longtable" + +><colgroup id="TBL-8-1g"><col +id="TBL-8-1"><col +id="TBL-8-2"><col +id="TBL-8-3"><col +id="TBL-8-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-8-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-1" +class="td01"><span +class="ec-lmvtt-10">bookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-1-4" +class="td10"> + <!--l. 931--><p class="noindent" >A set of Acrobat bookmarks are written, in a + manner similar to the table of contents, requiring + two passes of LaTeX. Some postprocessing of + the bookmark file (file extension <span +class="ec-lmvtt-10">.out</span>) may + be needed to translate LaTeX codes, since + bookmarks must be written in PDFEncoding. To + aid this process, the <span +class="ec-lmvtt-10">.out </span>file is not rewritten + by LaTeX if it is edited to contain a line + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\let\WriteBookmarks\relax</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-1" +class="td01"><span +class="ec-lmvtt-10">bookmarksopen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-2-4" +class="td10"> + <!--l. 937--><p class="noindent" >If Acrobat bookmarks are requested, show them + with all the subtrees expanded. </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-8-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-1" +class="td01"><span +class="ec-lmvtt-10">bookmarksopenlevel </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-2" +class="td11"> parameter </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-8-3-4" +class="td10"> + <!--l. 939--><p class="noindent" >level (<span +class="ec-lmvtt-10">\maxdimen</span>) to which bookmarks are open</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-1" +class="td01"><span +class="ec-lmvtt-10">bookmarksnumbered </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-4-4" +class="td10"> + <!--l. 940--><p class="noindent" >If Acrobat bookmarks are requested, include + section numbers. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-1" +class="td01"><span +class="ec-lmvtt-10">bookmarkstype </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-3" +class="td11"> <span +class="ec-lmri-10">toc </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-5-4" +class="td10"> + <!--l. 941--><p class="noindent" >to specify which ‘toc’ file to mimic </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-1" +class="td01"><span +class="ec-lmvtt-10">CJKbookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-6-4" +class="td10"> + <!--l. 943--><p class="noindent" >This option should be used to produce CJK + bookmarks. Package <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperref</span></span></span> supports both + normal and preprocessed mode of the <span +class="ec-lmss-10">CJK</span> + package; during the creation of bookmarks, + it simply replaces CJK’s macros with special + versions which expand to the corresponding + character codes. Note that without the ‘unicode’ + option of hyperref you get PDF files which + actually violate the PDF specification because + non-Unicode character codes are used – some PDF + readers localized for CJK languages (most notably + Acroread itself) support this. Also note that + option ‘CJKbookmarks’ cannot be used together + with option ‘unicode’. + <!--l. 955--><p class="noindent" >No mechanism is provided to + translate non-Unicode bookmarks to Unicode; for + portable PDF documents only Unicode encoding + should be used. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-1" +class="td01"><span +class="ec-lmvtt-10">pdfhighlight </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-3" +class="td11"> <span +class="ec-lmri-10">/I </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-7-4" +class="td10"> + <!--l. 958--><p class="noindent" >How link buttons behave when selected; /I is + for inverse (the default); the other possibilities + are /N (no effect), /O (outline), and /P (inset + highlighting). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-1" +class="td01"><span +class="ec-lmvtt-10">citebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-3" +class="td11"> <span +class="ec-lmri-10">0 1 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-8-4" +class="td10"> + <!--l. 961--><p class="noindent" >The color of the box around citations </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-9-1" +class="td01"><span +class="ec-lmvtt-10">filebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-9-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-9-3" +class="td11"> <span +class="ec-lmri-10">0 .5 .5 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-9-4" +class="td10"> + <!--l. 962--><p class="noindent" >The color of the box around links to files </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-10-1" +class="td01"><span +class="ec-lmvtt-10">linkbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-10-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-10-3" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-10-4" +class="td10"> + <!--l. 963--><p class="noindent" >The color of the box around normal links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-11-1" +class="td01"><span +class="ec-lmvtt-10">menubordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-11-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-11-3" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-11-4" +class="td10"> + <!--l. 964--><p class="noindent" >The color of the box around Acrobat menu links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-12-1" +class="td01"><span +class="ec-lmvtt-10">urlbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-12-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-12-3" +class="td11"> <span +class="ec-lmri-10">0 1 1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-12-4" +class="td10"> + <!--l. 965--><p class="noindent" >The color of the box around links to URLs </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-1" +class="td01"><span +class="ec-lmvtt-10">runbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-3" +class="td11"> <span +class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-13-4" +class="td10"> + <!--l. 966--><p class="noindent" >Color of border around ‘run’ links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-14-1" +class="td01"><span +class="ec-lmvtt-10">allbordercolors </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-14-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-14-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-8-14-4" +class="td10"> + <!--l. 967--><p class="noindent" >Set all border color options </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-15-1" +class="td01"><span +class="ec-lmvtt-10">pdfborder </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-15-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-15-3" +class="td11"> <span +class="ec-lmri-10">0 0 1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-8-15-4" +class="td10"> + <!--l. 968--><p class="noindent" >The style of box around links; defaults to a box + with lines of 1pt thickness, but the colorlinks + option resets it to produce no border. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-16-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-17-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-18-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-19-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-19-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-19-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-8-19-4" +class="td10"></td></tr> + </table></div> +<!--l. 972--><p class="noindent" >The color of link borders used to be specified <span +class="ec-lmri-10">only </span>as 3 numbers in the range 0..1, giving an RGB color. +Since version 6.76a, the usual color specifications of package <span +class="ec-lmss-10">(x)color </span>can be used if <span +class="ec-lmss-10">xcolor </span>has been +loaded. For further information see description of package <span +class="ec-lmss-10">hycolor</span>. + + +<!--l. 978--><p class="indent" > The bookmark commands are stored in a file called <span +class="ec-lmri-10">jobname</span><span +class="ec-lmvtt-10">.out</span>. The files is not processed by +LaTeX so any markup is passed through. You can postprocess this file as needed; as an aid +for this, the <span +class="ec-lmvtt-10">.out </span>file is not overwritten on the next TeX run if it is edited to contain the +line + + + <pre class="verbatim" id="verbatim-17"> +\let\WriteBookmarks\relax +</pre> +<!--l. 985--><p class="nopar" > +<!--l. 987--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.7 </span> <a + id="x1-190005.7"></a>PDF display and information options</h4> +<!--l. 988--><p class="noindent" > +<a + id="x1-19001r7"></a> <!--l. 989--><div class="longtable"> <table id="TBL-9" class="longtable" + +><colgroup id="TBL-9-1g"><col +id="TBL-9-1"><col +id="TBL-9-2"><col +id="TBL-9-3"><col +id="TBL-9-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-9-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-1-1" +class="td01"><span +class="ec-lmvtt-10">baseurl </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-1-2" +class="td11"> + <!--l. 989--><p class="noindent" >URL </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-1-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-1-4" +class="td10"> + <!--l. 989--><p class="noindent" >Sets the base URL of the PDF document </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-2-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagemode </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-2-2" +class="td11"> + <!--l. 990--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-2-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-2-4" +class="td10"> + <!--l. 990--><p class="noindent" >Determines how the file is opening in + Acrobat; the possibilities are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseNone</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseThumbs</span></span></span> (show thumbnails), <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseOutlines</span></span></span> + (show bookmarks), <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">FullScreen</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseOC</span></span></span> (PDF + 1.5), and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseAttachments</span></span></span> (PDF 1.6). If no + mode if explicitly chosen, but the bookmarks + option is set, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseOutlines</span></span></span> is used. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-3-1" +class="td01"><span +class="ec-lmvtt-10">pdftitle </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-3-2" +class="td11"> + <!--l. 995--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-3-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-3-4" +class="td10"> + <!--l. 995--><p class="noindent" >Sets the document information Title field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-4-1" +class="td01"><span +class="ec-lmvtt-10">pdfauthor </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-4-2" +class="td11"> + <!--l. 996--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-4-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-4-4" +class="td10"> + <!--l. 996--><p class="noindent" >Sets the document information Author field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-5-1" +class="td01"><span +class="ec-lmvtt-10">pdfsubject </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-5-2" +class="td11"> + <!--l. 997--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-5-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-5-4" +class="td10"> + <!--l. 997--><p class="noindent" >Sets the document information Subject field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-6-1" +class="td01"><span +class="ec-lmvtt-10">pdfcreator </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-6-2" +class="td11"> + <!--l. 998--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-6-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-6-4" +class="td10"> + <!--l. 998--><p class="noindent" >Sets the document information Creator field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-7-1" +class="td01"><span +class="ec-lmvtt-10">addtopdfcreator </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-7-2" +class="td11"> + <!--l. 999--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-7-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-7-4" +class="td10"> + <!--l. 999--><p class="noindent" >Adds additional text to the document + information Creator field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-8-1" +class="td01"><span +class="ec-lmvtt-10">pdfkeywords </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-8-2" +class="td11"> + <!--l. 1000--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-8-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-8-4" +class="td10"> + <!--l. 1000--><p class="noindent" >Sets the document information Keywords field</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-9-1" +class="td01"><span +class="ec-lmvtt-10">pdftrapped </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-9-2" +class="td11"> + <!--l. 1001--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-9-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-9-4" +class="td10"> + <!--l. 1001--><p class="noindent" >Sets the document information Trapped entry. + Possible values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">True</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">False</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Unknown</span></span></span>. + An empty value means, the entry is not set. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-10-1" +class="td01"><span +class="ec-lmvtt-10">pdfinfo </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-10-2" +class="td11"> + <!--l. 1004--><p class="noindent" >key + value + list </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-10-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-10-4" +class="td10"> + <!--l. 1004--><p class="noindent" >Alternative interface for setting the document + information. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-11-1" +class="td01"><span +class="ec-lmvtt-10">pdfview </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-11-2" +class="td11"> + <!--l. 1006--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-11-3" +class="td11"> <span +class="ec-lmri-10">XYZ </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-11-4" +class="td10"> + <!--l. 1006--><p class="noindent" >Sets the default PDF ‘view’ for each link </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-12-1" +class="td01"><span +class="ec-lmvtt-10">pdfstartpage </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-12-2" +class="td11"> + <!--l. 1007--><p class="noindent" >integer </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-12-3" +class="td11"> <span +class="ec-lmri-10">1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-12-4" +class="td10"> + <!--l. 1007--><p class="noindent" >Determines on which page the PDF file is + opened. An empty value means, the entry is + not set. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-13-1" +class="td01"><span +class="ec-lmvtt-10">pdfstartview </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-13-2" +class="td11"> + <!--l. 1008--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-13-3" +class="td11"> <span +class="ec-lmri-10">Fit </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-13-4" +class="td10"> + <!--l. 1008--><p class="noindent" >Set the startup page view </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-14-1" +class="td01"><span +class="ec-lmvtt-10">pdfremotestartview </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-14-2" +class="td11"> + <!--l. 1009--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-14-3" +class="td11"> <span +class="ec-lmri-10">Fit </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-14-4" +class="td10"> + <!--l. 1009--><p class="noindent" >Set the startup page view of remote PDF files</td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-9-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-15-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagescrop </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-15-2" +class="td11"> + <!--l. 1010--><p class="noindent" >n + n + n + n </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-15-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-15-4" +class="td10"> + <!--l. 1010--><p class="noindent" >Sets the default PDF crop box for pages. This + should be a set of four numbers </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-16-1" +class="td01"><span +class="ec-lmvtt-10">pdfcenterwindow </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-16-2" +class="td11"> + <!--l. 1011--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-16-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-16-4" +class="td10"> + <!--l. 1011--><p class="noindent" >position the document window in the center + of the screen </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-17-1" +class="td01"><span +class="ec-lmvtt-10">pdfdirection </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-17-2" +class="td11"> + <!--l. 1012--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-17-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-17-4" +class="td10"> + <!--l. 1012--><p class="noindent" >direction setting. Possible values: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">L2R</span></span></span> (left to + right) and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">R2L</span></span></span> (right to left) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-18-1" +class="td01"><span +class="ec-lmvtt-10">pdfdisplaydoctitle </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-18-2" +class="td11"> + <!--l. 1014--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-18-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-18-4" +class="td10"> + <!--l. 1014--><p class="noindent" >display document title instead of file name in + title bar </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-19-1" +class="td01"><span +class="ec-lmvtt-10">pdfduplex </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-19-2" +class="td11"> + <!--l. 1015--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-19-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-19-4" +class="td10"> + <!--l. 1015--><p class="noindent" >paper handling option for print + dialog. Possible vatues are: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Simplex</span></span></span> (print + single-sided), <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">DuplexFlipShortEdge</span></span></span> (duplex + and flip on the short edge of the sheet), + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">DuplexFlipLongEdge</span></span></span> (duplex and flip on the + long edge of the sheet) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-20-1" +class="td01"><span +class="ec-lmvtt-10">pdffitwindow </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-20-2" +class="td11"> + <!--l. 1020--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-20-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-20-4" +class="td10"> + <!--l. 1020--><p class="noindent" >resize document window to fit document size </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-21-1" +class="td01"><span +class="ec-lmvtt-10">pdflang </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-21-2" +class="td11"> + <!--l. 1021--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-21-3" +class="td11"> <span +class="ec-lmri-10">relax </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-21-4" +class="td10"> + <!--l. 1021--><p class="noindent" >PDF language identifier (RFC 3066) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-22-1" +class="td01"><span +class="ec-lmvtt-10">pdfmenubar </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-22-2" +class="td11"> + <!--l. 1022--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-22-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-22-4" +class="td10"> + <!--l. 1022--><p class="noindent" >make PDF viewer’s menu bar visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-23-1" +class="td01"><span +class="ec-lmvtt-10">pdfnewwindow </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-23-2" +class="td11"> + <!--l. 1023--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-23-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-23-4" +class="td10"> + <!--l. 1023--><p class="noindent" >make links that open another PDF file start a + new window </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-24-1" +class="td01"><span +class="ec-lmvtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-24-2" +class="td11"> + <!--l. 1025--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-24-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-24-4" +class="td10"> + <!--l. 1025--><p class="noindent" >page mode setting on exiting full-screen mode. + Possible values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseNone</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseOutlines</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseThumbs</span></span></span>, and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">UseOC</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-25-1" +class="td01"><span +class="ec-lmvtt-10">pdfnumcopies </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-25-2" +class="td11"> + <!--l. 1027--><p class="noindent" >integer </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-25-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-25-4" +class="td10"> + <!--l. 1027--><p class="noindent" >number of printed copies </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-26-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagelayout </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-26-2" +class="td11"> + <!--l. 1028--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-26-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-26-4" +class="td10"> + <!--l. 1028--><p class="noindent" >set layout of PDF pages. Possible values: + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">SinglePage</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">OneColumn</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TwoColumnLeft</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TwoColumnRight</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TwoPageLeft</span></span></span>, and + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TwoPageRight</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-27-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagelabels </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-27-2" +class="td11"> + <!--l. 1032--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-27-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-27-4" +class="td10"> + <!--l. 1032--><p class="noindent" >set PDF page labels </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-28-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagetransition </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-28-2" +class="td11"> + <!--l. 1033--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-28-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-28-4" +class="td10"> + <!--l. 1033--><p class="noindent" >set PDF page transition style. Possible values + are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Split</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Blinds</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Box</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Wipe</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Dissolve</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Glitter</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">R</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Fly</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Push</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Cover</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Uncover</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Fade</span></span></span>. + The default according to the PDF Reference + is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">R</span></span></span>, which simply replaces the old page with + the new one. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-29-1" +class="td01"><span +class="ec-lmvtt-10">pdfpicktraybypdfsize </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-29-2" +class="td11"> + <!--l. 1042--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-29-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-29-4" +class="td10"> + <!--l. 1042--><p class="noindent" >specify whether PDF page size is used to select + input paper tray in print dialog </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-9-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-30-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintarea </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-30-2" +class="td11"> + <!--l. 1043--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-30-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-30-4" +class="td10"> + <!--l. 1043--><p class="noindent" >set /PrintArea of viewer preferences. Possible + values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">MediaBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">BleedBox</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TrimBox</span></span></span>, and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">ArtBox</span></span></span>. The dafault according + to the PDF Refence is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-31-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintclip </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-31-2" +class="td11"> + <!--l. 1047--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-31-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-31-4" +class="td10"> + <!--l. 1047--><p class="noindent" >set /PrintClip of viewer preferences. Possible + values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">MediaBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">BleedBox</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TrimBox</span></span></span>, and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">ArtBox</span></span></span>. The dafault according + to the PDF Refence is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-32-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintpagerange </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-32-2" +class="td11"> + <!--l. 1051--><p class="noindent" >n + n + (n + n)* </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-32-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-32-4" +class="td10"> + <!--l. 1052--><p class="noindent" >set /PrintPageRange of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-33-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintscaling </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-33-2" +class="td11"> + <!--l. 1053--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-33-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-33-4" +class="td10"> + <!--l. 1053--><p class="noindent" >page scaling option for print dialog (option + /PrintScaling of viewer preferences, PDF 1.6); + valid values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">None</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">AppDefault</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-34-1" +class="td01"><span +class="ec-lmvtt-10">pdftoolbar </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-34-2" +class="td11"> + <!--l. 1058--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-34-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-34-4" +class="td10"> + <!--l. 1058--><p class="noindent" >make PDF toolbar visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-35-1" +class="td01"><span +class="ec-lmvtt-10">pdfviewarea </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-35-2" +class="td11"> + <!--l. 1059--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-35-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-35-4" +class="td10"> + <!--l. 1059--><p class="noindent" >set /ViewArea of viewer preferences. Possible + values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">MediaBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">BleedBox</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TrimBox</span></span></span>, and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">ArtBox</span></span></span>. The dafault according + to the PDF Refence is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-36-1" +class="td01"><span +class="ec-lmvtt-10">pdfviewclip </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-36-2" +class="td11"> + <!--l. 1063--><p class="noindent" >name </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-36-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-36-4" +class="td10"> + <!--l. 1063--><p class="noindent" >set /ViewClip of viewer preferences Possible + values are <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">MediaBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">BleedBox</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">TrimBox</span></span></span>, and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">ArtBox</span></span></span>. The dafault according + to the PDF Refence is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">CropBox</span></span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-37-1" +class="td01"><span +class="ec-lmvtt-10">pdfwindowui </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-37-2" +class="td11"> + <!--l. 1067--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-37-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-37-4" +class="td10"> + <!--l. 1067--><p class="noindent" >make PDF user interface elements visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-38-1" +class="td01"><span +class="ec-lmvtt-10">unicode </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-38-2" +class="td11"> + <!--l. 1068--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-38-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-9-38-4" +class="td10"> + <!--l. 1068--><p class="noindent" >Unicode encoded PDF strings </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-39-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-40-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-41-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-42-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-42-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-42-3" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-9-42-4" +class="td10"></td></tr> + </table></div> +<!--l. 1071--><p class="noindent" >Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, which +is not the same as TeX’s. The unit is bp and the origin is in the lower left corner. See also <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypercalcbp</span></span></span> +that is explained on page <a +href="#x1-270006.3">60<!--tex4ht:ref: hypercalcbp --></a>. pdfTeX works by supplying default values for <span +class="ec-lmvtt-10">XYZ </span>(horizontal <span +class="lmsy-10">×</span> +vertical <span +class="lmsy-10">× </span>zoom) and <span +class="ec-lmvtt-10">FitBH</span>. However, drivers using <span +class="ec-lmvtt-10">pdfmark </span>do not supply defaults, so +<span +class="ec-lmss-10">hyperref </span>passes in a value of -32768, which causes Acrobat to set (usually) sensible defaults. +The following are possible values for the <span +class="ec-lmvtt-10">pdfview</span>, <span +class="ec-lmvtt-10">pdfstartview </span>and <span +class="ec-lmvtt-10">pdfremotestartview</span> +parameters. +<!--l. 1083--><p class="indent" > +<a + id="x1-19002r8"></a> <!--l. 1084--><div class="longtable"> <table id="TBL-10" class="longtable" + +><colgroup id="TBL-10-1g"><col +id="TBL-10-1"><col +id="TBL-10-2"><col +id="TBL-10-3"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-10-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-1-1" +class="td01"><span +class="ec-lmvtt-10">XYZ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-1-2" +class="td11"> <span +class="ec-lmri-10">left top zoom </span></td><td style="white-space:normal; text-align:left;" id="TBL-10-1-3" +class="td10"> + <!--l. 1084--><p class="noindent" >Sets a coordinate and a zoom factor. If any one + is null, the source link value is used. <span +class="ec-lmri-10">null null</span> + <span +class="ec-lmri-10">null </span>will give the same values as the current + page. </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-10-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-1" +class="td01"><span +class="ec-lmvtt-10">Fit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-10-2-3" +class="td10"> + <!--l. 1086--><p class="noindent" >Fits the page to the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-1" +class="td01"><span +class="ec-lmvtt-10">FitH </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-2" +class="td11"> <span +class="ec-lmri-10">top </span></td><td style="white-space:normal; text-align:left;" id="TBL-10-3-3" +class="td10"> + <!--l. 1087--><p class="noindent" >Fits the width of the page to the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-1" +class="td01"><span +class="ec-lmvtt-10">FitV </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-2" +class="td11"> <span +class="ec-lmri-10">left </span></td><td style="white-space:normal; text-align:left;" id="TBL-10-4-3" +class="td10"> + <!--l. 1088--><p class="noindent" >Fits the height of the page to the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-1" +class="td01"><span +class="ec-lmvtt-10">FitR </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-2" +class="td11"> <span +class="ec-lmri-10">left bottom right top </span></td><td style="white-space:normal; text-align:left;" id="TBL-10-5-3" +class="td10"> + <!--l. 1089--><p class="noindent" >Fits the rectangle specified by the four + coordinates to the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-1" +class="td01"><span +class="ec-lmvtt-10">FitB </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-10-6-3" +class="td10"> + <!--l. 1090--><p class="noindent" >Fits the page bounding box to the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-7-1" +class="td01"><span +class="ec-lmvtt-10">FitBH </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-7-2" +class="td11"> <span +class="ec-lmri-10">top </span></td><td style="white-space:normal; text-align:left;" id="TBL-10-7-3" +class="td10"> + <!--l. 1091--><p class="noindent" >Fits the width of the page bounding box to + the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-8-1" +class="td01"><span +class="ec-lmvtt-10">FitBV </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-8-2" +class="td11"> <span +class="ec-lmri-10">left </span></td><td style="white-space:normal; text-align:left;" id="TBL-10-8-3" +class="td10"> + <!--l. 1092--><p class="noindent" >Fits the height of the page bounding box to + the window. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-9-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-10-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-11-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-12-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-10-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-13-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-13-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-10-13-3" +class="td10"></td></tr> + </table></div> +<!--l. 1095--><p class="indent" > The <span +class="ec-lmvtt-10">pdfpagelayout </span>can be one of the following values. +<!--l. 1097--><p class="indent" > +<a + id="x1-19003r9"></a> <!--l. 1098--><div class="longtable"> <table id="TBL-11" class="longtable" + +><colgroup id="TBL-11-1g"><col +id="TBL-11-1"><col +id="TBL-11-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-11-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-1-1" +class="td01"><span +class="ec-lmvtt-10">SinglePage </span></td><td style="white-space:normal; text-align:left;" id="TBL-11-1-2" +class="td10"> + <!--l. 1098--><p class="noindent" >Displays a single page; advancing flips the page </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-2-1" +class="td01"><span +class="ec-lmvtt-10">OneColumn </span></td><td style="white-space:normal; text-align:left;" id="TBL-11-2-2" +class="td10"> + <!--l. 1099--><p class="noindent" >Displays the document in one column; continuous scrolling. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-3-1" +class="td01"><span +class="ec-lmvtt-10">TwoColumnLeft </span></td><td style="white-space:normal; text-align:left;" id="TBL-11-3-2" +class="td10"> + <!--l. 1100--><p class="noindent" >Displays the document in two columns, odd-numbered pages to + the left. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-4-1" +class="td01"><span +class="ec-lmvtt-10">TwoColumnRight </span></td><td style="white-space:normal; text-align:left;" id="TBL-11-4-2" +class="td10"> + <!--l. 1101--><p class="noindent" >Displays the document in two columns, odd-numbered pages to + the right. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-5-1" +class="td01"><span +class="ec-lmvtt-10">TwoPageLeft </span></td><td style="white-space:normal; text-align:left;" id="TBL-11-5-2" +class="td10"> + <!--l. 1102--><p class="noindent" >Displays two pages, odd-numbered pages to the left (since PDF + 1.5). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-6-1" +class="td01"><span +class="ec-lmvtt-10">TwoPageRight </span></td><td style="white-space:normal; text-align:left;" id="TBL-11-6-2" +class="td10"> + <!--l. 1103--><p class="noindent" >Displays two pages, odd-numbered pages to the right (since PDF + 1.5). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-7-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-8-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-9-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-10-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-11-10-2" +class="td10"></td></tr> + </table></div> +<!--l. 1106--><p class="indent" > Finally, the <span +class="ec-lmvtt-10">pdfpagetransition </span>can be one of the following values, where <span +class="ec-lmri-10">/Di </span>stands for direction of +motion in degrees, generally in 90<sup><span +class="lmsy7-">∘</span></sup> steps, <span +class="ec-lmri-10">/Dm </span>is a horizontal (<span +class="ec-lmvtt-10">/H</span>) or vertical (<span +class="ec-lmvtt-10">/V</span>) dimension +(e.g. <span +class="ec-lmvtt-10">Blinds /Dm /V</span>), and <span +class="ec-lmri-10">/M </span>is for motion, either in (<span +class="ec-lmvtt-10">/I</span>) or out (<span +class="ec-lmvtt-10">/O</span>). +<!--l. 1113--><p class="indent" > +<a + id="x1-19004r10"></a> <!--l. 1114--><div class="longtable"> <table id="TBL-12" class="longtable" + +><colgroup id="TBL-12-1g"><col +id="TBL-12-1"><col +id="TBL-12-2"><col +id="TBL-12-3"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-12-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-1-1" +class="td01"><span +class="ec-lmvtt-10">Blinds </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-1-2" +class="td11"> /Dm </td><td style="white-space:normal; text-align:left;" id="TBL-12-1-3" +class="td10"> + <!--l. 1114--><p class="noindent" >Multiple lines distributed evenly across the screen sweep + in the same direction to reveal the new page. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-2-1" +class="td01"><span +class="ec-lmvtt-10">Box </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-2-2" +class="td11"> /M </td><td style="white-space:normal; text-align:left;" id="TBL-12-2-3" +class="td10"> + <!--l. 1116--><p class="noindent" >A box sweeps in or out. </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-12-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-3-1" +class="td01"><span +class="ec-lmvtt-10">Dissolve </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-3-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-3-3" +class="td10"> + <!--l. 1117--><p class="noindent" >The page image dissolves in a piecemeal fashion to reveal + the new page. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-4-1" +class="td01"><span +class="ec-lmvtt-10">Glitter </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-4-2" +class="td11"> /Di </td><td style="white-space:normal; text-align:left;" id="TBL-12-4-3" +class="td10"> + <!--l. 1118--><p class="noindent" >Similar to Dissolve, except the effect sweeps across the + screen. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-5-1" +class="td01"><span +class="ec-lmvtt-10">Split </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-5-2" +class="td11"> /Dm /M </td><td style="white-space:normal; text-align:left;" id="TBL-12-5-3" +class="td10"> + <!--l. 1119--><p class="noindent" >Two lines sweep across the screen to reveal the new page.</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-6-1" +class="td01"><span +class="ec-lmvtt-10">Wipe </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-6-2" +class="td11"> /Di </td><td style="white-space:normal; text-align:left;" id="TBL-12-6-3" +class="td10"> + <!--l. 1120--><p class="noindent" >A single line sweeps across the screen to reveal the new + page. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-7-1" +class="td01"><span +class="ec-lmvtt-10">R </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-7-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-7-3" +class="td10"> + <!--l. 1121--><p class="noindent" >Simply replaces the old page with the new one. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-8-1" +class="td01"><span +class="ec-lmvtt-10">Fly </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-8-2" +class="td11"> /Di /M </td><td style="white-space:normal; text-align:left;" id="TBL-12-8-3" +class="td10"> + <!--l. 1122--><p class="noindent" >Changes are flown out or in (as specified by /M), in the + direction specified by /Di, to or from a location that is + offscreen except when /Di is None. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-9-1" +class="td01"><span +class="ec-lmvtt-10">Push </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-9-2" +class="td11"> /Di </td><td style="white-space:normal; text-align:left;" id="TBL-12-9-3" +class="td10"> + <!--l. 1125--><p class="noindent" >The old page slides off the screen while the new page + slides in, pushing the old page out in the direction + specified by /Di. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-10-1" +class="td01"><span +class="ec-lmvtt-10">Cover </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-10-2" +class="td11"> /Di </td><td style="white-space:normal; text-align:left;" id="TBL-12-10-3" +class="td10"> + <!--l. 1128--><p class="noindent" >The new page slides on to the screen in the direction + specified by /Di, covering the old page. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-11-1" +class="td01"><span +class="ec-lmvtt-10">Uncover </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-11-2" +class="td11"> /Di </td><td style="white-space:normal; text-align:left;" id="TBL-12-11-3" +class="td10"> + <!--l. 1130--><p class="noindent" >The old page slides off the screen in the direction + specified by /Di, uncovering the new page in the + direction specified by /Di. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-12-1" +class="td01"><span +class="ec-lmvtt-10">Fade </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-12-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-12-3" +class="td10"> + <!--l. 1133--><p class="noindent" >The new page gradually becomes visible through the old + one. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-13-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-14-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-15-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-16-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-16-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-12-16-3" +class="td10"></td></tr> + </table></div> +<!--l. 1137--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.8 </span> <a + id="x1-200005.8"></a>Option <span +class="ec-lmvtt-10">pdfinfo</span></h4> +<!--l. 1139--><p class="noindent" >The information entries can be set using <span +class="ec-lmvtt-10">pdftitle</span>, <span +class="ec-lmvtt-10">pdfsubject</span>, …. Option <span +class="ec-lmvtt-10">pdfinfo </span>provides an alternative +interface. It takes a key value list. The key names are the names that appear in the PDF information +dictionary directly. Known keys such as <span +class="ec-lmvtt-10">Title</span>, <span +class="ec-lmvtt-10">Subject</span>, <span +class="ec-lmvtt-10">Trapped </span>and other are mapped to options +<span +class="ec-lmvtt-10">pdftitle</span>, <span +class="ec-lmvtt-10">subject</span>, <span +class="ec-lmvtt-10">trapped</span>, …Unknown keys are added to the information dictionary. Their values are text +strings (see PDF specification). Example: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-18"> +\hypersetup{ +  pdfinfo={ +    Title={My Title}, +    Subject={My Subject}, +    NewKey={Foobar}, +    % ... +  } +} +</pre> + <!--l. 1158--><p class="nopar" ></blockquote> +<!--l. 1161--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.9 </span> <a + id="x1-210005.9"></a>Big alphabetical list</h4> +<!--l. 1163--><p class="noindent" >The following is a complete listing of available options for <span +class="ec-lmss-10">hyperref</span>, arranged alphabetically. +<!--l. 1166--><p class="indent" > +<a + id="x1-21001r11"></a> <!--l. 1167--><div class="longtable"> <table id="TBL-13" class="longtable" + +><colgroup id="TBL-13-1g"><col +id="TBL-13-1"><col +id="TBL-13-2"><col +id="TBL-13-3"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-13-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-1-1" +class="td01"><span +class="ec-lmvtt-10">allbordercolors </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-1-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-1-3" +class="td10"> + <!--l. 1167--><p class="noindent" >Set all border color options </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-2-1" +class="td01"><span +class="ec-lmvtt-10">allcolors </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-2-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-2-3" +class="td10"> + <!--l. 1168--><p class="noindent" >Set all color options (without border and field + options) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-3-1" +class="td01"><span +class="ec-lmvtt-10">anchorcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-3-2" +class="td11"> <span +class="ec-lmri-10">black </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-3-3" +class="td10"> + <!--l. 1169--><p class="noindent" >set color of anchors, ignored by most drivers. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-4-1" +class="td01"><span +class="ec-lmvtt-10">backref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-4-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-4-3" +class="td10"> + <!--l. 1170--><p class="noindent" >do bibliographical back references </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-5-1" +class="td01"><span +class="ec-lmvtt-10">baseurl </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-5-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-5-3" +class="td10"> + <!--l. 1171--><p class="noindent" >set base URL for document </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-6-1" +class="td01"><span +class="ec-lmvtt-10">bookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-6-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-6-3" +class="td10"> + <!--l. 1172--><p class="noindent" >make bookmarks </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-7-1" +class="td01"><span +class="ec-lmvtt-10">bookmarksnumbered </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-7-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-7-3" +class="td10"> + <!--l. 1173--><p class="noindent" >put section numbers in bookmarks </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-8-1" +class="td01"><span +class="ec-lmvtt-10">bookmarksopen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-8-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-8-3" +class="td10"> + <!--l. 1174--><p class="noindent" >open up bookmark tree </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-9-1" +class="td01"><span +class="ec-lmvtt-10">bookmarksopenlevel </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-9-2" +class="td11"> <span +class="ec-lmvtt-10">\maxdimen </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-9-3" +class="td10"> + <!--l. 1175--><p class="noindent" >level to which bookmarks are open </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-10-1" +class="td01"><span +class="ec-lmvtt-10">bookmarkstype </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-10-2" +class="td11"> <span +class="ec-lmri-10">toc </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-10-3" +class="td10"> + <!--l. 1176--><p class="noindent" >to specify which ‘toc’ file to mimic </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-11-1" +class="td01"><span +class="ec-lmvtt-10">breaklinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-11-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-11-3" +class="td10"> + <!--l. 1177--><p class="noindent" >allow links to break over lines </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-12-1" +class="td01"><span +class="ec-lmvtt-10">CJKbookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-12-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-12-3" +class="td10"> + <!--l. 1178--><p class="noindent" >to produce CJK bookmarks </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-13-1" +class="td01"><span +class="ec-lmvtt-10">citebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-13-2" +class="td11"> <span +class="ec-lmri-10">0 1 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-13-3" +class="td10"> + <!--l. 1179--><p class="noindent" >color of border around cites </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-14-1" +class="td01"><span +class="ec-lmvtt-10">citecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-14-2" +class="td11"> <span +class="ec-lmri-10">green </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-14-3" +class="td10"> + <!--l. 1180--><p class="noindent" >color of citation links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-15-1" +class="td01"><span +class="ec-lmvtt-10">colorlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-15-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-15-3" +class="td10"> + <!--l. 1181--><p class="noindent" >color links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-16-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-13-16-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-16-3" +class="td10"> + <!--l. 1182--><p class="noindent" >(<span +class="ec-lmss-10">tex4ht</span>, <span +class="ec-lmss-10">dviwindo</span>) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-17-1" +class="td01"><span +class="ec-lmvtt-10">debug </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-17-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-17-3" +class="td10"> + <!--l. 1183--><p class="noindent" >provide details of anchors defined; same as + verbose </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-13-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-18-1" +class="td01"><span +class="ec-lmvtt-10">destlabel </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-18-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-18-3" +class="td10"> + <!--l. 1184--><p class="noindent" >destinations are named by the first <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span> + after the anchor creation </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-19-1" +class="td01"><span +class="ec-lmvtt-10">draft </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-19-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-19-3" +class="td10"> + <!--l. 1185--><p class="noindent" >do not do any hyperlinking </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-20-1" +class="td01"><span +class="ec-lmvtt-10">driverfallback </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-20-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-20-3" +class="td10"> + <!--l. 1186--><p class="noindent" >default if no driver specified or detected </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-21-1" +class="td01"><span +class="ec-lmvtt-10">dvipdfm </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-21-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-21-3" +class="td10"> + <!--l. 1187--><p class="noindent" >use <span +class="ec-lmss-10">dvipdfm </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-22-1" +class="td01"><span +class="ec-lmvtt-10">dvipdfmx </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-22-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-22-3" +class="td10"> + <!--l. 1188--><p class="noindent" >use <span +class="ec-lmss-10">dvipdfmx </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-23-1" +class="td01"><span +class="ec-lmvtt-10">dvips </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-23-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-23-3" +class="td10"> + <!--l. 1189--><p class="noindent" >use <span +class="ec-lmss-10">dvips </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-24-1" +class="td01"><span +class="ec-lmvtt-10">dvipsone </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-24-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-24-3" +class="td10"> + <!--l. 1190--><p class="noindent" >use <span +class="ec-lmss-10">dvipsone </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-25-1" +class="td01"><span +class="ec-lmvtt-10">dviwindo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-25-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-25-3" +class="td10"> + <!--l. 1191--><p class="noindent" >use <span +class="ec-lmss-10">dviwindo </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-26-1" +class="td01"><span +class="ec-lmvtt-10">encap </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-26-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-26-3" +class="td10"> + <!--l. 1192--><p class="noindent" >to set encap character for hyperindex </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-27-1" +class="td01"><span +class="ec-lmvtt-10">extension </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-27-2" +class="td11"> <span +class="ec-lmri-10">dvi </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-27-3" +class="td10"> + <!--l. 1193--><p class="noindent" >suffix of linked files </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-28-1" +class="td01"><span +class="ec-lmvtt-10">filebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-28-2" +class="td11"> <span +class="ec-lmri-10">0 .5 .5 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-28-3" +class="td10"> + <!--l. 1194--><p class="noindent" >color of border around file links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-29-1" +class="td01"><span +class="ec-lmvtt-10">filecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-29-2" +class="td11"> <span +class="ec-lmri-10">cyan </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-29-3" +class="td10"> + <!--l. 1195--><p class="noindent" >color of file links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-30-1" +class="td01"><span +class="ec-lmvtt-10">final </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-30-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-30-3" +class="td10"> + <!--l. 1196--><p class="noindent" >opposite of option draft </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-31-1" +class="td01"><span +class="ec-lmvtt-10">frenchlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-31-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-31-3" +class="td10"> + <!--l. 1197--><p class="noindent" >use small caps instead of color for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-32-1" +class="td01"><span +class="ec-lmvtt-10">hidelinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-32-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-32-3" +class="td10"> + <!--l. 1198--><p class="noindent" >Hide links (removing color and border) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-33-1" +class="td01"><span +class="ec-lmvtt-10">hyperfigures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-33-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-33-3" +class="td10"> + <!--l. 1199--><p class="noindent" >make figures hyper links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-34-1" +class="td01"><span +class="ec-lmvtt-10">hyperfootnotes </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-34-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-34-3" +class="td10"> + <!--l. 1200--><p class="noindent" >set up hyperlinked footnotes </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-35-1" +class="td01"><span +class="ec-lmvtt-10">hyperindex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-35-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-35-3" +class="td10"> + <!--l. 1201--><p class="noindent" >set up hyperlinked indices </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-36-1" +class="td01"><span +class="ec-lmvtt-10">hypertex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-36-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-36-3" +class="td10"> + <!--l. 1202--><p class="noindent" >use <span +class="ec-lmss-10">HyperTeX </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-37-1" +class="td01"><span +class="ec-lmvtt-10">hypertexnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-37-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-37-3" +class="td10"> + <!--l. 1203--><p class="noindent" >use guessable names for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-38-1" +class="td01"><span +class="ec-lmvtt-10">implicit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-38-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-38-3" +class="td10"> + <!--l. 1204--><p class="noindent" >redefine LaTeX internals </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-39-1" +class="td01"><span +class="ec-lmvtt-10">latex2html </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-39-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-39-3" +class="td10"> + <!--l. 1205--><p class="noindent" >use <span +class="ec-lmss-10">LaTeX2HTML </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-40-1" +class="td01"><span +class="ec-lmvtt-10">linkbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-40-2" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-40-3" +class="td10"> + <!--l. 1206--><p class="noindent" >color of border around links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-41-1" +class="td01"><span +class="ec-lmvtt-10">linkcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-41-2" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-41-3" +class="td10"> + <!--l. 1207--><p class="noindent" >color of links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-42-1" +class="td01"><span +class="ec-lmvtt-10">linktoc </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-42-2" +class="td11"> <span +class="ec-lmri-10">section </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-42-3" +class="td10"> + <!--l. 1208--><p class="noindent" >make text be link on TOC, LOF and LOT </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-43-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-43-1" +class="td01"><span +class="ec-lmvtt-10">linktocpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-43-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-43-3" +class="td10"> + <!--l. 1209--><p class="noindent" >make page number, not text, be link on TOC, + LOF and LOT </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-44-1" +class="td01"><span +class="ec-lmvtt-10">menubordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-44-2" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-44-3" +class="td10"> + <!--l. 1210--><p class="noindent" >color of border around menu links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-45-1" +class="td01"><span +class="ec-lmvtt-10">menucolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-45-2" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-45-3" +class="td10"> + <!--l. 1211--><p class="noindent" >color for menu links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-46-1" +class="td01"><span +class="ec-lmvtt-10">nativepdf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-46-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-46-3" +class="td10"> + <!--l. 1212--><p class="noindent" >an alias for <span +class="ec-lmss-10">dvips</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-47-1" +class="td01"><span +class="ec-lmvtt-10">naturalnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-47-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-47-3" +class="td10"> + <!--l. 1213--><p class="noindent" >use LaTeX-computed names for links </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-13-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-48-1" +class="td01"><span +class="ec-lmvtt-10">nesting </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-48-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-48-3" +class="td10"> + <!--l. 1214--><p class="noindent" >allow nesting of links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-49-1" +class="td01"><span +class="ec-lmvtt-10">next-anchor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-49-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-49-3" +class="td10"> + <!--l. 1215--><p class="noindent" >allow to set the name of the next anchor </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-50-1" +class="td01"><span +class="ec-lmvtt-10">pageanchor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-50-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-50-3" +class="td10"> + <!--l. 1216--><p class="noindent" >put an anchor on every page </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-51-1" +class="td01"><span +class="ec-lmvtt-10">pagebackref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-51-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-51-3" +class="td10"> + <!--l. 1217--><p class="noindent" >backreference by page number </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-52-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-52-1" +class="td01"><span +class="ec-lmvtt-10">pdfauthor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-52-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-52-3" +class="td10"> + <!--l. 1218--><p class="noindent" >text for PDF Author field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-53-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-53-1" +class="td01"><span +class="ec-lmvtt-10">pdfborder </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-53-2" +class="td11"> <span +class="ec-lmri-10">0 0 1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-53-3" +class="td10"> + <!--l. 1219--><p class="noindent" >width of PDF link border </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-54-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-54-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-13-54-2" +class="td11"> <span +class="ec-lmri-10">0 0 0 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-54-3" +class="td10"> + <!--l. 1220--><p class="noindent" >(<span +class="ec-lmvtt-10">colorlinks)</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-55-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-55-1" +class="td01"><span +class="ec-lmvtt-10">pdfborderstyle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-55-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-55-3" +class="td10"> + <!--l. 1221--><p class="noindent" >border style for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-56-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-56-1" +class="td01"><span +class="ec-lmvtt-10">pdfcenterwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-56-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-56-3" +class="td10"> + <!--l. 1222--><p class="noindent" >position the document window in the center + of the screen </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-57-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-57-1" +class="td01"><span +class="ec-lmvtt-10">pdfcreator </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-57-2" +class="td11"> <span +class="ec-lmri-10">LaTeX with </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-57-3" +class="td10"> + <!--l. 1223--><p class="noindent" >text for PDF Creator field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-58-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-58-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-13-58-2" +class="td11"> <span +class="ec-lmri-10">hyperref </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-58-3" +class="td10"> + <!--l. 1225--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-59-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-59-1" +class="td01"><span +class="ec-lmvtt-10">pdfdirection </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-59-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-59-3" +class="td10"> + <!--l. 1225--><p class="noindent" >direction setting </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-60-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-60-1" +class="td01"><span +class="ec-lmvtt-10">pdfdisplaydoctitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-60-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-60-3" +class="td10"> + <!--l. 1226--><p class="noindent" >display document title instead of file name in + title bar </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-61-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-61-1" +class="td01"><span +class="ec-lmvtt-10">pdfduplex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-61-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-61-3" +class="td10"> + <!--l. 1228--><p class="noindent" >paper handling option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-62-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-62-1" +class="td01"><span +class="ec-lmvtt-10">pdffitwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-62-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-62-3" +class="td10"> + <!--l. 1230--><p class="noindent" >resize document window to fit document size </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-63-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-63-1" +class="td01"><span +class="ec-lmvtt-10">pdfhighlight </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-63-2" +class="td11"> <span +class="ec-lmri-10">/I </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-63-3" +class="td10"> + <!--l. 1231--><p class="noindent" >set highlighting of PDF links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-64-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-64-1" +class="td01"><span +class="ec-lmvtt-10">pdfinfo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-64-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-64-3" +class="td10"> + <!--l. 1232--><p class="noindent" >alternative interface for setting document + information </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-65-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-65-1" +class="td01"><span +class="ec-lmvtt-10">pdfkeywords </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-65-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-65-3" +class="td10"> + <!--l. 1233--><p class="noindent" >text for PDF Keywords field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-66-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-66-1" +class="td01"><span +class="ec-lmvtt-10">pdflang </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-66-2" +class="td11"> <span +class="ec-lmri-10">relax </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-66-3" +class="td10"> + <!--l. 1234--><p class="noindent" >PDF language identifier (RFC 3066) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-67-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-67-1" +class="td01"><span +class="ec-lmvtt-10">pdfmark </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-67-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-67-3" +class="td10"> + <!--l. 1235--><p class="noindent" >an alias for <span +class="ec-lmss-10">dvips</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-68-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-68-1" +class="td01"><span +class="ec-lmvtt-10">pdfmenubar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-68-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-68-3" +class="td10"> + <!--l. 1236--><p class="noindent" >make PDF viewer’s menu bar visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-69-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-69-1" +class="td01"><span +class="ec-lmvtt-10">pdfnewwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-69-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-69-3" +class="td10"> + <!--l. 1237--><p class="noindent" >make links that open another PDF </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-70-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-70-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-13-70-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-70-3" +class="td10"> + <!--l. 1238--><p class="noindent" >file start a new window </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-71-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-71-1" +class="td01"><span +class="ec-lmvtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-71-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-71-3" +class="td10"> + <!--l. 1240--><p class="noindent" >page mode setting on exiting full-screen mode</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-72-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-72-1" +class="td01"><span +class="ec-lmvtt-10">pdfnumcopies </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-72-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-72-3" +class="td10"> + <!--l. 1242--><p class="noindent" >number of printed copies </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-73-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-73-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagelabels </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-73-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-73-3" +class="td10"> + <!--l. 1243--><p class="noindent" >set PDF page labels </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-74-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-74-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagelayout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-74-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-74-3" +class="td10"> + <!--l. 1244--><p class="noindent" >set layout of PDF pages </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-75-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-75-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-75-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-75-3" +class="td10"> + <!--l. 1245--><p class="noindent" >set default mode of PDF display </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-76-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-76-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagescrop </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-76-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-76-3" +class="td10"> + <!--l. 1246--><p class="noindent" >set crop size of PDF document </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-13-77-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-77-1" +class="td01"><span +class="ec-lmvtt-10">pdfpagetransition </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-77-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-77-3" +class="td10"> + <!--l. 1247--><p class="noindent" >set PDF page transition style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-78-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-78-1" +class="td01"><span +class="ec-lmvtt-10">pdfpicktraybypdfsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-78-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-78-3" +class="td10"> + <!--l. 1249--><p class="noindent" >set option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-79-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-79-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-79-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-79-3" +class="td10"> + <!--l. 1250--><p class="noindent" >set /PrintArea of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-80-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-80-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-80-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-80-3" +class="td10"> + <!--l. 1251--><p class="noindent" >set /PrintClip of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-81-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-81-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintpagerange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-81-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-81-3" +class="td10"> + <!--l. 1252--><p class="noindent" >set /PrintPageRange of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-82-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-82-1" +class="td01"><span +class="ec-lmvtt-10">pdfprintscaling </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-82-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-82-3" +class="td10"> + <!--l. 1253--><p class="noindent" >page scaling option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-83-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-83-1" +class="td01"><span +class="ec-lmvtt-10">pdfproducer </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-83-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-83-3" +class="td10"> + <!--l. 1254--><p class="noindent" >text for PDF Producer field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-84-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-84-1" +class="td01"><span +class="ec-lmvtt-10">pdfremotestartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-84-2" +class="td11"> <span +class="ec-lmri-10">Fit </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-84-3" +class="td10"> + <!--l. 1255--><p class="noindent" >starting view of remote PDF documents </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-85-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-85-1" +class="td01"><span +class="ec-lmvtt-10">pdfstartpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-85-2" +class="td11"> <span +class="ec-lmri-10">1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-85-3" +class="td10"> + <!--l. 1256--><p class="noindent" >page at which PDF document opens </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-86-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-86-1" +class="td01"><span +class="ec-lmvtt-10">pdfstartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-86-2" +class="td11"> <span +class="ec-lmri-10">Fit </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-86-3" +class="td10"> + <!--l. 1257--><p class="noindent" >starting view of PDF document </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-87-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-87-1" +class="td01"><span +class="ec-lmvtt-10">pdfsubject </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-87-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-87-3" +class="td10"> + <!--l. 1258--><p class="noindent" >text for PDF Subject field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-88-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-88-1" +class="td01"><span +class="ec-lmvtt-10">pdftex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-88-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-88-3" +class="td10"> + <!--l. 1259--><p class="noindent" >use <span +class="ec-lmss-10">pdfTeX </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-89-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-89-1" +class="td01"><span +class="ec-lmvtt-10">pdftitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-89-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-89-3" +class="td10"> + <!--l. 1260--><p class="noindent" >text for PDF Title field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-90-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-90-1" +class="td01"><span +class="ec-lmvtt-10">pdftoolbar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-90-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-90-3" +class="td10"> + <!--l. 1261--><p class="noindent" >make PDF toolbar visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-91-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-91-1" +class="td01"><span +class="ec-lmvtt-10">pdftrapped </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-91-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-91-3" +class="td10"> + <!--l. 1262--><p class="noindent" >Sets the document information Trapped entry. + Possible values are <span +class="ec-lmvtt-10">True</span>, <span +class="ec-lmvtt-10">False </span>and <span +class="ec-lmvtt-10">Unknown</span>. + An empty value means, the entry is not set. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-92-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-92-1" +class="td01"><span +class="ec-lmvtt-10">pdfview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-92-2" +class="td11"> <span +class="ec-lmri-10">XYZ </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-92-3" +class="td10"> + <!--l. 1265--><p class="noindent" >PDF ‘view’ when on link traversal </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-93-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-93-1" +class="td01"><span +class="ec-lmvtt-10">pdfviewarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-93-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-93-3" +class="td10"> + <!--l. 1266--><p class="noindent" >set /ViewArea of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-94-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-94-1" +class="td01"><span +class="ec-lmvtt-10">pdfviewclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-94-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-94-3" +class="td10"> + <!--l. 1267--><p class="noindent" >set /ViewClip of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-95-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-95-1" +class="td01"><span +class="ec-lmvtt-10">pdfwindowui </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-95-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-95-3" +class="td10"> + <!--l. 1268--><p class="noindent" >make PDF user interface elements visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-96-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-96-1" +class="td01"><span +class="ec-lmvtt-10">plainpages </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-96-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-96-3" +class="td10"> + <!--l. 1269--><p class="noindent" >do page number anchors as plain Arabic </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-97-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-97-1" +class="td01"><span +class="ec-lmvtt-10">ps2pdf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-97-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-97-3" +class="td10"> + <!--l. 1270--><p class="noindent" >use <span +class="ec-lmss-10">ps2pdf </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-98-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-98-1" +class="td01"><span +class="ec-lmvtt-10">psdextra </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-98-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-98-3" +class="td10"> + <!--l. 1271--><p class="noindent" >define more short names for PDF string + commands </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-99-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-99-1" +class="td01"><span +class="ec-lmvtt-10">raiselinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-99-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-99-3" +class="td10"> + <!--l. 1272--><p class="noindent" >raise up links (for <span +class="ec-lmss-10">HyperTeX </span>backend) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-100-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-100-1" +class="td01"><span +class="ec-lmvtt-10">runbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-100-2" +class="td11"> <span +class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-100-3" +class="td10"> + <!--l. 1273--><p class="noindent" >color of border around ‘run’ links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-101-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-101-1" +class="td01"><span +class="ec-lmvtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-101-2" +class="td11"> <span +class="ec-lmri-10">filecolor </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-101-3" +class="td10"> + <!--l. 1274--><p class="noindent" >color of ‘run’ links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-102-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-102-1" +class="td01"><span +class="ec-lmvtt-10">setpagesize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-102-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-102-3" +class="td10"> + <!--l. 1275--><p class="noindent" >set page size by special driver commands </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-103-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-103-1" +class="td01"><span +class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-103-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-103-3" +class="td10"> + <!--l. 1276--><p class="noindent" >use <span +class="ec-lmss-10">TeX4ht </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-104-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-104-1" +class="td01"><span +class="ec-lmvtt-10">textures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-104-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-104-3" +class="td10"> + <!--l. 1277--><p class="noindent" >use <span +class="ec-lmss-10">Textures </span>backend </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-13-105-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-105-1" +class="td01"><span +class="ec-lmvtt-10">unicode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-105-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-105-3" +class="td10"> + <!--l. 1278--><p class="noindent" >Unicode encoded pdf strings, starting with + version v7.00g set by default to true for all + engines. It will load a number of definitions in + puenc.def. It can be set to false for pdflatex, + but this is not recommended. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-106-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-106-1" +class="td01"><span +class="ec-lmvtt-10">urlbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-106-2" +class="td11"> <span +class="ec-lmri-10">0 1 1 </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-106-3" +class="td10"> + <!--l. 1279--><p class="noindent" >color of border around URL links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-107-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-107-1" +class="td01"><span +class="ec-lmvtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-107-2" +class="td11"> <span +class="ec-lmri-10">magenta </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-107-3" +class="td10"> + <!--l. 1280--><p class="noindent" >color of URL links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-108-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-108-1" +class="td01"><span +class="ec-lmvtt-10">verbose </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-108-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:normal; text-align:left;" id="TBL-13-108-3" +class="td10"> + <!--l. 1281--><p class="noindent" >be chatty </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-109-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-109-1" +class="td01"><span +class="ec-lmvtt-10">vtex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-109-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-109-3" +class="td10"> + <!--l. 1282--><p class="noindent" >use <span +class="ec-lmss-10">VTeX </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-110-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-110-1" +class="td01"><span +class="ec-lmvtt-10">xetex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-13-110-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-110-3" +class="td10"> + <!--l. 1283--><p class="noindent" >use <span +class="ec-lmss-10">XeTeX </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-111-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-111-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-112-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-112-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-113-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-113-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-114-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-114-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-13-115-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-115-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-13-115-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-13-115-3" +class="td10"></td></tr> + </table></div> +<!--l. 1286--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-220006"></a>Additional user macros</h3> +<!--l. 1288--><p class="noindent" >If you need to make references to URLs, or write explicit links, the following low-level user macros are +provided: +<!--l. 1291--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-14" class="tabular" + +><colgroup id="TBL-14-1g"><col +id="TBL-14-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-14-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-1-1" +class="td11"> <span +class="ec-lmvtt-10">\href</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">options</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">]</span></span></span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +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. 1295--><p class="noindent" >The <span +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 % do <span +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. 1300--><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 +class="ec-lmvtt-10">pdfnewwindow</span> +and the following key value options: + <dl class="description"><dt class="description"> + <!--l. 1304--><p class="noindent" > +<span +class="ec-lmvtk-10">page</span><span +class="ec-lmbx-10">:</span> </dt><dd +class="description"> + <!--l. 1304--><p class="noindent" >Specifies the start page number of remote PDF documents. First page is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">1</span></span></span>. + </dd><dt class="description"> + <!--l. 1306--><p class="noindent" > +<span +class="ec-lmvtk-10">ismap</span><span +class="ec-lmbx-10">:</span> </dt><dd +class="description"> + <!--l. 1306--><p class="noindent" >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"> + <!--l. 1309--><p class="noindent" > +<span +class="ec-lmvtk-10">nextactionraw</span><span +class="ec-lmbx-10">:</span> </dt><dd +class="description"> + <!--l. 1309--><p class="noindent" >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. 1313--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-15" class="tabular" + +><colgroup id="TBL-15-1g"><col +id="TBL-15-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-15-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-1-1" +class="td11"> <span +class="ec-lmvtt-10">\url</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> +<!--l. 1317--><p class="noindent" >Similar to <span +class="ec-lmvtt-10">\href</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmvtt-10">\nolinkurl</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}}</span></span></span>. Depending on the driver <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\href</span></span></span> also tries to detect the link +type. Thus the result can be a url link, file link, … +<!--l. 1322--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-16" class="tabular" + +><colgroup id="TBL-16-1g"><col +id="TBL-16-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-16-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-16-1-1" +class="td11"> <span +class="ec-lmvtt-10">\nolinkurl</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> +<!--l. 1326--><p class="noindent" >Write <span +class="ec-lmri-10">URL </span>in the same way as <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\url</span></span></span>, without creating a hyperlink. +<!--l. 1329--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-17" class="tabular" + +><colgroup id="TBL-17-1g"><col +id="TBL-17-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-17-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-17-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperbaseurl</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1333--><p class="noindent" >A base <span +class="ec-lmri-10">URL </span>is established, which is prepended to other specified URLs, to make it easier to write +portable documents. +<!--l. 1336--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-18" class="tabular" + +><colgroup id="TBL-18-1g"><col +id="TBL-18-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-18-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-18-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperimage</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">imageURL</span><span class="obeylines-h"><span class="verb"><span +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. 1340--><p class="noindent" >The link to the image referenced by the URL is inserted, using <span +class="ec-lmri-10">text </span>as the anchor. +<!--l. 1343--><p class="indent" > For drivers that produce HTML, the image itself is inserted by the browser, with the <span +class="ec-lmri-10">text </span>being +ignored completely. +<!--l. 1346--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-19" class="tabular" + +><colgroup id="TBL-19-1g"><col +id="TBL-19-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-19-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-19-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperdef</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">category</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +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. 1350--><p class="noindent" >A target area of the document (the <span +class="ec-lmri-10">text</span>) is marked, and given the name <span +class="ec-lmri-10">category.name</span> +<!--l. 1353--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-20" class="tabular" + +><colgroup id="TBL-20-1g"><col +id="TBL-20-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-20-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-20-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperref</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">category</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +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. 1357--><p class="noindent" ><span +class="ec-lmri-10">text </span>is made into a link to <span +class="ec-lmri-10">URL#category.name</span> +<!--l. 1359--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-21" class="tabular" + +><colgroup id="TBL-21-1g"><col +id="TBL-21-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-21-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-21-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperref</span><span class="obeylines-h"><span class="verb"><span +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><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. 1363--><p class="noindent" ><span +class="ec-lmri-10">text </span>is made into a link to the same place as <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ref{</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> would be linked. +<!--l. 1367--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-22" class="tabular" + +><colgroup id="TBL-22-1g"><col +id="TBL-22-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-22-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-22-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperlink</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +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. 1370--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-23" class="tabular" + +><colgroup id="TBL-23-1g"><col +id="TBL-23-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-23-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-23-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hypertarget</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +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. 1374--><p class="noindent" >A simple internal link is created with <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypertarget</span></span></span>, with two parameters of an anchor <span +class="ec-lmri-10">name</span>, and anchor +<span +class="ec-lmri-10">text</span>. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperlink</span></span></span> has two arguments, the name of a hypertext object defined somewhere by <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypertarget</span></span></span>, +and the <span +class="ec-lmri-10">text </span>which be used as the link on the page. +<!--l. 1380--><p class="indent" > Note that in HTML parlance, the <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperlink</span></span></span> command inserts a notional # in front of each link, +making it relative to the current testdocument; <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\href</span></span></span> expects a full URL. +<!--l. 1384--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-24" class="tabular" + +><colgroup id="TBL-24-1g"><col +id="TBL-24-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-24-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-24-1-1" +class="td11"> <span +class="ec-lmvtt-10">\phantomsection </span></td> + </tr></table> </div></span> +<!--l. 1388--><p class="noindent" >This sets an anchor at this location. It works similar to <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypertarget{}{}</span></span></span> with an automatically chosen +anchor name. Often it is 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 set. +Example: + + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-19"> +\cleardoublepage +\phantomsection +\addcontentsline{toc}{chapter}{\indexname} +\printindex +</pre> + <!--l. 1401--><p class="nopar" ></blockquote> +<!--l. 1403--><p class="noindent" >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. 1407--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-25" class="tabular" + +><colgroup id="TBL-25-1g"><col +id="TBL-25-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-25-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperget</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">anchor</span><span class="obeylines-h"><span class="verb"><span +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> <span +class="ec-lmvtt-10">\hyperget</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">pageanchor</span><span class="obeylines-h"><span class="verb"><span +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. 1412--><p class="indent" > This retrieves the anchor or the page anchor from a label in an expandable way. It takes +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\HyperDestNameFilter</span></span></span> into account. It can e.g. be used with the <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\bookmark</span></span></span> from the bookmark +package to set a destination to a label: + + + <pre class="verbatim" id="verbatim-20"> +\bookmark[dest=\hyperget{anchor}{sec}]{section} +</pre> +<!--l. 1418--><p class="nopar" > +<!--l. 1420--><p class="indent" > As <span +class="ec-lmri-10">pageanchor </span>retrieves the page number from the label it can’t be use together with the option +<span +class="ec-lmvtt-10">plainpages</span>. +<!--l. 1423--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-26" class="tabular" + +><colgroup id="TBL-26-1g"><col +id="TBL-26-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-26-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-26-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hyperget</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">currentanchor</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1427--><p class="indent" > This retrieves the last anchor that has been set. It too takes <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\HyperDestNameFilter</span></span></span> into +account. +<!--l. 1431--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-27" class="tabular" + +><colgroup id="TBL-27-1g"><col +id="TBL-27-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-27-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-27-1-1" +class="td11"> <span +class="ec-lmvtt-10">\autoref</span><span class="obeylines-h"><span class="verb"><span +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. 1435--><p class="noindent" >This is a replacement for the usual <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ref</span></span></span> command that places a contextual label in front of the reference. +This gives your users a bigger target to click for hyperlinks (e.g. ‘section 2’ instead of merely the number +‘2’). +<!--l. 1441--><p class="indent" > The label is worked out from the context of the original <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span> command by <span +class="ec-lmss-10">hyperref </span>by using the +macros listed below (shown with their default values). The macros can be (re)defined in documents using +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\(re)newcommand</span></span></span>; note that some of these macros are already defined in the standard document +classes. The mixture of lowercase and uppercase initial letters is deliberate and corresponds to the +author’s practice. +<!--l. 1449--><p class="indent" > For each macro below, <span +class="ec-lmss-10">hyperref </span>checks <span +class="ec-lmvtt-10">\*autorefname </span>before <span +class="ec-lmvtt-10">\*name</span>. For instance, it looks for +<span +class="ec-lmvtt-10">\figureautorefname </span>before <span +class="ec-lmvtt-10">\figurename</span>. +<!--l. 1453--><p class="indent" > +<a + id="x1-22001r12"></a> <!--l. 1454--><div class="longtable"> <table id="TBL-28" class="longtable" + +><colgroup id="TBL-28-1g"><col +id="TBL-28-1"><col +id="TBL-28-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-28-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-1-1" +class="td01"><span +class="ec-lmri-10">Macro </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-1-2" +class="td10"> + <!--l. 1454--><p class="noindent" ><span +class="ec-lmri-10">Default</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-2-1" +class="td01"><span +class="ec-lmvtt-10">\figurename </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-2-2" +class="td10"> + <!--l. 1455--><p class="noindent" >Figure </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-3-1" +class="td01"><span +class="ec-lmvtt-10">\tablename </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-3-2" +class="td10"> + <!--l. 1456--><p class="noindent" >Table </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-4-1" +class="td01"><span +class="ec-lmvtt-10">\partname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-4-2" +class="td10"> + <!--l. 1457--><p class="noindent" >Part </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-5-1" +class="td01"><span +class="ec-lmvtt-10">\appendixname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-5-2" +class="td10"> + <!--l. 1458--><p class="noindent" >Appendix </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-6-1" +class="td01"><span +class="ec-lmvtt-10">\equationname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-6-2" +class="td10"> + <!--l. 1459--><p class="noindent" >Equation </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-7-1" +class="td01"><span +class="ec-lmvtt-10">\Itemname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-7-2" +class="td10"> + <!--l. 1460--><p class="noindent" >item </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-8-1" +class="td01"><span +class="ec-lmvtt-10">\chaptername </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-8-2" +class="td10"> + <!--l. 1461--><p class="noindent" >chapter </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-9-1" +class="td01"><span +class="ec-lmvtt-10">\sectionname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-9-2" +class="td10"> + <!--l. 1462--><p class="noindent" >section </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-10-1" +class="td01"><span +class="ec-lmvtt-10">\subsectionname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-10-2" +class="td10"> + <!--l. 1463--><p class="noindent" >subsection </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-11-1" +class="td01"><span +class="ec-lmvtt-10">\subsubsectionname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-11-2" +class="td10"> + <!--l. 1464--><p class="noindent" >subsubsection </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-12-1" +class="td01"><span +class="ec-lmvtt-10">\paragraphname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-12-2" +class="td10"> + <!--l. 1465--><p class="noindent" >paragraph </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-13-1" +class="td01"><span +class="ec-lmvtt-10">\Hfootnotename </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-13-2" +class="td10"> + <!--l. 1466--><p class="noindent" >footnote </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-28-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-14-1" +class="td01"><span +class="ec-lmvtt-10">\AMSname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-14-2" +class="td10"> + <!--l. 1467--><p class="noindent" >Equation </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-15-1" +class="td01"><span +class="ec-lmvtt-10">\theoremname </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-15-2" +class="td10"> + <!--l. 1468--><p class="noindent" >Theorem </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-16-1" +class="td01"><span +class="ec-lmvtt-10">\page </span></td><td style="white-space:normal; text-align:left;" id="TBL-28-16-2" +class="td10"> + <!--l. 1469--><p class="noindent" >page </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-17-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-18-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-19-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-20-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-28-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-28-21-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-28-21-2" +class="td10"></td></tr> + </table></div> +<!--l. 1472--><p class="indent" > Example for a redefinition if <span +class="ec-lmss-10">babel </span>is used: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-21"> +\usepackage[ngerman]{babel} +\addto\extrasngerman{% +  \def\subsectionautorefname{Unterkapitel}% +} +</pre> + <!--l. 1479--><p class="nopar" ></blockquote> +<!--l. 1482--><p class="indent" > Hint: <span +class="ec-lmvtt-10">\autoref </span>works via the counter name that the reference is based on. Sometimes <span +class="ec-lmvtt-10">\autoref</span> +chooses the wrong name, if the counter is used for different things. For example, it happens with +<span +class="ec-lmvtt-10">\newtheorem </span>if a lemma shares a counter with theorems. Then package <span +class="ec-lmss-10">aliascnt </span>provides a method to +generate a simulated second counter that allows the differentiation between theorems and +lemmas: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-22"> +\documentclass{article} + +\usepackage{aliascnt} +\usepackage{hyperref} + +\newtheorem{theorem}{Theorem} + +\newaliascnt{lemma}{theorem} +\newtheorem{lemma}[lemma]{Lemma} +\aliascntresetthe{lemma} + +\providecommand*{\lemmaautorefname}{Lemma} + +\begin{document} + +We will use \autoref{a} to prove \autoref{b}. + +\begin{lemma}\label{a} +  Nobody knows. +\end{lemma} + +\begin{theorem}\label{b} +  Nobody is right. +\end{theorem}. + +\end{document} +</pre> + <!--l. 1517--><p class="nopar" ></blockquote> +<!--l. 1520--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-29" class="tabular" + +><colgroup id="TBL-29-1g"><col +id="TBL-29-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-29-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-29-1-1" +class="td11"> <span +class="ec-lmvtt-10">\autopageref</span><span class="obeylines-h"><span class="verb"><span +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. 1524--><p class="noindent" >It replaces <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pageref</span></span></span> and adds the name for page in front of the page reference. First <span +class="ec-lmvtt-10">\pageautorefname</span> +is checked before <span +class="ec-lmvtt-10">\pagename</span>. +<!--l. 1529--><p class="indent" > For instances where you want a reference to use the correct counter, but not to create a +link, there are starred forms (these starred forms exist even if hyperref has been loaded with +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">implicit=false</span></span></span>): + + +<!--l. 1533--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-30" class="tabular" + +><colgroup id="TBL-30-1g"><col +id="TBL-30-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-30-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-30-1-1" +class="td11"> <span +class="ec-lmvtt-10">\ref*</span><span class="obeylines-h"><span class="verb"><span +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. 1537--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-31" class="tabular" + +><colgroup id="TBL-31-1g"><col +id="TBL-31-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-31-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-31-1-1" +class="td11"> <span +class="ec-lmvtt-10">\pageref*</span><span class="obeylines-h"><span class="verb"><span +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. 1541--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-32" class="tabular" + +><colgroup id="TBL-32-1g"><col +id="TBL-32-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-32-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-32-1-1" +class="td11"> <span +class="ec-lmvtt-10">\autoref*</span><span class="obeylines-h"><span class="verb"><span +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. 1545--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-33" class="tabular" + +><colgroup id="TBL-33-1g"><col +id="TBL-33-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-33-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-33-1-1" +class="td11"> <span +class="ec-lmvtt-10">\autopageref*</span><span class="obeylines-h"><span class="verb"><span +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. 1549--><p class="indent" > A typical use would be to write + + + <pre class="verbatim" id="verbatim-23"> +\hyperref[other]{that nice section (\ref*{other}) we read before} +</pre> +<!--l. 1552--><p class="nopar" > +<!--l. 1554--><p class="indent" > We want <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ref*{other}</span></span></span> to generate the correct number, but not to form a link, since we do this +ourselves with <span +class="ec-lmvtt-10">\hyperref</span>. +<!--l. 1557--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-34" class="tabular" + +><colgroup id="TBL-34-1g"><col +id="TBL-34-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-34-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-34-1-1" +class="td11"> <span +class="ec-lmvtt-10">\pdfstringdef</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">macroname</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">TeXstring</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1561--><p class="indent" > <span +class="ec-lmvtt-10">\pdfstringdef </span>returns a macro containing the PDF string. (Currently this is done globally, but do not +rely on it.) All the following tasks, definitions and redefinitions are made in a group to keep them +local: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 1566--><p class="noindent" >Switching to PD1 or PU encoding + </li> + <li class="itemize"> + <!--l. 1567--><p class="noindent" >Defining the “octal sequence commands” (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\345</span></span></span>): <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\edef\3{\string\3}</span></span></span> + </li> + <li class="itemize"> + <!--l. 1568--><p class="noindent" >Special glyphs of TeX: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\{</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\%</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\&</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\space</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\dots</span></span></span>, etc. + </li> + <li class="itemize"> + <!--l. 1569--><p class="noindent" >National glyphs (<span +class="ec-lmss-10">german.sty</span>, <span +class="ec-lmss-10">french.sty</span>, etc.) + </li> + <li class="itemize"> + <!--l. 1570--><p class="noindent" >Logos: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\TeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\eTeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\MF</span></span></span>, etc. + </li> + <li class="itemize"> + <!--l. 1571--><p class="noindent" >Disabling commands that do not provide useful functionality in bookmarks: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\index</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\glossary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\discretionary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\def</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\let</span></span></span>, etc. + </li> + <li class="itemize"> + <!--l. 1573--><p class="noindent" >LaTeX’s font commands like <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textbf</span></span></span>, etc. + </li> + <li class="itemize"> + <!--l. 1574--><p class="noindent" >Support for <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\xspace</span></span></span> provided by the <span +class="ec-lmss-10">xspace </span>package</li></ul> + + +<!--l. 1577--><p class="indent" > In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in +the PDF string. For further details, see Heiko Oberdiek’s EuroTeX paper distributed with +<span +class="ec-lmss-10">hyperref</span>. +<!--l. 1581--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-35" class="tabular" + +><colgroup id="TBL-35-1g"><col +id="TBL-35-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-35-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-35-1-1" +class="td11"> <span +class="ec-lmvtt-10">\begin</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{NoHyper}</span></span></span>…<span +class="ec-lmvtt-10">\end</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{NoHyper}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1584--><p class="indent" > Sometimes we just don’t want the wretched package interfering with us. Define an environment we +can put in manually, or include in a style file, which stops the hypertext functions doing anything. +This is used, for instance, in the Elsevier classes, to stop <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperref</span></span></span> playing havoc in the front +matter. +<!--l. 1590--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a + id="x1-230006.1"></a>Bookmark macros</h4> +<!--l. 1592--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">6.1.1 </span> <a + id="x1-240006.1.1"></a>Setting bookmarks</h5> +<!--l. 1594--><p class="noindent" >Usually <span +class="ec-lmss-10">hyperref </span>automatically adds bookmarks for <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\section</span></span></span> and similar macros. But they can also set +manually. +<!--l. 1597--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-36" class="tabular" + +><colgroup id="TBL-36-1g"><col +id="TBL-36-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-36-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-36-1-1" +class="td11"> <span +class="ec-lmvtt-10">\pdfbookmark</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">level</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">]{</span></span></span>text<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1600--><p class="indent" > creates a bookmark with the specified text and at the given level (default is 0). As name for the +internal anchor name is used (in conjunction with level). Therefore the name must be unique (similar to +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span>). +<!--l. 1604--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-37" class="tabular" + +><colgroup id="TBL-37-1g"><col +id="TBL-37-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-37-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-37-1-1" +class="td11"> <span +class="ec-lmvtt-10">\currentpdfbookmark</span><span class="obeylines-h"><span class="verb"><span +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><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1607--><p class="indent" > creates a bookmark at the current level. +<!--l. 1609--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-38" class="tabular" + +><colgroup id="TBL-38-1g"><col +id="TBL-38-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-38-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-38-1-1" +class="td11"> <span +class="ec-lmvtt-10">\subpdfbookmark</span><span class="obeylines-h"><span class="verb"><span +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><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1612--><p class="indent" > creates a bookmark one step down in the bookmark hierarchy. Internally the current level is increased +by one. +<!--l. 1615--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-39" class="tabular" + +><colgroup id="TBL-39-1g"><col +id="TBL-39-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-39-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-1-1" +class="td11"> <span +class="ec-lmvtt-10">\belowpdfbookmark</span><span class="obeylines-h"><span class="verb"><span +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><span +class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1618--><p class="indent" > creates a bookmark below the current bookmark level. However after the command the current +bookmark level has not changed. +<!--l. 1621--><p class="noindent" ><span +class="ec-lmbx-10">Hint: </span>Package <span +class="ec-lmss-10">bookmark </span>replaces <span +class="ec-lmss-10">hyperref</span>’s bookmark organization by a new algorithm: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 1624--><p class="noindent" >Usually only one LaTeX run is needed. + </li> + <li class="itemize"> + <!--l. 1625--><p class="noindent" >More control over the bookmark appearance (color, font). + + + </li> + <li class="itemize"> + <!--l. 1626--><p class="noindent" >Different bookmark actions are supported (external file links, URLs, …).</li></ul> +<!--l. 1629--><p class="noindent" >Therefore I recommend using this package. +<!--l. 1631--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">6.1.2 </span> <a + id="x1-250006.1.2"></a>Replacement macros</h5> +<!--l. 1633--><p class="noindent" ><span +class="ec-lmss-10">hyperref </span>takes the text for bookmarks from the arguments of commands like <span +class="ec-lmvtt-10">\section</span>, which can +contain things like math, colors, or font changes, none of which will display in bookmarks as +is. +<!--l. 1637--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-40" class="tabular" + +><colgroup id="TBL-40-1g"><col +id="TBL-40-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-40-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-1-1" +class="td11"> <span +class="ec-lmvtt-10">\texorpdfstring</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">TeXstring</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">PDFstring</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1641--><p class="indent" > For example, + + + <pre class="verbatim" id="verbatim-24"> +\section{Pythagoras: +  \texorpdfstring{$ a^2 + b^2 = c^2 $}{% +    a\texttwosuperior\ + b\texttwosuperior\ = +    c\texttwosuperior +  }% +} +\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars} +</pre> +<!--l. 1650--><p class="nopar" > +<!--l. 1652--><p class="indent" > <span +class="ec-lmvtt-10">\pdfstringdef </span>executes the hook before it expands the string. Therefore, you can use this hook to +perform additional tasks or to disable additional commands. + + + <pre class="verbatim" id="verbatim-25"> +\expandafter\def\expandafter\pdfstringdefPreHook +\expandafter{% +  \pdfstringdefPreHook +  \renewcommand{\mycommand}[1]{}% +} +</pre> +<!--l. 1662--><p class="nopar" > +<!--l. 1664--><p class="indent" > However, for disabling commands, an easier way is via <span +class="ec-lmvtt-10">\pdfstringdefDisableCommands</span>, which adds +its argument to the definition of <span +class="ec-lmvtt-10">\pdfstringdefPreHook </span>(‘@’ can here be used as letter in command +names): + + + <pre class="verbatim" id="verbatim-26"> +\pdfstringdefDisableCommands{% +  \let~\textasciitilde +  \def\url{\pdfstringdefWarn\url}% +  \let\textcolor\@gobble +} +</pre> +<!--l. 1675--><p class="nopar" > +<!--l. 1677--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a + id="x1-260006.2"></a>Pagelabels</h4> +<!--l. 1678--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-41" class="tabular" + +><colgroup id="TBL-41-1g"><col +id="TBL-41-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-41-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-41-1-1" +class="td11"> <span +class="ec-lmvtt-10">\thispdfpagelabel</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">page number format</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1682--><p class="noindent" >This allows to change format of the page number shown in the tool bar of a PDF viewer for a specific +page, for example +<!--l. 1685--><p class="indent" > <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\thispdfpagelabel{Empty</span><span +class="ec-lmvtt-10"> Page-\roman{page}}</span></span></span> +<!--l. 1687--><p class="indent" > The command affects the page on which it is executed, so asynchronous page breaking should be +taken into account. It should be used in places where for example <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\thispagestyle</span></span></span> can be use +too. +<!--l. 1690--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.3 </span> <a + id="x1-270006.3"></a>Utility macros</h4> +<!--l. 1693--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-42" class="tabular" + +><colgroup id="TBL-42-1g"><col +id="TBL-42-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-42-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-42-1-1" +class="td11"> <span +class="ec-lmvtt-10">\hypercalcbp</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">dimen specification</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1696--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypercalcbp</span></span></span> takes a TeX dimen specification and converts it to bp and returns the number +without the unit. This is useful for options <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pdfview</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pdfstartview</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pdfremotestartview</span></span></span>. +Example: + <blockquote class="quote"> + + + <pre class="verbatim" id="verbatim-27"> +\hypersetup{ +  pdfstartview={FitBH \hypercalcbp{\paperheight-\topmargin-1in +    -\headheight-\headsep} +} +</pre> + <!--l. 1708--><p class="nopar" ></blockquote> +<!--l. 1710--><p class="noindent" >The origin of the PDF coordinate system is the lower left corner. +<!--l. 1712--><p class="indent" > Note, for calculations you need either package <span +class="ec-lmss-10">calc </span>or <span +class="lmmi-10">ε</span>-<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span>. Nowadays the latter should +automatically be enabled for <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> formats. Users without <span +class="lmmi-10">ε</span>-<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span>, please, look in the source +documentation <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperref.dtx</span></span></span> for further limitations. +<!--l. 1718--><p class="indent" > Also <span +class="ec-lmvtt-10">\hypercalcbp </span>cannot be used in option specifications of <span +class="ec-lmvtt-10">\documentclass </span>and <span +class="ec-lmvtt-10">\usepackage</span>, +because <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> expands the option lists of these commands. However package <span +class="ec-lmss-10">hyperref </span>is not yet loaded +and an undefined control sequence error would arise. +<!--l. 1725--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-280007"></a>New Features<span class="footnote-mark"><a +href="hyperref-doc6.html#fn5x0"><sup class="textsuperscript">5</sup></a></span><a + id="x1-28001f5"></a> </h3> + <h4 class="subsectionHead"><span class="titlemark">7.1 </span> <a + id="x1-290007.1"></a>Option ‘pdflinkmargin’</h4> +<!--l. 1730--><p class="noindent" >Option ‘pdflinkmargin’ is an experimental option for specifying a link margin, if the driver supports this. +Default is 1 pt for supporting drivers. +<!--l. 1735--><p class="indent" > + <dl class="description"><dt class="description"> + <!--l. 1736--><p class="noindent" > +<span +class="ec-lmbx-10">pdfTeX</span> </dt><dd +class="description"> + <!--l. 1736--><p class="noindent" > + <ul class="itemize1"> + <li class="itemize"> + <!--l. 1738--><p class="noindent" >The link area also depends on the surrounding box. + </li> + <li class="itemize"> + <!--l. 1739--><p class="noindent" >Settings have local effect. + </li> + <li class="itemize"> + <!--l. 1740--><p class="noindent" >When a page is shipped out, pdfTeX uses the current setting of the link margin for all + links on the page.</li></ul> + </dd><dt class="description"> + <!--l. 1744--><p class="noindent" > +<span +class="ec-lmbx-10">pdfmark</span> </dt><dd +class="description"> + <!--l. 1744--><p class="noindent" > + + <ul class="itemize1"> + <li class="itemize"> + <!--l. 1746--><p class="noindent" >Settings have global effect.</li></ul> + </dd><dt class="description"> + <!--l. 1749--><p class="noindent" > +<span +class="ec-lmbx-10">xetex</span> </dt><dd +class="description"> + <!--l. 1749--><p class="noindent" > + <ul class="itemize1"> + <li class="itemize"> + <!--l. 1751--><p class="noindent" >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"> g</span><span +class="ec-lmvtt-10"> #1}</span></span></span> (with + the unit removed).</li></ul> + </dd><dt class="description"> + <!--l. 1755--><p class="noindent" > +<span +class="ec-lmbx-10">Other drivers</span> </dt><dd +class="description"> + <!--l. 1755--><p class="noindent" >Unsupported.</dd></dl> +<!--l. 1760--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a + id="x1-300007.2"></a>Field option ‘calculatesortkey’</h4> +<!--l. 1762--><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 ‘calculatesortkey’. 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. 1772--><p class="indent" > Currently the field option ‘calculatesortkey’ is only supported by the driver for pdfTeX. +<!--l. 1775--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.3 </span> <a + id="x1-310007.3"></a>Option ‘next-anchor’</h4> +<!--l. 1776--><p class="noindent" >This option allows to overwrite the anchor name of the next anchor. This makes it possible to give for +example the heading of the table of contents an anchor name which can be referenced with a bookmark +command. + + + <pre class="verbatim" id="verbatim-28"> +\hypersetup{next-anchor=toc} +\tableofcontents +\bookmark[dest=\HyperDestNameFilter{toc},level=section]{\contentsname} +</pre> +<!--l. 1784--><p class="nopar" > +<!--l. 1786--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.4 </span> <a + id="x1-320007.4"></a>Option ‘localanchorname’</h4> +<!--l. 1788--><p class="noindent" >When<span class="marginpar">Deprecated 2022-04-27 v7.00o</span> 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. 1792--><p class="indent" > For example: + + + <pre class="verbatim" id="verbatim-29"> +    \section{Foobar} +    \begin{equation}\end{equation} +    \label{sec:foobar} +</pre> +<!--l. 1797--><p class="nopar" > With the default global setting (localanchorname=false) a reference to ‘sec:foobar’ jumps to the +equation before. With option ‘localanchorname’ the anchor of the equation is forgotten after the +environment and the reference ‘sec:foobar’ jumps to the section title. +<!--l. 1805--><p class="indent" > Option ‘localanchorname’ is an experimental option, there might be situations, where the anchor +name is not available as expected. +<!--l. 1809--><p class="indent" > The option is deprecated: it makes it difficult for package authors to add targets for links if it is +unclear if <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@currentHref</span></span></span> is set locally or globally. +<!--l. 1813--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.5 </span> <a + id="x1-330007.5"></a>Option ‘customdriver’</h4> +<!--l. 1815--><p class="noindent" >The value of option ‘customdriver’ is the name of an external driver file without extension ‘.def’. 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 ‘hyperref’, +otherwise a warning is given. +<!--l. 1820--><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. 1825--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.6 </span> <a + id="x1-340007.6"></a>Option ‘psdextra’</h4> +<!--l. 1827--><p class="noindent" >LaTeX’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, +therefore they are defined with prefix ‘text’ (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textgeq</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textnotin</span></span></span>, ...). They can be mapped to short +names during the processing to PDF strings. The disadvantage is that they are many hundreds macros +that need to be redefined for each PDF string conversion. Therefore this can be enabled or disabled +as option ‘psdextra’. On default the option is turned off (set to ‘false’). Turning the option +on means that the short names are available. Then <span class="obeylines-h"><span class="verb"><span +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. 1841--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.7 </span> <a + id="x1-350007.7"></a>\XeTeXLinkBox</h4> +<!--l. 1843--><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. 1852--><p class="indent" > Example: + + + <pre class="verbatim" id="verbatim-30"> +    % xelatex +    \documentclass{article} +    \usepackage{hyperref} +    \setlength{\XeTeXLinkMargin}{1pt} +    \begin{document} +    \section{Hello World} +    \newpage +    \label{sec:hello} +    \hyperref[sec:hello]{% +      \XeTeXLinkBox{\rule{10mm}{10mm}}% +    } +    \end{document} +</pre> +<!--l. 1868--><p class="nopar" > +<!--l. 1870--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.8 </span> <a + id="x1-360007.8"></a>\IfHyperBooleanExists and \IfHyperBoolean</h4> + + + <pre class="verbatim" id="verbatim-31"> + \IfHyperBooleanExists{OPTION}{YES}{NO} +</pre> +<!--l. 1873--><p class="nopar" > If a hyperref OPTION is a boolean, that means it takes values ‘true’ or ‘false’, then <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\IfHyperBooleanExists</span></span></span> +calls YES, otherwise NO. + + + <pre class="verbatim" id="verbatim-32"> + \IfHyperBoolean{OPTION}{YES}{NO} +</pre> +<!--l. 1880--><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. 1886--><p class="indent" > Both macros are expandable. Additionally option ‘stoppedearly’ 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. 1891--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.9 </span> <a + id="x1-370007.9"></a>\unichar</h4> +<!--l. 1893--><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 ‘ucs’. However it is defined independently for use in +hyperref’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. 1901--><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): + + + <pre class="verbatim" id="verbatim-33"> +    \unichar{"263A}% hexadecimal notation +    \unichar{9786}% decimal notation +</pre> +<!--l. 1906--><p class="nopar" > ‘"’ 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>: + + + <pre class="verbatim" id="verbatim-34"> +    \unichar{\string"263A}% converts ‘"’ to ‘"’ with catcode 12 (other) +</pre> +<!--l. 1911--><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: + + + <pre class="verbatim" id="verbatim-35"> +    \unichar{\dq 263A}% \dq is double quote with catcode 12 (other) +</pre> +<!--l. 1915--><p class="nopar" > +<!--l. 1918--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.10 </span> <a + id="x1-380007.10"></a>\ifpdfstringunicode</h4> +<!--l. 1920--><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 ‘PDFDocEncoding’ (8-bit encoding) +and ‘Unicode’ (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 +by a representation for the PDF string. However <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring</span></span></span> does not distinguish the two encodings. +This gap closes <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ifpdfstringunicode</span></span></span>. It is only allowed in the second argument of <span class="obeylines-h"><span class="verb"><span +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. 1934--><p class="indent" > As example we take a macro definition for the Vietnamese name of Hàn Thế Thành. Correctly written +it needs some accented characters, one character even with a double accent. Class ‘tugboat.cls’ defines a +macro for the typesetted name: + + + <pre class="verbatim" id="verbatim-36"> +    \def\Thanh{% +      H\‘an~% +      Th\^e\llap{\raise 0.5ex\hbox{\’{}}}% +      ~Th\‘anh% +    } +</pre> +<!--l. 1944--><p class="nopar" > It’s not entirely correct, the second accent over the ‘e’ is not an acute, but a hook. However standard +LaTeX does not provide such an accent. +<!--l. 1949--><p class="indent" > Now we can extend the definition 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 +class="ec-lmvtt-10">\unichar</span></span></span>. The character in question +is: + + + <pre class="verbatim" id="verbatim-37"> +    % U+1EC3 LATIN SMALL LETTER E WITH CIRCUMFLEX AND HOOK ABOVE +</pre> +<!--l. 1958--><p class="nopar" > Thus we can put this together: + + + <pre class="verbatim" id="verbatim-38"> +    \def\Thanh{% +      H\‘an~% +      \texorpdfstring{Th\^e\llap{\raise 0.5ex\hbox{\’{}}}}% +      {\ifpdfstringunicode{Th\unichar{"1EC3}}{Th\^e}}% +      ~Th\‘anh% +    } +</pre> +<!--l. 1967--><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: + + + <pre class="verbatim" id="verbatim-39"> +    \def\Thanh{% +      \texorpdfstring{% +        H\‘an~% +        Th\^e\llap{\raise 0.5ex\hbox{\’{}}}}% +        ~Th\‘anh% +      }{% +        \ifpdfstringunicode{% +          H\‘an Th\unichar{"1EC3} Th\‘anh% +        }{% +          Han The Thanh% +        }% +      }% +    } +</pre> +<!--l. 1985--><p class="nopar" > +<!--l. 1987--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.11 </span> <a + id="x1-390007.11"></a>Customizing index style file with \nohyperpage</h4> +<!--l. 1989--><p class="noindent" >Since version 2008/08/14 v6.78f. +<!--l. 1993--><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 +lists. However, only the standard settings are supported directly: + + + <pre class="verbatim" id="verbatim-40"> +    delim_r "--" +    delim_n ", " +</pre> +<!--l. 2000--><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"> delim_n,</span><span +class="ec-lmvtt-10"> suffix_2p,</span><span +class="ec-lmvtt-10"> suffix_3p,</span><span +class="ec-lmvtt-10"> suffix_mp</span></span></span> needs +markup that <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> can detect and knows that this stuff does not belong to a page number. Makro +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\nohyperpage</span></span></span> serves as this markup. Put the customized code for these keys inside <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\nohyperpage</span></span></span>, +e.g.: + + + <pre class="verbatim" id="verbatim-41"> +    suffix_2p "\\nohyperpage{f.}" +    suffix_3p "\\nohyperpage{ff.}" +</pre> +<!--l. 2012--><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. 2017--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.12 </span> <a + id="x1-400007.12"></a>Experimental option ‘ocgcolorlinks’</h4> +<!--l. 2019--><p class="noindent" >The idea are colored links, when viewed, but printed without colors. This new experimental option +‘ocgcolorlinks’ uses Optional Content Groups, a feature introduced in PDF 1.5. +<!--l. 2023--><p class="indent" > A better implementation which hasn’t the disadvantage to prevent line breaks is in the ocgx2 +package. Check its documentation for details how to use it. + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2026--><p class="noindent" >The option must be given for package loading: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\usepackage[ocgcolorlinks]{hyperref}</span></span></span> + </li> + <li class="itemize"> + <!--l. 2028--><p class="noindent" >Main disadvantage: Links cannot be broken across lines. PDF reference 1.7: 4.10.2 “Making + Graphical Content Optional”: Graphics state operations, such as setting the color, ..., are + still applied. Therefore the link text is put in a box and set twice, with and without color. + </li> + <li class="itemize"> + <!--l. 2034--><p class="noindent" >The feature can be switched of by <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypersetup{ocgcolorlinks=false}</span></span></span> inside the document. + </li> + <li class="itemize"> + <!--l. 2036--><p class="noindent" >Supported drivers: pdftex, dvipdfm + </li> + <li class="itemize"> + <!--l. 2037--><p class="noindent" >The PDF version should be at least 1.5. It is automatically set for pdfTeX, LuaTeX and + dvipdfmx.</li></ul> +<!--l. 2041--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.13 </span> <a + id="x1-410007.13"></a>Option ‘pdfa’</h4> +<!--l. 2043--><p class="noindent" >The new option ‘pdfa’ 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’t controlled by hyperref (XMP metadata, +fonts, colors, driver dependend low level stuff, ...). +<!--l. 2050--><p class="indent" > Currently, option ‘pdfa’ sets and disables the following items: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2052--><p class="noindent" >Enabled annotation flags: Print, NoZoom, NoRotate [PDF/A 6.5.3]. + + </li> + <li class="itemize"> + <!--l. 2053--><p class="noindent" >Disabled annotation flags: Hidden, Invisible, NoView [PDF/A 6.5.3]. + </li> + <li class="itemize"> + <!--l. 2054--><p class="noindent" >Disabled: Launch action (<a +href="run:..." >[</a>PDF/A 6.6.1]. + </li> + <li class="itemize"> + <!--l. 2055--><p class="noindent" >Restricted: Named actions (NextPage, PrevPage, FirstPage, LastPage) [PDF/A 6.6.1]. + </li> + <li class="itemize"> + <!--l. 2057--><p class="noindent" >Many things are disabled in PDF formulars: + <ul class="itemize2"> + <li class="itemize"> + <!--l. 2059--><p class="noindent" >JavaScript actions [PDF/A 6.6.1] + </li> + <li class="itemize"> + <!--l. 2060--><p class="noindent" >Trigger events (additional actions) [PDF/A 6.6.2] + </li> + <li class="itemize"> + <!--l. 2061--><p class="noindent" >Push button (because of JavaScript) + </li> + <li class="itemize"> + <!--l. 2062--><p class="noindent" >Interactive Forms: Flag NeedAppearances is the default ‘false’ (Because of this, + hyperref’s implementation of Forms looks ugly). [PDF/A 6.9]</li></ul> + </li></ul> +<!--l. 2070--><p class="indent" > The default value of the new option ‘pdfa’ is ‘false’. 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. 2076--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.14 </span> <a + id="x1-420007.14"></a>Option ‘linktoc’ added</h4> +<!--l. 2078--><p class="noindent" >The new option ‘linktoc’ allows more control which part of an entry in the table of contents is made into +a link: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2081--><p class="noindent" >‘linktoc=none’ (no links) + </li> + <li class="itemize"> + <!--l. 2082--><p class="noindent" >‘linktoc=section’ (default behaviour, same as ‘linktocpage=false’) + </li> + <li class="itemize"> + <!--l. 2083--><p class="noindent" >‘linktoc=page’ (same as ‘linktocpage=true’) + + </li> + <li class="itemize"> + <!--l. 2084--><p class="noindent" >‘linktoc=all’ (both the section and page part are links)</li></ul> +<!--l. 2087--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.15 </span> <a + id="x1-430007.15"></a>Option ‘pdfnewwindow’ changed</h4> +<!--l. 2089--><p class="noindent" >Before 6.77b: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2091--><p class="noindent" >pdfnewwindow=true <span +class="lmsy-10">→ </span>/NewWindow true + </li> + <li class="itemize"> + <!--l. 2092--><p class="noindent" >pdfnewwindow=false <span +class="lmsy-10">→ </span>(absent) + </li> + <li class="itemize"> + <!--l. 2093--><p class="noindent" >unused pdfnewwindow <span +class="lmsy-10">→ </span>(absent)</li></ul> +<!--l. 2095--><p class="noindent" >Since 6.77b: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2097--><p class="noindent" >pdfnewwindow=true <span +class="lmsy-10">→ </span>/NewWindow true + </li> + <li class="itemize"> + <!--l. 2098--><p class="noindent" >pdfnewwindow=false <span +class="lmsy-10">→ </span>/NewWindow false + </li> + <li class="itemize"> + <!--l. 2099--><p class="noindent" >pdfnewwindow= <span +class="lmsy-10">→ </span>(absent) + </li> + <li class="itemize"> + <!--l. 2100--><p class="noindent" >unused pdfnewwindow <span +class="lmsy-10">→ </span>(absent)</li></ul> +<!--l. 2105--><p class="indent" > Rationale: There is a difference between setting to ‘false’ 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. 2111--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.16 </span> <a + id="x1-440007.16"></a>Flag options for PDF forms</h4> +<!--l. 2113--><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. 2117--><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. 2119--><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. 2121--><p class="indent" > Options (convert to lowercase) except flags in square brackets: + + + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2124--><p class="noindent" >Table 8.16 Annotation flags (page 608): + <!--l. 2126--><p class="noindent" ><div class="obeylines-v"> + <br />1 Invisible + <br />2 Hidden (PDF 1.2) + <br />3 Print (PDF 1.2) + <br />4 NoZoom (PDF 1.3) + <br />5 NoRotate (PDF 1.3) + <br />6 NoView (PDF 1.3) + <br />[7 ReadOnly (PDF 1.3)] ignored for widget annotations, see table 8.70 + <br />8 Locked (PDF 1.4) + <br />9 ToggleNoView (PDF 1.5) + <br />10 LockedContents (PDF 1.7)</div> + </li> + <li class="itemize"> + <!--l. 2138--><p class="noindent" >Table 8.70 Field flags common to all field types (page 676): + <!--l. 2140--><p class="noindent" ><div class="obeylines-v"> + <br />1 ReadOnly + <br />2 Required + <br />3 NoExport</div> + </li> + <li class="itemize"> + <!--l. 2145--><p class="noindent" >Table 8.75 Field flags specific to button fields (page 686): + <!--l. 2147--><p class="noindent" ><div class="obeylines-v"> + <br />15 NoToggleToOff (Radio buttons only) + <br />16 Radio (set: radio buttons, clear: check box, pushbutton: clear) + <br />17 Pushbutton + <br />26 RadiosInUniso (PDF 1.5)</div> + </li> + <li class="itemize"> + <!--l. 2153--><p class="noindent" >Table 8.77 Field flags specific to text fields (page 691): + <!--l. 2155--><p class="noindent" ><div class="obeylines-v"> + <br />13 Multiline + <br />14 Password + <br />21 FileSelect (PDF 1.4) + <br />23 DoNotSpellCheck (PDF 1.4) + <br />24 DoNotScroll (PDF 1.4) + <br />25 Comb (PDF 1.5) + <br />26 RichText (PDF 1.5)</div> + + </li> + <li class="itemize"> + <!--l. 2164--><p class="noindent" >Table 8.79 Field flags specific to choice fields (page 693): + <!--l. 2166--><p class="noindent" ><div class="obeylines-v"> + <br />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 + <br />22 MultiSelect (PDF 1.4) + <br />23 DoNotSpellCheck (PDF 1.4) (only useful if Combo and Edit are set) + <br />27 CommitOnSelChange (PDF 1.5)</div> + </li> + <li class="itemize"> + <!--l. 2174--><p class="noindent" >Table 8.86 Flags for submit-form actions (page 704): + <!--l. 2176--><p class="noindent" ><div class="obeylines-v"> + <br />[1 Include/Exclude] unsupported, use ‘noexport’ (table 8.70) instead + <br />2 IncludeNoValueFields + <br />[3 ExportFormat] handled by option ‘export’ + <br />4 GetMethod + <br />5 SubmitCoordinates + <br />[6 XFDF (PDF 1.4)] handled by option ‘export’ + <br />7 IncludeAppendSaves (PDF 1.4) + <br />8 IncludeAnnotations (PDF 1.4) + <br />[9 SubmitPDF (PDF 1.4)] handled by option ‘export’ + <br />10 CanonicalFormat (PDF 1.4) + <br />11 ExclNonUserAnnots (PDF 1.4) + <br />12 ExclFKey (PDF 1.4) + <br />14 EmbedForm (PDF 1.5)</div> + </li></ul> +<!--l. 2193--><p class="indent" > New option ‘export’ sets the export format of a submit action. Valid values are (upper- or +lowercase): + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2196--><p class="noindent" >FDF + </li> + <li class="itemize"> + <!--l. 2197--><p class="noindent" >HTML + </li> + <li class="itemize"> + <!--l. 2198--><p class="noindent" >XFDF + + + </li> + <li class="itemize"> + <!--l. 2199--><p class="noindent" >PDF (not supported by Acrobat Reader)</li></ul> +<!--l. 2202--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.17 </span> <a + id="x1-450007.17"></a>Option ‘pdfversion’</h4> +<!--l. 2204--><p class="noindent" >This is an experimental option. It notifies ‘hyperref’ 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. 2210--><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. 2215--><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. 2218--><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"> + <!--l. 2221--><p class="noindent" >pdfTeX below 1.10a: unsupported. pdfTeX <span +class="lmsy-10">≥ </span>1.10a and < 1.30: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfoptionpdfminorversion</span></span></span> + pdfTeX <span +class="lmsy-10">≥ </span>1.30: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfminorversion</span></span></span> + </li> + <li class="itemize"> + <!--l. 2224--><p class="noindent" >dvipdfm: configuration file, example: TeX Live 2007, texmf/dvipdfm/config/config, entry ‘V + 2’. + </li> + <li class="itemize"> + <!--l. 2226--><p class="noindent" >dvipdfmx: configuration file, example: TeX Live 2007, texmf/dvipdfm/dvipdfmx.cfg, entry + ‘V 4’. + </li> + <li class="itemize"> + <!--l. 2228--><p class="noindent" >Ghostscript: option -dCompatibilityLevel (this is set in ‘ps2pdf12’, ‘ps2pdf13’, ‘ps2pdf14’).</li></ul> +<!--l. 2233--><p class="indent" > The current PDF version is used as default if this version can be detected (only pdfTeX <span +class="lmsy-10">≥ </span>1.10a). +Otherwise the lowest version 1.2 is assumed. Thus ‘hyperref’ tries to avoid PDF code that breaks this +version, but is free to use ignorable higher PDF features. +<!--l. 2240--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.18 </span> <a + id="x1-460007.18"></a>Field option ‘name’</h4> +<!--l. 2242--><p class="noindent" >Many form objects uses the label argument for several purposes: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2245--><p class="noindent" >Layouted label. + </li> + <li class="itemize"> + <!--l. 2246--><p class="noindent" >As name in HTML structures.</li></ul> +<!--l. 2248--><p class="noindent" >Code that is suitable for layouting with TeX can break in the structures of the output format. If option +‘name’ is given, then its value is used as name in the different output structures. Thus the value should +consist of letters only. + + +<!--l. 2255--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.19 </span> <a + id="x1-470007.19"></a>Option ‘pdfencoding’</h4> +<!--l. 2257--><p class="noindent" >The PDF format allows two encodings for bookmarks and entries in the information dictionary: +PDFDocEncoding and Unicode as UTF-16BE. Option <span +class="ec-lmss-10">pdfencoding </span>selects between these +encodings: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2261--><p class="noindent" ><span +class="ec-lmss-10">pdfdoc </span>uses PDFDocEncoding. It uses just one byte per character, but the supported + characters are limited (244 in PDF-1.7). + </li> + <li class="itemize"> + <!--l. 2263--><p class="noindent" ><span +class="ec-lmss-10">unicode </span>sets Unicode. It is encoded as UTF-16BE. Two bytes are used for most characters, + surrogates need four bytes. + </li> + <li class="itemize"> + <!--l. 2265--><p class="noindent" ><span +class="ec-lmss-10">auto </span>PDFDocEncoding if the string does not contain characters outside the encoding (outside + ascii if an unicode engine is used) and Unicode otherwise. This option is not intended for + the unicode engines.</li></ul> +<!--l. 2270--><p class="indent" > All drivers use <span +class="ec-lmss-10">unicode </span>by default now. If another encoding should be forced, it should be done in +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hypersetup</span></span></span>. +<!--l. 2273--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.20 </span> <a + id="x1-480007.20"></a>Color options/package hycolor</h4> +<!--l. 2275--><p class="noindent" >See documentation of package ‘hycolor’. +<!--l. 2278--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.21 </span> <a + id="x1-490007.21"></a>Option pdfusetitle</h4> +<!--l. 2280--><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. 2286--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.22 </span> <a + id="x1-500007.22"></a>Starred form of \autoref</h4> +<!--l. 2288--><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. 2291--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.23 </span> <a + id="x1-510007.23"></a>Link border style</h4> +<!--l. 2293--><p class="noindent" >Links can be underlined instead of the default rectangle or options <span +class="ec-lmss-10">colorlinks</span>, <span +class="ec-lmss-10">frenchlinks</span>. 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"> 1}</span></span></span> +<!--l. 2297--><p class="indent" > Some remarks: + + + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2300--><p class="noindent" >AR7/Linux seems to have a bug, that don’t use the default value <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">1</span></span></span> for the width, but zero, + thus that the underline is not visible without <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">/W</span><span +class="ec-lmvtt-10"> 1</span></span></span>. The same applies for dashed boxes, eg.: + pdfborderstyle=/S/D/D[3 2]/W 1 + </li> + <li class="itemize"> + <!--l. 2306--><p class="noindent" >The syntax is described in the PDF specification, look for “border style”, eg. Table 8.13 + “Entries in a border style dictionary” (specification for version 1.6) + </li> + <li class="itemize"> + <!--l. 2311--><p class="noindent" >The border style is removed by pdfborderstyle= This is automatically done if option + colorlinks is enabled. + </li> + <li class="itemize"> + <!--l. 2315--><p class="noindent" >Be aware that not all PDF viewers support this feature, not even Acrobat Reader itself: + <!--l. 2318--><p class="noindent" >Some support: + <ul class="itemize2"> + <li class="itemize"> + <!--l. 2320--><p class="noindent" >AR7/Linux: <span +class="ec-lmss-10">underline </span>and <span +class="ec-lmss-10">dashed</span>, but the border width must be given. + </li> + <li class="itemize"> + <!--l. 2322--><p class="noindent" >xpdf 3.00: <span +class="ec-lmss-10">underline </span>and <span +class="ec-lmss-10">dashed</span></li></ul> + <!--l. 2325--><p class="noindent" >Unsupported: + <ul class="itemize2"> + <li class="itemize"> + <!--l. 2327--><p class="noindent" >AR5/Linux + </li> + <li class="itemize"> + <!--l. 2328--><p class="noindent" >ghostscript 8.50</li></ul> + </li></ul> +<!--l. 2332--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.24 </span> <a + id="x1-520007.24"></a>Option <span +class="ec-lmss-10">bookmarksdepth</span></h4> +<!--l. 2334--><p class="noindent" >The depth of the bookmarks can be controlled by the new option <span +class="ec-lmss-10">bookmarksdepth</span>. The option acts +globally and distinguishes three cases: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2338--><p class="noindent" ><span +class="ec-lmss-10">bookmarksdepth </span>without value Then hyperref uses the current value of counter <span +class="ec-lmss-10">tocdepth</span>. + This is the compatible behaviour and the default. + + + </li> + <li class="itemize"> + <!--l. 2341--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">bookmarksdepth=<number></span></span></span>, the value is number (also negative): The depth for the + bookmarks are set to this number. + </li> + <li class="itemize"> + <!--l. 2343--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">bookmarksdepth=<name></span></span></span> The <name> is a document division name (part, chapter, ...). It must + not start with a digit or minus to avoid mixing up with the number case. Internally hyperref uses + the value of macro <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\toclevel@<name></span></span></span>. Examples: + + + <pre class="verbatim" id="verbatim-42"> +     \hypersetup{bookmarksdepth=paragraph} +     \hypersetup{bookmarksdepth=4} % same as before +     \hypersetup{bookmarksdepth} % counter "tocdepth" is used +</pre> + <!--l. 2353--><p class="nopar" ></li></ul> +<!--l. 2356--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.25 </span> <a + id="x1-530007.25"></a>Option <span +class="ec-lmss-10">pdfescapeform</span></h4> +<!--l. 2358--><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. 2370--><p class="indent" > Therefore a new option pdfescapeform was introduced: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2372--><p class="noindent" >pdfescapeform=false Escaping for the formulars are disabled, this is the compatibility + behaviour, therefore this is the default. + </li> + <li class="itemize"> + <!--l. 2375--><p class="noindent" >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. 2383--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.26 </span> <a + id="x1-540007.26"></a>Default driver setting</h4> +<!--l. 2385--><p class="noindent" >(hyperref <span +class="lmsy-10">≥ </span>6.72s) If no driver is given, hyperref tries its best to guess the most suitable +driver. Thus it loads <span +class="ec-lmss-10">hpdftex</span>, if pdfTeX is detected running in PDF mode. Or it loads the +corresponding VTeX driver for VTeX’s working modes. Unhappily many driver programs run +after the TeX compiler, so hyperref does not have a chance (dvips, dvipdfm, ...). In this +case driver <span +class="ec-lmss-10">hypertex </span>is loaded that supports the HyperTeX features that are recognized by +xdvi for example. This behaviour, however, can easily be changed in the configuration file +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperref.cfg</span></span></span>: + + + <pre class="verbatim" id="verbatim-43"> +    \providecommand*{\Hy@defaultdriver}{hdvips} +</pre> +<!--l. 2398--><p class="nopar" > for dvips, or + + + <pre class="verbatim" id="verbatim-44"> +    \providecommand*{\Hy@defaultdriver}{hypertex} +</pre> +<!--l. 2402--><p class="nopar" > for the default behaviour of hyperref. +<!--l. 2405--><p class="indent" > See also the new option ‘driverfallback’. +<!--l. 2407--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.27 </span> <a + id="x1-550007.27"></a>Backref entries</h4> +<!--l. 2409--><p class="noindent" >Alternative interface for formatting of backref entries, example: + + + <pre class="verbatim" id="verbatim-45"> +\documentclass[12pt,UKenglish]{article} + +\usepackage{babel} +\usepackage[pagebackref]{hyperref} + +% Some language options are detected by package backref. +% This affects the following macros: +%   \backrefpagesname +%   \backrefsectionsname +%   \backrefsep +%   \backreftwosep +%   \backreflastsep + +\renewcommand*{\backref}[1]{ +  % default interface +  % #1: backref list +  % +  % We want to use the alternative interface, +  % therefore the definition is empty here. +} +\renewcommand*{\backrefalt}[4]{% +  % alternative interface +  % #1: number of distinct back references +  % #2: backref list with distinct entries +  % #3: number of back references including duplicates +  % #4: backref list including duplicates +  \par +  #3 citation(s) on #1 page(s): #2,\par +  \ifnum#1=1 % +    \ifnum#3=1 % +      1 citation on page % +    \else +      #3 citations on page % +    \fi +  \else +    #3 citations on #1 pages % +  \fi +  #2,\par +  \ifnum#3=1 % +    1 citation located at page % +  \else +    #3 citations located at pages % +  \fi +  #4.\par +} + +% The list of distinct entries can be further refined: +\renewcommand*{\backrefentrycount}[2]{% + + +  % #1: the original backref entry +  % #2: the count of citations of this entry, +  %     in case of duplicates greater than one +  #1% +  \ifnum#2>1 % +    ~(#2)% +  \fi +} + +\begin{document} + +  \section{Hello} +    \cite{ref1, ref2, ref3, ref4} +  \section{World} +    \cite{ref1, ref3} +  \newpage + +  \section{Next section} +    \cite{ref1} +  \newpage + +  \section{Last section} +    \cite{ref1, ref2} +  \newpage + +  \pdfbookmark[1]{Bibliography}{bib} +  \begin{thebibliography}{99} +    \bibitem{ref1} Dummy entry one. + +    \bibitem{ref2} Dummy entry two. + +    \bibitem{ref3} Dummy entry three. + +    \bibitem{ref4} Dummy entry four. + +  \end{thebibliography} + +\end{document} +</pre> +<!--l. 2498--><p class="nopar" > +<!--l. 2500--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.28 </span> <a + id="x1-560007.28"></a>\phantomsection</h4> +<!--l. 2502--><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 +set. + + + <pre class="verbatim" id="verbatim-46"> +  \cleardoublepage +  \phantomsection +  \addcontentsline{toc}{chapter}{\indexname} +  \printindex +</pre> +<!--l. 2512--><p class="nopar" > +<!--l. 2514--><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. 2518--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.29 </span> <a + id="x1-570007.29"></a>puenc encoding, puenc-greekbasic.def and puenc-extra.def</h4> +<!--l. 2520--><p class="noindent" >The <span +class="ec-lmvtt-10">unicode </span>option loads for the bookmarks <span +class="ec-lmvtt-10">puenc.def </span>which contains quite a lot definitions of +commands for the bookmarks. As <span +class="ec-lmvtt-10">unicode </span>is now true for all engines, this file is now also loaded with +pdflatex. Some of the definitions in <span +class="ec-lmvtt-10">puenc.def </span>clash with other uses. To reduce the impact <span +class="ec-lmss-10">hyperref </span>uses +two strategies. + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2527--><p class="noindent" >A number of command are only defined conditionally: The commands for the cyrillic block + if <span +class="ec-lmvtt-10">\CYRDZE </span>is defined, greek if <span +class="ec-lmvtt-10">\textBeta </span>is defined, and hebrew if <span +class="ec-lmvtt-10">\hebdalet </span>is defined. + <!--l. 2531--><p class="noindent" >The greek block is in an extra file, <span +class="ec-lmvtt-10">puenc-greekbasic.def</span>, which can be loaded manually if + needed. + </li> + <li class="itemize"> + <!--l. 2534--><p class="noindent" >Other commands are moved to an extra file <span +class="ec-lmvtt-10">puenc-extra.def </span>which is not loaded + automatically, but can be loaded in the preamble if needed. Currently this file contains all + definitions for the accent <span +class="ec-lmvtt-10">\G</span>.</li></ul> +<!--l. 2541--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-580008"></a>Acrobat-specific behavior</h3> +<!--l. 2542--><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. 2545--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-43" class="tabular" + +><colgroup id="TBL-43-1g"><col +id="TBL-43-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-43-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-43-1-1" +class="td11"> <span +class="ec-lmvtt-10">\Acrobatmenu</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">menuoption</span><span class="obeylines-h"><span class="verb"><span +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. 2549--><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—comparison of this with the menus in Acrobat Reader or Exchange will +show what they do. Obviously some are only appropriate to Exchange. +<!--l. 2552--><p class="indent" > +<a + id="x1-58001r13"></a> + + + <!--l. 2553--><div class="longtable"> <table id="TBL-44" class="longtable" + +><colgroup id="TBL-44-1g"><col +id="TBL-44-1"><col +id="TBL-44-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-44-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-1-1" +class="td01">File </td><td style="white-space:normal; text-align:left;" id="TBL-44-1-2" +class="td10"> + <!--l. 2553--><p class="noindent" >Open, + Close, + Scan, + Save, + SaveAs, + Optimizer:SaveAsOpt, + Print, + PageSetup, + Quit </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-2-1" +class="td01">File<span +class="lmsy-10">→</span>Import </td><td style="white-space:normal; text-align:left;" id="TBL-44-2-2" +class="td10"> + <!--l. 2554--><p class="noindent" >ImportImage, + ImportNotes, + AcroForm:ImportFDF </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-3-1" +class="td01">File<span +class="lmsy-10">→</span>Export </td><td style="white-space:normal; text-align:left;" id="TBL-44-3-2" +class="td10"> + <!--l. 2555--><p class="noindent" >ExportNotes, + AcroForm:ExportFDF </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-4-1" +class="td01">File<span +class="lmsy-10">→</span>DocumentInfo </td><td style="white-space:normal; text-align:left;" id="TBL-44-4-2" +class="td10"> + <!--l. 2556--><p class="noindent" >GeneralInfo, + OpenInfo, + FontsInfo, + SecurityInfo, + Weblink:Base, + AutoIndex:DocInfo </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-5-1" +class="td01">File<span +class="lmsy-10">→</span>Preferences </td><td style="white-space:normal; text-align:left;" id="TBL-44-5-2" +class="td10"> + <!--l. 2557--><p class="noindent" >GeneralPrefs, + NotePrefs, + FullScreenPrefs, + Weblink:Prefs, + AcroSearch:Preferences(Windows) + or, + AcroSearch:Prefs(Mac), + Cpt:Capture </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-6-1" +class="td01">Edit </td><td style="white-space:normal; text-align:left;" id="TBL-44-6-2" +class="td10"> + <!--l. 2559--><p class="noindent" >Undo, + Cut, + Copy, + Paste, + Clear, + SelectAll, + Ole:CopyFile, + TouchUp:TextAttributes, + TouchUp:FitTextToSelection, + TouchUp:ShowLineMarkers, + TouchUp:ShowCaptureSuspects, + TouchUp:FindSuspect, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-7-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-44-7-2" +class="td10"> + <!--l. 2562--><p class="noindent" >Properties </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-8-1" +class="td01">Edit<span +class="lmsy-10">→</span>Fields </td><td style="white-space:normal; text-align:left;" id="TBL-44-8-2" +class="td10"> + <!--l. 2563--><p class="noindent" >AcroForm:Duplicate, + AcroForm:TabOrder </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-44-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-9-1" +class="td01">Document </td><td style="white-space:normal; text-align:left;" id="TBL-44-9-2" +class="td10"> + <!--l. 2564--><p class="noindent" >Cpt:CapturePages, + AcroForm:Actions, + CropPages, + RotatePages, + InsertPages, + ExtractPages, + ReplacePages, + DeletePages, + NewBookmark, + SetBookmarkDest, + CreateAllThumbs, + DeleteAllThumbs </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-10-1" +class="td01">View </td><td style="white-space:normal; text-align:left;" id="TBL-44-10-2" +class="td10"> + <!--l. 2567--><p class="noindent" >ActualSize, + FitVisible, + FitWidth, + FitPage, + ZoomTo, + FullScreen, + FirstPage, + PrevPage, + NextPage, + LastPage, + GoToPage, + GoBack, + GoForward, + SinglePage, + OneColumn, + TwoColumns, + ArticleThreads, + PageOnly, + ShowBookmarks, + ShowThumbs </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-11-1" +class="td01">Tools </td><td style="white-space:normal; text-align:left;" id="TBL-44-11-2" +class="td10"> + <!--l. 2570--><p class="noindent" >Hand, + ZoomIn, + ZoomOut, + SelectText, + SelectGraphics, + Note, + Link, + Thread, + AcroForm:Tool, + Acro_Movie:MoviePlayer, + TouchUp:TextTool, + Find, + FindAgain, + FindNextNote, + CreateNotesFile </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-44-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-12-1" +class="td01">Tools<span +class="lmsy-10">→</span>Search </td><td style="white-space:normal; text-align:left;" id="TBL-44-12-2" +class="td10"> + <!--l. 2573--><p class="noindent" >AcroSrch:Query, + AcroSrch:Indexes, + AcroSrch:Results, + AcroSrch:Assist, + AcroSrch:PrevDoc, + AcroSrch:PrevHit, + AcroSrch:NextHit, + AcroSrch:NextDoc </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-13-1" +class="td01">Window </td><td style="white-space:normal; text-align:left;" id="TBL-44-13-2" +class="td10"> + <!--l. 2575--><p class="noindent" >ShowHideToolBar, + ShowHideMenuBar, + ShowHideClipboard, + Cascade, + TileHorizontal, + TileVertical, + CloseAll </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-14-1" +class="td01">Help </td><td style="white-space:normal; text-align:left;" id="TBL-44-14-2" +class="td10"> + <!--l. 2577--><p class="noindent" >HelpUserGuide, + HelpTutorial, + HelpExchange, + HelpScan, + HelpCapture, + HelpPDFWriter, + HelpDistiller, + HelpSearch, + HelpCatalog, + HelpReader, + Weblink:Home </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-15-1" +class="td01">Help(Windows) </td><td style="white-space:normal; text-align:left;" id="TBL-44-15-2" +class="td10"> + <!--l. 2579--><p class="noindent" >About </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-16-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-17-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-18-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-44-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-19-1" +class="td01"> </td><td style="white-space:normal; text-align:left;" id="TBL-44-19-2" +class="td10"></td></tr> + </table></div> +<!--l. 2582--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-590009"></a>PDF and HTML forms</h3> +<!--l. 2583--><p class="noindent" >You must put your fields inside a <span +class="ec-lmvtt-10">Form </span>environment. The environment does some general setups, so +should be used only once in a document. Using simply <span +class="ec-lmvtt-10">\Form </span>at the begin of the document is possible +too. +<!--l. 2587--><p class="indent" > There are six macros to prepare fields: + + +<!--l. 2589--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-45" class="tabular" + +><colgroup id="TBL-45-1g"><col +id="TBL-45-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-45-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-45-1-1" +class="td11"> <span +class="ec-lmvtt-10">\TextField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +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. 2593--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-46" class="tabular" + +><colgroup id="TBL-46-1g"><col +id="TBL-46-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-46-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-46-1-1" +class="td11"> <span +class="ec-lmvtt-10">\CheckBox</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +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. 2597--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-47" class="tabular" + +><colgroup id="TBL-47-1g"><col +id="TBL-47-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-47-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-47-1-1" +class="td11"> <span +class="ec-lmvtt-10">\ChoiceMenu</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +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><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. 2601--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-48" class="tabular" + +><colgroup id="TBL-48-1g"><col +id="TBL-48-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-48-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-48-1-1" +class="td11"> <span +class="ec-lmvtt-10">\PushButton</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +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. 2605--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-49" class="tabular" + +><colgroup id="TBL-49-1g"><col +id="TBL-49-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-49-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-49-1-1" +class="td11"> <span +class="ec-lmvtt-10">\Submit</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +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. 2609--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-50" class="tabular" + +><colgroup id="TBL-50-1g"><col +id="TBL-50-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-50-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-50-1-1" +class="td11"> <span +class="ec-lmvtt-10">\Reset</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +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. 2613--><p class="indent" > The way forms and their labels are laid out is determined by: +<!--l. 2614--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-51" class="tabular" + +><colgroup id="TBL-51-1g"><col +id="TBL-51-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-51-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-51-1-1" +class="td11"> <span +class="ec-lmvtt-10">\LayoutTextField</span><span class="obeylines-h"><span class="verb"><span +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><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. 2618--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-52" class="tabular" + +><colgroup id="TBL-52-1g"><col +id="TBL-52-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-52-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-52-1-1" +class="td11"> <span +class="ec-lmvtt-10">\LayoutChoiceField</span><span class="obeylines-h"><span class="verb"><span +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><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. 2622--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-53" class="tabular" + +><colgroup id="TBL-53-1g"><col +id="TBL-53-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-53-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-53-1-1" +class="td11"> <span +class="ec-lmvtt-10">\LayoutCheckField</span><span class="obeylines-h"><span class="verb"><span +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><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. 2626--><p class="indent" > These macros default to #1 #2 +<!--l. 2628--><p class="indent" > What is actually shown in the field is determined by: +<!--l. 2629--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-54" class="tabular" + +><colgroup id="TBL-54-1g"><col +id="TBL-54-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-54-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-1-1" +class="td11"> <span +class="ec-lmvtt-10">\MakeRadioField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span +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. 2633--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-55" class="tabular" + +><colgroup id="TBL-55-1g"><col +id="TBL-55-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-55-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-1" +class="td11"> <span +class="ec-lmvtt-10">\MakeCheckField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span +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. 2636--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-56" class="tabular" + +><colgroup id="TBL-56-1g"><col +id="TBL-56-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-56-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-1-1" +class="td11"> <span +class="ec-lmvtt-10">\MakeTextField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span +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. 2639--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-57" class="tabular" + +><colgroup id="TBL-57-1g"><col +id="TBL-57-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-57-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-57-1-1" +class="td11"> <span +class="ec-lmvtt-10">\MakeChoiceField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span +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. 2643--><p class="noindent" ><span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-58" class="tabular" + +><colgroup id="TBL-58-1g"><col +id="TBL-58-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-58-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-58-1-1" +class="td11"> <span +class="ec-lmvtt-10">\MakeButtonField</span><span class="obeylines-h"><span class="verb"><span +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. 2647--><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"> to</span><span +class="ec-lmvtt-10"> #2{\hbox</span><span +class="ec-lmvtt-10"> to</span><span +class="ec-lmvtt-10"> #1{\hfill}\vfill}</span></span></span>, except the last, which defaults +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. 2651--><p class="indent" > You may also want to redefine the following macros: + + + <pre class="verbatim" id="verbatim-47"> +\def\DefaultHeightofSubmit{12pt} +\def\DefaultWidthofSubmit{2cm} +\def\DefaultHeightofReset{12pt} +\def\DefaultWidthofReset{2cm} +\def\DefaultHeightofCheckBox{0.8\baselineskip} +\def\DefaultWidthofCheckBox{0.8\baselineskip} +\def\DefaultHeightofChoiceMenu{0.8\baselineskip} +\def\DefaultWidthofChoiceMenu{0.8\baselineskip} +\def\DefaultHeightofText{\baselineskip} +\def\DefaultHeightofTextMultiline{4\baselineskip} +\def\DefaultWidthofText{3cm} +</pre> +<!--l. 2664--><p class="nopar" > +<!--l. 2666--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.1 </span> <a + id="x1-600009.1"></a>Forms environment parameters</h4> +<!--l. 2669--><p class="noindent" > +<a + id="x1-60001r14"></a> <!--l. 2670--><div class="longtable"> <table id="TBL-59" class="longtable" + +><colgroup id="TBL-59-1g"><col +id="TBL-59-1"><col +id="TBL-59-2"><col +id="TBL-59-3"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-59-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-1-1" +class="td01"><span +class="ec-lmvtt-10">action </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-59-1-2" +class="td11"> <span +class="ec-lmri-10">URL </span></td><td style="white-space:normal; text-align:left;" id="TBL-59-1-3" +class="td10"> + <!--l. 2670--><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 + style="vertical-align:baseline;" id="TBL-59-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-2-1" +class="td01"><span +class="ec-lmvtt-10">encoding </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-59-2-2" +class="td11"> <span +class="ec-lmri-10">name </span></td><td style="white-space:normal; text-align:left;" id="TBL-59-2-3" +class="td10"> + <!--l. 2671--><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 + style="vertical-align:baseline;" id="TBL-59-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-3-1" +class="td01"><span +class="ec-lmvtt-10">method </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-59-3-2" +class="td11"> <span +class="ec-lmri-10">name </span></td><td style="white-space:normal; text-align:left;" id="TBL-59-3-3" +class="td10"> + <!--l. 2673--><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> +</tr><tr + style="vertical-align:baseline;" id="TBL-59-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-4-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-59-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-5-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-59-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-6-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-59-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-7-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-59-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-59-8-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-59-8-2" +class="td11"> </td><td style="white-space:normal; text-align:left;" id="TBL-59-8-3" +class="td10"></td></tr> + </table></div> +<!--l. 2676--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.2 </span> <a + id="x1-610009.2"></a>Forms optional parameters</h4> +<!--l. 2677--><p class="noindent" >Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. <span +class="ec-lmvtt-10">color=0 0</span> +<span +class="ec-lmvtt-10">0.5</span>) +<!--l. 2681--><p class="indent" > +<a + id="x1-61001r15"></a> <!--l. 2682--><div class="longtable"> <table id="TBL-60" class="longtable" + +><colgroup id="TBL-60-1g"><col +id="TBL-60-1"><col +id="TBL-60-2"><col +id="TBL-60-3"><col +id="TBL-60-4"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-60-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-1-1" +class="td01"><span +class="ec-lmvtt-10">accesskey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-1-2" +class="td11"> key </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-1-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-1-4" +class="td10"> (as per HTML) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-2-1" +class="td01"><span +class="ec-lmvtt-10">align </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-2-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-2-3" +class="td11"> <span +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-2-4" +class="td10"> alignment within text field; 0 is left-aligned, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-3-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-3-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-3-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-3-4" +class="td10"> 1 is centered, 2 is right-aligned. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-4-1" +class="td01"><span +class="ec-lmvtt-10">altname </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-4-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-4-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-4-4" +class="td10"> alternative name, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-5-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-5-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-5-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-5-4" +class="td10"> the name shown in the user interface </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-6-1" +class="td01"><span +class="ec-lmvtt-10">backgroundcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-6-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-6-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-6-4" +class="td10"> color of box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-7-1" +class="td01"><span +class="ec-lmvtt-10">bordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-7-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-7-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-7-4" +class="td10"> color of border </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-8-1" +class="td01"><span +class="ec-lmvtt-10">bordersep </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-8-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-8-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-8-4" +class="td10"> box border gap </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-9-1" +class="td01"><span +class="ec-lmvtt-10">borderstyle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-9-2" +class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-9-3" +class="td11"> <span +class="ec-lmri-10">S </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-9-4" +class="td10"> box border style; S (Solid) is default, B is Beveled,</td> + +</tr><tr + style="vertical-align:baseline;" id="TBL-60-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-10-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-10-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-10-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-10-4" +class="td10"> D is Dashed, I is Inset and U is Underline </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-11-1" +class="td01"><span +class="ec-lmvtt-10">borderwidth </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-11-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-11-3" +class="td11"> <span +class="ec-lmri-10">1 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-11-4" +class="td10"> width of box border, the value is a dimension </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-12-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-12-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-12-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-12-4" +class="td10"> or a number with default unit bp </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-13-1" +class="td01"><span +class="ec-lmvtt-10">calculate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-13-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-13-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-13-4" +class="td10"> JavaScript code to calculate the value of the field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-14-1" +class="td01"><span +class="ec-lmvtt-10">charsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-14-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-14-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-14-4" +class="td10"> font size of field text </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-15-1" +class="td01"><span +class="ec-lmvtt-10">checkboxsymbol </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-15-2" +class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-15-3" +class="td11"> <span +class="ec-lmri-10">4 (</span><span +class="pzdr-">✔</span><span +class="ec-lmri-10">) </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-15-4" +class="td10"> symbol used for check boxes (ZapfDingbats), </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-16-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-16-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-16-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-16-4" +class="td10"> the value is a character or <span +class="ec-lmvtt-10">\ding</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmvtto-10">number</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span>, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-17-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-17-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-17-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-17-4" +class="td10"> see package <span +class="ec-lmss-10">pifont </span>from bundle <span +class="ec-lmss-10">psnfss </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-18-1" +class="td01"><span +class="ec-lmvtt-10">checked </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-18-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-18-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-18-4" +class="td10"> whether option selected by default </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-19-1" +class="td01"><span +class="ec-lmvtt-10">color </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-19-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-19-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-19-4" +class="td10"> color of text in box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-20-1" +class="td01"><span +class="ec-lmvtt-10">combo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-20-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-20-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-20-4" +class="td10"> choice list is ‘combo’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-21-1" +class="td01"><span +class="ec-lmvtt-10">default </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-21-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-21-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-21-4" +class="td10"> default value </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-22-1" +class="td01"><span +class="ec-lmvtt-10">disabled </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-22-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-22-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-22-4" +class="td10"> field disabled </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-23-1" +class="td01"><span +class="ec-lmvtt-10">format </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-23-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-23-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-23-4" +class="td10"> JavaScript code to format the field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-24-1" +class="td01"><span +class="ec-lmvtt-10">height </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-24-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-24-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-24-4" +class="td10"> height of field box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-25-1" +class="td01"><span +class="ec-lmvtt-10">hidden </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-25-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-25-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-25-4" +class="td10"> field hidden </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-26-1" +class="td01"><span +class="ec-lmvtt-10">keystroke </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-26-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-26-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-26-4" +class="td10"> JavaScript code to control the keystrokes on entry </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-27-1" +class="td01"><span +class="ec-lmvtt-10">mappingname </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-27-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-27-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-27-4" +class="td10"> the mapping name to be used when exporting </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-28-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-28-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-28-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-28-4" +class="td10"> the field data </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-29-1" +class="td01"><span +class="ec-lmvtt-10">maxlen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-29-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-29-3" +class="td11"> <span +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-29-4" +class="td10"> number of characters allowed in text field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-30-1" +class="td01"><span +class="ec-lmvtt-10">menulength </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-30-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-30-3" +class="td11"> <span +class="ec-lmri-10">4 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-30-4" +class="td10"> number of elements shown in list </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-31-1" +class="td01"><span +class="ec-lmvtt-10">multiline </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-31-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-31-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-31-4" +class="td10"> whether text box is multiline </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-32-1" +class="td01"><span +class="ec-lmvtt-10">name </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-32-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-32-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-32-4" +class="td10"> name of field (defaults to label) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-33-1" +class="td01"><span +class="ec-lmvtt-10">onblur </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-33-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-33-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-33-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-34-1" +class="td01"><span +class="ec-lmvtt-10">onchange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-34-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-34-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-34-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-35-1" +class="td01"><span +class="ec-lmvtt-10">onclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-35-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-35-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-35-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-36-1" +class="td01"><span +class="ec-lmvtt-10">ondblclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-36-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-36-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-36-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-37-1" +class="td01"><span +class="ec-lmvtt-10">onfocus </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-37-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-37-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-37-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-38-1" +class="td01"><span +class="ec-lmvtt-10">onkeydown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-38-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-38-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-38-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-39-1" +class="td01"><span +class="ec-lmvtt-10">onkeypress </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-39-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-39-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-39-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-40-1" +class="td01"><span +class="ec-lmvtt-10">onkeyup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-40-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-40-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-40-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-41-1" +class="td01"><span +class="ec-lmvtt-10">onmousedown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-41-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-41-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-41-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-42-1" +class="td01"><span +class="ec-lmvtt-10">onmousemove </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-42-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-42-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-42-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-43-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-43-1" +class="td01"><span +class="ec-lmvtt-10">onmouseout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-43-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-43-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-43-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-44-1" +class="td01"><span +class="ec-lmvtt-10">onmouseover </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-44-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-44-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-44-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-45-1" +class="td01"><span +class="ec-lmvtt-10">onmouseup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-45-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-45-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-45-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-46-1" +class="td01"><span +class="ec-lmvtt-10">onselect </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-46-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-46-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-46-4" +class="td10"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-47-1" +class="td01"><span +class="ec-lmvtt-10">password </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-47-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-47-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-47-4" +class="td10"> text field is ‘password’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-48-1" +class="td01"><span +class="ec-lmvtt-10">popdown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-48-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-48-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-48-4" +class="td10"> choice list is ‘popdown’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-49-1" +class="td01"><span +class="ec-lmvtt-10">radio </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-49-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-49-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-49-4" +class="td10"> choice list is ‘radio’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-50-1" +class="td01"><span +class="ec-lmvtt-10">radiosymbol </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-50-2" +class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-50-3" +class="td11"> <span +class="ec-lmri-10">H (</span><span +class="pzdr-">★</span><span +class="ec-lmri-10">) </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-50-4" +class="td10"> symbol used for radio fields (ZapfDingbats), </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-51-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-51-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-51-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-51-4" +class="td10"> the value is a character or <span +class="ec-lmvtt-10">\ding</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmvtto-10">number</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span>, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-52-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-52-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-52-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-52-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-52-4" +class="td10"> see package <span +class="ec-lmss-10">pifont </span>from bundle <span +class="ec-lmss-10">psnfss </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-53-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-53-1" +class="td01"><span +class="ec-lmvtt-10">readonly </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-53-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-53-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-53-4" +class="td10"> field is readonly </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-54-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-54-1" +class="td01"><span +class="ec-lmvtt-10">rotation </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-54-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-54-3" +class="td11"> <span +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-54-4" +class="td10"> rotation of the widget annotation </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-55-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-55-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-55-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-55-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-55-4" +class="td10"> (degree, counterclockwise, multiple of 90) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-56-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-56-1" +class="td01"><span +class="ec-lmvtt-10">tabkey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-56-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-56-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-56-4" +class="td10"> (as per HTML) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-57-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-57-1" +class="td01"><span +class="ec-lmvtt-10">validate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-57-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-57-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-57-4" +class="td10"> JavaScript code to validate the entry </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-58-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-58-1" +class="td01"><span +class="ec-lmvtt-10">value </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-58-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-58-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-58-4" +class="td10"> initial value </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-59-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-59-1" +class="td01"><span +class="ec-lmvtt-10">width </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-60-59-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-59-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-59-4" +class="td10"> width of field box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-60-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-60-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-61-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-61-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-62-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-62-1" +class="td01"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-60-63-"><td style="white-space:nowrap; text-align:left;" id="TBL-60-63-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-63-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-63-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-60-63-4" +class="td10"></td></tr> + </table></div> +<!--l. 2743--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">10 </span> <a + id="x1-6200010"></a>Defining a new driver</h3> +<!--l. 2744--><p class="noindent" >A hyperref driver has to provide definitions for eight macros: +<!--l. 2747--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@anchor</span></span></span> +<!--l. 2749--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@link</span></span></span> +<!--l. 2751--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@linkfile</span></span></span> +<!--l. 2753--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@linkurl</span></span></span> +<!--l. 2755--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@anchorstart</span></span></span> + +<!--l. 2757--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@anchorend</span></span></span> +<!--l. 2759--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@linkstart</span></span></span> +<!--l. 2761--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@linkend</span></span></span> +<!--l. 2764--><p class="indent" > The draft option defines the macros as follows + + + <pre class="verbatim" id="verbatim-48"> +\let\hyper@@anchor\@gobble +\gdef\hyper@link##1##2##3{##3}% +\def\hyper@linkurl##1##2{##1}% +\def\hyper@linkfile##1##2##3{##1}% +\let\hyper@anchorstart\@gobble +\let\hyper@anchorend\@empty +\let\hyper@linkstart\@gobbletwo +\let\hyper@linkend\@empty +</pre> +<!--l. 2774--><p class="nopar" > +<!--l. 2776--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">11 </span> <a + id="x1-6300011"></a>Special support for other packages</h3> +<!--l. 2778--><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"> + <li class="itemize"> + <!--l. 2783--><p class="noindent" >Packages that manipulate the bibliographic mechanism. Peter William’s <span +class="ec-lmss-10">harvard </span>package is + supported. However, the recommended package is Patrick Daly’s <span +class="ec-lmss-10">natbib </span>package that has + specific <span +class="ec-lmss-10">hyperref </span>hooks to allow reliable interaction. This package covers a very wide variety + of layouts and citation styles, all of which work with <span +class="ec-lmss-10">hyperref</span>. + </li> + <li class="itemize"> + <!--l. 2790--><p class="noindent" >Packages that changes <span +class="ec-lmvtt-10">\label </span>and <span +class="ec-lmvtt-10">\ref </span>macros. + </li> + <li class="itemize"> + <!--l. 2793--><p class="noindent" >Packages that do anything serious with the index. + </li> + <li class="itemize"> + <!--l. 2795--><p class="noindent" >Packages that do anything serious with sectioning commands and the toc</li></ul> +<!--l. 2800--><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 +class="ec-lmss-10">minitoc</span>, which support crossdocument links using <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>’s normal +<span +class="ec-lmvtt-10">\label</span>/<span +class="ec-lmvtt-10">\ref </span>mechanisms and per-chapter tables of contents, respectively. +<!--l. 2807--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.1 </span> <a + id="x1-6400011.1"></a>Package Compatibility</h4> +<!--l. 2809--><p class="noindent" >Currently only package loading orders are available: +<!--l. 2812--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.1 </span> <a + id="x1-6500011.1.1"></a>algorithm</h5> + + <pre class="verbatim" id="verbatim-49"> + \usepackage{float} +  \usepackage{hyperref} +  \usepackage[chapter]{algorithm}% eg. +</pre> +<!--l. 2817--><p class="nopar" > +<!--l. 2819--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.2 </span> <a + id="x1-6600011.1.2"></a>amsmath</h5> +<!--l. 2821--><p class="noindent" >The environments equation and eqnarray are not supported too well. For example, there might be +spacing problems (eqnarray isn’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 +gather: + + + <pre class="verbatim" id="verbatim-50"> +  \usepackage{amsmath} +  \let\equation\gather +  \let\endequation\endgather +</pre> +<!--l. 2832--><p class="nopar" > +<!--l. 2834--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.3 </span> <a + id="x1-6700011.1.3"></a>amsrefs</h5> +<!--l. 2836--><p class="noindent" >Package loading order: + + + <pre class="verbatim" id="verbatim-51"> +  \usepackage{hyperref} +  \usepackage{amsrefs} +</pre> +<!--l. 2841--><p class="nopar" > +<!--l. 2843--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.4 </span> <a + id="x1-6800011.1.4"></a>arydshln, longtable</h5> +<!--l. 2845--><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: + + + <pre class="verbatim" id="verbatim-52"> +  \usepackage{longtable} +  \usepackage{hyperref} +  \usepackage{arydshln} +</pre> +<!--l. 2853--><p class="nopar" > +<!--l. 2855--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.5 </span> <a + id="x1-6900011.1.5"></a>babel/magyar.ldf</h5> +<!--l. 2857--><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. 2862--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.6 </span> <a + id="x1-7000011.1.6"></a>babel/spanish.ldf</h5> +<!--l. 2864--><p class="noindent" >Babel’s spanish.ldf redefines ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\.</span></span></span>’ to support ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\...</span></span></span>’. In bookmarks (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfstringdef</span></span></span>) only ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\.</span></span></span>’ is supported. If +‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\...</span></span></span>’ is needed, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring{\...}{\dots}</span></span></span> can be used instead. +<!--l. 2871--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.7 </span> <a + id="x1-7100011.1.7"></a>bibentry</h5> +<!--l. 2873--><p class="noindent" >Workaround: + + + <pre class="verbatim" id="verbatim-53"> +  \makeatletter +  \let\saved@bibitem\@bibitem +  \makeatother + +  \usepackage{bibentry} +  \usepackage{hyperref} + +  \begin{document} + +  \begingroup +    \makeatletter +    \let\@bibitem\saved@bibitem +    \nobibliography{database} +  \endgroup +</pre> +<!--l. 2890--><p class="nopar" > +<!--l. 2892--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.8 </span> <a + id="x1-7200011.1.8"></a>bigfoot</h5> +<!--l. 2894--><p class="noindent" >Hyperref does not support package ‘bigfoot’. And package ‘bigfoot’ does not support hyperref’s footnotes +and disables them (hyperfootnotes=false). +<!--l. 2899--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.9 </span> <a + id="x1-7300011.1.9"></a>chappg</h5> +<!--l. 2901--><p class="noindent" >Package ‘chappg’ uses <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> that is redefined by ‘hyperref’. The package order is +therefore: + + + <pre class="verbatim" id="verbatim-54"> +  \usepackage{hyperref} +  \usepackage{chappg} +</pre> +<!--l. 2907--><p class="nopar" > +<!--l. 2909--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.10 </span> <a + id="x1-7400011.1.10"></a>cite</h5> +<!--l. 2911--><p class="noindent" >This is from Mike Shell: cite.sty cannot currently be used with hyperref. However, I can do a workaround +via: + + + <pre class="verbatim" id="verbatim-55"> + \makeatletter + \def\NAT@parse{\typeout{This is a fake Natbib command to fool Hyperref.}} + \makeatother + + \usepackage[hypertex]{hyperref} +</pre> +<!--l. 2921--><p class="nopar" > +<!--l. 2923--><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. 2928--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.11 </span> <a + id="x1-7500011.1.11"></a>count1to</h5> +<!--l. 2930--><p class="noindent" >Package ‘count1to’ adds several <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> commands that confuse ‘hyperref’. Therefore <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\theH<...></span></span></span> +has to be fixed: + + + <pre class="verbatim" id="verbatim-56"> +  \usepackage{count1to} +  \AtBeginDocument{% *after* \usepackage{count1to} +    \renewcommand*{\theHsection}{\theHchapter.\arabic{section}}% +    \renewcommand*{\theHsubsection}{\theHsection.\arabic{subsection}}% +    \renewcommand*{\theHsubsubsection}{\theHsubsection.\arabic{subsubsection}}% +    \renewcommand*{\theHparagraph}{\theHsubsubsection.\arabic{paragraph}}% +    \renewcommand*{\theHsubparagraph}{\theHparagraph.\arabic{subparagraph}}% +  } +</pre> +<!--l. 2942--><p class="nopar" > +<!--l. 2944--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.12 </span> <a + id="x1-7600011.1.12"></a>dblaccnt</h5> +<!--l. 2946--><p class="noindent" >pd1enc.def or puenc.def should be loaded before: + + + <pre class="verbatim" id="verbatim-57"> +  \usepackage{hyperref} +  \usepackage{dblaccnt} +</pre> +<!--l. 2950--><p class="nopar" > or see entry for <span +class="ec-lmss-10">vietnam</span>. +<!--l. 2954--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.13 </span> <a + id="x1-7700011.1.13"></a>easyeqn</h5> +<!--l. 2955--><p class="noindent" >Not compatible, breaks. +<!--l. 2958--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.14 </span> <a + id="x1-7800011.1.14"></a>ellipsis</h5> +<!--l. 2960--><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): + + + <pre class="verbatim" id="verbatim-58"> +  \usepackage{hyperref} +  \usepackage{ellipsis} +</pre> +<!--l. 2965--><p class="nopar" > +<!--l. 2967--><p class="indent" > (this will lead to wrong ellipsis in the bookmarks, so <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring</span></span></span> is needed). +<!--l. 2969--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.15 </span> <a + id="x1-7900011.1.15"></a>float</h5> + + + <pre class="verbatim" id="verbatim-59"> + \usepackage{float} +  \usepackage{hyperref} +</pre> +<!--l. 2973--><p class="nopar" > + <ul class="itemize1"> + <li class="itemize"> + <!--l. 2975--><p class="noindent" >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"> + <!--l. 2976--><p class="noindent" >Anchor are set at top of the float object, if its style is controlled by float.sty.</li></ul> +<!--l. 2980--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.16 </span> <a + id="x1-8000011.1.16"></a>endnotes</h5> +<!--l. 2981--><p class="noindent" >Unsupported. +<!--l. 2983--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.17 </span> <a + id="x1-8100011.1.17"></a>foiltex</h5> +<!--l. 2984--><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 ‘atbegshi’ instead, that hooks into <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\shipout</span></span></span>. Thus the patch of ‘foils.cls’ 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. 2992--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.18 </span> <a + id="x1-8200011.1.18"></a>footnote</h5> +<!--l. 2994--><p class="noindent" >This package is not supported, you have to disable hyperref’s footnote support by using option +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperfootnotes=false</span></span></span>. +<!--l. 2998--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.19 </span> <a + id="x1-8300011.1.19"></a>geometry</h5> +<!--l. 3000--><p class="noindent" >Driver ‘dvipdfm’ and program ‘dvipdfm’ might generate a warning: Sorry. Too late to change page size +Then prefer the program ‘dvipdfmx’ 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: + + + <pre class="verbatim" id="verbatim-60"> +    \documentclass[dvipdfm]{article}% or other classes +    \usepackage{atbegshi} +    \AtBeginDocument{% +      \let\OrgAtBeginDvi\AtBeginDvi +      \let\AtBeginDvi\AtBeginShipoutFirst +    } +    \usepackage[ +      paperwidth=170mm, +      paperheight=240mm +    ]{geometry} +    \AtBeginDocument{% +      \let\AtBeginDvi\OrgAtBeginDvi +    } +    \usepackage{hyperref} + +  or + +    \documentclass[dvipdfm]{article}% or other classes +    \usepackage{atbegshi} +    \let\AtBeginDvi\AtBeginShipoutFirst +    \usepackage[ +      paperwidth=170mm, +      paperheight=240mm +    ]{geometry} +    \usepackage{hyperref} +</pre> +<!--l. 3032--><p class="nopar" > +<!--l. 3034--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.20 </span> <a + id="x1-8400011.1.20"></a>IEEEtran.cls</h5> +<!--l. 3036--><p class="noindent" >version <span +class="lmsy-10">≥ </span>V1.6b (because of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@makecaption</span></span></span>, see ChangeLog) +<!--l. 3039--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.21 </span> <a + id="x1-8500011.1.21"></a>index</h5> +<!--l. 3041--><p class="noindent" >version <span +class="lmsy-10">≥ </span>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. 3044--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.22 </span> <a + id="x1-8600011.1.22"></a>lastpage</h5> +<!--l. 3046--><p class="noindent" >Compatible. +<!--l. 3049--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.23 </span> <a + id="x1-8700011.1.23"></a>linguex</h5> + + + <pre class="verbatim" id="verbatim-61"> + \usepackage{hyperref} +  \usepackage{linguex} +</pre> +<!--l. 3053--><p class="nopar" > +<!--l. 3055--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.24 </span> <a + id="x1-8800011.1.24"></a>ltabptch</h5> + + + <pre class="verbatim" id="verbatim-62"> + \usepackage{longtable} +  \usepackage{ltabptch} +  \usepackage{hyperref} +</pre> +<!--l. 3060--><p class="nopar" > +<!--l. 3062--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.25 </span> <a + id="x1-8900011.1.25"></a>mathenv</h5> +<!--l. 3064--><p class="noindent" >Unsupported. +<!--l. 3068--><p class="indent" > Both ‘mathenv’ and ‘hyperref’ messes around with environment ‘eqnarray’. You can load ‘mathenv’ +after ‘hyperref’ 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 ‘eqnarray’ +properly, for example. +<!--l. 3075--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.26 </span> <a + id="x1-9000011.1.26"></a>minitoc-hyper</h5> +<!--l. 3077--><p class="noindent" >This package is obsolete, use the up-to-date original package minitoc instead. +<!--l. 3082--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.27 </span> <a + id="x1-9100011.1.27"></a>multind</h5> + + + <pre class="verbatim" id="verbatim-63"> + \usepackage{multind} +  \usepackage{hyperref} +</pre> +<!--l. 3086--><p class="nopar" > +<!--l. 3088--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.28 </span> <a + id="x1-9200011.1.28"></a>natbib</h5> + + + <pre class="verbatim" id="verbatim-64"> + \usepackage{natbib} +  \usepackage{hyperref} +</pre> +<!--l. 3092--><p class="nopar" > +<!--l. 3094--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.29 </span> <a + id="x1-9300011.1.29"></a>nomencl</h5> +<!--l. 3095--><p class="noindent" >Example for introducing links for the page numbers: + + + <pre class="verbatim" id="verbatim-65"> +      \renewcommand*{\pagedeclaration}[1]{\unskip, \hyperpage{#1}} +</pre> +<!--l. 3098--><p class="nopar" > +<!--l. 3101--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.30 </span> <a + id="x1-9400011.1.30"></a>ntheorem-hyper</h5> +<!--l. 3102--><p class="noindent" >This package is obsolete, use the up-to-date original package ntheorem instead. +<!--l. 3106--><p class="indent" > For equations the following might work: + + + <pre class="verbatim" id="verbatim-66"> +      \renewcommand*{\eqdeclaration}[1]{% +        \hyperlink{equation.#1}{(Equation~#1)}% +      } +    But the mapping from the equation number to the anchor name +    is not available in general. +</pre> +<!--l. 3113--><p class="nopar" > +<!--l. 3116--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.31 </span> <a + id="x1-9500011.1.31"></a>prettyref</h5> + + + <pre class="verbatim" id="verbatim-67"> +%%% example for prettyref %%% +\documentclass{article} +\usepackage{prettyref} +\usepackage{hyperref} + +%\newrefformat{FIG}{Figure~\ref{#1}}% without hyperref +\newrefformat{FIG}{\hyperref[{#1}]{Figure~\ref*{#1}}} + +\begin{document} +  This is a reference to \prettyref{FIG:ONE}. +  \newpage +  \begin{figure} +    \caption{This is my figure} +    \label{FIG:ONE} +  \end{figure} +\end{document} +%%% example for prettyref %%% +       +</pre> +<!--l. 3135--><p class="nopar" > +<!--l. 3138--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.32 </span> <a + id="x1-9600011.1.32"></a>setspace</h5> + + + <pre class="verbatim" id="verbatim-68"> + \usepackage{setspace} +  \usepackage{hyperref} +</pre> +<!--l. 3142--><p class="nopar" > +<!--l. 3144--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.33 </span> <a + id="x1-9700011.1.33"></a>sidecap</h5> +<!--l. 3145--><p class="noindent" >Nothing special is needed anymore. +<!--l. 3147--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.34 </span> <a + id="x1-9800011.1.34"></a>subfigure</h5> +<!--l. 3148--><p class="noindent" >The package is obsolete. Use either <span +class="ec-lmss-10">subfig </span>or <span +class="ec-lmss-10">subcaption</span> +<!--l. 3151--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.35 </span> <a + id="x1-9900011.1.35"></a>titleref</h5> + + + <pre class="verbatim" id="verbatim-69"> + \usepackage{nameref} +  \usepackage{titleref}% without usetoc +  \usepackage{hyperref} +</pre> +<!--l. 3156--><p class="nopar" > +<!--l. 3158--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.36 </span> <a + id="x1-10000011.1.36"></a>tabularx</h5> +<!--l. 3160--><p class="noindent" >Linked footnotes are not supported inside environment ‘tabularx’, 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 ‘Limitations’. Before version 2011/09/28 6.82i hyperref had +disabled footnotes entirely by ‘hyperfootnotes=false’. +<!--l. 3166--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.37 </span> <a + id="x1-10100011.1.37"></a>titlesec</h5> +<!--l. 3168--><p class="noindent" ><span +class="ec-lmss-10">nameref </span>supports titlesec, but hyperref does not (unsolved is the anchor setting, missing with +unnumbered section, perhaps problems with page breaks with numbered ones). +<!--l. 3173--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.38 </span> <a + id="x1-10200011.1.38"></a>ucs/utf8x.def</h5> +<!--l. 3175--><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 <span +class="ec-lmss-10">ucs </span>offers +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\PrerenderUnicode</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\PreloadUnicodePage</span></span></span> to solve this: + + + <pre class="verbatim" id="verbatim-70"> +    \usepackage{ucs} +    \usepackage[utf8x]{inputenc} +    \usepackage{hyperref}% or with option unicode +    \PrerenderUnicode{^^c3^^b6}% or \PrerenderUnicodePage{1} +    \hypersetup{pdftitle={Umlaut example: ^^c3^^b6}} +</pre> +<!--l. 3188--><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. 3192--><p class="indent" > Note: utf8 is now the default in LaTeX and <span +class="ec-lmss-10">ucs </span>is no longer recommended. +<!--l. 3195--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.39 </span> <a + id="x1-10300011.1.39"></a>varioref</h5> +<!--l. 3196--><p class="noindent" >There are too many problems with varioref. Nobody has time to sort them out. Therefore this package is +now unsupported. +<!--l. 3199--><p class="indent" > Perhaps you are lucky and some of the features of varioref works with the following loading +order: + + + <pre class="verbatim" id="verbatim-71"> +    \usepackage{nameref} +    \usepackage{varioref} +    \usepackage{hyperref} +</pre> +<!--l. 3205--><p class="nopar" > +<!--l. 3208--><p class="indent" > Also some babel versions can be problematic. For example, 2005/05/21 v3.8g contains a patch for +varioref that breaks the hyperref support for varioref. +<!--l. 3213--><p class="indent" > Also unsupported: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 3215--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\Ref</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\Vref</span></span></span> do not uppercase the first letter. + </li> + <li class="itemize"> + <!--l. 3216--><p class="noindent" ><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. 3220--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.40 </span> <a + id="x1-10400011.1.40"></a>verse</h5> +<!--l. 3222--><p class="noindent" >Version 2005/08/22 v2.22 contains support for hyperref. +<!--l. 3224--><p class="indent" > For older versions see example from de.comp.text.tex (2005/08/11, slightly modified): + + + <pre class="verbatim" id="verbatim-72"> +  \documentclass{article} + +  % package order does not matter +  \usepackage{verse} +  \usepackage{hyperref} + +  \makeatletter +  % make unique poemline anchors +  \newcounter{verse@env} +  \setcounter{verse@env}{0} +  \let\org@verse\verse +  \def\verse{% +    \stepcounter{verse@env}% +    \org@verse +  } +  \def\theHpoemline{\arabic{verse@env}.\thepoemline} + +  % add anchor for before \addcontentsline in \@vsptitle +  \let\org@vsptitle\@vsptitle +  \def\@vsptitle{% +    \phantomsection +    \org@vsptitle +  } +  \makeatother + +  \begin{document} + +  \poemtitle{Poem 1} +  \begin{verse} +  An one-liner. +  \end{verse} + +  \newpage + +  \poemtitle{Poem 2} +  \begin{verse} +  Another one-liner. +  \end{verse} + +  \end{document} +</pre> +<!--l. 3268--><p class="nopar" > +<!--l. 3270--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.41 </span> <a + id="x1-10500011.1.41"></a>vietnam</h5> + + + <pre class="verbatim" id="verbatim-73"> + % pd1enc.def should be loaded before package dblaccnt: +  \usepackage[PD1,OT1]{fontenc} +  \usepackage{vietnam} +  \usepackage{hyperref} +</pre> +<!--l. 3276--><p class="nopar" > +<!--l. 3278--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">11.1.42 </span> <a + id="x1-10600011.1.42"></a>XeTeX</h5> +<!--l. 3280--><p class="noindent" >Default for the encoding of bookmarks is <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pdfencoding=unicode</span></span></span>. That means the strings are always +treated as unicode strings. If <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">auto</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pdfdoc</span></span></span> is forced it applies only if the string restricts to the +printable ASCII set, 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. 3286--><p class="indent" > In older versions hyperref contained special conversion code from UTF-16BE back to UTF-8 in a +number of places for xetex to avoid the xdvipdfmx warning +<!--l. 3290--><p class="indent" > <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">Failed</span><span +class="ec-lmvtt-10"> to</span><span +class="ec-lmvtt-10"> convert</span><span +class="ec-lmvtt-10"> input</span><span +class="ec-lmvtt-10"> string</span><span +class="ec-lmvtt-10"> to</span><span +class="ec-lmvtt-10"> UTF16...</span></span></span> +<!--l. 3292--><p class="indent" > This is no longer needed with a current xdvipdfmx, so this code has been removed. +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\csname</span><span +class="ec-lmvtt-10"> HyPsd@XeTeXBigCharstrue\endcsname</span></span></span> should no longer be used. +<!--l. 3298--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">12 </span> <a + id="x1-10700012"></a>Limitations<span class="footnote-mark"><a +href="hyperref-doc7.html#fn6x0"><sup class="textsuperscript">6</sup></a></span><a + id="x1-107001f6"></a> </h3> + <h4 class="subsectionHead"><span class="titlemark">12.1 </span> <a + id="x1-10800012.1"></a>Wrapped/broken link support</h4> +<!--l. 3301--><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. 3305--><p class="indent" > Workarounds: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 3307--><p class="noindent" >For long section or caption titles in the table of contents or list of figures/tables option + <span +class="ec-lmss-10">linktocpage </span>can be used. Then the page number will be a link, and the overlong section title + is not forced into an one line link with overfull <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hbox</span></span></span> warning. + </li> + <li class="itemize"> + <!--l. 3312--><p class="noindent" >“<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\url</span></span></span>”s are caught by package <span +class="ec-lmss-10">breakurl</span>. + </li> + <li class="itemize"> + <!--l. 3313--><p class="noindent" >The option <span +class="ec-lmss-10">breaklinks </span>is intended for internal use. But it can be used to force link wrapping, + e.g. when printing a document. However, when such a document is converted to PDF and + viewed with a PDF viewer, the active link area will be misplaced. + + + <!--l. 3319--><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. 3325--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">12.2 </span> <a + id="x1-10900012.2"></a>Links across pages</h4> +<!--l. 3327--><p class="noindent" >In general they have problems: + <ul class="itemize1"> + <li class="itemize"> + <!--l. 3329--><p class="noindent" >Some driver doesn’t support them at all (see above). + </li> + <li class="itemize"> + <!--l. 3330--><p class="noindent" >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. 3335--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">12.3 </span> <a + id="x1-11000012.3"></a>Footnotes</h4> +<!--l. 3337--><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 +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> to <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span> is not as strong as <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ref</span></span></span> to <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span>. Therefore it is not clear in general +which <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> references which <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span>. But that is necessary to implement hyperlinking. +Thus the implementation of hyperref does not support the optional argument of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> and +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span>. +<!--l. 3348--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">13 </span> <a + id="x1-11100013"></a>Hints<span class="footnote-mark"><a +href="hyperref-doc8.html#fn7x0"><sup class="textsuperscript">7</sup></a></span><a + id="x1-111001f7"></a> </h3> + <h4 class="subsectionHead"><span class="titlemark">13.1 </span> <a + id="x1-11200013.1"></a>Spaces in option values</h4> +<!--l. 3352--><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 +class="ec-lmvtt-10">\RequirePackage</span></span></span>), e.g.: + + + <pre class="verbatim" id="verbatim-74"> +    \usepackage[pdfborder=0 0 1]{hyperref} +</pre> +<!--l. 3356--><p class="nopar" > Package hyperref now gets + + + <pre class="verbatim" id="verbatim-75"> +    pdfborder=001 +</pre> +<!--l. 3360--><p class="nopar" > and the result is an invalid PDF file. As workaround braces can be used: + + + <pre class="verbatim" id="verbatim-76"> +    \usepackage[pdfborder={0 0 1}]{hyperref} +</pre> +<!--l. 3365--><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> + + + <pre class="verbatim" id="verbatim-77"> +    \hypersetup{pdfborder=0 0 1} +</pre> +<!--l. 3369--><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. 3375--><p class="indent" > Alternatively, LaTeX’s option handling system can be adapted to key value options by one of the +packages <span +class="ec-lmss-10">kvoptions-patch </span>(from project <span +class="ec-lmss-10">kvoptions</span>) or <span +class="ec-lmss-10">xkvltxp </span>(from project <span +class="ec-lmss-10">xsetkeys</span>). +<!--l. 3380--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">13.2 </span> <a + id="x1-11300013.2"></a>Index with makeindex</h4> + <ul class="itemize1"> + <li class="itemize"> + <!--l. 3382--><p class="noindent" >Package hyperref adds <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> commands by the encap mechanism (see documentation + of Makeindex), if option hyperindex is set (default). <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> uses the page anchors that + are set by hyperref at each page (default). However in the default case page numbers are used + in anchor names in arabic form. If the page numbers in other formats are used (book class + with <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\frontmatter</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\romannumbering</span></span></span>, ...), then the page anchors are not unique. Therefore + option <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">plainpages=false</span></span></span> is recommended. + </li> + <li class="itemize"> + <!--l. 3392--><p class="noindent" >The encap mechanism of Makeindex allows to use one command only (see documentation of + Makeindex). If the user sets such a command, hyperref suppresses its <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> command. With + logical markup this situation can easily be solved: + + + <pre class="verbatim" id="verbatim-78"> +       \usepackage{makeidx} +       \makeindex +       \usepackage[hyperindex]{hyperref} +       \newcommand*{\main}[1]{\textbf{\hyperpage{#1}}} +       ... +       \index{Some example|main} +</pre> + <!--l. 3404--><p class="nopar" > + </li> + <li class="itemize"> + <!--l. 3405--><p class="noindent" >Scientic Word/Scientific WorkPlace users can use package robustindex with hyperindex=false. + </li> + <li class="itemize"> + <!--l. 3407--><p class="noindent" >Other encap characters can be set by option <span +class="ec-lmss-10">encap</span>. Example for use of “?”: + + + <pre class="verbatim" id="verbatim-79"> +       \usepackage[encap=?]{hyperref} +</pre> + <!--l. 3411--><p class="nopar" > + </li> + <li class="itemize"> + <!--l. 3412--><p class="noindent" >Another possibility is the insertion of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> by a style file for makeindex. For this case, + hyperref’s insertion will be disabled by <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperindex=false</span></span></span>. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> will be defined regardless of + setting of hyperindex. + + + <pre class="verbatim" id="verbatim-80"> + %%% cut %%% hyperindex.ist %%% cut %%% + delim_0 ", \\hyperpage{" + delim_1 ", \\hyperpage{" + delim_2 ", \\hyperpage{" + delim_n "}, \\hyperpage{" + delim_t "}" + encap_prefix "}\\" + encap_infix "{\\hyperpage{" + encap_suffix "}" + %%% cut %%% hyperindex.ist %%% cut %%% +</pre> + <!--l. 3427--><p class="nopar" ></li></ul> +<!--l. 3430--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">13.3 </span> <a + id="x1-11400013.3"></a>Warning <span +class="ec-lmvtt-10">"bookmark level for unknown <foobar> defaults to 0"</span></h4> +<!--l. 3432--><p class="noindent" >Getting rid of it: + + + <pre class="verbatim" id="verbatim-81"> +\makeatletter +\providecommand*{\toclevel@<foobar>}{0} +\makeatother +</pre> +<!--l. 3437--><p class="nopar" > +<!--l. 3439--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">13.4 </span> <a + id="x1-11500013.4"></a>Link anchors in figures</h4> +<!--l. 3441--><p class="noindent" >The caption command increments the counter and here is the place where hyperref set the corresponding +anchor. Unhappily the caption is set below the figure, so the figure is not visible if a link jumps +to a figure. In this case, try package <span +class="ec-lmss-10">hypcap </span>that implements a method to circumvent the +problem. +<!--l. 3449--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">13.5 </span> <a + id="x1-11600013.5"></a>Additional unicode characters in bookmarks and pdf information entries:</h4> + + + <pre class="verbatim" id="verbatim-82"> +\documentclass[pdftex]{article} +\usepackage[unicode]{hyperref} +</pre> +<!--l. 3453--><p class="nopar" > +<!--l. 3455--><p class="indent" > Support for additional unicode characters: +<!--l. 3457--><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. 3459--><p class="indent" > 1. Get a list with unicode data, eg: +<!--l. 3461--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt +<!--l. 3463--><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>): + + + <pre class="verbatim" id="verbatim-83"> +    0227;LATIN SMALL LETTER A WITH DOT ABOVE;... +    1EA1;LATIN SMALL LETTER A WITH DOT BELOW;... +</pre> +<!--l. 3467--><p class="nopar" > +<!--l. 3469--><p class="indent" > 3. Calculate the octal code: +<!--l. 3471--><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.) + + + <pre class="verbatim" id="verbatim-84"> +    0227 -> \002\047 +    1EA1 -> \036\241 +</pre> +<!--l. 3478--><p class="nopar" > +<!--l. 3480--><p class="indent" > 4. Transform into a form understood by hyperref: +<!--l. 3482--><p class="indent" > Hyperref must know where the first byte starts, this is marked by <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">9</span></span></span> (8 and 9 cannot occur in octal +numbers): + + + <pre class="verbatim" id="verbatim-85"> +    \002\047 -> \9002\047 +    \036\241 -> \9036\241 +</pre> +<!--l. 3489--><p class="nopar" > +<!--l. 3491--><p class="indent" > Optional: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">8</span></span></span> is used for abbreviations: + + + <pre class="verbatim" id="verbatim-86"> +    \900 = \80, \901 = \81, \902 = \82, ... + +    \9002\047 -> \82\047 +</pre> +<!--l. 3497--><p class="nopar" > +<!--l. 3499--><p class="indent" > 5. Declare the character with LaTeX: + + + <pre class="verbatim" id="verbatim-87"> +\DeclareTextCompositeCommand{\.}{PU}{a}{\82\047} +\DeclareTextCompositeCommand{\d}{PU}{a}{\9036\241} + +\begin{document} +\section{\={a}, \d{a}, \’{a}, \.{a}} +\end{document} +       +</pre> +<!--l. 3508--><p class="nopar" > +<!--l. 3510--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">13.6 </span> <a + id="x1-11700013.6"></a>Footnotes</h4> +<!--l. 3512--><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 +class="ec-lmvtt-10">\footnotemark</span></span></span>. Here you can either disable hyperref’s footnote support by +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperfootnotes=false</span></span></span> or fiddle with internal macros, nasty examples: + + + <pre class="verbatim" id="verbatim-88"> +\documentclass{article} +\usepackage{hyperref} +\begin{document} +Hello% +\footnote{The first footnote} +World% +\addtocounter{footnote}{-1}% +\addtocounter{Hfootnote}{-1}% +\footnotemark. +\end{document} + +  or + +\documentclass{article} + +\usepackage{hyperref} + +\begin{document} + +\makeatletter + +A% +  \footnotemark +  \let\saved@Href@A\Hy@footnote@currentHref +  % remember link name +B% +  \footnotemark +  \let\saved@Href@B\Hy@footnote@currentHref +b% +  \addtocounter{footnote}{-1}% +  \addtocounter{Hfootnote}{-1}% generate the same anchor +  \footnotemark +C% +  \footnotemark +  \let\saved@Href@C\Hy@footnote@currentHref + +  \addtocounter{footnote}{-2}% +  \let\Hy@footnote@currentHref\saved@Href@A +\footnotetext{AAAA}% +  \addtocounter{footnote}{1}% +  \let\Hy@footnote@currentHref\saved@Href@B +\footnotetext{BBBBB}% +  \addtocounter{footnote}{1}% +  \let\Hy@footnote@currentHref\saved@Href@C +\footnotetext{CCCC}% + +\end{document} +</pre> +<!--l. 3566--><p class="nopar" > + +<!--l. 3568--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">13.7 </span> <a + id="x1-11800013.7"></a>Subordinate counters</h4> +<!--l. 3570--><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 +class="ec-lmvtt-10">\@addtoreset</span></span></span> to reset a counter in dependency to +another counter. Package hyperref hooks into <span class="obeylines-h"><span class="verb"><span +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. 3580--><p class="indent" > However, if the definition of subordinate counters take place before hyperref is loaded, the old +meaning of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> is called without hyperref’s additions. Then the companion counter macro +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\theH<counter></span></span></span> can be redefined accordingly. Or move the definition of subordinate counters after +hyperref is loaded. +<!--l. 3586--><p class="indent" > Example for <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\newtheorem</span></span></span>, problematic case: + + + <pre class="verbatim" id="verbatim-89"> +    \newtheorem{corA}{CorollaryA}[section] +    \usepackage{hyperref} +</pre> +<!--l. 3590--><p class="nopar" > Solution a) + + + <pre class="verbatim" id="verbatim-90"> +    \usepackage{hyperref} +    \newtheorem{corA}{CorollaryA}[section} +</pre> +<!--l. 3595--><p class="nopar" > Solution b) + + + <pre class="verbatim" id="verbatim-91"> +    \newtheorem{corA}{CorollaryA}[section] +    \usepackage{hyperref} +    \newcommand*{\theHcorA}{\theHsection.\number\value{corA}} +</pre> +<!--l. 3601--><p class="nopar" > +<!--l. 3603--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">14 </span> <a + id="x1-11900014"></a>History and acknowledgments</h3> +<!--l. 3605--><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 +class="ec-lmss-10">hyperref </span>started as a simple port of their +work to <span class="HoLogo-LaTeX2e"><span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span><span class="HoLogo-2">2</span><span class="HoLogo-e"><span +class="lmmi-10">ε</span></span></span> standards, but eventually I rewrote nearly everything, because I didn’t +understand a lot of the original, and was only interested in getting it to work with <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span>. I +would like to thank Arthur Smith, Tanmoy Bhattacharya, Mark Doyle, Paul Ginsparg, David +Carlisle, T. V. Raman and Leslie Lamport for comments, requests, thoughts and code to +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. 3618--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has +made the package more robust. The days spent on RevTeX are entirely due to him! The +investigations of Bill Moss into the later versions including native PDF support uncovered a +good many bugs, and his testing is appreciated. Hans Hagen provided a lot of insight into +PDF. +<!--l. 3626--><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 +class="ec-lmss-10">dvipdf</span>, and Hàn Thế Thành supplied all +the information needed for <span +class="ec-lmss-10">pdftex</span>. Patrick Daly kindly updated his <span +class="ec-lmss-10">natbib </span>package to allow +easy integration with <span +class="ec-lmss-10">hyperref</span>. Michael Mehlich’s <span +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. 3635--><p class="indent" > The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and +ideas; Thomas Merz, whose book <span +class="ec-lmri-10">Web Publishing with Acrobat/PDF </span>provided crucial insights; +D. P. Story, whose detailed article about pdfmarks and forms solved many practical problems; and Hans +Hagen, who explained how to do it in <span +class="ec-lmss-10">pdftex</span>. +<!--l. 3641--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost. +<!--l. 3644--><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 +<span +class="ec-lmss-10">hyperref</span>. + + + <h3 class="sectionHead"><span class="titlemark">15 </span> <a + id="x1-12000015"></a>GNU Free Documentation License</h3> +<!--l. 3684--><p class="noindent" >Version 1.2, November 2002 +<!--l. 3687--><p class="indent" > Copyright <span +class="ts1-lmr10-">©</span> 2000,2001,2002 Free Software Foundation, Inc.<br +class="newline" />59 Temple Place, Suite 330, Boston, MA 02111-1307 USA<br +class="newline" />Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is +not allowed. +<!--l. 3693--><p class="noindent" > + <h4 class="likesubsectionHead"><a + id="x1-121000"></a>Preamble</h4> +<!--l. 3695--><p class="noindent" >The purpose of this License is to make a manual, textbook, or other functional and useful document +“free” in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with +or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for +the author and publisher a way to get credit for their work, while not being considered responsible for +modifications made by others. +<!--l. 3703--><p class="indent" > This License is a kind of “copyleft”, which means that derivative works of the document must +themselves be free in the same sense. It complements the GNU General Public License, which is a +copyleft license designed for free software. +<!--l. 3708--><p class="indent" > We have designed this License in order to use it for manuals for free software, because free software +needs free documentation: a free program should come with manuals providing the same +freedoms that the software does. But this License is not limited to software manuals; it can +be used for any textual work, regardless of subject matter or whether it is published as a +printed book. We recommend this License principally for works whose purpose is instruction or +reference. +<!--l. 3717--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.1 </span> <a + id="x1-12200015.1"></a>Applicability and definitions</h4> +<!--l. 3720--><p class="noindent" >This License applies to any manual or other work, in any medium, that contains a notice placed by +the copyright holder saying it can be distributed under the terms of this License. Such a +notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under +the conditions stated herein. The “Document”, below, refers to any such manual or work. +Any member of the public is a licensee, and is addressed as “you”. You accept the license +if you copy, modify or distribute the work in a way requiring permission under copyright +law. +<!--l. 3730--><p class="indent" > A “Modified Version” of the Document means any work containing the Document or a +portion of it, either copied verbatim, or with modifications and/or translated into another +language. +<!--l. 3734--><p class="indent" > A “Secondary Section” is a named appendix or a front-matter section of the Document that deals +exclusively with the relationship of the publishers or authors of the Document to the Document’s overall +subject (or to related matters) and contains nothing that could fall directly within that overall subject. +(Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical connection with the subject or with +related matters, or of legal, commercial, philosophical, ethical or political position regarding +them. +<!--l. 3745--><p class="indent" > The “Invariant Sections” are certain Secondary Sections whose titles are designated, as being those of +Invariant Sections, in the notice that says that the Document is released under this License. If a section +does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The +Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections +then there are none. + + +<!--l. 3753--><p class="indent" > The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts or +Back-Cover Texts, in the notice that says that the Document is released under this License. +A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 +words. +<!--l. 3758--><p class="indent" > A “Transparent” copy of the Document means a machine-readable copy, represented in a format +whose specification is available to the general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or +(for drawings) some widely available drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an +otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or +discourage subsequent modification by readers is not Transparent. An image format is not +Transparent if used for any substantial amount of text. A copy that is not “Transparent” is called +“Opaque”. +<!--l. 3771--><p class="indent" > Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo +input format, LaTeX input format, SGML or XML using a publicly available DTD, and +standard-conforming simple HTML, PostScript or PDF designed for human modification. +Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include +proprietary formats that can be read and edited only by proprietary word processors, SGML +or XML for which the DTD and/or processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word processors for output purposes +only. +<!--l. 3782--><p class="indent" > The “Title Page” means, for a printed book, the title page itself, plus such following pages as are +needed to hold, legibly, the material this License requires to appear in the title page. For works in +formats which do not have any title page as such, “Title Page” means the text near the +most prominent appearance of the work’s title, preceding the beginning of the body of the +text. +<!--l. 3789--><p class="indent" > A section “Entitled XYZ” means a named subunit of the Document whose title either is precisely +XYZ or contains XYZ in parentheses following text that translates XYZ in another language. +(Here XYZ stands for a specific section name mentioned below, such as “Acknowledgements”, +“Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section when you +modify the Document means that it remains a section “Entitled XYZ” according to this +definition. +<!--l. 3797--><p class="indent" > The Document may include Warranty Disclaimers next to the notice which states that this +License applies to the Document. These Warranty Disclaimers are considered to be included by +reference in this License, but only as regards disclaiming warranties: any other implication +that these Warranty Disclaimers may have is void and has no effect on the meaning of this +License. +<!--l. 3805--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.2 </span> <a + id="x1-12300015.2"></a>Verbatim copying</h4> +<!--l. 3808--><p class="noindent" >You may copy and distribute the Document in any medium, either commercially or noncommercially, +provided that this License, the copyright notices, and the license notice saying this License applies to the +Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this +License. You may not use technical measures to obstruct or control the reading or further copying of the +copies you make or distribute. However, you may accept compensation in exchange for copies. +If you distribute a large enough number of copies you must also follow the conditions in +section <a +href="#x1-12400015.3">15.3<!--tex4ht:ref: copying --></a>. +<!--l. 3819--><p class="indent" > You may also lend copies, under the same conditions stated above, and you may publicly display +copies. + + +<!--l. 3823--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.3 </span> <a + id="x1-12400015.3"></a>Copying in quantity</h4> +<!--l. 3826--><p class="noindent" >If you publish printed copies (or copies in media that commonly have printed covers) of the Document, +numbering more than 100, and the Document’s license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front +cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly +identify you as the publisher of these copies. The front cover must present the full title with all +words of the title equally prominent and visible. You may add other material on the covers in +addition. Copying with changes limited to the covers, as long as they preserve the title of +the Document and satisfy these conditions, can be treated as verbatim copying in other +respects. +<!--l. 3839--><p class="indent" > If the required texts for either cover are too voluminous to fit legibly, you should put the first ones +listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent +pages. +<!--l. 3844--><p class="indent" > If you publish or distribute Opaque copies of the Document numbering more than 100, you must +either include a machine-readable Transparent copy along with each Opaque copy, or state in or with +each Opaque copy a computer-network location from which the general network-using public has access +to download using public-standard network protocols a complete Transparent copy of the Document, free +of added material. If you use the latter option, you must take reasonably prudent steps, when you +begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will +remain thus accessible at the stated location until at least one year after the last time you +distribute an Opaque copy (directly or through your agents or retailers) of that edition to the +public. +<!--l. 3857--><p class="indent" > It is requested, but not required, that you contact the authors of the Document well before +redistributing any large number of copies, to give them a chance to provide you with an updated version +of the Document. +<!--l. 3862--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.4 </span> <a + id="x1-12500015.4"></a>Modifications</h4> +<!--l. 3865--><p class="noindent" >You may copy and distribute a Modified Version of the Document under the conditions of sections <a +href="#x1-12300015.2">15.2<!--tex4ht:ref: verbatim --></a> +and <a +href="#x1-12400015.3">15.3<!--tex4ht:ref: copying --></a> above, provided that you release the Modified Version under precisely this License, with the +Modified Version filling the role of the Document, thus licensing distribution and modification of the +Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified +Version: +<!--l. 3874--><p class="indent" > + <ol class="enumerate1" > +<li + class="enumerate" id="x1-125002x1"> + <!--l. 3875--><p class="noindent" >Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, + and from those of previous versions (which should, if there were any, be listed in the History + section of the Document). You may use the same title as a previous version if the original + publisher of that version gives permission. + </li> +<li + class="enumerate" id="x1-125004x2"> + <!--l. 3880--><p class="noindent" >List on the Title Page, as authors, one or more persons or entities responsible for authorship + of the modifications in the Modified Version, together with at least five of the principal + authors of the Document (all of its principal authors, if it has fewer than five), unless they + release you from this requirement. + + </li> +<li + class="enumerate" id="x1-125006x3"> + <!--l. 3885--><p class="noindent" >State on the Title page the name of the publisher of the Modified Version, as the publisher. + </li> +<li + class="enumerate" id="x1-125008x4"> + <!--l. 3887--><p class="noindent" >Preserve all the copyright notices of the Document. + </li> +<li + class="enumerate" id="x1-125010x5"> + <!--l. 3888--><p class="noindent" >Add an appropriate copyright notice for your modifications adjacent to the other copyright + notices. + </li> +<li + class="enumerate" id="x1-125012x6"> + <!--l. 3890--><p class="noindent" >Include, immediately after the copyright notices, a license notice giving the public permission + to use the Modified Version under the terms of this License, in the form shown in the + Addendum below. + </li> +<li + class="enumerate" id="x1-125014x7"> + <!--l. 3893--><p class="noindent" >Preserve in that license notice the full lists of Invariant Sections and required Cover Texts + given in the Document’s license notice. + </li> +<li + class="enumerate" id="x1-125016x8"> + <!--l. 3895--><p class="noindent" >Include an unaltered copy of this License. + </li> +<li + class="enumerate" id="x1-125018x9"> + <!--l. 3896--><p class="noindent" >Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at + least the title, year, new authors, and publisher of the Modified Version as given on the Title + Page. If there is no section Entitled “History” in the Document, create one stating the title, + year, authors, and publisher of the Document as given on its Title Page, then add an item + describing the Modified Version as stated in the previous sentence. + </li> +<li + class="enumerate" id="x1-125020x10"> + <!--l. 3903--><p class="noindent" >Preserve the network location, if any, given in the Document for public access to a + Transparent copy of the Document, and likewise the network locations given in the Document + for previous versions it was based on. These may be placed in the “History” section. You + may omit a network location for a work that was published at least four years before the + Document itself, or if the original publisher of the version it refers to gives permission. + + + </li> +<li + class="enumerate" id="x1-125022x11"> + <!--l. 3910--><p class="noindent" >For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the + section, and preserve in the section all the substance and tone of each of the contributor + acknowledgements and/or dedications given therein. + </li> +<li + class="enumerate" id="x1-125024x12"> + <!--l. 3914--><p class="noindent" >Preserve all the Invariant Sections of the Document, unaltered in their text and in their + titles. Section numbers or the equivalent are not considered part of the section titles. + </li> +<li + class="enumerate" id="x1-125026x13"> + <!--l. 3917--><p class="noindent" >Delete any section Entitled “Endorsements”. Such a section may not be included in the + Modified Version. + </li> +<li + class="enumerate" id="x1-125028x14"> + <!--l. 3919--><p class="noindent" >Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with + any Invariant Section. + </li> +<li + class="enumerate" id="x1-125030x15"> + <!--l. 3921--><p class="noindent" >Preserve any Warranty Disclaimers. + </li></ol> +<!--l. 3925--><p class="indent" > If the Modified Version includes new front-matter sections or appendices that qualify as Secondary +Sections and contain no material copied from the Document, you may at your option designate some or +all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in +the Modified Version’s license notice. These titles must be distinct from any other section +titles. +<!--l. 3932--><p class="indent" > You may add a section Entitled “Endorsements”, provided it contains nothing but endorsements of +your Modified Version by various parties–for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a standard. +<!--l. 3938--><p class="indent" > You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as +a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any +one entity. If the Document already includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, you may not add another; but you +may replace the old one, on explicit permission from the previous publisher that added the old +one. +<!--l. 3948--><p class="indent" > The author(s) and publisher(s) of the Document do not by this License give permission to use their +names for publicity for or to assert or imply endorsement of any Modified Version. + + +<!--l. 3953--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.5 </span> <a + id="x1-12600015.5"></a>Combining documents</h4> +<!--l. 3956--><p class="noindent" >You may combine the Document with other documents released under this License, under the terms +defined in section <a +href="#x1-12500015.4">15.4<!--tex4ht:ref: modifications --></a> above for modified versions, provided that you include in the combination all of +the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant +Sections of your combined work in its license notice, and that you preserve all their Warranty +Disclaimers. +<!--l. 3964--><p class="indent" > The combined work need only contain one copy of this License, and multiple identical Invariant +Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name +but different contents, make the title of each such section unique by adding at the end of it, in +parentheses, the name of the original author or publisher of that section if known, or else a unique +number. Make the same adjustment to the section titles in the list of Invariant Sections in the license +notice of the combined work. +<!--l. 3973--><p class="indent" > In the combination, you must combine any sections Entitled “History” in the various original +documents, forming one section Entitled “History”; likewise combine any sections Entitled +“Acknowledgements”, and any sections Entitled “Dedications”. You must delete all sections Entitled +“Endorsements”. +<!--l. 3980--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.6 </span> <a + id="x1-12700015.6"></a>Collections of documents</h4> +<!--l. 3983--><p class="noindent" >You may make a collection consisting of the Document and other documents released under this License, +and replace the individual copies of this License in the various documents with a single copy that is +included in the collection, provided that you follow the rules of this License for verbatim copying of each +of the documents in all other respects. +<!--l. 3989--><p class="indent" > You may extract a single document from such a collection, and distribute it individually under this +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. 3995--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.7 </span> <a + id="x1-12800015.7"></a>Aggregation with independent works</h4> +<!--l. 3998--><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 “aggregate” if the copyright +resulting from the compilation is not used to limit the legal rights of the compilation’s users beyond what +the individual works permit. When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves derivative works of the +Document. +<!--l. 4007--><p class="indent" > If the Cover Text requirement of section <a +href="#x1-12400015.3">15.3<!--tex4ht:ref: copying --></a> is applicable to these copies of the Document, then if +the Document is less than one half of the entire aggregate, the Document’s Cover Texts may be placed +on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the +Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole +aggregate. +<!--l. 4016--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.8 </span> <a + id="x1-12900015.8"></a>Translation</h4> +<!--l. 4019--><p class="noindent" >Translation is considered a kind of modification, so you may distribute translations of the Document +under the terms of section <a +href="#x1-12500015.4">15.4<!--tex4ht:ref: modifications --></a>. Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include translations of some or all Invariant +Sections in addition to the original versions of these Invariant Sections. You may include a translation of + +this License, and all the license notices in the Document, and any Warranty Disclaimers, +provided that you also include the original English version of this License and the original +versions of those notices and disclaimers. In case of a disagreement between the translation +and the original version of this License or a notice or disclaimer, the original version will +prevail. +<!--l. 4033--><p class="indent" > If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the +requirement (section <a +href="#x1-12500015.4">15.4<!--tex4ht:ref: modifications --></a>) to Preserve its Title (section <a +href="#x1-12200015.1">15.1<!--tex4ht:ref: applicability --></a>) will typically require changing the actual +title. +<!--l. 4040--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.9 </span> <a + id="x1-13000015.9"></a>Termination</h4> +<!--l. 4043--><p class="noindent" >You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under +this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, parties who have received copies, or +rights, from you under this License will not have their licenses terminated so long as such parties remain +in full compliance. +<!--l. 4052--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">15.10 </span> <a + id="x1-13100015.10"></a>Future revisions of this license</h4> +<!--l. 4055--><p class="noindent" >The Free Software Foundation may publish new, revised versions of the GNU Free Documentation +License from time to time. Such new versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. +<!--l. 4061--><p class="indent" > Each version of the License is given a distinguishing version number. If the Document specifies that a +particular numbered version of this License “or any later version” applies to it, you have the option of +following the terms and conditions either of that specified version or of any later version that has been +published (not as a draft) by the Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not as a draft) by the Free Software +Foundation. +<!--l. 4071--><p class="noindent" > + <h4 class="likesubsectionHead"><a + id="x1-132000"></a>Addendum: how to use this license for your documents</h4> +<!--l. 4073--><p class="noindent" >To use this License in a document you have written, include a copy of the License in the document and +put the following copyright and license notices just after the title page: +<!--l. 4077--><p class="indent" > + <blockquote class="quote"> + <!--l. 4078--><p class="noindent" >Copyright <span +class="ts1-lmr10-">©</span> YEAR YOUR NAME. Permission is granted to copy, distribute and/or + modify this document under the terms of the GNU Free Documentation License, + Version 1.2 or any later version published by the Free Software Foundation; with no + Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the + license is included in the section entitled “GNU Free Documentation License”.</blockquote> +<!--l. 4087--><p class="indent" > If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” +line with this: +<!--l. 4090--><p class="indent" > with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and +with the Back-Cover Texts being LIST. + + +<!--l. 4093--><p class="indent" > If you have Invariant Sections without Cover Texts, or some other combination of the three, merge +those two alternatives to suit the situation. +<!--l. 4097--><p class="indent" > If your document contains nontrivial examples of program code, we recommend releasing these +examples in parallel under your choice of free software license, such as the GNU General Public License, +to permit their use in free software. + +</body></html> + + + + diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.pdf b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.pdf Binary files differindex 94a2a192bdf..95b21e342ca 100644 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex index 12f5533b192..88f4c957531 100644 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex @@ -166,7 +166,7 @@ } \makeatother \title{Hypertext marks in \hologo{LaTeX}: a manual for \xpackage{hyperref}} -\date{2023-06-25 v7.01a} +\date{2023-07-08 v7.01b} \begin{document} @@ -1332,16 +1332,22 @@ action dictionaries, see PDF specification. \ci{url}\verb|{|\emph{URL}\verb|}| \end{cmdsyntax} -\noindent Similar to -\ci{href}\verb|{|\emph{URL}\verb|}{|\ci{nolinkurl}\verb|{|\emph{URL}\verb|}}|. -Depending on the driver \verb|\href| also tries to detect the link type. -Thus the result can be a url link, file link, \dots +\noindent Similar to +\ci{href}\verb|{|\emph{URL}\verb|}{|\ci{nolinkurl}\verb|{|\emph{URL}\verb|}}|. +Depending on the driver \verb|\href| also tries to detect the link type. Thus +the result can be a url link, file link, \dots. The implementation makes use +of the \xpackage{url} package and its commands can be used to format and fine +tune the url, but the behaviour of \ci{url} is different to the behaviour in +the \xpackage{url} package: Most importantly the hyperref \cs{url} expands +commands. If the behaviour or the original \cs{url} is needed, the url +package should be loaded first and the command should be copied into some +alias command. \begin{cmdsyntax} \ci{nolinkurl}\verb|{|\emph{URL}\verb|}| \end{cmdsyntax} -\noindent Write \emph{URL} in the same way as \verb|\url|, +\noindent Write \emph{URL} in the same way as \verb|\url| described above, without creating a hyperlink. \begin{cmdsyntax} diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc2.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc2.html new file mode 100644 index 00000000000..c9fa9e4df35 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc2.html @@ -0,0 +1,21 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <!--l. 212--><p class="indent" > <span class="footnote-mark"><a + id="fn1x0"><a + id="x2-4002x2"></a> <sup class="textsuperscript">1</sup></a></span><span +class="ec-lmr-8">Now: </span><a +href="https://ctan.org/tex-archive/support/hypertex/hypertex" class="url" ><span +class="ec-lmvtt-10x-x-80">https://ctan.org/tex-archive/support/hypertex/hypertex</span></a></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc3.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc3.html new file mode 100644 index 00000000000..516b3b25733 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc3.html @@ -0,0 +1,19 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <!--l. 230--><p class="indent" > <span class="footnote-mark"><a + id="fn2x0"><a + id="x3-4004x2"></a> <sup class="textsuperscript">2</sup></a></span><span +class="ec-lmr-8">This is borrowed from an article by Arthur Smith.</span></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc4.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc4.html new file mode 100644 index 00000000000..7e3e6a54ebd --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc4.html @@ -0,0 +1,25 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <!--l. 295--><p class="indent" > <span class="footnote-mark"><a + id="fn3x0"><a + id="x4-4006x2"></a> <sup class="textsuperscript">3</sup></a></span><span +class="ec-lmr-8">Make sure you turn off the partial font downloading supported by </span><span +class="ec-lmss-8">dvips </span><span +class="ec-lmr-8">and </span><span +class="ec-lmss-8">dvipsone </span><span +class="ec-lmr-8">in favor of Distiller’s own</span> + <span +class="ec-lmr-8">system.</span></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc5.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc5.html new file mode 100644 index 00000000000..5b80632c3df --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc5.html @@ -0,0 +1,21 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <!--l. 333--><p class="indent" > <span class="footnote-mark"><a + id="fn4x0"><a + id="x5-5002x3"></a> <sup class="textsuperscript">4</sup></a></span><span +class="ec-lmr-8">But work has started to reduce the number of redefinition and so the dependencies on the loading</span> + <span +class="ec-lmr-8">order.</span></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc6.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc6.html new file mode 100644 index 00000000000..86b6169f821 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc6.html @@ -0,0 +1,19 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <span class="footnote-mark"><a + id="fn5x0"><a + id="x6-28002x7"></a> <sup class="textsuperscript">5</sup></a></span><span +class="ec-lmr-8">This section moved from the README file, needs more integration into the manual</span></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc7.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc7.html new file mode 100644 index 00000000000..97b0248da7d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc7.html @@ -0,0 +1,19 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <span class="footnote-mark"><a + id="fn6x0"><a + id="x7-107002x12"></a> <sup class="textsuperscript">6</sup></a></span><span +class="ec-lmr-8">This section moved from the README file, needs more integration into the manual</span></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc8.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc8.html new file mode 100644 index 00000000000..ec67959b8a4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc8.html @@ -0,0 +1,19 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title></title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)"> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)"> +<!-- html --> +<meta name="src" content="hyperref-doc.tex"> +<link rel="stylesheet" type="text/css" href="hyperref-doc.css"> +</head><body +> + <div class="footnote-text"> + <span class="footnote-mark"><a + id="fn7x0"><a + id="x8-111002x13"></a> <sup class="textsuperscript">7</sup></a></span><span +class="ec-lmr-8">This section moved from the README file, needs more integration into the manual</span></div> + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-linktarget.pdf b/Master/texmf-dist/doc/latex/hyperref/hyperref-linktarget.pdf Binary files differindex dc18af60f1f..1a5c95d3fa7 100644 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-linktarget.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-linktarget.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf b/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf Binary files differindex 4889dc2a2a5..09fd05e1142 100644 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/nameref.pdf b/Master/texmf-dist/doc/latex/hyperref/nameref.pdf Binary files differindex 0eb1a45b131..3abd7017627 100644 --- a/Master/texmf-dist/doc/latex/hyperref/nameref.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/nameref.pdf |