From 4d027ddb699c57025992eccbdd3cef0ec2836ee1 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 1 Jun 2007 16:58:52 +0000 Subject: hyperref update (30may07) git-svn-id: svn://tug.org/texlive/trunk@4399 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/hyperref/ChangeLog | 78 + Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf | Bin 271517 -> 276174 bytes Master/texmf-dist/doc/latex/hyperref/README | 32 +- Master/texmf-dist/doc/latex/hyperref/README.pdf | Bin 255229 -> 257594 bytes Master/texmf-dist/doc/latex/hyperref/hyperref.pdf | Bin 2968830 -> 3130477 bytes Master/texmf-dist/doc/latex/hyperref/manual.css | 14 +- Master/texmf-dist/doc/latex/hyperref/manual.html | 3250 ++++++++++---------- Master/texmf-dist/doc/latex/hyperref/manual.pdf | Bin 447913 -> 483321 bytes Master/texmf-dist/doc/latex/hyperref/manual2.html | 4 +- Master/texmf-dist/doc/latex/hyperref/manual3.html | 10 +- Master/texmf-dist/doc/latex/hyperref/options.pdf | Bin 42064 -> 42058 bytes 11 files changed, 1760 insertions(+), 1628 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog b/Master/texmf-dist/doc/latex/hyperref/ChangeLog index 00a9e930fd2..847aeb22970 100644 --- a/Master/texmf-dist/doc/latex/hyperref/ChangeLog +++ b/Master/texmf-dist/doc/latex/hyperref/ChangeLog @@ -1,3 +1,81 @@ +2007-05-29 6.76g Heiko Oberdiek + * The color of launch annotations are set by options + `runcolor' and `runbordercolor'. (Previously `filecolor' + was used.) + * Support for package `showkeys' added for \autoref. + * Fix for line breaks right after \url or \href. + * nameref 2.31: Support for caption of package `listings'. + * nameref 2.31: Some fixes in \NR@@vpageref. + +2007-05-09 6.76f Heiko Oberdiek + * Use of package `etexcmds' for \unexpanded. + +2007-05-03 6.76e Heiko Oberdiek + * hyperref: ConTeXt's base/syst-gen.tex redefines e-TeX's \unexpanded. + * Some support for amsmath's environment `subequations'. + * nameref 2.30: \label is supported after longtable's \caption. + +2007-04-25 6.76d Heiko Oberdiek + * 6.76d + * Option dvipdfmx-outline-open/\SpecialDvipdfmxOutlineOpen + adjusted to new CVS version of dvipdfmx. + +2007-04-18 6.76c Heiko Oberdiek + * 6.76c + * Fix for star forms of \ref commands. + * Fixes for \autopageref. + +2007-04-11 6.76b Heiko Oberdiek + * 6.76b + * Line end cleanup, removal of spaces. + * Minor fixes in form part. + +2007-04-09 6.76a Heiko Oberdiek + * 6.76a + * Color options implemented by package `hycolor'. + * pdfborder: Patch for ghostscript added to remove resolution + dependency. Unclear is the behaviour of Acrobat Distiller, + dvipsone, and textures. + The values for pdfborder should be specified in the way + they should appear in the PDF file. Default: pdborder={0 0 1} + * \autopageref added. + * New field option `rotation' added. + * Field options bordercolor and backgroundcolor: + * An empty value is permitted. + * If the value does not start with a number ('0', '1', '.'), + then it is processed as xcolor specification. + * Fix for drivers dvipdfm/pdfmark: launch annotation now uses + `runbordercolor' instead of `filebordercolor'. + * PD1 encoding: Replacements for older AR versions removed: + \l, \L, \v z, \v Z, \i, \textfractionmark, \textfi, \textfl + * \pdfstringdef: a little faster. + * \href followed by `%' and line break works now. + * Option dvipdfmx-outline-open or \chardef\SpecialDvipdfmxOutlineOpen=1 + enables support for open outline entries + (dvipdfmx, since cvs version 2007-03-29). + Caution: this feature is experimental and can change. + * Italian translation of \autoref names added (Cristian Battaglia). + * Support for \greeknumeral and \Greeknumeral in Bookmarks + (with option unicode). + * Replacement for \greeknumeral and \Greeknumeral in anchor names. + * pdfmark: Destinations without rectangle (D.P.Story) + * Fixes for fancybox. + * Fixes for chapterbib (Donald Arsenau). + * Some support for Spanish shorthands in bookmarks added. + * varioref (hyperref + nameref): + * Support for \Ref and \Vref. + * \vref puts the whole reference text in a link. + * Fix for babel shorthand characters. + * Small fixes for undefined references. + * tex4ht: \hyperlinkfileprefix{} added (Eitan Gurari). + * Some support for hypcap added (idea of Axel Sommerfeldt). + * Unused form field option `fillcolor' removed. + * Unused option `pagecolor' removed. + * Practically unused option `pagebordercolor' removed. + * \PDFPage removed, because it's undocumented, is not + free from errors and is not supported by all drivers. + * nameref 2.29: beamer support added. + 2007-02-27 6.75t Heiko Oberdiek * 6.75t * Suppressing links with empty link area. diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf index ec845102532..dd0f1076485 100644 Binary files a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf and b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf differ diff --git a/Master/texmf-dist/doc/latex/hyperref/README b/Master/texmf-dist/doc/latex/hyperref/README index 9e1883aa968..bf8971f335f 100644 --- a/Master/texmf-dist/doc/latex/hyperref/README +++ b/Master/texmf-dist/doc/latex/hyperref/README @@ -138,6 +138,10 @@ apart from nameref and backref: 5 NEW FEATURES ============== +Color options/package hycolor +----------------------------- + See documentation of package `hycolor'. + Option pdfusetitle ------------------ If option pdfusetitle is set then hyperref tries to @@ -409,6 +413,14 @@ bibentry \nobibliography{database} \endgroup +chappg +------ + Package chappg uses \@addtoreset that is redefined by hyperref. + The package order is therefore: + + \usepackage{hyperref} + \usepackage{chappg} + cite ---- This is from Mike Shell: @@ -596,12 +608,18 @@ titlesec varioref -------- - \usepackage{nameref} - \usepackage{varioref} - \usepackage{hyperref} - Some babel versions (eg. 2005/05/21 v3.8g) contain a patch for - varioref that breaks the hyperref support for varioref. - Thus with babel v3.8g varioref cannot be used with hyperref. + There are too many problems with varioref. Nobody has time to + sort them out. Therefore this package is now unsupported. + + Perhaps you are lucky and some of the features of varioref works + with the following loading order: + \usepackage{nameref} + \usepackage{varioref} + \usepackage{hyperref} + + Also some babel versions can be problematic. For exmample, + 2005/05/21 v3.8g contains a patch for varioref that breaks + the hyperref support for varioref. Also unsupported: * \Ref, \Vref do not uppercase the first letter. @@ -717,6 +735,8 @@ Index with makeindex \newcommand*{\main}[1]{\textbf{\hyperpage{#1}}} ... \index{Some example|main} + * Scientic Word/Scientific WorkPlace users can use + package robustindex with hyperindex=false. * Other encap characters can be set by option "encap". Example for use of "?": \usepackage[encap=?]{hyperref} diff --git a/Master/texmf-dist/doc/latex/hyperref/README.pdf b/Master/texmf-dist/doc/latex/hyperref/README.pdf index 17dc73108d2..75652968275 100644 Binary files a/Master/texmf-dist/doc/latex/hyperref/README.pdf and b/Master/texmf-dist/doc/latex/hyperref/README.pdf differ diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf b/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf index 948a2488730..481a1a59452 100644 Binary files a/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf and b/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf differ diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.css b/Master/texmf-dist/doc/latex/hyperref/manual.css index 4ce2a0d94c5..fb451e7adeb 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual.css +++ b/Master/texmf-dist/doc/latex/hyperref/manual.css @@ -2,13 +2,13 @@ /* start css.sty */ .cmmi-10{font-style: italic;} .cmsy-7{font-size:70%;} -.ecrm-1728{font-size:170%;} -.ecss-1728{font-size:170%; font-family: sans-serif;} -.ecrm-1200{font-size:120%;} -.ectt-1000{ font-family: monospace;} -.ecti-1000{ font-style: italic;} -.ecss-1000{ font-family: sans-serif;} -.ecbx-1000{ font-weight: bold;} +.cork-lmr-17{font-size:170%;} +.cork-lmss-17{font-size:170%;font-family: sans-serif;} +.cork-lmr-12{font-size:120%;} +.cork-lmtt-10{font-family: monospace;} +.cork-lmri-10{ font-style:italic;} +.cork-lmss-10{font-family: sans-serif;} +.cork-lmbx-10{font-weight: bold;} .htf-cmbx {font-weight: bold; font-style:normal;} p.noindent { text-indent: 0em } p.nopar { text-indent: 0em; } diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.html b/Master/texmf-dist/doc/latex/hyperref/manual.html index c1ed635de52..65094174a59 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual.html @@ -7,7 +7,7 @@ - + @@ -19,11 +19,11 @@

Hypertext marks in LATEX: a manual for hyperref

Sebastian Rahtz
Heiko Oberdiek
+class="cork-lmr-12">Sebastian Rahtz
Heiko Oberdiek
September 2006
+class="cork-lmr-12">September 2006

Contents

@@ -37,13 +37,13 @@ href="#x1-40003" id="QQ2-1-4">Package options
 3.1 General options
 3.2 Configuration options +href="#x1-60003.2" id="QQ2-1-6">Configuration options
 3.3 Backend drivers
 3.4 Extension options
 3.5 PDF-specific display options +href="#x1-90003.5" id="QQ2-1-9">PDF-specific display options
 3.6 PDF display and information options
 3.7 Replacement macros
 4.2 Utility macros
