diff options
author | Karl Berry <karl@freefriends.org> | 2023-06-25 22:26:58 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-06-25 22:26:58 +0000 |
commit | e2b471ee57adf753b0637108df1aa1e2fc378721 (patch) | |
tree | 2e1751d161f2fdb660da6fcd61ac707f26646fc7 /Master/texmf-dist/doc | |
parent | ebae48848fc5e4574efcff1e149bff84aca7e993 (diff) |
hyperref (26jun23)
git-svn-id: svn://tug.org/texlive/trunk@67471 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
17 files changed, 10 insertions, 8938 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt index f471e510844..0c9421dd128 100644 --- a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt +++ b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt @@ -1,3 +1,11 @@ +2023-06-25 Ulrike Fischer + * define the amsmath \ifmeasuring@ always as external package depend on hyperref doing it. + +2023-06-18 Ulrike Fischer + * changed various patches for amsmath to make them independent of loading order. + * nameref: check the definition of label and reinstate the kernel definition if it has been changed. + This avoid problems with classes (revtex) and packages (ntheorem) which changes \label in an incompatible way. + 2023-05-16 Ulrike Fischer * remove puenc-greekbasic.def and load definitions from greek-fontenc instead. * xr-hyper: unified and simplified the brace handling: all defined references have now diff --git a/Master/texmf-dist/doc/latex/hyperref/README.md b/Master/texmf-dist/doc/latex/hyperref/README.md index a020d71328e..013d3d82e96 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-05-16 v7.00y +Version 2023-06-25 v7.01a ## INTRODUCTION diff --git a/Master/texmf-dist/doc/latex/hyperref/backref.pdf b/Master/texmf-dist/doc/latex/hyperref/backref.pdf Binary files differindex ed0fa58e7b9..10bc5158a7a 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 deleted file mode 100644 index a135ec3c7e0..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.css +++ /dev/null @@ -1,320 +0,0 @@ - -/* 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 deleted file mode 100644 index 1d029c9ed6b..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.html +++ /dev/null @@ -1,8473 +0,0 @@ -<!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-05-16 v7.00y</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 or for most current engines autodetected; at present, the following drivers are -supported: - <dl class="description"><dt class="description"> - <!--l. 273--><p class="noindent" > -<span -class="ec-lmbx-10">hypertex</span> </dt><dd -class="description"> - <!--l. 273--><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. 275--><p class="noindent" > -<span -class="ec-lmbx-10">dvips</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">dvips</span>. This is the default driver if dvi mode is - detected. - </dd><dt class="description"> - <!--l. 277--><p class="noindent" > -<span -class="ec-lmbx-10">dvipsone</span> </dt><dd -class="description"> - <!--l. 277--><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. 278--><p class="noindent" > -<span -class="ec-lmbx-10">ps2pdf</span> </dt><dd -class="description"> - <!--l. 278--><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. 280--><p class="noindent" > -<span -class="ec-lmbx-10">tex4ht</span> </dt><dd -class="description"> - <!--l. 280--><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>, autodetected. - </dd><dt class="description"> - <!--l. 281--><p class="noindent" > -<span -class="ec-lmbx-10">pdftex</span> </dt><dd -class="description"> - <!--l. 281--><p class="noindent" >pdfTeX, Hàn Thế Thành’s TeX variant that writes PDF directly, autodetected. - </dd><dt class="description"> - <!--l. 282--><p class="noindent" > -<span -class="ec-lmbx-10">luatex</span> </dt><dd -class="description"> - <!--l. 282--><p class="noindent" >luaTeX, Unicode TeX variant that writes PDF directly, autodetected. - </dd><dt class="description"> - <!--l. 283--><p class="noindent" > -<span -class="ec-lmbx-10">dvipdfm</span> </dt><dd -class="description"> - <!--l. 283--><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. 284--><p class="noindent" > -<span -class="ec-lmbx-10">dvipdfmx</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 for driver <span -class="ec-lmss-10">dvipdfmx</span>, a successor of <span -class="ec-lmss-10">dvipdfm</span> - </dd><dt class="description"> - <!--l. 286--><p class="noindent" > -<span -class="ec-lmbx-10">dviwindo</span> </dt><dd -class="description"> - <!--l. 286--><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. 287--><p class="noindent" > -<span -class="ec-lmbx-10">vtex</span> </dt><dd -class="description"> - <!--l. 287--><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, autodetected. - </dd><dt class="description"> - <!--l. 290--><p class="noindent" > -<span -class="ec-lmbx-10">textures</span> </dt><dd -class="description"> - <!--l. 290--><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. 291--><p class="noindent" > -<span -class="ec-lmbx-10">xetex</span> </dt><dd -class="description"> - <!--l. 291--><p class="noindent" >produces <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\special</span></span></span> commands for XeTeX, autodetected. - </dd><dt class="description"> - <!--l. 292--><p class="noindent" > -<span -class="ec-lmbx-10">hitex</span> </dt><dd -class="description"> - <!--l. 292--><p class="noindent" >(new 2023) for the hint format produces by the HiTeX engine, autodetected. This a quite - experimental engine and the driver file is not part of the <span -class="ec-lmss-10">hyperref </span>bundle but is provided by - the <span -class="ec-lmss-10">hitex </span>package. Problems should be reported to <a -href="https://github.com/ruckertm/HINT" class="url" ><span -class="ec-lmvtt-10">https://github.com/ruckertm/HINT</span></a>.</dd></dl> -<!--l. 297--><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. 308--><p class="noindent" > -<span -class="ec-lmbx-10">driverfallback</span> </dt><dd -class="description"> - <!--l. 308--><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. 313--><p class="noindent" ><span -class="ec-lmvtt-10">driverfallback=dvipdfm</span></blockquote> - <!--l. 315--><p class="noindent" >Autodetected drivers (<span -class="ec-lmss-10">pdftex</span>, <span -class="ec-lmss-10">luatex</span>, <span -class="ec-lmss-10">xetex</span>, <span -class="ec-lmss-10">vtex</span>, <span -class="ec-lmss-10">vtexpdfmark</span>, <span -class="ec-lmss-10">hitex</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. 328--><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. 333--><p class="nopar" > -<!--l. 335--><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. 340--><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. 346--><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. 352--><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. 362--><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. 370--><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. 375--><p class="indent" > This section is work in progress. Suggestions or comments are welcome. -<!--l. 378--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a - id="x1-70004.1"></a>Counters</h4> -<!--l. 379--><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. 383--><p class="indent" > - <dl class="description"><dt class="description"> - <!--l. 385--><p class="noindent" > -<span -class="ec-lmvtk-10">\theH<counter></span> </dt><dd -class="description"> - - <!--l. 385--><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. 392--><p class="noindent" > -<span -class="ec-lmvtk-10">\toclevel@<counter></span> </dt><dd -class="description"> - <!--l. 392--><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. 405--><p class="nopar" > - </dd></dl> -<!--l. 409--><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. 410--><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. 418--><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. 426--><p class="nopar" > -<!--l. 428--><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. 431--><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. 439--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">4.3 </span> <a - id="x1-90004.3"></a>Links commands</h4> -<!--l. 440--><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. 455--><p class="nopar" > -<!--l. 457--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">4.4 </span> <a - id="x1-100004.4"></a>Creating targets</h4> -<!--l. 459--><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. 465--><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. 469--><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. 472--><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. 473--><p class="noindent" >The target created by the <span -class="ec-lmvtt-10">\refstepcounter </span>can affect spacing. - </li> - <li class="itemize"> - <!--l. 474--><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. 478--><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. 487--><p class="nopar" > -<!--l. 489--><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. 492--><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. 499--><p class="nopar" > -<!--l. 501--><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. 503--><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. 510--><p class="indent" > - <dl class="description"><dt class="description"> - <!--l. 511--><p class="noindent" > -<span -class="ec-lmbx-10">sectioning commands</span> </dt><dd -class="description"> - <!--l. 511--><p class="noindent" > - <ul class="itemize1"> - <li class="itemize"> - <!--l. 513--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>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. 516--><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. 522--><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. 530--><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. 535--><p class="noindent" > -<span -class="ec-lmbx-10">footnotes</span> </dt><dd -class="description"> - - <!--l. 535--><p class="noindent" >To enable (partly) the linking of footnotes <span -class="ec-lmss-10">hyperref </span>redefines or patches various commands, in part - package dependant. - <ul class="itemize1"> - <li class="itemize"> - <!--l. 537--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>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. 542--><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. 545--><p class="noindent" > -<span -class="ec-lmbx-10">amsmath tags</span> </dt><dd -class="description"> - <!--l. 545--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>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. 551--><p class="noindent" > -<span -class="ec-lmbx-10">counters</span> </dt><dd -class="description"> - <!--l. 551--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>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. 559--><p class="noindent" > -<span -class="ec-lmbx-10">math environments</span> </dt><dd -class="description"> - <!--l. 559--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>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. 563--><p class="noindent" > -<span -class="ec-lmbx-10">table of contents</span> </dt><dd -class="description"> - <!--l. 563--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>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><dt class="description"> - <!--l. 567--><p class="noindent" > -<span -class="ec-lmbx-10">captions</span> </dt><dd -class="description"> - <!--l. 567--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>redefines <span -class="ec-lmvtt-10">\caption </span>and <span -class="ec-lmvtt-10">\@caption </span>to insert targets for links. This code can be suppressed - by defining <span -class="ec-lmvtt-10">\hyper@nopatch@caption </span>(additional helper commands are not suppressed). As - various packages redefine captions too (e.g. the <span -class="ec-lmss-10">caption </span>package) side-effects must be carefully - tested! - - </dd><dt class="description"> - <!--l. 572--><p class="noindent" > -<span -class="ec-lmbx-10">longtable</span> </dt><dd -class="description"> - <!--l. 572--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>redefines <span -class="ec-lmvtt-10">\LT@start </span>and <span -class="ec-lmvtt-10">\LT@array </span>to move the targets in a better place. This code can - be suppressed by defining <span -class="ec-lmvtt-10">\hyper@nopatch@longtable</span> - </dd><dt class="description"> - <!--l. 575--><p class="noindent" > -<span -class="ec-lmbx-10">theorems</span> </dt><dd -class="description"> - <!--l. 575--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>patches <span -class="ec-lmvtt-10">\@thm</span>. This code can be suppressed by defining <span -class="ec-lmvtt-10">\hyper@nopatch@thm</span> - </dd><dt class="description"> - <!--l. 577--><p class="noindent" > -<span -class="ec-lmbx-10">citations and bibliography</span> </dt><dd -class="description"> - <!--l. 577--><p class="noindent" >If <span -class="ec-lmss-10">natbib </span>is not loaded <span -class="ec-lmss-10">hyperref </span>redefines <span -class="ec-lmvtt-10">\bibcite</span>, <span -class="ec-lmvtt-10">\@lbibitem </span>and <span -class="ec-lmvtt-10">\@bibitem</span>. These redefinitions - can be suppressed by defining <span -class="ec-lmvtt-10">\hyper@nopatch@bib</span>.</dd></dl> -<!--l. 581--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">5 </span> <a - id="x1-120005"></a>Package options</h3> -<!--l. 583--><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. 591--><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 <span -class="ec-lmss-10">hyperref </span>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. 598--><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. 599--><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. 601--><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. 602--><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. 603--><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. 604--><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. 606--><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. 607--><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. 608--><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. 609--><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. 610--><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. 611--><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. 612--><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. 613--><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. 614--><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. 614--><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. 615--><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. 616--><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. 621--><p class="indent" > As an example, the behavior of a particular file could be controlled by: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 624--><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. 631--><p class="nopar" > - </li> - <li class="itemize"> - <!--l. 633--><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. 638--><p class="nopar" > - </li> - <li class="itemize"> - <!--l. 640--><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. 646--><p class="nopar" ></li></ul> -<!--l. 649--><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. 659--><p class="nopar" > -<!--l. 661--><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. 665--><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. 670--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.1 </span> <a - id="x1-130005.1"></a>General options</h4> -<!--l. 672--><p class="noindent" >Firstly, the options to specify general behavior and page size. -<!--l. 675--><p class="indent" > -<a - id="x1-13001r1"></a> <!--l. 676--><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. 685--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.2 </span> <a - id="x1-140005.2"></a>Options for destination names</h4> -<!--l. 687--><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. 692--><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. 698--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">chapter.4</span></span></span></blockquote> -<!--l. 700--><p class="noindent" >This scheme is used by: - <dl class="description"><dt class="description"> - <!--l. 702--><p class="noindent" > -<span -class="ec-lmvtk-10">\autoref</span> </dt><dd -class="description"> - <!--l. 702--><p class="noindent" >displays the description label for the reference depending on the counter name. - - - </dd><dt class="description"> - <!--l. 704--><p class="noindent" > -<span -class="ec-lmvtk-10">\hyperpage</span> </dt><dd -class="description"> - <!--l. 704--><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. 709--><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. 722--><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. 728--><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. 736--><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. 741--><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. 754--><p class="nopar" ></blockquote> -<!--l. 756--><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. 759--><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. 764--><p class="nopar" ></blockquote> -<!--l. 766--><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. 775--><p class="nopar" ></blockquote> -<!--l. 777--><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. 792--><p class="nopar" ></blockquote> -<!--l. 794--><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. 812--><p class="nopar" ></blockquote> -<!--l. 815--><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. 818--><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. 821--><p class="indent" > Hint: Anchors can also be named and set by <span -class="ec-lmvtt-10">\hypertarget</span>. -<!--l. 824--><p class="indent" > -<a - id="x1-14001r2"></a> <!--l. 825--><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. 833--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.3 </span> <a - id="x1-150005.3"></a>Configuration options</h4> -<!--l. 835--><p class="noindent" > -<a - id="x1-15001r3"></a> <!--l. 836--><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. 836--><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. 839--><p class="noindent" >This option is in <span -class="ec-lmss-10">hyperref </span>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. 841--><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. 844--><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. 847--><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. 852--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.4 </span> <a - id="x1-160005.4"></a>Backend drivers</h4> -<!--l. 854--><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. 857--><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. 859--><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. 861--><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. 863--><p class="noindent" >Package default is <span -class="ec-lmss-10">hypertex</span>.</li></ol> -<!--l. 865--><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. 870--><p class="indent" > -<a - id="x1-16009r4"></a> <!--l. 871--><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. 871--><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. 872--><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. 873--><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. 874--><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. 875--><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. 876--><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. 877--><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. 878--><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. 879--><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. 880--><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. 881--><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. 882--><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. 883--><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. 886--><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. 887--><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. 888--><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. 890--><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. 891--><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. 895--><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. 904--><p class="nopar" > -<!--l. 906--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.5 </span> <a - id="x1-170005.5"></a>Extension options</h4> -<!--l. 907--><p class="noindent" > -<a - id="x1-17001r5"></a> <!--l. 908--><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. 908--><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. 911--><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. 911--><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. 915--><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. 917--><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. 920--><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. 922--><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. 923--><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. 924--><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. 925--><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. 927--><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. 932--><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. 933--><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. 934--><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. 935--><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. 936--><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. 937--><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. 938--><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. 939--><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. 940--><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. 941--><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. 944--><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. 947--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.6 </span> <a - id="x1-180005.6"></a>PDF-specific display options</h4> -<!--l. 948--><p class="noindent" > -<a - id="x1-18001r6"></a> <!--l. 949--><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. 949--><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. 955--><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. 957--><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. 958--><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. 959--><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. 961--><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 <span -class="ec-lmss-10">hyperref </span>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. 973--><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. 976--><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. 979--><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. 980--><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. 981--><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. 982--><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. 983--><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. 984--><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. 985--><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. 986--><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. 990--><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. 996--><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. 1003--><p class="nopar" > -<!--l. 1005--><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. 1006--><p class="noindent" > -<a - id="x1-19001r7"></a> <!--l. 1007--><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. 1007--><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. 1007--><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. 1008--><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. 1008--><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. 1013--><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. 1013--><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. 1014--><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. 1014--><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. 1015--><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. 1015--><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. 1016--><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. 1016--><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. 1017--><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. 1017--><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. 1018--><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. 1018--><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. 1019--><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. 1019--><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. 1022--><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. 1022--><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. 1024--><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. 1024--><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. 1025--><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. 1025--><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. 1026--><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. 1026--><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. 1027--><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. 1027--><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. 1028--><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. 1028--><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. 1029--><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. 1029--><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. 1030--><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. 1030--><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. 1032--><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. 1032--><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. 1033--><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. 1033--><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. 1038--><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. 1038--><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. 1039--><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. 1039--><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. 1040--><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. 1040--><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. 1041--><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. 1041--><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. 1043--><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. 1043--><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. 1045--><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. 1045--><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. 1046--><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. 1046--><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. 1050--><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. 1050--><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. 1051--><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. 1051--><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. 1060--><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. 1060--><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. 1061--><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. 1061--><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. 1065--><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. 1065--><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. 1069--><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. 1070--><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. 1071--><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. 1071--><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. 1076--><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. 1076--><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. 1077--><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. 1077--><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. 1081--><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. 1081--><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. 1085--><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. 1085--><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. 1086--><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. 1086--><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. 1089--><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">61<!--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. 1101--><p class="indent" > -<a - id="x1-19002r8"></a> <!--l. 1102--><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. 1102--><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. 1104--><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. 1105--><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. 1106--><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. 1107--><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. 1108--><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. 1109--><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. 1110--><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. 1113--><p class="indent" > The <span -class="ec-lmvtt-10">pdfpagelayout </span>can be one of the following values. -<!--l. 1115--><p class="indent" > -<a - id="x1-19003r9"></a> <!--l. 1116--><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. 1116--><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. 1117--><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. 1118--><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. 1119--><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. 1120--><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. 1121--><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. 1124--><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. 1131--><p class="indent" > -<a - id="x1-19004r10"></a> <!--l. 1132--><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. 1132--><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. 1134--><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. 1135--><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. 1136--><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. 1137--><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. 1138--><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. 1139--><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. 1140--><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. 1143--><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. 1146--><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. 1148--><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. 1151--><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. 1155--><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. 1157--><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. 1176--><p class="nopar" ></blockquote> -<!--l. 1179--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">5.9 </span> <a - id="x1-210005.9"></a>Big alphabetical list</h4> -<!--l. 1181--><p class="noindent" >The following is a complete listing of available options for <span -class="ec-lmss-10">hyperref</span>, arranged alphabetically. -<!--l. 1184--><p class="indent" > -<a - id="x1-21001r11"></a> <!--l. 1185--><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. 1185--><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. 1186--><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. 1187--><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. 1188--><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. 1189--><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. 1190--><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. 1191--><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. 1192--><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. 1193--><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. 1194--><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. 1195--><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. 1196--><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. 1197--><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. 1198--><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. 1199--><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. 1200--><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. 1201--><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. 1202--><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. 1203--><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. 1204--><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. 1205--><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. 1206--><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. 1207--><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. 1208--><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. 1209--><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. 1210--><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. 1211--><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. 1212--><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. 1213--><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. 1214--><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. 1215--><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. 1216--><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. 1217--><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. 1218--><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. 1219--><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. 1220--><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. 1221--><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. 1222--><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. 1223--><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. 1224--><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. 1225--><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. 1226--><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. 1227--><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. 1228--><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. 1229--><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. 1230--><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. 1231--><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. 1232--><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. 1233--><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. 1234--><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. 1235--><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. 1236--><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. 1237--><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. 1238--><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. 1239--><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. 1240--><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. 1241--><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. 1243--><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. 1243--><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. 1244--><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. 1246--><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. 1248--><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. 1249--><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. 1250--><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. 1251--><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. 1252--><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. 1253--><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. 1254--><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. 1255--><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. 1256--><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. 1258--><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. 1260--><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. 1261--><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. 1262--><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. 1263--><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. 1264--><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. 1265--><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. 1267--><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. 1268--><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. 1269--><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. 1270--><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. 1271--><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. 1272--><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. 1273--><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. 1274--><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. 1275--><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. 1276--><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. 1277--><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. 1278--><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. 1279--><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. 1280--><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. 1283--><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. 1284--><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. 1285--><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. 1286--><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. 1287--><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. 1288--><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. 1289--><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. 1290--><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. 1291--><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. 1292--><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. 1293--><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. 1294--><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. 1295--><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. 1296--><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. 1297--><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. 1298--><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. 1299--><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. 1300--><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. 1301--><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. 1304--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">6 </span> <a - id="x1-220006"></a>Additional user macros</h3> -<!--l. 1306--><p class="noindent" >If you need to make references to URLs, or write explicit links, the following low-level user macros are -provided: -<!--l. 1309--><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. 1313--><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. 1318--><p class="indent" > The optional argument <span -class="ec-lmri-10">options </span>recognizes the <span -class="ec-lmss-10">hyperref </span>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. 1322--><p class="noindent" > -<span -class="ec-lmvtk-10">page</span><span -class="ec-lmbx-10">:</span> </dt><dd -class="description"> - <!--l. 1322--><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. 1324--><p class="noindent" > -<span -class="ec-lmvtk-10">ismap</span><span -class="ec-lmbx-10">:</span> </dt><dd -class="description"> - <!--l. 1324--><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. 1327--><p class="noindent" > -<span -class="ec-lmvtk-10">nextactionraw</span><span -class="ec-lmbx-10">:</span> </dt><dd -class="description"> - <!--l. 1327--><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. 1331--><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. 1335--><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. 1340--><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. 1344--><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. 1347--><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. 1351--><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. 1354--><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. 1358--><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. 1361--><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. 1364--><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. 1368--><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. 1371--><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. 1375--><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. 1377--><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. 1381--><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. 1385--><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. 1388--><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. 1392--><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. 1398--><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. 1402--><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. 1406--><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. 1419--><p class="nopar" ></blockquote> -<!--l. 1421--><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. 1425--><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. 1430--><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. 1436--><p class="nopar" > -<!--l. 1438--><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. 1441--><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. 1445--><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. 1449--><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. 1453--><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. 1459--><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. 1467--><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. 1471--><p class="indent" > -<a - id="x1-22001r12"></a> <!--l. 1472--><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. 1472--><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. 1473--><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. 1474--><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. 1475--><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. 1476--><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. 1477--><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. 1478--><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. 1479--><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. 1480--><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. 1481--><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. 1482--><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. 1483--><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. 1484--><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. 1485--><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. 1486--><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. 1487--><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. 1490--><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. 1497--><p class="nopar" ></blockquote> -<!--l. 1500--><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. 1535--><p class="nopar" ></blockquote> -<!--l. 1538--><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. 1542--><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. 1547--><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. 1551--><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. 1555--><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. 1559--><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. 1563--><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. 1567--><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. 1570--><p class="nopar" > -<!--l. 1572--><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. 1575--><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. 1579--><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. 1584--><p class="noindent" >Switching to PD1 or PU encoding - </li> - <li class="itemize"> - <!--l. 1585--><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. 1586--><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. 1587--><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. 1588--><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. 1589--><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. 1591--><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. 1592--><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. 1595--><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. 1599--><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. 1602--><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. 1608--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a - id="x1-230006.1"></a>Bookmark macros</h4> -<!--l. 1610--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">6.1.1 </span> <a - id="x1-240006.1.1"></a>Setting bookmarks</h5> -<!--l. 1612--><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. 1615--><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. 1618--><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. 1622--><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. 1625--><p class="indent" > creates a bookmark at the current level. -<!--l. 1627--><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. 1630--><p class="indent" > creates a bookmark one step down in the bookmark hierarchy. Internally the current level is increased -by one. -<!--l. 1633--><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. 1636--><p class="indent" > creates a bookmark below the current bookmark level. However after the command the current -bookmark level has not changed. -<!--l. 1639--><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. 1642--><p class="noindent" >Usually only one LaTeX run is needed. - </li> - <li class="itemize"> - <!--l. 1643--><p class="noindent" >More control over the bookmark appearance (color, font). - - - </li> - <li class="itemize"> - <!--l. 1644--><p class="noindent" >Different bookmark actions are supported (external file links, URLs, …).</li></ul> -<!--l. 1647--><p class="noindent" >Therefore I recommend using this package. -<!--l. 1649--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">6.1.2 </span> <a - id="x1-250006.1.2"></a>Replacement macros</h5> -<!--l. 1651--><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. 1655--><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. 1659--><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. 1668--><p class="nopar" > -<!--l. 1670--><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. 1680--><p class="nopar" > -<!--l. 1682--><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. 1693--><p class="nopar" > -<!--l. 1695--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a - id="x1-260006.2"></a>Pagelabels</h4> -<!--l. 1696--><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. 1700--><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. 1703--><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. 1705--><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. 1708--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">6.3 </span> <a - id="x1-270006.3"></a>Utility macros</h4> -<!--l. 1711--><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. 1714--><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. 1726--><p class="nopar" ></blockquote> -<!--l. 1728--><p class="noindent" >The origin of the PDF coordinate system is the lower left corner. -<!--l. 1730--><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. 1736--><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. 1743--><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. 1748--><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. 1753--><p class="indent" > - <dl class="description"><dt class="description"> - <!--l. 1754--><p class="noindent" > -<span -class="ec-lmbx-10">pdfTeX</span> </dt><dd -class="description"> - <!--l. 1754--><p class="noindent" > - <ul class="itemize1"> - <li class="itemize"> - <!--l. 1756--><p class="noindent" >The link area also depends on the surrounding box. - </li> - <li class="itemize"> - <!--l. 1757--><p class="noindent" >Settings have local effect. - </li> - <li class="itemize"> - <!--l. 1758--><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. 1762--><p class="noindent" > -<span -class="ec-lmbx-10">pdfmark</span> </dt><dd -class="description"> - <!--l. 1762--><p class="noindent" > - - <ul class="itemize1"> - <li class="itemize"> - <!--l. 1764--><p class="noindent" >Settings have global effect.</li></ul> - </dd><dt class="description"> - <!--l. 1767--><p class="noindent" > -<span -class="ec-lmbx-10">xetex</span> </dt><dd -class="description"> - <!--l. 1767--><p class="noindent" > - <ul class="itemize1"> - <li class="itemize"> - <!--l. 1769--><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. 1773--><p class="noindent" > -<span -class="ec-lmbx-10">Other drivers</span> </dt><dd -class="description"> - <!--l. 1773--><p class="noindent" >Unsupported.</dd></dl> -<!--l. 1778--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a - id="x1-300007.2"></a>Field option ‘calculatesortkey’</h4> -<!--l. 1780--><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. 1790--><p class="indent" > Currently the field option ‘calculatesortkey’ is only supported by the driver for pdfTeX. -<!--l. 1793--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.3 </span> <a - id="x1-310007.3"></a>Option ‘next-anchor’</h4> -<!--l. 1794--><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. 1802--><p class="nopar" > -<!--l. 1804--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.4 </span> <a - id="x1-320007.4"></a>Option ‘localanchorname’</h4> -<!--l. 1806--><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. 1810--><p class="indent" > For example: - - - <pre class="verbatim" id="verbatim-29"> -    \section{Foobar} -    \begin{equation}\end{equation} -    \label{sec:foobar} -</pre> -<!--l. 1815--><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. 1823--><p class="indent" > Option ‘localanchorname’ is an experimental option, there might be situations, where the anchor -name is not available as expected. -<!--l. 1827--><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. 1831--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.5 </span> <a - id="x1-330007.5"></a>Option ‘customdriver’</h4> -<!--l. 1833--><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. 1838--><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. 1843--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.6 </span> <a - id="x1-340007.6"></a>Option ‘psdextra’</h4> -<!--l. 1845--><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. 1859--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.7 </span> <a - id="x1-350007.7"></a>\XeTeXLinkBox</h4> -<!--l. 1861--><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. 1870--><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. 1886--><p class="nopar" > -<!--l. 1888--><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. 1891--><p class="nopar" > If a <span -class="ec-lmss-10">hyperref </span>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. 1898--><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. 1904--><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 <span -class="ec-lmss-10">hyperref </span>prematurely. -<!--l. 1909--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.9 </span> <a - id="x1-370007.9"></a>\unichar</h4> -<!--l. 1911--><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 -<span -class="ec-lmss-10">hyperref</span>’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. 1919--><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. 1924--><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. 1929--><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. 1933--><p class="nopar" > -<!--l. 1936--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.10 </span> <a - id="x1-380007.10"></a>\ifpdfstringunicode</h4> -<!--l. 1938--><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. 1952--><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. 1962--><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. 1967--><p class="indent" > Now we can extend the definition to support <span -class="ec-lmss-10">hyperref</span>. 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. 1976--><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. 1985--><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. 2003--><p class="nopar" > -<!--l. 2005--><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. 2007--><p class="noindent" >Since version 2008/08/14 v6.78f. -<!--l. 2011--><p class="indent" > For hyperlink support in the index, <span -class="ec-lmss-10">hyperref </span>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. 2018--><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. 2030--><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. 2035--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.12 </span> <a - id="x1-400007.12"></a>Experimental option ‘ocgcolorlinks’</h4> -<!--l. 2037--><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. 2041--><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. 2044--><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. 2046--><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. 2052--><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. 2054--><p class="noindent" >Supported drivers: pdftex, dvipdfm - </li> - <li class="itemize"> - <!--l. 2055--><p class="noindent" >The PDF version should be at least 1.5. It is automatically set for pdfTeX, LuaTeX and - dvipdfmx.</li></ul> -<!--l. 2059--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.13 </span> <a - id="x1-410007.13"></a>Option ‘pdfa’</h4> -<!--l. 2061--><p class="noindent" >The new option ‘pdfa’ tries to avoid violations of PDF/A in code generated by <span -class="ec-lmss-10">hyperref</span>. However, the -result is usually not in PDF/A, because many features aren’t controlled by <span -class="ec-lmss-10">hyperref </span>(XMP metadata, -fonts, colors, driver dependend low level stuff, ...). -<!--l. 2068--><p class="indent" > Currently, option ‘pdfa’ sets and disables the following items: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2070--><p class="noindent" >Enabled annotation flags: Print, NoZoom, NoRotate [PDF/A 6.5.3]. - - </li> - <li class="itemize"> - <!--l. 2071--><p class="noindent" >Disabled annotation flags: Hidden, Invisible, NoView [PDF/A 6.5.3]. - </li> - <li class="itemize"> - <!--l. 2072--><p class="noindent" >Disabled: Launch action (<a -href="run:..." >[</a>PDF/A 6.6.1]. - </li> - <li class="itemize"> - <!--l. 2073--><p class="noindent" >Restricted: Named actions (NextPage, PrevPage, FirstPage, LastPage) [PDF/A 6.6.1]. - </li> - <li class="itemize"> - <!--l. 2075--><p class="noindent" >Many things are disabled in PDF formulars: - <ul class="itemize2"> - <li class="itemize"> - <!--l. 2077--><p class="noindent" >JavaScript actions [PDF/A 6.6.1] - </li> - <li class="itemize"> - <!--l. 2078--><p class="noindent" >Trigger events (additional actions) [PDF/A 6.6.2] - </li> - <li class="itemize"> - <!--l. 2079--><p class="noindent" >Push button (because of JavaScript) - </li> - <li class="itemize"> - <!--l. 2080--><p class="noindent" >Interactive Forms: Flag NeedAppearances is the default ‘false’ (Because of this, - <span -class="ec-lmss-10">hyperref</span>’s implementation of Forms looks ugly). [PDF/A 6.9]</li></ul> - </li></ul> -<!--l. 2088--><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 <span -class="ec-lmss-10">hyperref </span>is loaded (<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\usepackage{hyperref}</span></span></span>). -<!--l. 2094--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.14 </span> <a - id="x1-420007.14"></a>Option ‘linktoc’ added</h4> -<!--l. 2096--><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. 2099--><p class="noindent" >‘linktoc=none’ (no links) - </li> - <li class="itemize"> - <!--l. 2100--><p class="noindent" >‘linktoc=section’ (default behaviour, same as ‘linktocpage=false’) - </li> - <li class="itemize"> - <!--l. 2101--><p class="noindent" >‘linktoc=page’ (same as ‘linktocpage=true’) - - </li> - <li class="itemize"> - <!--l. 2102--><p class="noindent" >‘linktoc=all’ (both the section and page part are links)</li></ul> -<!--l. 2105--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.15 </span> <a - id="x1-430007.15"></a>Option ‘pdfnewwindow’ changed</h4> -<!--l. 2107--><p class="noindent" >Before 6.77b: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2109--><p class="noindent" >pdfnewwindow=true <span -class="lmsy-10">→ </span>/NewWindow true - </li> - <li class="itemize"> - <!--l. 2110--><p class="noindent" >pdfnewwindow=false <span -class="lmsy-10">→ </span>(absent) - </li> - <li class="itemize"> - <!--l. 2111--><p class="noindent" >unused pdfnewwindow <span -class="lmsy-10">→ </span>(absent)</li></ul> -<!--l. 2113--><p class="noindent" >Since 6.77b: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2115--><p class="noindent" >pdfnewwindow=true <span -class="lmsy-10">→ </span>/NewWindow true - </li> - <li class="itemize"> - <!--l. 2116--><p class="noindent" >pdfnewwindow=false <span -class="lmsy-10">→ </span>/NewWindow false - </li> - <li class="itemize"> - <!--l. 2117--><p class="noindent" >pdfnewwindow= <span -class="lmsy-10">→ </span>(absent) - </li> - <li class="itemize"> - <!--l. 2118--><p class="noindent" >unused pdfnewwindow <span -class="lmsy-10">→ </span>(absent)</li></ul> -<!--l. 2123--><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. 2129--><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. 2131--><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. 2135--><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. 2137--><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. 2139--><p class="indent" > Options (convert to lowercase) except flags in square brackets: - - - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2142--><p class="noindent" >Table 8.16 Annotation flags (page 608): - <!--l. 2144--><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. 2156--><p class="noindent" >Table 8.70 Field flags common to all field types (page 676): - <!--l. 2158--><p class="noindent" ><div class="obeylines-v"> - <br />1 ReadOnly - <br />2 Required - <br />3 NoExport</div> - </li> - <li class="itemize"> - <!--l. 2163--><p class="noindent" >Table 8.75 Field flags specific to button fields (page 686): - <!--l. 2165--><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. 2171--><p class="noindent" >Table 8.77 Field flags specific to text fields (page 691): - <!--l. 2173--><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. 2182--><p class="noindent" >Table 8.79 Field flags specific to choice fields (page 693): - <!--l. 2184--><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. 2192--><p class="noindent" >Table 8.86 Flags for submit-form actions (page 704): - <!--l. 2194--><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. 2211--><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. 2214--><p class="noindent" >FDF - </li> - <li class="itemize"> - <!--l. 2215--><p class="noindent" >HTML - </li> - <li class="itemize"> - <!--l. 2216--><p class="noindent" >XFDF - - - </li> - <li class="itemize"> - <!--l. 2217--><p class="noindent" >PDF (not supported by Acrobat Reader)</li></ul> -<!--l. 2220--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.17 </span> <a - id="x1-450007.17"></a>Option ‘pdfversion’</h4> -<!--l. 2222--><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. 2228--><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. 2233--><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. 2236--><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. 2239--><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. 2242--><p class="noindent" >dvipdfm: configuration file, example: TeX Live 2007, texmf/dvipdfm/config/config, entry ‘V - 2’. - </li> - <li class="itemize"> - <!--l. 2244--><p class="noindent" >dvipdfmx: configuration file, example: TeX Live 2007, texmf/dvipdfm/dvipdfmx.cfg, entry - ‘V 4’. - </li> - <li class="itemize"> - <!--l. 2246--><p class="noindent" >Ghostscript: option -dCompatibilityLevel (this is set in ‘ps2pdf12’, ‘ps2pdf13’, ‘ps2pdf14’).</li></ul> -<!--l. 2251--><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. 2258--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.18 </span> <a - id="x1-460007.18"></a>Field option ‘name’</h4> -<!--l. 2260--><p class="noindent" >Many form objects uses the label argument for several purposes: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2263--><p class="noindent" >Layouted label. - </li> - <li class="itemize"> - <!--l. 2264--><p class="noindent" >As name in HTML structures.</li></ul> -<!--l. 2266--><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. 2273--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.19 </span> <a - id="x1-470007.19"></a>Option ‘pdfencoding’</h4> -<!--l. 2275--><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. 2279--><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. 2281--><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. 2283--><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. 2288--><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. 2291--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.20 </span> <a - id="x1-480007.20"></a>Color options/package hycolor</h4> -<!--l. 2293--><p class="noindent" >See documentation of package ‘hycolor’. -<!--l. 2296--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.21 </span> <a - id="x1-490007.21"></a>Option pdfusetitle</h4> -<!--l. 2298--><p class="noindent" >If option pdfusetitle is set then <span -class="ec-lmss-10">hyperref </span>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. 2304--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.22 </span> <a - id="x1-500007.22"></a>Starred form of \autoref</h4> -<!--l. 2306--><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. 2309--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.23 </span> <a - id="x1-510007.23"></a>Link border style</h4> -<!--l. 2311--><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. 2315--><p class="indent" > Some remarks: - - - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2318--><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. 2324--><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. 2329--><p class="noindent" >The border style is removed by pdfborderstyle= This is automatically done if option - colorlinks is enabled. - </li> - <li class="itemize"> - <!--l. 2333--><p class="noindent" >Be aware that not all PDF viewers support this feature, not even Acrobat Reader itself: - <!--l. 2336--><p class="noindent" >Some support: - <ul class="itemize2"> - <li class="itemize"> - <!--l. 2338--><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. 2340--><p class="noindent" >xpdf 3.00: <span -class="ec-lmss-10">underline </span>and <span -class="ec-lmss-10">dashed</span></li></ul> - <!--l. 2343--><p class="noindent" >Unsupported: - <ul class="itemize2"> - <li class="itemize"> - <!--l. 2345--><p class="noindent" >AR5/Linux - </li> - <li class="itemize"> - <!--l. 2346--><p class="noindent" >ghostscript 8.50</li></ul> - </li></ul> -<!--l. 2350--><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. 2352--><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. 2356--><p class="noindent" ><span -class="ec-lmss-10">bookmarksdepth </span>without value Then <span -class="ec-lmss-10">hyperref </span>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. 2359--><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. 2361--><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 <span -class="ec-lmss-10">hyperref </span>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. 2371--><p class="nopar" ></li></ul> -<!--l. 2374--><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. 2376--><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. 2388--><p class="indent" > Therefore a new option pdfescapeform was introduced: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2390--><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. 2393--><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. 2401--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.26 </span> <a - id="x1-540007.26"></a>Default driver setting</h4> -<!--l. 2403--><p class="noindent" >(hyperref <span -class="lmsy-10">≥ </span>6.72s) If no driver is given, <span -class="ec-lmss-10">hyperref </span>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 <span -class="ec-lmss-10">hyperref </span>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. 2416--><p class="nopar" > for dvips, or - - - <pre class="verbatim" id="verbatim-44"> -    \providecommand*{\Hy@defaultdriver}{hypertex} -</pre> -<!--l. 2420--><p class="nopar" > for the default behaviour of <span -class="ec-lmss-10">hyperref</span>. -<!--l. 2423--><p class="indent" > See also the new option ‘driverfallback’. -<!--l. 2425--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.27 </span> <a - id="x1-550007.27"></a>Backref entries</h4> -<!--l. 2427--><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. 2516--><p class="nopar" > -<!--l. 2518--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">7.28 </span> <a - id="x1-560007.28"></a>\phantomsection</h4> -<!--l. 2520--><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. 2530--><p class="nopar" > -<!--l. 2532--><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. 2536--><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. 2538--><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. 2545--><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. 2549--><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. 2552--><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. 2559--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">8 </span> <a - id="x1-580008"></a>Acrobat-specific behavior</h3> -<!--l. 2560--><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. 2563--><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. 2567--><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. 2570--><p class="indent" > -<a - id="x1-58001r13"></a> - - - <!--l. 2571--><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. 2571--><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. 2572--><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. 2573--><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. 2574--><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. 2575--><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. 2577--><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. 2580--><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. 2581--><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. 2582--><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. 2585--><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. 2588--><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. 2591--><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. 2593--><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. 2595--><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. 2597--><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. 2600--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">9 </span> <a - id="x1-590009"></a>PDF and HTML forms</h3> -<!--l. 2601--><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. 2605--><p class="indent" > There are six macros to prepare fields: - - -<!--l. 2607--><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. 2611--><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. 2615--><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. 2619--><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. 2623--><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. 2627--><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. 2631--><p class="indent" > The way forms and their labels are laid out is determined by: -<!--l. 2632--><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. 2636--><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. 2640--><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. 2644--><p class="indent" > These macros default to #1 #2 -<!--l. 2646--><p class="indent" > What is actually shown in the field is determined by: -<!--l. 2647--><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. 2651--><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. 2654--><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. 2657--><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. 2661--><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. 2665--><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. 2669--><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. 2682--><p class="nopar" > -<!--l. 2684--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">9.1 </span> <a - id="x1-600009.1"></a>Forms environment parameters</h4> -<!--l. 2687--><p class="noindent" > -<a - id="x1-60001r14"></a> <!--l. 2688--><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. 2688--><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. 2689--><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. 2691--><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. 2694--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">9.2 </span> <a - id="x1-610009.2"></a>Forms optional parameters</h4> -<!--l. 2695--><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. 2699--><p class="indent" > -<a - id="x1-61001r15"></a> <!--l. 2700--><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. 2761--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">10 </span> <a - id="x1-6200010"></a>Defining a new driver</h3> -<!--l. 2762--><p class="noindent" >A <span -class="ec-lmss-10">hyperref </span>driver has to provide definitions for eight macros: -<!--l. 2765--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@anchor</span></span></span> -<!--l. 2767--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@link</span></span></span> -<!--l. 2769--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@linkfile</span></span></span> -<!--l. 2771--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@linkurl</span></span></span> -<!--l. 2773--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@anchorstart</span></span></span> - -<!--l. 2775--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@anchorend</span></span></span> -<!--l. 2777--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@linkstart</span></span></span> -<!--l. 2779--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@linkend</span></span></span> -<!--l. 2782--><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. 2792--><p class="nopar" > -<!--l. 2794--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">11 </span> <a - id="x1-6300011"></a>Special support for other packages</h3> -<!--l. 2796--><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. 2801--><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. 2808--><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. 2811--><p class="noindent" >Packages that do anything serious with the index. - </li> - <li class="itemize"> - <!--l. 2813--><p class="noindent" >Packages that do anything serious with sectioning commands and the toc</li></ul> -<!--l. 2818--><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. 2825--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">11.1 </span> <a - id="x1-6400011.1"></a>Package Compatibility</h4> -<!--l. 2827--><p class="noindent" >Currently only package loading orders are available: -<!--l. 2830--><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. 2835--><p class="nopar" > -<!--l. 2837--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.2 </span> <a - id="x1-6600011.1.2"></a>amsmath</h5> -<!--l. 2839--><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. 2850--><p class="nopar" > -<!--l. 2852--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.3 </span> <a - id="x1-6700011.1.3"></a>amsrefs</h5> -<!--l. 2854--><p class="noindent" >Package loading order: - - - <pre class="verbatim" id="verbatim-51"> -  \usepackage{hyperref} -  \usepackage{amsrefs} -</pre> -<!--l. 2859--><p class="nopar" > -<!--l. 2861--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.4 </span> <a - id="x1-6800011.1.4"></a>arydshln, longtable</h5> -<!--l. 2863--><p class="noindent" >Package <span -class="ec-lmss-10">longtable </span>must be put before <span -class="ec-lmss-10">hyperref </span>and <span -class="ec-lmss-10">arydshln</span>, <span -class="ec-lmss-10">hyperref </span>after <span -class="ec-lmss-10">arydshln </span>generates an error, -thus the resulting package order is then: - - - <pre class="verbatim" id="verbatim-52"> -  \usepackage{longtable} -  \usepackage{hyperref} -  \usepackage{arydshln} -</pre> -<!--l. 2871--><p class="nopar" > -<!--l. 2873--><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. 2875--><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. 2880--><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. 2882--><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. 2889--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.7 </span> <a - id="x1-7100011.1.7"></a>bibentry</h5> -<!--l. 2891--><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. 2908--><p class="nopar" > -<!--l. 2910--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.8 </span> <a - id="x1-7200011.1.8"></a>bigfoot</h5> -<!--l. 2912--><p class="noindent" ><span -class="ec-lmss-10">hyperref </span>does not support package <span -class="ec-lmss-10">bigfoot</span>. And package <span -class="ec-lmss-10">bigfoot </span>does not support <span -class="ec-lmss-10">hyperref</span>’s footnotes and -disables them (hyperfootnotes=false). -<!--l. 2917--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.9 </span> <a - id="x1-7300011.1.9"></a>chappg</h5> -<!--l. 2919--><p class="noindent" >Package <span -class="ec-lmss-10">chappg </span>uses <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\@addtoreset</span></span></span> that is redefined by <span -class="ec-lmss-10">hyperref</span>. The package order is therefore: - - - <pre class="verbatim" id="verbatim-54"> -  \usepackage{hyperref} -  \usepackage{chappg} -</pre> -<!--l. 2925--><p class="nopar" > -<!--l. 2927--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.10 </span> <a - id="x1-7400011.1.10"></a>cite</h5> -<!--l. 2929--><p class="noindent" >This is from Mike Shell: cite.sty cannot currently be used with <span -class="ec-lmss-10">hyperref</span>. 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. 2939--><p class="nopar" > -<!--l. 2941--><p class="indent" > so that <span -class="ec-lmss-10">hyperref </span>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. 2946--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.11 </span> <a - id="x1-7500011.1.11"></a>count1to</h5> -<!--l. 2948--><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. 2960--><p class="nopar" > -<!--l. 2962--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.12 </span> <a - id="x1-7600011.1.12"></a>dblaccnt</h5> -<!--l. 2964--><p class="noindent" >pd1enc.def or puenc.def should be loaded before: - - - <pre class="verbatim" id="verbatim-57"> -  \usepackage{hyperref} -  \usepackage{dblaccnt} -</pre> -<!--l. 2968--><p class="nopar" > or see entry for <span -class="ec-lmss-10">vietnam</span>. -<!--l. 2972--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.13 </span> <a - id="x1-7700011.1.13"></a>easyeqn</h5> -<!--l. 2973--><p class="noindent" >Not compatible, breaks. -<!--l. 2976--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.14 </span> <a - id="x1-7800011.1.14"></a>ellipsis</h5> -<!--l. 2978--><p class="noindent" >This packages redefines <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\textellipsis</span></span></span> after package <span -class="ec-lmss-10">hyperref </span>(pd1enc.def/puenc.def should be loaded -before): - - - <pre class="verbatim" id="verbatim-58"> -  \usepackage{hyperref} -  \usepackage{ellipsis} -</pre> -<!--l. 2983--><p class="nopar" > -<!--l. 2985--><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. 2987--><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. 2991--><p class="nopar" > - <ul class="itemize1"> - <li class="itemize"> - <!--l. 2993--><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. 2994--><p class="noindent" >Anchor are set at top of the float object, if its style is controlled by float.sty.</li></ul> -<!--l. 2998--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.16 </span> <a - id="x1-8000011.1.16"></a>endnotes</h5> -<!--l. 2999--><p class="noindent" >Unsupported. -<!--l. 3001--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.17 </span> <a - id="x1-8100011.1.17"></a>foiltex</h5> -<!--l. 3002--><p class="noindent" >Update to version 2008/01/28 v2.1.4b: Since version 6.77a <span -class="ec-lmss-10">hyperref </span>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 <span -class="ec-lmss-10">hyperref</span> -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. 3010--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.18 </span> <a - id="x1-8200011.1.18"></a>footnote</h5> -<!--l. 3012--><p class="noindent" >This package is not supported, you have to disable <span -class="ec-lmss-10">hyperref</span>’s footnote support by using option -<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">hyperfootnotes=false</span></span></span>. -<!--l. 3016--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.19 </span> <a - id="x1-8300011.1.19"></a>geometry</h5> -<!--l. 3018--><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. 3050--><p class="nopar" > -<!--l. 3052--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.20 </span> <a - id="x1-8400011.1.20"></a>IEEEtran.cls</h5> -<!--l. 3054--><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. 3057--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.21 </span> <a - id="x1-8500011.1.21"></a>index</h5> -<!--l. 3059--><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. 3062--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.22 </span> <a - id="x1-8600011.1.22"></a>lastpage</h5> -<!--l. 3064--><p class="noindent" >Compatible. -<!--l. 3067--><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. 3071--><p class="nopar" > -<!--l. 3073--><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. 3078--><p class="nopar" > -<!--l. 3080--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.25 </span> <a - id="x1-8900011.1.25"></a>mathenv</h5> -<!--l. 3082--><p class="noindent" >Unsupported. -<!--l. 3086--><p class="indent" > Both <span -class="ec-lmss-10">mathenv </span>and <span -class="ec-lmss-10">hyperref </span>messes around with environment <span -class="ec-lmvtt-10">eqnarray</span>. You can load <span -class="ec-lmss-10">mathenv </span>after -<span -class="ec-lmss-10">hyperref </span>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 <span -class="ec-lmvtt-10">eqnarray </span>properly, for -example. -<!--l. 3093--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.26 </span> <a - id="x1-9000011.1.26"></a>minitoc-hyper</h5> -<!--l. 3095--><p class="noindent" >This package is obsolete, use the up-to-date original package <span -class="ec-lmss-10">minitoc </span>instead. -<!--l. 3100--><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. 3104--><p class="nopar" > -<!--l. 3106--><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. 3110--><p class="nopar" > -<!--l. 3112--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.29 </span> <a - id="x1-9300011.1.29"></a>nomencl</h5> -<!--l. 3113--><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. 3116--><p class="nopar" > -<!--l. 3119--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.30 </span> <a - id="x1-9400011.1.30"></a>ntheorem-hyper</h5> -<!--l. 3120--><p class="noindent" >This package is obsolete, use the up-to-date original package <span -class="ec-lmss-10">ntheorem </span>instead. -<!--l. 3124--><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. 3131--><p class="nopar" > -<!--l. 3134--><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. 3153--><p class="nopar" > -<!--l. 3156--><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. 3160--><p class="nopar" > -<!--l. 3162--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.33 </span> <a - id="x1-9700011.1.33"></a>sidecap</h5> -<!--l. 3163--><p class="noindent" >Nothing special is needed anymore. -<!--l. 3165--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.34 </span> <a - id="x1-9800011.1.34"></a>subfigure</h5> -<!--l. 3166--><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. 3169--><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. 3174--><p class="nopar" > -<!--l. 3176--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.36 </span> <a - id="x1-10000011.1.36"></a>tabularx</h5> -<!--l. 3178--><p class="noindent" >Linked footnotes are not supported inside environment <span -class="ec-lmvtt-10">tabularx</span>, 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 <span -class="ec-lmss-10">hyperref </span>had -disabled footnotes entirely by <span -class="ec-lmvtt-10">hyperfootnotes=false</span>. -<!--l. 3184--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.37 </span> <a - id="x1-10100011.1.37"></a>titlesec</h5> -<!--l. 3186--><p class="noindent" ><span -class="ec-lmss-10">nameref </span>supports <span -class="ec-lmss-10">titlesec</span>, but <span -class="ec-lmss-10">hyperref </span>does not (unsolved is the anchor setting, missing with unnumbered -section, perhaps problems with page breaks with numbered ones). -<!--l. 3191--><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. 3193--><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. 3206--><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. 3210--><p class="indent" > Note: utf8 is now the default in LaTeX and <span -class="ec-lmss-10">ucs </span>is no longer recommended. -<!--l. 3213--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.39 </span> <a - id="x1-10300011.1.39"></a>varioref</h5> -<!--l. 3214--><p class="noindent" >There are too many problems with <span -class="ec-lmss-10">varioref</span>. Nobody has time to sort them out. Therefore this package is -now unsupported. -<!--l. 3217--><p class="indent" > Perhaps you are lucky and some of the features of <span -class="ec-lmss-10">varioref </span>works with the following loading -order: - - - <pre class="verbatim" id="verbatim-71"> -    \usepackage{nameref} -    \usepackage{varioref} -    \usepackage{hyperref} -</pre> -<!--l. 3223--><p class="nopar" > -<!--l. 3226--><p class="indent" > Also some babel versions can be problematic. For example, 2005/05/21 v3.8g contains a patch for -<span -class="ec-lmss-10">varioref </span>that breaks the <span -class="ec-lmss-10">hyperref </span>support for <span -class="ec-lmss-10">varioref</span>. -<!--l. 3231--><p class="indent" > Also unsupported: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 3233--><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. 3234--><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. 3238--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.40 </span> <a - id="x1-10400011.1.40"></a>verse</h5> -<!--l. 3240--><p class="noindent" >Version 2005/08/22 v2.22 contains support for <span -class="ec-lmss-10">hyperref</span>. -<!--l. 3242--><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. 3286--><p class="nopar" > -<!--l. 3288--><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. 3294--><p class="nopar" > -<!--l. 3296--><p class="noindent" > - <h5 class="subsubsectionHead"><span class="titlemark">11.1.42 </span> <a - id="x1-10600011.1.42"></a>XeTeX</h5> -<!--l. 3298--><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. 3304--><p class="indent" > In older versions <span -class="ec-lmss-10">hyperref </span>contained special conversion code from UTF-16BE back to UTF-8 in a -number of places for xetex to avoid the xdvipdfmx warning -<!--l. 3308--><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. 3310--><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. 3316--><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. 3319--><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. 3323--><p class="indent" > Workarounds: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 3325--><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. 3330--><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. 3331--><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. 3337--><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. 3343--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">12.2 </span> <a - id="x1-10900012.2"></a>Links across pages</h4> -<!--l. 3345--><p class="noindent" >In general they have problems: - <ul class="itemize1"> - <li class="itemize"> - <!--l. 3347--><p class="noindent" >Some driver doesn’t support them at all (see above). - </li> - <li class="itemize"> - <!--l. 3348--><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. 3353--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">12.3 </span> <a - id="x1-11000012.3"></a>Footnotes</h4> -<!--l. 3355--><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 <span -class="ec-lmss-10">hyperref </span>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. 3366--><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. 3370--><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. 3374--><p class="nopar" > Package <span -class="ec-lmss-10">hyperref </span>now gets - - - <pre class="verbatim" id="verbatim-75"> -    pdfborder=001 -</pre> -<!--l. 3378--><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. 3383--><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. 3387--><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. 3393--><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. 3398--><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. 3400--><p class="noindent" >Package <span -class="ec-lmss-10">hyperref </span>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 <span -class="ec-lmss-10">hyperref </span>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. 3410--><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, <span -class="ec-lmss-10">hyperref </span>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. 3422--><p class="nopar" > - </li> - <li class="itemize"> - <!--l. 3423--><p class="noindent" >Scientic Word/Scientific WorkPlace users can use package robustindex with hyperindex=false. - </li> - <li class="itemize"> - <!--l. 3425--><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. 3429--><p class="nopar" > - </li> - <li class="itemize"> - <!--l. 3430--><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, - <span -class="ec-lmss-10">hyperref</span>’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. 3445--><p class="nopar" ></li></ul> -<!--l. 3448--><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. 3450--><p class="noindent" >Getting rid of it: - - - <pre class="verbatim" id="verbatim-81"> -\makeatletter -\providecommand*{\toclevel@<foobar>}{0} -\makeatother -</pre> -<!--l. 3455--><p class="nopar" > -<!--l. 3457--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">13.4 </span> <a - id="x1-11500013.4"></a>Link anchors in figures</h4> -<!--l. 3459--><p class="noindent" >The caption command increments the counter and here is the place where <span -class="ec-lmss-10">hyperref </span>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. 3467--><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. 3471--><p class="nopar" > -<!--l. 3473--><p class="indent" > Support for additional unicode characters: -<!--l. 3475--><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. 3477--><p class="indent" > 1. Get a list with unicode data, eg: -<!--l. 3479--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt -<!--l. 3481--><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. 3485--><p class="nopar" > -<!--l. 3487--><p class="indent" > 3. Calculate the octal code: -<!--l. 3489--><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. 3496--><p class="nopar" > -<!--l. 3498--><p class="indent" > 4. Transform into a form understood by <span -class="ec-lmss-10">hyperref</span>: -<!--l. 3500--><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. 3507--><p class="nopar" > -<!--l. 3509--><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. 3515--><p class="nopar" > -<!--l. 3517--><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. 3526--><p class="nopar" > -<!--l. 3528--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">13.6 </span> <a - id="x1-11700013.6"></a>Footnotes</h4> -<!--l. 3530--><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 <span -class="ec-lmss-10">hyperref</span>’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. 3584--><p class="nopar" > - -<!--l. 3586--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">13.7 </span> <a - id="x1-11800013.7"></a>Subordinate counters</h4> -<!--l. 3588--><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 <span -class="ec-lmss-10">hyperref </span>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 <span -class="ec-lmss-10">hyperref</span>. -<!--l. 3598--><p class="indent" > However, if the definition of subordinate counters take place before <span -class="ec-lmss-10">hyperref </span>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 <span -class="ec-lmss-10">hyperref</span>’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 -<span -class="ec-lmss-10">hyperref </span>is loaded. -<!--l. 3604--><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. 3608--><p class="nopar" > Solution a) - - - <pre class="verbatim" id="verbatim-90"> -    \usepackage{hyperref} -    \newtheorem{corA}{CorollaryA}[section} -</pre> -<!--l. 3613--><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. 3619--><p class="nopar" > -<!--l. 3621--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">14 </span> <a - id="x1-11900014"></a>History and acknowledgments</h3> -<!--l. 3623--><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. 3636--><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. 3644--><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. 3653--><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. 3659--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost. -<!--l. 3662--><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. 3702--><p class="noindent" >Version 1.2, November 2002 -<!--l. 3705--><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. 3711--><p class="noindent" > - <h4 class="likesubsectionHead"><a - id="x1-121000"></a>Preamble</h4> -<!--l. 3713--><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. 3721--><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. 3726--><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. 3735--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.1 </span> <a - id="x1-12200015.1"></a>Applicability and definitions</h4> -<!--l. 3738--><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. 3748--><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. 3752--><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. 3763--><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. 3771--><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. 3776--><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. 3789--><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. 3800--><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. 3807--><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. 3815--><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. 3823--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.2 </span> <a - id="x1-12300015.2"></a>Verbatim copying</h4> -<!--l. 3826--><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. 3837--><p class="indent" > You may also lend copies, under the same conditions stated above, and you may publicly display -copies. - - -<!--l. 3841--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.3 </span> <a - id="x1-12400015.3"></a>Copying in quantity</h4> -<!--l. 3844--><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. 3857--><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. 3862--><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. 3875--><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. 3880--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.4 </span> <a - id="x1-12500015.4"></a>Modifications</h4> -<!--l. 3883--><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. 3892--><p class="indent" > - <ol class="enumerate1" > -<li - class="enumerate" id="x1-125002x1"> - <!--l. 3893--><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. 3898--><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. 3903--><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. 3905--><p class="noindent" >Preserve all the copyright notices of the Document. - </li> -<li - class="enumerate" id="x1-125010x5"> - <!--l. 3906--><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. 3908--><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. 3911--><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. 3913--><p class="noindent" >Include an unaltered copy of this License. - </li> -<li - class="enumerate" id="x1-125018x9"> - <!--l. 3914--><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. 3921--><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. 3928--><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. 3932--><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. 3935--><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. 3937--><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. 3939--><p class="noindent" >Preserve any Warranty Disclaimers. - </li></ol> -<!--l. 3943--><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. 3950--><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. 3956--><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. 3966--><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. 3971--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.5 </span> <a - id="x1-12600015.5"></a>Combining documents</h4> -<!--l. 3974--><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. 3982--><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. 3991--><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. 3998--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.6 </span> <a - id="x1-12700015.6"></a>Collections of documents</h4> -<!--l. 4001--><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. 4007--><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. 4013--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.7 </span> <a - id="x1-12800015.7"></a>Aggregation with independent works</h4> -<!--l. 4016--><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. 4025--><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. 4034--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.8 </span> <a - id="x1-12900015.8"></a>Translation</h4> -<!--l. 4037--><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. 4051--><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. 4058--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">15.9 </span> <a - id="x1-13000015.9"></a>Termination</h4> -<!--l. 4061--><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. 4070--><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. 4073--><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. 4079--><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. 4089--><p class="noindent" > - <h4 class="likesubsectionHead"><a - id="x1-132000"></a>Addendum: how to use this license for your documents</h4> -<!--l. 4091--><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. 4095--><p class="indent" > - <blockquote class="quote"> - <!--l. 4096--><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. 4105--><p class="indent" > If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” -line with this: -<!--l. 4108--><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. 4111--><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. 4115--><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 039f817ee3d..94a2a192bdf 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 5db76cd05ee..12f5533b192 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-05-16 v7.00y} +\date{2023-06-25 v7.01a} \begin{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc2.html b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc2.html deleted file mode 100644 index e24d5ff1cd2..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc2.html +++ /dev/null @@ -1,21 +0,0 @@ -<!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 deleted file mode 100644 index 516b3b25733..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc3.html +++ /dev/null @@ -1,19 +0,0 @@ -<!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 deleted file mode 100644 index cada83835b3..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc4.html +++ /dev/null @@ -1,25 +0,0 @@ -<!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. 300--><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 deleted file mode 100644 index e8d78ad09f6..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc5.html +++ /dev/null @@ -1,21 +0,0 @@ -<!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. 338--><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 deleted file mode 100644 index 86b6169f821..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc6.html +++ /dev/null @@ -1,19 +0,0 @@ -<!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 deleted file mode 100644 index 97b0248da7d..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc7.html +++ /dev/null @@ -1,19 +0,0 @@ -<!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 deleted file mode 100644 index ec67959b8a4..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc8.html +++ /dev/null @@ -1,19 +0,0 @@ -<!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 8b0151bbfea..dc18af60f1f 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 e4576ab482d..4889dc2a2a5 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 9d9b8a5905a..0eb1a45b131 100644 --- a/Master/texmf-dist/doc/latex/hyperref/nameref.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/nameref.pdf |