diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref/manual.html')
| -rw-r--r-- | Master/texmf-dist/doc/latex/hyperref/manual.html | 4109 |
1 files changed, 4109 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..afaaa8fa142 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual.html @@ -0,0 +1,4109 @@ +<!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.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<!-- html --> +<meta name="src" content="manual.tex"> +<meta name="date" content="2004-02-12 15:16: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="ecrm-1200">Sebastian Rahtz </span><br class="and"><span +class="ecrm-1200">Heiko Oberdiek</span></div> +<br> +<div class="date" ><span +class="ecrm-1200">February 2004</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="sectionToc">5 <a +href="#x1-140005" id="QQ2-1-14">Acrobat-specific behavior</a></span> +<br> <span class="sectionToc">6 <a +href="#x1-150006" id="QQ2-1-15">PDF and HTML forms</a></span> +<br> <span class="subsectionToc">6.1 <a +href="#x1-160006.1" id="QQ2-1-16">Forms environment parameters</a></span> +<br> <span class="subsectionToc">6.2 <a +href="#x1-170006.2" id="QQ2-1-17">Forms optional parameters</a></span> +<br> <span class="sectionToc">7 <a +href="#x1-180007" id="QQ2-1-18">Defining a new driver</a></span> +<br> <span class="sectionToc">8 <a +href="#x1-190008" id="QQ2-1-19">Special support for other packages</a></span> +<br> <span class="sectionToc">9 <a +href="#x1-200009" id="QQ2-1-20">History and acknowledgments</a></span> +<br> <span class="sectionToc">10 <a +href="#x1-2100010" id="QQ2-1-21">GNU Free Documentation License</a></span> +<br> <span class="subsectionToc">10.1 <a +href="#x1-2300010.1" id="QQ2-1-23">Applicability and definitions</a></span> +<br> <span class="subsectionToc">10.2 <a +href="#x1-2400010.2" id="QQ2-1-24">Verbatim copying</a></span> +<br> <span class="subsectionToc">10.3 <a +href="#x1-2500010.3" id="QQ2-1-25">Copying in quantity</a></span> +<br> <span class="subsectionToc">10.4 <a +href="#x1-2600010.4" id="QQ2-1-26">Modifications</a></span> +<br> <span class="subsectionToc">10.5 <a +href="#x1-2700010.5" id="QQ2-1-27">Combining documents</a></span> +<br> <span class="subsectionToc">10.6 <a +href="#x1-2800010.6" id="QQ2-1-28">Collections of documents</a></span> +<br> <span class="subsectionToc">10.7 <a +href="#x1-2900010.7" id="QQ2-1-29">Aggregation with independent works</a></span> +<br> <span class="subsectionToc">10.8 <a +href="#x1-3000010.8" id="QQ2-1-30">Translation</a></span> +<br> <span class="subsectionToc">10.9 <a +href="#x1-3100010.9" id="QQ2-1-31">Termination</a></span> +<br> <span class="subsectionToc">10.10 <a +href="#x1-3200010.10" id="QQ2-1-32">Future revisions of this license</a></span> + + + </div> +<!--l. 123--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">1 </span> <a + id="x1-20001"></a>Introduction</h3> +<!--l. 125--><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 +<a +href="http://xxx.lanl.gov/hypertex/" class="url" ><span +class="ectt-1000">http://xxx.lanl.gov/hypertex/</span></a>. 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="ectt-1000">\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="ecti-1000">ad hoc</span> +hypertext links, including those to external documents and URLs. +<!--l. 133--><p class="indent"> This manual provides a brief overview of the <span +class="ecss-1000">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="ectt-1000">hyperref.dtx</span>. You should also read the chapter on <span +class="ecss-1000">hyperref </span>in <span +class="ecti-1000">The </span><span class="LATEX"><span +class="ecti-1000">L</span><span class="A"><span +class="ecti-1000">A</span></span><span class="TEX"><span +class="ecti-1000">T</span><span +class="E"><span +class="ecti-1000">E</span></span><span +class="ecti-1000">X</span></span></span><span +class="ecti-1000"> Web Companion</span>, +where you will find additional examples. +<!--l. 140--><p class="indent"> The Hyper<span class="TEX">T<span +class="E">E</span>X</span> specification<a +href="manual2.html" id="manual2.html" ><sup>1</sup></a> +says that conformant viewers/translators must recognize the following set of <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> constructs: + <dl class="description"><dt class="description"> +<span +class="ecbx-1000">href:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<a</span><span +class="ectt-1000"> href</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "href_string"></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">name:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<a</span><span +class="ectt-1000"> name</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "name_string"></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">end:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:</a></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">image:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<img</span><span +class="ectt-1000"> src</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "href_string"></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">base_name:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<base</span><span +class="ectt-1000"> href</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "href_string"></span></span></span></dd></dl> +<!--l. 152--><p class="indent"> The <span +class="ecti-1000">href</span>, <span +class="ecti-1000">name </span>and <span +class="ecti-1000">end </span>commands are used to do the basic hypertext operations of establishing links +between sections of documents. The <span +class="ecti-1000">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="ecti-1000">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. 161--><p class="indent"> The <span +class="ecti-1000">href </span>and <span +class="ecti-1000">name </span>commands must be paired with an <span +class="ecti-1000">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="ecti-1000">anchor </span>in the document. In the case of an <span +class="ecti-1000">href</span> +command, the <span +class="ecti-1000">anchor </span>is to be highlighted in the <span +class="ecti-1000">DVI viewer</span>, and when clicked on will cause the scene to +shift to the destination specified by <span +class="ecti-1000">href_string</span>. The <span +class="ecti-1000">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="ectt-1000">href="#name_string"</span></span></span> with the <span +class="ecti-1000">name_string </span>identical to the one in the name +command) or as part of a URL (of the form <span +class="ecti-1000">URL#name_string</span>). Here <span +class="ecti-1000">href_string </span>is a valid URL +or local identifier, while <span +class="ecti-1000">name_string </span>could be any string at all: the only caveat is that ‘<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">"</span></span></span>’ +characters should be escaped with a backslash (<span +class="cmsy-10">\</span>), and if it looks like a URL name it may cause +problems. +<!--l. 177--><p class="indent"> However, the drivers intended to produce <span +class="ecti-1000">only </span>PDF use literal PostScript or PDF <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ecbx-1000">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="ecss-1000">xdvi</span>, <span +class="ecss-1000">dvips </span>(with the <span +class="ecss-1000">-z</span> + option), <span +class="ecss-1000">OzTeX</span>, and <span +class="ecss-1000">Textures</span>) + </dd><dt class="description"> +<span +class="ecbx-1000">dvips</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands tailored for <span +class="ecss-1000">dvips</span> + </dd><dt class="description"> +<span +class="ecbx-1000">dvipsone</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands tailored for <span +class="ecss-1000">dvipsone</span> + </dd><dt class="description"> +<span +class="ecbx-1000">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="ecss-1000">dvips</span>, but a few variations remained before + version 5.21 + </dd><dt class="description"> +<span +class="ecbx-1000">tex4ht</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands for use with <span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span><span +class="ecss-1000">4ht</span> + </dd><dt class="description"> +<span +class="ecbx-1000">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="ecbx-1000">dvipdf</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands for the DVI to PDF driver <span +class="ecss-1000">dvipdf</span> + </dd><dt class="description"> +<span +class="ecbx-1000">dvipdfm</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands for Mark Wicks’ DVI to PDF driver <span +class="ecss-1000">dvipdfm</span> + </dd><dt class="description"> +<span +class="ecbx-1000">dviwindo</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands that Y&Y’s Windows previewer interprets as hypertext + jumps within the previewer + </dd><dt class="description"> +<span +class="ecbx-1000">vtex</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ecbx-1000">textures</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands that <span +class="ecss-1000">Textures </span>interprets as hypertext jumps within the + previewer</dd></dl> +<!--l. 200--><p class="indent"> Output from <span +class="ecss-1000">dvips </span>or <span +class="ecss-1000">dvipsone </span>must be processed using Acrobat Distiller to obtain a PDF +file.<a +href="manual3.html" id="manual3.html" ><sup>2</sup></a> +The result is generally preferable to that produced by using the <span +class="ecss-1000">hypertex </span>driver, and then +processing with <span +class="ecss-1000">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="ectt-1000">\special </span>commands is that you can also use the document in hypertext DVI viewers, such +as <span +class="ecss-1000">xdvi</span>. + <h3 class="sectionHead"><span class="titlemark">2 </span> <a + id="x1-30002"></a>Implicit behavior</h3> +<!--l. 212--><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 width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\usepackage{hyperref} +</div> +</td></tr></table> +<!--l. 217--><p class="nopar"> +<!--l. 219--><p class="indent"> Make sure it comes <span +class="ecti-1000">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="ectt-1000">\section </span>commands will produce a bookmark and a +link, whereas <span +class="ectt-1000">\section* </span>commands will only show links when paired with a corresponding +<span +class="ectt-1000">\addcontentsline </span>command. +<!--l. 227--><p class="indent"> In addition, the <span +class="ectt-1000">hyperindex </span>option (see below) attempts to make items in the index by hyperlinked +back to the text, and the option <span +class="ectt-1000">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="ectt-1000">colorlinks</span>, as its name well implies, colors the links instead of using boxes; this is the option used in +this document. +<!--l. 236--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">3 </span> <a + id="x1-40003"></a>Package options</h3> +<!--l. 238--><p class="noindent">All user-configurable aspects of <span +class="ecss-1000">hyperref </span>are set using a single ‘key=value’ scheme (using the <span +class="ecss-1000">keyval</span> +package) with the key <span +class="ectt-1000">Hyp</span>. The options can be set either in the optional argument to the +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\usepackage</span></span></span> command, or using the <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypersetup</span></span></span> macro. When the package is loaded, a file +<span +class="ectt-1000">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. 246--><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="ectt-1000">hyperref.cfg </span>setting up the look of links, adding backreferencing, and setting + a PDF display default: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \hypersetup{backref, + <br />pdfpagemode=FullScreen, + <br />colorlinks=true} +</div> + </td></tr></table> + <!--l. 256--><p class="nopar"> + </li> + <li class="itemize">A global option in the file, which is passed down to <span +class="ecss-1000">hyperref</span>: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \documentclass[dvips]{article} +</div> + </td></tr></table> + <!--l. 263--><p class="nopar"> + </li> + <li class="itemize">File-specific options in the <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\usepackage</span></span></span> commands, which override the ones set in + <span +class="ectt-1000">hyperref.cfg</span>: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \usepackage[pdftitle={A Perfect Day},colorlinks=false]{hyperref} +</div> + </td></tr></table> + <!--l. 270--><p class="nopar"></li></ul> +<!--l. 273--><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="ectt-1000">\begin{document}</span></span></span>, only in +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\usepackage[...]{hyperref}</span></span></span>, before first use, etc. +<!--l. 277--><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. 281--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a + id="x1-50003.1"></a>General options</h4> +<!--l. 283--><p class="noindent">Firstly, the options to specify general behavior and page size. +<!--l. 286--><p class="noindent"> +<a + id="x1-5001r1"></a> <!--l. 287--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><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 + valign="baseline" id="TBL-2-1-"><td align="left" style="white-space:nowrap;" id="TBL-2-1-1" +class="td11"> <span +class="ectt-1000">draft </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-1-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-1-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-1-4" +class="td11"> all hypertext options are turned off </td> +</tr><tr + valign="baseline" id="TBL-2-2-"><td align="left" style="white-space:nowrap;" id="TBL-2-2-1" +class="td11"> <span +class="ectt-1000">final </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-2-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-2-4" +class="td11"> all hypertext options are turned on </td> +</tr><tr + valign="baseline" id="TBL-2-3-"><td align="left" style="white-space:nowrap;" id="TBL-2-3-1" +class="td11"> <span +class="ectt-1000">debug </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-3-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-3-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-3-4" +class="td11"> extra diagnostic messages are printed in </td> +</tr><tr + valign="baseline" id="TBL-2-4-"><td align="left" style="white-space:nowrap;" id="TBL-2-4-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-4-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-4-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-4-4" +class="td11"> the log file </td> +</tr><tr + valign="baseline" id="TBL-2-5-"><td align="left" style="white-space:nowrap;" id="TBL-2-5-1" +class="td11"> <span +class="ectt-1000">verbose </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-5-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-5-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-5-4" +class="td11"> same as debug </td> +</tr><tr + valign="baseline" id="TBL-2-6-"><td align="left" style="white-space:nowrap;" id="TBL-2-6-1" +class="td11"> <span +class="ectt-1000">implicit </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-6-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-6-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" 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 + valign="baseline" id="TBL-2-7-"><td align="left" style="white-space:nowrap;" id="TBL-2-7-1" +class="td11"> <span +class="ectt-1000">hypertexnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-7-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-7-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-7-4" +class="td11"> use guessable names for links </td> +</tr><tr + valign="baseline" id="TBL-2-8-"><td align="left" style="white-space:nowrap;" id="TBL-2-8-1" +class="td11"> <span +class="ectt-1000">naturalnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-8-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-8-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" 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 + valign="baseline" id="TBL-2-9-"><td align="left" style="white-space:nowrap;" id="TBL-2-9-1" +class="td11"> <span +class="ectt-1000">a4paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-9-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-9-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-9-4" +class="td11"> sets paper size to 210mm <span +class="cmsy-10">× </span>297mm </td> +</tr><tr + valign="baseline" id="TBL-2-10-"><td align="left" style="white-space:nowrap;" id="TBL-2-10-1" +class="td11"> <span +class="ectt-1000">a5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-10-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-10-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-10-4" +class="td11"> sets paper size to 148mm <span +class="cmsy-10">× </span>210mm </td> +</tr><tr + valign="baseline" id="TBL-2-11-"><td align="left" style="white-space:nowrap;" id="TBL-2-11-1" +class="td11"> <span +class="ectt-1000">b5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-11-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-11-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-11-4" +class="td11"> sets paper size to 176mm <span +class="cmsy-10">× </span>250mm </td> +</tr><tr + valign="baseline" id="TBL-2-12-"><td align="left" style="white-space:nowrap;" id="TBL-2-12-1" +class="td11"> <span +class="ectt-1000">letterpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-12-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-12-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-12-4" +class="td11"> sets paper size to 8.5in <span +class="cmsy-10">× </span>11in </td> +</tr><tr + valign="baseline" id="TBL-2-13-"><td align="left" style="white-space:nowrap;" id="TBL-2-13-1" +class="td11"> <span +class="ectt-1000">legalpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-13-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-13-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-13-4" +class="td11"> sets paper size to 8.5in <span +class="cmsy-10">× </span>14in </td> +</tr><tr + valign="baseline" id="TBL-2-14-"><td align="left" style="white-space:nowrap;" id="TBL-2-14-1" +class="td11"> <span +class="ectt-1000">executivepaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-14-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-14-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-14-4" +class="td11"> sets paper size to 7.25in <span +class="cmsy-10">× </span>10.5in </td> +</tr><tr + valign="baseline" id="TBL-2-15-"><td align="left" style="white-space:nowrap;" id="TBL-2-15-1" +class="td11"> <span +class="ectt-1000">setpagesize </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-15-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-15-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-15-4" +class="td11"> sets page size by special driver commands </td> +</tr><tr + valign="baseline" id="TBL-2-16-"><td align="left" style="white-space:nowrap;" id="TBL-2-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-2-17-"><td align="left" style="white-space:nowrap;" id="TBL-2-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-2-18-"><td align="left" style="white-space:nowrap;" id="TBL-2-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-2-19-"><td align="left" style="white-space:nowrap;" id="TBL-2-19-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-19-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-19-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-19-4" +class="td11"></td></tr> + </table></div> +<!--l. 304--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a + id="x1-60003.2"></a>Configuration options</h4> +<!--l. 306--><p class="noindent"> +<a + id="x1-6001r2"></a> <!--l. 307--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><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 + valign="baseline" id="TBL-3-1-"><td align="left" style="white-space:nowrap;" id="TBL-3-1-1" +class="td11"> <span +class="ectt-1000">raiselinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-1-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-1-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-3-1-4" +class="td11"> + <!--l. 307--><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="ectt-1000">\special</span></span></span> commands to reflect the real + height of the link (which could contain a + graphic) </td> +</tr><tr + valign="baseline" id="TBL-3-2-"><td align="left" style="white-space:nowrap;" id="TBL-3-2-1" +class="td11"> <span +class="ectt-1000">breaklinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-2-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-3-2-4" +class="td11"> + <!--l. 310--><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 + valign="baseline" id="TBL-3-3-"><td align="left" style="white-space:nowrap;" id="TBL-3-3-1" +class="td11"> <span +class="ectt-1000">pageanchor </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-3-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-3-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-3-3-4" +class="td11"> + <!--l. 313--><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="ectt-1000">\tableofcontents</span></span></span> will not + contain hyperlinks. </td> +</tr><tr + valign="baseline" id="TBL-3-4-"><td align="left" style="white-space:nowrap;" id="TBL-3-4-1" +class="td11"> <span +class="ectt-1000">plainpages </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-4-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-4-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-3-4-4" +class="td11"> + <!--l. 315--><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 + valign="baseline" id="TBL-3-5-"><td align="left" style="white-space:nowrap;" id="TBL-3-5-1" +class="td11"> <span +class="ectt-1000">nesting </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-5-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-5-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-3-5-4" +class="td11"> + <!--l. 317--><p class="noindent">Allows links to be nested; no drivers currently + support this. </td> +</tr><tr + valign="baseline" id="TBL-3-6-"><td align="left" style="white-space:nowrap;" id="TBL-3-6-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-3-7-"><td align="left" style="white-space:nowrap;" id="TBL-3-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-3-8-"><td align="left" style="white-space:nowrap;" id="TBL-3-8-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-3-9-"><td align="left" style="white-space:nowrap;" id="TBL-3-9-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-3-9-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-3-9-3" +class="td11"> </td><td align="left" id="TBL-3-9-4" +class="td11"></td></tr> + </table></div> +<!--l. 320--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a + id="x1-70003.3"></a>Backend drivers</h4> +<!--l. 322--><p class="noindent">If no driver is specified, the package defaults to loading the <span +class="ecss-1000">hypertex </span>driver. All of these are boolean +options. +<!--l. 325--><p class="noindent"> +<a + id="x1-7001r3"></a> <!--l. 326--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-4-1g"><col +id="TBL-4-1"><col +id="TBL-4-2"></colgroup> +<tr + valign="baseline" id="TBL-4-1-"><td align="left" style="white-space:nowrap;" id="TBL-4-1-1" +class="td11"> <span +class="ectt-1000">dvips </span></td><td align="left" id="TBL-4-1-2" +class="td11"> + <!--l. 326--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">dvips </span>driver. </td> +</tr><tr + valign="baseline" id="TBL-4-2-"><td align="left" style="white-space:nowrap;" id="TBL-4-2-1" +class="td11"> <span +class="ectt-1000">dvipsone </span></td><td align="left" id="TBL-4-2-2" +class="td11"> + <!--l. 327--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">dvipsone </span>driver. </td> +</tr><tr + valign="baseline" id="TBL-4-3-"><td align="left" style="white-space:nowrap;" id="TBL-4-3-1" +class="td11"> <span +class="ectt-1000">dviwindo </span></td><td align="left" id="TBL-4-3-2" +class="td11"> + <!--l. 328--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">dviwindo </span>Windows previewer. </td> +</tr><tr + valign="baseline" id="TBL-4-4-"><td align="left" style="white-space:nowrap;" id="TBL-4-4-1" +class="td11"> <span +class="ectt-1000">hypertex </span></td><td align="left" id="TBL-4-4-2" +class="td11"> + <!--l. 329--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the Hyper<span class="TEX">T<span +class="E">E</span>X</span>-compliant drivers. </td> +</tr><tr + valign="baseline" id="TBL-4-5-"><td align="left" style="white-space:nowrap;" id="TBL-4-5-1" +class="td11"> <span +class="ectt-1000">latex2html </span></td><td align="left" id="TBL-4-5-2" +class="td11"> + <!--l. 330--><p class="noindent">Redefines a few macros for compatibility with <span +class="ecss-1000">latex2html</span>. </td> +</tr><tr + valign="baseline" id="TBL-4-6-"><td align="left" style="white-space:nowrap;" id="TBL-4-6-1" +class="td11"> <span +class="ectt-1000">nativepdf </span></td><td align="left" id="TBL-4-6-2" +class="td11"> + <!--l. 331--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> + + +</tr><tr + valign="baseline" id="TBL-4-7-"><td align="left" style="white-space:nowrap;" id="TBL-4-7-1" +class="td11"> <span +class="ectt-1000">pdfmark </span></td><td align="left" id="TBL-4-7-2" +class="td11"> + <!--l. 332--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> +</tr><tr + valign="baseline" id="TBL-4-8-"><td align="left" style="white-space:nowrap;" id="TBL-4-8-1" +class="td11"> <span +class="ectt-1000">pdftex </span></td><td align="left" id="TBL-4-8-2" +class="td11"> + <!--l. 333--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">pdftex </span>program. </td> +</tr><tr + valign="baseline" id="TBL-4-9-"><td align="left" style="white-space:nowrap;" id="TBL-4-9-1" +class="td11"> <span +class="ectt-1000">ps2pdf </span></td><td align="left" id="TBL-4-9-2" +class="td11"> + <!--l. 334--><p class="noindent">Redefines a few macros for compatibility with Ghostscript’s PDF writer, + otherwise identical to <span +class="ecss-1000">dvips</span>. </td> +</tr><tr + valign="baseline" id="TBL-4-10-"><td align="left" style="white-space:nowrap;" id="TBL-4-10-1" +class="td11"> <span +class="ectt-1000">tex4ht </span></td><td align="left" id="TBL-4-10-2" +class="td11"> + <!--l. 337--><p class="noindent">for use with <span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span><span +class="ecss-1000">4ht</span> </td> +</tr><tr + valign="baseline" id="TBL-4-11-"><td align="left" style="white-space:nowrap;" id="TBL-4-11-1" +class="td11"> <span +class="ectt-1000">textures </span></td><td align="left" id="TBL-4-11-2" +class="td11"> + <!--l. 338--><p class="noindent">for use with <span +class="ecss-1000">Textures</span> </td> +</tr><tr + valign="baseline" id="TBL-4-12-"><td align="left" style="white-space:nowrap;" id="TBL-4-12-1" +class="td11"> <span +class="ectt-1000">vtex </span></td><td align="left" id="TBL-4-12-2" +class="td11"> + <!--l. 339--><p class="noindent">For use with MicroPress’ <span +class="ecss-1000">VTeX</span>; the PDF and HTML backends are detected + automatically. </td> +</tr><tr + valign="baseline" id="TBL-4-13-"><td align="left" style="white-space:nowrap;" id="TBL-4-13-1" +class="td11"> <span +class="ectt-1000">vtexpdfmark </span></td><td align="left" id="TBL-4-13-2" +class="td11"> + <!--l. 341--><p class="noindent">for use with <span +class="ecss-1000">VTeX</span>’s PostScript backend. </td> +</tr><tr + valign="baseline" id="TBL-4-14-"><td align="left" style="white-space:nowrap;" id="TBL-4-14-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-15-"><td align="left" style="white-space:nowrap;" id="TBL-4-15-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-16-"><td align="left" style="white-space:nowrap;" id="TBL-4-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-17-"><td align="left" style="white-space:nowrap;" id="TBL-4-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-18-"><td align="left" style="white-space:nowrap;" id="TBL-4-18-1" +class="td11"> </td><td align="left" id="TBL-4-18-2" +class="td11"></td></tr> + </table></div> +<!--l. 344--><p class="indent"> If you use <span +class="ecss-1000">dviwindo</span>, you may need to redefine the macro <span +class="ectt-1000">\wwwbrowser </span>(the default is +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">C:\netscape\netscape</span></span></span>) to tell <span +class="ecss-1000">dviwindo </span>what program to launch. Thus, users of Internet Explorer might +add something like this to hyperref.cfg: + + + <table width="100%" +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. 353--><p class="nopar"> +<!--l. 355--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.4 </span> <a + id="x1-80003.4"></a>Extension options</h4> +<!--l. 356--><p class="noindent"> +<a + id="x1-8001r4"></a> <!--l. 357--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><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 + valign="baseline" id="TBL-5-1-"><td align="left" style="white-space:nowrap;" id="TBL-5-1-1" +class="td11"> <span +class="ectt-1000">extension </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-1-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-5-1-3" +class="td11"> </td><td align="left" id="TBL-5-1-4" +class="td11"> + <!--l. 357--><p class="noindent">Set the file extension (e.g. <span +class="ecss-1000">dvi</span>) which + will be appended to file links created if + you use the <span +class="ecss-1000">xr </span>package. </td> +</tr><tr + valign="baseline" id="TBL-5-2-"><td align="left" style="white-space:nowrap;" id="TBL-5-2-1" +class="td11"> <span +class="ectt-1000">hyperfigures </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-2-3" +class="td11"> </td><td align="left" id="TBL-5-2-4" +class="td11"> + <!--l. 360--><p class="noindent"> </td> +</tr><tr + valign="baseline" id="TBL-5-3-"><td align="left" style="white-space:nowrap;" id="TBL-5-3-1" +class="td11"> <span +class="ectt-1000">backref </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-3-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-3-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-3-4" +class="td11"> + <!--l. 360--><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="ecti-1000">if </span>there is a blank line after + each <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\bibitem</span></span></span>. </td> +</tr><tr + valign="baseline" id="TBL-5-4-"><td align="left" style="white-space:nowrap;" id="TBL-5-4-1" +class="td11"> <span +class="ectt-1000">pagebackref </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-4-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-4-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-4-4" +class="td11"> + <!--l. 363--><p class="noindent">Adds ‘backlink’ text to the end of each + item in the bibliography, as a list of + page numbers. </td> +</tr><tr + valign="baseline" id="TBL-5-5-"><td align="left" style="white-space:nowrap;" id="TBL-5-5-1" +class="td11"> <span +class="ectt-1000">hyperindex </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-5-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-5-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-5-4" +class="td11"> + <!--l. 365--><p class="noindent">Makes the text of index entries into + hyperlinks. Easily broken . . . </td> +</tr><tr + valign="baseline" id="TBL-5-6-"><td align="left" style="white-space:nowrap;" id="TBL-5-6-1" +class="td11"> <span +class="ectt-1000">encap </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-6-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-5-6-3" +class="td11"> </td><td align="left" id="TBL-5-6-4" +class="td11"> + <!--l. 366--><p class="noindent">Sets encap character for hyperindex </td> +</tr><tr + valign="baseline" id="TBL-5-7-"><td align="left" style="white-space:nowrap;" id="TBL-5-7-1" +class="td11"> <span +class="ectt-1000">linktocpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-7-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-7-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-7-4" +class="td11"> + <!--l. 367--><p class="noindent">make page number, not text, be link on + TOC, LOF and LOT </td> +</tr><tr + valign="baseline" id="TBL-5-8-"><td align="left" style="white-space:nowrap;" id="TBL-5-8-1" +class="td11"> <span +class="ectt-1000">breaklinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-8-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-8-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-8-4" +class="td11"> + <!--l. 368--><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 + valign="baseline" id="TBL-5-9-"><td align="left" style="white-space:nowrap;" id="TBL-5-9-1" +class="td11"> <span +class="ectt-1000">colorlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-9-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-9-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-9-4" +class="td11"> + <!--l. 370--><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 + valign="baseline" id="TBL-5-10-"><td align="left" style="white-space:nowrap;" id="TBL-5-10-1" +class="td11"> <span +class="ectt-1000">linkcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-10-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-10-3" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-5-10-4" +class="td11"> + <!--l. 373--><p class="noindent">Color for normal internal links. </td> +</tr><tr + valign="baseline" id="TBL-5-11-"><td align="left" style="white-space:nowrap;" id="TBL-5-11-1" +class="td11"> <span +class="ectt-1000">anchorcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-11-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-11-3" +class="td11"> <span +class="ecti-1000">black </span></td><td align="left" id="TBL-5-11-4" +class="td11"> + <!--l. 374--><p class="noindent">Color for anchor text. </td> +</tr><tr + valign="baseline" id="TBL-5-12-"><td align="left" style="white-space:nowrap;" id="TBL-5-12-1" +class="td11"> <span +class="ectt-1000">citecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-12-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-12-3" +class="td11"> <span +class="ecti-1000">green </span></td><td align="left" id="TBL-5-12-4" +class="td11"> + <!--l. 375--><p class="noindent">Color for bibliographical citations in + text. </td> +</tr><tr + valign="baseline" id="TBL-5-13-"><td align="left" style="white-space:nowrap;" id="TBL-5-13-1" +class="td11"> <span +class="ectt-1000">filecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-13-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-13-3" +class="td11"> <span +class="ecti-1000">magenta </span></td><td align="left" id="TBL-5-13-4" +class="td11"> + <!--l. 376--><p class="noindent">Color for URLs which open local files. </td> +</tr><tr + valign="baseline" id="TBL-5-14-"><td align="left" style="white-space:nowrap;" id="TBL-5-14-1" +class="td11"> <span +class="ectt-1000">menucolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-14-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-14-3" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-5-14-4" +class="td11"> + <!--l. 377--><p class="noindent">Color for Acrobat menu items. </td> +</tr><tr + valign="baseline" id="TBL-5-15-"><td align="left" style="white-space:nowrap;" id="TBL-5-15-1" +class="td11"> <span +class="ectt-1000">pagecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-15-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-15-3" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-5-15-4" +class="td11"> + <!--l. 378--><p class="noindent">Color for links to other pages. </td> +</tr><tr + valign="baseline" id="TBL-5-16-"><td align="left" style="white-space:nowrap;" id="TBL-5-16-1" +class="td11"> <span +class="ectt-1000">urlcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-16-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-16-3" +class="td11"> <span +class="ecti-1000">cyan </span></td><td align="left" id="TBL-5-16-4" +class="td11"> + <!--l. 379--><p class="noindent">Color for linked URLs. </td> +</tr><tr + valign="baseline" id="TBL-5-17-"><td align="left" style="white-space:nowrap;" id="TBL-5-17-1" +class="td11"> <span +class="ectt-1000">frenchlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-17-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-17-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-17-4" +class="td11"> + <!--l. 380--><p class="noindent">use small caps instead of color for links </td> +</tr><tr + valign="baseline" id="TBL-5-18-"><td align="left" style="white-space:nowrap;" id="TBL-5-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-5-19-"><td align="left" style="white-space:nowrap;" id="TBL-5-19-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-5-20-"><td align="left" style="white-space:nowrap;" id="TBL-5-20-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-5-21-"><td align="left" style="white-space:nowrap;" id="TBL-5-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-5-21-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-5-21-3" +class="td11"> </td><td align="left" id="TBL-5-21-4" +class="td11"></td></tr> + </table></div> +<!--l. 383--><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="ecss-1000">color </span>package. +<!--l. 386--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a + id="x1-90003.5"></a>PDF-specific display options</h4> +<!--l. 387--><p class="noindent"> +<a + id="x1-9001r5"></a> <!--l. 388--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><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 + valign="baseline" id="TBL-6-1-"><td align="left" style="white-space:nowrap;" id="TBL-6-1-1" +class="td11"> <span +class="ectt-1000">bookmarks </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-1-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-6-1-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-6-1-4" +class="td11"> + <!--l. 388--><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="ectt-1000">.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="ectt-1000">.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="ectt-1000">\let\WriteBookmarks\relax</span></span></span> </td> +</tr><tr + valign="baseline" id="TBL-6-2-"><td align="left" style="white-space:nowrap;" id="TBL-6-2-1" +class="td11"> <span +class="ectt-1000">bookmarksopen </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-6-2-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-6-2-4" +class="td11"> + <!--l. 394--><p class="noindent">If Acrobat bookmarks + are requested, show them with + all the subtrees expanded. </td> + + +</tr><tr + valign="baseline" id="TBL-6-3-"><td align="left" style="white-space:nowrap;" id="TBL-6-3-1" +class="td11"> <span +class="ectt-1000">bookmarksopenlevel </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-3-2" +class="td11"> parameter </td><td align="left" style="white-space:nowrap;" id="TBL-6-3-3" +class="td11"> </td><td align="left" id="TBL-6-3-4" +class="td11"> + <!--l. 396--><p class="noindent">level (<span +class="ectt-1000">\maxdimen</span>) to which + bookmarks are open </td> +</tr><tr + valign="baseline" id="TBL-6-4-"><td align="left" style="white-space:nowrap;" id="TBL-6-4-1" +class="td11"> <span +class="ectt-1000">bookmarksnumbered </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-4-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-6-4-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-6-4-4" +class="td11"> + <!--l. 397--><p class="noindent">If Acrobat bookmarks + are requested, include section + numbers. </td> +</tr><tr + valign="baseline" id="TBL-6-5-"><td align="left" style="white-space:nowrap;" id="TBL-6-5-1" +class="td11"> <span +class="ectt-1000">bookmarkstype </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-5-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-6-5-3" +class="td11"> <span +class="ecti-1000">toc </span></td><td align="left" id="TBL-6-5-4" +class="td11"> + <!--l. 398--><p class="noindent">to specify which ‘toc’ file to + mimic </td> +</tr><tr + valign="baseline" id="TBL-6-6-"><td align="left" style="white-space:nowrap;" id="TBL-6-6-1" +class="td11"> <span +class="ectt-1000">pdfhighlight </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-6-2" +class="td11"> name </td><td align="left" style="white-space:nowrap;" id="TBL-6-6-3" +class="td11"> <span +class="ecti-1000">/I </span></td><td align="left" id="TBL-6-6-4" +class="td11"> + <!--l. 399--><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 + valign="baseline" id="TBL-6-7-"><td align="left" style="white-space:nowrap;" id="TBL-6-7-1" +class="td11"> <span +class="ectt-1000">citebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-7-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-7-3" +class="td11"> <span +class="ecti-1000">0 1 0 </span></td><td align="left" id="TBL-6-7-4" +class="td11"> + <!--l. 402--><p class="noindent">The color of the box around + citations </td> +</tr><tr + valign="baseline" id="TBL-6-8-"><td align="left" style="white-space:nowrap;" id="TBL-6-8-1" +class="td11"> <span +class="ectt-1000">filebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-8-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-8-3" +class="td11"> <span +class="ecti-1000">0 .5 .5 </span></td><td align="left" id="TBL-6-8-4" +class="td11"> + <!--l. 403--><p class="noindent">The color of the box around links + to files </td> +</tr><tr + valign="baseline" id="TBL-6-9-"><td align="left" style="white-space:nowrap;" id="TBL-6-9-1" +class="td11"> <span +class="ectt-1000">linkbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-9-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-9-3" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-6-9-4" +class="td11"> + <!--l. 404--><p class="noindent">The color of the box around + normal links </td> +</tr><tr + valign="baseline" id="TBL-6-10-"><td align="left" style="white-space:nowrap;" id="TBL-6-10-1" +class="td11"> <span +class="ectt-1000">menubordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-10-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-10-3" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-6-10-4" +class="td11"> + <!--l. 405--><p class="noindent">The color of the box around + Acrobat menu links </td> +</tr><tr + valign="baseline" id="TBL-6-11-"><td align="left" style="white-space:nowrap;" id="TBL-6-11-1" +class="td11"> <span +class="ectt-1000">pagebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-11-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-11-3" +class="td11"> <span +class="ecti-1000">1 1 0 </span></td><td align="left" id="TBL-6-11-4" +class="td11"> + <!--l. 406--><p class="noindent">The color of the box around links + to pages </td> +</tr><tr + valign="baseline" id="TBL-6-12-"><td align="left" style="white-space:nowrap;" id="TBL-6-12-1" +class="td11"> <span +class="ectt-1000">urlbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-12-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-12-3" +class="td11"> <span +class="ecti-1000">0 1 1 </span></td><td align="left" id="TBL-6-12-4" +class="td11"> + <!--l. 407--><p class="noindent">The color of the box around links + to URLs </td> +</tr><tr + valign="baseline" id="TBL-6-13-"><td align="left" style="white-space:nowrap;" id="TBL-6-13-1" +class="td11"> <span +class="ectt-1000">runbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-13-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-13-3" +class="td11"> <span +class="ecti-1000">0 .7 .7 </span></td><td align="left" id="TBL-6-13-4" +class="td11"> + <!--l. 408--><p class="noindent">color of border around ‘run’ links </td> +</tr><tr + valign="baseline" id="TBL-6-14-"><td align="left" style="white-space:nowrap;" id="TBL-6-14-1" +class="td11"> <span +class="ectt-1000">pdfborder </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-14-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-6-14-3" +class="td11"> <span +class="ecti-1000">0 0 1 </span></td><td align="left" id="TBL-6-14-4" +class="td11"> + <!--l. 409--><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 + valign="baseline" id="TBL-6-15-"><td align="left" style="white-space:nowrap;" id="TBL-6-15-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-6-16-"><td align="left" style="white-space:nowrap;" id="TBL-6-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-6-17-"><td align="left" style="white-space:nowrap;" id="TBL-6-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-6-18-"><td align="left" style="white-space:nowrap;" id="TBL-6-18-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-6-18-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-6-18-3" +class="td11"> </td><td align="left" id="TBL-6-18-4" +class="td11"></td></tr> + </table></div> +<!--l. 413--><p class="indent"> Note that the color of link borders can be specified <span +class="ecti-1000">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. 417--><p class="indent"> The bookmark commands are stored in a file called <span +class="ecti-1000">jobname</span><span +class="ectt-1000">.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="ectt-1000">.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 width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\let\WriteBookmarks\relax +</div> +</td></tr></table> +<!--l. 425--><p class="nopar"> +<!--l. 427--><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. 428--><p class="noindent"> +<a + id="x1-10001r6"></a> <!--l. 429--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><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 + valign="baseline" id="TBL-7-1-"><td align="left" style="white-space:nowrap;" id="TBL-7-1-1" +class="td11"> <span +class="ectt-1000">baseurl </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-1-2" +class="td11"> URL </td><td align="left" style="white-space:nowrap;" id="TBL-7-1-3" +class="td11"> </td><td align="left" id="TBL-7-1-4" +class="td11"> + <!--l. 429--><p class="noindent">Sets the base URL of the PDF + document </td> +</tr><tr + valign="baseline" id="TBL-7-2-"><td align="left" style="white-space:nowrap;" id="TBL-7-2-1" +class="td11"> <span +class="ectt-1000">pdfpagemode </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-2-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-2-3" +class="td11"> <span +class="ecti-1000">None </span></td><td align="left" id="TBL-7-2-4" +class="td11"> + <!--l. 430--><p class="noindent">Determines how the file is + opening in Acrobat; the possibilities are + <span +class="ectt-1000">None</span>, <span +class="ectt-1000">UseThumbs </span>(show thumbnails), + <span +class="ectt-1000">UseOutlines </span>(show bookmarks), and + <span +class="ectt-1000">FullScreen</span>. If no mode if explicitly + chosen, but the bookmarks option is + set, <span +class="ectt-1000">UseOutlines </span>is used. </td> +</tr><tr + valign="baseline" id="TBL-7-3-"><td align="left" style="white-space:nowrap;" id="TBL-7-3-1" +class="td11"> <span +class="ectt-1000">pdftitle </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-3-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-3-3" +class="td11"> </td><td align="left" id="TBL-7-3-4" +class="td11"> + <!--l. 434--><p class="noindent">Sets the document information Title + field </td> +</tr><tr + valign="baseline" id="TBL-7-4-"><td align="left" style="white-space:nowrap;" id="TBL-7-4-1" +class="td11"> <span +class="ectt-1000">pdfauthor </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-4-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-4-3" +class="td11"> </td><td align="left" id="TBL-7-4-4" +class="td11"> + <!--l. 435--><p class="noindent">Sets the document information Author + field </td> +</tr><tr + valign="baseline" id="TBL-7-5-"><td align="left" style="white-space:nowrap;" id="TBL-7-5-1" +class="td11"> <span +class="ectt-1000">pdfsubject </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-5-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-5-3" +class="td11"> </td><td align="left" id="TBL-7-5-4" +class="td11"> + <!--l. 436--><p class="noindent">Sets the document information Subject + field </td> +</tr><tr + valign="baseline" id="TBL-7-6-"><td align="left" style="white-space:nowrap;" id="TBL-7-6-1" +class="td11"> <span +class="ectt-1000">pdfcreator </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-6-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-6-3" +class="td11"> </td><td align="left" id="TBL-7-6-4" +class="td11"> + <!--l. 437--><p class="noindent">Sets the document information Creator + field </td> +</tr><tr + valign="baseline" id="TBL-7-7-"><td align="left" style="white-space:nowrap;" id="TBL-7-7-1" +class="td11"> <span +class="ectt-1000">pdfproducer </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-7-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-7-3" +class="td11"> </td><td align="left" id="TBL-7-7-4" +class="td11"> + <!--l. 438--><p class="noindent">Sets the document information + Producer field </td> +</tr><tr + valign="baseline" id="TBL-7-8-"><td align="left" style="white-space:nowrap;" id="TBL-7-8-1" +class="td11"> <span +class="ectt-1000">pdfkeywords </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-8-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-8-3" +class="td11"> </td><td align="left" id="TBL-7-8-4" +class="td11"> + <!--l. 439--><p class="noindent">Sets the document information + Keywords field </td> +</tr><tr + valign="baseline" id="TBL-7-9-"><td align="left" style="white-space:nowrap;" id="TBL-7-9-1" +class="td11"> <span +class="ectt-1000">pdfview </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-9-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-9-3" +class="td11"> <span +class="ecti-1000">FitBH </span></td><td align="left" id="TBL-7-9-4" +class="td11"> + <!--l. 440--><p class="noindent">Sets the default PDF ‘view’ for each + link </td> +</tr><tr + valign="baseline" id="TBL-7-10-"><td align="left" style="white-space:nowrap;" id="TBL-7-10-1" +class="td11"> <span +class="ectt-1000">pdfstartpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-10-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-10-3" +class="td11"> <span +class="ecti-1000">1 </span></td><td align="left" id="TBL-7-10-4" +class="td11"> + <!--l. 441--><p class="noindent">Determines on which page the PDF file + is opened. </td> +</tr><tr + valign="baseline" id="TBL-7-11-"><td align="left" style="white-space:nowrap;" id="TBL-7-11-1" +class="td11"> <span +class="ectt-1000">pdfstartview </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-11-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-11-3" +class="td11"> <span +class="ecti-1000">FitB </span></td><td align="left" id="TBL-7-11-4" +class="td11"> + <!--l. 442--><p class="noindent">Set the startup page view </td> + + +</tr><tr + valign="baseline" id="TBL-7-12-"><td align="left" style="white-space:nowrap;" id="TBL-7-12-1" +class="td11"> <span +class="ectt-1000">pdfpagescrop </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-12-2" +class="td11"> n n n n </td><td align="left" style="white-space:nowrap;" id="TBL-7-12-3" +class="td11"> </td><td align="left" id="TBL-7-12-4" +class="td11"> + <!--l. 443--><p class="noindent">Sets the default PDF crop box for + pages. This should be a set of four + numbers </td> +</tr><tr + valign="baseline" id="TBL-7-13-"><td align="left" style="white-space:nowrap;" id="TBL-7-13-1" +class="td11"> <span +class="ectt-1000">pdfcenterwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-13-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-13-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-13-4" +class="td11"> + <!--l. 444--><p class="noindent">position the document window in the + center of the screen </td> +</tr><tr + valign="baseline" id="TBL-7-14-"><td align="left" style="white-space:nowrap;" id="TBL-7-14-1" +class="td11"> <span +class="ectt-1000">pdffitwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-14-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-14-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-14-4" +class="td11"> + <!--l. 445--><p class="noindent">resize document window to fit + document size </td> +</tr><tr + valign="baseline" id="TBL-7-15-"><td align="left" style="white-space:nowrap;" id="TBL-7-15-1" +class="td11"> <span +class="ectt-1000">pdfmenubar </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-15-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-15-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-7-15-4" +class="td11"> + <!--l. 446--><p class="noindent">make PDF viewer’s menu bar visible </td> +</tr><tr + valign="baseline" id="TBL-7-16-"><td align="left" style="white-space:nowrap;" id="TBL-7-16-1" +class="td11"> <span +class="ectt-1000">pdfnewwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-16-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-16-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-16-4" +class="td11"> + <!--l. 447--><p class="noindent">make links that open another PDF file + start a new window </td> +</tr><tr + valign="baseline" id="TBL-7-17-"><td align="left" style="white-space:nowrap;" id="TBL-7-17-1" +class="td11"> <span +class="ectt-1000">pdfpagelayout </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-17-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-17-3" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-7-17-4" +class="td11"> + <!--l. 448--><p class="noindent">set layout of PDF pages </td> +</tr><tr + valign="baseline" id="TBL-7-18-"><td align="left" style="white-space:nowrap;" id="TBL-7-18-1" +class="td11"> <span +class="ectt-1000">pdfpagelabels </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-18-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-18-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-18-4" +class="td11"> + <!--l. 449--><p class="noindent">set PDF page labels </td> +</tr><tr + valign="baseline" id="TBL-7-19-"><td align="left" style="white-space:nowrap;" id="TBL-7-19-1" +class="td11"> <span +class="ectt-1000">pdfpagetransition </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-19-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-19-3" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-7-19-4" +class="td11"> + <!--l. 450--><p class="noindent">set PDF page transition style </td> +</tr><tr + valign="baseline" id="TBL-7-20-"><td align="left" style="white-space:nowrap;" id="TBL-7-20-1" +class="td11"> <span +class="ectt-1000">pdftoolbar </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-20-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-20-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-7-20-4" +class="td11"> + <!--l. 451--><p class="noindent">make PDF toolbar visible </td> +</tr><tr + valign="baseline" id="TBL-7-21-"><td align="left" style="white-space:nowrap;" id="TBL-7-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-7-21-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-7-21-3" +class="td11"> </td><td align="left" id="TBL-7-21-4" +class="td11"></td></tr> +<tr + valign="baseline" id="TBL-7-22-"><td align="left" style="white-space:nowrap;" id="TBL-7-22-1" +class="td11"> <span +class="ectt-1000">pdfwindowui </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-22-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-22-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-7-22-4" +class="td11"> + <!--l. 452--><p class="noindent">make PDF user interface elements + visible </td> +</tr><tr + valign="baseline" id="TBL-7-23-"><td align="left" style="white-space:nowrap;" id="TBL-7-23-1" +class="td11"> <span +class="ectt-1000">unicode </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-23-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-7-23-3" +class="td11"> </td><td align="left" id="TBL-7-23-4" +class="td11"> + <!--l. 453--><p class="noindent">Unicode encoded PDF strings </td> +</tr><tr + valign="baseline" id="TBL-7-24-"><td align="left" style="white-space:nowrap;" id="TBL-7-24-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-7-25-"><td align="left" style="white-space:nowrap;" id="TBL-7-25-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-7-26-"><td align="left" style="white-space:nowrap;" id="TBL-7-26-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-7-27-"><td align="left" style="white-space:nowrap;" id="TBL-7-27-1" +class="td11"> </td> + </tr> + </table></div> +<!--l. 456--><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. pdf<span class="TEX">T<span +class="E">E</span>X</span> works by supplying default values for <span +class="ectt-1000">XYZ </span>(horizontal <span +class="cmsy-10">×</span> +vertical <span +class="cmsy-10">× </span>zoom) and <span +class="ectt-1000">FitBH</span>. However, drivers using <span +class="ectt-1000">pdfmark </span>do not supply defaults, so <span +class="ecss-1000">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="ectt-1000">pdfview </span>and <span +class="ectt-1000">pdfstartview </span>parameters. +<!--l. 465--><p class="noindent"> +<a + id="x1-10002r7"></a> <!--l. 466--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-8-1g"><col +id="TBL-8-1"><col +id="TBL-8-2"><col +id="TBL-8-3"></colgroup> +<tr + valign="baseline" id="TBL-8-1-"><td align="left" style="white-space:nowrap;" id="TBL-8-1-1" +class="td11"> <span +class="ectt-1000">XYZ </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-1-2" +class="td11"> <span +class="ecti-1000">left top zoom </span></td><td align="left" id="TBL-8-1-3" +class="td11"> + <!--l. 466--><p class="noindent">Sets a coordinate and a zoom factor. If any one + is null, the source link value is used. <span +class="ecti-1000">null null</span> + <span +class="ecti-1000">null </span>will give the same values as the current + page. </td> +</tr><tr + valign="baseline" id="TBL-8-2-"><td align="left" style="white-space:nowrap;" id="TBL-8-2-1" +class="td11"> <span +class="ectt-1000">Fit </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-2-2" +class="td11"> </td><td align="left" id="TBL-8-2-3" +class="td11"> + <!--l. 468--><p class="noindent">Fits the page to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-3-"><td align="left" style="white-space:nowrap;" id="TBL-8-3-1" +class="td11"> <span +class="ectt-1000">FitH </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-3-2" +class="td11"> <span +class="ecti-1000">top </span></td><td align="left" id="TBL-8-3-3" +class="td11"> + <!--l. 469--><p class="noindent">Fits the width of the page to the window. </td> + + +</tr><tr + valign="baseline" id="TBL-8-4-"><td align="left" style="white-space:nowrap;" id="TBL-8-4-1" +class="td11"> <span +class="ectt-1000">FitV </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-4-2" +class="td11"> <span +class="ecti-1000">left </span></td><td align="left" id="TBL-8-4-3" +class="td11"> + <!--l. 470--><p class="noindent">Fits the height of the page to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-5-"><td align="left" style="white-space:nowrap;" id="TBL-8-5-1" +class="td11"> <span +class="ectt-1000">FitR </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-5-2" +class="td11"> <span +class="ecti-1000">left bottom right top </span></td><td align="left" id="TBL-8-5-3" +class="td11"> + <!--l. 471--><p class="noindent">Fits the rectangle specified by the four + coordinates to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-6-"><td align="left" style="white-space:nowrap;" id="TBL-8-6-1" +class="td11"> <span +class="ectt-1000">FitB </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-6-2" +class="td11"> </td><td align="left" id="TBL-8-6-3" +class="td11"> + <!--l. 472--><p class="noindent">Fits the page bounding box to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-7-"><td align="left" style="white-space:nowrap;" id="TBL-8-7-1" +class="td11"> <span +class="ectt-1000">FitBH </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-7-2" +class="td11"> <span +class="ecti-1000">top </span></td><td align="left" id="TBL-8-7-3" +class="td11"> + <!--l. 473--><p class="noindent">Fits the width of the page bounding box to + the window. </td> +</tr><tr + valign="baseline" id="TBL-8-8-"><td align="left" style="white-space:nowrap;" id="TBL-8-8-1" +class="td11"> <span +class="ectt-1000">FitBV </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-8-2" +class="td11"> <span +class="ecti-1000">left </span></td><td align="left" id="TBL-8-8-3" +class="td11"> + <!--l. 474--><p class="noindent">Fits the height of the page bounding box to + the window. </td> +</tr><tr + valign="baseline" id="TBL-8-9-"><td align="left" style="white-space:nowrap;" id="TBL-8-9-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-10-"><td align="left" style="white-space:nowrap;" id="TBL-8-10-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-11-"><td align="left" style="white-space:nowrap;" id="TBL-8-11-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-12-"><td align="left" style="white-space:nowrap;" id="TBL-8-12-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-13-"><td align="left" style="white-space:nowrap;" id="TBL-8-13-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-8-13-2" +class="td11"> </td><td align="left" id="TBL-8-13-3" +class="td11"></td></tr> + </table></div> +<!--l. 477--><p class="indent"> The <span +class="ectt-1000">pdfpagelayout </span>can be one of the following values. +<!--l. 479--><p class="noindent"> +<a + id="x1-10003r8"></a> <!--l. 480--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-9-1g"><col +id="TBL-9-1"><col +id="TBL-9-2"></colgroup> +<tr + valign="baseline" id="TBL-9-1-"><td align="left" style="white-space:nowrap;" id="TBL-9-1-1" +class="td11"> <span +class="ectt-1000">SinglePage </span></td><td align="left" id="TBL-9-1-2" +class="td11"> + <!--l. 480--><p class="noindent">Displays a single page; advancing flips the page </td> +</tr><tr + valign="baseline" id="TBL-9-2-"><td align="left" style="white-space:nowrap;" id="TBL-9-2-1" +class="td11"> <span +class="ectt-1000">OneColumn </span></td><td align="left" id="TBL-9-2-2" +class="td11"> + <!--l. 481--><p class="noindent">Displays the document in one column; continuous scrolling. </td> +</tr><tr + valign="baseline" id="TBL-9-3-"><td align="left" style="white-space:nowrap;" id="TBL-9-3-1" +class="td11"> <span +class="ectt-1000">TwoColumnLeft </span></td><td align="left" id="TBL-9-3-2" +class="td11"> + <!--l. 482--><p class="noindent">Displays the document in two columns, odd-numbered pages to + the left. </td> +</tr><tr + valign="baseline" id="TBL-9-4-"><td align="left" style="white-space:nowrap;" id="TBL-9-4-1" +class="td11"> <span +class="ectt-1000">TwoColumnRight </span></td><td align="left" id="TBL-9-4-2" +class="td11"> + <!--l. 483--><p class="noindent">Displays the document in two columns, odd-numbered pages to + the right. </td> +</tr><tr + valign="baseline" id="TBL-9-5-"><td align="left" style="white-space:nowrap;" id="TBL-9-5-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-9-6-"><td align="left" style="white-space:nowrap;" id="TBL-9-6-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-9-7-"><td align="left" style="white-space:nowrap;" id="TBL-9-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-9-8-"><td align="left" style="white-space:nowrap;" id="TBL-9-8-1" +class="td11"> </td><td align="left" id="TBL-9-8-2" +class="td11"></td></tr> + </table></div> +<!--l. 486--><p class="indent"> Finally, the <span +class="ectt-1000">pdfpagetransition </span>can be one of the following values, where <span +class="ecti-1000">/Di </span>stands for direction of +motion in degrees, generally in 90<sup ><span +class="cmsy-7"><span class="htf-cmbx">o</span></span></sup> steps, <span +class="ecti-1000">/Dm </span>is a horizontal (<span +class="ectt-1000">/H</span>) or vertical (<span +class="ectt-1000">/V</span>) dimension +(e.g. <span +class="ectt-1000">Blinds /Dm /V</span>), and <span +class="ecti-1000">/M </span>is for motion, either in (<span +class="ectt-1000">/I</span>) or out (<span +class="ectt-1000">/O</span>). +<!--l. 493--><p class="noindent"> +<a + id="x1-10004r9"></a> <!--l. 494--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-10-1g"><col +id="TBL-10-1"><col +id="TBL-10-2"><col +id="TBL-10-3"></colgroup> +<tr + valign="baseline" id="TBL-10-1-"><td align="left" style="white-space:nowrap;" id="TBL-10-1-1" +class="td11"> <span +class="ectt-1000">Blinds </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-1-2" +class="td11"> /Dm </td><td align="left" id="TBL-10-1-3" +class="td11"> + <!--l. 494--><p class="noindent">Multiple lines distributed evenly across the screen sweep + in the same direction to reveal the new page. </td> +</tr><tr + valign="baseline" id="TBL-10-2-"><td align="left" style="white-space:nowrap;" id="TBL-10-2-1" +class="td11"> <span +class="ectt-1000">Box </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-2-2" +class="td11"> /M </td><td align="left" id="TBL-10-2-3" +class="td11"> + <!--l. 496--><p class="noindent">A box sweeps in or out. </td> + + +</tr><tr + valign="baseline" id="TBL-10-3-"><td align="left" style="white-space:nowrap;" id="TBL-10-3-1" +class="td11"> <span +class="ectt-1000">Dissolve </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-3-2" +class="td11"> </td><td align="left" id="TBL-10-3-3" +class="td11"> + <!--l. 497--><p class="noindent">The page image dissolves in a piecemeal fashion to reveal + the new page. </td> +</tr><tr + valign="baseline" id="TBL-10-4-"><td align="left" style="white-space:nowrap;" id="TBL-10-4-1" +class="td11"> <span +class="ectt-1000">Glitter </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-4-2" +class="td11"> /Di </td><td align="left" id="TBL-10-4-3" +class="td11"> + <!--l. 498--><p class="noindent">Similar to Dissolve, except the effect sweeps across the + screen. </td> +</tr><tr + valign="baseline" id="TBL-10-5-"><td align="left" style="white-space:nowrap;" id="TBL-10-5-1" +class="td11"> <span +class="ectt-1000">Split </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-5-2" +class="td11"> /Dm /M </td><td align="left" id="TBL-10-5-3" +class="td11"> + <!--l. 499--><p class="noindent">Two lines sweep across the screen to reveal the new page. </td> +</tr><tr + valign="baseline" id="TBL-10-6-"><td align="left" style="white-space:nowrap;" id="TBL-10-6-1" +class="td11"> <span +class="ectt-1000">Wipe </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-6-2" +class="td11"> /Di </td><td align="left" id="TBL-10-6-3" +class="td11"> + <!--l. 500--><p class="noindent">A single line sweeps across the screen to reveal the new + page. </td> +</tr><tr + valign="baseline" id="TBL-10-7-"><td align="left" style="white-space:nowrap;" id="TBL-10-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-10-8-"><td align="left" style="white-space:nowrap;" id="TBL-10-8-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-10-9-"><td align="left" style="white-space:nowrap;" id="TBL-10-9-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-10-10-"><td align="left" style="white-space:nowrap;" id="TBL-10-10-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-10-10-2" +class="td11"> </td><td align="left" id="TBL-10-10-3" +class="td11"></td></tr> + </table></div> +<!--l. 503--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.7 </span> <a + id="x1-110003.7"></a>Big alphabetical list</h4> +<!--l. 505--><p class="noindent">The following is a complete listing of available options for <span +class="ecss-1000">hyperref</span>, arranged alphabetically. +<!--l. 508--><p class="noindent"> +<a + id="x1-11001r10"></a> <!--l. 509--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-11-1g"><col +id="TBL-11-1"><col +id="TBL-11-2"><col +id="TBL-11-3"></colgroup> +<tr + valign="baseline" id="TBL-11-1-"><td align="left" style="white-space:nowrap;" id="TBL-11-1-1" +class="td11"> <span +class="ectt-1000">a4paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-1-2" +class="td11"> </td><td align="left" id="TBL-11-1-3" +class="td11"> + <!--l. 509--><p class="noindent">use A4 paper </td> +</tr><tr + valign="baseline" id="TBL-11-2-"><td align="left" style="white-space:nowrap;" id="TBL-11-2-1" +class="td11"> <span +class="ectt-1000">a5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-2-2" +class="td11"> </td><td align="left" id="TBL-11-2-3" +class="td11"> + <!--l. 510--><p class="noindent">use A5 paper </td> +</tr><tr + valign="baseline" id="TBL-11-3-"><td align="left" style="white-space:nowrap;" id="TBL-11-3-1" +class="td11"> <span +class="ectt-1000">anchorcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-3-2" +class="td11"> <span +class="ecti-1000">black </span></td><td align="left" id="TBL-11-3-3" +class="td11"> + <!--l. 511--><p class="noindent">set color of anchors </td> +</tr><tr + valign="baseline" id="TBL-11-4-"><td align="left" style="white-space:nowrap;" id="TBL-11-4-1" +class="td11"> <span +class="ectt-1000">b5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-4-2" +class="td11"> </td><td align="left" id="TBL-11-4-3" +class="td11"> + <!--l. 512--><p class="noindent">use B5 paper </td> +</tr><tr + valign="baseline" id="TBL-11-5-"><td align="left" style="white-space:nowrap;" id="TBL-11-5-1" +class="td11"> <span +class="ectt-1000">backref </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-5-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-5-3" +class="td11"> + <!--l. 513--><p class="noindent">do bibliographical back references </td> +</tr><tr + valign="baseline" id="TBL-11-6-"><td align="left" style="white-space:nowrap;" id="TBL-11-6-1" +class="td11"> <span +class="ectt-1000">baseurl </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-6-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-6-3" +class="td11"> + <!--l. 514--><p class="noindent">set base URL for document </td> +</tr><tr + valign="baseline" id="TBL-11-7-"><td align="left" style="white-space:nowrap;" id="TBL-11-7-1" +class="td11"> <span +class="ectt-1000">bookmarks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-7-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-7-3" +class="td11"> + <!--l. 515--><p class="noindent">make bookmarks </td> +</tr><tr + valign="baseline" id="TBL-11-8-"><td align="left" style="white-space:nowrap;" id="TBL-11-8-1" +class="td11"> <span +class="ectt-1000">bookmarksnumbered </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-8-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-8-3" +class="td11"> + <!--l. 516--><p class="noindent">put section numbers in bookmarks </td> +</tr><tr + valign="baseline" id="TBL-11-9-"><td align="left" style="white-space:nowrap;" id="TBL-11-9-1" +class="td11"> <span +class="ectt-1000">bookmarksopen </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-9-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-9-3" +class="td11"> + <!--l. 517--><p class="noindent">open up bookmark tree </td> +</tr><tr + valign="baseline" id="TBL-11-10-"><td align="left" style="white-space:nowrap;" id="TBL-11-10-1" +class="td11"> <span +class="ectt-1000">bookmarksopenlevel </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-10-2" +class="td11"> <span +class="ectt-1000">\maxdimen </span></td><td align="left" id="TBL-11-10-3" +class="td11"> + <!--l. 518--><p class="noindent">level to which bookmarks are open </td> +</tr><tr + valign="baseline" id="TBL-11-11-"><td align="left" style="white-space:nowrap;" id="TBL-11-11-1" +class="td11"> <span +class="ectt-1000">bookmarkstype </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-11-2" +class="td11"> <span +class="ecti-1000">toc </span></td><td align="left" id="TBL-11-11-3" +class="td11"> + <!--l. 519--><p class="noindent">to specify which ‘toc’ file to mimic </td> +</tr><tr + valign="baseline" id="TBL-11-12-"><td align="left" style="white-space:nowrap;" id="TBL-11-12-1" +class="td11"> <span +class="ectt-1000">breaklinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-12-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-12-3" +class="td11"> + <!--l. 520--><p class="noindent">allow links to break over lines </td> +</tr><tr + valign="baseline" id="TBL-11-13-"><td align="left" style="white-space:nowrap;" id="TBL-11-13-1" +class="td11"> <span +class="ectt-1000">citebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-13-2" +class="td11"> <span +class="ecti-1000">0 1 0 </span></td><td align="left" id="TBL-11-13-3" +class="td11"> + <!--l. 521--><p class="noindent">color of border around cites </td> + + +</tr><tr + valign="baseline" id="TBL-11-14-"><td align="left" style="white-space:nowrap;" id="TBL-11-14-1" +class="td11"> <span +class="ectt-1000">citecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-14-2" +class="td11"> <span +class="ecti-1000">green </span></td><td align="left" id="TBL-11-14-3" +class="td11"> + <!--l. 522--><p class="noindent">color of citation links </td> +</tr><tr + valign="baseline" id="TBL-11-15-"><td align="left" style="white-space:nowrap;" id="TBL-11-15-1" +class="td11"> <span +class="ectt-1000">colorlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-15-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-15-3" +class="td11"> + <!--l. 523--><p class="noindent">color links </td> +</tr><tr + valign="baseline" id="TBL-11-16-"><td align="left" style="white-space:nowrap;" id="TBL-11-16-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-16-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-16-3" +class="td11"> + <!--l. 524--><p class="noindent">(<span +class="ecss-1000">tex4ht</span>, <span +class="ecss-1000">dviwindo</span>) </td> +</tr><tr + valign="baseline" id="TBL-11-17-"><td align="left" style="white-space:nowrap;" id="TBL-11-17-1" +class="td11"> <span +class="ectt-1000">debug </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-17-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-17-3" +class="td11"> + <!--l. 525--><p class="noindent">provide details of anchors defined; same + as verbose </td> +</tr><tr + valign="baseline" id="TBL-11-18-"><td align="left" style="white-space:nowrap;" id="TBL-11-18-1" +class="td11"> <span +class="ectt-1000">draft </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-18-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-18-3" +class="td11"> + <!--l. 526--><p class="noindent">do not do any hyperlinking </td> +</tr><tr + valign="baseline" id="TBL-11-19-"><td align="left" style="white-space:nowrap;" id="TBL-11-19-1" +class="td11"> <span +class="ectt-1000">dvipdf </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-19-2" +class="td11"> </td><td align="left" id="TBL-11-19-3" +class="td11"> + <!--l. 527--><p class="noindent">use <span +class="ecss-1000">dvipdf </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-20-"><td align="left" style="white-space:nowrap;" id="TBL-11-20-1" +class="td11"> <span +class="ectt-1000">dvipdfm </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-20-2" +class="td11"> </td><td align="left" id="TBL-11-20-3" +class="td11"> + <!--l. 528--><p class="noindent">use <span +class="ecss-1000">dvipdfm </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-21-"><td align="left" style="white-space:nowrap;" id="TBL-11-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-21-2" +class="td11"> </td><td align="left" id="TBL-11-21-3" +class="td11"></td></tr> +<tr + valign="baseline" id="TBL-11-22-"><td align="left" style="white-space:nowrap;" id="TBL-11-22-1" +class="td11"> <span +class="ectt-1000">dvips </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-22-2" +class="td11"> </td><td align="left" id="TBL-11-22-3" +class="td11"> + <!--l. 529--><p class="noindent">use <span +class="ecss-1000">dvips </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-23-"><td align="left" style="white-space:nowrap;" id="TBL-11-23-1" +class="td11"> <span +class="ectt-1000">dvipsone </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-23-2" +class="td11"> </td><td align="left" id="TBL-11-23-3" +class="td11"> + <!--l. 530--><p class="noindent">use <span +class="ecss-1000">dvipsone </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-24-"><td align="left" style="white-space:nowrap;" id="TBL-11-24-1" +class="td11"> <span +class="ectt-1000">dviwindo </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-24-2" +class="td11"> </td><td align="left" id="TBL-11-24-3" +class="td11"> + <!--l. 531--><p class="noindent">use <span +class="ecss-1000">dviwindo </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-25-"><td align="left" style="white-space:nowrap;" id="TBL-11-25-1" +class="td11"> <span +class="ectt-1000">encap </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-25-2" +class="td11"> </td><td align="left" id="TBL-11-25-3" +class="td11"> + <!--l. 532--><p class="noindent">to set encap character for hyperindex </td> +</tr><tr + valign="baseline" id="TBL-11-26-"><td align="left" style="white-space:nowrap;" id="TBL-11-26-1" +class="td11"> <span +class="ectt-1000">executivepaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-26-2" +class="td11"> </td><td align="left" id="TBL-11-26-3" +class="td11"> + <!--l. 533--><p class="noindent">use executivepaper </td> +</tr><tr + valign="baseline" id="TBL-11-27-"><td align="left" style="white-space:nowrap;" id="TBL-11-27-1" +class="td11"> <span +class="ectt-1000">extension </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-27-2" +class="td11"> <span +class="ecti-1000">dvi </span></td><td align="left" id="TBL-11-27-3" +class="td11"> + <!--l. 534--><p class="noindent">suffix of linked files </td> +</tr><tr + valign="baseline" id="TBL-11-28-"><td align="left" style="white-space:nowrap;" id="TBL-11-28-1" +class="td11"> <span +class="ectt-1000">filebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-28-2" +class="td11"> <span +class="ecti-1000">0 .5 .5 </span></td><td align="left" id="TBL-11-28-3" +class="td11"> + <!--l. 535--><p class="noindent">color of border around file links </td> +</tr><tr + valign="baseline" id="TBL-11-29-"><td align="left" style="white-space:nowrap;" id="TBL-11-29-1" +class="td11"> <span +class="ectt-1000">filecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-29-2" +class="td11"> <span +class="ecti-1000">cyan </span></td><td align="left" id="TBL-11-29-3" +class="td11"> + <!--l. 536--><p class="noindent">color of file links </td> +</tr><tr + valign="baseline" id="TBL-11-30-"><td align="left" style="white-space:nowrap;" id="TBL-11-30-1" +class="td11"> <span +class="ectt-1000">final </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-30-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-30-3" +class="td11"> + <!--l. 537--><p class="noindent">opposite of option draft </td> +</tr><tr + valign="baseline" id="TBL-11-31-"><td align="left" style="white-space:nowrap;" id="TBL-11-31-1" +class="td11"> <span +class="ectt-1000">frenchlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-31-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-31-3" +class="td11"> + <!--l. 538--><p class="noindent">use small caps instead of color for links </td> +</tr><tr + valign="baseline" id="TBL-11-32-"><td align="left" style="white-space:nowrap;" id="TBL-11-32-1" +class="td11"> <span +class="ectt-1000">hyperfigures </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-32-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-32-3" +class="td11"> + <!--l. 539--><p class="noindent">make figures hyper links </td> +</tr><tr + valign="baseline" id="TBL-11-33-"><td align="left" style="white-space:nowrap;" id="TBL-11-33-1" +class="td11"> <span +class="ectt-1000">hyperindex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-33-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-33-3" +class="td11"> + <!--l. 540--><p class="noindent">set up hyperlinked indices </td> +</tr><tr + valign="baseline" id="TBL-11-34-"><td align="left" style="white-space:nowrap;" id="TBL-11-34-1" +class="td11"> <span +class="ectt-1000">hypertex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-34-2" +class="td11"> </td><td align="left" id="TBL-11-34-3" +class="td11"> + <!--l. 541--><p class="noindent">use <span +class="ecss-1000">Hyper</span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span> backend </td> +</tr><tr + valign="baseline" id="TBL-11-35-"><td align="left" style="white-space:nowrap;" id="TBL-11-35-1" +class="td11"> <span +class="ectt-1000">hypertexnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-35-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-35-3" +class="td11"> + <!--l. 542--><p class="noindent">use guessable names for links </td> +</tr><tr + valign="baseline" id="TBL-11-36-"><td align="left" style="white-space:nowrap;" id="TBL-11-36-1" +class="td11"> <span +class="ectt-1000">implicit </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-36-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-36-3" +class="td11"> + <!--l. 543--><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 + valign="baseline" id="TBL-11-37-"><td align="left" style="white-space:nowrap;" id="TBL-11-37-1" +class="td11"> <span +class="ectt-1000">latex2html </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-37-2" +class="td11"> </td><td align="left" id="TBL-11-37-3" +class="td11"> + <!--l. 544--><p class="noindent">use <span class="LATEX"><span +class="ecss-1000">L</span><span class="A"><span +class="ecss-1000">A</span></span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span></span><span +class="ecss-1000">2HTML </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-38-"><td align="left" style="white-space:nowrap;" id="TBL-11-38-1" +class="td11"> <span +class="ectt-1000">legalpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-38-2" +class="td11"> </td><td align="left" id="TBL-11-38-3" +class="td11"> + <!--l. 545--><p class="noindent">use legalpaper </td> +</tr><tr + valign="baseline" id="TBL-11-39-"><td align="left" style="white-space:nowrap;" id="TBL-11-39-1" +class="td11"> <span +class="ectt-1000">letterpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-39-2" +class="td11"> </td><td align="left" id="TBL-11-39-3" +class="td11"> + <!--l. 546--><p class="noindent">use letterpaper </td> + + +</tr><tr + valign="baseline" id="TBL-11-40-"><td align="left" style="white-space:nowrap;" id="TBL-11-40-1" +class="td11"> <span +class="ectt-1000">linkbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-40-2" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-11-40-3" +class="td11"> + <!--l. 547--><p class="noindent">color of border around links </td> +</tr><tr + valign="baseline" id="TBL-11-41-"><td align="left" style="white-space:nowrap;" id="TBL-11-41-1" +class="td11"> <span +class="ectt-1000">linkcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-41-2" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-11-41-3" +class="td11"> + <!--l. 548--><p class="noindent">color of links </td> +</tr><tr + valign="baseline" id="TBL-11-42-"><td align="left" style="white-space:nowrap;" id="TBL-11-42-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-11-43-"><td align="left" style="white-space:nowrap;" id="TBL-11-43-1" +class="td11"> <span +class="ectt-1000">linktocpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-43-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-43-3" +class="td11"> + <!--l. 549--><p class="noindent">make page number, not text, be link on + TOC, LOF and LOT </td> +</tr><tr + valign="baseline" id="TBL-11-44-"><td align="left" style="white-space:nowrap;" id="TBL-11-44-1" +class="td11"> <span +class="ectt-1000">menubordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-44-2" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-11-44-3" +class="td11"> + <!--l. 550--><p class="noindent">color of border around menu links </td> +</tr><tr + valign="baseline" id="TBL-11-45-"><td align="left" style="white-space:nowrap;" id="TBL-11-45-1" +class="td11"> <span +class="ectt-1000">menucolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-45-2" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-11-45-3" +class="td11"> + <!--l. 551--><p class="noindent">color for menu links </td> +</tr><tr + valign="baseline" id="TBL-11-46-"><td align="left" style="white-space:nowrap;" id="TBL-11-46-1" +class="td11"> <span +class="ectt-1000">nativepdf </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-46-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-46-3" +class="td11"> + <!--l. 552--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> +</tr><tr + valign="baseline" id="TBL-11-47-"><td align="left" style="white-space:nowrap;" id="TBL-11-47-1" +class="td11"> <span +class="ectt-1000">naturalnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-47-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-47-3" +class="td11"> + <!--l. 553--><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 + valign="baseline" id="TBL-11-48-"><td align="left" style="white-space:nowrap;" id="TBL-11-48-1" +class="td11"> <span +class="ectt-1000">nesting </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-48-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-48-3" +class="td11"> + <!--l. 554--><p class="noindent">allow nesting of links </td> +</tr><tr + valign="baseline" id="TBL-11-49-"><td align="left" style="white-space:nowrap;" id="TBL-11-49-1" +class="td11"> <span +class="ectt-1000">pageanchor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-49-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-49-3" +class="td11"> + <!--l. 555--><p class="noindent">put an anchor on every page </td> +</tr><tr + valign="baseline" id="TBL-11-50-"><td align="left" style="white-space:nowrap;" id="TBL-11-50-1" +class="td11"> <span +class="ectt-1000">pagebackref </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-50-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-50-3" +class="td11"> + <!--l. 556--><p class="noindent">backreference by page number </td> +</tr><tr + valign="baseline" id="TBL-11-51-"><td align="left" style="white-space:nowrap;" id="TBL-11-51-1" +class="td11"> <span +class="ectt-1000">pagebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-51-2" +class="td11"> <span +class="ecti-1000">1 1 0 </span></td><td align="left" id="TBL-11-51-3" +class="td11"> + <!--l. 557--><p class="noindent">color of border around page links </td> +</tr><tr + valign="baseline" id="TBL-11-52-"><td align="left" style="white-space:nowrap;" id="TBL-11-52-1" +class="td11"> <span +class="ectt-1000">pagecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-52-2" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-11-52-3" +class="td11"> + <!--l. 558--><p class="noindent">color of page links </td> +</tr><tr + valign="baseline" id="TBL-11-53-"><td align="left" style="white-space:nowrap;" id="TBL-11-53-1" +class="td11"> <span +class="ectt-1000">pdfauthor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-53-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-53-3" +class="td11"> + <!--l. 559--><p class="noindent">text for PDF Author field </td> +</tr><tr + valign="baseline" id="TBL-11-54-"><td align="left" style="white-space:nowrap;" id="TBL-11-54-1" +class="td11"> <span +class="ectt-1000">pdfborder </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-54-2" +class="td11"> <span +class="ecti-1000">0 0 1 </span></td><td align="left" id="TBL-11-54-3" +class="td11"> + <!--l. 560--><p class="noindent">width of PDF link border </td> +</tr><tr + valign="baseline" id="TBL-11-55-"><td align="left" style="white-space:nowrap;" id="TBL-11-55-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-55-2" +class="td11"> <span +class="ecti-1000">0 0 0 </span></td><td align="left" id="TBL-11-55-3" +class="td11"> + <!--l. 561--><p class="noindent">(<span +class="ectt-1000">colorlinks)</span> </td> +</tr><tr + valign="baseline" id="TBL-11-56-"><td align="left" style="white-space:nowrap;" id="TBL-11-56-1" +class="td11"> <span +class="ectt-1000">pdfcenterwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-56-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-56-3" +class="td11"> + <!--l. 562--><p class="noindent">position the document window in the + center of the screen </td> +</tr><tr + valign="baseline" id="TBL-11-57-"><td align="left" style="white-space:nowrap;" id="TBL-11-57-1" +class="td11"> <span +class="ectt-1000">pdfcreator </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-57-2" +class="td11"> <span +class="ecti-1000">LaTeX with </span></td><td align="left" id="TBL-11-57-3" +class="td11"> + <!--l. 563--><p class="noindent">text for PDF Creator field </td> +</tr><tr + valign="baseline" id="TBL-11-58-"><td align="left" style="white-space:nowrap;" id="TBL-11-58-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-58-2" +class="td11"> <span +class="ecti-1000">hyperref </span></td><td align="left" id="TBL-11-58-3" +class="td11"> + <!--l. 565--><p class="noindent"> </td> +</tr><tr + valign="baseline" id="TBL-11-59-"><td align="left" style="white-space:nowrap;" id="TBL-11-59-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-59-2" +class="td11"> <span +class="ecti-1000">package </span></td><td align="left" id="TBL-11-59-3" +class="td11"> + <!--l. 566--><p class="noindent"> </td> +</tr><tr + valign="baseline" id="TBL-11-60-"><td align="left" style="white-space:nowrap;" id="TBL-11-60-1" +class="td11"> <span +class="ectt-1000">pdffitwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-60-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-60-3" +class="td11"> + <!--l. 566--><p class="noindent">resize document window to fit + document size </td> +</tr><tr + valign="baseline" id="TBL-11-61-"><td align="left" style="white-space:nowrap;" id="TBL-11-61-1" +class="td11"> <span +class="ectt-1000">pdfhighlight </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-61-2" +class="td11"> <span +class="ecti-1000">/I </span></td><td align="left" id="TBL-11-61-3" +class="td11"> + <!--l. 567--><p class="noindent">set highlighting of PDF links </td> +</tr><tr + valign="baseline" id="TBL-11-62-"><td align="left" style="white-space:nowrap;" id="TBL-11-62-1" +class="td11"> <span +class="ectt-1000">pdfkeywords </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-62-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-62-3" +class="td11"> + <!--l. 568--><p class="noindent">text for PDF Keywords field </td> +</tr><tr + valign="baseline" id="TBL-11-63-"><td align="left" style="white-space:nowrap;" id="TBL-11-63-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-11-64-"><td align="left" style="white-space:nowrap;" id="TBL-11-64-1" +class="td11"> <span +class="ectt-1000">pdfmark </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-64-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-64-3" +class="td11"> + <!--l. 569--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> + + +</tr><tr + valign="baseline" id="TBL-11-65-"><td align="left" style="white-space:nowrap;" id="TBL-11-65-1" +class="td11"> <span +class="ectt-1000">pdfmenubar </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-65-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-65-3" +class="td11"> + <!--l. 570--><p class="noindent">make PDF viewer’s menu bar visible </td> +</tr><tr + valign="baseline" id="TBL-11-66-"><td align="left" style="white-space:nowrap;" id="TBL-11-66-1" +class="td11"> <span +class="ectt-1000">pdfnewwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-66-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-66-3" +class="td11"> + <!--l. 571--><p class="noindent">make links that open another PDF </td> +</tr><tr + valign="baseline" id="TBL-11-67-"><td align="left" style="white-space:nowrap;" id="TBL-11-67-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-67-2" +class="td11"> </td><td align="left" id="TBL-11-67-3" +class="td11"> + <!--l. 572--><p class="noindent">file start a new window </td> +</tr><tr + valign="baseline" id="TBL-11-68-"><td align="left" style="white-space:nowrap;" id="TBL-11-68-1" +class="td11"> <span +class="ectt-1000">pdfpagelayout </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-68-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-68-3" +class="td11"> + <!--l. 573--><p class="noindent">set layout of PDF pages </td> +</tr><tr + valign="baseline" id="TBL-11-69-"><td align="left" style="white-space:nowrap;" id="TBL-11-69-1" +class="td11"> <span +class="ectt-1000">pdfpagemode </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-69-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-69-3" +class="td11"> + <!--l. 574--><p class="noindent">set default mode of PDF display </td> +</tr><tr + valign="baseline" id="TBL-11-70-"><td align="left" style="white-space:nowrap;" id="TBL-11-70-1" +class="td11"> <span +class="ectt-1000">pdfpagelabels </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-70-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-70-3" +class="td11"> + <!--l. 575--><p class="noindent">set PDF page labels </td> +</tr><tr + valign="baseline" id="TBL-11-71-"><td align="left" style="white-space:nowrap;" id="TBL-11-71-1" +class="td11"> <span +class="ectt-1000">pdfpagescrop </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-71-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-71-3" +class="td11"> + <!--l. 576--><p class="noindent">set crop size of PDF document </td> +</tr><tr + valign="baseline" id="TBL-11-72-"><td align="left" style="white-space:nowrap;" id="TBL-11-72-1" +class="td11"> <span +class="ectt-1000">pdfpagetransition </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-72-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-72-3" +class="td11"> + <!--l. 577--><p class="noindent">set PDF page transition style </td> +</tr><tr + valign="baseline" id="TBL-11-73-"><td align="left" style="white-space:nowrap;" id="TBL-11-73-1" +class="td11"> <span +class="ectt-1000">pdfproducer </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-73-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-73-3" +class="td11"> + <!--l. 578--><p class="noindent">text for PDF Producer field </td> +</tr><tr + valign="baseline" id="TBL-11-74-"><td align="left" style="white-space:nowrap;" id="TBL-11-74-1" +class="td11"> <span +class="ectt-1000">pdfstartpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-74-2" +class="td11"> <span +class="ecti-1000">1 </span></td><td align="left" id="TBL-11-74-3" +class="td11"> + <!--l. 579--><p class="noindent">page at which PDF document opens </td> +</tr><tr + valign="baseline" id="TBL-11-75-"><td align="left" style="white-space:nowrap;" id="TBL-11-75-1" +class="td11"> <span +class="ectt-1000">pdfstartview </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-75-2" +class="td11"> <span +class="ecti-1000">/Fit </span></td><td align="left" id="TBL-11-75-3" +class="td11"> + <!--l. 580--><p class="noindent">starting view of PDF document </td> +</tr><tr + valign="baseline" id="TBL-11-76-"><td align="left" style="white-space:nowrap;" id="TBL-11-76-1" +class="td11"> <span +class="ectt-1000">pdfsubject </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-76-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-76-3" +class="td11"> + <!--l. 581--><p class="noindent">text for PDF Subject field </td> +</tr><tr + valign="baseline" id="TBL-11-77-"><td align="left" style="white-space:nowrap;" id="TBL-11-77-1" +class="td11"> <span +class="ectt-1000">pdftex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-77-2" +class="td11"> </td><td align="left" id="TBL-11-77-3" +class="td11"> + <!--l. 582--><p class="noindent">use <span +class="ecss-1000">pdf</span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span> backend </td> +</tr><tr + valign="baseline" id="TBL-11-78-"><td align="left" style="white-space:nowrap;" id="TBL-11-78-1" +class="td11"> <span +class="ectt-1000">pdftitle </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-78-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-78-3" +class="td11"> + <!--l. 583--><p class="noindent">text for PDF Title field </td> +</tr><tr + valign="baseline" id="TBL-11-79-"><td align="left" style="white-space:nowrap;" id="TBL-11-79-1" +class="td11"> <span +class="ectt-1000">pdftoolbar </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-79-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-79-3" +class="td11"> + <!--l. 584--><p class="noindent">make PDF toolbar visible </td> +</tr><tr + valign="baseline" id="TBL-11-80-"><td align="left" style="white-space:nowrap;" id="TBL-11-80-1" +class="td11"> <span +class="ectt-1000">pdfview </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-80-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-80-3" +class="td11"> + <!--l. 585--><p class="noindent">PDF ‘view’ when on link traversal </td> +</tr><tr + valign="baseline" id="TBL-11-81-"><td align="left" style="white-space:nowrap;" id="TBL-11-81-1" +class="td11"> <span +class="ectt-1000">pdfwindowui </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-81-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-81-3" +class="td11"> + <!--l. 586--><p class="noindent">make PDF user interface elements + visible </td> +</tr><tr + valign="baseline" id="TBL-11-82-"><td align="left" style="white-space:nowrap;" id="TBL-11-82-1" +class="td11"> <span +class="ectt-1000">plainpages </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-82-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-82-3" +class="td11"> + <!--l. 587--><p class="noindent">do page number anchors as plain arabic </td> +</tr><tr + valign="baseline" id="TBL-11-83-"><td align="left" style="white-space:nowrap;" id="TBL-11-83-1" +class="td11"> <span +class="ectt-1000">ps2pdf </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-83-2" +class="td11"> </td><td align="left" id="TBL-11-83-3" +class="td11"> + <!--l. 588--><p class="noindent">use <span +class="ecss-1000">ps2pdf </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-84-"><td align="left" style="white-space:nowrap;" id="TBL-11-84-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-11-85-"><td align="left" style="white-space:nowrap;" id="TBL-11-85-1" +class="td11"> <span +class="ectt-1000">raiselinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-85-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-85-3" +class="td11"> + <!--l. 589--><p class="noindent">raise up links (for <span +class="ecss-1000">Hyper</span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span> backend) </td> +</tr><tr + valign="baseline" id="TBL-11-86-"><td align="left" style="white-space:nowrap;" id="TBL-11-86-1" +class="td11"> <span +class="ectt-1000">runbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-86-2" +class="td11"> <span +class="ecti-1000">0 .7 .7 </span></td><td align="left" id="TBL-11-86-3" +class="td11"> + <!--l. 590--><p class="noindent">color of border around ‘run’ links </td> +</tr><tr + valign="baseline" id="TBL-11-87-"><td align="left" style="white-space:nowrap;" id="TBL-11-87-1" +class="td11"> <span +class="ectt-1000">setpagesize </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-87-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-87-3" +class="td11"> + <!--l. 591--><p class="noindent">set page size by special driver + commands </td> +</tr><tr + valign="baseline" id="TBL-11-88-"><td align="left" style="white-space:nowrap;" id="TBL-11-88-1" +class="td11"> <span +class="ectt-1000">tex4ht </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-88-2" +class="td11"> </td><td align="left" id="TBL-11-88-3" +class="td11"> + <!--l. 592--><p class="noindent">use <span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span><span +class="ecss-1000">4ht </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-89-"><td align="left" style="white-space:nowrap;" id="TBL-11-89-1" +class="td11"> <span +class="ectt-1000">textures </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-89-2" +class="td11"> </td><td align="left" id="TBL-11-89-3" +class="td11"> + <!--l. 593--><p class="noindent">use <span +class="ecss-1000">Textures </span>backend </td> + + +</tr><tr + valign="baseline" id="TBL-11-90-"><td align="left" style="white-space:nowrap;" id="TBL-11-90-1" +class="td11"> <span +class="ectt-1000">unicode </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-90-2" +class="td11"> </td><td align="left" id="TBL-11-90-3" +class="td11"> + <!--l. 594--><p class="noindent">Unicode encoded pdf strings </td> +</tr><tr + valign="baseline" id="TBL-11-91-"><td align="left" style="white-space:nowrap;" id="TBL-11-91-1" +class="td11"> <span +class="ectt-1000">urlbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-91-2" +class="td11"> <span +class="ecti-1000">0 1 1 </span></td><td align="left" id="TBL-11-91-3" +class="td11"> + <!--l. 595--><p class="noindent">color of border around URL links </td> +</tr><tr + valign="baseline" id="TBL-11-92-"><td align="left" style="white-space:nowrap;" id="TBL-11-92-1" +class="td11"> <span +class="ectt-1000">urlcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-92-2" +class="td11"> <span +class="ecti-1000">magenta </span></td><td align="left" id="TBL-11-92-3" +class="td11"> + <!--l. 596--><p class="noindent">color of URL links </td> +</tr><tr + valign="baseline" id="TBL-11-93-"><td align="left" style="white-space:nowrap;" id="TBL-11-93-1" +class="td11"> <span +class="ectt-1000">verbose </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-93-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-93-3" +class="td11"> + <!--l. 597--><p class="noindent">be chatty </td> +</tr><tr + valign="baseline" id="TBL-11-94-"><td align="left" style="white-space:nowrap;" id="TBL-11-94-1" +class="td11"> <span +class="ectt-1000">vtex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-94-2" +class="td11"> </td><td align="left" id="TBL-11-94-3" +class="td11"> + <!--l. 598--><p class="noindent">use <span +class="ecss-1000">VTeX </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-95-"><td align="left" style="white-space:nowrap;" id="TBL-11-95-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-96-"><td align="left" style="white-space:nowrap;" id="TBL-11-96-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-97-"><td align="left" style="white-space:nowrap;" id="TBL-11-97-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-98-"><td align="left" style="white-space:nowrap;" id="TBL-11-98-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-99-"><td align="left" style="white-space:nowrap;" id="TBL-11-99-1" +class="td11"> </td> + </tr> + </table></div> +<!--l. 601--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-120004"></a>Additional user macros</h3> +<!--l. 603--><p class="noindent">If you need to make references to URLs, or write explicit links, the following low-level user macros are +provided: +<!--l. 606--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\href{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 610--><p class="noindent">The <span +class="ecti-1000">text </span>is made a hyperlink to the <span +class="ecti-1000">URL</span>; this must be a full URL (relative to the base URL, if that is +defined). The special characters # and ~ do <span +class="ecti-1000">not </span>need to be escaped in any way. +<!--l. 615--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\url{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}</span> </span> +<!--l. 619--><p class="noindent">Equivalent to <span +class="ectt-1000">\href</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">{</span></span></span><span +class="ecti-1000">URL</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}{</span></span></span><span +class="ecti-1000">URL</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}</span></span></span>. +<!--l. 622--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\nolinkurl{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}</span> </span> +<!--l. 626--><p class="noindent">Write <span +class="ecti-1000">URL </span>as plain text, without creating a hyperlink. +<!--l. 628--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperbaseurl{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}</span> </span> +<!--l. 632--><p class="noindent">A base <span +class="ecti-1000">URL </span>is established, which is prepended to other specified URLs, to make it easier to write +portable documents. +<!--l. 635--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperimage{</span><span +class="ecti-1000">imageURL</span><span +class="ectt-1000">}</span> </span> +<!--l. 639--><p class="noindent">The image referenced by the <span +class="ecti-1000">URL </span>is inserted. + +<!--l. 641--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperdef{</span><span +class="ecti-1000">category</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 645--><p class="noindent">A target area of the document (the <span +class="ecti-1000">text</span>) is marked, and given the name <span +class="ecti-1000">category.name</span> +<!--l. 648--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperref{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">category</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 652--><p class="noindent"><span +class="ecti-1000">text </span>is made into a link to <span +class="ecti-1000">URL#category.name</span> +<!--l. 654--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperlink{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 657--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hypertarget{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 661--><p class="noindent">A simple internal link is created with <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypertarget</span></span></span>, with two parameters of an anchor <span +class="ecti-1000">name</span>, and +anchor <span +class="ecti-1000">text</span>. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ectt-1000">\hypertarget</span></span></span>, and the <span +class="ecti-1000">text </span>which be used as the link on the page. +<!--l. 667--><p class="indent"> Note that in HTML parlance, the <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ectt-1000">\href</span></span></span> expects a full URL. +<!--l. 672--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\autoref{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 676--><p class="indent"> This is a replacement for the usual <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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. 681--><p class="indent"> The label is worked out from the context of the original <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\label</span></span></span> command by <span +class="ecss-1000">hyperref </span>by using the +macros listed below (shown with their default values). The macros can be redefined in documents using +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\renewcommand</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. 689--><p class="indent"> For each macro below, <span +class="ecss-1000">hyperref </span>checks <span +class="ectt-1000">\*autorefname </span>before <span +class="ectt-1000">\*name</span>. For instance, it looks for +<span +class="ectt-1000">\figureautorefname </span>before <span +class="ectt-1000">\figurename</span>. +<!--l. 693--><p class="noindent"> +<a + id="x1-12001r11"></a> <!--l. 694--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-12-1g"><col +id="TBL-12-1"><col +id="TBL-12-2"></colgroup> +<tr + valign="baseline" id="TBL-12-1-"><td align="left" style="white-space:nowrap;" id="TBL-12-1-1" +class="td11"> <span +class="ecti-1000">Macro </span></td><td align="left" id="TBL-12-1-2" +class="td11"> + <!--l. 694--><p class="noindent"><span +class="ecti-1000">Default</span> </td> +</tr><tr + valign="baseline" id="TBL-12-2-"><td align="left" style="white-space:nowrap;" id="TBL-12-2-1" +class="td11"> <span +class="ectt-1000">\figurename </span></td><td align="left" id="TBL-12-2-2" +class="td11"> + <!--l. 695--><p class="noindent">Figure </td> +</tr><tr + valign="baseline" id="TBL-12-3-"><td align="left" style="white-space:nowrap;" id="TBL-12-3-1" +class="td11"> <span +class="ectt-1000">\tablename </span></td><td align="left" id="TBL-12-3-2" +class="td11"> + <!--l. 696--><p class="noindent">Table </td> +</tr><tr + valign="baseline" id="TBL-12-4-"><td align="left" style="white-space:nowrap;" id="TBL-12-4-1" +class="td11"> <span +class="ectt-1000">\partname </span></td><td align="left" id="TBL-12-4-2" +class="td11"> + <!--l. 697--><p class="noindent">Part </td> +</tr><tr + valign="baseline" id="TBL-12-5-"><td align="left" style="white-space:nowrap;" id="TBL-12-5-1" +class="td11"> <span +class="ectt-1000">\appendixname </span></td><td align="left" id="TBL-12-5-2" +class="td11"> + <!--l. 698--><p class="noindent">Appendix </td> +</tr><tr + valign="baseline" id="TBL-12-6-"><td align="left" style="white-space:nowrap;" id="TBL-12-6-1" +class="td11"> <span +class="ectt-1000">\equationname </span></td><td align="left" id="TBL-12-6-2" +class="td11"> + <!--l. 699--><p class="noindent">Equation </td> + + +</tr><tr + valign="baseline" id="TBL-12-7-"><td align="left" style="white-space:nowrap;" id="TBL-12-7-1" +class="td11"> <span +class="ectt-1000">\Itemname </span></td><td align="left" id="TBL-12-7-2" +class="td11"> + <!--l. 700--><p class="noindent">item </td> +</tr><tr + valign="baseline" id="TBL-12-8-"><td align="left" style="white-space:nowrap;" id="TBL-12-8-1" +class="td11"> <span +class="ectt-1000">\Chaptername </span></td><td align="left" id="TBL-12-8-2" +class="td11"> + <!--l. 701--><p class="noindent">chapter </td> +</tr><tr + valign="baseline" id="TBL-12-9-"><td align="left" style="white-space:nowrap;" id="TBL-12-9-1" +class="td11"> <span +class="ectt-1000">\sectionname </span></td><td align="left" id="TBL-12-9-2" +class="td11"> + <!--l. 702--><p class="noindent">section </td> +</tr><tr + valign="baseline" id="TBL-12-10-"><td align="left" style="white-space:nowrap;" id="TBL-12-10-1" +class="td11"> <span +class="ectt-1000">\subsectionname </span></td><td align="left" id="TBL-12-10-2" +class="td11"> + <!--l. 703--><p class="noindent">subsection </td> +</tr><tr + valign="baseline" id="TBL-12-11-"><td align="left" style="white-space:nowrap;" id="TBL-12-11-1" +class="td11"> <span +class="ectt-1000">\subsubsectionname </span></td><td align="left" id="TBL-12-11-2" +class="td11"> + <!--l. 704--><p class="noindent">subsubsection </td> +</tr><tr + valign="baseline" id="TBL-12-12-"><td align="left" style="white-space:nowrap;" id="TBL-12-12-1" +class="td11"> <span +class="ectt-1000">\paragraphname </span></td><td align="left" id="TBL-12-12-2" +class="td11"> + <!--l. 705--><p class="noindent">paragraph </td> +</tr><tr + valign="baseline" id="TBL-12-13-"><td align="left" style="white-space:nowrap;" id="TBL-12-13-1" +class="td11"> <span +class="ectt-1000">\Hfootnotename </span></td><td align="left" id="TBL-12-13-2" +class="td11"> + <!--l. 706--><p class="noindent">footnote </td> +</tr><tr + valign="baseline" id="TBL-12-14-"><td align="left" style="white-space:nowrap;" id="TBL-12-14-1" +class="td11"> <span +class="ectt-1000">\AMSname </span></td><td align="left" id="TBL-12-14-2" +class="td11"> + <!--l. 707--><p class="noindent">Equation </td> +</tr><tr + valign="baseline" id="TBL-12-15-"><td align="left" style="white-space:nowrap;" id="TBL-12-15-1" +class="td11"> <span +class="ectt-1000">\theoremname </span></td><td align="left" id="TBL-12-15-2" +class="td11"> + <!--l. 708--><p class="noindent">Theorem </td> +</tr><tr + valign="baseline" id="TBL-12-16-"><td align="left" style="white-space:nowrap;" id="TBL-12-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-12-17-"><td align="left" style="white-space:nowrap;" id="TBL-12-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-12-18-"><td align="left" style="white-space:nowrap;" id="TBL-12-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-12-19-"><td align="left" style="white-space:nowrap;" id="TBL-12-19-1" +class="td11"> </td><td align="left" id="TBL-12-19-2" +class="td11"></td></tr> + </table></div> +<!--l. 711--><p class="indent"> For instances where you want a reference to use the correct counter, but not to create a link, there +are two starred forms: +<!--l. 714--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\ref*{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 718--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\pageref*{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 722--><p class="indent"> A typical use would be to write + + + <table width="100%" +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. 725--><p class="nopar"> +<!--l. 727--><p class="indent"> We want <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ref*{other}</span></span></span> to generate the correct number, but not to form a link, since we do this +ourselves with <span +class="ectt-1000">\hyperref</span>. +<!--l. 730--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\pdfstringdef{</span><span +class="ecti-1000">macroname</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">TEXstring</span><span +class="ectt-1000">}</span> </span> +<!--l. 734--><p class="indent"> <span +class="ectt-1000">\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: +<!--l. 738--><p class="indent"> + <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="ectt-1000">\345</span></span></span>): <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ectt-1000">\{</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\%</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\&</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\space</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\dots</span></span></span>, etc. + </li> + <li class="itemize">National glyphs (<span +class="ecss-1000">german.sty</span>, <span +class="ecss-1000">french.sty</span>, etc.) + </li> + <li class="itemize">Logos: <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\TeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\eTeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ectt-1000">\label</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\index</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\discretionary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\def</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\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="ectt-1000">\textbf</span></span></span>, etc. + </li> + <li class="itemize">Support for <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\xspace</span></span></span> provided by the <span +class="ecss-1000">xspace </span>package</li></ul> +<!--l. 750--><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="ecss-1000">hyperref</span>. +<!--l. 755--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-130004.1"></a>Replacement macros</h4> +<!--l. 757--><p class="noindent"><span +class="ecss-1000">hyperref </span>takes the text for bookmarks from the arguments of commands like <span +class="ectt-1000">\section</span>, which can +contain things like math, colors, or font changes, none of which will display in bookmarks as +is. + + +<!--l. 761--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\texorpdfstring{</span><span +class="ecti-1000">TEXstring</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">PDFstring</span><span +class="ectt-1000">}</span> </span> +<!--l. 765--><p class="indent"> For example, + + + <table width="100%" +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 />\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars} +</div> +</td></tr></table> +<!--l. 772--><p class="nopar"> +<!--l. 774--><p class="indent"> <span +class="ectt-1000">\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 width="100%" +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. 784--><p class="nopar"> +<!--l. 786--><p class="indent"> However, for disabling commands, an easier way is via <span +class="ectt-1000">\pdfstringdefDisableCommands</span>, which adds +its argument to the definition of <span +class="ectt-1000">\pdfstringdefPreHook </span>(‘@’ can here be used as letter in command +names): + + + <table width="100%" +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. 797--><p class="nopar"> +<!--l. 800--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">5 </span> <a + id="x1-140005"></a>Acrobat-specific behavior</h3> +<!--l. 801--><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. 804--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\Acrobatmenu{</span><span +class="ecti-1000">menuoption</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 808--><p class="noindent">The <span +class="ecti-1000">text </span>is used to create a button which activates the appropriate <span +class="ecti-1000">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. 811--><p class="noindent"> +<a + id="x1-14001r12"></a> <!--l. 812--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-13-1g"><col +id="TBL-13-1"><col +id="TBL-13-2"></colgroup> +<tr + valign="baseline" id="TBL-13-1-"><td align="left" style="white-space:nowrap;" id="TBL-13-1-1" +class="td11"> File </td><td align="left" id="TBL-13-1-2" +class="td11"> + <!--l. 812--><p class="noindent">Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, + Print, PageSetup, Quit </td> +</tr><tr + valign="baseline" id="TBL-13-2-"><td align="left" style="white-space:nowrap;" id="TBL-13-2-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Import </td><td align="left" id="TBL-13-2-2" +class="td11"> + <!--l. 813--><p class="noindent">ImportImage, ImportNotes, AcroForm:ImportFDF </td> +</tr><tr + valign="baseline" id="TBL-13-3-"><td align="left" style="white-space:nowrap;" id="TBL-13-3-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Export </td><td align="left" id="TBL-13-3-2" +class="td11"> + <!--l. 814--><p class="noindent">ExportNotes, AcroForm:ExportFDF </td> +</tr><tr + valign="baseline" id="TBL-13-4-"><td align="left" style="white-space:nowrap;" id="TBL-13-4-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>DocumentInfo </td><td align="left" id="TBL-13-4-2" +class="td11"> + <!--l. 815--><p class="noindent">GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, + Weblink:Base, AutoIndex:DocInfo </td> +</tr><tr + valign="baseline" id="TBL-13-5-"><td align="left" style="white-space:nowrap;" id="TBL-13-5-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Preferences </td><td align="left" id="TBL-13-5-2" +class="td11"> + <!--l. 816--><p class="noindent">GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, + AcroSearch:Preferences(Windows) or, + AcroSearch:Prefs(Mac), Cpt:Capture </td> +</tr><tr + valign="baseline" id="TBL-13-6-"><td align="left" style="white-space:nowrap;" id="TBL-13-6-1" +class="td11"> Edit </td><td align="left" id="TBL-13-6-2" +class="td11"> + <!--l. 818--><p class="noindent">Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, + TouchUp:TextAttributes, + TouchUp:FitTextToSelection, TouchUp:ShowLineMarkers, + TouchUp:ShowCaptureSuspects, TouchUp:FindSuspect, </td> +</tr><tr + valign="baseline" id="TBL-13-7-"><td align="left" style="white-space:nowrap;" id="TBL-13-7-1" +class="td11"> </td><td align="left" id="TBL-13-7-2" +class="td11"> + <!--l. 821--><p class="noindent">Properties </td> +</tr><tr + valign="baseline" id="TBL-13-8-"><td align="left" style="white-space:nowrap;" id="TBL-13-8-1" +class="td11"> Edit<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Fields </td><td align="left" id="TBL-13-8-2" +class="td11"> + <!--l. 822--><p class="noindent">AcroForm:Duplicate, AcroForm:TabOrder </td> + + +</tr><tr + valign="baseline" id="TBL-13-9-"><td align="left" style="white-space:nowrap;" id="TBL-13-9-1" +class="td11"> Document </td><td align="left" id="TBL-13-9-2" +class="td11"> + <!--l. 823--><p class="noindent">Cpt:CapturePages, + AcroForm:Actions, CropPages, RotatePages, InsertPages, + ExtractPages, ReplacePages, DeletePages, NewBookmark, + SetBookmarkDest, CreateAllThumbs, DeleteAllThumbs </td> +</tr><tr + valign="baseline" id="TBL-13-10-"><td align="left" style="white-space:nowrap;" id="TBL-13-10-1" +class="td11"> View </td><td align="left" id="TBL-13-10-2" +class="td11"> + <!--l. 826--><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 + valign="baseline" id="TBL-13-11-"><td align="left" style="white-space:nowrap;" id="TBL-13-11-1" +class="td11"> Tools </td><td align="left" id="TBL-13-11-2" +class="td11"> + <!--l. 829--><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 + valign="baseline" id="TBL-13-12-"><td align="left" style="white-space:nowrap;" id="TBL-13-12-1" +class="td11"> Tools<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Search </td><td align="left" id="TBL-13-12-2" +class="td11"> + <!--l. 832--><p class="noindent">AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, + AcroSrch:Assist, AcroSrch:PrevDoc, AcroSrch:PrevHit, + AcroSrch:NextHit, AcroSrch:NextDoc </td> +</tr><tr + valign="baseline" id="TBL-13-13-"><td align="left" style="white-space:nowrap;" id="TBL-13-13-1" +class="td11"> Window </td><td align="left" id="TBL-13-13-2" +class="td11"> + <!--l. 834--><p class="noindent">ShowHideToolBar, ShowHideMenuBar, + ShowHideClipboard, Cascade, TileHorizontal, TileVertical, + CloseAll </td> +</tr><tr + valign="baseline" id="TBL-13-14-"><td align="left" style="white-space:nowrap;" id="TBL-13-14-1" +class="td11"> Help </td><td align="left" id="TBL-13-14-2" +class="td11"> + <!--l. 836--><p class="noindent">HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, + HelpCapture, HelpPDFWriter, HelpDistiller, HelpSearch, + HelpCatalog, HelpReader, Weblink:Home </td> +</tr><tr + valign="baseline" id="TBL-13-15-"><td align="left" style="white-space:nowrap;" id="TBL-13-15-1" +class="td11"> Help(Windows) </td><td align="left" id="TBL-13-15-2" +class="td11"> + <!--l. 838--><p class="noindent">About </td> +</tr><tr + valign="baseline" id="TBL-13-16-"><td align="left" style="white-space:nowrap;" id="TBL-13-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-13-17-"><td align="left" style="white-space:nowrap;" id="TBL-13-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-13-18-"><td align="left" style="white-space:nowrap;" id="TBL-13-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-13-19-"><td align="left" style="white-space:nowrap;" id="TBL-13-19-1" +class="td11"> </td><td align="left" id="TBL-13-19-2" +class="td11"></td></tr> + </table></div> +<!--l. 841--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-150006"></a>PDF and HTML forms</h3> +<!--l. 842--><p class="noindent">You must put your fields inside a <span +class="ectt-1000">Form </span>environment (only one per file). +<!--l. 844--><p class="indent"> There are six macros to prepare fields: +<!--l. 846--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\TextField[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 850--><p class="noindent"> + + +<span class="fbox"> <span +class="ectt-1000">\CheckBox[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 854--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\ChoiceMenu[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">choices</span><span +class="ectt-1000">}</span> </span> +<!--l. 858--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\PushButton[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 862--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\Submit[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 866--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\Reset[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 870--><p class="indent"> The way forms and their labels are laid out is determined by: +<!--l. 871--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\LayoutTextField{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">field</span><span +class="ectt-1000">}</span> </span> +<!--l. 875--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\LayoutChoiceField{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">field</span><span +class="ectt-1000">}</span> </span> +<!--l. 879--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\LayoutCheckboxField{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">field</span><span +class="ectt-1000">}</span> </span> +<!--l. 883--><p class="indent"> These macros default to #1 #2 +<!--l. 885--><p class="indent"> What is actually shown in as the field is determined by: +<!--l. 886--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeRadioField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 890--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeCheckField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 893--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeTextField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 896--><p class="noindent"> + + +<span class="fbox"> <span +class="ectt-1000">\MakeChoiceField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 900--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeButtonField{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 904--><p class="indent"> These macros default to <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\vbox</span><span +class="ectt-1000"> to</span><span +class="ectt-1000"> #2{\hbox</span><span +class="ectt-1000"> to</span><span +class="ectt-1000"> #1{\hfill}\vfill}</span></span></span>, except the last, which defaults +to #1; it is used for buttons, and the special <span +class="ectt-1000">\Submit </span>and <span +class="ectt-1000">\Reset </span>macros. +<!--l. 908--><p class="indent"> You may also want to redefine the following macros: + + + <table width="100%" +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\DefaultWidthofText{3cm} +</div> +</td></tr></table> +<!--l. 920--><p class="nopar"> +<!--l. 922--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a + id="x1-160006.1"></a>Forms environment parameters</h4> +<!--l. 924--><p class="noindent"> +<a + id="x1-16001r13"></a> <!--l. 925--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-14-1g"><col +id="TBL-14-1"><col +id="TBL-14-2"><col +id="TBL-14-3"></colgroup> +<tr + valign="baseline" id="TBL-14-1-"><td align="left" style="white-space:nowrap;" id="TBL-14-1-1" +class="td11"> <span +class="ectt-1000">action </span></td><td align="left" style="white-space:nowrap;" id="TBL-14-1-2" +class="td11"> <span +class="ecti-1000">URL </span></td><td align="left" id="TBL-14-1-3" +class="td11"> + <!--l. 925--><p class="noindent">The URL that will receive the form data if a <span +class="ecss-1000">Submit </span>button + is included in the form </td> +</tr><tr + valign="baseline" id="TBL-14-2-"><td align="left" style="white-space:nowrap;" id="TBL-14-2-1" +class="td11"> <span +class="ectt-1000">encoding </span></td><td align="left" style="white-space:nowrap;" id="TBL-14-2-2" +class="td11"> <span +class="ecti-1000">name </span></td><td align="left" id="TBL-14-2-3" +class="td11"> + <!--l. 926--><p class="noindent">The encoding for the string set to the URL; FDF-encoding + is usual, and <span +class="ectt-1000">html </span>is the only valid value </td> +</tr><tr + valign="baseline" id="TBL-14-3-"><td align="left" style="white-space:nowrap;" id="TBL-14-3-1" +class="td11"> <span +class="ectt-1000">method </span></td><td align="left" style="white-space:nowrap;" id="TBL-14-3-2" +class="td11"> <span +class="ecti-1000">name </span></td><td align="left" id="TBL-14-3-3" +class="td11"> + <!--l. 928--><p class="noindent">Used only when generating HTML; values can be <span +class="ectt-1000">post </span>or + <span +class="ectt-1000">get</span> </td> +</tr><tr + valign="baseline" id="TBL-14-4-"><td align="left" style="white-space:nowrap;" id="TBL-14-4-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-5-"><td align="left" style="white-space:nowrap;" id="TBL-14-5-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-6-"><td align="left" style="white-space:nowrap;" id="TBL-14-6-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-7-"><td align="left" style="white-space:nowrap;" id="TBL-14-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-8-"><td align="left" style="white-space:nowrap;" id="TBL-14-8-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-14-8-2" +class="td11"> </td><td align="left" id="TBL-14-8-3" +class="td11"></td></tr> + </table></div> +<!--l. 931--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a + id="x1-170006.2"></a>Forms optional parameters</h4> +<!--l. 932--><p class="noindent">Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. <span +class="ectt-1000">color=0 0</span> +<span +class="ectt-1000">0.5</span>) +<!--l. 935--><p class="noindent"> +<a + id="x1-17001r14"></a> <!--l. 936--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><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 + valign="baseline" id="TBL-15-1-"><td align="left" style="white-space:nowrap;" id="TBL-15-1-1" +class="td11"> <span +class="ectt-1000">accesskey </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-1-2" +class="td11"> key </td><td align="left" style="white-space:nowrap;" id="TBL-15-1-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-1-4" +class="td11"> (as per HTML) </td> +</tr><tr + valign="baseline" id="TBL-15-2-"><td align="left" style="white-space:nowrap;" id="TBL-15-2-1" +class="td11"> <span +class="ectt-1000">align </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-2-2" +class="td11"> number </td><td align="left" style="white-space:nowrap;" id="TBL-15-2-3" +class="td11"> <span +class="ecti-1000">0 </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-2-4" +class="td11"> alignment within text field; 0 is left-aligned, </td> +</tr><tr + valign="baseline" id="TBL-15-3-"><td align="left" style="white-space:nowrap;" id="TBL-15-3-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-3-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-3-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-3-4" +class="td11"> 1 is centered, 2 is right-aligned. </td> + + +</tr><tr + valign="baseline" id="TBL-15-4-"><td align="left" style="white-space:nowrap;" id="TBL-15-4-1" +class="td11"> <span +class="ectt-1000">backgroundcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-4-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-4-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-4-4" +class="td11"> color of box </td> +</tr><tr + valign="baseline" id="TBL-15-5-"><td align="left" style="white-space:nowrap;" id="TBL-15-5-1" +class="td11"> <span +class="ectt-1000">bordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-5-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-5-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-5-4" +class="td11"> color of border </td> +</tr><tr + valign="baseline" id="TBL-15-6-"><td align="left" style="white-space:nowrap;" id="TBL-15-6-1" +class="td11"> <span +class="ectt-1000">bordersep </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-6-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-6-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-6-4" +class="td11"> box border gap </td> +</tr><tr + valign="baseline" id="TBL-15-7-"><td align="left" style="white-space:nowrap;" id="TBL-15-7-1" +class="td11"> <span +class="ectt-1000">borderwidth </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-7-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-7-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-7-4" +class="td11"> width of box border </td> +</tr><tr + valign="baseline" id="TBL-15-8-"><td align="left" style="white-space:nowrap;" id="TBL-15-8-1" +class="td11"> <span +class="ectt-1000">calculate </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-8-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-8-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-8-4" +class="td11"> JavaScript code to calculate the value of the field </td> +</tr><tr + valign="baseline" id="TBL-15-9-"><td align="left" style="white-space:nowrap;" id="TBL-15-9-1" +class="td11"> <span +class="ectt-1000">charsize </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-9-2" +class="td11"> dimen </td><td align="left" style="white-space:nowrap;" id="TBL-15-9-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-9-4" +class="td11"> font size of field text </td> +</tr><tr + valign="baseline" id="TBL-15-10-"><td align="left" style="white-space:nowrap;" id="TBL-15-10-1" +class="td11"> <span +class="ectt-1000">checked </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-10-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-10-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-10-4" +class="td11"> whether option selected by default </td> +</tr><tr + valign="baseline" id="TBL-15-11-"><td align="left" style="white-space:nowrap;" id="TBL-15-11-1" +class="td11"> <span +class="ectt-1000">color </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-11-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-11-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-11-4" +class="td11"> color of text in box </td> +</tr><tr + valign="baseline" id="TBL-15-12-"><td align="left" style="white-space:nowrap;" id="TBL-15-12-1" +class="td11"> <span +class="ectt-1000">combo </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-12-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-12-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-12-4" +class="td11"> choice list is ‘combo’ style </td> +</tr><tr + valign="baseline" id="TBL-15-13-"><td align="left" style="white-space:nowrap;" id="TBL-15-13-1" +class="td11"> <span +class="ectt-1000">default </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-13-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-13-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-13-4" +class="td11"> default value </td> +</tr><tr + valign="baseline" id="TBL-15-14-"><td align="left" style="white-space:nowrap;" id="TBL-15-14-1" +class="td11"> <span +class="ectt-1000">disabled </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-14-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-14-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-14-4" +class="td11"> field disabled </td> +</tr><tr + valign="baseline" id="TBL-15-15-"><td align="left" style="white-space:nowrap;" id="TBL-15-15-1" +class="td11"> <span +class="ectt-1000">format </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-15-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-15-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-15-4" +class="td11"> JavaScript code to format the field </td> +</tr><tr + valign="baseline" id="TBL-15-16-"><td align="left" style="white-space:nowrap;" id="TBL-15-16-1" +class="td11"> <span +class="ectt-1000">height </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-16-2" +class="td11"> dimen </td><td align="left" style="white-space:nowrap;" id="TBL-15-16-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-16-4" +class="td11"> height of field box </td> +</tr><tr + valign="baseline" id="TBL-15-17-"><td align="left" style="white-space:nowrap;" id="TBL-15-17-1" +class="td11"> <span +class="ectt-1000">hidden </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-17-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-17-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-17-4" +class="td11"> field hidden </td> +</tr><tr + valign="baseline" id="TBL-15-18-"><td align="left" style="white-space:nowrap;" id="TBL-15-18-1" +class="td11"> <span +class="ectt-1000">ketstroke </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-18-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-18-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-18-4" +class="td11"> JavaScript code to control the keystrokes on entry </td> +</tr><tr + valign="baseline" id="TBL-15-19-"><td align="left" style="white-space:nowrap;" id="TBL-15-19-1" +class="td11"> <span +class="ectt-1000">maxlen </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-19-2" +class="td11"> number </td><td align="left" style="white-space:nowrap;" id="TBL-15-19-3" +class="td11"> <span +class="ecti-1000">0 </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-19-4" +class="td11"> number of characters allowed in text field </td> +</tr><tr + valign="baseline" id="TBL-15-20-"><td align="left" style="white-space:nowrap;" id="TBL-15-20-1" +class="td11"> <span +class="ectt-1000">menulength </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-20-2" +class="td11"> number </td><td align="left" style="white-space:nowrap;" id="TBL-15-20-3" +class="td11"> <span +class="ecti-1000">4 </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-20-4" +class="td11"> number of elements shown in list </td> +</tr><tr + valign="baseline" id="TBL-15-21-"><td align="left" style="white-space:nowrap;" id="TBL-15-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-21-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-21-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-21-4" +class="td11"></td></tr> +<tr + valign="baseline" id="TBL-15-22-"><td align="left" style="white-space:nowrap;" id="TBL-15-22-1" +class="td11"> <span +class="ectt-1000">multiline </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-22-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-22-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-22-4" +class="td11"> whether text box is multiline </td> +</tr><tr + valign="baseline" id="TBL-15-23-"><td align="left" style="white-space:nowrap;" id="TBL-15-23-1" +class="td11"> <span +class="ectt-1000">name </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-23-2" +class="td11"> name </td><td align="left" style="white-space:nowrap;" id="TBL-15-23-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-23-4" +class="td11"> name of field (defaults to label) </td> +</tr><tr + valign="baseline" id="TBL-15-24-"><td align="left" style="white-space:nowrap;" id="TBL-15-24-1" +class="td11"> <span +class="ectt-1000">onblur </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-24-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-24-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-24-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-25-"><td align="left" style="white-space:nowrap;" id="TBL-15-25-1" +class="td11"> <span +class="ectt-1000">onchange </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-25-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-25-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-25-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-26-"><td align="left" style="white-space:nowrap;" id="TBL-15-26-1" +class="td11"> <span +class="ectt-1000">onclick </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-26-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-26-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-26-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-27-"><td align="left" style="white-space:nowrap;" id="TBL-15-27-1" +class="td11"> <span +class="ectt-1000">ondblclick </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-27-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-27-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-27-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-28-"><td align="left" style="white-space:nowrap;" id="TBL-15-28-1" +class="td11"> <span +class="ectt-1000">onfocus </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-28-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-28-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-28-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-29-"><td align="left" style="white-space:nowrap;" id="TBL-15-29-1" +class="td11"> <span +class="ectt-1000">onkeydown </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-29-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-29-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-29-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-30-"><td align="left" style="white-space:nowrap;" id="TBL-15-30-1" +class="td11"> <span +class="ectt-1000">onkeypress </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-30-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-30-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-30-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-31-"><td align="left" style="white-space:nowrap;" id="TBL-15-31-1" +class="td11"> <span +class="ectt-1000">onkeyup </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-31-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-31-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-31-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-32-"><td align="left" style="white-space:nowrap;" id="TBL-15-32-1" +class="td11"> <span +class="ectt-1000">onmousedown </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-32-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-32-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-32-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-33-"><td align="left" style="white-space:nowrap;" id="TBL-15-33-1" +class="td11"> <span +class="ectt-1000">onmousemove </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-33-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-33-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-33-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-34-"><td align="left" style="white-space:nowrap;" id="TBL-15-34-1" +class="td11"> <span +class="ectt-1000">onmouseout </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-34-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-34-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-34-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-35-"><td align="left" style="white-space:nowrap;" id="TBL-15-35-1" +class="td11"> <span +class="ectt-1000">onmouseover </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-35-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-35-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-35-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-36-"><td align="left" style="white-space:nowrap;" id="TBL-15-36-1" +class="td11"> <span +class="ectt-1000">onmouseup </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-36-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-36-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-36-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-37-"><td align="left" style="white-space:nowrap;" id="TBL-15-37-1" +class="td11"> <span +class="ectt-1000">onselect </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-37-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-37-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-37-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-38-"><td align="left" style="white-space:nowrap;" id="TBL-15-38-1" +class="td11"> <span +class="ectt-1000">password </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-38-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-38-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-38-4" +class="td11"> text field is ‘password’ style </td> +</tr><tr + valign="baseline" id="TBL-15-39-"><td align="left" style="white-space:nowrap;" id="TBL-15-39-1" +class="td11"> <span +class="ectt-1000">popdown </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-39-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-39-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-39-4" +class="td11"> choice list is ‘popdown’ style </td> +</tr><tr + valign="baseline" id="TBL-15-40-"><td align="left" style="white-space:nowrap;" id="TBL-15-40-1" +class="td11"> <span +class="ectt-1000">radio </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-40-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-40-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-40-4" +class="td11"> choice list is ‘radio’ style </td> +</tr><tr + valign="baseline" id="TBL-15-41-"><td align="left" style="white-space:nowrap;" id="TBL-15-41-1" +class="td11"> <span +class="ectt-1000">readonly </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-41-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-41-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-41-4" +class="td11"> field is readonly </td> +</tr><tr + valign="baseline" id="TBL-15-42-"><td align="left" style="white-space:nowrap;" id="TBL-15-42-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-15-43-"><td align="left" style="white-space:nowrap;" id="TBL-15-43-1" +class="td11"> <span +class="ectt-1000">tabkey </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-43-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-43-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-43-4" +class="td11"> (as per HTML) </td> +</tr><tr + valign="baseline" id="TBL-15-44-"><td align="left" style="white-space:nowrap;" id="TBL-15-44-1" +class="td11"> <span +class="ectt-1000">validate </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-44-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-44-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-44-4" +class="td11"> JavaScript code to validate the entry </td> +</tr><tr + valign="baseline" id="TBL-15-45-"><td align="left" style="white-space:nowrap;" id="TBL-15-45-1" +class="td11"> <span +class="ectt-1000">value </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-45-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-45-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-45-4" +class="td11"> initial value </td> +</tr><tr + valign="baseline" id="TBL-15-46-"><td align="left" style="white-space:nowrap;" id="TBL-15-46-1" +class="td11"> <span +class="ectt-1000">width </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-46-2" +class="td11"> dimen </td><td align="left" style="white-space:nowrap;" id="TBL-15-46-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-46-4" +class="td11"> width of field box </td> +</tr><tr + valign="baseline" id="TBL-15-47-"><td align="left" style="white-space:nowrap;" id="TBL-15-47-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-15-48-"><td align="left" style="white-space:nowrap;" id="TBL-15-48-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-15-49-"><td align="left" style="white-space:nowrap;" id="TBL-15-49-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-15-50-"><td align="left" style="white-space:nowrap;" id="TBL-15-50-1" +class="td11"> </td> + </tr> + </table></div> + + +<!--l. 982--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-180007"></a>Defining a new driver</h3> +<!--l. 983--><p class="noindent">A hyperref driver has to provide definitions for eight macros: +<!--l. 986--><p class="noindent">1. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@anchor</span></span></span> +<!--l. 988--><p class="noindent">2. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@link</span></span></span> +<!--l. 990--><p class="noindent">3. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkfile</span></span></span> +<!--l. 992--><p class="noindent">4. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkurl</span></span></span> +<!--l. 994--><p class="noindent">5. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@anchorstart</span></span></span> +<!--l. 996--><p class="noindent">6. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@anchorend</span></span></span> +<!--l. 998--><p class="noindent">7. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkstart</span></span></span> +<!--l. 1000--><p class="noindent">8. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkend</span></span></span> +<!--l. 1003--><p class="indent"> The draft option defines the macros as follows + + + <table width="100%" +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. 1013--><p class="nopar"> +<!--l. 1015--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-190008"></a>Special support for other packages</h3> +<!--l. 1017--><p class="noindent"><span +class="ecss-1000">hyperref </span>aims to cooperate with other packages, but there are several possible sources for conflict, such +as +<!--l. 1020--><p class="indent"> + <ul class="itemize1"> + <li class="itemize">Packages that manipulate the bibliographic mechanism. Peter William’s <span +class="ecss-1000">harvard </span>package is + supported. However, the recommended package is Patrick Daly’s <span +class="ecss-1000">natbib </span>package that has + specific <span +class="ecss-1000">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="ecss-1000">hyperref</span>. + </li> + <li class="itemize">Packages that typeset the contents of the <span +class="ectt-1000">\label </span>and <span +class="ectt-1000">\ref </span>macros, such as <span +class="ecss-1000">showkeys</span>. Since + the <span +class="ecss-1000">hyperref </span>package redefines these commands, you must set <span +class="ectt-1000">implicit=false </span>for these + packages to work. + </li> + <li class="itemize">Packages that do anything serious with the index.</li></ul> +<!--l. 1037--><p class="indent"> The <span +class="ecss-1000">hyperref </span>package is distributed with variants on two useful packages designed to work especially +well with it. These are <span +class="ecss-1000">xr </span>and <span +class="ecss-1000">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="ectt-1000">\label/\ref</span></span></span> mechanisms and per-chapter tables of contents, respectively. +<!--l. 1043--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-200009"></a>History and acknowledgments</h3> +<!--l. 1045--><p class="noindent">The original authors of <span +class="ecss-1000">hyperbasics.tex </span>and <span +class="ecss-1000">hypertex.sty</span>, from which this package +descends, are Tanmoy Bhattacharya (<span +class="ectt-1000">tanmoy@qcd.lanl.gov</span>) and Thorsten Ohl +(<span +class="ectt-1000">thorsten.ohl@physik.th-darmstadt.de</span>). <span +class="ecss-1000">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="cmmi-10"><img +src="cmmi10-22.gif" alt="e" class="10x-x-22" /></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. 1059--><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="ectt-1000">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="ectt-1000">pragma@pi.net</span>) provided a lot of insight into +PDF. +<!--l. 1067--><p class="indent"> Berthold Horn provided help, encouragement and sponsorship for the <span +class="ecss-1000">dvipsone </span>and <span +class="ecss-1000">dviwindo </span>drivers. +Sergey Lesenko provided the changes needed for <span +class="ecss-1000">dvipdf</span>, and Hàn Thê' Thành supplied all +the information needed for <span +class="ecss-1000">pdftex</span>. Patrick Daly kindly updated his <span +class="ecss-1000">natbib </span>package to allow +easy integration with <span +class="ecss-1000">hyperref</span>. Michael Mehlich’s <span +class="ecss-1000">hyper </span>package (developed in parallel with +<span +class="ecss-1000">hyperref</span>) showed me solutions for some problems. Hopefully the two packages will combine one +day. +<!--l. 1076--><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="ecti-1000">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="ecss-1000">pdftex</span>. +<!--l. 1082--><p class="indent"> Steve Dandy recreated the manual source in July 2003 after it had been lost. +<!--l. 1085--><p class="indent"> Especial extra thanks to David Carlisle for the <span +class="ecss-1000">backref </span>module, the ps2pdf and dviwindo support, +frequent general rewrites of my bad code, and for working on changes to the <span +class="ecss-1000">xr </span>package to suit +<span +class="ecss-1000">hyperref</span>. + + + <h3 class="sectionHead"><span class="titlemark">10 </span> <a + id="x1-2100010"></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="cmsy-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-2200010"></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-2300010.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-2400010.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-2500010.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-2500010.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-2600010.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-2400010.2">10.2<!--tex4ht:ref: verbatim --></a> +and <a +href="#x1-2500010.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 type="1" class="enumerate1" > + <li class="enumerate" value="1" +><a + id="x1-26002x1"></a>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" value="2" +><a + id="x1-26004x2"></a>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" value="3" +><a + id="x1-26006x3"></a>State on the Title page the name of the publisher of the Modified Version, as the publisher. + + </li> + <li class="enumerate" value="4" +><a + id="x1-26008x4"></a>Preserve all the copyright notices of the Document. + </li> + <li class="enumerate" value="5" +><a + id="x1-26010x5"></a>Add an appropriate copyright notice for your modifications adjacent to the other copyright + notices. + </li> + <li class="enumerate" value="6" +><a + id="x1-26012x6"></a>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" value="7" +><a + id="x1-26014x7"></a>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" value="8" +><a + id="x1-26016x8"></a>Include an unaltered copy of this License. + </li> + <li class="enumerate" value="9" +><a + id="x1-26018x9"></a>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" value="10" +><a + id="x1-26020x10"></a>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" value="11" +><a + id="x1-26022x11"></a>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" value="12" +><a + id="x1-26024x12"></a>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" value="13" +><a + id="x1-26026x13"></a>Delete any section Entitled “Endorsements”. Such a section may not be included in the + Modified Version. + </li> + <li class="enumerate" value="14" +><a + id="x1-26028x14"></a>Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with + any Invariant Section. + </li> + <li class="enumerate" value="15" +><a + id="x1-26030x15"></a>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-2700010.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-2600010.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-2800010.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-2900010.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-2500010.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-3000010.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-2600010.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-2600010.4">10.4<!--tex4ht:ref: modifications --></a>) to Preserve its Title (section <a +href="#x1-2300010.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-3100010.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-3200010.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-3300010.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="cmsy-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> + + + + |