5 Acrobat-specific behavior +href="#x1-150005" id="QQ2-1-15">Acrobat-specific behavior
6 PDF and HTML forms
 6.1 Forms environment parameters
 6.2 Forms optional parameters
7 Defining a new driver +href="#x1-190007" id="QQ2-1-19">Defining a new driver
8 Special support for other packages
9 History and acknowledgments
10 GNU Free Documentation License
 10.1 Applicability and definitions +href="#x1-2400010.1" id="QQ2-1-24">Applicability and definitions
 10.2 Verbatim copying
 10.3 Copying in quantity
 10.4 Modifications +href="#x1-2700010.4" id="QQ2-1-27">Modifications
 10.5 Combining documents
 10.6 Future revisions of this license -

+

1 Introduction

-

The package derives from, and builds on, the work of the HyperT

The package derives from, and builds on, the work of the HyperTEX project, described at http://xxx.lanl.gov/hypertex/. It extends the functionality of all the LAThttp://xxx.lanl.gov/hypertex/. It extends the functionality of all the LATEX cross-referencing commands (including the table of contents, bibliographies etc) to produce \special commands which a +class="cork-lmtt-10">\special commands which a driver can turn into hypertext links; it also provides new commands to allow the user to write ad hoc +class="cork-lmri-10">ad hoc hypertext links, including those to external documents and URLs. -

This manual provides a brief overview of the hyperref package. For more details, you should read the +

This manual provides a brief overview of the hyperref package. For more details, you should read the additional documentation distributed with the package, as well as the complete documentation by processing hyperref.dtx. You should also read the chapter on hyperref in The LAThyperref.dtx. You should also read the chapter on hyperref in The LATEX Web Companion, -where you will find additional examples. -

The HyperTEX specificationEX Web +Companion, where you will find additional examples. +

The HyperTEX specification1 says that conformant viewers/translators must recognize the following set of \special constructs: +class="cork-lmtt-10">\special constructs:

href:
href:
html:<a href = "href_string"> +class="cork-lmtt-10">html:<a href = "href_string">
name:
name:
html:<a name = "name_string"> +class="cork-lmtt-10">html:<a name = "name_string">
end:
end:
html:</a> +class="cork-lmtt-10">html:</a>
image:
image:
html:<img src = "href_string"> +class="cork-lmtt-10">html:<img src = "href_string">
base_name:
base_name:
html:<base href = "href_string">
-

The href, name and end commands are used to do the basic hypertext operations of establishing links +class="cork-lmtt-10">html:<base href = "href_string"> +

