diff options
author | Karl Berry <karl@freefriends.org> | 2009-05-26 23:22:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-05-26 23:22:36 +0000 |
commit | 788463b73b8e87304fa052fe0f9fe43fc2217a3a (patch) | |
tree | d6612e5b5237b81281b06a6be039df71695119c4 /Master/texmf-dist/doc/latex/hyperref/manual.html | |
parent | 2be0d9eaabb3f79a9a41cb82da8e05d538f20c17 (diff) |
hyperref update (26may09)
git-svn-id: svn://tug.org/texlive/trunk@13484 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref/manual.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/hyperref/manual.html | 4565 |
1 files changed, 4565 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.html b/Master/texmf-dist/doc/latex/hyperref/manual.html new file mode 100644 index 00000000000..7defe603f35 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual.html @@ -0,0 +1,4565 @@ +<!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 (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> +<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> +<!-- html --> +<meta name="src" content="manual.tex"> +<meta name="date" content="2008-10-12 08:08:00"> +<link rel="stylesheet" type="text/css" href="manual.css"> +</head><body +> + <div class="maketitle"> + + + + + +<h2 class="titleHead">Hypertext marks in <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>: a manual for hyperref</h2> + <div class="author" ><span +class="ec-lmr-12">Sebastian Rahtz </span><br class="and" /><span +class="ec-lmr-12">Heiko Oberdiek</span></div> +<br /> +<div class="date" ><span +class="ec-lmr-12">October 2008</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">Introduction</a></span> +<br /> <span class="sectionToc" >2 <a +href="#x1-30002" id="QQ2-1-3">Implicit behavior</a></span> +<br /> <span class="sectionToc" >3 <a +href="#x1-40003" id="QQ2-1-4">Package options</a></span> +<br />  <span class="subsectionToc" >3.1 <a +href="#x1-50003.1" id="QQ2-1-5">General options</a></span> +<br />  <span class="subsectionToc" >3.2 <a +href="#x1-60003.2" id="QQ2-1-6">Configuration options</a></span> +<br />  <span class="subsectionToc" >3.3 <a +href="#x1-70003.3" id="QQ2-1-7">Backend drivers</a></span> +<br />  <span class="subsectionToc" >3.4 <a +href="#x1-80003.4" id="QQ2-1-8">Extension options</a></span> +<br />  <span class="subsectionToc" >3.5 <a +href="#x1-90003.5" id="QQ2-1-9">PDF-specific display options</a></span> +<br />  <span class="subsectionToc" >3.6 <a +href="#x1-100003.6" id="QQ2-1-10">PDF display and information options</a></span> +<br />  <span class="subsectionToc" >3.7 <a +href="#x1-110003.7" id="QQ2-1-11">Big alphabetical list</a></span> +<br /> <span class="sectionToc" >4 <a +href="#x1-120004" id="QQ2-1-12">Additional user macros</a></span> +<br />  <span class="subsectionToc" >4.1 <a +href="#x1-130004.1" id="QQ2-1-13">Replacement macros</a></span> +<br />  <span class="subsectionToc" >4.2 <a +href="#x1-140004.2" id="QQ2-1-14">Utility macros</a></span> +<br /> <span class="sectionToc" >5 <a +href="#x1-150005" id="QQ2-1-15">Acrobat-specific behavior</a></span> +<br /> <span class="sectionToc" >6 <a +href="#x1-160006" id="QQ2-1-16">PDF and HTML forms</a></span> +<br />  <span class="subsectionToc" >6.1 <a +href="#x1-170006.1" id="QQ2-1-17">Forms environment parameters</a></span> +<br />  <span class="subsectionToc" >6.2 <a +href="#x1-180006.2" id="QQ2-1-18">Forms optional parameters</a></span> +<br /> <span class="sectionToc" >7 <a +href="#x1-190007" id="QQ2-1-19">Defining a new driver</a></span> +<br /> <span class="sectionToc" >8 <a +href="#x1-200008" id="QQ2-1-20">Special support for other packages</a></span> +<br /> <span class="sectionToc" >9 <a +href="#x1-210009" id="QQ2-1-21">History and acknowledgments</a></span> +<br /> <span class="sectionToc" >10 <a +href="#x1-2200010" id="QQ2-1-22">GNU Free Documentation License</a></span> +<br />  <span class="subsectionToc" >10.1 <a +href="#x1-2400010.1" id="QQ2-1-24">Applicability and definitions</a></span> +<br />  <span class="subsectionToc" >10.2 <a +href="#x1-2500010.2" id="QQ2-1-25">Verbatim copying</a></span> +<br />  <span class="subsectionToc" >10.3 <a +href="#x1-2600010.3" id="QQ2-1-26">Copying in quantity</a></span> +<br />  <span class="subsectionToc" >10.4 <a +href="#x1-2700010.4" id="QQ2-1-27">Modifications</a></span> +<br />  <span class="subsectionToc" >10.5 <a +href="#x1-2800010.5" id="QQ2-1-28">Combining documents</a></span> +<br />  <span class="subsectionToc" >10.6 <a +href="#x1-2900010.6" id="QQ2-1-29">Collections of documents</a></span> +<br />  <span class="subsectionToc" >10.7 <a +href="#x1-3000010.7" id="QQ2-1-30">Aggregation with independent works</a></span> +<br />  <span class="subsectionToc" >10.8 <a +href="#x1-3100010.8" id="QQ2-1-31">Translation</a></span> +<br />  <span class="subsectionToc" >10.9 <a +href="#x1-3200010.9" id="QQ2-1-32">Termination</a></span> +<br />  <span class="subsectionToc" >10.10 <a +href="#x1-3300010.10" id="QQ2-1-33">Future revisions of this license</a></span> + + </div> +<!--l. 131--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">1 </span> <a + id="x1-20001"></a>Introduction</h3> +<!--l. 133--><p class="noindent" >The package derives from, and builds on, the work of the Hyper<span class="TEX">T<span +class="E">E</span>X</span> project, described at <span class="obeylines-h"><a +href="http://xxx.lanl.gov/hypertex/" class="url" ><span +class="ec-lmtt-10">http://xxx.lanl.gov/hypertex/</span></a></span>. It extends the functionality of all the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> cross-referencing +commands (including the table of contents, bibliographies etc) to produce <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></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. 141--><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-lmtt-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="LATEX"><span +class="ec-lmri-10">L</span><span class="A"><span +class="ec-lmri-10">A</span></span><span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span></span><span +class="ec-lmri-10"> Web Companion</span>, +where you will find additional examples. +<!--l. 148--><p class="indent" > The Hyper<span class="TEX">T<span +class="E">E</span>X</span> specification<span class="footnote-mark"><a +href="manual2.html#fn1x0"><sup class="textsuperscript">1</sup></a></span><a + id="x1-2001f1"></a> +says that conformant viewers/translators must recognize the following set of <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> constructs: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">href:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">html:<a</span><span +class="ec-lmtt-10"> href</span><span +class="ec-lmtt-10"> =</span><span +class="ec-lmtt-10"> "href_string"></span></span></span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">name:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">html:<a</span><span +class="ec-lmtt-10"> name</span><span +class="ec-lmtt-10"> =</span><span +class="ec-lmtt-10"> "name_string"></span></span></span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">end:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">html:</a></span></span></span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">image:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">html:<img</span><span +class="ec-lmtt-10"> src</span><span +class="ec-lmtt-10"> =</span><span +class="ec-lmtt-10"> "href_string"></span></span></span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">base_name:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">html:<base</span><span +class="ec-lmtt-10"> href</span><span +class="ec-lmtt-10"> =</span><span +class="ec-lmtt-10"> "href_string"></span></span></span></dd></dl> +<!--l. 160--><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 URL’s may be retrieved +correctly. +<!--l. 169--><p class="indent" > The <span +class="ec-lmri-10">href </span>and <span +class="ec-lmri-10">name </span>commands must be paired with an <span +class="ec-lmri-10">end </span>command later in the <span class="TEX">T<span +class="E">E</span>X</span> file—the +<span class="TEX">T<span +class="E">E</span>X</span> commands between the two ends of a pair form an <span +class="ec-lmri-10">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-lmtt-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-lmtt-10">"</span></span></span>’ +characters should be escaped with a backslash (<span +class="lmsy-10">n</span>), and if it looks like a URL name it may cause +problems. + + +<!--l. 185--><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-lmtt-10">\special</span></span></span> +commands. The commands are defined in configuration files for different drivers, selected by package +options; at present, the following drivers are supported: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">hypertex</span> </dt><dd +class="description">DVI processors conforming to the Hyper<span class="TEX">T<span +class="E">E</span>X</span> guidelines (i.e. <span +class="ec-lmss-10">xdvi</span>, <span +class="ec-lmss-10">dvips </span>(with the <span +class="ec-lmss-10">-z</span> + option), <span +class="ec-lmss-10">OzTeX</span>, and <span +class="ec-lmss-10">Textures</span>) + </dd><dt class="description"> +<span +class="ec-lmbx-10">dvips</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands tailored for <span +class="ec-lmss-10">dvips</span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">dvipsone</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands tailored for <span +class="ec-lmss-10">dvipsone</span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">ps2pdf</span> </dt><dd +class="description">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"> +<span +class="ec-lmbx-10">tex4ht</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands for use with <span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span><span +class="ec-lmss-10">4ht</span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">pdftex</span> </dt><dd +class="description">pdf<span class="TEX">T<span +class="E">E</span>X</span>, Hàn Thê´ Thành’s <span class="TEX">T<span +class="E">E</span>X</span> variant that writes PDF directly + </dd><dt class="description"> +<span +class="ec-lmbx-10">dvipdfm</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands for Mark Wicks’ DVI to PDF driver <span +class="ec-lmss-10">dvipdfm</span> + </dd><dt class="description"> +<span +class="ec-lmbx-10">dvipdfmx</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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"> +<span +class="ec-lmbx-10">dviwindo</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands that Y&Y’s Windows previewer interprets as hypertext + jumps within the previewer + </dd><dt class="description"> +<span +class="ec-lmbx-10">vtex</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands that MicroPress’ HTML and PDF-producing <span class="TEX">T<span +class="E">E</span>X</span> variants + interpret as hypertext jumps within the previewer + </dd><dt class="description"> +<span +class="ec-lmbx-10">textures</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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"> +<span +class="ec-lmbx-10">xetex</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\special</span></span></span> commands for Xe<span class="TEX">T<span +class="E">E</span>X</span></dd></dl> +<!--l. 210--><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="manual3.html#fn2x0"><sup class="textsuperscript">2</sup></a></span><a + id="x1-2002f2"></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 +Hyper<span class="TEX">T<span +class="E">E</span>X</span> <span +class="ec-lmtt-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>. + + + <h3 class="sectionHead"><span class="titlemark">2 </span> <a + id="x1-30002"></a>Implicit behavior</h3> +<!--l. 222--><p class="noindent" >This package can be used with more or less any normal <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> document by specifying in the +document preamble + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\usepackage{hyperref} +</div> +</td></tr></table> +<!--l. 227--><p class="nopar" > +<!--l. 229--><p class="indent" > Make sure it comes <span +class="ec-lmri-10">last </span>of your loaded packages, to give it a fighting chance of not being over-written, +since its job is to redefine many <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> commands. Hopefully you will find that all cross-references +work correctly as hypertext. For example, <span +class="ec-lmtt-10">\section </span>commands will produce a bookmark and a +link, whereas <span +class="ec-lmtt-10">\section* </span>commands will only show links when paired with a corresponding +<span +class="ec-lmtt-10">\addcontentsline </span>command. +<!--l. 237--><p class="indent" > In addition, the <span +class="ec-lmtt-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-lmtt-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-lmtt-10">colorlinks</span>, as its name well implies, colors the links instead of using boxes; this is the option used in +this document. +<!--l. 246--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">3 </span> <a + id="x1-40003"></a>Package options</h3> +<!--l. 248--><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-lmtt-10">Hyp</span>. The options can be set either in the optional argument to the +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\usepackage</span></span></span> command, or using the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hypersetup</span></span></span> macro. When the package is loaded, a file +<span +class="ec-lmtt-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. 256--><p class="indent" > As an example, the behavior of a particular file could be controlled by: + <ul class="itemize1"> + <li class="itemize">a site-wide <span +class="ec-lmtt-10">hyperref.cfg </span>setting up the look of links, adding backreferencing, and setting + a PDF display default: + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \hypersetup{backref, +  <br />pdfpagemode=FullScreen, +  <br />colorlinks=true} +</div> + </td></tr></table> + <!--l. 266--><p class="nopar" > + </li> + <li class="itemize">A global option in the file, which is passed down to <span +class="ec-lmss-10">hyperref</span>: + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \documentclass[dvips]{article} +</div> + </td></tr></table> + <!--l. 273--><p class="nopar" > + </li> + <li class="itemize">File-specific options in the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\usepackage</span></span></span> commands, which override the ones set in + <span +class="ec-lmtt-10">hyperref.cfg</span>: + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \usepackage[pdftitle={A Perfect Day},colorlinks=false]{hyperref} +</div> + </td></tr></table> + <!--l. 280--><p class="nopar" ></li></ul> +<!--l. 283--><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-lmtt-10">\begin{document}</span></span></span>, only in +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\usepackage[...]{hyperref}</span></span></span>, before first use, etc. +<!--l. 287--><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. 291--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a + id="x1-50003.1"></a>General options</h4> +<!--l. 293--><p class="noindent" >Firstly, the options to specify general behavior and page size. +<!--l. 296--><p class="noindent" > +<a + id="x1-5001r1"></a> <!--l. 297--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-2-1g"><col +id="TBL-2-1"><col +id="TBL-2-2"><col +id="TBL-2-3"><col +id="TBL-2-4"></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-lmtt-10">draft </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-4" +class="td11"> all hypertext options are turned off </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-lmtt-10">final </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-4" +class="td11"> all hypertext options are turned on </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-lmtt-10">debug </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-4" +class="td11"> extra diagnostic messages are printed in </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"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-4-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-4-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-4-4" +class="td11"> the log file </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-lmtt-10">verbose </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-5-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-5-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-5-4" +class="td11"> same as debug </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-lmtt-10">implicit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-4" +class="td11"> redefines <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> internals </td> +</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-lmtt-10">hypertexnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-4" +class="td11"> use guessable names for links </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-lmtt-10">naturalnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-8-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-8-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-8-4" +class="td11"> use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-computed names for links </td> +</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-lmtt-10">a4paper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-9-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-9-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-9-4" +class="td11"> sets paper size to 210mm <span +class="lmsy-10"> +</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-lmtt-10">a5paper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-10-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-10-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-10-4" +class="td11"> sets paper size to 148mm <span +class="lmsy-10"> +</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-lmtt-10">b5paper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-11-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-11-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-11-4" +class="td11"> sets paper size to 176mm <span +class="lmsy-10"> +</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-lmtt-10">letterpaper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-12-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-12-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-12-4" +class="td11"> sets paper size to 8.5in <span +class="lmsy-10"> +</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-lmtt-10">legalpaper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-13-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-13-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-13-4" +class="td11"> sets paper size to 8.5in <span +class="lmsy-10"> +</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-lmtt-10">executivepaper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-14-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-14-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-14-4" +class="td11"> sets paper size to 7.25in <span +class="lmsy-10"> +</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-lmtt-10">setpagesize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-15-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-15-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-2-15-4" +class="td11"> sets page size by special driver commands </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"> </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"> </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"> </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"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-19-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-19-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-19-4" +class="td11"></td></tr> + </table></div> +<!--l. 314--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a + id="x1-60003.2"></a>Configuration options</h4> +<!--l. 316--><p class="noindent" > +<a + id="x1-6001r2"></a> <!--l. 317--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><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-lmtt-10">raiselinks </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">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-1-4" +class="td11"> + <!--l. 317--><p class="noindent" >In the hypertex driver, the height of links is + normally calculcated by the driver as simply + the base line of contained text; this options + forces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1" +class="td11"> <span +class="ec-lmtt-10">breaklinks </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">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-2-4" +class="td11"> + <!--l. 320--><p class="noindent" >Allows link text to break across lines; since + this cannot be accommodated in PDF, it is + only set true by default if the pdftex driver is + used. This makes links on multiple lines into + different PDF links to the same target. </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-lmtt-10">pageanchor </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">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-3-4" +class="td11"> + <!--l. 323--><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-lmtt-10">\printindex</span></span></span> will not contain valid + hyperlinks. </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"> <span +class="ec-lmtt-10">plainpages </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-4-4" +class="td11"> + <!--l. 326--><p class="noindent" >Forces page anchors to be named by the arabic + form of the page number, rather than the + formatted form. </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-lmtt-10">nesting </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:wrap; text-align:left;" id="TBL-3-5-4" +class="td11"> + <!--l. 328--><p class="noindent" >Allows links to be nested; no drivers currently + support this. </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"> </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"> </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><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-3-9-4" +class="td11"></td></tr> + </table></div> +<!--l. 331--><p class="indent" > Note for option <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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. 336--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a + id="x1-70003.3"></a>Backend drivers</h4> +<!--l. 338--><p class="noindent" >If no driver is specified, the package defaults to loading the <span +class="ec-lmss-10">hypertex </span>driver. +<!--l. 341--><p class="noindent" > +<a + id="x1-7001r3"></a> <!--l. 342--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-4-1g"><col +id="TBL-4-1"><col +id="TBL-4-2"></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-lmtt-10">dvipdfm </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-1-2" +class="td11"> + <!--l. 342--><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-4-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-1" +class="td11"> <span +class="ec-lmtt-10">dvipdfmx </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-2-2" +class="td11"> + <!--l. 343--><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-4-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-1" +class="td11"> <span +class="ec-lmtt-10">dvips </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-3-2" +class="td11"> + <!--l. 344--><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-4-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-1" +class="td11"> <span +class="ec-lmtt-10">dvipsone </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-4-2" +class="td11"> + <!--l. 345--><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-4-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-1" +class="td11"> <span +class="ec-lmtt-10">dviwindo </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-5-2" +class="td11"> + <!--l. 346--><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-4-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-1" +class="td11"> <span +class="ec-lmtt-10">hypertex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-6-2" +class="td11"> + <!--l. 347--><p class="noindent" >Sets up <span +class="ec-lmss-10">hyperref </span>for use with the Hyper<span class="TEX">T<span +class="E">E</span>X</span>-compliant drivers. </td> +</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"> <span +class="ec-lmtt-10">latex2html </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-7-2" +class="td11"> + <!--l. 348--><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-4-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-8-1" +class="td11"> <span +class="ec-lmtt-10">nativepdf </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-8-2" +class="td11"> + <!--l. 349--><p class="noindent" >An alias for <span +class="ec-lmss-10">dvips</span> </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"> <span +class="ec-lmtt-10">pdfmark </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-9-2" +class="td11"> + <!--l. 350--><p class="noindent" >An alias for <span +class="ec-lmss-10">dvips</span> </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"> <span +class="ec-lmtt-10">pdftex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-10-2" +class="td11"> + <!--l. 351--><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-4-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-11-1" +class="td11"> <span +class="ec-lmtt-10">ps2pdf </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-11-2" +class="td11"> + <!--l. 352--><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-4-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-12-1" +class="td11"> <span +class="ec-lmtt-10">tex4ht </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-12-2" +class="td11"> + <!--l. 355--><p class="noindent" >For use with <span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span><span +class="ec-lmss-10">4ht</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-13-1" +class="td11"> <span +class="ec-lmtt-10">textures </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-13-2" +class="td11"> + <!--l. 356--><p class="noindent" >For use with <span +class="ec-lmss-10">Textures</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-14-1" +class="td11"> <span +class="ec-lmtt-10">vtex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-14-2" +class="td11"> + <!--l. 357--><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-4-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-15-1" +class="td11"> <span +class="ec-lmtt-10">vtexpdfmark </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-15-2" +class="td11"> + <!--l. 359--><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-4-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-16-1" +class="td11"> <span +class="ec-lmtt-10">xetex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-16-2" +class="td11"> + <!--l. 360--><p class="noindent" >For use with Xe<span class="TEX">T<span +class="E">E</span>X</span>(using backend for dvipdfm). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-17-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-18-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-19-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-20-1" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-4-20-2" +class="td11"></td></tr> + </table></div> +<!--l. 364--><p class="indent" > If you use <span +class="ec-lmss-10">dviwindo</span>, you may need to redefine the macro <span +class="ec-lmtt-10">\wwwbrowser </span>(the default is +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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: + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\renewcommand{wwwbrowser}{C:\string\Program\space + <br />  Files\string\Plus!\string\Microsoft\space + <br />  Internet\string\iexplore.exe} +</div> +</td></tr></table> +<!--l. 373--><p class="nopar" > +<!--l. 375--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.4 </span> <a + id="x1-80003.4"></a>Extension options</h4> +<!--l. 376--><p class="noindent" > +<a + id="x1-8001r4"></a> <!--l. 377--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><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-lmtt-10">extension </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-1-4" +class="td11"> + <!--l. 377--><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-5-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-1" +class="td11"> <span +class="ec-lmtt-10">hyperfigures </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"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-2-4" +class="td11"> + <!--l. 380--><p class="noindent" > </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-lmtt-10">backref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-3-4" +class="td11"> + <!--l. 380--><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-lmtt-10">\bibitem</span></span></span>. Supported values are + <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">section</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">slide</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">page</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">none</span></span></span>, or <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">false</span></span></span>. + If no value is given, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">section</span></span></span> is taken as + default. </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-lmtt-10">pagebackref </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:wrap; text-align:left;" id="TBL-5-4-4" +class="td11"> + <!--l. 384--><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-5-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-1" +class="td11"> <span +class="ec-lmtt-10">hyperindex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-5-4" +class="td11"> + <!--l. 386--><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-lmtt-10">pageanchor</span></span></span>, …) </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"> <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">pageanchors</span></span></span> <span +class="ec-lmtt-10">and </span><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">plainpages=false</span></span></span><span +class="ec-lmtt-10">. </span></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"> <span +class="ec-lmtt-10">hyperfootnotes </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-7-4" +class="td11"> + <!--l. 389--><p class="noindent" >Makes the footnote marks into + hyperlinks to the footnote text. Easily + broken … </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"> <span +class="ec-lmtt-10">encap </span></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:wrap; text-align:left;" id="TBL-5-8-4" +class="td11"> + <!--l. 391--><p class="noindent" >Sets encap character for hyperindex </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-1" +class="td11"> <span +class="ec-lmtt-10">linktocpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-9-4" +class="td11"> + <!--l. 392--><p class="noindent" >make page number, not text, be link on + TOC, LOF and LOT </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-5-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-1" +class="td11"> <span +class="ec-lmtt-10">breaklinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-10-4" +class="td11"> + <!--l. 393--><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-5-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-1" +class="td11"> <span +class="ec-lmtt-10">colorlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-11-4" +class="td11"> + <!--l. 395--><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. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-1" +class="td11"> <span +class="ec-lmtt-10">linkcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-3" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-12-4" +class="td11"> + <!--l. 398--><p class="noindent" >Color for normal internal links. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-1" +class="td11"> <span +class="ec-lmtt-10">anchorcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-3" +class="td11"> <span +class="ec-lmri-10">black </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-13-4" +class="td11"> + <!--l. 399--><p class="noindent" >Color for anchor text. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-14-1" +class="td11"> <span +class="ec-lmtt-10">citecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-14-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-14-3" +class="td11"> <span +class="ec-lmri-10">green </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-14-4" +class="td11"> + <!--l. 400--><p class="noindent" >Color for bibliographical citations in + text. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-15-1" +class="td11"> <span +class="ec-lmtt-10">filecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-15-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-15-3" +class="td11"> <span +class="ec-lmri-10">magenta </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-15-4" +class="td11"> + <!--l. 401--><p class="noindent" >Color for URLs which open local files. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-16-1" +class="td11"> <span +class="ec-lmtt-10">menucolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-16-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-16-3" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-16-4" +class="td11"> + <!--l. 402--><p class="noindent" >Color for Acrobat menu items. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-17-1" +class="td11"> <span +class="ec-lmtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-17-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-17-3" +class="td11"> <span +class="ec-lmri-10">filecolor </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-17-4" +class="td11"> + <!--l. 403--><p class="noindent" >Color for run links (launch + annotations). </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-18-1" +class="td11"> <span +class="ec-lmtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-18-2" +class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-18-3" +class="td11"> <span +class="ec-lmri-10">cyan </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-18-4" +class="td11"> + <!--l. 404--><p class="noindent" >Color for linked URLs. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-19-1" +class="td11"> <span +class="ec-lmtt-10">frenchlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-19-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-19-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-19-4" +class="td11"> + <!--l. 405--><p class="noindent" >use small caps instead of color for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-20-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-21-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-22-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-23-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-23-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-23-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-23-4" +class="td11"></td></tr> + </table></div> +<!--l. 408--><p class="indent" > Note that all color names must be defined before use, following the normal system of the standard +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> <span +class="ec-lmss-10">color </span>package. +<!--l. 411--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a + id="x1-90003.5"></a>PDF-specific display options</h4> +<!--l. 412--><p class="noindent" > +<a + id="x1-9001r5"></a> <!--l. 413--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-6-1g"><col +id="TBL-6-1"><col +id="TBL-6-2"><col +id="TBL-6-3"><col +id="TBL-6-4"></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-lmtt-10">bookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-1-4" +class="td10"> + <!--l. 413--><p class="noindent" >A set of Acrobat bookmarks are written, in a + manner similar to the table of contents, requiring + two passes of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>. Some postprocessing of + the bookmark file (file extension <span +class="ec-lmtt-10">.out</span>) may + be needed to translate <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> codes, since + bookmarks must be written in PDFEncoding. To + aid this process, the <span +class="ec-lmtt-10">.out </span>file is not rewritten + by <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> if it is edited to contain a line + <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\let\WriteBookmarks\relax</span></span></span> </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"><span +class="ec-lmtt-10">bookmarksopen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-2-4" +class="td10"> + <!--l. 419--><p class="noindent" >If Acrobat bookmarks are requested, show them + with all the subtrees expanded. </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-lmtt-10">bookmarksopenlevel </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-2" +class="td11"> parameter </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-3-4" +class="td10"> + <!--l. 421--><p class="noindent" >level (<span +class="ec-lmtt-10">\maxdimen</span>) to which bookmarks are open </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-lmtt-10">bookmarksnumbered </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-4-4" +class="td10"> + <!--l. 422--><p class="noindent" >If Acrobat bookmarks are requested, include + section numbers. </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-lmtt-10">bookmarkstype </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-3" +class="td11"> <span +class="ec-lmri-10">toc </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-5-4" +class="td10"> + <!--l. 423--><p class="noindent" >to specify which ‘toc’ file to mimic </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-lmtt-10">CJKbookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-6-4" +class="td10"> + <!--l. 425--><p class="noindent" >This option should be used to produce CJK + bookmarks. Package <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">hyperref</span></span></span> supports both + normal and preprocessed mode of the CJK + package; during the creation of bookmarks, + it simply replaces CJK’s macros with special + versions which expand to the corresponding + character codes. Note that without the ‘unicode’ + option of hyperref you get PDF files which + actually violate the PDF specification because + non-Unicode character codes are used – some + PDF readers localized for CJK languages (most + notably Acroread itself) support this. Also note + that option ‘CJKbookmarks’ cannot be used + together with option ‘unicode’. + <!--l. 437--><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-6-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-1" +class="td01"><span +class="ec-lmtt-10">pdfhighlight </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-3" +class="td11"> <span +class="ec-lmri-10">/I </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-7-4" +class="td10"> + <!--l. 440--><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-6-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-1" +class="td01"><span +class="ec-lmtt-10">citebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-3" +class="td11"> <span +class="ec-lmri-10">0 1 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-8-4" +class="td10"> + <!--l. 443--><p class="noindent" >The color of the box around citations </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-lmtt-10">filebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-3" +class="td11"> <span +class="ec-lmri-10">0 .5 .5 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-9-4" +class="td10"> + <!--l. 444--><p class="noindent" >The color of the box around links to files </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-lmtt-10">linkbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-3" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-10-4" +class="td10"> + <!--l. 445--><p class="noindent" >The color of the box around normal links </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-lmtt-10">menubordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-3" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-11-4" +class="td10"> + <!--l. 446--><p class="noindent" >The color of the box around Acrobat menu links</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-lmtt-10">urlbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-3" +class="td11"> <span +class="ec-lmri-10">0 1 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-12-4" +class="td10"> + <!--l. 447--><p class="noindent" >The color of the box around links to URLs </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-lmtt-10">runbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-2" +class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-3" +class="td11"> <span +class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-13-4" +class="td10"> + <!--l. 448--><p class="noindent" >color of border around ‘run’ links </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-lmtt-10">pdfborder </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-3" +class="td11"> <span +class="ec-lmri-10">0 0 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-14-4" +class="td10"> + <!--l. 449--><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-6-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-1" +class="td01"> </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"> </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"> </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"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-18-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-18-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-18-4" +class="td10"></td></tr> + </table></div> +<!--l. 453--><p class="indent" > Note that the color of link borders can be specified <span +class="ec-lmri-10">only </span>as 3 numbers in the range 0..1, giving an +RGB color. You cannot use colors defined in <span class="TEX">T<span +class="E">E</span>X</span>. +<!--l. 457--><p class="indent" > The bookmark commands are stored in a file called <span +class="ec-lmri-10">jobname</span><span +class="ec-lmtt-10">.out</span>. The files is not processed by +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> so any markup is passed through. You can postprocess this file as needed; as an aid +for this, the <span +class="ec-lmtt-10">.out </span>file is not overwritten on the next <span class="TEX">T<span +class="E">E</span>X</span> run if it is edited to contain the +line +<br class="newline" /> + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\let\WriteBookmarks\relax +</div> +</td></tr></table> +<!--l. 465--><p class="nopar" > +<!--l. 467--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.6 </span> <a + id="x1-100003.6"></a>PDF display and information options</h4> +<!--l. 468--><p class="noindent" > +<a + id="x1-10001r6"></a> <!--l. 469--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><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="td11"> <span +class="ec-lmtt-10">baseurl </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-2" +class="td11"> URL </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-1-4" +class="td11"> + <!--l. 469--><p class="noindent" >Sets the base URL of the PDF + document </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="td11"> <span +class="ec-lmtt-10">pdfpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-2-4" +class="td11"> + <!--l. 470--><p class="noindent" >Determines how the file is opening in + Acrobat; the possibilities are <span +class="ec-lmtt-10">UseNone</span>, + <span +class="ec-lmtt-10">UseThumbs</span> + (show thumbnails), <span +class="ec-lmtt-10">UseOutlines </span>(show + bookmarks), <span +class="ec-lmtt-10">FullScreen</span>, <span +class="ec-lmtt-10">UseOC </span>(PDF + 1.5), and <span +class="ec-lmtt-10">UseAttachments </span>(PDF 1.6). + If no mode if explicitly chosen, but the + bookmarks option is set, <span +class="ec-lmtt-10">UseOutlines</span> + is used. </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="td11"> <span +class="ec-lmtt-10">pdftitle </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"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-3-4" +class="td11"> + <!--l. 475--><p class="noindent" >Sets the document information Title + field </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="td11"> <span +class="ec-lmtt-10">pdfauthor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-4-4" +class="td11"> + <!--l. 476--><p class="noindent" >Sets the document information Author + field </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="td11"> <span +class="ec-lmtt-10">pdfsubject </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-5-4" +class="td11"> + <!--l. 477--><p class="noindent" >Sets the document information Subject + field </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="td11"> <span +class="ec-lmtt-10">pdfcreator </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-6-4" +class="td11"> + <!--l. 478--><p class="noindent" >Sets the document information Creator + field </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="td11"> <span +class="ec-lmtt-10">pdfproducer </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-7-4" +class="td11"> + <!--l. 479--><p class="noindent" >Sets the document information + Producer field </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="td11"> <span +class="ec-lmtt-10">pdfkeywords </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"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-8-4" +class="td11"> + <!--l. 480--><p class="noindent" >Sets the document information + Keywords field </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="td11"> <span +class="ec-lmtt-10">pdfview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-3" +class="td11"> <span +class="ec-lmri-10">XYZ </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-9-4" +class="td11"> + <!--l. 481--><p class="noindent" >Sets the default PDF ‘view’ for each + link </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="td11"> <span +class="ec-lmtt-10">pdfstartpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-3" +class="td11"> <span +class="ec-lmri-10">1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-10-4" +class="td11"> + <!--l. 482--><p class="noindent" >Determines on which page the PDF file + is opened. </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="td11"> <span +class="ec-lmtt-10">pdfstartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-3" +class="td11"> <span +class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-11-4" +class="td11"> + <!--l. 483--><p class="noindent" >Set the startup page view </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="td11"> <span +class="ec-lmtt-10">pdfpagescrop </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-2" +class="td11"> n n n n </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-3" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-12-4" +class="td11"> + <!--l. 484--><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-7-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-1" +class="td11"> <span +class="ec-lmtt-10">pdfcenterwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-13-4" +class="td11"> + <!--l. 485--><p class="noindent" >position the document window in the + center of the screen </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="td11"> <span +class="ec-lmtt-10">pdfdirection </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-14-4" +class="td11"> + <!--l. 486--><p class="noindent" >direction setting </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="td11"> <span +class="ec-lmtt-10">pdfdisplaydoctitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-15-4" +class="td11"> + <!--l. 487--><p class="noindent" >display document title instead of file + name in title bar </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="td11"> <span +class="ec-lmtt-10">pdfduplex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-16-4" +class="td11"> + <!--l. 489--><p class="noindent" >paper handling option for print dialog </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="td11"> <span +class="ec-lmtt-10">pdffitwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-17-4" +class="td11"> + <!--l. 490--><p class="noindent" >resize document window to fit + document size </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="td11"> <span +class="ec-lmtt-10">pdflang </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-18-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-18-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-18-4" +class="td11"> + <!--l. 491--><p class="noindent" >PDF language identifier (RFC 3066) </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="td11"> <span +class="ec-lmtt-10">pdfmenubar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-19-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-19-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-19-4" +class="td11"> + <!--l. 492--><p class="noindent" >make PDF viewer’s menu bar visible </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="td11"> <span +class="ec-lmtt-10">pdfnewwindow </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:wrap; text-align:left;" id="TBL-7-20-4" +class="td11"> + <!--l. 493--><p class="noindent" >make links that open another PDF file + start a new window </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="td11"> </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:wrap; text-align:left;" id="TBL-7-21-4" +class="td11"></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="td11"> <span +class="ec-lmtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-22-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-22-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-22-4" +class="td11"> + <!--l. 495--><p class="noindent" >page mode setting on exiting full-screen + mode </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="td11"> <span +class="ec-lmtt-10">pdfnumcopies </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-23-2" +class="td11"> integer </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-23-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-23-4" +class="td11"> + <!--l. 497--><p class="noindent" >number of printed copies </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="td11"> <span +class="ec-lmtt-10">pdfpagelayout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-24-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-24-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-24-4" +class="td11"> + <!--l. 498--><p class="noindent" >set layout of PDF pages </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="td11"> <span +class="ec-lmtt-10">pdfpagelabels </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-25-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-25-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-25-4" +class="td11"> + <!--l. 499--><p class="noindent" >set PDF page labels </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="td11"> <span +class="ec-lmtt-10">pdfpagetransition </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-26-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-26-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-26-4" +class="td11"> + <!--l. 500--><p class="noindent" >set PDF page transition style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-27-1" +class="td11"> <span +class="ec-lmtt-10">pdfpicktrackbypdfsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-27-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-27-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-27-4" +class="td11"> + <!--l. 501--><p class="noindent" >set option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-28-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-28-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-28-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-28-4" +class="td11"> + <!--l. 502--><p class="noindent" >set /PrintArea of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-29-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-29-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-29-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-29-4" +class="td11"> + <!--l. 503--><p class="noindent" >set /PrintClip of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-30-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintpagerange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-30-2" +class="td11"> n n (n n)* </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-30-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-30-4" +class="td11"> + <!--l. 505--><p class="noindent" >set /PrintPageRange of viewer + preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-31-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintscaling </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-31-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-31-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-31-4" +class="td11"> + <!--l. 507--><p class="noindent" >page scaling option for print dialog; + valid values are <span +class="ec-lmtt-10">None </span>and <span +class="ec-lmtt-10">AppDefault</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-32-1" +class="td11"> <span +class="ec-lmtt-10">pdftoolbar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-32-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-32-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-32-4" +class="td11"> + <!--l. 510--><p class="noindent" >make PDF toolbar visible </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-7-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-33-1" +class="td11"> <span +class="ec-lmtt-10">pdfviewarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-33-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-33-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-33-4" +class="td11"> + <!--l. 511--><p class="noindent" >set /ViewArea of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-34-1" +class="td11"> <span +class="ec-lmtt-10">pdfviewclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-34-2" +class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-34-3" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-34-4" +class="td11"> + <!--l. 512--><p class="noindent" >set /ViewClip of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-35-1" +class="td11"> <span +class="ec-lmtt-10">pdfwindowui </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-35-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-35-3" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-35-4" +class="td11"> + <!--l. 513--><p class="noindent" >make PDF user interface elements + visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-36-1" +class="td11"> <span +class="ec-lmtt-10">unicode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-36-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-36-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-36-4" +class="td11"> + <!--l. 514--><p class="noindent" >Unicode encoded PDF strings </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-37-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-38-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-39-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-40-1" +class="td11"> </td> + </tr> + </table></div> +<!--l. 517--><p class="indent" > Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, +which is not the same as <span class="TEX">T<span +class="E">E</span>X</span>’s. The unit is bp and the origin is in the lower left corner. +See also <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hypercalcbp</span></span></span> that is explained on page <a +href="#x1-140004.2">35<!--tex4ht:ref: hypercalcbp --></a>. pdf<span class="TEX">T<span +class="E">E</span>X</span> works by supplying default +values for <span +class="ec-lmtt-10">XYZ </span>(horizontal <span +class="lmsy-10"> +class="lmsy-10"> +class="ec-lmtt-10">FitBH</span>. However, drivers using <span +class="ec-lmtt-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-lmtt-10">pdfview </span>and <span +class="ec-lmtt-10">pdfstartview</span> +parameters. +<!--l. 529--><p class="noindent" > +<a + id="x1-10002r7"></a> <!--l. 530--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-8-1g"><col +id="TBL-8-1"><col +id="TBL-8-2"><col +id="TBL-8-3"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-8-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-1" +class="td11"> <span +class="ec-lmtt-10">XYZ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-2" +class="td11"> <span +class="ec-lmri-10">left top zoom </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-1-3" +class="td11"> + <!--l. 530--><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-8-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-1" +class="td11"> <span +class="ec-lmtt-10">Fit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-2-3" +class="td11"> + <!--l. 532--><p class="noindent" >Fits the page to the window. </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="td11"> <span +class="ec-lmtt-10">FitH </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-2" +class="td11"> <span +class="ec-lmri-10">top </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-3-3" +class="td11"> + <!--l. 533--><p class="noindent" >Fits the width of the page to the window. </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="td11"> <span +class="ec-lmtt-10">FitV </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-2" +class="td11"> <span +class="ec-lmri-10">left </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-4-3" +class="td11"> + <!--l. 534--><p class="noindent" >Fits the height of the page to the window. </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="td11"> <span +class="ec-lmtt-10">FitR </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-2" +class="td11"> <span +class="ec-lmri-10">left bottom right top </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-5-3" +class="td11"> + <!--l. 535--><p class="noindent" >Fits the rectangle specified by the four + coordinates to the window. </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="td11"> <span +class="ec-lmtt-10">FitB </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-6-3" +class="td11"> + <!--l. 536--><p class="noindent" >Fits the page bounding box to the window. </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="td11"> <span +class="ec-lmtt-10">FitBH </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-2" +class="td11"> <span +class="ec-lmri-10">top </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-7-3" +class="td11"> + <!--l. 537--><p class="noindent" >Fits the width of the page bounding box to + the window. </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="td11"> <span +class="ec-lmtt-10">FitBV </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-2" +class="td11"> <span +class="ec-lmri-10">left </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-8-3" +class="td11"> + <!--l. 538--><p class="noindent" >Fits the height of the page bounding box to + the window. </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="td11"> </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="td11"> </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="td11"> </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="td11"> </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="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-13-3" +class="td11"></td></tr> + </table></div> +<!--l. 541--><p class="indent" > The <span +class="ec-lmtt-10">pdfpagelayout </span>can be one of the following values. +<!--l. 543--><p class="noindent" > +<a + id="x1-10003r8"></a> <!--l. 544--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-9-1g"><col +id="TBL-9-1"><col +id="TBL-9-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-9-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-1-1" +class="td11"> <span +class="ec-lmtt-10">SinglePage </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-1-2" +class="td11"> + <!--l. 544--><p class="noindent" >Displays a single page; advancing flips the page </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="td11"> <span +class="ec-lmtt-10">OneColumn </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-2-2" +class="td11"> + <!--l. 545--><p class="noindent" >Displays the document in one column; continuous scrolling. </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="td11"> <span +class="ec-lmtt-10">TwoColumnLeft </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-3-2" +class="td11"> + <!--l. 546--><p class="noindent" >Displays the document in two columns, odd-numbered pages to + the left. </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="td11"> <span +class="ec-lmtt-10">TwoColumnRight </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-4-2" +class="td11"> + <!--l. 547--><p class="noindent" >Displays the document in two columns, odd-numbered pages to + the right. </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="td11"> </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="td11"> </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="td11"> </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="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-9-8-2" +class="td11"></td></tr> + </table></div> +<!--l. 550--><p class="indent" > Finally, the <span +class="ec-lmtt-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="lmsy-7"> +class="ec-lmri-10">/Dm </span>is a horizontal (<span +class="ec-lmtt-10">/H</span>) or vertical (<span +class="ec-lmtt-10">/V</span>) dimension +(e.g. <span +class="ec-lmtt-10">Blinds /Dm /V</span>), and <span +class="ec-lmri-10">/M </span>is for motion, either in (<span +class="ec-lmtt-10">/I</span>) or out (<span +class="ec-lmtt-10">/O</span>). +<!--l. 557--><p class="noindent" > +<a + id="x1-10004r9"></a> <!--l. 558--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><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="td11"> <span +class="ec-lmtt-10">Blinds </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-1-2" +class="td11"> /Dm </td><td style="white-space:wrap; text-align:left;" id="TBL-10-1-3" +class="td11"> + <!--l. 558--><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-10-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-1" +class="td11"> <span +class="ec-lmtt-10">Box </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-2" +class="td11"> /M </td><td style="white-space:wrap; text-align:left;" id="TBL-10-2-3" +class="td11"> + <!--l. 560--><p class="noindent" >A box sweeps in or out. </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="td11"> <span +class="ec-lmtt-10">Dissolve </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-10-3-3" +class="td11"> + <!--l. 561--><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-10-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-1" +class="td11"> <span +class="ec-lmtt-10">Glitter </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-2" +class="td11"> /Di </td><td style="white-space:wrap; text-align:left;" id="TBL-10-4-3" +class="td11"> + <!--l. 562--><p class="noindent" >Similar to Dissolve, except the effect sweeps across the + screen. </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="td11"> <span +class="ec-lmtt-10">Split </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-2" +class="td11"> /Dm /M </td><td style="white-space:wrap; text-align:left;" id="TBL-10-5-3" +class="td11"> + <!--l. 563--><p class="noindent" >Two lines sweep across the screen to reveal the new page. </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="td11"> <span +class="ec-lmtt-10">Wipe </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-2" +class="td11"> /Di </td><td style="white-space:wrap; text-align:left;" id="TBL-10-6-3" +class="td11"> + <!--l. 564--><p class="noindent" >A single line sweeps across the screen to reveal the new + page. </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="td11"> </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="td11"> </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="td11"> </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="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-10-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-10-10-3" +class="td11"></td></tr> + </table></div> + +<!--l. 567--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.7 </span> <a + id="x1-110003.7"></a>Big alphabetical list</h4> +<!--l. 569--><p class="noindent" >The following is a complete listing of available options for <span +class="ec-lmss-10">hyperref</span>, arranged alphabetically. +<!--l. 572--><p class="noindent" > +<a + id="x1-11001r10"></a> <!--l. 573--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-11-1g"><col +id="TBL-11-1"><col +id="TBL-11-2"><col +id="TBL-11-3"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-11-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-1-1" +class="td11"> <span +class="ec-lmtt-10">a4paper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-1-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-1-3" +class="td11"> + <!--l. 573--><p class="noindent" >use A4 paper </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="td11"> <span +class="ec-lmtt-10">a5paper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-2-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-2-3" +class="td11"> + <!--l. 574--><p class="noindent" >use A5 paper </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="td11"> <span +class="ec-lmtt-10">anchorcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-3-2" +class="td11"> <span +class="ec-lmri-10">black </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-3-3" +class="td11"> + <!--l. 575--><p class="noindent" >set color of anchors </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="td11"> <span +class="ec-lmtt-10">b5paper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-4-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-4-3" +class="td11"> + <!--l. 576--><p class="noindent" >use B5 paper </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="td11"> <span +class="ec-lmtt-10">backref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-5-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-5-3" +class="td11"> + <!--l. 577--><p class="noindent" >do bibliographical back references </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="td11"> <span +class="ec-lmtt-10">baseurl </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-6-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-6-3" +class="td11"> + <!--l. 578--><p class="noindent" >set base URL for document </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="td11"> <span +class="ec-lmtt-10">bookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-7-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-7-3" +class="td11"> + <!--l. 579--><p class="noindent" >make bookmarks </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="td11"> <span +class="ec-lmtt-10">bookmarksnumbered </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-8-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-8-3" +class="td11"> + <!--l. 580--><p class="noindent" >put section numbers in bookmarks </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="td11"> <span +class="ec-lmtt-10">bookmarksopen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-9-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-9-3" +class="td11"> + <!--l. 581--><p class="noindent" >open up bookmark tree </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="td11"> <span +class="ec-lmtt-10">bookmarksopenlevel </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-10-2" +class="td11"> <span +class="ec-lmtt-10">\maxdimen </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-10-3" +class="td11"> + <!--l. 582--><p class="noindent" >level to which bookmarks are open </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-11-1" +class="td11"> <span +class="ec-lmtt-10">bookmarkstype </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-11-2" +class="td11"> <span +class="ec-lmri-10">toc </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-11-3" +class="td11"> + <!--l. 583--><p class="noindent" >to specify which ‘toc’ file to mimic </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-12-1" +class="td11"> <span +class="ec-lmtt-10">breaklinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-12-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-12-3" +class="td11"> + <!--l. 584--><p class="noindent" >allow links to break over lines </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-13-1" +class="td11"> <span +class="ec-lmtt-10">CJKbookmarks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-13-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-13-3" +class="td11"> + <!--l. 585--><p class="noindent" >to produce CJK bookmarks </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-14-1" +class="td11"> <span +class="ec-lmtt-10">citebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-14-2" +class="td11"> <span +class="ec-lmri-10">0 1 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-14-3" +class="td11"> + <!--l. 586--><p class="noindent" >color of border around cites </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-15-1" +class="td11"> <span +class="ec-lmtt-10">citecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-15-2" +class="td11"> <span +class="ec-lmri-10">green </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-15-3" +class="td11"> + <!--l. 587--><p class="noindent" >color of citation links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-16-1" +class="td11"> <span +class="ec-lmtt-10">colorlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-16-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-16-3" +class="td11"> + <!--l. 588--><p class="noindent" >color links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-17-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-17-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-17-3" +class="td11"> + <!--l. 589--><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-11-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-18-1" +class="td11"> <span +class="ec-lmtt-10">debug </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-18-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-18-3" +class="td11"> + <!--l. 590--><p class="noindent" >provide details of anchors defined; same + as verbose </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-19-1" +class="td11"> <span +class="ec-lmtt-10">draft </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-19-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-19-3" +class="td11"> + <!--l. 591--><p class="noindent" >do not do any hyperlinking </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-20-1" +class="td11"> <span +class="ec-lmtt-10">dvipdfm </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-20-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-20-3" +class="td11"> + <!--l. 592--><p class="noindent" >use <span +class="ec-lmss-10">dvipdfm </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-21-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-21-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-21-3" +class="td11"></td></tr> + + +<tr + style="vertical-align:baseline;" id="TBL-11-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-22-1" +class="td11"> <span +class="ec-lmtt-10">dvipdfmx </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-22-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-22-3" +class="td11"> + <!--l. 593--><p class="noindent" >use <span +class="ec-lmss-10">dvipdfmx </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-23-1" +class="td11"> <span +class="ec-lmtt-10">dvips </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-23-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-23-3" +class="td11"> + <!--l. 594--><p class="noindent" >use <span +class="ec-lmss-10">dvips </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-24-1" +class="td11"> <span +class="ec-lmtt-10">dvipsone </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-24-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-24-3" +class="td11"> + <!--l. 595--><p class="noindent" >use <span +class="ec-lmss-10">dvipsone </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-25-1" +class="td11"> <span +class="ec-lmtt-10">dviwindo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-25-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-25-3" +class="td11"> + <!--l. 596--><p class="noindent" >use <span +class="ec-lmss-10">dviwindo </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-26-1" +class="td11"> <span +class="ec-lmtt-10">encap </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-26-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-26-3" +class="td11"> + <!--l. 597--><p class="noindent" >to set encap character for hyperindex </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-27-1" +class="td11"> <span +class="ec-lmtt-10">executivepaper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-27-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-27-3" +class="td11"> + <!--l. 598--><p class="noindent" >use executivepaper </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-28-1" +class="td11"> <span +class="ec-lmtt-10">extension </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-28-2" +class="td11"> <span +class="ec-lmri-10">dvi </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-28-3" +class="td11"> + <!--l. 599--><p class="noindent" >suffix of linked files </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-29-1" +class="td11"> <span +class="ec-lmtt-10">filebordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-29-2" +class="td11"> <span +class="ec-lmri-10">0 .5 .5 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-29-3" +class="td11"> + <!--l. 600--><p class="noindent" >color of border around file links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-30-1" +class="td11"> <span +class="ec-lmtt-10">filecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-30-2" +class="td11"> <span +class="ec-lmri-10">cyan </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-30-3" +class="td11"> + <!--l. 601--><p class="noindent" >color of file links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-31-1" +class="td11"> <span +class="ec-lmtt-10">final </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-31-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-31-3" +class="td11"> + <!--l. 602--><p class="noindent" >opposite of option draft </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-32-1" +class="td11"> <span +class="ec-lmtt-10">frenchlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-32-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-32-3" +class="td11"> + <!--l. 603--><p class="noindent" >use small caps instead of color for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-33-1" +class="td11"> <span +class="ec-lmtt-10">hyperfigures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-33-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-33-3" +class="td11"> + <!--l. 604--><p class="noindent" >make figures hyper links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-34-1" +class="td11"> <span +class="ec-lmtt-10">hyperfootnotes </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-34-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-34-3" +class="td11"> + <!--l. 605--><p class="noindent" >set up hyperlinked footnotes </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-35-1" +class="td11"> <span +class="ec-lmtt-10">hyperindex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-35-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-35-3" +class="td11"> + <!--l. 606--><p class="noindent" >set up hyperlinked indices </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-36-1" +class="td11"> <span +class="ec-lmtt-10">hypertex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-36-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-36-3" +class="td11"> + <!--l. 607--><p class="noindent" >use <span +class="ec-lmss-10">Hyper</span><span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span> backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-37-1" +class="td11"> <span +class="ec-lmtt-10">hypertexnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-37-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-37-3" +class="td11"> + <!--l. 608--><p class="noindent" >use guessable names for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-38-1" +class="td11"> <span +class="ec-lmtt-10">implicit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-38-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-38-3" +class="td11"> + <!--l. 609--><p class="noindent" >redefine <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> internals </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-39-1" +class="td11"> <span +class="ec-lmtt-10">latex2html </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-39-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-39-3" +class="td11"> + <!--l. 610--><p class="noindent" >use <span class="LATEX"><span +class="ec-lmss-10">L</span><span class="A"><span +class="ec-lmss-10">A</span></span><span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span></span><span +class="ec-lmss-10">2HTML </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-40-1" +class="td11"> <span +class="ec-lmtt-10">legalpaper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-40-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-40-3" +class="td11"> + <!--l. 611--><p class="noindent" >use legalpaper </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-41-1" +class="td11"> <span +class="ec-lmtt-10">letterpaper </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-41-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-41-3" +class="td11"> + <!--l. 612--><p class="noindent" >use letterpaper </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-42-1" +class="td11"> </td> + </tr> +<tr + style="vertical-align:baseline;" id="TBL-11-43-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-43-1" +class="td11"> <span +class="ec-lmtt-10">linkbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-43-2" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-43-3" +class="td11"> + <!--l. 613--><p class="noindent" >color of border around links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-44-1" +class="td11"> <span +class="ec-lmtt-10">linkcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-44-2" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-44-3" +class="td11"> + <!--l. 614--><p class="noindent" >color of links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-45-1" +class="td11"> <span +class="ec-lmtt-10">linktocpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-45-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-45-3" +class="td11"> + <!--l. 615--><p class="noindent" >make page number, not text, be link on + TOC, LOF and LOT </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-46-1" +class="td11"> <span +class="ec-lmtt-10">menubordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-46-2" +class="td11"> <span +class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-46-3" +class="td11"> + <!--l. 616--><p class="noindent" >color of border around menu links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-47-1" +class="td11"> <span +class="ec-lmtt-10">menucolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-47-2" +class="td11"> <span +class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-47-3" +class="td11"> + <!--l. 617--><p class="noindent" >color for menu links </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-11-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-48-1" +class="td11"> <span +class="ec-lmtt-10">nativepdf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-48-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-48-3" +class="td11"> + <!--l. 618--><p class="noindent" >an alias for <span +class="ec-lmss-10">dvips</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-49-1" +class="td11"> <span +class="ec-lmtt-10">naturalnames </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-49-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-49-3" +class="td11"> + <!--l. 619--><p class="noindent" >use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-computed names for links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-50-1" +class="td11"> <span +class="ec-lmtt-10">nesting </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-50-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-50-3" +class="td11"> + <!--l. 620--><p class="noindent" >allow nesting of links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-51-1" +class="td11"> <span +class="ec-lmtt-10">pageanchor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-51-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-51-3" +class="td11"> + <!--l. 621--><p class="noindent" >put an anchor on every page </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-52-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-52-1" +class="td11"> <span +class="ec-lmtt-10">pagebackref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-52-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-52-3" +class="td11"> + <!--l. 622--><p class="noindent" >backreference by page number </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-53-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-53-1" +class="td11"> <span +class="ec-lmtt-10">pdfauthor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-53-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-53-3" +class="td11"> + <!--l. 623--><p class="noindent" >text for PDF Author field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-54-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-54-1" +class="td11"> <span +class="ec-lmtt-10">pdfborder </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-54-2" +class="td11"> <span +class="ec-lmri-10">0 0 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-54-3" +class="td11"> + <!--l. 624--><p class="noindent" >width of PDF link border </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-55-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-55-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-55-2" +class="td11"> <span +class="ec-lmri-10">0 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-55-3" +class="td11"> + <!--l. 625--><p class="noindent" >(<span +class="ec-lmtt-10">colorlinks)</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-56-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-56-1" +class="td11"> <span +class="ec-lmtt-10">pdfcenterwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-56-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-56-3" +class="td11"> + <!--l. 626--><p class="noindent" >position the document window in the + center of the screen </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-57-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-57-1" +class="td11"> <span +class="ec-lmtt-10">pdfcreator </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-57-2" +class="td11"> <span +class="ec-lmri-10">LaTeX with </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-57-3" +class="td11"> + <!--l. 627--><p class="noindent" >text for PDF Creator field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-58-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-58-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-58-2" +class="td11"> <span +class="ec-lmri-10">hyperref </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-58-3" +class="td11"> + <!--l. 629--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-59-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-59-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-59-2" +class="td11"> <span +class="ec-lmri-10">package </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-59-3" +class="td11"> + <!--l. 630--><p class="noindent" > </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-60-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-60-1" +class="td11"> <span +class="ec-lmtt-10">pdfdirection </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-60-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-60-3" +class="td11"> + <!--l. 630--><p class="noindent" >direction setting </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-61-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-61-1" +class="td11"> <span +class="ec-lmtt-10">pdfdisplaydoctitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-61-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-61-3" +class="td11"> + <!--l. 631--><p class="noindent" >display document title instead of file + name in title bar </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-62-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-62-1" +class="td11"> <span +class="ec-lmtt-10">pdfduplex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-62-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-62-3" +class="td11"> + <!--l. 633--><p class="noindent" >paper handling option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-63-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-63-1" +class="td11"> </td> + </tr> +<tr + style="vertical-align:baseline;" id="TBL-11-64-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-64-1" +class="td11"> <span +class="ec-lmtt-10">pdffitwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-64-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-64-3" +class="td11"> + <!--l. 635--><p class="noindent" >resize document window to fit + document size </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-65-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-65-1" +class="td11"> <span +class="ec-lmtt-10">pdfhighlight </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-65-2" +class="td11"> <span +class="ec-lmri-10">/I </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-65-3" +class="td11"> + <!--l. 636--><p class="noindent" >set highlighting of PDF links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-66-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-66-1" +class="td11"> <span +class="ec-lmtt-10">pdfkeywords </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-66-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-66-3" +class="td11"> + <!--l. 637--><p class="noindent" >text for PDF Keywords field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-67-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-67-1" +class="td11"> <span +class="ec-lmtt-10">pdflang </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-67-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-67-3" +class="td11"> + <!--l. 638--><p class="noindent" >PDF language identifier (RFC 3066) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-68-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-68-1" +class="td11"> <span +class="ec-lmtt-10">pdfmark </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-68-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-68-3" +class="td11"> + <!--l. 639--><p class="noindent" >an alias for <span +class="ec-lmss-10">dvips</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-69-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-69-1" +class="td11"> <span +class="ec-lmtt-10">pdfmenubar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-69-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-69-3" +class="td11"> + <!--l. 640--><p class="noindent" >make PDF viewer’s menu bar visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-70-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-70-1" +class="td11"> <span +class="ec-lmtt-10">pdfnewwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-70-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-70-3" +class="td11"> + <!--l. 641--><p class="noindent" >make links that open another PDF </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-71-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-71-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-71-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-71-3" +class="td11"> + <!--l. 642--><p class="noindent" >file start a new window </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-11-72-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-72-1" +class="td11"> <span +class="ec-lmtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-72-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-72-3" +class="td11"> + <!--l. 644--><p class="noindent" >page mode setting on exiting full-screen + mode </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-73-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-73-1" +class="td11"> <span +class="ec-lmtt-10">pdfnumcopies </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-73-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-73-3" +class="td11"> + <!--l. 646--><p class="noindent" >number of printed copies </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-74-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-74-1" +class="td11"> <span +class="ec-lmtt-10">pdfpagelayout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-74-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-74-3" +class="td11"> + <!--l. 647--><p class="noindent" >set layout of PDF pages </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-75-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-75-1" +class="td11"> <span +class="ec-lmtt-10">pdfpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-75-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-75-3" +class="td11"> + <!--l. 648--><p class="noindent" >set default mode of PDF display </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-76-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-76-1" +class="td11"> <span +class="ec-lmtt-10">pdfpagelabels </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-76-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-76-3" +class="td11"> + <!--l. 649--><p class="noindent" >set PDF page labels </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-77-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-77-1" +class="td11"> <span +class="ec-lmtt-10">pdfpagescrop </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-77-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-77-3" +class="td11"> + <!--l. 650--><p class="noindent" >set crop size of PDF document </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-78-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-78-1" +class="td11"> <span +class="ec-lmtt-10">pdfpagetransition </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-78-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-78-3" +class="td11"> + <!--l. 651--><p class="noindent" >set PDF page transition style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-79-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-79-1" +class="td11"> <span +class="ec-lmtt-10">pdfpicktrackbypdfsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-79-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-79-3" +class="td11"> + <!--l. 653--><p class="noindent" >set option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-80-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-80-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-80-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-80-3" +class="td11"> + <!--l. 654--><p class="noindent" >set /PrintArea of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-81-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-81-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-81-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-81-3" +class="td11"> + <!--l. 655--><p class="noindent" >set /PrintClip of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-82-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-82-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintpagerange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-82-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-82-3" +class="td11"> + <!--l. 656--><p class="noindent" >set /PrintPageRange of viewer + preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-83-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-83-1" +class="td11"> <span +class="ec-lmtt-10">pdfprintscaling </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-83-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-83-3" +class="td11"> + <!--l. 657--><p class="noindent" >page scaling option for print dialog </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-84-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-84-1" +class="td11"> </td> + </tr> +<tr + style="vertical-align:baseline;" id="TBL-11-85-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-85-1" +class="td11"> <span +class="ec-lmtt-10">pdfproducer </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-85-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-85-3" +class="td11"> + <!--l. 658--><p class="noindent" >text for PDF Producer field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-86-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-86-1" +class="td11"> <span +class="ec-lmtt-10">pdfstartpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-86-2" +class="td11"> <span +class="ec-lmri-10">1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-86-3" +class="td11"> + <!--l. 659--><p class="noindent" >page at which PDF document opens </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-87-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-87-1" +class="td11"> <span +class="ec-lmtt-10">pdfstartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-87-2" +class="td11"> <span +class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-87-3" +class="td11"> + <!--l. 660--><p class="noindent" >starting view of PDF document </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-88-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-88-1" +class="td11"> <span +class="ec-lmtt-10">pdfsubject </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-88-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-88-3" +class="td11"> + <!--l. 661--><p class="noindent" >text for PDF Subject field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-89-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-89-1" +class="td11"> <span +class="ec-lmtt-10">pdftex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-89-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-89-3" +class="td11"> + <!--l. 662--><p class="noindent" >use <span +class="ec-lmss-10">pdf</span><span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span> backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-90-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-90-1" +class="td11"> <span +class="ec-lmtt-10">pdftitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-90-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-90-3" +class="td11"> + <!--l. 663--><p class="noindent" >text for PDF Title field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-91-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-91-1" +class="td11"> <span +class="ec-lmtt-10">pdftoolbar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-91-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-91-3" +class="td11"> + <!--l. 664--><p class="noindent" >make PDF toolbar visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-92-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-92-1" +class="td11"> <span +class="ec-lmtt-10">pdfview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-92-2" +class="td11"> <span +class="ec-lmri-10">XYZ </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-92-3" +class="td11"> + <!--l. 665--><p class="noindent" >PDF ‘view’ when on link traversal </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-93-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-93-1" +class="td11"> <span +class="ec-lmtt-10">pdfviewarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-93-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-93-3" +class="td11"> + <!--l. 666--><p class="noindent" >set /ViewArea of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-94-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-94-1" +class="td11"> <span +class="ec-lmtt-10">pdfviewclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-94-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-94-3" +class="td11"> + <!--l. 667--><p class="noindent" >set /ViewClip of viewer preferences </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-95-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-95-1" +class="td11"> <span +class="ec-lmtt-10">pdfwindowui </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-95-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-95-3" +class="td11"> + <!--l. 668--><p class="noindent" >make PDF user interface elements + visible </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-96-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-96-1" +class="td11"> <span +class="ec-lmtt-10">plainpages </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-96-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-96-3" +class="td11"> + <!--l. 669--><p class="noindent" >do page number anchors as plain arabic </td> + + +</tr><tr + style="vertical-align:baseline;" id="TBL-11-97-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-97-1" +class="td11"> <span +class="ec-lmtt-10">ps2pdf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-97-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-97-3" +class="td11"> + <!--l. 670--><p class="noindent" >use <span +class="ec-lmss-10">ps2pdf </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-98-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-98-1" +class="td11"> <span +class="ec-lmtt-10">raiselinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-98-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-98-3" +class="td11"> + <!--l. 671--><p class="noindent" >raise up links (for <span +class="ec-lmss-10">Hyper</span><span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span> backend) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-99-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-99-1" +class="td11"> <span +class="ec-lmtt-10">runbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-99-2" +class="td11"> <span +class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-99-3" +class="td11"> + <!--l. 672--><p class="noindent" >color of border around ‘run’ links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-100-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-100-1" +class="td11"> <span +class="ec-lmtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-100-2" +class="td11"> <span +class="ec-lmri-10">filecolor </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-100-3" +class="td11"> + <!--l. 673--><p class="noindent" >color of ‘run’ links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-101-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-101-1" +class="td11"> <span +class="ec-lmtt-10">setpagesize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-101-2" +class="td11"> <span +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-101-3" +class="td11"> + <!--l. 674--><p class="noindent" >set page size by special driver + commands </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-102-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-102-1" +class="td11"> <span +class="ec-lmtt-10">tex4ht </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-102-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-102-3" +class="td11"> + <!--l. 675--><p class="noindent" >use <span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span><span +class="ec-lmss-10">4ht </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-103-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-103-1" +class="td11"> <span +class="ec-lmtt-10">textures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-103-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-103-3" +class="td11"> + <!--l. 676--><p class="noindent" >use <span +class="ec-lmss-10">Textures </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-104-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-104-1" +class="td11"> <span +class="ec-lmtt-10">unicode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-104-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-104-3" +class="td11"> + <!--l. 677--><p class="noindent" >Unicode encoded pdf strings </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-105-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-105-1" +class="td11"> </td> + </tr> +<tr + style="vertical-align:baseline;" id="TBL-11-106-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-106-1" +class="td11"> <span +class="ec-lmtt-10">urlbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-106-2" +class="td11"> <span +class="ec-lmri-10">0 1 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-106-3" +class="td11"> + <!--l. 678--><p class="noindent" >color of border around URL links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-107-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-107-1" +class="td11"> <span +class="ec-lmtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-107-2" +class="td11"> <span +class="ec-lmri-10">magenta </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-107-3" +class="td11"> + <!--l. 679--><p class="noindent" >color of URL links </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-108-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-108-1" +class="td11"> <span +class="ec-lmtt-10">verbose </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-108-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-11-108-3" +class="td11"> + <!--l. 680--><p class="noindent" >be chatty </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-109-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-109-1" +class="td11"> <span +class="ec-lmtt-10">vtex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-109-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-109-3" +class="td11"> + <!--l. 681--><p class="noindent" >use <span +class="ec-lmss-10">VTeX </span>backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-110-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-110-1" +class="td11"> <span +class="ec-lmtt-10">xetex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-110-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-110-3" +class="td11"> + <!--l. 682--><p class="noindent" >use <span +class="ec-lmss-10">Xe</span><span class="TEX"><span +class="ec-lmss-10">T</span><span +class="E"><span +class="ec-lmss-10">E</span></span><span +class="ec-lmss-10">X</span></span> backend </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-111-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-111-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-112-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-112-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-113-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-113-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-114-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-114-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-11-115-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-115-1" +class="td11"> </td> + </tr> + </table></div> +<!--l. 685--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-120004"></a>Additional user macros</h3> +<!--l. 687--><p class="noindent" >If you need to make references to URLs, or write explicit links, the following low-level user macros are +provided: +<!--l. 690--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\href{</span><span +class="ec-lmri-10">URL</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 694--><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. +<!--l. 699--><p class="noindent" > + + +<span class="fbox"> <span +class="ec-lmtt-10">\url{</span><span +class="ec-lmri-10">URL</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 703--><p class="noindent" >Similar to <span +class="ec-lmtt-10">\href</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">}{</span></span></span><span +class="ec-lmtt-10">\nolinkurl</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">{</span></span></span><span +class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">}}</span></span></span>. Depending on the driver <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\href</span></span></span> also tries to detect the +link type. Thus the result can be a url link, file link, … +<!--l. 708--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\nolinkurl{</span><span +class="ec-lmri-10">URL</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 712--><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-lmtt-10">\url</span></span></span>, without creating a hyperlink. +<!--l. 715--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hyperbaseurl{</span><span +class="ec-lmri-10">URL</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 719--><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. 722--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hyperimage{</span><span +class="ec-lmri-10">imageURL</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 726--><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. 729--><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. 732--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hyperdef{</span><span +class="ec-lmri-10">category</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">name</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 736--><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. 739--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hyperref{</span><span +class="ec-lmri-10">URL</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">category</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">name</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 743--><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. 745--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hyperref[</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 749--><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-lmtt-10">\ref{</span></span></span><span +class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">}</span></span></span> would be linked. +<!--l. 753--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hyperlink{</span><span +class="ec-lmri-10">name</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 756--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hypertarget{</span><span +class="ec-lmri-10">name</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 760--><p class="noindent" >A simple internal link is created with <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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-lmtt-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-lmtt-10">\hypertarget</span></span></span>, and the <span +class="ec-lmri-10">text </span>which be used as the link on the page. + + +<!--l. 766--><p class="indent" > Note that in HTML parlance, the <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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-lmtt-10">\href</span></span></span> expects a full URL. +<!--l. 770--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\phantomsection</span> </span> +<!--l. 774--><p class="noindent" >This sets an anchor at this location. It works similar to <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hypertarget{}{}</span></span></span> with an automatically +choosen anchor name. Often it is used in conjunction with <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\addcontentsline</span></span></span> for sectionlike things +(index, bibliography, preface). <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\addcontentsline</span></span></span> refers to the latest previous location where an anchor +is set. Example: + <div class="quote"> + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\cleardoublepage + <br />\phantomsection + <br />\addcontentsline{toc}{chapter}{\indexname} + <br />\printindex +</div> + </td></tr></table> + <!--l. 787--><p class="nopar" ></div> +<!--l. 789--><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. 793--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\autoref{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 797--><p class="noindent" >This is a replacement for the usual <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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. 803--><p class="indent" > The label is worked out from the context of the original <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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-lmtt-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. 811--><p class="indent" > For each macro below, <span +class="ec-lmss-10">hyperref </span>checks <span +class="ec-lmtt-10">\*autorefname </span>before <span +class="ec-lmtt-10">\*name</span>. For instance, it looks for +<span +class="ec-lmtt-10">\figureautorefname </span>before <span +class="ec-lmtt-10">\figurename</span>. +<!--l. 815--><p class="noindent" > +<a + id="x1-12001r11"></a> <!--l. 816--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-12-1g"><col +id="TBL-12-1"><col +id="TBL-12-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-12-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-1-1" +class="td11"> <span +class="ec-lmri-10">Macro </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-1-2" +class="td11"> + <!--l. 816--><p class="noindent" ><span +class="ec-lmri-10">Default</span> </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="td11"> <span +class="ec-lmtt-10">\figurename </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-2-2" +class="td11"> + <!--l. 817--><p class="noindent" >Figure </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="td11"> <span +class="ec-lmtt-10">\tablename </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-3-2" +class="td11"> + <!--l. 818--><p class="noindent" >Table </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="td11"> <span +class="ec-lmtt-10">\partname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-4-2" +class="td11"> + <!--l. 819--><p class="noindent" >Part </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="td11"> <span +class="ec-lmtt-10">\appendixname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-5-2" +class="td11"> + <!--l. 820--><p class="noindent" >Appendix </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="td11"> <span +class="ec-lmtt-10">\equationname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-6-2" +class="td11"> + <!--l. 821--><p class="noindent" >Equation </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="td11"> <span +class="ec-lmtt-10">\Itemname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-7-2" +class="td11"> + <!--l. 822--><p class="noindent" >item </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="td11"> <span +class="ec-lmtt-10">\chaptername </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-8-2" +class="td11"> + <!--l. 823--><p class="noindent" >chapter </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="td11"> <span +class="ec-lmtt-10">\sectionname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-9-2" +class="td11"> + <!--l. 824--><p class="noindent" >section </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="td11"> <span +class="ec-lmtt-10">\subsectionname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-10-2" +class="td11"> + <!--l. 825--><p class="noindent" >subsection </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="td11"> <span +class="ec-lmtt-10">\subsubsectionname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-11-2" +class="td11"> + <!--l. 826--><p class="noindent" >subsubsection </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="td11"> <span +class="ec-lmtt-10">\paragraphname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-12-2" +class="td11"> + <!--l. 827--><p class="noindent" >paragraph </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="td11"> <span +class="ec-lmtt-10">\Hfootnotename </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-13-2" +class="td11"> + <!--l. 828--><p class="noindent" >footnote </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="td11"> <span +class="ec-lmtt-10">\AMSname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-14-2" +class="td11"> + <!--l. 829--><p class="noindent" >Equation </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="td11"> <span +class="ec-lmtt-10">\theoremname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-15-2" +class="td11"> + <!--l. 830--><p class="noindent" >Theorem </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="td11"> <span +class="ec-lmtt-10">\page </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-16-2" +class="td11"> + <!--l. 831--><p class="noindent" >page </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-17-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-18-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-19-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-20-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-12-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-21-1" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-21-2" +class="td11"></td></tr> + </table></div> +<!--l. 834--><p class="indent" > Example for a redefinition if <span +class="ec-lmss-10">babel </span>is used: + <div class="quote"> + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\usepackage[ngerman]{babel} + <br />\addto\extrasngerman{% + <br />  \def\subsectionautorefname{Unterkapitel}% + <br />} +</div> + </td></tr></table> + <!--l. 841--><p class="nopar" ></div> +<!--l. 844--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\autopageref{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 848--><p class="noindent" >It replaces <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\pageref</span></span></span> and adds the name for page in front of the page reference. First <span +class="ec-lmtt-10">\pageautorefname</span> +is checked before <span +class="ec-lmtt-10">\pagename</span>. +<!--l. 853--><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: +<!--l. 856--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\ref*{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 860--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\pageref*{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 864--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\autoref*{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 868--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\autopageref*{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 872--><p class="indent" > A typical use would be to write + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\hyperref[other]{that nice section (\ref*{other}) we read before} +</div> +</td></tr></table> +<!--l. 875--><p class="nopar" > +<!--l. 877--><p class="indent" > We want <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-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-lmtt-10">\hyperref</span>. +<!--l. 880--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\pdfstringdef{</span><span +class="ec-lmri-10">macroname</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">TEXstring</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 884--><p class="indent" > <span +class="ec-lmtt-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">Switching to PD1 or PU encoding + </li> + <li class="itemize">Defining the “octal sequence commands” (<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\345</span></span></span>): <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\edef\3{\string\3}</span></span></span> + </li> + <li class="itemize">Special glyphs of <span class="TEX">T<span +class="E">E</span>X</span>: <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\{</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\%</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\&</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\space</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\dots</span></span></span>, etc. + </li> + <li class="itemize">National glyphs (<span +class="ec-lmss-10">german.sty</span>, <span +class="ec-lmss-10">french.sty</span>, etc.) + </li> + <li class="itemize">Logos: <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\TeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\eTeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\MF</span></span></span>, etc. + </li> + <li class="itemize">Disabling commands that do not provide useful functionality in bookmarks: <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\label</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\index</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\glossary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\discretionary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\def</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\let</span></span></span>, etc. + </li> + <li class="itemize"><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>’s font commands like <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\textbf</span></span></span>, etc. + </li> + <li class="itemize">Support for <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\xspace</span></span></span> provided by the <span +class="ec-lmss-10">xspace </span>package</li></ul> +<!--l. 900--><p class="indent" > In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in +the PDF string. For further details, see Heiko Oberdiek’s Euro<span class="TEX">T<span +class="E">E</span>X</span> paper distributed with +<span +class="ec-lmss-10">hyperref</span>. +<!--l. 905--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-130004.1"></a>Replacement macros</h4> +<!--l. 907--><p class="noindent" ><span +class="ec-lmss-10">hyperref </span>takes the text for bookmarks from the arguments of commands like <span +class="ec-lmtt-10">\section</span>, which can +contain things like math, colors, or font changes, none of which will display in bookmarks as +is. + + +<!--l. 911--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\texorpdfstring{</span><span +class="ec-lmri-10">TEXstring</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">PDFstring</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 915--><p class="indent" > For example, + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\section{Pythagoras: + <br />  \texorpdfstring{$ a^2 + b^2 = c^2 $}{% + <br />    a\texttwosuperior\ + b\texttwosuperior\ = + <br />    c\texttwosuperior + <br />  }% + <br />} + <br />\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars} +</div> +</td></tr></table> +<!--l. 924--><p class="nopar" > +<!--l. 926--><p class="indent" > <span +class="ec-lmtt-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. + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\expandafter\def\expandafter\pdfstringdefPreHook + <br />\expandafter{% + <br />  \pdfstringdefPreHook + <br />  \renewcommand{\mycommand}[1]{}% + <br />} +</div> +</td></tr></table> +<!--l. 936--><p class="nopar" > +<!--l. 938--><p class="indent" > However, for disabling commands, an easier way is via <span +class="ec-lmtt-10">\pdfstringdefDisableCommands</span>, which adds +its argument to the definition of <span +class="ec-lmtt-10">\pdfstringdefPreHook </span>(‘@’ can here be used as letter in command +names): + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\pdfstringdefDisableCommands{% + <br />  \let~\textasciitilde + <br />  \def\url{\pdfstringdefwarn\url}% + <br />  \let\textcolor\@gobble + <br />} +</div> +</td></tr></table> +<!--l. 949--><p class="nopar" > +<!--l. 951--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a + id="x1-140004.2"></a>Utility macros</h4> +<!--l. 954--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\hypercalcbp{</span><span +class="ec-lmri-10">dimen specification</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 957--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hypercalcbp</span></span></span> takes a <span class="TEX">T<span +class="E">E</span>X</span> dimen specification and converts it to bp and returns the number without +the unit. This is useful for options <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">pdfstartview</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">pdfview</span></span></span>. Example: + <div class="quote"> + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\hypersetup{ + <br />  pdfstartview={FitBH \hypercalcbp{\paperheight-\topmargin-1in + <br />    -\headheight-\headsep} + <br />} +</div> + </td></tr></table> + <!--l. 968--><p class="nopar" ></div> +<!--l. 970--><p class="noindent" >The origin of the PDF coordinate system is the lower left corner. +<!--l. 972--><p class="indent" > Note, for calculations you need either package |calc| or <span +class="lmmi-10">"</span>-<span class="TEX">T<span +class="E">E</span>X</span>. Nowadays the latter should +automatically be enabled for <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> formats. Users without <span +class="lmmi-10">"</span>-<span class="TEX">T<span +class="E">E</span>X</span>, please, look in the source +documentation <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">hyperref.dtx</span></span></span> for further limitations. +<!--l. 978--><p class="indent" > Also <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hypercalcbp</span></span></span> cannot be used in option specifications of <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\documentclass</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\usepackage</span></span></span>, +because <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> expands the option lists of these commands. However package <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">hyperref</span></span></span> is not yet +loaded and an undefined control sequence error would arise. +<!--l. 984--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">5 </span> <a + id="x1-150005"></a>Acrobat-specific behavior</h3> +<!--l. 985--><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. 988--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\Acrobatmenu{</span><span +class="ec-lmri-10">menuoption</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 992--><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. 995--><p class="noindent" > +<a + id="x1-15001r12"></a> <!--l. 996--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-13-1g"><col +id="TBL-13-1"><col +id="TBL-13-2"></colgroup> +<tr + style="vertical-align:baseline;" id="TBL-13-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-1-1" +class="td11"> File </td><td style="white-space:wrap; text-align:left;" id="TBL-13-1-2" +class="td11"> + <!--l. 996--><p class="noindent" >Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, + Print, PageSetup, Quit </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="td11"> File<span +class="lmsy-10">!</span>Import </td><td style="white-space:wrap; text-align:left;" id="TBL-13-2-2" +class="td11"> + <!--l. 997--><p class="noindent" >ImportImage, ImportNotes, AcroForm:ImportFDF </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="td11"> File<span +class="lmsy-10">!</span>Export </td><td style="white-space:wrap; text-align:left;" id="TBL-13-3-2" +class="td11"> + <!--l. 998--><p class="noindent" >ExportNotes, AcroForm:ExportFDF </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="td11"> File<span +class="lmsy-10">!</span>DocumentInfo </td><td style="white-space:wrap; text-align:left;" id="TBL-13-4-2" +class="td11"> + <!--l. 999--><p class="noindent" >GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, + Weblink:Base, AutoIndex:DocInfo </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="td11"> File<span +class="lmsy-10">!</span>Preferences </td><td style="white-space:wrap; text-align:left;" id="TBL-13-5-2" +class="td11"> + <!--l. 1000--><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-13-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-6-1" +class="td11"> Edit </td><td style="white-space:wrap; text-align:left;" id="TBL-13-6-2" +class="td11"> + <!--l. 1002--><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-13-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-7-1" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-13-7-2" +class="td11"> + <!--l. 1005--><p class="noindent" >Properties </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="td11"> Edit<span +class="lmsy-10">!</span>Fields </td><td style="white-space:wrap; text-align:left;" id="TBL-13-8-2" +class="td11"> + <!--l. 1006--><p class="noindent" >AcroForm:Duplicate, AcroForm:TabOrder </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="td11"> Document </td><td style="white-space:wrap; text-align:left;" id="TBL-13-9-2" +class="td11"> + <!--l. 1007--><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-13-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-10-1" +class="td11"> View </td><td style="white-space:wrap; text-align:left;" id="TBL-13-10-2" +class="td11"> + <!--l. 1010--><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-13-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-11-1" +class="td11"> Tools </td><td style="white-space:wrap; text-align:left;" id="TBL-13-11-2" +class="td11"> + <!--l. 1013--><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-13-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-12-1" +class="td11"> Tools<span +class="lmsy-10">!</span>Search </td><td style="white-space:wrap; text-align:left;" id="TBL-13-12-2" +class="td11"> + <!--l. 1016--><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-13-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-13-13-1" +class="td11"> Window </td><td style="white-space:wrap; text-align:left;" id="TBL-13-13-2" +class="td11"> + <!--l. 1018--><p class="noindent" >ShowHideToolBar, ShowHideMenuBar, + ShowHideClipboard, Cascade, TileHorizontal, TileVertical, + CloseAll </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="td11"> Help </td><td style="white-space:wrap; text-align:left;" id="TBL-13-14-2" +class="td11"> + <!--l. 1020--><p class="noindent" >HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, + HelpCapture, HelpPDFWriter, HelpDistiller, HelpSearch, + HelpCatalog, HelpReader, Weblink:Home </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="td11"> Help(Windows) </td><td style="white-space:wrap; text-align:left;" id="TBL-13-15-2" +class="td11"> + <!--l. 1022--><p class="noindent" >About </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="td11"> </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="td11"> </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="td11"> </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="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-13-19-2" +class="td11"></td></tr> + </table></div> +<!--l. 1025--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-160006"></a>PDF and HTML forms</h3> +<!--l. 1026--><p class="noindent" >You must put your fields inside a <span +class="ec-lmtt-10">Form </span>environment (only one per file). +<!--l. 1028--><p class="indent" > There are six macros to prepare fields: + + +<!--l. 1030--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\TextField[</span><span +class="ec-lmri-10">parameters</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1034--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\CheckBox[</span><span +class="ec-lmri-10">parameters</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1038--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\ChoiceMenu[</span><span +class="ec-lmri-10">parameters</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">choices</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1042--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\PushButton[</span><span +class="ec-lmri-10">parameters</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1046--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\Submit[</span><span +class="ec-lmri-10">parameters</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1050--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\Reset[</span><span +class="ec-lmri-10">parameters</span><span +class="ec-lmtt-10">]{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1054--><p class="indent" > The way forms and their labels are laid out is determined by: +<!--l. 1055--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\LayoutTextField{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">field</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1059--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\LayoutChoiceField{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">field</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1063--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\LayoutCheckField{</span><span +class="ec-lmri-10">label</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">field</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1067--><p class="indent" > These macros default to #1 #2 +<!--l. 1069--><p class="indent" > What is actually shown in as the field is determined by: +<!--l. 1070--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\MakeRadioField{</span><span +class="ec-lmri-10">width</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">height</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1074--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\MakeCheckField{</span><span +class="ec-lmri-10">width</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">height</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1077--><p class="noindent" > + + +<span class="fbox"> <span +class="ec-lmtt-10">\MakeTextField{</span><span +class="ec-lmri-10">width</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">height</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1080--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\MakeChoiceField{</span><span +class="ec-lmri-10">width</span><span +class="ec-lmtt-10">}{</span><span +class="ec-lmri-10">height</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1084--><p class="noindent" > +<span class="fbox"> <span +class="ec-lmtt-10">\MakeButtonField{</span><span +class="ec-lmri-10">text</span><span +class="ec-lmtt-10">}</span> </span> +<!--l. 1088--><p class="indent" > These macros default to <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\vbox</span><span +class="ec-lmtt-10"> to</span><span +class="ec-lmtt-10"> #2{\hbox</span><span +class="ec-lmtt-10"> to</span><span +class="ec-lmtt-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-lmtt-10">\Submit </span>and <span +class="ec-lmtt-10">\Reset </span>macros. +<!--l. 1092--><p class="indent" > You may also want to redefine the following macros: + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\def\DefaultHeightofSubmit{12pt} + <br />\def\DefaultWidthofSubmit{2cm} + <br />\def\DefaultHeightofReset{12pt} + <br />\def\DefaultWidthofReset{2cm} + <br />\def\DefaultHeightofCheckBox{0.8\baselineskip} + <br />\def\DefaultWidthofCheckBox{0.8\baselineskip} + <br />\def\DefaultHeightofChoiceMenu{0.8\baselineskip} + <br />\def\DefaultWidthofChoiceMenu{0.8\baselineskip} + <br />\def\DefaultHeightofText{\baselineskip} + <br />\def\DefaultHeightofTextMultiline{4\baselineskip} + <br />\def\DefaultWidthofText{3cm} +</div> +</td></tr></table> +<!--l. 1105--><p class="nopar" > +<!--l. 1107--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a + id="x1-170006.1"></a>Forms environment parameters</h4> +<!--l. 1109--><p class="noindent" > +<a + id="x1-17001r13"></a> <!--l. 1110--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-14-1g"><col +id="TBL-14-1"><col +id="TBL-14-2"><col +id="TBL-14-3"></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-lmtt-10">action </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-14-1-2" +class="td11"> <span +class="ec-lmri-10">URL </span></td><td style="white-space:wrap; text-align:left;" id="TBL-14-1-3" +class="td11"> + <!--l. 1110--><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-14-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-2-1" +class="td11"> <span +class="ec-lmtt-10">encoding </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-14-2-2" +class="td11"> <span +class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-14-2-3" +class="td11"> + <!--l. 1111--><p class="noindent" >The encoding for the string set to the URL; FDF-encoding + is usual, and <span +class="ec-lmtt-10">html </span>is the only valid value </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-14-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-3-1" +class="td11"> <span +class="ec-lmtt-10">method </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-14-3-2" +class="td11"> <span +class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-14-3-3" +class="td11"> + <!--l. 1113--><p class="noindent" >Used only when generating HTML; values can be <span +class="ec-lmtt-10">post </span>or + <span +class="ec-lmtt-10">get</span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-14-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-4-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-14-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-5-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-14-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-6-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-14-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-7-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-14-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-14-8-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-14-8-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-14-8-3" +class="td11"></td></tr> + </table></div> +<!--l. 1116--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a + id="x1-180006.2"></a>Forms optional parameters</h4> +<!--l. 1117--><p class="noindent" >Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. <span +class="ec-lmtt-10">color=0 0</span> +<span +class="ec-lmtt-10">0.5</span>) +<!--l. 1120--><p class="noindent" > +<a + id="x1-18001r14"></a> <!--l. 1121--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-15-1g"><col +id="TBL-15-1"><col +id="TBL-15-2"><col +id="TBL-15-3"><col +id="TBL-15-4"></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-lmtt-10">accesskey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-1-2" +class="td11"> key </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-1-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-1-4" +class="td11"> (as per HTML) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-2-1" +class="td11"> <span +class="ec-lmtt-10">align </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-2-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-2-3" +class="td11"> <span +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-2-4" +class="td11"> alignment within text field; 0 is left-aligned, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-3-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-3-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-3-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-3-4" +class="td11"> 1 is centered, 2 is right-aligned. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-4-1" +class="td11"> <span +class="ec-lmtt-10">backgroundcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-4-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-4-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-4-4" +class="td11"> color of box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-5-1" +class="td11"> <span +class="ec-lmtt-10">bordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-5-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-5-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-5-4" +class="td11"> color of border </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-6-1" +class="td11"> <span +class="ec-lmtt-10">bordersep </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-6-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-6-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-6-4" +class="td11"> box border gap </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-7-1" +class="td11"> <span +class="ec-lmtt-10">borderwidth </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-7-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-7-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-7-4" +class="td11"> width of box border </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-8-1" +class="td11"> <span +class="ec-lmtt-10">calculate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-8-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-8-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-8-4" +class="td11"> JavaScript code to calculate the value of the field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-9-1" +class="td11"> <span +class="ec-lmtt-10">charsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-9-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-9-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-9-4" +class="td11"> font size of field text </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-10-1" +class="td11"> <span +class="ec-lmtt-10">checked </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-10-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-10-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-10-4" +class="td11"> whether option selected by default </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-11-1" +class="td11"> <span +class="ec-lmtt-10">color </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-11-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-11-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-11-4" +class="td11"> color of text in box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-12-1" +class="td11"> <span +class="ec-lmtt-10">combo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-12-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-12-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-12-4" +class="td11"> choice list is ‘combo’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-13-1" +class="td11"> <span +class="ec-lmtt-10">default </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-13-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-13-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-13-4" +class="td11"> default value </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-14-1" +class="td11"> <span +class="ec-lmtt-10">disabled </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-14-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-14-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-14-4" +class="td11"> field disabled </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-15-1" +class="td11"> <span +class="ec-lmtt-10">format </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-15-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-15-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-15-4" +class="td11"> JavaScript code to format the field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-16-1" +class="td11"> <span +class="ec-lmtt-10">height </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-16-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-16-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-16-4" +class="td11"> height of field box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-17-1" +class="td11"> <span +class="ec-lmtt-10">hidden </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-17-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-17-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-17-4" +class="td11"> field hidden </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-18-1" +class="td11"> <span +class="ec-lmtt-10">ketstroke </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-18-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-18-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-18-4" +class="td11"> JavaScript code to control the keystrokes on entry </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-19-1" +class="td11"> <span +class="ec-lmtt-10">maxlen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-19-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-19-3" +class="td11"> <span +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-19-4" +class="td11"> number of characters allowed in text field </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-20-1" +class="td11"> <span +class="ec-lmtt-10">menulength </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-20-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-20-3" +class="td11"> <span +class="ec-lmri-10">4 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-20-4" +class="td11"> number of elements shown in list </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-21-1" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-21-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-21-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-21-4" +class="td11"></td></tr> +<tr + style="vertical-align:baseline;" id="TBL-15-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-22-1" +class="td11"> <span +class="ec-lmtt-10">multiline </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-22-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-22-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-22-4" +class="td11"> whether text box is multiline </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-23-1" +class="td11"> <span +class="ec-lmtt-10">name </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-23-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-23-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-23-4" +class="td11"> name of field (defaults to label) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-24-1" +class="td11"> <span +class="ec-lmtt-10">onblur </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-24-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-24-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-24-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-25-1" +class="td11"> <span +class="ec-lmtt-10">onchange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-25-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-25-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-25-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-26-1" +class="td11"> <span +class="ec-lmtt-10">onclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-26-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-26-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-26-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-27-1" +class="td11"> <span +class="ec-lmtt-10">ondblclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-27-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-27-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-27-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-28-1" +class="td11"> <span +class="ec-lmtt-10">onfocus </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-28-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-28-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-28-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-29-1" +class="td11"> <span +class="ec-lmtt-10">onkeydown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-29-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-29-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-29-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-30-1" +class="td11"> <span +class="ec-lmtt-10">onkeypress </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-30-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-30-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-30-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-31-1" +class="td11"> <span +class="ec-lmtt-10">onkeyup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-31-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-31-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-31-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-32-1" +class="td11"> <span +class="ec-lmtt-10">onmousedown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-32-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-32-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-32-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-33-1" +class="td11"> <span +class="ec-lmtt-10">onmousemove </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-33-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-33-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-33-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-34-1" +class="td11"> <span +class="ec-lmtt-10">onmouseout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-34-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-34-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-34-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-35-1" +class="td11"> <span +class="ec-lmtt-10">onmouseover </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-35-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-35-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-35-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-36-1" +class="td11"> <span +class="ec-lmtt-10">onmouseup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-36-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-36-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-36-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-37-1" +class="td11"> <span +class="ec-lmtt-10">onselect </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-37-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-37-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-37-4" +class="td11"> JavaScript code </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-38-1" +class="td11"> <span +class="ec-lmtt-10">password </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-38-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-38-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-38-4" +class="td11"> text field is ‘password’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-39-1" +class="td11"> <span +class="ec-lmtt-10">popdown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-39-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-39-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-39-4" +class="td11"> choice list is ‘popdown’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-40-1" +class="td11"> <span +class="ec-lmtt-10">radio </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-40-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-40-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-40-4" +class="td11"> choice list is ‘radio’ style </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-41-1" +class="td11"> <span +class="ec-lmtt-10">readonly </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-41-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-41-3" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-41-4" +class="td11"> field is readonly </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-42-1" +class="td11"> </td> + </tr> +<tr + style="vertical-align:baseline;" id="TBL-15-43-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-43-1" +class="td11"> <span +class="ec-lmtt-10">rotation </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-43-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-43-3" +class="td11"> <span +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-43-4" +class="td11"> rotation of the widget annotation (degree, counterclockwise, multiple of 90) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-44-1" +class="td11"> <span +class="ec-lmtt-10">tabkey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-44-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-44-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-44-4" +class="td11"> (as per HTML) </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-45-1" +class="td11"> <span +class="ec-lmtt-10">validate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-45-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-45-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-45-4" +class="td11"> JavaScript code to validate the entry </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-46-1" +class="td11"> <span +class="ec-lmtt-10">value </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-46-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-46-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-46-4" +class="td11"> initial value </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-47-1" +class="td11"> <span +class="ec-lmtt-10">width </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-15-47-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-47-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-15-47-4" +class="td11"> width of field box </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-48-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-49-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-50-1" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-15-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-15-51-1" +class="td11"> </td> + </tr> + + + </table></div> +<!--l. 1169--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-190007"></a>Defining a new driver</h3> +<!--l. 1170--><p class="noindent" >A hyperref driver has to provide definitions for eight macros: +<!--l. 1173--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@anchor</span></span></span> +<!--l. 1175--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@link</span></span></span> +<!--l. 1177--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@linkfile</span></span></span> +<!--l. 1179--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@linkurl</span></span></span> +<!--l. 1181--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@anchorstart</span></span></span> +<!--l. 1183--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@anchorend</span></span></span> +<!--l. 1185--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@linkstart</span></span></span> +<!--l. 1187--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\hyper@linkend</span></span></span> +<!--l. 1190--><p class="indent" > The draft option defines the macros as follows + + + <table +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\let\hyper@@anchor\@gobble + <br />\gdef\hyper@link##1##2##3{##3}% + <br />\def\hyper@linkurl##1##2{##1}% + <br />\def\hyper@linkfile##1##2##3{##1}% + <br />\let\hyper@anchorstart\@gobble + <br />\let\hyper@anchorend\@empty + <br />\let\hyper@linkstart\@gobbletwo + <br />\let\hyper@linkend\@empty +</div> +</td></tr></table> +<!--l. 1200--><p class="nopar" > +<!--l. 1202--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-200008"></a>Special support for other packages</h3> +<!--l. 1204--><p class="noindent" ><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">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">Packages that typeset the contents of the <span +class="ec-lmtt-10">\label </span>and <span +class="ec-lmtt-10">\ref </span>macros, such as <span +class="ec-lmss-10">showkeys</span>. Since + the <span +class="ec-lmss-10">hyperref </span>package redefines these commands, you must set <span +class="ec-lmtt-10">implicit=false </span>for these + packages to work. + </li> + <li class="itemize">Packages that do anything serious with the index.</li></ul> +<!--l. 1224--><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="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>’s normal +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\label/\ref</span></span></span> mechanisms and per-chapter tables of contents, respectively. +<!--l. 1230--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-210009"></a>History and acknowledgments</h3> +<!--l. 1232--><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 (<span +class="ec-lmtt-10">tanmoy@qcd.lanl.gov</span>) and Thorsten Ohl +(<span +class="ec-lmtt-10">thorsten.ohl@physik.th-darmstadt.de</span>). <span +class="ec-lmss-10">hyperref </span>started as a simple port of their work to +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>2<span +class="lmmi-10">"</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="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="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. 1246--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has made the +package more robust. The days spent on Rev<span class="TEX">T<span +class="E">E</span>X</span> are entirely due to him! The investigations of Bill +Moss (<span +class="ec-lmtt-10">bmoss@math.clemson.edu</span>) into the later versions including native PDF support uncovered a good +many bugs, and his testing is appreciated. Hans Hagen (<span +class="ec-lmtt-10">pragma@pi.net</span>) provided a lot of insight into +PDF. +<!--l. 1254--><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. 1263--><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. 1269--><p class="indent" > Steve Dandy recreated the manual source in July 2003 after it had been lost. +<!--l. 1272--><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">10 </span> <a + id="x1-2200010"></a>GNU Free Documentation License</h3> +<!--l. 6--><p class="noindent" >Version 1.2, November 2002 +<br class="newline" /> +<!--l. 9--><p class="indent" > Copyright <span +class="lmsy-10">©</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. 15--><p class="noindent" > + <h4 class="likesubsectionHead"><a + id="x1-2300010"></a>Preamble</h4> +<!--l. 17--><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. 25--><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. 30--><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. 39--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a + id="x1-2400010.1"></a>Applicability and definitions</h4> +<!--l. 42--><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. 52--><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. 56--><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. 67--><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. 75--><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. 80--><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. 93--><p class="indent" > Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo +input format, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> input format, SGML or XML using a publicly available DTD, and +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. 104--><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. 111--><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. 119--><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. 127--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a + id="x1-2500010.2"></a>Verbatim copying</h4> +<!--l. 130--><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-2600010.3">10.3<!--tex4ht:ref: copying --></a>. +<!--l. 141--><p class="indent" > You may also lend copies, under the same conditions stated above, and you may publicly display +copies. + + +<!--l. 145--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a + id="x1-2600010.3"></a>Copying in quantity</h4> +<!--l. 148--><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. 161--><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. 166--><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. 179--><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. 184--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.4 </span> <a + id="x1-2700010.4"></a>Modifications</h4> +<!--l. 187--><p class="noindent" >You may copy and distribute a Modified Version of the Document under the conditions of sections <a +href="#x1-2500010.2">10.2<!--tex4ht:ref: verbatim --></a> +and <a +href="#x1-2600010.3">10.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. 196--><p class="indent" > + <ol class="enumerate1" > + <li + class="enumerate" id="x1-27002x1">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-27004x2">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-27006x3">State on the Title page the name of the publisher of the Modified Version, as the publisher. + + </li> + <li + class="enumerate" id="x1-27008x4">Preserve all the copyright notices of the Document. + </li> + <li + class="enumerate" id="x1-27010x5">Add an appropriate copyright notice for your modifications adjacent to the other copyright + notices. + </li> + <li + class="enumerate" id="x1-27012x6">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-27014x7">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-27016x8">Include an unaltered copy of this License. + </li> + <li + class="enumerate" id="x1-27018x9">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-27020x10">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-27022x11">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-27024x12">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-27026x13">Delete any section Entitled “Endorsements”. Such a section may not be included in the + Modified Version. + </li> + <li + class="enumerate" id="x1-27028x14">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-27030x15">Preserve any Warranty Disclaimers. + </li></ol> + + +<!--l. 247--><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. 254--><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. 260--><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. 270--><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. 275--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.5 </span> <a + id="x1-2800010.5"></a>Combining documents</h4> +<!--l. 278--><p class="noindent" >You may combine the Document with other documents released under this License, under the terms +defined in section <a +href="#x1-2700010.4">10.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. 286--><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. 295--><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. 302--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.6 </span> <a + id="x1-2900010.6"></a>Collections of documents</h4> +<!--l. 305--><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. 311--><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. 317--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.7 </span> <a + id="x1-3000010.7"></a>Aggregation with independent works</h4> + +<!--l. 320--><p class="noindent" >A compilation of the Document or its derivatives with other separate and independent documents or +works, in or on a volume of a storage or distribution medium, is called an “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. 329--><p class="indent" > If the Cover Text requirement of section <a +href="#x1-2600010.3">10.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. 338--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.8 </span> <a + id="x1-3100010.8"></a>Translation</h4> +<!--l. 341--><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-2700010.4">10.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. 355--><p class="indent" > If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the +requirement (section <a +href="#x1-2700010.4">10.4<!--tex4ht:ref: modifications --></a>) to Preserve its Title (section <a +href="#x1-2400010.1">10.1<!--tex4ht:ref: applicability --></a>) will typically require changing the actual +title. +<!--l. 362--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.9 </span> <a + id="x1-3200010.9"></a>Termination</h4> +<!--l. 365--><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. 374--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.10 </span> <a + id="x1-3300010.10"></a>Future revisions of this license</h4> +<!--l. 377--><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. 383--><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. 393--><p class="noindent" > + <h4 class="likesubsectionHead"><a + id="x1-3400010.10"></a>Addendum: how to use this license for your documents</h4> +<!--l. 395--><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. 399--><p class="indent" > + <div class="quote"> + <!--l. 400--><p class="noindent" >Copyright <span +class="lmsy-10">©</span> YEAR YOUR NAME. Permission is granted to copy, distribute and/or + 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”.</div> +<!--l. 409--><p class="indent" > If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” +line with this: +<!--l. 412--><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. 415--><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. 419--><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> + + + + |