The href, name and end commands are used to do the basic hypertext operations of establishing links between sections of documents. The image command is intended (as with current HTML +class="cork-lmri-10">image command is intended (as with current HTML viewers) to place an image of arbitrary graphical format on the page in the current location. The base_name 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 +class="cork-lmri-10">base_name 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. -

The href and name commands must be paired with an end command later in the TEX file—the +

The href and name commands must be paired with an end command later in the TEX file—the TEX commands between the two ends of a pair form an anchor in the document. In the case of an href +class="cork-lmri-10">anchor in the document. In the case of an href command, the anchor is to be highlighted in the DVI viewer, and when clicked on will cause the scene to -shift to the destination specified by href_string. The anchor associated with a name command +class="cork-lmri-10">anchor is to be highlighted in the DVI viewer, and when clicked on will cause the scene to +shift to the destination specified by href_string. The anchor associated with a name command represents a possible location to which other hypertext links may refer, either as local references (of the form href="#name_string" with the name_string identical to the one in the name +class="cork-lmtt-10">href="#name_string" with the name_string identical to the one in the name command) or as part of a URL (of the form URL#name_string). Here href_string is a valid URL -or local identifier, while name_string could be any string at all: the only caveat is that ‘"’ +class="cork-lmri-10">URL#name_string). Here href_string is a valid URL +or local identifier, while name_string could be any string at all: the only caveat is that ‘"’ characters should be escaped with a backslash (\), and if it looks like a URL name it may cause problems. -

However, the drivers intended to produce only PDF use literal PostScript or PDF \special -commands. The commands are defined in configuration files for different drivers, selected by package +

However, the drivers intended to produce only PDF use literal PostScript or PDF \special +commands. The commands are defined in configuration files for different drivers, selected by package options; at present, the following drivers are supported:

hypertex
hypertex
DVI processors conforming to the HyperTEX guidelines (i.e. xdvi, dvips (with the -z +class="cork-lmss-10">xdvi, dvips (with the -z option), OzTeX, and Textures) +class="cork-lmss-10">OzTeX, and Textures)
dvips
dvips
produces \special commands tailored for dvips +class="cork-lmtt-10">\special commands tailored for dvips
dvipsone
dvipsone
produces \special commands tailored for dvipsone +class="cork-lmtt-10">\special commands tailored for dvipsone
ps2pdf
ps2pdf
a special case of output suitable for processing by earlier versions of Ghostscript’s PDF writer; this is basically the same as that for dvips, but a few variations remained before +class="cork-lmss-10">dvips, but a few variations remained before version 5.21
tex4ht
tex4ht
produces \special commands for use with T\special commands for use with TEX4ht +class="cork-lmss-10">EX4ht
pdftex
pdftex
pdfTEX, Hàn Thê' Thành’s TEX, Hàn Thêˊ Thành’s TEX variant that writes PDF directly
dvipdfm
dvipdfm
produces \special commands for Mark Wicks’ DVI to PDF driver dvipdfm +class="cork-lmtt-10">\special commands for Mark Wicks’ DVI to PDF driver dvipdfm
dvipdfmx
dvipdfmx
produces \special commands for driver dvipdfmx, a successor of dvipdfm +class="cork-lmtt-10">\special commands for driver dvipdfmx, a successor of dvipdfm
dviwindo
dviwindo
produces \special commands that Y&Y’s Windows previewer interprets as hypertext +class="cork-lmtt-10">\special commands that Y&Y’s Windows previewer interprets as hypertext jumps within the previewer
vtex
vtex
produces \special commands that MicroPress’ HTML and PDF-producing T\special commands that MicroPress’ HTML and PDF-producing TEX variants interpret as hypertext jumps within the previewer
textures
textures
produces \special commands that Textures interprets as hypertext jumps within the +class="cork-lmtt-10">\special commands that Textures interprets as hypertext jumps within the previewer
xetex
xetex
produces \special commands for XeT\special commands for XeTEX
-

Output from dvips or dvipsone must be processed using Acrobat Distiller to obtain a PDF -file.

Output from dvips or dvipsone must be processed using Acrobat Distiller to obtain a PDF +file.2 The result is generally preferable to that produced by using the hypertex driver, and then +class="cork-lmss-10">hypertex driver, and then processing with dvips -z, but the DVI file is not portable. The main advantage of using the +class="cork-lmss-10">dvips -z, but the DVI file is not portable. The main advantage of using the HyperTEX \special commands is that you can also use the document in hypertext DVI viewers, such +class="cork-lmtt-10">\special commands is that you can also use the document in hypertext DVI viewers, such as xdvi. +class="cork-lmss-10">xdvi.

2 Implicit behavior

-

This package can be used with more or less any normal LAT

This package can be used with more or less any normal LATEX document by specifying in the -document preamble +document preamble
\usepackage{hyperref}
-

-

Make sure it comes last of your loaded packages, to give it a fighting chance of not being over-written, -since its job is to redefine many LATEX commands. Hopefully you will find that all cross-references +

+

Make sure it comes last of your loaded packages, to give it a fighting chance of not being over-written, +since its job is to redefine many LATEX commands. Hopefully you will find that all cross-references work correctly as hypertext. For example, \section commands will produce a bookmark and a +class="cork-lmtt-10">\section commands will produce a bookmark and a link, whereas \section* commands will only show links when paired with a corresponding +class="cork-lmtt-10">\section* commands will only show links when paired with a corresponding \addcontentsline command. -

In addition, the hyperindex option (see below) attempts to make items in the index by hyperlinked +class="cork-lmtt-10">\addcontentsline command. +

In addition, the hyperindex option (see below) attempts to make items in the index by hyperlinked back to the text, and the option backref inserts extra ‘back’ links into the bibliography for each entry. +class="cork-lmtt-10">backref 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, colorlinks, as its name well implies, colors the links instead of using boxes; this is the option used in +class="cork-lmtt-10">colorlinks, as its name well implies, colors the links instead of using boxes; this is the option used in this document. -

+

3 Package options

-

All user-configurable aspects of hyperref are set using a single ‘key=value’ scheme (using the keyval +

All user-configurable aspects of hyperref are set using a single ‘key=value’ scheme (using the keyval package) with the key Hyp. The options can be set either in the optional argument to the +class="cork-lmtt-10">Hyp. The options can be set either in the optional argument to the \usepackage command, or using the \hypersetup macro. When the package is loaded, a file +class="cork-lmtt-10">\usepackage command, or using the \hypersetup macro. When the package is loaded, a file hyperref.cfg is read if it can be found, and this is a convenient place to set options on a site-wide +class="cork-lmtt-10">hyperref.cfg is read if it can be found, and this is a convenient place to set options on a site-wide basis. -

As an example, the behavior of a particular file could be controlled by: +

As an example, the behavior of a particular file could be controlled by:

-

Some options can be given at any time, but many are restricted: before \begin{document}, only in +

+

Some options can be given at any time, but many are restricted: before \begin{document}, only in \usepackage[...]{hyperref}, before first use, etc. -

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, +class="cork-lmtt-10">\usepackage[...]{hyperref}, before first use, etc. +

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. -

+

3.1 General options

-

Firstly, the options to specify general behavior and page size. -

+

Firstly, the options to specify general behavior and page size. +

+class="cork-lmri-10">false +class="td11"> the log file
draft draft boolean false all hypertext options are turned off all hypertext options are turned off
final final boolean true true all hypertext options are turned on
debug debug boolean false false extra diagnostic messages are printed in
the log file
verbose verbose boolean false false same as debug
implicit implicit boolean true redefines LATtrue redefines LATEX internals
hypertexnames hypertexnames boolean true true use guessable names for links
naturalnames naturalnames boolean false false use LATEX-computed names for links
a4paper a4paper boolean true true sets paper size to 210mm × 297mm
a5paper a5paper boolean false false sets paper size to 148mm × 210mm
b5paper b5paper boolean false false sets paper size to 176mm × 250mm
letterpaper letterpaper boolean false false sets paper size to 8.5in × 11in
legalpaper legalpaper boolean false false sets paper size to 8.5in × 14in
executivepaper executivepaper boolean false false sets paper size to 7.25in × 10.5in
setpagesize setpagesize boolean true true sets page size by special driver commands
-

+

3.2 Configuration options

-

+ id="x1-60003.2">Configuration options +

+ different PDF links to the same target.
raiselinks raiselinks boolean true true -

In the hypertex driver, the height of links is +

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 \special commands to reflect the real +class="cork-lmtt-10">\special commands to reflect the real height of the link (which could contain a graphic)

breaklinks breaklinks boolean false false -

Allows link text to break across lines; since +

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.

pageanchor pageanchor boolean true true -

Determines whether every page is given an +

Determines whether every page is given an implicit anchor at the top left corner. If this is - turned off, \printindex will not contain valid + turned off, \printindex will not contain valid hyperlinks.

plainpages plainpages boolean false false -

Forces page anchors to be named by the arabic +

Forces page anchors to be named by the arabic form of the page number, rather than the formatted form.

nesting nesting boolean false false -

Allows links to be nested; no drivers currently +

Allows links to be nested; no drivers currently support this.

-

Note for option breaklinks: The correct value is automatically set according to the driver features. +

Note for option breaklinks: The correct value is automatically set according to the driver features. It can be overwritten for drivers that do not support broken links. However, at any case, the link area will be wrong and displaced. -

+

3.3 Backend drivers

-

If no driver is specified, the package defaults to loading the hypertex driver. -

+

If no driver is specified, the package defaults to loading the hypertex driver. +

+

Sets up hyperref for use with the dvipdfm driver.

+

Sets up hyperref for use with the dvipdfmx driver.

+

Sets up hyperref for use with the dvips driver.

+

Sets up hyperref for use with the dvipsone driver.

+

Sets up hyperref for use with the dviwindo Windows previewer.

+

Redefines a few macros for compatibility with latex2html.

+

An alias for dvips

+

An alias for dvips

+

Sets up hyperref for use with the pdftex program.

+class="cork-lmss-10">dvips. +class="cork-lmss-10">EX4ht +

For use with Textures

+

For use with VTeX’s PostScript backend.

class="td11">
dvipdfm dvipdfm -

Sets up hyperref for use with the dvipdfm driver.

dvipdfmx dvipdfmx -

Sets up hyperref for use with the dvipdfmx driver.

dvips dvips -

Sets up hyperref for use with the dvips driver.

dvipsone dvipsone -

Sets up hyperref for use with the dvipsone driver.

dviwindo dviwindo -

Sets up hyperref for use with the dviwindo Windows previewer.

hypertex hypertex -

Sets up hyperref for use with the HyperT

Sets up hyperref for use with the HyperTEX-compliant drivers.

latex2html latex2html -

Redefines a few macros for compatibility with latex2html.

nativepdf nativepdf -

An alias for dvips

pdfmark pdfmark -

An alias for dvips

pdftex pdftex -

Sets up hyperref for use with the pdftex program.

ps2pdf ps2pdf -

Redefines a few macros for compatibility with Ghostscript’s PDF writer, +

Redefines a few macros for compatibility with Ghostscript’s PDF writer, otherwise identical to dvips.

tex4ht tex4ht -

For use with T

For use with TEX4ht

textures textures -

For use with Textures

vtex vtex -

For use with MicroPress’ VTeX; the PDF and HTML backends are detected +

For use with MicroPress’ VTeX; the PDF and HTML backends are detected automatically.

vtexpdfmark vtexpdfmark -

For use with VTeX’s PostScript backend.

xetex xetex -

For use with XeT

For use with XeTEX(using backend for dvipdfm).

-

If you use dviwindo, you may need to redefine the macro \wwwbrowser (the default is +

If you use dviwindo, you may need to redefine the macro \wwwbrowser (the default is C:\netscape\netscape) to tell dviwindo what program to launch. Thus, users of Internet Explorer might +class="cork-lmtt-10">C:\netscape\netscape) to tell dviwindo what program to launch. Thus, users of Internet Explorer might add something like this to hyperref.cfg: @@ -823,13 +824,13 @@ class="verbatim">

 
  Internet\string\iexplore.exe}
-

-

+

+

3.4 Extension options

-

+

+class="cork-lmss-10">xr package. +

+class="cork-lmtt-10">\bibitem. +class="cork-lmtt-10">pageanchor, ...) +class="cork-lmtt-10">pageanchorsand plainpages=false. + broken ... +

Sets encap character for hyperindex

@@ -946,89 +947,89 @@ class="td11"> +

Color for normal internal links.

+

Color for anchor text.

+

Color for URLs which open local files.

+

Color for Acrobat menu items.

+

Color for run links (launch + annotations).

extension extension text -

Set the file extension (e.g. dvi) which - will be appended to file links created if +

Set the file extension (e.g. dvi) which + will be appended to file links created if you use the xr package.

hyperfigures hyperfigures boolean -

backref backref boolean false false -

Adds ‘backlink’ text to the end of each +

Adds ‘backlink’ text to the end of each item in the bibliography, as a list of section numbers. This can only work properly if there is a blank line after +class="cork-lmri-10">if there is a blank line after each \bibitem.

pagebackref pagebackref boolean false false -

Adds ‘backlink’ text to the end of each +

Adds ‘backlink’ text to the end of each item in the bibliography, as a list of page numbers.

hyperindex hyperindex boolean true true -

Makes the page numbers of index +

Makes the page numbers of index entries into hyperlinks. Relays on unique page anchors (pageanchor, . . . )

pageanchors and plainpages=false.
hyperfootnotes hyperfootnotes boolean true true -

Makes the footnote marks into +

Makes the footnote marks into hyperlinks to the footnote text. Easily - broken . . .

encap encap -

Sets encap character for hyperindex

linktocpage linktocpage boolean false false -

make page number, not text, be link on +

make page number, not text, be link on TOC, LOF and LOT

breaklinks breaklinks boolean false false -

allow links to break over lines by +

allow links to break over lines by making links over multiple lines into PDF links to the same target

colorlinks colorlinks boolean false false -

Colors the text of links and anchors. +

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, + references, URLs, local file references, and other links.

linkcolor linkcolor color red red -

Color for normal internal links.

anchorcolor anchorcolor color black black -

Color for anchor text.

citecolor citecolor color green green -

Color for bibliographical citations in +

Color for bibliographical citations in text.

filecolor filecolor color magenta magenta -

Color for URLs which open local files.

menucolor menucolor color red red -

Color for Acrobat menu items.

pagecolor runcolor color red filecolor -

Color for links to other pages, but - currently unused.

urlcolor urlcolor color cyan cyan

Color for linked URLs.

frenchlinks frenchlinks boolean false false

use small caps instead of color for links

-

Note that all color names must be defined before use, following the normal system of the standard +

Note that all color names must be defined before use, following the normal system of the standard LATEX color package. +class="cork-lmss-10">color package.

3.5 PDF-specific display options

+ id="x1-90003.5">PDF-specific display options

+class="cork-lmtt-10">\let\WriteBookmarks\relax +class="cork-lmtt-10">\maxdimen) to which bookmarks are open +

to specify which ‘toc’ file to mimic

+

The color of the box around links to files

+

The color of the box around links to URLs

+

color of border around ‘run’ links

- - - + + -
bookmarks bookmarks boolean true true

A set of Acrobat bookmarks are written, in a manner similar to the table of contents, requiring - two passes of LATEX. Some postprocessing of - the bookmark file (file extension .out) may + two passes of LATEX. Some postprocessing of + the bookmark file (file extension .out) may be needed to translate LATEX codes, since bookmarks must be written in PDFEncoding. To aid this process, the .out file is not rewritten +class="cork-lmtt-10">.out file is not rewritten by LATEX if it is edited to contain a line \let\WriteBookmarks\relax

bookmarksopen bookmarksopen boolean false false

If Acrobat bookmarks are requested, show them with all the subtrees expanded.

bookmarksopenlevel bookmarksopenlevel parameter

level (\maxdimen) to which bookmarks are open

bookmarksnumbered bookmarksnumbered boolean false false

If Acrobat bookmarks are requested, include section numbers.

bookmarkstype text bookmarkstype text toc toc -

to specify which ‘toc’ file to mimic

CJKbookmarks CJKbookmarks boolean false false

This option should be used to produce CJK bookmarks. Package hyperref supports both +class="cork-lmtt-10">hyperref supports both normal and preprocessed mode of the CJK package; during the creation of bookmarks, it simply replaces CJK’s macros with special versions which expand to the corresponding character codes. Note that without the ‘unicode’ - option of hyperref you get PDF files which - actually violate the PDF specification because + option of hyperref you get PDF files which + actually violate the PDF specification because non-Unicode character codes are used – some PDF readers localized for CJK languages (most notably Acroread itself) support this. Also note @@ -1156,118 +1157,108 @@ class="ectt-1000">hyperref supports both

pdfhighlight pdfhighlight name /I /I

How link buttons behave when selected; /I is for inverse (the default); the other possibilities - are /N (no effect), /O (outline), and /P (inset + are /N (no effect), /O (outline), and /P (inset highlighting).

citebordercolor citebordercolor RGB color 0 1 0 0 1 0

The color of the box around citations

filebordercolor filebordercolor RGB color 0 .5 .5 0 .5 .5 -

The color of the box around links to files

linkbordercolor linkbordercolor RGB color 1 0 0 1 0 0

The color of the box around normal links

menubordercolor menubordercolor RGB color 1 0 0 1 0 0

The color of the box around Acrobat menu links

pagebordercolor urlbordercolor RGB color 1 1 0 0 1 1 -

The color of the box around links to pages

urlbordercolor runbordercolor RGB color 0 1 1 0 .7 .7 -

The color of the box around links to URLs

runbordercolor RGB color pdfborder 0 .7 .7 0 0 1 -

color of border around ‘run’ links

pdfborder 0 0 1 -

The style of box around links; defaults to a box +

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.

-

Note that the color of link borders can be specified only as 3 numbers in the range 0..1, giving an -RGB color. You cannot use colors defined in T

Note that the color of link borders can be specified only as 3 numbers in the range 0..1, giving an +RGB color. You cannot use colors defined in TEX. -

The bookmark commands are stored in a file called jobname.out. The files is not processed by +

The bookmark commands are stored in a file called jobname.out. The files is not processed by LATEX so any markup is passed through. You can postprocess this file as needed; as an aid +class="E">EX so any markup is passed through. You can postprocess this file as needed; as an aid for this, the .out file is not overwritten on the next T.out file is not overwritten on the next TEX run if it is edited to contain the line
@@ -1279,13 +1270,13 @@ class="verbatim">

\let\WriteBookmarks\relax
-

-

+

+

3.6 PDF display and information options

-

+

+class="cork-lmtt-10">UseOutlines is used. +

Sets the document information Title + field

+

Sets the document information Author + field

+

Sets the document information Subject + field

+

Sets the document information Creator + field

+

Sets the document information + Producer field

+

Sets the document information + Keywords field

+

Set the startup page view

+

direction setting

+

paper handling option for print dialog

+

resize document window to fit + document size

+

PDF language identifier (RFC 3066)

+

make PDF viewer’s menu bar visible

+

number of printed copies

+

set layout of PDF pages

+

set PDF page labels

+

set PDF page transition style

+

set option for print dialog

+

set /PrintArea of viewer preferences

+

set /PrintClip of viewer preferences

+class="cork-lmtt-10">None and AppDefault +

make PDF toolbar visible

+

set /ViewArea of viewer preferences

+

set /ViewClip of viewer preferences

+

Unicode encoded PDF strings

@@ -1655,28 +1646,28 @@ class="td11"> class="td11">
baseurl baseurl URL -

Sets the base URL of the PDF +

Sets the base URL of the PDF document

pdfpagemode pdfpagemode text empty empty -

Determines how the file is +

Determines how the file is opening in Acrobat; the possibilities are None, UseThumbs (show thumbnails), +class="cork-lmtt-10">None, UseThumbs (show thumbnails), UseOutlines (show bookmarks), and +class="cork-lmtt-10">UseOutlines (show bookmarks), and FullScreen. If no mode if explicitly +class="cork-lmtt-10">FullScreen. If no mode if explicitly chosen, but the bookmarks option is set, UseOutlines is used.

pdftitle pdftitle text -

Sets the document information Title - field

pdfauthor pdfauthor text -

Sets the document information Author - field

pdfsubject pdfsubject text -

Sets the document information Subject - field

pdfcreator pdfcreator text -

Sets the document information Creator - field

pdfproducer pdfproducer text -

Sets the document information - Producer field

pdfkeywords pdfkeywords text -

Sets the document information - Keywords field

pdfview pdfview text XYZ XYZ -

Sets the default PDF ‘view’ for each +

Sets the default PDF ‘view’ for each link

pdfstartpage pdfstartpage text 1 1 -

Determines on which page the PDF file +

Determines on which page the PDF file is opened.

pdfstartview pdfstartview text Fit Fit -

Set the startup page view

pdfpagescrop pdfpagescrop n n n n -

Sets the default PDF crop box for +

Sets the default PDF crop box for pages. This should be a set of four numbers

pdfcenterwindow pdfcenterwindow boolean false false -

position the document window in the +

position the document window in the center of the screen

pdfdirection pdfdirection text empty empty -

direction setting

pdfdisplaydoctitle pdfdisplaydoctitle boolean false false -

display document title instead of file +

display document title instead of file name in title bar

pdfduplex pdfduplex text empty empty -

paper handling option for print dialog

pdffitwindow pdffitwindow boolean false false -

resize document window to fit - document size

pdflang pdflang text empty empty -

PDF language identifier (RFC 3066)

pdfmenubar pdfmenubar boolean true true -

make PDF viewer’s menu bar visible

pdfnewwindow pdfnewwindow boolean false false -

make links that open another PDF file +

make links that open another PDF file start a new window

pdfnonfullscreenpagemode pdfnonfullscreenpagemode boolean empty empty -

page mode setting on exiting full-screen +

page mode setting on exiting full-screen mode

pdfnumcopies pdfnumcopies integer empty empty -

number of printed copies

pdfpagelayout pdfpagelayout text empty empty -

set layout of PDF pages

pdfpagelabels pdfpagelabels boolean true true -

set PDF page labels

pdfpagetransition pdfpagetransition text empty empty -

set PDF page transition style

pdfpicktrackbypdfsize pdfpicktrackbypdfsize text empty empty -

set option for print dialog

pdfprintarea pdfprintarea text empty empty -

set /PrintArea of viewer preferences

pdfprintclip pdfprintclip text empty empty -

set /PrintClip of viewer preferences

pdfprintpagerange pdfprintpagerange n n (n n)* empty empty -

set /PrintPageRange of viewer +

set /PrintPageRange of viewer preferences

pdfprintscaling pdfprintscaling text empty empty -

page scaling option for print dialog; +

page scaling option for print dialog; valid values are None and AppDefault

pdftoolbar pdftoolbar boolean true true -

make PDF toolbar visible

pdfviewarea pdfviewarea text empty empty -

set /ViewArea of viewer preferences

pdfviewclip pdfviewclip text empty empty -

set /ViewClip of viewer preferences

pdfwindowui pdfwindowui boolean true true -

make PDF user interface elements +

make PDF user interface elements visible

unicode unicode boolean false false -

Unicode encoded PDF strings

-

Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, +

Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, which is not the same as TEX’s. The unit is bp and the origin is in the lower left corner. See also \hypercalcbp that is explained on page 33. pdfT\hypercalcbp that is explained on page 34. pdfTEX works by supplying default values for XYZ (horizontal XYZ (horizontal × vertical × zoom) and FitBH. However, drivers using pdfmark do +class="cork-lmtt-10">FitBH. However, drivers using pdfmark do not supply defaults, so hyperref passes in a value of -32768, which causes Acrobat to set +class="cork-lmss-10">hyperref passes in a value of -32768, which causes Acrobat to set (usually) sensible defaults. The following are possible values for the pdfview and pdfstartview +class="cork-lmtt-10">pdfview and pdfstartview parameters. -

+

+

Fits the page to the window.

+

Fits the width of the page to the window.

+

Fits the height of the page to the window.

+

Fits the page bounding box to the window.

XYZ XYZ left top zoom left top zoom -

Sets a coordinate and a zoom factor. If any one +

Sets a coordinate and a zoom factor. If any one is null, the source link value is used. null null +class="cork-lmri-10">null null null will give the same values as the current +class="cork-lmri-10">null will give the same values as the current page.

Fit Fit -

Fits the page to the window.

FitH FitH top top -

Fits the width of the page to the window.

FitV FitV left left -

Fits the height of the page to the window.

FitR FitR left bottom right top left bottom right top -

Fits the rectangle specified by the four +

Fits the rectangle specified by the four coordinates to the window.

FitB FitB -

Fits the page bounding box to the window.

FitBH FitBH top top -

Fits the width of the page bounding box to +

Fits the width of the page bounding box to the window.

FitBV FitBV left left -

Fits the height of the page bounding box to +

Fits the height of the page bounding box to the window.

-

The pdfpagelayout can be one of the following values. -

+

The pdfpagelayout can be one of the following values. +

+

Displays a single page; advancing flips the page

+

Displays the document in one column; continuous scrolling.

class="td11">
SinglePage SinglePage -

Displays a single page; advancing flips the page

OneColumn OneColumn -

Displays the document in one column; continuous scrolling.

TwoColumnLeft TwoColumnLeft -

Displays the document in two columns, odd-numbered pages to +

Displays the document in two columns, odd-numbered pages to the left.

TwoColumnRight TwoColumnRight -

Displays the document in two columns, odd-numbered pages to +

Displays the document in two columns, odd-numbered pages to the right.

-

Finally, the pdfpagetransition can be one of the following values, where /Di stands for direction of +

Finally, the pdfpagetransition can be one of the following values, where /Di stands for direction of motion in degrees, generally in 90o steps, /Dm is a horizontal (/H) or vertical (/V) dimension +class="cork-lmri-10">/Dm is a horizontal (/H) or vertical (/V) dimension (e.g. Blinds /Dm /V), and /M is for motion, either in (/I) or out (/O). -

+class="cork-lmtt-10">Blinds /Dm /V), and /M is for motion, either in (/I) or out (/O). +

+

A box sweeps in or out.

+

Similar to Dissolve, except the effect sweeps across the + screen.

+

Two lines sweep across the screen to reveal the new page.

Blinds Blinds /Dm -

Multiple lines distributed evenly across the screen sweep +

Multiple lines distributed evenly across the screen sweep in the same direction to reveal the new page.

Box Box /M -

A box sweeps in or out.

Dissolve Dissolve -

The page image dissolves in a piecemeal fashion to reveal +

The page image dissolves in a piecemeal fashion to reveal the new page.

Glitter Glitter /Di -

Similar to Dissolve, except the effect sweeps across the - screen.

Split Split /Dm /M -

Two lines sweep across the screen to reveal the new page.

Wipe Wipe /Di -

A single line sweeps across the screen to reveal the new +

A single line sweeps across the screen to reveal the new page.

-

+

3.7 Big alphabetical list

-

The following is a complete listing of available options for hyperref, arranged alphabetically. -

+

The following is a complete listing of available options for hyperref, arranged alphabetically. +

+

use A4 paper

+

use A5 paper

+

set color of anchors

+

use B5 paper

+

do bibliographical back references

+

set base URL for document

+

make bookmarks

+

put section numbers in bookmarks

+

open up bookmark tree

+

level to which bookmarks are open

+

to specify which ‘toc’ file to mimic

+

allow links to break over lines

+

to produce CJK bookmarks

+

color of border around cites

+

color of citation links

+

color links

+

(tex4ht, dviwindo)

+

do not do any hyperlinking

+

use dvipdf backend (deprecated)

+

use dvipdfm backend

+

use dvipdfmx backend

+

use dvips backend

+

use dvipsone backend

+

use dviwindo backend

+

to set encap character for hyperindex

+

use executivepaper

+

suffix of linked files

+

color of border around file links

+

color of file links

+

opposite of option draft

+

use small caps instead of color for links

+

make figures hyper links

+

set up hyperlinked footnotes

+

set up hyperlinked indices

+class="cork-lmss-10">EX backend +

use guessable names for links

+class="cork-lmss-10">EX2HTML backend +

use legalpaper

@@ -2258,334 +2249,335 @@ class="td11"> +

use letterpaper

+

color of border around links

+

color of links

+

color of border around menu links

+

color for menu links

+

an alias for dvips

+

allow nesting of links

+

put an anchor on every page

+

backreference by page number

+

text for PDF Author field

+

width of PDF link border

+

(colorlinks)

+

position the document window in the + center of the screen

+

text for PDF Creator field

+

+

+

direction setting

+

display document title instead of file + name in title bar

+class="td11"> +

paper handling option for print dialog

+

resize document window to fit + document size

+

set highlighting of PDF links

+

text for PDF Keywords field

+

PDF language identifier (RFC 3066)

+

an alias for dvips

+

make PDF viewer’s menu bar visible

+

make links that open another PDF

+

file start a new window

+

page mode setting on exiting full-screen + mode

+

number of printed copies

+

set layout of PDF pages

+

set default mode of PDF display

+

set PDF page labels

+

set crop size of PDF document

+

set PDF page transition style

+

set option for print dialog

+

set /PrintArea of viewer preferences

+

set /PrintClip of viewer preferences

+

set /PrintPageRange of viewer + preferences

@@ -2593,245 +2585,239 @@ class="td11"> +

page scaling option for print dialog

+

text for PDF Producer field

+

page at which PDF document opens

+

starting view of PDF document

+

text for PDF Subject field

+

use pdfTEX backend

+

text for PDF Title field

+

make PDF toolbar visible

+

PDF ‘view’ when on link traversal

+

set /ViewArea of viewer preferences

+

set /ViewClip of viewer preferences

+

make PDF user interface elements + visible

+

do page number anchors as plain arabic

+

use ps2pdf backend

+

raise up links (for HyperTEX backend)

+

color of border around ‘run’ links

+

color of ‘run’ links

+

set page size by special driver + commands

+

use TEX4ht backend

+

use Textures backend

+class="td11"> +

Unicode encoded pdf strings

+

color of border around URL links

+

color of URL links

+

be chatty

+

use VTeX backend

+

use XeTEX backend

+class="td11"> @@ -2843,151 +2829,147 @@ class="td11"> class="td11"> -
a4paper a4paper -

use A4 paper

a5paper a5paper -

use A5 paper

anchorcolor anchorcolor black black -

set color of anchors

b5paper b5paper -

use B5 paper

backref backref false false -

do bibliographical back references

baseurl baseurl empty empty -

set base URL for document

bookmarks bookmarks true true -

make bookmarks

bookmarksnumbered bookmarksnumbered false false -

put section numbers in bookmarks

bookmarksopen bookmarksopen false false -

open up bookmark tree

bookmarksopenlevel bookmarksopenlevel \maxdimen \maxdimen -

level to which bookmarks are open

bookmarkstype bookmarkstype toc toc -

to specify which ‘toc’ file to mimic

breaklinks breaklinks false false -

allow links to break over lines

CJKbookmarks CJKbookmarks false false -

to produce CJK bookmarks

citebordercolor citebordercolor 0 1 0 0 1 0 -

color of border around cites

citecolor citecolor green green -

color of citation links

colorlinks colorlinks false false -

color links

true true -

(tex4ht, dviwindo)

debug debug false false -

provide details of anchors defined; same +

provide details of anchors defined; same as verbose

draft draft false false -

do not do any hyperlinking

dvipdf dvipdf -

use dvipdf backend (deprecated)

dvipdfm dvipdfm -

use dvipdfm backend

dvipdfmx dvipdfmx -

use dvipdfmx backend

dvips dvips -

use dvips backend

dvipsone dvipsone -

use dvipsone backend

dviwindo dviwindo -

use dviwindo backend

encap encap -

to set encap character for hyperindex

executivepaper executivepaper -

use executivepaper

extension extension dvi dvi -

suffix of linked files

filebordercolor filebordercolor 0 .5 .5 0 .5 .5 -

color of border around file links

filecolor filecolor cyan cyan -

color of file links

final final true true -

opposite of option draft

frenchlinks frenchlinks false false -

use small caps instead of color for links

hyperfigures hyperfigures false false -

make figures hyper links

hyperfootnotes hyperfootnotes true true -

set up hyperlinked footnotes

hyperindex hyperindex true true -

set up hyperlinked indices

hypertex hypertex -

use HyperT

use HyperTEX backend

hypertexnames hypertexnames true true -

use guessable names for links

implicit implicit true true -

redefine LAT

redefine LATEX internals

latex2html latex2html -

use LAT

use LATEX2HTML backend

legalpaper legalpaper -

use legalpaper

letterpaper letterpaper -

use letterpaper

linkbordercolor linkbordercolor 1 0 0 1 0 0 -

color of border around links

linkcolor linkcolor red red -

color of links

linktocpage linktocpage false false -

make page number, not text, be link on +

make page number, not text, be link on TOC, LOF and LOT

menubordercolor menubordercolor 1 0 0 1 0 0 -

color of border around menu links

menucolor menucolor red red -

color for menu links

nativepdf nativepdf false false -

an alias for dvips

naturalnames naturalnames false false -

use LAT

use LATEX-computed names for links

nesting nesting false false -

allow nesting of links

pageanchor pageanchor true true -

put an anchor on every page

pagebackref pagebackref false false -

backreference by page number

pagebordercolor pdfauthor 1 1 0 empty -

color of border around page links

pagecolor pdfborder red 0 0 1 -

color of page links, but currently unused

pdfauthor empty 0 0 0 -

text for PDF Author field

pdfborder pdfcenterwindow 0 0 1 false -

width of PDF link border

0 0 0 pdfcreator LaTeX with -

(colorlinks)

pdfcenterwindow false hyperref -

position the document window in the - center of the screen

pdfcreator LaTeX with package -

text for PDF Creator field

hyperref pdfdirection empty -

package pdfdisplaydoctitle false -

pdfdirection pdfduplex empty empty -

direction setting

pdfdisplaydoctitle pdffitwindow false false -

display document title instead of file - name in title bar

pdfduplex pdfhighlight empty /I -

paper handling option for print dialog

pdffitwindow pdfkeywords false empty -

resize document window to fit - document size

pdfhighlight pdflang /I empty -

set highlighting of PDF links

pdfkeywords pdfmark empty false -

text for PDF Keywords field

pdflang pdfmenubar empty true -

PDF language identifier (RFC 3066)

pdfmark pdfnewwindow false false -

an alias for dvips

pdfmenubar true -

make PDF viewer’s menu bar visible

pdfnewwindow pdfnonfullscreenpagemode false empty -

make links that open another PDF

pdfnumcopies empty -

file start a new window

pdfnonfullscreenpagemode pdfpagelayout empty empty -

page mode setting on exiting full-screen - mode

pdfnumcopies pdfpagemode empty empty -

number of printed copies

pdfpagelayout pdfpagelabels empty true -

set layout of PDF pages

pdfpagemode pdfpagescrop empty empty -

set default mode of PDF display

pdfpagelabels pdfpagetransition true empty -

set PDF page labels

pdfpagescrop pdfpicktrackbypdfsize empty empty -

set crop size of PDF document

pdfpagetransition pdfprintarea empty empty -

set PDF page transition style

pdfpicktrackbypdfsize pdfprintclip empty empty -

set option for print dialog

pdfprintarea pdfprintpagerange empty empty -

set /PrintArea of viewer preferences

pdfprintclip pdfprintscaling empty empty -

set /PrintClip of viewer preferences

pdfprintpagerange pdfproducer empty empty -

set /PrintPageRange of viewer - preferences

pdfprintscaling pdfstartpage empty 1 -

page scaling option for print dialog

pdfproducer pdfstartview empty Fit -

text for PDF Producer field

pdfstartpage pdfsubject 1 empty -

page at which PDF document opens

pdfstartview Fit pdftex -

starting view of PDF document

pdfsubject pdftitle empty empty -

text for PDF Subject field

pdftex pdftoolbar true -

use pdfTEX backend

pdftitle pdfview empty XYZ -

text for PDF Title field

pdftoolbar pdfviewarea true empty -

make PDF toolbar visible

pdfview pdfviewclip XYZ empty -

PDF ‘view’ when on link traversal

pdfviewarea pdfwindowui empty true -

set /ViewArea of viewer preferences

pdfviewclip plainpages empty false -

set /ViewClip of viewer preferences

pdfwindowui true ps2pdf -

make PDF user interface elements - visible

plainpages raiselinks false false -

do page number anchors as plain arabic

ps2pdf runbordercolor 0 .7 .7 -

use ps2pdf backend

raiselinks runcolor false filecolor -

raise up links (for HyperTEX backend)

runbordercolor setpagesize 0 .7 .7 true -

color of border around ‘run’ links

setpagesize true tex4ht -

set page size by special driver - commands

tex4ht textures -

use TEX4ht backend

textures unicode false -

use Textures backend

unicode urlbordercolor false 0 1 1 -

Unicode encoded pdf strings

urlbordercolor urlcolor 0 1 1 magenta -

color of border around URL links

urlcolor verbose magenta false -

color of URL links

verbose false vtex -

be chatty

vtex xetex -

use VTeX backend

xetex -

use XeTEX backend

-

+

4 Additional user macros

-

If you need to make references to URLs, or write explicit links, the following low-level user macros are +

If you need to make references to URLs, or write explicit links, the following low-level user macros are provided: -

+

\href{URL}{text} -

The text is made a hyperlink to the URL; this must be a full URL (relative to the base URL, if that is -defined). The special characters # and ~ do not need to be escaped in any way. -

+class="cork-lmtt-10">\href{URL}{text} +

The text is made a hyperlink to the URL; this must be a full URL (relative to the base URL, if that is +defined). The special characters # and ~ do not need to be escaped in any way. +

\url{URL} -

Similar to \href{URL}{\nolinkurl{URL}}. Depending on the driver \href also tries to detect the link +class="cork-lmtt-10">\url{URL} +

Similar to \href{URL}{\nolinkurl{URL}}. Depending on the driver \href also tries to detect the link +type. Thus the result can be a url link, file link, ... -type. Thus the result can be a url link, file link, . . . -

+

\nolinkurl{URL} -

Write URL in the same way as \url, without creating a hyperlink. -

+class="cork-lmtt-10">\nolinkurl{URL} +

Write URL in the same way as \url, without creating a hyperlink. +

\hyperbaseurl{URL} -

A base URL is established, which is prepended to other specified URLs, to make it easier to write +class="cork-lmtt-10">\hyperbaseurl{URL} +

A base URL is established, which is prepended to other specified URLs, to make it easier to write portable documents. -

+

\hyperimage{imageURL}{text} -

The link to the image referenced by the URL is inserted, using text as the anchor. -

For drivers that produce HTML, the image itself is inserted by the browser, with the text being +class="cork-lmtt-10">\hyperimage{imageURL}{text} +

The link to the image referenced by the URL is inserted, using text as the anchor. +

For drivers that produce HTML, the image itself is inserted by the browser, with the text being ignored completely. -

+

\hyperdef{category}{name}{text} -

A target area of the document (the text) is marked, and given the name category.name -

+class="cork-lmtt-10">\hyperdef{category}{name}{text} +

A target area of the document (the text) is marked, and given the name category.name +

\hyperref{URL}{category}{name}{text} -

text is made into a link to URL#category.name -

+class="cork-lmtt-10">\hyperref{URL}{category}{name}{text} +

text is made into a link to URL#category.name +

\hyperref[label]{text} -

text is made into a link to the same place as \ref{label} would be linked. -

+class="cork-lmtt-10">\hyperref[label]{text} +

text is made into a link to the same place as \ref{label} would be linked. +

\hyperlink{name}{text} -

+class="cork-lmtt-10">\hyperlink{name}{text} +

\hypertarget{name}{text} -

A simple internal link is created with \hypertarget, with two parameters of an anchor name, and +class="cork-lmtt-10">\hypertarget{name}{text} +

A simple internal link is created with \hypertarget, with two parameters of an anchor name, and anchor text. \hyperlink has two arguments, the name of a hypertext object defined somewhere by +class="cork-lmri-10">text. \hyperlink has two arguments, the name of a hypertext object defined somewhere by \hypertarget, and the text which be used as the link on the page. -

Note that in HTML parlance, the \hyperlink command inserts a notional # in front of each link, +class="cork-lmtt-10">\hypertarget, and the text which be used as the link on the page. +

Note that in HTML parlance, the \hyperlink command inserts a notional # in front of each link, making it relative to the current testdocument; \href expects a full URL. - - -

+class="cork-lmtt-10">\href expects a full URL. +

\phantomsection -

This sets an anchor at this location. It works similar to \hypertarget{}{} with an automatically +class="cork-lmtt-10">\phantomsection +

This sets an anchor at this location. It works similar to \hypertarget{}{} with an automatically + choosen anchor name. Often it is used in conjunction with \addcontentsline for sectionlike things +class="cork-lmtt-10">\addcontentsline for sectionlike things (index, bibliography, preface). \addcontentsline refers to the latest previous location where an anchor +class="cork-lmtt-10">\addcontentsline refers to the latest previous location where an anchor is set. Example:

@@ -3001,36 +2983,36 @@ class="verbatim">
 
\printindex
-

-

Now the entry in the table of contents (and bookmarks) for the index points to the start of the index page, +

+

Now the entry in the table of contents (and bookmarks) for the index points to the start of the index page, not to a location before this page. -

+

\autoref{label} -

This is a replacement for the usual \ref 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’). -

The label is worked out from the context of the original \label command by hyperref by using the -macros listed below (shown with their default values). The macros can be (re)defined in documents using +class="cork-lmtt-10">\autoref{label} +

This is a replacement for the usual \ref 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’). +

The label is worked out from the context of the original \label command by hyperref by using the +macros listed below (shown with their default values). The macros can be (re)defined in documents using \(re)newcommand; note that some of these macros are already defined in the standard document classes. +class="cork-lmtt-10">\(re)newcommand; 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. -

For each macro below, hyperref checks \*autorefname before \*name. For instance, it looks for +

For each macro below, hyperref checks \*autorefname before \*name. For instance, it looks for \figureautorefname before \figurename. -

+class="cork-lmtt-10">\figureautorefname before \figurename. +

+

Default

+

Figure

+

Table

+

Part

+

Appendix

+

Equation

+

item

+

chapter

+

section

+

subsection

+

subsubsection

+

paragraph

+

footnote

+

Equation

+

Theorem

+class="td11"> \page @@ -3139,22 +3124,63 @@ class="td11"> class="td11"> + +
Macro Macro -

Default

\figurename \figurename -

Figure

\tablename \tablename -

Table

\partname \partname -

Part

\appendixname \appendixname -

Appendix

\equationname \equationname -

Equation

\Itemname \Itemname -

item

\chaptername \chaptername -

chapter

\sectionname \sectionname -

section

\subsectionname \subsectionname -

subsection

\subsubsectionname \subsubsectionname -

subsubsection

\paragraphname \paragraphname -

paragraph

\Hfootnotename \Hfootnotename -

footnote

\AMSname \AMSname -

Equation

\theoremname \theoremname -

Theorem

+

page

-

For instances where you want a reference to use the correct counter, but not to create a link, there -are two starred forms: -

+

Example for a redefinition if babel is used: +

+ + +
+\usepackage[ngerman]{babel} + 
\addto\extrasngerman{% + 
  \def\subsectionautorefname{Unterkapitel}% + 
} +
+
+

+

+ \autopageref{label} +

It replaces \pageref and adds the name for page in front of the page reference. First \pageautorefname +is checked before \pagename. +

For instances where you want a reference to use the correct counter, but not to create a link, there +are starred forms: +

+ \ref*{label} +

+ \pageref*{label} +

\ref*{label} -

+class="cork-lmtt-10">\autoref*{label} +

\pageref*{label} -

A typical use would be to write +class="cork-lmtt-10">\autopageref*{label} +

A typical use would be to write
\hyperref[other]{that nice section (\ref*{other}) we read before}
-

-

We want \ref*{other} to generate the correct number, but not to form a link, since we do this +

+

We want \ref*{other} to generate the correct number, but not to form a link, since we do this ourselves with \hyperref. -

+class="cork-lmtt-10">\hyperref. +

\pdfstringdef{macroname}{TEXstring} -

\pdfstringdef 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 +class="cork-lmtt-10">\pdfstringdef{macroname}{TEXstring} +

\pdfstringdef 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: -

+

-

In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in +class="cork-lmtt-10">\xspace provided by the xspace package +

In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in the PDF string. For further details, see Heiko Oberdiek’s EuroTEX paper distributed with hyperref. -

+class="cork-lmss-10">hyperref. +

4.1 Replacement macros

-

hyperref takes the text for bookmarks from the arguments of commands like \section, which can +

hyperref takes the text for bookmarks from the arguments of commands like \section, which can contain things like math, colors, or font changes, none of which will display in bookmarks as is. -

+

\texorpdfstring{TEXstring}{PDFstring} -

For example, +class="cork-lmtt-10">\texorpdfstring{TEXstring}{PDFstring} +

For example,
 
\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars}
-

-

\pdfstringdef executes the hook before it expands the string. Therefore, you can use this hook to +

+

\pdfstringdef executes the hook before it expands the string. Therefore, you can use this hook to perform additional tasks or to disable additional commands. @@ -3273,11 +3299,11 @@ class="verbatim">

 
}
-

-

However, for disabling commands, an easier way is via \pdfstringdefDisableCommands, which adds -its argument to the definition of \pdfstringdefPreHook (‘@’ can here be used as letter in command +

+

However, for disabling commands, an easier way is via \pdfstringdefDisableCommands, which adds +its argument to the definition of \pdfstringdefPreHook (‘@’ can here be used as letter in command names): @@ -3291,21 +3317,21 @@ class="verbatim">

 
}
-

-

+

+

4.2 Utility macros

-

+

\hypercalcbp{dimen specification} -

\hypercalcbp takes a TEX dimen specification and converts it to bp and returns the number without +class="cork-lmtt-10">\hypercalcbp{dimen specification} +

\hypercalcbp takes a TEX dimen specification and converts it to bp and returns the number without the unit. This is useful for options pdfstartview and pdfview. Example: +class="cork-lmtt-10">pdfstartview and pdfview. Example:

@@ -3318,9 +3344,9 @@ class="verbatim">
 
}
-

-

The origin of the PDF coordinate system is the lower left corner. -

Note, for calculations you need either package |calc| or

+

The origin of the PDF coordinate system is the lower left corner. +

Note, for calculations you need either package |calc| or e-TEX. Nowadays the latter should @@ -3330,35 +3356,35 @@ class="cmmi-10">e-TEX, please, look in the source documentation hyperref.dtx for further limitations. -

Also \hypercalcbp cannot be used in option specifications of \documentclass and \usepackage, +class="cork-lmtt-10">hyperref.dtx for further limitations. +

Also \hypercalcbp cannot be used in option specifications of \documentclass and \usepackage, because LATEX expands the option lists of these commands. However package hyperref is not yet -loaded and an undefined control sequence error would arise. -

+class="cork-lmtt-10">hyperref is not yet +loaded and an undefined control sequence error would arise. +

5 Acrobat-specific behavior

-

If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided + id="x1-150005">Acrobat-specific behavior +

If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided in the appropriate drivers: -

+

\Acrobatmenu{menuoption}{text} -

The text is used to create a button which activates the appropriate menuoption. The following table lists +class="cork-lmtt-10">\Acrobatmenu{menuoption}{text} +

The text is used to create a button which activates the appropriate menuoption. 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. -

+

valign="baseline" id="TBL-13-1-"> +

ImportImage, ImportNotes, AcroForm:ImportFDF

+

ExportNotes, AcroForm:ExportFDF

@@ -3406,7 +3432,7 @@ class="td11"> valign="baseline" id="TBL-13-6-"> @@ -3414,19 +3440,19 @@ class="td11"> valign="baseline" id="TBL-13-7-"> +

Properties

+

AcroForm:Duplicate, AcroForm:TabOrder

@@ -3434,7 +3460,7 @@ class="td11"> valign="baseline" id="TBL-13-10-"> @@ -3453,28 +3479,28 @@ class="td11"> Tools-->Search +

About

@@ -3489,127 +3515,127 @@ class="td11"> class="td11">
File -

Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, +

Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, Print, PageSetup, Quit

File-->Import -

ImportImage, ImportNotes, AcroForm:ImportFDF

File-->Export -

ExportNotes, AcroForm:ExportFDF

File-->DocumentInfo -

GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, +

GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, Weblink:Base, AutoIndex:DocInfo

File-->Preferences -

GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, - AcroSearch:Preferences(Windows) or, +

GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, + AcroSearch:Preferences(Windows) or, AcroSearch:Prefs(Mac), Cpt:Capture

Edit -

Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, +

Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, TouchUp:TextAttributes, TouchUp:FitTextToSelection, TouchUp:ShowLineMarkers, TouchUp:ShowCaptureSuspects, TouchUp:FindSuspect,

-

Properties

Edit-->Fields -

AcroForm:Duplicate, AcroForm:TabOrder

Document -

Cpt:CapturePages, +

Cpt:CapturePages, AcroForm:Actions, CropPages, RotatePages, InsertPages, ExtractPages, ReplacePages, DeletePages, NewBookmark, SetBookmarkDest, CreateAllThumbs, DeleteAllThumbs

View -

ActualSize, FitVisible, FitWidth, FitPage, ZoomTo, +

ActualSize, FitVisible, FitWidth, FitPage, ZoomTo, FullScreen, FirstPage, PrevPage, NextPage, LastPage, GoToPage, GoBack, GoForward, SinglePage, OneColumn, TwoColumns, ArticleThreads, PageOnly, ShowBookmarks, @@ -3443,7 +3469,7 @@ class="td11"> valign="baseline" id="TBL-13-11-">

Tools -

Hand, ZoomIn, ZoomOut, SelectText, SelectGraphics, +

Hand, ZoomIn, ZoomOut, SelectText, SelectGraphics, Note, Link, Thread, AcroForm:Tool, Acro_Movie:MoviePlayer, TouchUp:TextTool, Find, FindAgain, FindNextNote, CreateNotesFile

-

AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, +

AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, AcroSrch:Assist, AcroSrch:PrevDoc, AcroSrch:PrevHit, AcroSrch:NextHit, AcroSrch:NextDoc

Window -

ShowHideToolBar, ShowHideMenuBar, +

ShowHideToolBar, ShowHideMenuBar, ShowHideClipboard, Cascade, TileHorizontal, TileVertical, CloseAll

Help -

HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, +

HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, HelpCapture, HelpPDFWriter, HelpDistiller, HelpSearch, HelpCatalog, HelpReader, Weblink:Home

Help(Windows) -

About

-

+

6 PDF and HTML forms

-

You must put your fields inside a Form environment (only one per file). -

There are six macros to prepare fields: +

You must put your fields inside a Form environment (only one per file). +

There are six macros to prepare fields: -

+

\TextField[parameters]{label} -

+class="cork-lmtt-10">\TextField[parameters]{label} +

\CheckBox[parameters]{label} -

+class="cork-lmtt-10">\CheckBox[parameters]{label} +

\ChoiceMenu[parameters]{label}{choices} -

+class="cork-lmtt-10">\ChoiceMenu[parameters]{label}{choices} +

\PushButton[parameters]{label} -

+class="cork-lmtt-10">\PushButton[parameters]{label} +

\Submit[parameters]{label} -

+class="cork-lmtt-10">\Submit[parameters]{label} +

\Reset[parameters]{label} -

The way forms and their labels are laid out is determined by: -

+class="cork-lmtt-10">\Reset[parameters]{label} +

The way forms and their labels are laid out is determined by: +

\LayoutTextField{label}{field} -

+class="cork-lmtt-10">\LayoutTextField{label}{field} +

\LayoutChoiceField{label}{field} -

+class="cork-lmtt-10">\LayoutChoiceField{label}{field} +

\LayoutCheckField{label}{field} -

These macros default to #1 #2 -

What is actually shown in as the field is determined by: -

+class="cork-lmtt-10">\LayoutCheckField{label}{field} +

These macros default to #1 #2 +

What is actually shown in as the field is determined by: +

\MakeRadioField{width}{height} -

+class="cork-lmtt-10">\MakeRadioField{width}{height} +

\MakeCheckField{width}{height} -

+class="cork-lmtt-10">\MakeCheckField{width}{height} +

\MakeTextField{width}{height} -

+class="cork-lmtt-10">\MakeTextField{width}{height} +

\MakeChoiceField{width}{height} -

+class="cork-lmtt-10">\MakeChoiceField{width}{height} +

\MakeButtonField{text} -

These macros default to \vbox to #2{\hbox to #1{\hfill}\vfill}, except the last, which defaults +class="cork-lmtt-10">\MakeButtonField{text} +

These macros default to \vbox to #2{\hbox to #1{\hfill}\vfill}, except the last, which defaults to #1; it is used for buttons, and the special \Submit and \Reset macros. -

You may also want to redefine the following macros: +class="cork-lmtt-10">\Submit and \Reset macros. +

You may also want to redefine the following macros:
 
\def\DefaultWidthofText{3cm}
-

-

+

+

6.1 Forms environment parameters

-

+

+class="cork-lmtt-10">html is the only valid value +class="cork-lmtt-10">get @@ -3688,16 +3714,16 @@ class="td11">
action action URL URL -

The URL that will receive the form data if a Submit button +

The URL that will receive the form data if a Submit button is included in the form

encoding encoding name name -

The encoding for the string set to the URL; FDF-encoding +

The encoding for the string set to the URL; FDF-encoding is usual, and html is the only valid value

method method name name -

Used only when generating HTML; values can be post or +

Used only when generating HTML; values can be post or get

-

+

6.2 Forms optional parameters

-

Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. color=0 0 +

Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. color=0 0 0.5) -

+class="cork-lmtt-10">0.5) +

+class="cork-lmri-10">0 +class="td11"> color of border +class="td11"> JavaScript code to calculate the value of the field +class="td11"> font size of field text +class="cork-lmri-10">false +class="td11"> JavaScript code to format the field +class="td11"> height of field box +class="cork-lmri-10">false +class="cork-lmri-10">0 +class="td11"> name of field (defaults to label) +class="cork-lmri-10">false +class="cork-lmri-10">false @@ -4010,34 +4036,39 @@ class="td11"> +class="cork-lmtt-10">rotation +class="cork-lmtt-10">tabkey +class="cork-lmtt-10">validate +class="cork-lmtt-10">value +class="td11"> width @@ -4046,32 +4077,35 @@ class="td11"> class="td11"> +
accesskey accesskey key (as per HTML)
align align number 0 alignment within text field; 0 is left-aligned, alignment within text field; 0 is left-aligned,
1 is centered, 2 is right-aligned.
backgroundcolor backgroundcolor color of box
bordercolor bordercolor color of border
bordersep bordersep box border gap
borderwidth borderwidth width of box border
calculate calculate JavaScript code to calculate the value of the field
charsize charsize dimen font size of field text
checked checked boolean false false whether option selected by default
color color color of text in box
combo combo boolean false false choice list is ‘combo’ style
default default default value
disabled disabled boolean false field disabled field disabled
format format JavaScript code to format the field
height height dimen height of field box
hidden hidden boolean false field hidden field hidden
ketstroke ketstroke JavaScript code to control the keystrokes on entry
maxlen maxlen number 0 number of characters allowed in text field number of characters allowed in text field
menulength menulength number 4 4 number of elements shown in list
multiline multiline boolean false false whether text box is multiline
name name name name of field (defaults to label)
onblur onblur JavaScript code
onchange onchange JavaScript code
onclick onclick JavaScript code
ondblclick ondblclick JavaScript code
onfocus onfocus JavaScript code
onkeydown onkeydown JavaScript code
onkeypress onkeypress JavaScript code
onkeyup onkeyup JavaScript code
onmousedown onmousedown JavaScript code
onmousemove onmousemove JavaScript code
onmouseout onmouseout JavaScript code
onmouseover onmouseover JavaScript code
onmouseup onmouseup JavaScript code
onselect onselect JavaScript code
password password boolean false text field is ‘password’ style text field is ‘password’ style
popdown popdown boolean false false choice list is ‘popdown’ style
radio radio boolean false false choice list is ‘radio’ style
readonly readonly boolean false field is readonly field is readonly
tabkey (as per HTML) number 0 rotation of the widget annotation (degree, counterclockwise, multiple of 90)
validate JavaScript code to validate the entry (as per HTML)
value initial value JavaScript code to validate the entry
width dimen width of field box initial value
dimen width of field box
-

+

7 Defining a new driver

-

A hyperref driver has to provide definitions for eight macros: -

1. \hyper@anchor -

2. \hyper@link -

3. \hyper@linkfile -

4. \hyper@linkurl -

5. \hyper@anchorstart -

6. \hyper@anchorend -

7. \hyper@linkstart -

8. \hyper@linkend -

The draft option defines the macros as follows + id="x1-190007">Defining a new driver +

A hyperref driver has to provide definitions for eight macros: +

1. \hyper@anchor +

2. \hyper@link +

3. \hyper@linkfile +

4. \hyper@linkurl +

5. \hyper@anchorstart +

6. \hyper@anchorend +

7. \hyper@linkstart +

8. \hyper@linkend +

The draft option defines the macros as follows
 
\let\hyper@linkend\@empty
-

-

+

+

8 Special support for other packages

-

hyperref aims to cooperate with other packages, but there are several possible sources for conflict, such +

hyperref aims to cooperate with other packages, but there are several possible sources for conflict, such as -

+

-

The hyperref package is distributed with variants on two useful packages designed to work especially +

The hyperref package is distributed with variants on two useful packages designed to work especially well with it. These are xr and minitoc, which support crossdocument links using LATxr and minitoc, which support crossdocument links using LATEX’s normal \label/\ref mechanisms and per-chapter tables of contents, respectively. -

+class="cork-lmtt-10">\label/\ref mechanisms and per-chapter tables of contents, respectively. +

9 History and acknowledgments

-

The original authors of hyperbasics.tex and hypertex.sty, from which this package +

The original authors of hyperbasics.tex and hypertex.sty, from which this package descends, are Tanmoy Bhattacharya (tanmoy@qcd.lanl.gov) and Thorsten Ohl +class="cork-lmtt-10">tanmoy@qcd.lanl.gov) and Thorsten Ohl (thorsten.ohl@physik.th-darmstadt.de). hyperref started as a simple port of their work to +class="cork-lmtt-10">thorsten.ohl@physik.th-darmstadt.de). hyperref started as a simple port of their work to LATEX2e standards, but event the original, and was only interested in getting it to work with LATEX. 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. +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. -

Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has made the +

Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has made the package more robust. The days spent on RevTEX are entirely due to him! The investigations of Bill Moss (bmoss@math.clemson.edu) into the later versions including native PDF support uncovered a good +class="cork-lmtt-10">bmoss@math.clemson.edu) into the later versions including native PDF support uncovered a good many bugs, and his testing is appreciated. Hans Hagen (pragma@pi.net) provided a lot of insight into +class="cork-lmtt-10">pragma@pi.net) provided a lot of insight into PDF. -

Berthold Horn provided help, encouragement and sponsorship for the dvipsone and dviwindo drivers. +

Berthold Horn provided help, encouragement and sponsorship for the dvipsone and dviwindo drivers. Sergey Lesenko provided the changes needed for dvipdf, and Hàn Thê' Thành supplied all +class="cork-lmss-10">dvipdf, and Hàn Thêˊ Thành supplied all the information needed for pdftex. Patrick Daly kindly updated his natbib package to allow +class="cork-lmss-10">pdftex. Patrick Daly kindly updated his natbib package to allow easy integration with hyperref. Michael Mehlich’s hyper package (developed in parallel with +class="cork-lmss-10">hyperref. Michael Mehlich’s hyper package (developed in parallel with hyperref) showed me solutions for some problems. Hopefully the two packages will combine one +class="cork-lmss-10">hyperref) showed me solutions for some problems. Hopefully the two packages will combine one day. -

The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and +

The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and ideas; Thomas Merz, whose book Web Publishing with Acrobat/PDF provided crucial insights; +class="cork-lmri-10">Web Publishing with Acrobat/PDF 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 pdftex. -

Steve Dandy recreated the manual source in July 2003 after it had been lost. -

Especial extra thanks to David Carlisle for the backref module, the ps2pdf and dviwindo support, +class="cork-lmss-10">pdftex. +

Steve Dandy recreated the manual source in July 2003 after it had been lost. +

Especial extra thanks to David Carlisle for the backref module, the ps2pdf and dviwindo support, frequent general rewrites of my bad code, and for working on changes to the xr package to suit +class="cork-lmss-10">xr package to suit hyperref. +class="cork-lmss-10">hyperref.

10 Preamble

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. +“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.

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. @@ -4210,7 +4244,7 @@ printed book. We recommend this License principally for works whose purpose is i reference.

10.1 Applicability and definitions

+ id="x1-2400010.1">Applicability and definitions

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 @@ -4218,8 +4252,8 @@ the conditions stated herein. The “Document”, below, refers to any s 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. -

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 +

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.

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 @@ -4230,7 +4264,7 @@ related matters, or of legal, commercial, philosophical, ethical or political po them.

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 +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 @@ -4240,38 +4274,38 @@ Back-Cover Texts, in the notice that says that the Document is released under th A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.

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 +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 +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”.

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LATEX input format, SGML or XML using a publicly available DTD, and -standard-conforming simple HTML, PostScript or PDF designed for human modification. +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.

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 +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.

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”, +(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. +definition.

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 +that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.

10.2

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 +

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.

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 @@ -4317,13 +4351,13 @@ redistributing any large number of copies, to give them a chance to provide you of the Document.

10.4 Modifications

-

You may copy and distribute a Modified Version of the Document under the conditions of sections  Modifications

+

You may copy and distribute a Modified Version of the Document under the conditions of sections  10.2 and 10.3 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 +href="#x1-2600010.3">10.3 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:

    @@ -4337,13 +4371,13 @@ Version:
  1. 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 + 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.
  2. State on the Title page the name of the publisher of the Modified Version, as the publisher. + id="x1-27006x3">State on the Title page the name of the publisher of the Modified Version, as the publisher.
  3. Add an appropriate copyright notice for your modifications adjacent to the other copyright + id="x1-27010x5">Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
  4. 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 + to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
  5. 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 + 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. + describing the Modified Version as stated in the previous sentence.
  6. For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the + id="x1-27022x11">For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
  7. @@ -4400,11 +4434,11 @@ Version:
  8. Delete any section Entitled “Endorsements”. Such a section may not be included in the - Modified Version. + Modified Version.
  9. Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with + id="x1-27028x14">Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with any Invariant Section.
-

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary +

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 +the Modified Version’s license notice. These titles must be distinct from any other section titles.

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. -

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 +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. +

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.

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. +names for publicity for or to assert or imply endorsement of any Modified Version.

10.5 Combining documents

You may combine the Document with other documents released under this License, under the terms -defined in section  10.4 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 +defined in section  10.4 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.

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 +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. @@ -4478,7 +4512,7 @@ aggregate.

10.8 Translation

-

Translation is considered a kind of modification, so you may distribute translations of the Document +

Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section  10.4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant @@ -4506,10 +4540,10 @@ in full compliance. id="x1-3300010.10">Future revisions of this license

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/. -

Each version of the License is given a distinguishing version number. If the Document specifies that a +differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. +

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 +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. diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.pdf b/Master/texmf-dist/doc/latex/hyperref/manual.pdf index 8349fda001f..524b69e2c77 100644 Binary files a/Master/texmf-dist/doc/latex/hyperref/manual.pdf and b/Master/texmf-dist/doc/latex/hyperref/manual.pdf differ diff --git a/Master/texmf-dist/doc/latex/hyperref/manual2.html b/Master/texmf-dist/doc/latex/hyperref/manual2.html index 0827f1e82ab..d018ed32aa5 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual2.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual2.html @@ -7,11 +7,11 @@ - + -

This is borrowed from an article by Arthur Smith. diff --git a/Master/texmf-dist/doc/latex/hyperref/manual3.html b/Master/texmf-dist/doc/latex/hyperref/manual3.html index 7a7bd32d260..755d188e60d 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual3.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual3.html @@ -7,14 +7,14 @@ - + -

Make sure you turn off the partial font downloading supported by dvips and dvipsone in favor of +

Make sure you turn off the partial font downloading supported by dvips and dvipsone in favor of Distiller’s own system. diff --git a/Master/texmf-dist/doc/latex/hyperref/options.pdf b/Master/texmf-dist/doc/latex/hyperref/options.pdf index d368e6ea363..99443b5058e 100644 Binary files a/Master/texmf-dist/doc/latex/hyperref/options.pdf and b/Master/texmf-dist/doc/latex/hyperref/options.pdf differ -- cgit v1.2.3