diff options
| author | Karl Berry <karl@freefriends.org> | 2018-09-30 21:23:18 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2018-09-30 21:23:18 +0000 |
| commit | 0e00fb64c271b0107e65fdf601df25e39f61b57f (patch) | |
| tree | d8770513326a4cb339513523d8b7e315c68ed37e | |
| parent | 11e3c92a57cc2bb390d65b5856bc5c1beb47a4ec (diff) | |
hyperref (30sep18)
git-svn-id: svn://tug.org/texlive/trunk@48792 c570f23f-e606-0410-a88d-b1316a301751
38 files changed, 5575 insertions, 3316 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf Binary files differdeleted file mode 100644 index 37c05e430e9..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/ChangeLog.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt index bee97e703d7..6dc67f4996e 100644 --- a/Master/texmf-dist/doc/latex/hyperref/ChangeLog +++ b/Master/texmf-dist/doc/latex/hyperref/ChangeLog.txt @@ -1,3 +1,16 @@ +2018-09-30 6.88a David Carlisle + * Reorganise README and ChangeLog moving most of README into the manual + and maintaining README.md as markdown and ChangeLog.txt as text + * Document NoHyper in the manual (copied from hyperref.dtx) for github issue 55 + * hyperref.dtx: Add \protected@file@percent for github issue 70 + * Adjust default pdfcreator and add addtopdfcreator key for githb issue 53 + * Use \scdefault not always sc as font shape for frenchlinks, github issue 64. + * Greek Autoref support, issue #52 + +2018-04-02 6.87a David Carlisle + * 6.87a + * Silence babel messages in pdfstringdef issue #59 + 2018-02-06 6.86b David Carlisle * 6.86b * Fix packaging of luatex.dtx (reported on tex.sx) diff --git a/Master/texmf-dist/doc/latex/hyperref/README b/Master/texmf-dist/doc/latex/hyperref/README deleted file mode 100644 index d9be178ed93..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/README +++ /dev/null @@ -1,1645 +0,0 @@ -README for hyperref bundle, 2018/02/06 - - -TABLE OF CONTENTS -================= - -1 Introduction -2 Download -3 Installation -4 Additional Packages -5 New Features -6 Package Compatibility -7 Limitations -8 Hints -9 Authors/Maintainers -10 Bug Reports -11 Known Problems -12 ToDo -13 Versions in TeX distributions - - -1 INTRODUCTION -============== - -This package is used to emend cross-referencing commands in LaTeX to -produce some sort of \special commands; there are backends for the -\special set defined for HyperTeX dvi processors, for embedded pdfmark -commands for processing by Acrobat Distiller (dvips and dvipsone), for -dviwindo, for pdfTeX, for dvipdfm, for TeX4ht, and for VTEX's pdf and HTML -backends. - -Included are: -a) `backref' a package by David Carlisle to provide links back from - bibliography to the main text; these are hypertext links after using - hyperref. -b) nameref' a package to allow reference to the *names* of sections rather - than their numbers. - -2 DOWNLOAD -========== - -`hyperref' is available on CTAN: - CTAN:macros/latex/contrib/hyperref/ - -Also a ZIP file is provided that contains the files, already sorted -in a TDS tree: - CTAN:install/macros/latex/contrib/hyperref.tds.zip - -`CTAN:' means one of the `Comprehensive TeX Archive Network' -nodes or one of its mirrors. This is explained in - http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives - -The main repository of hyperref is located at github - https://github.com/ho-tex/hyperref - - -3 INSTALLATION -============== - -Installation with ZIP file in TDS format ----------------------------------------- -The ZIP file `hyperref.tds.zip' contains the files sorted -in a TDS tree. Thus you can directly unpack the ZIP file -inside a TDS tree. (See CTAN:tds.zip for an explanation of TDS.) -Example: - cd /...somewhere.../texmf - unzip /...downloadpath.../hyperref.tds.zip -Do not forget to refresh the file name database of this TDS tree, -Example: - texhash /...somewhere.../texmf - -Manual installation -------------------- -a) Download the hyperref files from CTAN or the TUG server. - If necessary, unpack them. -b) If directory `beta' exists, replace the files by the counterparts - in this directory, if you want to use the latest versions. -c) Generate the package and driver files: - tex hyperref.ins -d) Install the files `*.sty', `*.def', and `*.cfg' in your TDS tree: - cp *.sty *.def *.cfg TDS:tex/latex/hyperref/ - Replace `TDS:' by the prefix of your TDS tree (texmf directory). - The exception is bmhydoc.sty, it belongs to the source files - (TDS:source/latex/hyperref/). -e) Copy the documentation files to "TDS:doc/latex/hyperref/": - manual.pdf, README, README.pdf, ChangeLog, ChangeLog.pdf, - slides.pdf, paper.pdf, options.pdf, hyperref.pdf, backref.pdf, - nameref.pdf (Also the HTML version of the manual can be put there.) -f) Update the databases if necessary, eg. for teTeX: - mktexlsr .../texmf - - -4 ADDITIONAL PACKAGES -===================== - -Depending on the driver and option settings, hyperref loads -other packages: -* atbegshi.sty: - CTAN:macros/latex/contrib/oberdiek/atbegshi.pdf -* atveryend.sty: - CTAN:macros/latex/contrib/oberdiek/atveryend.pdf -* backref.sty (loaded by option `backref' or `pagebackref'): - CTAN:macros/latex/contrib/hyperref/backref.dtx -* bigintcalc.sty (loaded by package `bitset'): - CTAN:macros/latex/contrib/oberdiek/bigintcalc.pdf -* bitset.sty: - CTAN:macros/latex/contrib/oberdiek/bitset.pdf -* color.sty (loaded by option `colorlinks'): - CTAN:macros/latex/required/graphics/ -* etexcmds.sty: - CTAN:macros/latex/contrib/oberdiek/etexcmds.pdf -* gettitlestring.sty (loaded by package `nameref'): - CTAN:macros/latex/contrib/oberdiek/gettitlestring.pdf -* hycolor.sty: - CTAN:macros/latex/contrib/oberdiek/hycolor.pdf -* infwarerr.sty (loaded by packages `etexcmds', `stringenc', - `atbegshi', `bitset'): - CTAN:macros/latex/contrib/oberdiek/infwarerr.pdf -* intcalc.sty: - CTAN:macros/latex/contrib/oberdiek/intcalc.pdf -* ifpdf.sty (loaded by package `atbegshi'): - CTAN:macros/latex/contrib/oberdiek/atbegshi.pdf -* ifluatex.sty (loaded by package `pdftexcmds'): - CTAN:macros/latex/contrib/oberdiek/ifluatex.pdf -* ifvtex.sty: - CTAN:macros/latex/contrib/oberdiek/ifvtex.pdf -* ifxetex.sty: - CTAN:macros/generic/ifxetex/ifxetex.sty -* intcalc.sty (loaded by package `bitset'): - CTAN:macros/latex/contrib/oberdiek/intcalc.pdf -* keyval.sty - CTAN:macros/latex/required/graphics/ -* kvdefinekeys.sty - CTAN:macros/latex/contrib/oberdiek/kvsetkeys.pdf -* kvoptions.sty: - CTAN:macros/latex/contrib/oberdiek/kvoptions.pdf -* kvsetkeys.sty: - CTAN:macros/latex/contrib/oberdiek/kvsetkeys.pdf -* letltxmacro.sty: - CTAN:macros/latex/contrib/oberdiek/letltxmacro.pdf -* ltxcmds.sty (loaded by package `pdftexcmds'): - CTAN:macros/latex/contrib/oberdiek/ltxcmds.pdf -* memhfixc.sty (loaded if class `memoir' is loaded): - CTAN:macros/latex/contrib/memoir/memhfixc.sty -* nameref.sty: - CTAN:macros/latex/contrib/hyperref/nameref.dtx -* pdfescape.sty (loaded by package `stringenc'): - CTAN:macros/latex/contrib/oberdiek/pdfescape.pdf -* pdftexcmds.sty - CTAN:macros/latex/contrib/oberdiek/pdftexcmds.pdf -* refcount.sty (loaded by package `nameref') - CTAN:macros/latex/contrib/oberdiek/refcount.pdf -* rerunfilecheck.sty: - CTAN:macros/latex/contrib/oberdiek/rerunfilecheck.pdf -* stringenc.sty: - CTAN:macros/latex/contrib/oberdiek/stringenc.pdf -* tex4ht.sty (loaded by option `tex4ht'): - CTAN:support/TeX4ht/ -* uniquecounter.sty (loaded by package `rerunfilecheck'): - CTAN:macros/latex/contrib/oberdiek/uniquecounter.pdf -* url.sty - CTAN:macros/latex/contrib/other/misc/url.sty -* vtexhtml.sty (loaded if VTeX is used in HTML mode) -* xcolor-patch.sty (loaded by package `hycolor') - CTAN:macros/latex/contrib/oberdiek/hycolor.pdf - - -5 NEW FEATURES -============== - -Option `pdflinkmargin' ----------------------- - Option `pdflinkmargin' is an experimental option for specifying - a link margin, if the driver supports this. Default is 1 pt for - supporting drivers. - - pdfTeX: - * The link area also depends on the surrounding box. - * Settings have local effect. - * When a page is shipped out, pdfTeX uses the current setting - of the link margin for all links on the page. - - pdfmark: - * Settings have global effect. - - Other drivers: Unsupported. - -Field option `calculatesortkey' -------------------------------- - Fields with calculated values are calculated in document order - by default. If calculated field values depend on other calculated - fields that appear later in the document, then the correct calculation - order can be specified with option `calculatesortkey'. Its value is - used as key to lexicographically sort the calculated fields. - The sort key do not need to be unique. Fields that share the same - key are sorted in document order. - - Currently the field option `calculatesortkey' is only supported by - the driver for pdfTeX. - -Option `localanchorname' ------------------------- - When an anchor is set (e.g. via \refstepcounter), then the - anchor name is globally set to the current anchor name. - - For example: - \section{Foobar} - \begin{equation}\end{equation} - \label{sec:foobar} - With the default global setting (localanchorname=false) - a reference to `sec:foobar' jumps to the equation before. - With option `localanchorname' the anchor of the equation - is forgotten after the environment and the reference - `sec:foobar' jumps to the section title. - - Option `localanchorname' is an experimental option, there - might be situations, where the anchor name is not available - as expected. - -Option `customdriver' ---------------------- - The value of option `customdriver' is the name of an external - driver file without extension `.def'. The file must have - \ProvidesFile with a version date and number that match the - date and number of `hyperref', otherwise a warning is given. - - Because the interface, what needs to be defined in the driver, - is not well defined and quite messy, the option is mainly intended - to ease developing, testing, debugging the driver part. - -Option `psdextra' ------------------ - LaTeX's NFSS is used to assist the conversion of arbitrary - TeX strings to PDF strings (bookmarks, PDF information entries). - Many math command names (\geq, \notin, ...) are not in control - of NFSS, therefore they are defined with prefix `text' - (\textgeq, \textnotin, ...). They can be mapped to short names - during the processing to PDF strings. The disadvantage is that - they are many hundreds macros that need to be redefined for - each PDF string conversion. Therefore this can be enabled or - disabled as option `psdextra'. On default the option is turned - off (set to `false'). Turning the option on means - that the short names are available. Then \geq can directly - be used instead of \textgeq. - -\XeTeXLinkBox -------------- - When XeTeX generates a link annotation, it does not look - at the boxes (as the other drivers), but only at the character - glyphs. If there are no glyphs (images, rules, ...), then - it does not generate a link annotation. Macro \XeTeXLinkBox - puts its argument in a box and adds spaces at the lower left - and upper right corners. An additional margin can be specified - by setting it to the dimen register \XeTeXLinkMargin. The default - is 2pt. - - Example: - % xelatex - \documentclass{article} - \usepackage{hyperref} - \setlength{\XeTeXLinkMargin}{1pt} - \begin{document} - \section{Hello World} - \newpage - \label{sec:hello} - \hyperref[sec:hello]{% - \XeTeXLinkBox{\rule{10mm}{10mm}}% - } - \end{document} - -\IfHyperBooleanExists and \IfHyperBoolean ------------------------------------------ - \IfHyperBooleanExists{OPTION}{YES}{NO} - If a hyperref OPTION is a boolean, that means it takes values - `true' or `false', then \IfHyperBooleanExists calls YES, otherwise NO. - - \IfHyperBoolean{OPTION}{YES}{NO} - Macro \IfHyperBoolean calls YES, if OPTION exists as boolean and is - enabled. Otherwise NO is executed. - - Both macros are expandable. Additionally option `stoppedearly' is - available. It is enabled if \MaybeStopEarly or \MaybeStopNow - end hyperref prematurely. - -\unichar --------- - If a Unicode character is not supported by puenc.def, it can - be given by using \unichar. It's name and syntax is inherited - from package `ucs'. However it is defined independently for - use in hyperref's \pdfstringdef (that converts arbitrary - TeX code to PDF strings or tries to do this). - - Macro \unichar takes a TeX number as argument, - examples for U+263A (WHITE SMILING FACE): - \unichar{"263A}% hexadecimal notation - \unichar{9786}% decimal notation - `"' must not be a babel shorthand character or otherwise - active. Otherwise prefix it with \string: - \unichar{\string"263A}% converts `"' to `"' with catcode 12 (other) - Users of (n)german packages or babel options may use \dq instead: - \unichar{\dq 263A}% \dq is double quote with catcode 12 (other) - -\ifpdfstringunicode -------------------- - Some features of the PDF specification needs PDF strings. - Examples are bookmarks or the entries in the information dictionary. - The PDF specification allows two encodings `PDFDocEncoding' - (8-bit encoding) and `Unicode' (UTF-16). The user can help - using \texorpdfstring to replace complicate TeX constructs - by a representation for the PDF string. However \texorpdfstring - does not distinguish the two encodings. This gap closes - \ifpdfstringunicode. It is only allowed in the second argument - of \texorpdfstring and takes two arguments, the first allows - the full range of Unicode. The second is limited to the - characters available in PDFDocEncoding. - - As example we take a macro definition for the Vietnamese - name of Han The Thanh. Correctly written it needs some - accented characters, one character even with a double accent. - Class `tugboat.cls' defines a macro for the typesetted name: - \def\Thanh{% - H\`an~% - Th\^e\llap{\raise 0.5ex\hbox{\'{}}}% - ~Th\`anh% - } - It's not entirely correct, the second accent over the `e' is not - an acute, but a hook. However standard LaTeX does not provide - such an accent. - Now we can extend the defintion to support hyperref. - The first and the last word are already supported automatically. - Characters with two or more accents are a difficult business in - LaTeX, because the NFSS2 macros of the LaTeX kernel do not support - more than one accent. Therefore also puenc.def misses support for - them. But we can provide it using \unichar. The character - in question is: - % U+1EC3 LATIN SMALL LETTER E WITH CIRCUMFLEX AND HOOK ABOVE - Thus we can put this together: - \def\Thanh{% - H\`an~% - \texorpdfstring{Th\^e\llap{\raise 0.5ex\hbox{\'{}}}}% - {\ifpdfstringunicode{Th\unichar{"1EC3}}{Th\^e}}% - ~Th\`anh% - } - For PDFDocEncoding (PD1) the variant above has dropped the - second accent. Alternatively we could provide a representation - without accents instead of wrong accents: - \def\Thanh{% - \texorpdfstring{% - H\`an~% - Th\^e\llap{\raise 0.5ex\hbox{\'{}}}}% - ~Th\`anh% - }{% - \ifpdfstringunicode{% - H\`an Th\unichar{"1EC3} Th\`anh% - }{% - Han The Thanh% - }% - }% - } - -Customizing index style file with \nohyperpage ----------------------------------------------- - Since version 2008/08/14 v6.78f. - - For hyperlink support in the index, hyperref inserts \hyperpage - into the index macros. After processing with Makeindex, \hyperpage - analyzes its argument to detect page ranges and page comma lists. - However, only the standard settings are supported directly: - delim_r "--" - delim_n ", " - (See manual page/documentation of Makeindex that explains - the keys that can be used in style files for Makeindex.) - Customized versions of - delim_r, delim_n, suffix_2p, suffix_3p, suffix_mp - needs markup that \hyperpage can detect and knows that - this stuff does not belong to a page number. Makro - \nohyperpage serves as this markup. Put the customized - code for these keys inside \nohyperpage, e.g.: - suffix_2p "\\nohyperpage{f.}" - suffix_3p "\\nohyperpage{ff.}" - (Depending on the typesetting tradition some space "\\," or "~" - should be put before the first f inside \nohyperpage.) - -Experimental option `ocgcolorlinks' ------------------------------------ - The idea are colored links, when viewed, but printed without colors. - This new experimental option `ocgcolorlinks' uses Optional Content - Groups, a feature introduced in PDF 1.5. - * The option must be given for package loading: - \usepackage[ocgcolorlinks]{hyperref} - * Main disadvantage: Links cannot be broken across lines. - PDF reference 1.7: 4.10.2 "Making Graphical Content Optional": - Graphics state operations, such as setting the color, ..., - are still applied. - Therefore the link text is put in a box and set twice, with and - without color. - * The feature can be switched of by \hypersetup{ocgcolorlinks=false} - inside the document. - * Supported drivers: pdftex, dvipdfm - * The PDF version should be at least 1.5. It is automatically - set for pdfTeX. Users of dvipdfmx set the version on the command - line: dvipdfmx -V 5 - -Option `pdfa' -------------- - The new option `pdfa' tries to avoid violations of PDF/A in code - generated by hyperref. However, the result is usually not in PDF/A, - because many features aren't controlled by hyperref (XMP metadata, - fonts, colors, driver dependend low level stuff, ...). - - Currently, option `pdfa' sets and disables the following items: - * Enabled annotation flags: Print, NoZoom, NoRotate [PDF/A 6.5.3]. - * Disabled annotation flags: Hidden, Invisible, NoView [PDF/A 6.5.3]. - * Disabled: Launch action (\href{run:...} [PDF/A 6.6.1]. - * Restricted: Named actions (\Acrobatmenu: NextPage, PrevPage, - FirstPage, LastPage) [PDF/A 6.6.1]. - * Many things are disabled in PDF formulars: - * JavaScript actions [PDF/A 6.6.1] - * Trigger events (additional actions) [PDF/A 6.6.2] - * Push button (because of JavaScript) - * Interactive Forms: Flag NeedAppearances is the default `false' - (Because of this, hyperref's implementation of Forms looks ugly). - [PDF/A 6.9] - - The default value of the new option `pdfa' is `false'. It influences - the loading of the package and cannot be changed after hyperref is - loaded (\usepackage{hyperref}). - - ToDo: - * XMP support - * ... - But perhaps Adobe Acrobat is now happy and can now convert - the PDF file to PDF/A. - -Option `linktoc' added ----------------------- - The new option `linktoc' allows more control which part - of an entry in the table of contents is made into a link: - * `linktoc=none' (no links) - * `linktoc=section' (default behaviour, same as `linktocpage=false') - * `linktoc=page' (same as `linktocpage=true') - * `linktoc=all' (both the section and page part are links) - -Option `pdfnewwindow' changed ------------------------------ - Before 6.77b: - * pdfnewwindow=true --> /NewWindow true - * pdfnewwindow=false --> (absent) - * unused pdfnewwindow --> (absent) - Since 6.77b: - * pdfnewwindow=true --> /NewWindow true - * pdfnewwindow=false --> /NewWindow false - * pdfnewwindow={} --> (absent) - * unused pdfnewwindow --> (absent) - - Rationale: There is a difference between setting to `false' - and an absent entry. In the former case the new document - replaces the old one, in the latter case the PDF viewer - application should respect the user preference. - -Flag options for PDF forms --------------------------- - PDF form field macros (\TextField, \CheckBox, ...) support - boolean flag options. The option name is the lowercase - version of the names in the PDF specification (1.7): - http://www.adobe.com/devnet/pdf/pdf_reference.html - http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf - Options (convert to lowercase) except flags in square brackets: - * Table 8.16 Annotation flags (page 608): - 1 Invisible - 2 Hidden (PDF 1.2) - 3 Print (PDF 1.2) - 4 NoZoom (PDF 1.3) - 5 NoRotate (PDF 1.3) - 6 NoView (PDF 1.3) - [7 ReadOnly (PDF 1.3)] ignored for widget annotations, see table 8.70 - 8 Locked (PDF 1.4) - 9 ToggleNoView (PDF 1.5) - 10 LockedContents (PDF 1.7) - * Table 8.70 Field flags common to all field types (page 676): - 1 ReadOnly - 2 Required - 3 NoExport - * Table 8.75 Field flags specific to button fields (page 686): - 15 NoToggleToOff (Radio buttons only) - 16 Radio (set: radio buttons, clear: check box, pushbutton: clear) - 17 Pushbutton - 26 RadiosInUniso (PDF 1.5) - * Table 8.77 Field flags specific to text fields (page 691): - 13 Multiline - 14 Password - 21 FileSelect (PDF 1.4) - 23 DoNotSpellCheck (PDF 1.4) - 24 DoNotScroll (PDF 1.4) - 25 Comb (PDF 1.5) - 26 RichText (PDF 1.5) - * Table 8.79 Field flags specific to choice fields (page 693): - 18 Combo (set: combo box, clear: list box) - 19 Edit (only useful if Combo is set) - 20 (Sort) for authoring tools, not PDF viewers - 22 MultiSelect (PDF 1.4) - 23 DoNotSpellCheck (PDF 1.4) (only useful if Combo and Edit are set) - 27 CommitOnSelChange (PDF 1.5) - * Table 8.86 Flags for submit-form actions (page 704): - [1 Include/Exclude] unsupported, use `noexport' (table 8.70) instead - 2 IncludeNoValueFields - [3 ExportFormat] handled by option `export' - 4 GetMethod - 5 SubmitCoordinates - [6 XFDF (PDF 1.4)] handled by option `export' - 7 IncludeAppendSaves (PDF 1.4) - 8 IncludeAnnotations (PDF 1.4) - [9 SubmitPDF (PDF 1.4)] handled by option `export' - 10 CanonicalFormat (PDF 1.4) - 11 ExclNonUserAnnots (PDF 1.4) - 12 ExclFKey (PDF 1.4) - 14 EmbedForm (PDF 1.5) - - New option `export' sets the export format of a submit action. - Valid values are (upper- or lowercase): - * FDF - * HTML - * XFDF - * PDF (not supported by Acrobat Reader) - -Option `pdfversion' -------------------- - This is an experimental option. It notifies `hyperref' about - the intended PDF version. Currently this is used in code for - PDF forms (implementation notes 116 and 122 of PDF spec 1.7). - - Values: 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. Values below 1.2 are not - supported, because most drivers expect higher PDF versions. - - The option must be used early, not after \usepackage{hyperref}. - - In theory this option should also set the PDF version, - but this is not generally supported. - * pdfTeX below 1.10a: unsupported. - pdfTeX >= 1.10a and < 1.30: \pdfoptionpdfminorversion - pdfTeX >= 1.30: \pdfminorversion - * dvipdfm: configuration file, example: - TeX Live 2007, texmf/dvipdfm/config/config, entry `V 2'. - * dvipdfmx: configuration file, example: - TeX Live 2007, texmf/dvipdfm/dvipdfmx.cfg, entry `V 4'. - * Ghostscript: option -dCompatibilityLevel (this is set in - `ps2pdf12', `ps2pdf13', `ps2pdf14'). - - The current PDF version is used as default if this version - can be detected (only pdfTeX >= 1.10a). Otherwise the lowest - version 1.2 is assumed. Thus `hyperref' tries to avoid PDF code - that breaks this version, but is free to use ignorable higher PDF - features. - -Field option `name' -------------------- - Many form objects uses the label argument - for several purposes: - * Layouted label. - * As name in HTML structures. - Code that is suitable for layouting with TeX can - break in the structures of the output format. - If option `name' is given, then its value is used - as name in the different output structures. Thus - the value should consist of letters only. - -Option `pdfencoding' --------------------- - The PDF format allows two encodings for bookmarks and entries - in the information dictionary: PDFDocEncoding and Unicode - as UTF-16BE. Option "pdfencoding" selects between these encodings: - * "pdfdoc" uses PDFDocEncoding. It uses just one byte per character, - but the supported characters are limited (244 in PDF-1.7). - * "unicode" sets Unicode. It is encoded as UTF-16BE. Two bytes - are used for most characters, surrogates need four bytes. - * "auto" PDFDocEncoding if the string does not contain characters - outside the encoding and Unicode otherwise. - -Color options/package hycolor ------------------------------ - See documentation of package `hycolor'. - -Option pdfusetitle ------------------- - If option pdfusetitle is set then hyperref tries to - derive the values for pdftitle and pdfauthor from - \title and \author. An optional argument for \title and - \author is supported (class amsart). - -Starred form of \autoref ------------------------- - \autoref* generates a reference without link as \ref* or \pageref*. - -Link border style ------------------ - Links can be underlined instead of the default rectangle or - options "colorlinks", "frenchlinks". This is done by option - pdfborderstyle={/S/U/W 1} - - Some remarks: - - * AR7/Linux seems to have a bug, that don't use the default - value "1" for the width, but zero, thus that the underline - is not visible without "/W 1". The same applies for - dashed boxes, eg.: - pdfborderstyle={/S/D/D[3 2]/W 1} - - * The syntax is described in the PDF specification, look for - "border style", eg. - Table 8.13 "Entries in a border style dictionary" - (specification for version 1.6) - - * The border style is removed by - pdfborderstyle={} - This is automatically done if option colorlinks is enabled. - - * Be aware that not all PDF viewers support this feature, not - even Acrobat Reader itself: - - Some support: - * AR7/Linux: "underline" and "dashed", but the border width - must be given. - * xpdf 3.00: "underline" and "dashed" - - Unsupported: - * AR5/Linux - * ghostscript 8.50 - -Option "bookmarksdepth" ------------------------ - The depth of the bookmarks can be controlled by the new - option "bookmarksdepth". The option acts globally and - distinguishes three cases: - * "bookmarksdepth" without value - Then hyperref uses the current value of counter "tocdepth". - This is the compatible behaviour and the default. - * "bookmarksdepth=<number>", the value is number (also negative): - The depth for the bookmarks are set to this number. - * "bookmarksdepth=<name>" - The <name> is a document division name (part, chapter, ...). - It must not start with a digit or minus to avoid mixing up - with the number case. Internally hyperref uses the value - of macro "\toclevel@<name>". - Examples: - \hypersetup{bookmarksdepth=paragraph} - \hypersetup{bookmarksdepth=4} % same as before - \hypersetup{bookmarksdepth} % counter "tocdepth" is used - -Option "pdfescapeform" ----------------------- - There are many places where arbitrary strings end up as - PS or PDF strings. The PS/PDF strings in parentheses form - require the protection of some characters, e.g. unmatched - left or right parentheses need escaping or the escape - character itself (backslash). - Since 2006/02/12 v6.75a the PS/PDF driver should do - this automatically. However I assume a problem with - compatibility, especially regarding the form part where - larger amounts of JavaScript code can be present. - It would be a pain to remove all the escaping, because - an additional escaping layer can falsify the code. - - Therefore a new option pdfescapeform was introduced: - * pdfescapeform=false - Escaping for the formulars are disabled, this is - the compatibility behaviour, therefore this is the default. - * pdfescapeform=true - Then the PS/PDF drivers do all the necessary escaping. - This is the logical choice and the recommended setting. - For example, the user writes JavaScript as JavaScript - and do not care about escaping characters for PS/PDF - output. - -Default driver setting ----------------------- - (hyperref >= 6.72s) - If no driver is given, hyperref tries its best to guess the - most suitable driver. Thus it loads "hpdftex", if pdfTeX is - detected running in PDF mode. Or it loads the corresponding - VTeX driver for VTeX's working modes. - Unhappily many driver programs run after the TeX compiler, - so hyperref does not have a chance (dvips, dvipdfm, ...). - In this case driver "hypertex" is loaded that supports the - HyperTeX features that are recognized by xdvi for example. - This behaviour, however, can easily be changed in the configuration - file "hyperref.cfg": - \providecommand*{\Hy@defaultdriver}{hdvips} - for dvips, or - \providecommand*{\Hy@defaultdriver}{hypertex} - for the default behaviour of hyperref. - - See also the new option `driverfallback'. - -Backref entries ---------------- - Alternative interface for formatting of backref entries, example: - -\documentclass[12pt,UKenglish]{article} - -\usepackage{babel} -\usepackage[pagebackref]{hyperref} - -% Some language options are detected by package backref. -% This affects the following macros: -% \backrefpagesname -% \backrefsectionsname -% \backrefsep -% \backreftwosep -% \backreflastsep - -\renewcommand*{\backref}[1]{ - % default interface - % #1: backref list - % - % We want to use the alternative interface, - % therefore the definition is empty here. -} -\renewcommand*{\backrefalt}[4]{% - % alternative interface - % #1: number of distinct back references - % #2: backref list with distinct entries - % #3: number of back references including duplicates - % #4: backref list including duplicates - \par - #3 citation(s) on #1 page(s): #2,\par - \ifnum#1=1 % - \ifnum#3=1 % - 1 citation on page % - \else - #3 citations on page % - \fi - \else - #3 citations on #1 pages % - \fi - #2,\par - \ifnum#3=1 % - 1 citation located at page % - \else - #3 citations located at pages % - \fi - #4.\par -} - -% The list of distinct entries can be further refined: -\renewcommand*{\backrefentrycount}[2]{% - % #1: the original backref entry - % #2: the count of citations of this entry, - % in case of duplicates greater than one - #1% - \ifnum#2>1 % - ~(#2)% - \fi -} - -\begin{document} - - \section{Hello} - \cite{ref1, ref2, ref3, ref4} - \section{World} - \cite{ref1, ref3} - \newpage - - \section{Next section} - \cite{ref1} - \newpage - - \section{Last section} - \cite{ref1, ref2} - \newpage - - \pdfbookmark[1]{Bibliography}{bib} - \begin{thebibliography}{99} - \bibitem{ref1} Dummy entry one. - - \bibitem{ref2} Dummy entry two. - - \bibitem{ref3} Dummy entry three. - - \bibitem{ref4} Dummy entry four. - - \end{thebibliography} - -\end{document} - -\phantomsection ---------------- -Set an anchor at this location. It is often used in conjunction -with \addcontentsline for sectionlike things (index, bibliography, -preface). \addcontentsline refers to the latest previous location -where an anchor is set. - - \cleardoublepage - \phantomsection - \addcontentsline{toc}{chapter}{\indexname} - \printindex - -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. - -\hypercalcbp ------------- -See manual. - - -6 PACKAGE COMPATIBILITY -======================= - -Currently only package loading orders are available: - -Note: hyperref loads package "nameref" at \begin{document}. -Sometimes this is too late, thus this package must be loaded -earlier. - -algorithm ---------- - \usepackage{float} - \usepackage{hyperref} - \usepackage[chapter]{algorithm}% eg. - -amsmath -------- - The environments equation and eqnarray are not supported too well. - For example, there might be spacing problems (eqnarray isn't recommended - anyway, see CTAN:info/l2tabu/, the situation for equation is unclear, - because nobody is interested in investigating). Consider using the - environments that package amsmath provide, e.g. gather for equation. - The environment equation can even redefined to use gather: - - \usepackage{amsmath} - \let\equation\gather - \let\endequation\endgather - -amsrefs -------- - Package loading order: - - \usepackage{hyperref} - \usepackage{amsrefs} - -arydshln, longtable ---------,---------- - Package longtable must be put before hyperref and arydshln, - hyperref after arydshln generates an error, thus the - resulting package order is then: - - \usepackage{longtable} - \usepacakge{hyperref} - \usepackage{arydshln} - -babel/magyar.ldf ----------------- - The old version 2005/03/30 v1.4j will not work. - You need at least version 1.5, maintained by P\'eter Szab\'o, - see CTAN:language/hungarian/babel/. - -babel/spanish.ldf ------------------ - Babel's spanish.ldf redefines `\.' to support `\...'. - In bookmarks (\pdfstringdef) only `\.' is supported. - If `\...' is needed, - \texorpdfstring{\...}{\dots} - can be used instead. - -bibentry --------- - Workaround: - - \makeatletter - \let\saved@bibitem\@bibitem - \makeatother - - \usepackage{bibentry} - \usepackage{hyperref} - - \begin{document} - - \begingroup - \makeatletter - \let\@bibitem\saved@bibitem - \nobibliography{database} - \endgroup - -bigfoot -------- - Hyperref does not support package `bigfoot'. And package - `bigfoot' does not support hyperref's footnotes and disables - them (hyperfootnotes=false). - -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: -> cite.sty cannot currently be used with hyperref. -> However, I can do a workaround via: -> -> \makeatletter -> \def\NAT@parse{\typeout{This is a fake Natbib command to fool Hyperref.}} -> \makeatother -> -> \usepackage[hypertex]{hyperref} -> -> so that hyperref will not redefine any of the biblabel stuff - so cite.sty -> will work as normal - although the citations will not be hyperlinked, of -> course (But this may not be an issue for many people). - -count1to --------- - Package `count1to' adds several \@addtoreset commands that confuse - `hyperref'. Therefore \theH<...> has to be fixed: - - \usepackage{count1to} - \AtBeginDocument{% *after* \usepackage{count1to} - \renewcommand*{\theHsection}{\theHchapter.\arabic{section}}% - \renewcommand*{\theHsubsection}{\theHsection.\arabic{subsection}}% - \renewcommand*{\theHsubsubsection}{\theHsubsection.\arabic{subsubsection}}% - \renewcommand*{\theHparagraph}{\theHsubsubsection.\arabic{paragraph}}% - \renewcommand*{\theHsubparagraph}{\theHparagraph.\arabic{subparagraph}}% - } - -dblaccnt --------- - pd1enc.def or puenc.def should be loaded before: - \usepackage{hyperref} - \usepackage{dblaccnt} - or see entry for "vietnam". - -easyeqn -------- - Not compatible, breaks. - -ellipsis --------- - This packages redefines \textellipsis, thus it has to be loaded - after package hyperref (pd1enc.def/puenc.def should be loaded before): - \usepackage{hyperref} - \usepackage{ellipsis} - -float ------ - \usepackage{float} - \usepackage{hyperref} - - * Several \caption commands are not supported inside one float object. - * Anchor are set at top of the float object, if its style is controlled - by float.sty. - -endnotes --------- - Unsupported. - -foiltex -------- - Update to version 2008/01/28 v2.1.4b: - Since version 6.77a hyperref does not hack into \@begindvi, - it uses package `atbegshi' instead, that hooks into \shipout. - Thus the patch of `foils.cls' regarding hyperref is now obsolete - and causes an undefined error message about \@hyperfixhead. - This is fixed in FoilTeX 2.1.4b. - -footnote --------- - This package is not supported, you have to disable hyperref's footnote - support by using option "hyperfootnotes=false". - -geometry --------- - Driver `dvipdfm' and program `dvipdfm' might generate a warning: - Sorry. Too late to change page size - Then prefer the program `dvipdfmx' or use one of the following - workarounds to move the \special of geometry to an earlier - location: - - \documentclass[dvipdfm]{article}% or other classes - \usepackage{atbegshi} - \AtBeginDocument{% - \let\OrgAtBeginDvi\AtBeginDvi - \let\AtBeginDvi\AtBeginShipoutFirst - } - \usepackage[ - paperwidth=170mm, - paperheight=240mm - ]{geometry} - \AtBeginDocument{% - \let\AtBeginDvi\OrgAtBeginDvi - } - \usepackage{hyperref} - - or - - \documentclass[dvipdfm]{article}% or other classes - \usepackage{atbegshi} - \let\AtBeginDvi\AtBeginShipoutFirst - \usepackage[ - paperwidth=170mm, - paperheight=240mm - ]{geometry} - \usepackage{hyperref} - -IEEEtran.cls ------------- - version >= V1.6b (because of \@makecaption, see ChangeLog) - -index ------ - version >= 1995/09/28 v4.1 (because of \addcontentsline redefinition) - -lastpage --------- - Compatible. - -linguex -------- - \usepackage{hyperref} - \usepackage{linguex} - -ltabptch --------- - \usepackage{longtable} - \usepackage{ltabptch} - \usepackage{hyperref} - -mathenv -------- - Unsupported. - - Both `mathenv' and `hyperref' messes around with - environment `eqnarray'. You can load `mathenv' after - `hyperref' to avoid an error message. But \label - will not work inside environment `eqnarray' properly, - for example. - -minitoc-hyper -------------- - This package is obsolete, use the uptodate original - package minitoc instead. - -multind -------- - \usepackage{multind} - \usepackage{hyperref} - -natbib ------- - \usepackage{natbib} - \usepackage{hyperref} - -nomencl -------- - * Example for introducing links for the page numbers: - \renewcommand*{\pagedeclaration}[1]{\unskip, \hyperpage{#1}} - - * For equations the following might work: - \renewcommand*{\eqdeclaration}[1]{% - \hyperlink{equation.#1}{(Equation~#1)}% - } - But the mapping from the equation number to the anchor name - is not available in general. - -parskip -------- - \usepackage{parskip} - \usepackage{hyperref}[2012/08/20] - - Both packages want to redefine \@starttoc. - -prettyref ---------- -%%% example for prettyref %%% -\documentclass{article} -\usepackage{prettyref} -\usepackage[pdftex]{hyperref} - -%\newrefformat{FIG}{Figure~\ref{#1}}% without hyperref -\newrefformat{FIG}{\hyperref[{#1}]{Figure~\ref*{#1}}} - -\begin{document} - This is a reference to \prettyref{FIG:ONE}. - \newpage - \begin{figure} - \caption{This is my figure} - \label{FIG:ONE} - \end{figure} -\end{document} -%%% example for prettyref %%% - -ntheorem --------- - ntheorem-hyper.sty is an old patched version of ntheorem.sty. - Newer versions of ntheorem know the option hyperref: - \usepackage{hyperref} - \usepackage[hyperref]{ntheorem} - But there are still unsolved problems (options thref, ...). - -setspace --------- - \usepackage{setspace} - \usepackage{hyperref} - -sidecap -------- - Before 2002/05/24 v1.5h: - \usepackage{nameref} - \usepackage{hyperref} - \usepackage{sidecap} - -subfigure ---------- - 1995/03/06 v2.0: - \usepackage{subfigure} - \usepackage{hyperref} - % hypertexnames is set to false. - v2.1: - \usepackage{nameref} - \usepackage{subfigure} - \usepackage{hyperref} - or - \usepackage{hyperref} - \usepackage{subfigure} - v2.1.2: - please update - v2.1.3: - \usepackage{hyperref} - \usepackage{subfigure} - or vice versa? - -titleref --------- - \usepackage{nameref} - \usepackage{titleref}% without usetoc - \usepackage{hyperref} - -tabularx --------- - Linked footnotes are not supported inside environment `tabularx', - because they uses the optional argument of \footnotetext, see - section `Limitations'. Before version 2011/09/28 6.82i - hyperref had disabled footnotes entirely by `hyperfootnotes=false'. - -titlesec --------- - "nameref" supports titlesec, but hyperref does not - (unsolved is the anchor setting, missing with unnumbered - section, perhaps problems with page breaks with numbered ones). - -ucs/utf8x.def -------------- - The first time a multibyte UTF8 sequence is called, it - does some calculations and stores the result in a macro - for speeding up the next calls of that UTF8 sequence. - However this makes the first call non-expandable and - will break if used in information entries or bookmarks. - Package "ucs" offers \PrerenderUnicode or \PreloadUnicodePage - to solve this: - \usepackage{ucs} - \usepackage[utf8x]{inputenc} - \usepackage{hyperref}% or with option unicode - \PrerenderUnicode{^^c3^^b6}% or \PrerenderUnicodePage{1} - \hypersetup{pdftitle={Umlaut example: ^^c3^^b6}} - The notation with two carets avoids trouble with 8-bit bytes - for the README file, you can use the characters directly. - -varioref --------- - 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. - * \vpageref[]{...} - On the same page a previous space is not suppressed. - -verse ------ - Version 2005/08/22 v2.22 contains support for hyperref. - - For older versions see example from - de.comp.text.tex (2005/08/11, slightly modified): - - \documentclass{article} - - % package order does not matter - \usepackage{verse} - \usepackage{hyperref} - - \makeatletter - % make unique poemline anchors - \newcounter{verse@env} - \setcounter{verse@env}{0} - \let\org@verse\verse - \def\verse{% - \stepcounter{verse@env}% - \org@verse - } - \def\theHpoemline{\arabic{verse@env}.\thepoemline} - - % add anchor for before \addcontentsline in \@vsptitle - \let\org@vsptitle\@vsptitle - \def\@vsptitle{% - \phantomsection - \org@vsptitle - } - \makeatother - - \begin{document} - - \poemtitle{Poem 1} - \begin{verse} - An one-liner. - \end{verse} - - \newpage - - \poemtitle{Poem 2} - \begin{verse} - Another one-liner. - \end{verse} - - \end{document} - -vietnam -------- - % pd1enc.def should be loaded before package dblaccnt: - \usepackage[PD1,OT1]{fontenc} - \usepackage{vietnam} - \usepackage{hyperref} - -XeTeX ------ - Default for the encoding of bookmarks is `pdfencoding=auto'. - That means the strings are always treated as unicode strings. - Only if the string restricts to the printable ASCII set, - it is written as ASCII string. The reason is that the - \special does not support PDFDocEncoding. - - XeTeX uses the program xdvipdfmx for PDF output generation. - This program behaves a little different from dvipdfm, because - of the supported Unicode characters. Strings for bookmarks - or information entries can be output directly. The - big chars (char code > 255) are written in UTF-8 and - xdvipdfmx tries to convert them to UTF-16BE. However - hyperref already provides PDF strings encoded in UTF-16BE, - thus the result is a warning - "Failed to convert input string to UTF16..." - The best way would be, if xdvipdfm could detect the - byte order marker (\376\377) and skips the conversion - if that marker is present. - For the time being I added the following to hyperref, - when option `pdfencoding=auto' is set (default for XeTeX): - The string is converted back to big characters thus that the - string is written as UTF-8. But I am very unhappy with this - solution. Main disadvantage: - Two versions of \pdfstringdef are needed: - a) The string is converted back to big characters for - the "tainted keys" of xdvipdfmx (spc_pdfm.c: default_taintkeys). - The subset hyperref uses is /Title, /Author, /Subject, - /Keywords, /Creator, /Producer, /T. Any changes of this - set in xdvipdfmx cannot be detected by hyperref. - b) Without conversion for the other strings , providing UTF16be - directly. Examples: Prefix of page labels, some elements - of formulars. - Thus *each* application that uses \pdfstringdef now must - check, if it defines a string for some of the tained keys. - If yes, then the call of \pdfstringdef should be preceded - by "\csname HyPsd@XeTeXBigCharstrue\endcsname". - Example: package bookmark. - - -7 LIMITATIONS -============= - -Wrapped/broken link support ---------------------------- - Only few drivers support automatically wrapped/broken links, - e.g. pdftex, dvipdfm, hypertex. Other drivers lack this - feature, e.g. dvips, dvipsone. - - Workarounds: - * For long section or caption titles in the table of contents - or list of figures/tables option "linktocpage" can be used. - Then the page number will be a link, and the overlong section - title is not forced into an one line link with overvull \hbox - warning. - * "\url"s are caught by package "breakurl". - * The option "breaklinks" is intended for internal use. But it - can be used to force link wrapping, e.g. when printing a - document. However, when such a document is converted to PDF - and viewed with a PDF viewer, the active link area will be - misplaced. - Another limitation: some penalties are "optimized" by TeX, - thus there are missing break points, especially within - \url. (See thread "hyperref.sty, breaklinks and url.sty 3.2" - in comp.text.tex 2005-09). - -Links across pages ------------------- - In general they have problems: - * Some driver doesn't support them at all (see above). - * The driver allows it, but the link result might include - the footer and/or header, or an error message can - occur sometimes. - -Footnotes ---------- - LaTeX allows the separation of the footnote mark and the - footnote text (\footnotemark, \footnotetext). This interface - might be enough for visual typesetting. But the relation between - \footnotemark to \footnotetext is not as strong as \ref to \label. - Therefore it is not clear in general which \footnotemark references - which \footnotetext. But that is necessary to implement hyperlinking. - Thus the implementation of hyperref does not support the optional - argument of \footnotemark and \footnotetext. - - -8 HINTS -======= - -Spaces in option values ------------------------ - Unhappily LaTeX strips spaces from options if they are given - in \documentclass or \usepackage (or \RequirePackage), e.g.: - \usepackage[pdfborder=0 0 1]{hyperref} - Package hyperref now gets - pdfborder=001 - and the result is an invalid PDF file. - As workaround braces can be used: - \usepackage[pdfborder={0 0 1}]{hyperref} - Some options can also be given in \hypersetup: - \hypersetup{pdfborder=0 0 1} - In \hypersetup the options are directly processed as key value - options (see package keyval) without space stripping in the value part. - - Alternatively, LaTeX's option handling system can be adapted - to key value options by one of the packages "kvoptions-patch" - (from project "kvoptions") or "xkvltxp" (from project "xsetkeys"). - -Index with makeindex --------------------- - * Package hyperref adds \hyperpage commands by the encap - mechanism (see documentation of Makeindex), - if option hyperindex is set (default). - \hyperpage uses the page anchors that are set by - hyperref at each page (default). However in the - default case page numbers are used in anchor names - in arabic form. If the page numbers in other formats - are used (book class with \frontmatter, \romannumbering, ...), - then the page anchors are not unique. Therefore option - "plainpages=false" is recommended. - * The encap mechanism of Makeindex allows to use one command only - (see documentation of Makeindex). - If the user sets such a command, hyperref suppresses its - \hyperpage command. With logical markup this situation - can easily be solved: - \usepackage{makeidx} - \makeindex - \usepackage[hyperindex]{hyperref} - \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} - * An other possibility is the insertion of \hyperpage by - a style file for makeindex. For this case, hyperref's - insertion will be disabled by "hyperindex=false". - \hyperpage will be defined regardless of setting of hyperindex. - -%%% cut %%% hyperindex.ist %%% cut %%% -delim_0 ", \\hyperpage{" -delim_1 ", \\hyperpage{" -delim_2 ", \\hyperpage{" -delim_n "}, \\hyperpage{" -delim_t "}" -encap_prefix "}\\" -encap_infix "{\\hyperpage{" -encap_suffix "}" -%%% cut %%% hyperindex.ist %%% cut %%% - -Warning "bookmark level for unknown <foobar> defaults to 0" ------------------------------------------------------------ - Getting rid of it: - -\makeatletter -\providecommand*{\toclevel@<foobar>}{0} -\makeatother - -Link anchors in figures ------------------------ - The caption command increments the counter and here is the - place where hyperref set the corresponding anchor. Unhappily - the caption is set below the figure, so the figure is not - visible if a link jumps to a figure. - In this cases, try package "hypcap.sty" that implements - a method to circumvent the problem. - -Additional unicode characters in bookmarks and pdf information entries: ------------------------------------------------------------------------ -\documentclass[pdftex]{article} -\usepackage[unicode]{hyperref} - -% Support for additional unicode characters: -% -% Example: \.{a} and \d{a} -% -% 1. Get a list with unicode data, eg: -% http://www.unicode.org/Public/UNIDATA/UnicodeData.txt -% -% 2. Identify the characters (\.{a}, \d{a}): -% -% 0227;LATIN SMALL LETTER A WITH DOT ABOVE;... -% 1EA1;LATIN SMALL LETTER A WITH DOT BELOW;... -% -% 3. Calculate the octal code: -% The first characters of the line in the file are -% hex values, convert each byte and prepend them -% with a backslash. (This will go into the PDF file.) -% -% 0227 -> \002\047 -% 1EA1 -> \036\241 -% -% 4. Transform into a form understood by hyperref: -% -% Hyperref must know where the first byte starts, -% this is marked by "9" (8 and 9 cannot occur in -% octal numbers): -% -% \002\047 -> \9002\047 -% \036\241 -> \9036\241 -% -% Optional: "8" is used for abbreviations: -% \900 = \80, \901 = \81, \902 = \82, ... -% -% \9002\047 -> \82\047 -% -% 5. Declare the character with LaTeX: -% -\DeclareTextCompositeCommand{\.}{PU}{a}{\82\047} -\DeclareTextCompositeCommand{\d}{PU}{a}{\9036\241} - -\begin{document} -\section{\={a}, \d{a}, \'{a}, \.{a}} -\end{document} - -Footnotes ---------- - The footnote support is rather limited. It is beyond the scope - to use \footnotemark and \footnotetext out of order or reusing - \footnotemark. Here you can either disable hyperref's footnote - support by "hyperfootnotes=false" or fiddle with internal macros, - nasty examples: - -\documentclass{article} -\usepackage{hyperref} -\begin{document} -Hello% -\footnote{The first footnote} -World% -\addtocounter{footnote}{-1}% -\addtocounter{Hfootnote}{-1}% -\footnotemark. -\end{document} - - or - -\documentclass{article} - -\usepackage{hyperref} - -\begin{document} - -\makeatletter - -A% - \footnotemark - \let\saved@Href@A\Hy@footnote@currentHref - % remember link name -B% - \footnotemark - \let\saved@Href@B\Hy@footnote@currentHref -b% - \addtocounter{footnote}{-1}% - \addtocounter{Hfootnote}{-1}% generate the same anchor - \footnotemark -C% - \footnotemark - \let\saved@Href@C\Hy@footnote@currentHref - - \addtocounter{footnote}{-2}% - \let\Hy@footnote@currentHref\saved@Href@A -\footnotetext{AAAA}% - \addtocounter{footnote}{1}% - \let\Hy@footnote@currentHref\saved@Href@B -\footnotetext{BBBBB}% - \addtocounter{footnote}{1}% - \let\Hy@footnote@currentHref\saved@Href@C -\footnotetext{CCCC}% - -\end{document} - -Subordinate counters --------------------- - Some counters do not have unique values and require the value - of other counters to be unique. For example, sections or figures - might be numbered within chapters or \newtheorem is used with - an optional counter argument. Internally LaTeX uses \@addtoreset - to reset a counter in dependency to another counter. Package - hyperref hooks into \@addtoreset to catch this situation. - Also \numberwithin of package amsmath is catched by hyperref. - - However, if the definition of subordinate counters take place - before hyperref is loaded, the old meaning of \@addtoreset is - called without hyperref's additions. Then the companion counter - macro \theH<counter> can be redefined accordingly. Or move the - definition of subordinate counters after hyperref is loaded. - - Example for \newtheorem, problematic case: - \newtheorem{corA}{CorollaryA}[section] - \usepackage{hyperref} - Solution a) - \usepackage{hyperref} - \newtheorem{corA}{CorollaryA}[section} - Solution b) - \newtheorem{corA}{CorollaryA}[section] - \usepackage{hyperref} - \newcommand*{\theHcorA}{\theHsection.\number\value{corA}} - - -9 AUTHORS/MAINTAINERS -===================== - -* Sebastian Rahtz (died 2016) -* Heiko Oberdiek - - -10 BUG REPORTS -============== - -A bug report should contain: -* Comprehensive problem description. This includes error or - warning messages. - * \errorcontextlines=\maxdimen can be added in the TeX code - to get more informations in TeX error messages. -* Minimal test file that shows the problem, but does not - contain any unnecessary packages and code. -* Used drivers/programs. -* Version information about used packages and programs. - * If you are using LaTeX, then add "\listfiles". Then - a list of version informations is printed at the end - of the LaTeX run. -* Please no other files than the minimal test file. - The other files .log, .dvi, .ps, .pdf are seldom necessary, - so send them only on request. - -Bug address ------------ -A bug tracker is available at github: - https://github.com/ho-tex/oberdiek/issues -Alternatively bug reports can be send to the support group public email list: - <ho-tex [at] tug [dot] org> - -Vietnamese part ---------------- -Responsible for the Vietnamese translations of the -\autoref names and puvnenc.def are: - Han The Thanh <hanthethanh [at] gmail [dot] com> - Reinhard Kotucha <reinhard [dot] kotucha at web [dot] de> - -Arabic part ------------ -Responsible for the additions to PU encoding for Arabi is - Youssef Jabri <yjabri [at] ensa [dot] univ-oujda [dot] ac [dot] ma> - - -11 KNOWN PROBLEMS -================= - -* (half-done) hyper images (link from thumbnail in text) -* Relative links are not sorted out or documented well. - For PDF generation: - * With baseurl: all links are considered relative to this URL. - * Without baseurl: a relative link without "file:" can be - achieved by: - \begingroup - \hypersetup{linkfileprefix={}}% - \href{../foo/bar.html}{bar.html} - \endgroup -* ... - - -12 TODO -======= - -* modules -* bookmark organisation -* documentation -* PDF threads -* more for PDF forms - * per object setting - * vary gap between text and box -* PostScript driver: the current implementation doesn't relly support - nested links. The start positions should be remembered in a stack, - but there are complications with page breaks. -* ... - - -13 VERSIONS IN TEX DISTRIBUTIONS -================================ - -TeX Live --------- -* TL 2016: 2016/05/05 v6.83n (at time of first release) -* TL 2011: 2011/04/17 v6.82g (at time of first release) -* TL 2010: 2010/06/18 v6.81g (at time of first release) -* TL 2009: 2009/10/09 v6.79a (at time of first release) -* TL 2008: 2008/08/14 v6.78f (at time of first release) -* TL 2007: 2007/02/07 v6.75r -* TL 2005: 2003/11/30 v6.74m -* TL 2004: 2003/11/30 v6.74m -* TL 2003: 2003/09/15 v6.74i -* TL 7 (2002): 2002/05/27 v6.72r -* TL 6b (2001): 2001/05/26 v6.71g -* TL 5d (2000): 2000/07/02 v6.70m -* TL 5c (2000): 2000/05/08 v6.70f -* TL 4 (1999): 1999/04/13 v6.56 -* TL 3 (1998): 1998/03/25 v6.19 - diff --git a/Master/texmf-dist/doc/latex/hyperref/README.md b/Master/texmf-dist/doc/latex/hyperref/README.md new file mode 100644 index 00000000000..053fca439ea --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/README.md @@ -0,0 +1,182 @@ +# README for hyperref bundle +2018-09-30 + + +## INTRODUCTION + + +This package is used to emend cross-referencing commands in LaTeX to +produce some sort of \special commands; there are backends for the +\special set defined for HyperTeX dvi processors, for embedded pdfmark +commands for processing by Acrobat Distiller (dvips and dvipsone), for +dviwindo, for pdfTeX, for dvipdfm, for TeX4ht, and for VTEX's pdf and HTML +backends. + +Included are: + + 1. `hyperef' The main hyperlinking functionality. + 2. `backref' a package by David Carlisle to provide links back from + bibliography to the main text; these are hypertext links after using + hyperref. + 3. nameref' a package to allow reference to the *names* of sections rather + than their numbers. + +## DOWNLOAD + + +`hyperref' is available on CTAN: + CTAN:macros/latex/contrib/hyperref/ + +Also a ZIP file is provided that contains the files, already sorted +in a TDS tree: + CTAN:install/macros/latex/contrib/hyperref.tds.zip + +"CTAN:" means one of the `Comprehensive TeX Archive Network' +nodes or one of its mirrors. This is explained in + https://texfaq.org/FAQ-archives + +The main repository of hyperref is located at github + https://github.com/ho-tex/hyperref + + +## INSTALLATION + + +### Installation with ZIP file in TDS format + +The ZIP file `hyperref.tds.zip' contains the files sorted +in a TDS tree. Thus you can directly unpack the ZIP file +inside a TDS tree. (See CTAN:tds.zip for an explanation of TDS.) +Example: +``` + cd /...somewhere.../texmf + unzip /...downloadpath.../hyperref.tds.zip +``` +Do not forget to refresh the file name database of this TDS tree, +Example: +``` + texhash /...somewhere.../texmf +``` + +### Manual installation + + 1. Download the hyperref files from CTAN or the TUG server. + If necessary, unpack them. + 2. If directory `beta' exists, replace the files by the counterparts + in this directory, if you want to use the latest versions. + 3. Generate the package and driver files: + tex hyperref.ins + 4. Install the files `*.sty', `*.def', and `*.cfg' in your TDS tree: + cp *.sty *.def *.cfg TDS:tex/latex/hyperref/ + Replace `TDS:' by the prefix of your TDS tree (texmf directory). + The exception is bmhydoc.sty, it belongs to the source files + (TDS:source/latex/hyperref/). + 5. Copy the documentation files to "TDS:doc/latex/hyperref/": + manual.pdf, README, README.pdf, ChangeLog, ChangeLog.pdf, + slides.pdf, paper.pdf, options.pdf, hyperref.pdf, backref.pdf, + nameref.pdf (Also the HTML version of the manual can be put there.) + 6. Update the databases if necessary, eg. for teTeX: + mktexlsr .../texmf + +## AUTHORS/MAINTAINERS + + + * Sebastian Rahtz (died 2016) + * Heiko Oberdiek + * David Carlisle (via GitHub ho-tex origanisation) + + +## BUG REPORTS + + +A bug report should contain: + + * Comprehensive problem description. This includes error or + warning messages. + * \errorcontextlines=\maxdimen can be added in the TeX code + to get more informations in TeX error messages. + * Minimal test file that shows the problem, but does not + contain any unnecessary packages and code. + * Used drivers/programs. + * Version information about used packages and programs. + * If you are using LaTeX, then add "\listfiles". Then + a list of version informations is printed at the end + of the LaTeX run. + * Please no other files than the minimal test file. + The other files .log, .dvi, .ps, .pdf are seldom necessary, + so send them only on request. + +## Bug address + +A bug tracker is available at github: + https://github.com/ho-tex/oberdiek/issues + +Alternatively bug reports can be send to the support group public email list: + <ho-tex [at] tug [dot] org> + +## Vietnamese part + +Responsible for the Vietnamese translations of the +\autoref names and puvnenc.def are: + Han The Thanh <hanthethanh [at] gmail [dot] com> + Reinhard Kotucha <reinhard [dot] kotucha at web [dot] de> + +## Arabic part + +Responsible for the additions to PU encoding for Arabi is + Youssef Jabri <yjabri [at] ensa [dot] univ-oujda [dot] ac [dot] ma> + + +## KNOWN PROBLEMS + + + * (half-done) hyper images (link from thumbnail in text) + * Relative links are not sorted out or documented well. + For PDF generation: + * With baseurl: all links are considered relative to this URL. + * Without baseurl: a relative link without "file:" can be + achieved by: + ``` + \begingroup + \hypersetup{linkfileprefix={}}% + \href{../foo/bar.html}{bar.html} + \endgroup + ``` + * ... + + +## TODO + + * modules + * bookmark organisation + * documentation + * PDF threads + * more for PDF forms + * per object setting + * vary gap between text and box + * PostScript driver: the current implementation doesn't relly support + nested links. The start positions should be remembered in a stack, + but there are complications with page breaks. + * ... + + +## VERSIONS IN TEX DISTRIBUTIONS + +| TeX Live | hyperref | comment | +| -------- | -------- | ------- | +| TL 2016 | 2016/05/05 v6.83n | (at time of first release) | +| TL 2011 | 2011/04/17 v6.82g | (at time of first release) | +| TL 2010 | 2010/06/18 v6.81g | (at time of first release) | +| TL 2009 | 2009/10/09 v6.79a | (at time of first release) | +| TL 2008 | 2008/08/14 v6.78f | (at time of first release) | +| TL 2007 | 2007/02/07 v6.75r | | +| TL 2005 | 2003/11/30 v6.74m | | +| TL 2004 | 2003/11/30 v6.74m | | +| TL 2003 | 2003/09/15 v6.74i | | +| TL 7 (2002) | 2002/05/27 v6.72r | | +| TL 6b (2001) | 2001/05/26 v6.71g | | +| TL 5d (2000) | 2000/07/02 v6.70m | | +| TL 5c (2000) | 2000/05/08 v6.70f | | +| TL 4 (1999) | 1999/04/13 v6.56 | | +| TL 3 (1998) | 1998/03/25 v6.19 | | + diff --git a/Master/texmf-dist/doc/latex/hyperref/README.pdf b/Master/texmf-dist/doc/latex/hyperref/README.pdf Binary files differdeleted file mode 100644 index 6ea4ea6aa18..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/README.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/hyperref/backref.pdf b/Master/texmf-dist/doc/latex/hyperref/backref.pdf Binary files differindex 87f1ace8df7..ea342ad4ae2 100644 --- a/Master/texmf-dist/doc/latex/hyperref/backref.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/backref.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf b/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf Binary files differdeleted file mode 100644 index cd677b888fe..00000000000 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.html b/Master/texmf-dist/doc/latex/hyperref/manual.html index 1387156d966..b568eec95b0 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual.html @@ -21,7 +21,7 @@ class="ec-lmr-12">Sebastian Rahtz </span><br class="and" /><span class="ec-lmr-12">Heiko Oberdiek</span></div><br /> <div class="date" ><span -class="ec-lmr-12">January 2017</span></div> +class="ec-lmr-12">September 2018</span></div> </div> <h3 class="likesectionHead"><a id="x1-1000"></a>Contents</h3> @@ -62,47 +62,216 @@ href="#x1-170004.1.2" id="QQ2-1-17">Replacement macros</a></span> <br />  <span class="subsectionToc" >4.2 <a href="#x1-180004.2" id="QQ2-1-18">Utility macros</a></span> <br /> <span class="sectionToc" >5 <a -href="#x1-190005" id="QQ2-1-19">Acrobat-specific behavior</a></span> +href="#x1-190005" id="QQ2-1-19">New Features</a></span> +<br />  <span class="subsectionToc" >5.1 <a +href="#x1-200005.1" id="QQ2-1-20">Option ‘pdflinkmargin’</a></span> +<br />  <span class="subsectionToc" >5.2 <a +href="#x1-210005.2" id="QQ2-1-21">Field option ‘calculatesortkey’</a></span> +<br />  <span class="subsectionToc" >5.3 <a +href="#x1-220005.3" id="QQ2-1-22">Option ‘localanchorname’</a></span> +<br />  <span class="subsectionToc" >5.4 <a +href="#x1-230005.4" id="QQ2-1-23">Option ‘customdriver’</a></span> +<br />  <span class="subsectionToc" >5.5 <a +href="#x1-240005.5" id="QQ2-1-24">Option ‘psdextra’</a></span> +<br />  <span class="subsectionToc" >5.6 <a +href="#x1-250005.6" id="QQ2-1-25">\XeTeXLinkBox</a></span> +<br />  <span class="subsectionToc" >5.7 <a +href="#x1-260005.7" id="QQ2-1-26">\IfHyperBooleanExists and \IfHyperBoolean</a></span> +<br />  <span class="subsectionToc" >5.8 <a +href="#x1-270005.8" id="QQ2-1-27">\unichar</a></span> +<br />  <span class="subsectionToc" >5.9 <a +href="#x1-280005.9" id="QQ2-1-28">\ifpdfstringunicode</a></span> +<br />  <span class="subsectionToc" >5.10 <a +href="#x1-290005.10" id="QQ2-1-29">Customizing index style file with \nohyperpage</a></span> +<br />  <span class="subsectionToc" >5.11 <a +href="#x1-300005.11" id="QQ2-1-30">Experimental option ‘ocgcolorlinks’</a></span> +<br />  <span class="subsectionToc" >5.12 <a +href="#x1-310005.12" id="QQ2-1-31">Option ‘pdfa’</a></span> +<br />  <span class="subsectionToc" >5.13 <a +href="#x1-320005.13" id="QQ2-1-32">Option ‘linktoc’ added</a></span> + +<br />  <span class="subsectionToc" >5.14 <a +href="#x1-330005.14" id="QQ2-1-33">Option ‘pdfnewwindow’ changed</a></span> +<br />  <span class="subsectionToc" >5.15 <a +href="#x1-340005.15" id="QQ2-1-34">Flag options for PDF forms</a></span> +<br />  <span class="subsectionToc" >5.16 <a +href="#x1-350005.16" id="QQ2-1-35">Option ‘pdfversion’</a></span> +<br />  <span class="subsectionToc" >5.17 <a +href="#x1-360005.17" id="QQ2-1-36">Field option ‘name’</a></span> +<br />  <span class="subsectionToc" >5.18 <a +href="#x1-370005.18" id="QQ2-1-37">Option ‘pdfencoding’</a></span> +<br />  <span class="subsectionToc" >5.19 <a +href="#x1-380005.19" id="QQ2-1-38">Color options/package hycolor</a></span> +<br />  <span class="subsectionToc" >5.20 <a +href="#x1-390005.20" id="QQ2-1-39">Option pdfusetitle</a></span> +<br />  <span class="subsectionToc" >5.21 <a +href="#x1-400005.21" id="QQ2-1-40">Starred form of \autoref</a></span> +<br />  <span class="subsectionToc" >5.22 <a +href="#x1-410005.22" id="QQ2-1-41">Link border style</a></span> +<br />  <span class="subsectionToc" >5.23 <a +href="#x1-420005.23" id="QQ2-1-42">Option "bookmarksdepth"</a></span> +<br />  <span class="subsectionToc" >5.24 <a +href="#x1-430005.24" id="QQ2-1-43">Option "pdfescapeform"</a></span> +<br />  <span class="subsectionToc" >5.25 <a +href="#x1-440005.25" id="QQ2-1-44">Default driver setting</a></span> +<br />  <span class="subsectionToc" >5.26 <a +href="#x1-450005.26" id="QQ2-1-45">Backref entries</a></span> +<br />  <span class="subsectionToc" >5.27 <a +href="#x1-460005.27" id="QQ2-1-46">\phantomsection</a></span> <br /> <span class="sectionToc" >6 <a -href="#x1-200006" id="QQ2-1-20">PDF and HTML forms</a></span> -<br />  <span class="subsectionToc" >6.1 <a -href="#x1-210006.1" id="QQ2-1-21">Forms environment parameters</a></span> -<br />  <span class="subsectionToc" >6.2 <a -href="#x1-220006.2" id="QQ2-1-22">Forms optional parameters</a></span> +href="#x1-470006" id="QQ2-1-47">Acrobat-specific behavior</a></span> <br /> <span class="sectionToc" >7 <a -href="#x1-230007" id="QQ2-1-23">Defining a new driver</a></span> +href="#x1-480007" id="QQ2-1-48">PDF and HTML forms</a></span> +<br />  <span class="subsectionToc" >7.1 <a +href="#x1-490007.1" id="QQ2-1-49">Forms environment parameters</a></span> +<br />  <span class="subsectionToc" >7.2 <a +href="#x1-500007.2" id="QQ2-1-50">Forms optional parameters</a></span> <br /> <span class="sectionToc" >8 <a -href="#x1-240008" id="QQ2-1-24">Special support for other packages</a></span> +href="#x1-510008" id="QQ2-1-51">Defining a new driver</a></span> <br /> <span class="sectionToc" >9 <a -href="#x1-250009" id="QQ2-1-25">History and acknowledgments</a></span> +href="#x1-520009" id="QQ2-1-52">Special support for other packages</a></span> +<br />  <span class="subsectionToc" >9.1 <a +href="#x1-530009.1" id="QQ2-1-53">Package Compatibility</a></span> +<br />   <span class="subsubsectionToc" >9.1.1 <a +href="#x1-540009.1.1" id="QQ2-1-54">algorithm</a></span> +<br />   <span class="subsubsectionToc" >9.1.2 <a +href="#x1-550009.1.2" id="QQ2-1-55">amsmath</a></span> +<br />   <span class="subsubsectionToc" >9.1.3 <a +href="#x1-560009.1.3" id="QQ2-1-56">amsrefs</a></span> +<br />   <span class="subsubsectionToc" >9.1.4 <a +href="#x1-570009.1.4" id="QQ2-1-57">arydshln, longtable</a></span> +<br />   <span class="subsubsectionToc" >9.1.5 <a +href="#x1-580009.1.5" id="QQ2-1-58">babel/magyar.ldf</a></span> +<br />   <span class="subsubsectionToc" >9.1.6 <a +href="#x1-590009.1.6" id="QQ2-1-59">babel/spanish.ldf</a></span> +<br />   <span class="subsubsectionToc" >9.1.7 <a +href="#x1-600009.1.7" id="QQ2-1-60">bibentry</a></span> +<br />   <span class="subsubsectionToc" >9.1.8 <a +href="#x1-610009.1.8" id="QQ2-1-61">bigfoot</a></span> +<br />   <span class="subsubsectionToc" >9.1.9 <a +href="#x1-620009.1.9" id="QQ2-1-62">chappg</a></span> +<br />   <span class="subsubsectionToc" >9.1.10 <a +href="#x1-630009.1.10" id="QQ2-1-63">cite</a></span> +<br />   <span class="subsubsectionToc" >9.1.11 <a +href="#x1-640009.1.11" id="QQ2-1-64">count1to</a></span> +<br />   <span class="subsubsectionToc" >9.1.12 <a +href="#x1-650009.1.12" id="QQ2-1-65">dblaccnt</a></span> +<br />   <span class="subsubsectionToc" >9.1.13 <a +href="#x1-660009.1.13" id="QQ2-1-66">easyeqn</a></span> +<br />   <span class="subsubsectionToc" >9.1.14 <a +href="#x1-670009.1.14" id="QQ2-1-67">ellipsis</a></span> +<br />   <span class="subsubsectionToc" >9.1.15 <a +href="#x1-680009.1.15" id="QQ2-1-68">float</a></span> +<br />   <span class="subsubsectionToc" >9.1.16 <a +href="#x1-690009.1.16" id="QQ2-1-69">endnotes</a></span> +<br />   <span class="subsubsectionToc" >9.1.17 <a +href="#x1-700009.1.17" id="QQ2-1-70">foiltex</a></span> +<br />   <span class="subsubsectionToc" >9.1.18 <a +href="#x1-710009.1.18" id="QQ2-1-71">footnote</a></span> +<br />   <span class="subsubsectionToc" >9.1.19 <a +href="#x1-720009.1.19" id="QQ2-1-72">geometry</a></span> +<br />   <span class="subsubsectionToc" >9.1.20 <a +href="#x1-730009.1.20" id="QQ2-1-73">IEEEtran.cls</a></span> +<br />   <span class="subsubsectionToc" >9.1.21 <a +href="#x1-740009.1.21" id="QQ2-1-74">index</a></span> +<br />   <span class="subsubsectionToc" >9.1.22 <a +href="#x1-750009.1.22" id="QQ2-1-75">lastpage</a></span> +<br />   <span class="subsubsectionToc" >9.1.23 <a +href="#x1-760009.1.23" id="QQ2-1-76">linguex</a></span> +<br />   <span class="subsubsectionToc" >9.1.24 <a +href="#x1-770009.1.24" id="QQ2-1-77">ltabptch</a></span> +<br />   <span class="subsubsectionToc" >9.1.25 <a +href="#x1-780009.1.25" id="QQ2-1-78">mathenv</a></span> +<br />   <span class="subsubsectionToc" >9.1.26 <a +href="#x1-790009.1.26" id="QQ2-1-79">minitoc-hyper</a></span> +<br />   <span class="subsubsectionToc" >9.1.27 <a +href="#x1-800009.1.27" id="QQ2-1-80">multind</a></span> +<br />   <span class="subsubsectionToc" >9.1.28 <a +href="#x1-810009.1.28" id="QQ2-1-81">natbib</a></span> +<br />   <span class="subsubsectionToc" >9.1.29 <a +href="#x1-820009.1.29" id="QQ2-1-82">nomencl</a></span> +<br />   <span class="subsubsectionToc" >9.1.30 <a +href="#x1-830009.1.30" id="QQ2-1-83">parskip</a></span> +<br />   <span class="subsubsectionToc" >9.1.31 <a +href="#x1-840009.1.31" id="QQ2-1-84">prettyref</a></span> + +<br />   <span class="subsubsectionToc" >9.1.32 <a +href="#x1-850009.1.32" id="QQ2-1-85">ntheorem</a></span> +<br />   <span class="subsubsectionToc" >9.1.33 <a +href="#x1-860009.1.33" id="QQ2-1-86">setspace</a></span> +<br />   <span class="subsubsectionToc" >9.1.34 <a +href="#x1-870009.1.34" id="QQ2-1-87">sidecap</a></span> +<br />   <span class="subsubsectionToc" >9.1.35 <a +href="#x1-880009.1.35" id="QQ2-1-88">subfigure</a></span> +<br />   <span class="subsubsectionToc" >9.1.36 <a +href="#x1-890009.1.36" id="QQ2-1-89">titleref</a></span> +<br />   <span class="subsubsectionToc" >9.1.37 <a +href="#x1-900009.1.37" id="QQ2-1-90">tabularx</a></span> +<br />   <span class="subsubsectionToc" >9.1.38 <a +href="#x1-910009.1.38" id="QQ2-1-91">titlesec</a></span> +<br />   <span class="subsubsectionToc" >9.1.39 <a +href="#x1-920009.1.39" id="QQ2-1-92">ucs/utf8x.def</a></span> +<br />   <span class="subsubsectionToc" >9.1.40 <a +href="#x1-930009.1.40" id="QQ2-1-93">varioref</a></span> +<br />   <span class="subsubsectionToc" >9.1.41 <a +href="#x1-940009.1.41" id="QQ2-1-94">verse</a></span> +<br />   <span class="subsubsectionToc" >9.1.42 <a +href="#x1-950009.1.42" id="QQ2-1-95">vietnam</a></span> +<br />   <span class="subsubsectionToc" >9.1.43 <a +href="#x1-960009.1.43" id="QQ2-1-96">XeTeX</a></span> <br /> <span class="sectionToc" >10 <a -href="#x1-2600010" id="QQ2-1-26">GNU Free Documentation License</a></span> +href="#x1-9700010" id="QQ2-1-97">Limitiations</a></span> <br />  <span class="subsectionToc" >10.1 <a -href="#x1-2800010.1" id="QQ2-1-28">Applicability and definitions</a></span> +href="#x1-9800010.1" id="QQ2-1-98">Wrapped/broken link support</a></span> <br />  <span class="subsectionToc" >10.2 <a -href="#x1-2900010.2" id="QQ2-1-29">Verbatim copying</a></span> +href="#x1-9900010.2" id="QQ2-1-99">Links across pages</a></span> <br />  <span class="subsectionToc" >10.3 <a -href="#x1-3000010.3" id="QQ2-1-30">Copying in quantity</a></span> -<br />  <span class="subsectionToc" >10.4 <a -href="#x1-3100010.4" id="QQ2-1-31">Modifications</a></span> -<br />  <span class="subsectionToc" >10.5 <a -href="#x1-3200010.5" id="QQ2-1-32">Combining documents</a></span> -<br />  <span class="subsectionToc" >10.6 <a -href="#x1-3300010.6" id="QQ2-1-33">Collections of documents</a></span> - -<br />  <span class="subsectionToc" >10.7 <a -href="#x1-3400010.7" id="QQ2-1-34">Aggregation with independent works</a></span> -<br />  <span class="subsectionToc" >10.8 <a -href="#x1-3500010.8" id="QQ2-1-35">Translation</a></span> -<br />  <span class="subsectionToc" >10.9 <a -href="#x1-3600010.9" id="QQ2-1-36">Termination</a></span> -<br />  <span class="subsectionToc" >10.10 <a -href="#x1-3700010.10" id="QQ2-1-37">Future revisions of this license</a></span> +href="#x1-10000010.3" id="QQ2-1-100">Footnotes</a></span> +<br /> <span class="sectionToc" >11 <a +href="#x1-10100011" id="QQ2-1-101">Hints</a></span> +<br />  <span class="subsectionToc" >11.1 <a +href="#x1-10200011.1" id="QQ2-1-102">Spaces in option values</a></span> +<br />  <span class="subsectionToc" >11.2 <a +href="#x1-10300011.2" id="QQ2-1-103">Index with makeindex</a></span> +<br />  <span class="subsectionToc" >11.3 <a +href="#x1-10400011.3" id="QQ2-1-104">Warning "bookmark level for unknown <foobar> defaults to 0"</a></span> +<br />  <span class="subsectionToc" >11.4 <a +href="#x1-10500011.4" id="QQ2-1-105">Link anchors in figures</a></span> +<br />  <span class="subsectionToc" >11.5 <a +href="#x1-10600011.5" id="QQ2-1-106">Additional unicode characters in bookmarks and pdf information entries:</a></span> +<br />  <span class="subsectionToc" >11.6 <a +href="#x1-10700011.6" id="QQ2-1-107">Footnotes</a></span> +<br />  <span class="subsectionToc" >11.7 <a +href="#x1-10800011.7" id="QQ2-1-108">Subordinate counters</a></span> +<br /> <span class="sectionToc" >12 <a +href="#x1-10900012" id="QQ2-1-109">History and acknowledgments</a></span> +<br /> <span class="sectionToc" >13 <a +href="#x1-11000013" id="QQ2-1-110">GNU Free Documentation License</a></span> +<br />  <span class="subsectionToc" >13.1 <a +href="#x1-11200013.1" id="QQ2-1-112">Applicability and definitions</a></span> +<br />  <span class="subsectionToc" >13.2 <a +href="#x1-11300013.2" id="QQ2-1-113">Verbatim copying</a></span> +<br />  <span class="subsectionToc" >13.3 <a +href="#x1-11400013.3" id="QQ2-1-114">Copying in quantity</a></span> +<br />  <span class="subsectionToc" >13.4 <a +href="#x1-11500013.4" id="QQ2-1-115">Modifications</a></span> +<br />  <span class="subsectionToc" >13.5 <a +href="#x1-11600013.5" id="QQ2-1-116">Combining documents</a></span> +<br />  <span class="subsectionToc" >13.6 <a +href="#x1-11700013.6" id="QQ2-1-117">Collections of documents</a></span> +<br />  <span class="subsectionToc" >13.7 <a +href="#x1-11800013.7" id="QQ2-1-118">Aggregation with independent works</a></span> +<br />  <span class="subsectionToc" >13.8 <a +href="#x1-11900013.8" id="QQ2-1-119">Translation</a></span> +<br />  <span class="subsectionToc" >13.9 <a +href="#x1-12000013.9" id="QQ2-1-120">Termination</a></span> +<br />  <span class="subsectionToc" >13.10 <a +href="#x1-12100013.10" id="QQ2-1-121">Future revisions of this license</a></span> </div> -<!--l. 189--><p class="noindent" > +<!--l. 187--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">1 </span> <a id="x1-20001"></a>Introduction</h3> -<!--l. 191--><p class="noindent" >The package derives from, and builds on, the work of the Hyper<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> project, described at +<!--l. 189--><p class="noindent" >The package derives from, and builds on, the work of the Hyper<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> project, described at <a href="http://xxx.lanl.gov/hypertex/" class="url" ><span class="ec-lmvtt-10">http://xxx.lanl.gov/hypertex/</span></a>. It extends the functionality of all the <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> cross-referencing @@ -111,7 +280,7 @@ class="ec-lmvtt-10">\special </span>commands which a driver can turn into hypertext links; it also provides new commands to allow the user to write <span class="ec-lmri-10">ad hoc</span> hypertext links, including those to external documents and URLs. -<!--l. 199--><p class="indent" > This manual provides a brief overview of the <span +<!--l. 197--><p class="indent" > This manual provides a brief overview of the <span class="ec-lmss-10">hyperref </span>package. For more details, you should read the additional documentation distributed with the package, as well as the complete documentation by processing <span @@ -125,7 +294,9 @@ class="ec-lmri-10">E</span></span><span class="ec-lmri-10">X</span></span></span> <span class="ec-lmri-10">Web Companion</span>, where you will find additional examples. -<!--l. 206--><p class="indent" > The Hyper<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> specification<span class="footnote-mark"><a + + +<!--l. 204--><p class="indent" > The Hyper<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span> specification<span class="footnote-mark"><a href="manual2.html#fn1x0"><sup class="textsuperscript">1</sup></a></span><a id="x1-2001f1"></a> says that conformant viewers/translators must recognize the following set of <span @@ -167,7 +338,7 @@ class="ec-lmvtt-10">html:<base</span><span class="ec-lmvtt-10"> href</span><span class="ec-lmvtt-10"> =</span><span class="ec-lmvtt-10"> "href_string"></span></span></span></dd></dl> -<!--l. 218--><p class="indent" > The <span +<!--l. 216--><p class="indent" > The <span class="ec-lmri-10">href</span>, <span class="ec-lmri-10">name </span>and <span class="ec-lmri-10">end </span>commands are used to do the basic hypertext operations of establishing links @@ -178,7 +349,7 @@ The <span class="ec-lmri-10">base_name </span>command is be used to communicate to the DVI viewer the full (URL) location of the current document so that files specified by relative URLs may be retrieved correctly. -<!--l. 227--><p class="indent" > The <span +<!--l. 225--><p class="indent" > The <span class="ec-lmri-10">href </span>and <span class="ec-lmri-10">name </span>commands must be paired with an <span class="ec-lmri-10">end </span>command later in the <span class="TEX">T<span @@ -202,12 +373,11 @@ class="ec-lmri-10">URL#name_string</span>). Here <span class="ec-lmri-10">href_string </span>is a valid URL or local identifier, while <span class="ec-lmri-10">name_string </span>could be any string at all: the only caveat is that ‘<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">"</span></span></span>’ - +class="ec-lmvtt-10">"</span></span></span>’ characters should be escaped with a backslash (<span class="lmsy-10">\</span>), and if it looks like a URL name it may cause problems. -<!--l. 243--><p class="indent" > However, the drivers intended to produce <span +<!--l. 241--><p class="indent" > However, the drivers intended to produce <span class="ec-lmri-10">only </span>PDF use literal PostScript or PDF <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\special</span></span></span> commands. The commands are defined in configuration files for different drivers, selected by package @@ -246,6 +416,8 @@ class="description">a special case of output suitable for processing by earlier writer; this is basically the same as that for <span class="ec-lmss-10">dvips</span>, but a few variations remained before version 5.21 + + </dd><dt class="description"> <span class="ec-lmbx-10">tex4ht</span> </dt><dd @@ -264,6 +436,12 @@ class="E">E</span>X</span>, Hàn Thê´ Thành’s <span class="TEX">T<span class="E">E</span>X</span> variant that writes PDF directly </dd><dt class="description"> <span +class="ec-lmbx-10">luatex</span> </dt><dd +class="description">lua<span class="TEX">T<span +class="E">E</span>X</span>, Unicode <span class="TEX">T<span +class="E">E</span>X</span> variant that writes PDF directly + </dd><dt class="description"> +<span class="ec-lmbx-10">dvipdfm</span> </dt><dd class="description">produces <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\special</span></span></span> commands for Mark Wicks’ DVI to PDF driver <span @@ -301,7 +479,7 @@ class="ec-lmbx-10">xetex</span> </dt><dd class="description">produces <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\special</span></span></span> commands for Xe<span class="TEX">T<span class="E">E</span>X</span></dd></dl> -<!--l. 268--><p class="indent" > Output from <span +<!--l. 267--><p class="indent" > Output from <span class="ec-lmss-10">dvips </span>or <span class="ec-lmss-10">dvipsone </span>must be processed using Acrobat Distiller to obtain a PDF file.<span class="footnote-mark"><a @@ -315,8 +493,7 @@ Hyper<span class="TEX">T<span class="E">E</span>X</span> <span class="ec-lmvtt-10">\special </span>commands is that you can also use the document in hypertext DVI viewers, such as <span -class="ec-lmss-10">xdvi</span>. - +class="ec-lmss-10">xdvi</span>. <dl class="description"><dt class="description"> <span class="ec-lmbx-10">driverfallback</span> </dt><dd @@ -324,9 +501,9 @@ class="description">If a driver is not given and cannot be autodetected, then us value to this option <span class="ec-lmss-10">driverfallback</span>. Example: <div class="quote"> - <!--l. 284--><p class="noindent" ><span + <!--l. 283--><p class="noindent" ><span class="ec-lmvtt-10">driverfallback=dvipdfm</span></div> - <!--l. 286--><p class="noindent" >Autodetected drivers (<span + <!--l. 285--><p class="noindent" >Autodetected drivers (<span class="ec-lmss-10">pdftex</span>, <span class="ec-lmss-10">xetex</span>, <span class="ec-lmss-10">vtex</span>, <span @@ -342,9 +519,11 @@ class="ec-lmss-10">hyperref </span>uses the driver, given by <span class="ec-lmss-10">driverfallback</span>. If the driver is already specified or can be autodetected, then option <span class="ec-lmss-10">driverfallback </span>is ignored.</dd></dl> + + <h3 class="sectionHead"><span class="titlemark">2 </span> <a id="x1-30002"></a>Implicit behavior</h3> -<!--l. 299--><p class="noindent" >This package can be used with more or less any normal <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +<!--l. 298--><p class="noindent" >This package can be used with more or less any normal <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> document by specifying in the document preamble @@ -352,8 +531,8 @@ document preamble <div class="verbatim" id="verbatim-1"> \usepackage{hyperref} </div> -<!--l. 304--><p class="nopar" > -<!--l. 306--><p class="indent" > Make sure it comes <span +<!--l. 303--><p class="nopar" > +<!--l. 305--><p class="indent" > Make sure it comes <span class="ec-lmri-10">last </span>of your loaded packages, to give it a fighting chance of not being over-written, since its job is to redefine many <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> commands. Hopefully you will find that all cross-references @@ -363,7 +542,7 @@ whereas <span class="ec-lmvtt-10">\section* </span>commands will only show links when paired with a corresponding <span class="ec-lmvtt-10">\addcontentsline</span> command. -<!--l. 314--><p class="indent" > In addition, the <span +<!--l. 313--><p class="indent" > In addition, the <span class="ec-lmvtt-10">hyperindex </span>option (see below) attempts to make items in the index by hyperlinked back to the text, and the option <span class="ec-lmvtt-10">backref </span>inserts extra ‘back’ links into the bibliography for each entry. @@ -371,10 +550,10 @@ Other options control the appearance of links, and give extra control over PDF o <span class="ec-lmvtt-10">colorlinks</span>, as its name well implies, colors the links instead of using boxes; this is the option used in this document. -<!--l. 323--><p class="noindent" > +<!--l. 322--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">3 </span> <a id="x1-40003"></a>Package options</h3> -<!--l. 325--><p class="noindent" >All user-configurable aspects of <span +<!--l. 324--><p class="noindent" >All user-configurable aspects of <span class="ec-lmss-10">hyperref </span>are set using a single ‘key=value’ scheme (using the <span class="ec-lmss-10">keyval</span> package) with the key <span @@ -385,7 +564,11 @@ class="ec-lmvtt-10">\hypersetup </span>macro. When the package is loaded, a file <span class="ec-lmvtt-10">hyperref.cfg </span>is read if it can be found, and this is a convenient place to set options on a site-wide basis. -<!--l. 333--><p class="indent" > As an example, the behavior of a particular file could be controlled by: +<!--l. 332--><p class="indent" > Note however that some options (for example <span +class="ec-lmvtt-10">unicode</span>) can only be used as packge options, and not +in <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypersetup</span></span></span> as the option settings are processed as the package is read. +<!--l. 336--><p class="indent" > As an example, the behavior of a particular file could be controlled by: <ul class="itemize1"> <li class="itemize">a site-wide <span class="ec-lmvtt-10">hyperref.cfg </span>setting up the look of links, adding backreferencing, and setting a @@ -397,7 +580,7 @@ class="ec-lmvtt-10">hyperref.cfg </span>setting up the look of links, adding bac  <br />pdfpagemode=FullScreen,  <br />colorlinks=true} </div> - <!--l. 343--><p class="nopar" > + <!--l. 346--><p class="nopar" > </li> <li class="itemize">A global option in the file, which is passed down to <span class="ec-lmss-10">hyperref</span>: @@ -406,7 +589,7 @@ class="ec-lmss-10">hyperref</span>: <div class="verbatim" id="verbatim-3"> \documentclass[dvips]{article} </div> - <!--l. 350--><p class="nopar" > + <!--l. 353--><p class="nopar" > </li> <li class="itemize">File-specific options in the <span class="ec-lmvtt-10">\usepackage </span>commands, which override the ones set in @@ -418,8 +601,8 @@ class="ec-lmvtt-10">hyperref.cfg</span>: \usepackage[colorlinks=false]{hyperref}  <br />\hypersetup{pdftitle={A Perfect Day}} </div> - <!--l. 358--><p class="nopar" ></li></ul> -<!--l. 361--><p class="indent" > As seen in the previous example, information entries (pdftitle, pdfauthor, …) should be set after the + <!--l. 361--><p class="nopar" ></li></ul> +<!--l. 364--><p class="indent" > As seen in the previous example, information entries (pdftitle, pdfauthor, …) should be set after the package is loaded. Otherwise <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> expands the values of these options prematurely. Also <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span @@ -432,24 +615,24 @@ class="ec-lmvtt-10">\hypersetup</span></span></span>. \usepackage[pdfborder={0 0 0}]{hyperref}  <br />\hypersetup{pdfborder=0 0 0} </div> -<!--l. 371--><p class="nopar" > -<!--l. 373--><p class="indent" > Package ‘kvoptions-patch’ patches <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +<!--l. 374--><p class="nopar" > +<!--l. 376--><p class="indent" > Package ‘kvoptions-patch’ patches <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> to make it aware of key value options and to prevent premature value expansions. -<!--l. 376--><p class="indent" > Some options can be given at any time, but many are restricted: before <span class="obeylines-h"><span class="verb"><span +<!--l. 379--><p class="indent" > Some options can be given at any time, but many are restricted: before <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\begin{document}</span></span></span>, only in <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\usepackage[...]{hyperref}</span></span></span>, before first use, etc. -<!--l. 380--><p class="indent" > In the key descriptions that follow, many options do not need a value, as they default to the value +<!--l. 383--><p class="indent" > In the key descriptions that follow, many options do not need a value, as they default to the value true if used. These are the ones classed as ‘boolean’. The values true and false can always be specified, however. -<!--l. 384--><p class="noindent" > +<!--l. 387--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a id="x1-50003.1"></a>General options</h4> -<!--l. 386--><p class="noindent" >Firstly, the options to specify general behavior and page size. -<!--l. 389--><p class="noindent" > +<!--l. 389--><p class="noindent" >Firstly, the options to specify general behavior and page size. +<!--l. 392--><p class="noindent" > <a - id="x1-5001r1"></a> <!--l. 390--><div class="longtable"> <table id="TBL-2" class="longtable" + id="x1-5001r1"></a> <!--l. 393--><div class="longtable"> <table id="TBL-2" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-2-1g"><col id="TBL-2-1"><col @@ -527,20 +710,20 @@ class="td11"> </td><td style="white-space:nowrap; text-align:left;" id= class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-11-4" class="td11"></td></tr> </table></div> -<!--l. 399--><p class="noindent" > +<!--l. 402--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a id="x1-60003.2"></a>Options for destination names</h4> -<!--l. 401--><p class="noindent" >Destinations names (also anchor, target or link names) are internal names that identify a position on a +<!--l. 404--><p class="noindent" >Destinations names (also anchor, target or link names) are internal names that identify a position on a page in the document. They are used in link targets for inner document links or the bookmarks, for example. -<!--l. 406--><p class="indent" > Usually anchor are set, if <span +<!--l. 409--><p class="indent" > Usually anchor are set, if <span class="ec-lmvtt-10">\refstepcounter </span>is called. Thus there is a counter name and value. Both are used to construct the destination name. By default the counter value follows the counter name separated by a dot. Example for the fourth chapter: <div class="quote"> - <!--l. 412--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span + <!--l. 415--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">chapter.4</span></span></span></div> -<!--l. 414--><p class="noindent" >This scheme is used by: +<!--l. 417--><p class="noindent" >This scheme is used by: <dl class="description"><dt class="description"> <span class="ec-lmvtk-10">\autoref</span> </dt><dd @@ -552,7 +735,7 @@ class="ec-lmvtk-10">\hyperpage</span> </dt><dd class="description">is used by the index to get page links. Page anchor setting (<span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">pageanchor</span></span></span>) must not be turned off.</dd></dl> -<!--l. 423--><p class="indent" > It is very important that the destination names are unique, because two destinations must not share +<!--l. 426--><p class="indent" > It is very important that the destination names are unique, because two destinations must not share the same name. The counter value <span class="ec-lmvtt-10">\the<counter> </span>is not always unique for the counter. For example, table and figures can be numbered inside the chapter without having the chapter number in their @@ -568,7 +751,7 @@ class="ec-lmvtt-10">table.2.4 </span>is unique because it has used <span class="ec-lmvtt-10">\theHtable </span>that gives <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">2.4</span></span></span> in this case. -<!--l. 436--><p class="indent" > Often the user do not need to set <span +<!--l. 439--><p class="indent" > Often the user do not need to set <span class="ec-lmvtt-10">\theH<counter></span>. Defaults for standard cases (chapter, …) are provided. And after <span class="ec-lmss-10">hyperref </span>is loaded, new counters with parent counters also define <span @@ -579,7 +762,7 @@ class="ec-lmvtt-10">\@addtoreset </span>or <span class="ec-lmvtt-10">\numberwithin </span>of package <span class="ec-lmss-10">amsmath </span>are used. -<!--l. 442--><p class="indent" > Usually problems with duplicate destination names can be solved by an appropriate definition of +<!--l. 445--><p class="indent" > Usually problems with duplicate destination names can be solved by an appropriate definition of <span class="ec-lmvtt-10">\theH<counter></span>. If option <span class="ec-lmvtt-10">hypertexnames </span>is disabled, then a unique artificial number is used instead of @@ -588,11 +771,11 @@ class="ec-lmvtt-10">plainpages </span>the page anchors use the arabic form. In both latter cases <span class="ec-lmvtt-10">\hyperpage </span>for index links is affected and might not work properly. -<!--l. 450--><p class="indent" > If an unnumbered entity gets an anchor (starred forms of chapters, sections, …) or <span +<!--l. 453--><p class="indent" > If an unnumbered entity gets an anchor (starred forms of chapters, sections, …) or <span class="ec-lmvtt-10">\phantomsection </span>is used, then the dummy counter name <span class="ec-lmvtt-10">section* </span>and an artificial unique number is used. -<!--l. 455--><p class="indent" > If the final PDF file is going to be merged with another file, than the destination names might clash, +<!--l. 458--><p class="indent" > If the final PDF file is going to be merged with another file, than the destination names might clash, because both documents might contain <span class="ec-lmvtt-10">chapter.1 </span>or <span class="ec-lmvtt-10">page.1</span>. Also <span @@ -610,12 +793,12 @@ to all destination names: <div class="verbatim" id="verbatim-6"> \renewcommand*{\HyperDestNameFilter}[1]{\jobname-#1} </div> - <!--l. 468--><p class="nopar" ></div> -<!--l. 470--><p class="noindent" >In document <span + <!--l. 471--><p class="nopar" ></div> +<!--l. 473--><p class="noindent" >In document <span class="ec-lmvtt-10">docA </span>the destination name <span class="ec-lmvtt-10">chapter.2 </span>becomes <span class="ec-lmvtt-10">docA-chapter.2</span>. -<!--l. 473--><p class="indent" > Destination names can also be used from the outside in URIs(, if the driver has not removed or +<!--l. 476--><p class="indent" > Destination names can also be used from the outside in URIs(, if the driver has not removed or changed them), for example: <div class="quote"> @@ -623,8 +806,8 @@ changed them), for example: <div class="verbatim" id="verbatim-7"> http://somewhere/path/file.pdf#nameddest=chapter.4 </div> - <!--l. 478--><p class="nopar" ></div> -<!--l. 480--><p class="noindent" >However using a number seems unhappy. If another chapter is added before, the number changes. But it is + <!--l. 481--><p class="nopar" ></div> +<!--l. 483--><p class="noindent" >However using a number seems unhappy. If another chapter is added before, the number changes. But it is very difficult to pass a new name for the destination to the anchor setting process that is usually deep hidden in the internals. The first name of <span class="ec-lmvtt-10">\label </span>after the anchor setting seems a good @@ -636,8 +819,8 @@ approximation:   \section{Introduction}  <br />  \label{intro} </div> - <!--l. 489--><p class="nopar" ></div> -<!--l. 491--><p class="noindent" >Option <span + <!--l. 492--><p class="nopar" ></div> +<!--l. 494--><p class="noindent" >Option <span class="ec-lmvtt-10">destlabel </span>checks for each <span class="ec-lmvtt-10">\label</span>, if there is a new destination name active and replaces the destination name by the label name. Because the destination name is already in use because of the @@ -659,8 +842,8 @@ class="ec-lmri-10">all </span>destination names:  <br />  \jobname-\HyperDestLabelReplace{#1}%  <br />} </div> - <!--l. 506--><p class="nopar" ></div> -<!--l. 508--><p class="noindent" >The other case that only files prefixed that do not have a corresponding <span + <!--l. 509--><p class="nopar" ></div> +<!--l. 511--><p class="noindent" >The other case that only files prefixed that do not have a corresponding <span class="ec-lmvtt-10">\label </span>is more complicate, because <span class="ec-lmvtt-10">\HyperDestLabelReplace </span>needs the unmodified destination name as argument. This is solved by an @@ -684,12 +867,12 @@ Lua<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span>):  <br />}  <br />\makeatother </div> - <!--l. 526--><p class="nopar" ></div> -<!--l. 529--><p class="indent" > With option <span + <!--l. 529--><p class="nopar" ></div> +<!--l. 532--><p class="indent" > With option <span class="ec-lmvtt-10">destlabel </span>destinations can also named manually, if the destination is not yet renamed: <div class="quote"> - <!--l. 532--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span + <!--l. 535--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\HyperDestRename{</span></span></span><span class="lmsy-10">⟨</span><span class="ec-lmvtto-10">destination</span><span @@ -699,11 +882,11 @@ class="lmsy-10">⟨</span><span class="ec-lmvtto-10">newname</span><span class="lmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span></div> -<!--l. 535--><p class="indent" > Hint: Anchors can also be named and set by <span +<!--l. 538--><p class="indent" > Hint: Anchors can also be named and set by <span class="ec-lmvtt-10">\hypertarget</span>. -<!--l. 538--><p class="noindent" > +<!--l. 541--><p class="noindent" > <a - id="x1-6001r2"></a> <!--l. 539--><div class="longtable"> <table id="TBL-3" class="longtable" + id="x1-6001r2"></a> <!--l. 542--><div class="longtable"> <table id="TBL-3" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-3-1g"><col id="TBL-3-1"><col @@ -775,12 +958,12 @@ class="td11"> </td><td style="white-space:nowrap; text-align:left;" id= class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-11-4" class="td11"></td></tr> </table></div> -<!--l. 547--><p class="noindent" > +<!--l. 550--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a id="x1-70003.3"></a>Configuration options</h4> -<!--l. 549--><p class="noindent" > +<!--l. 552--><p class="noindent" > <a - id="x1-7001r3"></a> <!--l. 550--><div class="longtable"> <table id="TBL-4" class="longtable" + id="x1-7001r3"></a> <!--l. 553--><div class="longtable"> <table id="TBL-4" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-4-1g"><col id="TBL-4-1"><col @@ -797,7 +980,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" i class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-1-4" class="td11"> - <!--l. 550--><p class="noindent" >In the hypertex driver, the height of links is + <!--l. 553--><p class="noindent" >In the hypertex driver, the height of links is normally calculated by the driver as simply the base line of contained text; this options forces <span class="obeylines-h"><span class="verb"><span @@ -812,7 +995,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" i class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-2-4" class="td11"> - <!--l. 553--><p class="noindent" >Allows link text to break across lines; since + <!--l. 556--><p class="noindent" >Allows link text to break across lines; since this cannot be accommodated in PDF, it is only set true by default if the pdftex driver is used. This makes links on multiple lines into @@ -825,7 +1008,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" i class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-3-4" class="td11"> - <!--l. 556--><p class="noindent" >Determines whether every page is given an + <!--l. 559--><p class="noindent" >Determines whether every page is given an implicit anchor at the top left corner. If this is turned off, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\printindex</span></span></span> will not contain valid @@ -838,7 +1021,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" i class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-4-4-4" class="td11"> - <!--l. 559--><p class="noindent" >Allows links to be nested; no drivers currently + <!--l. 562--><p class="noindent" >Allows links to be nested; no drivers currently support this. </td> </tr><tr style="vertical-align:baseline;" id="TBL-4-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-1" @@ -856,14 +1039,14 @@ class="td11"> </td><td style="white-space:nowrap; text-align:left;" id= class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-4-8-4" class="td11"></td></tr> </table></div> -<!--l. 562--><p class="indent" > Note for option <span class="obeylines-h"><span class="verb"><span +<!--l. 565--><p class="indent" > Note for option <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">breaklinks</span></span></span>: The correct value is automatically set according to the driver features. It can be overwritten for drivers that do not support broken links. However, at any case, the link area will be wrong and displaced. -<!--l. 567--><p class="noindent" > +<!--l. 570--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.4 </span> <a id="x1-80003.4"></a>Backend drivers</h4> -<!--l. 569--><p class="noindent" >If no driver is specified, the package tries to find a driver in the following order: +<!--l. 572--><p class="noindent" >If no driver is specified, the package tries to find a driver in the following order: <ol class="enumerate1" > <li class="enumerate" id="x1-8002x1">Autodetection, some <span class="TEX">T<span @@ -885,7 +1068,7 @@ class="ec-lmvtt-10">\Hy@defaultdriver</span>. The macro takes a driver file name <li class="enumerate" id="x1-8008x4">Package default is <span class="ec-lmss-10">hypertex</span>.</li></ol> -<!--l. 580--><p class="noindent" >Many distributions are using a driver file <span +<!--l. 583--><p class="noindent" >Many distributions are using a driver file <span class="ec-lmvtt-10">hypertex.cfg </span>that define <span class="ec-lmvtt-10">\Hy@defaultdriver </span>with <span class="ec-lmvtt-10">hdvips</span>. This @@ -893,166 +1076,165 @@ is recommended because driver <span class="ec-lmss-10">dvips </span>provides much more features than <span class="ec-lmss-10">hypertex </span>for PDF generation. -<!--l. 585--><p class="noindent" > <a - id="x1-8009r4"></a> <!--l. 586--><div class="longtable"> <table id="TBL-5" class="longtable" + id="x1-8009r4"></a> <!--l. 589--><div class="longtable"> <table id="TBL-5" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-5-1g"><col id="TBL-5-1"><col id="TBL-5-2"></colgroup> - - <tr style="vertical-align:baseline;" id="TBL-5-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">driverfallback </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-1-2" -class="td11"> - <!--l. 586--><p class="noindent" >Its value is used as driver option </td> +class="td10"> + <!--l. 589--><p class="noindent" >Its value is used as driver option </td> + + </tr><tr style="vertical-align:baseline;" id="TBL-5-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-1" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-2-2" -class="td11"> - <!--l. 587--><p class="noindent" >if the driver is not given or autodetected. </td> +class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-2-2" +class="td10"> + <!--l. 590--><p class="noindent" >if the driver is not given or autodetected. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">dvipdfm </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-3-2" -class="td11"> - <!--l. 588--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 591--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the <span -class="ec-lmss-10">dvipdfm </span>driver. </td> +class="ec-lmss-10">dvipdfm </span>driver. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">dvipdfmx </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-4-2" -class="td11"> - <!--l. 589--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 592--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the <span -class="ec-lmss-10">dvipdfmx </span>driver. </td> +class="ec-lmss-10">dvipdfmx </span>driver. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">dvips </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-5-2" -class="td11"> - <!--l. 590--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 593--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the <span -class="ec-lmss-10">dvips </span>driver. </td> +class="ec-lmss-10">dvips </span>driver. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">dvipsone </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-6-2" -class="td11"> - <!--l. 591--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 594--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the <span -class="ec-lmss-10">dvipsone </span>driver. </td> +class="ec-lmss-10">dvipsone </span>driver. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">dviwindo </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-7-2" -class="td11"> - <!--l. 592--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 595--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the <span -class="ec-lmss-10">dviwindo </span>Windows previewer. </td> +class="ec-lmss-10">dviwindo </span>Windows previewer. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">hypertex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-8-2" -class="td11"> - <!--l. 593--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 596--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the Hyper<span class="TEX">T<span -class="E">E</span>X</span>-compliant drivers. </td> +class="E">E</span>X</span>-compliant drivers. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">latex2html </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-9-2" -class="td11"> - <!--l. 594--><p class="noindent" >Redefines a few macros for compatibility with <span -class="ec-lmss-10">latex2html</span>. </td> +class="td10"> + <!--l. 597--><p class="noindent" >Redefines a few macros for compatibility with <span +class="ec-lmss-10">latex2html</span>. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">nativepdf </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-10-2" -class="td11"> - <!--l. 595--><p class="noindent" >An alias for <span -class="ec-lmss-10">dvips</span> </td> +class="td10"> + <!--l. 598--><p class="noindent" >An alias for <span +class="ec-lmss-10">dvips</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">pdfmark </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-11-2" -class="td11"> - <!--l. 596--><p class="noindent" >An alias for <span -class="ec-lmss-10">dvips</span> </td> +class="td10"> + <!--l. 599--><p class="noindent" >An alias for <span +class="ec-lmss-10">dvips</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">pdftex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-12-2" -class="td11"> - <!--l. 597--><p class="noindent" >Sets up <span +class="td10"> + <!--l. 600--><p class="noindent" >Sets up <span class="ec-lmss-10">hyperref </span>for use with the <span -class="ec-lmss-10">pdftex </span>program. </td> +class="ec-lmss-10">pdftex </span>program. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">ps2pdf </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-13-2" -class="td11"> - <!--l. 598--><p class="noindent" >Redefines a few macros for compatibility with Ghostscript’s PDF writer, +class="td10"> + <!--l. 601--><p class="noindent" >Redefines a few macros for compatibility with Ghostscript’s PDF writer, otherwise identical to <span -class="ec-lmss-10">dvips</span>. </td> +class="ec-lmss-10">dvips</span>. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-14-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-14-2" -class="td11"> - <!--l. 601--><p class="noindent" >For use with <span class="TEX"><span +class="td10"> + <!--l. 604--><p class="noindent" >For use with <span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span><span -class="ec-lmss-10">4ht</span> </td> +class="ec-lmss-10">4ht</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-15-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">textures </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-15-2" -class="td11"> - <!--l. 602--><p class="noindent" >For use with <span -class="ec-lmss-10">Textures</span> </td> +class="td10"> + <!--l. 605--><p class="noindent" >For use with <span +class="ec-lmss-10">Textures</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-16-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">vtex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-16-2" -class="td11"> - <!--l. 603--><p class="noindent" >For use with MicroPress’ <span +class="td10"> + <!--l. 606--><p class="noindent" >For use with MicroPress’ <span class="ec-lmss-10">VTeX</span>; the PDF and HTML backends are detected - automatically. </td> + automatically. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-17-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">vtexpdfmark </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-17-2" -class="td11"> - <!--l. 605--><p class="noindent" >For use with <span -class="ec-lmss-10">VTeX</span>’s PostScript backend. </td> +class="td10"> + <!--l. 608--><p class="noindent" >For use with <span +class="ec-lmss-10">VTeX</span>’s PostScript backend. </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-18-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">xetex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-5-18-2" -class="td11"> - <!--l. 606--><p class="noindent" >For use with Xe<span class="TEX">T<span -class="E">E</span>X</span>(using backend for dvipdfm). </td> +class="td10"> + <!--l. 609--><p class="noindent" >For use with Xe<span class="TEX">T<span +class="E">E</span>X</span>(using backend for dvipdfm). </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-19-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-20-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-21-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-5-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-22-1" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-22-2" -class="td11"></td></tr> +class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-5-22-2" +class="td10"></td></tr> </table></div> -<!--l. 610--><p class="indent" > If you use <span +<!--l. 613--><p class="indent" > If you use <span class="ec-lmss-10">dviwindo</span>, you may need to redefine the macro <span class="ec-lmvtt-10">\wwwbrowser </span>(the default is <span class="obeylines-h"><span class="verb"><span @@ -1066,13 +1248,12 @@ add something like this to hyperref.cfg:  <br />  Files\string\Plus!\string\Microsoft\space  <br />  Internet\string\iexplore.exe} </div> -<!--l. 619--><p class="nopar" > -<!--l. 621--><p class="noindent" > +<!--l. 622--><p class="nopar" > +<!--l. 624--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a id="x1-90003.5"></a>Extension options</h4> -<!--l. 622--><p class="noindent" > <a - id="x1-9001r5"></a> <!--l. 623--><div class="longtable"> <table id="TBL-6" class="longtable" + id="x1-9001r5"></a> <!--l. 626--><div class="longtable"> <table id="TBL-6" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-6-1g"><col id="TBL-6-1"><col @@ -1081,273 +1262,277 @@ id="TBL-6-3"><col id="TBL-6-4"></colgroup> <tr style="vertical-align:baseline;" id="TBL-6-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">extension </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-2" class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-1-4" -class="td11"> - <!--l. 623--><p class="noindent" >Set the file extension (e.g. <span -class="ec-lmss-10">dvi</span>) which - will be appended to file links created if - you use the <span -class="ec-lmss-10">xr </span>package. </td> +class="td10"> + <!--l. 626--><p class="noindent" >Set the file extension (e.g. <span +class="ec-lmss-10">dvi</span>) + which will be appended to file links + created if you use the <span +class="ec-lmss-10">xr </span>package. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">hyperfigures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-2-4" -class="td11"> - <!--l. 626--><p class="noindent" > </td> +class="td10"> + <!--l. 629--><p class="noindent" > </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">backref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-2" class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-3-4" -class="td11"> - <!--l. 626--><p class="noindent" >Adds ‘backlink’ text to the end of each - item in the bibliography, as a list of - section numbers. This can only work - properly <span -class="ec-lmri-10">if </span>there is a blank line after - each <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\bibitem</span></span></span>. Supported values are - <span class="obeylines-h"><span class="verb"><span +class="td10"> + <!--l. 629--><p class="noindent" >Adds ‘backlink’ text to the end + of each item in the bibliography, + as a list of section numbers. This + can only work properly <span +class="ec-lmri-10">if </span>there is + a blank line after each <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\bibitem</span></span></span>. + Supported values are <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">section</span></span></span>, <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">slide</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">slide</span></span></span>, + <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">page</span></span></span>, <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">none</span></span></span>, or <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">false</span></span></span>. If - no value is given, <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">section</span></span></span> is taken as - default. </td> +class="ec-lmvtt-10">false</span></span></span>. If no value is + given, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">section</span></span></span> is taken as default. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">pagebackref </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-4-4" -class="td11"> - <!--l. 630--><p class="noindent" >Adds ‘backlink’ text to the end of each - item in the bibliography, as a list of - page numbers. </td> +class="td10"> + <!--l. 633--><p class="noindent" >Adds ‘backlink’ text to the end of + each item in the bibliography, as a + list of page numbers. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">hyperindex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-5-4" -class="td11"> - <!--l. 632--><p class="noindent" >Makes the page numbers of index - entries into hyperlinks. Relays on - unique page anchors (<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">pageanchor</span></span></span>, …) </td> +class="td10"> + <!--l. 635--><p class="noindent" >Makes the page numbers of index + entries into hyperlinks. Relays on + unique page anchors (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pageanchor</span></span></span>, + …) </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-1" -class="td11"> <span class="obeylines-h"><span class="verb"><span +class="td01"><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">pageanchors</span></span></span> <span class="ec-lmvtt-10">and </span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">plainpages=false</span></span></span><span class="ec-lmvtt-10">. </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-6-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">hyperfootnotes </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-7-4" -class="td11"> - <!--l. 635--><p class="noindent" >Makes the footnote marks into - hyperlinks to the footnote text. Easily - broken … </td> +class="td10"> + <!--l. 638--><p class="noindent" >Makes the footnote marks into + hyperlinks to the footnote text. + Easily broken … </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">encap </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-2" class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-8-4" -class="td11"> - <!--l. 637--><p class="noindent" >Sets encap character for hyperindex </td> +class="td10"> + <!--l. 640--><p class="noindent" >Sets encap character for hyperindex</td> </tr><tr style="vertical-align:baseline;" id="TBL-6-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">linktoc </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-2" class="td11"> text </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-3" class="td11"> <span class="ec-lmri-10">section </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-9-4" -class="td11"> - <!--l. 638--><p class="noindent" >make text (<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">section</span></span></span>), page number +class="td10"> + <!--l. 641--><p class="noindent" >make text (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">section</span></span></span>), page number (<span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">page</span></span></span>), both (<span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">all</span></span></span>) or nothing (<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">none</span></span></span>) be - link on TOC, LOF and LOT </td> +class="ec-lmvtt-10">none</span></span></span>) + be link on TOC, LOF and LOT </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">linktocpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-10-4" -class="td11"> - <!--l. 639--><p class="noindent" >make page number, not text, be link on - TOC, LOF and LOT </td> +class="td10"> + <!--l. 642--><p class="noindent" >make page number, not text, be link + on TOC, LOF and LOT </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">breaklinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-11-4" -class="td11"> - <!--l. 640--><p class="noindent" >allow links to break over lines by - making links over multiple lines into - PDF links to the same target </td> +class="td10"> + <!--l. 643--><p class="noindent" >allow links to break over lines by + making links over multiple lines into + PDF links to the same target </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">colorlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-12-4" -class="td11"> - <!--l. 642--><p class="noindent" >Colors the text of links and anchors. - The colors chosen depend on the the - type of link. At present the only types - of link distinguished are citations, page - references, URLs, local file references, - and other links. Unlike colored boxes, - the colored text remains when printing. </td> +class="td10"> + <!--l. 645--><p class="noindent" >Colors the text of links and anchors. + The colors chosen depend on the + the type of link. At present the + only types of link distinguished are + citations, page references, URLs, + local file references, and other links. + Unlike colored boxes, the colored + text remains when printing. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">linkcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-3" class="td11"> <span class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-13-4" -class="td11"> - <!--l. 647--><p class="noindent" >Color for normal internal links. </td> +class="td10"> + <!--l. 650--><p class="noindent" >Color for normal internal links. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">anchorcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-3" class="td11"> <span class="ec-lmri-10">black </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-14-4" -class="td11"> - <!--l. 648--><p class="noindent" >Color for anchor text. </td> +class="td10"> + <!--l. 651--><p class="noindent" >Color for anchor text. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">citecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-3" class="td11"> <span class="ec-lmri-10">green </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-15-4" -class="td11"> - <!--l. 649--><p class="noindent" >Color for bibliographical citations in - text. </td> +class="td10"> + <!--l. 652--><p class="noindent" >Color for bibliographical citations in + text. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-16-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">filecolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-16-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-16-3" class="td11"> <span class="ec-lmri-10">cyan </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-16-4" -class="td11"> - <!--l. 650--><p class="noindent" >Color for URLs which open local files. </td> +class="td10"> + <!--l. 653--><p class="noindent" >Color for URLs which open local + files. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-17-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">menucolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-17-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-17-3" class="td11"> <span class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-17-4" -class="td11"> - <!--l. 651--><p class="noindent" >Color for Acrobat menu items. </td> +class="td10"> + <!--l. 654--><p class="noindent" >Color for Acrobat menu items. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-18-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-18-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-18-3" class="td11"> <span class="ec-lmri-10">filecolor </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-18-4" -class="td11"> - <!--l. 652--><p class="noindent" >Color for run links (launch - annotations). </td> +class="td10"> + <!--l. 655--><p class="noindent" >Color for run links (launch + annotations). </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-19-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-19-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-19-3" class="td11"> <span class="ec-lmri-10">magenta </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-19-4" -class="td11"> - <!--l. 653--><p class="noindent" >Color for linked URLs. </td> +class="td10"> + <!--l. 656--><p class="noindent" >Color for linked URLs. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-20-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">allcolors </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-20-2" class="td11"> color </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-20-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-20-4" -class="td11"> - <!--l. 654--><p class="noindent" >Set all color options (without border - and field options). </td> +class="td10"> + <!--l. 657--><p class="noindent" >Set all color options (without border + and field options). </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-21-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-21-2" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-21-2" class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-21-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-21-4" -class="td11"></td></tr> +class="td10"></td></tr> <tr style="vertical-align:baseline;" id="TBL-6-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-22-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">frenchlinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-22-2" class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-22-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-6-22-4" -class="td11"> - <!--l. 655--><p class="noindent" >Use small caps instead of color for links. </td> +class="td10"> + <!--l. 658--><p class="noindent" >Use small caps instead of color for + links. </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-23-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">hidelinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-23-2" class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-23-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-6-23-4" -class="td11"> - <!--l. 656--><p class="noindent" >Hide links (removing color and border). </td> +class="td10"> + <!--l. 659--><p class="noindent" >Hide links (removing color and + border). </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-24-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-25-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-26-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-27-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-28-1" -class="td11"> </td></tr> +class="td01"> </td></tr> </table></div> -<!--l. 659--><p class="indent" > Note that all color names must be defined before use, following the normal system of the standard +<!--l. 662--><p class="noindent" >Note that all color names must be defined before use, following the normal system of the standard <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> <span class="ec-lmss-10">color </span>package. -<!--l. 662--><p class="noindent" > +<!--l. 665--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.6 </span> <a id="x1-100003.6"></a>PDF-specific display options</h4> -<!--l. 663--><p class="noindent" > <a - id="x1-10001r6"></a> <!--l. 664--><div class="longtable"> <table id="TBL-7" class="longtable" + id="x1-10001r6"></a> <!--l. 667--><div class="longtable"> <table id="TBL-7" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-7-1g"><col id="TBL-7-1"><col @@ -1364,7 +1549,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-1-4" class="td10"> - <!--l. 664--><p class="noindent" >A set of Acrobat bookmarks are written, in a + <!--l. 667--><p class="noindent" >A set of Acrobat bookmarks are written, in a manner similar to the table of contents, requiring two passes of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span>. Some postprocessing of @@ -1387,7 +1572,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-2-4" class="td10"> - <!--l. 670--><p class="noindent" >If Acrobat bookmarks are requested, show them + <!--l. 673--><p class="noindent" >If Acrobat bookmarks are requested, show them with all the subtrees expanded. </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-1" @@ -1396,7 +1581,7 @@ class="ec-lmvtt-10">bookmarksopenlevel </span></td><td style="white-space:now class="td11"> parameter </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-3-4" class="td10"> - <!--l. 672--><p class="noindent" >level (<span + <!--l. 675--><p class="noindent" >level (<span class="ec-lmvtt-10">\maxdimen</span>) to which bookmarks are open</td> </tr><tr style="vertical-align:baseline;" id="TBL-7-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-1" @@ -1406,7 +1591,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-4-4" class="td10"> - <!--l. 673--><p class="noindent" >If Acrobat bookmarks are requested, include + <!--l. 676--><p class="noindent" >If Acrobat bookmarks are requested, include section numbers. </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-1" @@ -1416,7 +1601,7 @@ class="td11"> text </td><td style="white-space:nowrap; text-align:lef class="td11"> <span class="ec-lmri-10">toc </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-5-4" class="td10"> - <!--l. 674--><p class="noindent" >to specify which ‘toc’ file to mimic </td> + <!--l. 677--><p class="noindent" >to specify which ‘toc’ file to mimic </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-1" class="td01"><span @@ -1425,7 +1610,7 @@ class="td11"> boolean </td><td style="white-space:nowrap; text-align:left class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-6-4" class="td10"> - <!--l. 676--><p class="noindent" >This option should be used to produce CJK + <!--l. 679--><p class="noindent" >This option should be used to produce CJK bookmarks. Package <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">hyperref</span></span></span> supports both normal and preprocessed mode of the <span @@ -1441,7 +1626,7 @@ class="ec-lmss-10">CJK</span> notably Acroread itself) support this. Also note that option ‘CJKbookmarks’ cannot be used together with option ‘unicode’. - <!--l. 688--><p class="noindent" >No mechanism is provided to + <!--l. 691--><p class="noindent" >No mechanism is provided to translate non-Unicode bookmarks to Unicode; for portable PDF documents only Unicode encoding should be used. </td> @@ -1453,7 +1638,7 @@ class="td11"> name </td><td style="white-space:nowrap; text-align:left class="td11"> <span class="ec-lmri-10">/I </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-7-4" class="td10"> - <!--l. 691--><p class="noindent" >How link buttons behave when selected; /I is + <!--l. 694--><p class="noindent" >How link buttons behave when selected; /I is for inverse (the default); the other possibilities are /N (no effect), /O (outline), and /P (inset highlighting). </td> @@ -1465,7 +1650,7 @@ class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" class="td11"> <span class="ec-lmri-10">0 1 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-8-4" class="td10"> - <!--l. 694--><p class="noindent" >The color of the box around citations </td> + <!--l. 697--><p class="noindent" >The color of the box around citations </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-1" class="td01"><span @@ -1474,7 +1659,7 @@ class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" class="td11"> <span class="ec-lmri-10">0 .5 .5 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-9-4" class="td10"> - <!--l. 695--><p class="noindent" >The color of the box around links to files </td> + <!--l. 698--><p class="noindent" >The color of the box around links to files </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-1" class="td01"><span @@ -1483,7 +1668,7 @@ class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" class="td11"> <span class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-10-4" class="td10"> - <!--l. 696--><p class="noindent" >The color of the box around normal links </td> + <!--l. 699--><p class="noindent" >The color of the box around normal links </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-1" class="td01"><span @@ -1492,7 +1677,7 @@ class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" class="td11"> <span class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-11-4" class="td10"> - <!--l. 697--><p class="noindent" >The color of the box around Acrobat menu links</td> + <!--l. 700--><p class="noindent" >The color of the box around Acrobat menu links</td> </tr><tr style="vertical-align:baseline;" id="TBL-7-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-1" class="td01"><span @@ -1501,7 +1686,7 @@ class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" class="td11"> <span class="ec-lmri-10">0 1 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-12-4" class="td10"> - <!--l. 698--><p class="noindent" >The color of the box around links to URLs </td> + <!--l. 701--><p class="noindent" >The color of the box around links to URLs </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-1" class="td01"><span @@ -1510,7 +1695,7 @@ class="td11"> RGB color </td><td style="white-space:nowrap; text-align:left;" class="td11"> <span class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-13-4" class="td10"> - <!--l. 699--><p class="noindent" >Color of border around ‘run’ links </td> + <!--l. 702--><p class="noindent" >Color of border around ‘run’ links </td> </tr><tr @@ -1520,7 +1705,7 @@ class="ec-lmvtt-10">allbordercolors </span></td><td style="white-space class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-14-4" class="td10"> - <!--l. 700--><p class="noindent" >Set all border color options </td> + <!--l. 703--><p class="noindent" >Set all border color options </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-1" class="td01"><span @@ -1529,7 +1714,7 @@ class="td11"> </td><td style="white-space:nowrap; text-align:le class="td11"> <span class="ec-lmri-10">0 0 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-7-15-4" class="td10"> - <!--l. 701--><p class="noindent" >The style of box around links; defaults to a box + <!--l. 704--><p class="noindent" >The style of box around links; defaults to a box with lines of 1pt thickness, but the colorlinks option resets it to produce no border. </td> </tr><tr @@ -1548,37 +1733,35 @@ class="td11"> </td><td style="white-space:nowrap; text-align:left;" i class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-7-19-4" class="td10"></td></tr> </table></div> -<!--l. 705--><p class="indent" > Note that the color of link borders can be specified <span -class="ec-lmri-10">only </span>as 3 numbers in the range 0..1, giving an -RGB color. You cannot use colors defined in <span class="TEX">T<span -class="E">E</span>X</span>. Since version 6.76a this is no longer true. Especially -with the help of package <span +<!--l. 708--><p class="noindent" >Note that the color of link borders can be specified <span +class="ec-lmri-10">only </span>as 3 numbers in the range 0..1, giving an RGB +color. You cannot use colors defined in <span class="TEX">T<span +class="E">E</span>X</span>. Since version 6.76a this is no longer true. Especially with +the help of package <span class="ec-lmss-10">xcolor </span>the usual color specifications of package <span class="ec-lmss-10">(x)color </span>can be used. For further information see description of package <span class="ec-lmss-10">hycolor</span>. -<!--l. 712--><p class="indent" > The bookmark commands are stored in a file called <span +<!--l. 715--><p class="indent" > The bookmark commands are stored in a file called <span class="ec-lmri-10">jobname</span><span class="ec-lmvtt-10">.out</span>. The files is not processed by <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> so any markup is passed through. You can postprocess this file as needed; as an aid for -this, the <span +class="E">E</span>X</span></span> so any markup is passed through. You can postprocess this file as needed; as an aid +for this, the <span class="ec-lmvtt-10">.out </span>file is not overwritten on the next <span class="TEX">T<span -class="E">E</span>X</span> run if it is edited to contain the line -<br -class="newline" /> +class="E">E</span>X</span> run if it is edited to contain the +line <div class="verbatim" id="verbatim-12"> \let\WriteBookmarks\relax </div> -<!--l. 720--><p class="nopar" > -<!--l. 722--><p class="noindent" > +<!--l. 722--><p class="nopar" > +<!--l. 724--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.7 </span> <a id="x1-110003.7"></a>PDF display and information options</h4> -<!--l. 723--><p class="noindent" > <a - id="x1-11001r7"></a> <!--l. 724--><div class="longtable"> <table id="TBL-8" class="longtable" + id="x1-11001r7"></a> <!--l. 726--><div class="longtable"> <table id="TBL-8" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-8-1g"><col id="TBL-8-1"><col @@ -1590,20 +1773,20 @@ id="TBL-8-4"></colgroup> class="td01"><span class="ec-lmvtt-10">baseurl </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-1-2" class="td11"> - <!--l. 724--><p class="noindent" >URL </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-3" + <!--l. 726--><p class="noindent" >URL </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-1-4" class="td10"> - <!--l. 724--><p class="noindent" >Sets the base URL of the PDF document </td> + <!--l. 726--><p class="noindent" >Sets the base URL of the PDF document </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-1" class="td01"><span class="ec-lmvtt-10">pdfpagemode </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-2-2" class="td11"> - <!--l. 725--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-3" + <!--l. 727--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-2-4" class="td10"> - <!--l. 725--><p class="noindent" >Determines how the file is opening in + <!--l. 727--><p class="noindent" >Determines how the file is opening in Acrobat; the possibilities are <span class="ec-lmvtt-10">UseNone</span>, <span @@ -1622,73 +1805,74 @@ class="ec-lmvtt-10">UseOutlines </span>is used. </td> class="td01"><span class="ec-lmvtt-10">pdftitle </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-3-2" class="td11"> - <!--l. 730--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-3" + <!--l. 732--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-3-4" class="td10"> - <!--l. 730--><p class="noindent" >Sets the document information Title field </td> + <!--l. 732--><p class="noindent" >Sets the document information Title field </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-1" class="td01"><span class="ec-lmvtt-10">pdfauthor </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-4-2" class="td11"> - <!--l. 731--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-3" + <!--l. 733--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-4-4" class="td10"> - <!--l. 731--><p class="noindent" >Sets the document information Author field </td> + <!--l. 733--><p class="noindent" >Sets the document information Author field </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-1" class="td01"><span class="ec-lmvtt-10">pdfsubject </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-5-2" class="td11"> - <!--l. 732--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-3" + <!--l. 734--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-5-4" class="td10"> - <!--l. 732--><p class="noindent" >Sets the document information Subject field </td> + <!--l. 734--><p class="noindent" >Sets the document information Subject field </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-1" class="td01"><span class="ec-lmvtt-10">pdfcreator </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-6-2" class="td11"> - <!--l. 733--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-3" + <!--l. 735--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-6-4" class="td10"> - <!--l. 733--><p class="noindent" >Sets the document information Creator field </td> + <!--l. 735--><p class="noindent" >Sets the document information Creator field </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-1" class="td01"><span -class="ec-lmvtt-10">pdfproducer </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-7-2" +class="ec-lmvtt-10">addtopdfproducer </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-7-2" class="td11"> - <!--l. 734--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-3" + <!--l. 736--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-7-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-7-4" class="td10"> - <!--l. 734--><p class="noindent" >Sets the document information Producer field</td> + <!--l. 736--><p class="noindent" >Adds additional text to the document + information Producer field </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-1" class="td01"><span class="ec-lmvtt-10">pdfkeywords </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-8-2" class="td11"> - <!--l. 735--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-3" + <!--l. 737--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-8-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-8-4" class="td10"> - <!--l. 735--><p class="noindent" >Sets the document information Keywords field</td> + <!--l. 737--><p class="noindent" >Sets the document information Keywords field</td> </tr><tr style="vertical-align:baseline;" id="TBL-8-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-9-1" class="td01"><span class="ec-lmvtt-10">pdftrapped </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-9-2" class="td11"> - <!--l. 736--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-9-3" + <!--l. 738--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-9-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-9-4" class="td10"> - <!--l. 736--><p class="noindent" >Sets the document information Trapped entry.</td> + <!--l. 738--><p class="noindent" >Sets the document information Trapped entry.</td> </tr><tr style="vertical-align:baseline;" id="TBL-8-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-10-1" class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-10-2" class="td11"> - <!--l. 737--><p class="noindent" > </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-10-3" + <!--l. 739--><p class="noindent" > </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-10-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-10-4" class="td10"> - <!--l. 737--><p class="noindent" >Possible values are <span + <!--l. 739--><p class="noindent" >Possible values are <span class="ec-lmvtt-10">True</span>, <span class="ec-lmvtt-10">False </span>and <span class="ec-lmvtt-10">Unknown</span>.</td> @@ -1696,64 +1880,64 @@ class="ec-lmvtt-10">Unknown</span>.</td> style="vertical-align:baseline;" id="TBL-8-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-11-1" class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-11-2" class="td11"> - <!--l. 738--><p class="noindent" > </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-11-3" + <!--l. 740--><p class="noindent" > </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-11-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-11-4" class="td10"> - <!--l. 738--><p class="noindent" >An empty value means, the entry is not set. </td> + <!--l. 740--><p class="noindent" >An empty value means, the entry is not set. </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-12-1" class="td01"><span class="ec-lmvtt-10">pdfinfo </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-12-2" class="td11"> - <!--l. 739--><p class="noindent" >key + <!--l. 741--><p class="noindent" >key value list </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-12-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-12-4" class="td10"> - <!--l. 739--><p class="noindent" >Alternative interface for setting the document + <!--l. 741--><p class="noindent" >Alternative interface for setting the document information. </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-1" class="td01"><span class="ec-lmvtt-10">pdfview </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-13-2" class="td11"> - <!--l. 741--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-3" + <!--l. 743--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-13-3" class="td11"> <span class="ec-lmri-10">XYZ </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-13-4" class="td10"> - <!--l. 741--><p class="noindent" >Sets the default PDF ‘view’ for each link </td> + <!--l. 743--><p class="noindent" >Sets the default PDF ‘view’ for each link </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-14-1" class="td01"><span class="ec-lmvtt-10">pdfstartpage </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-14-2" class="td11"> - <!--l. 742--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-14-3" + <!--l. 744--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-14-3" class="td11"> <span class="ec-lmri-10">1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-14-4" class="td10"> - <!--l. 742--><p class="noindent" >Determines on which page the PDF file is + <!--l. 744--><p class="noindent" >Determines on which page the PDF file is opened. </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-15-1" class="td01"><span class="ec-lmvtt-10">pdfstartview </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-15-2" class="td11"> - <!--l. 743--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-15-3" + <!--l. 745--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-15-3" class="td11"> <span class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-15-4" class="td10"> - <!--l. 743--><p class="noindent" >Set the startup page view </td> + <!--l. 745--><p class="noindent" >Set the startup page view </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-16-1" class="td01"><span class="ec-lmvtt-10">pdfremotestartview </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-16-2" class="td11"> - <!--l. 744--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-16-3" + <!--l. 746--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-16-3" class="td11"> <span class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-16-4" class="td10"> - <!--l. 744--><p class="noindent" >Set the startup page view of remote PDF files</td> + <!--l. 746--><p class="noindent" >Set the startup page view of remote PDF files</td> </tr><tr @@ -1761,45 +1945,45 @@ class="td10"> class="td01"><span class="ec-lmvtt-10">pdfpagescrop </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-17-2" class="td11"> - <!--l. 745--><p class="noindent" >n + <!--l. 747--><p class="noindent" >n n n n </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-17-3" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-8-17-4" class="td10"> - <!--l. 745--><p class="noindent" >Sets the default PDF crop box for pages. This + <!--l. 747--><p class="noindent" >Sets the default PDF crop box for pages. This should be a set of four numbers </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-18-1" class="td01"><span class="ec-lmvtt-10">pdfcenterwindow </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-18-2" class="td11"> - <!--l. 746--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-18-3" + <!--l. 748--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-18-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-18-4" class="td10"> - <!--l. 746--><p class="noindent" >position the document window in the center + <!--l. 748--><p class="noindent" >position the document window in the center of the screen </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-19-1" class="td01"><span class="ec-lmvtt-10">pdfdirection </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-19-2" class="td11"> - <!--l. 747--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-19-3" + <!--l. 749--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-19-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-19-4" class="td10"> - <!--l. 747--><p class="noindent" >direction setting </td> + <!--l. 749--><p class="noindent" >direction setting </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-20-1" class="td01"><span class="ec-lmvtt-10">pdfdisplaydoctitle </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-20-2" class="td11"> - <!--l. 748--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-20-3" + <!--l. 750--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-20-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-20-4" class="td10"> - <!--l. 748--><p class="noindent" >display document title instead of file name in + <!--l. 750--><p class="noindent" >display document title instead of file name in title bar </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-21-1" @@ -1812,155 +1996,155 @@ class="td10"></td></tr> class="td01"><span class="ec-lmvtt-10">pdfduplex </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-22-2" class="td11"> - <!--l. 750--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-22-3" + <!--l. 752--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-22-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-22-4" class="td10"> - <!--l. 750--><p class="noindent" >paper handling option for print dialog </td> + <!--l. 752--><p class="noindent" >paper handling option for print dialog </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-23-1" class="td01"><span class="ec-lmvtt-10">pdffitwindow </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-23-2" class="td11"> - <!--l. 751--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-23-3" + <!--l. 753--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-23-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-23-4" class="td10"> - <!--l. 751--><p class="noindent" >resize document window to fit document size </td> + <!--l. 753--><p class="noindent" >resize document window to fit document size </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-24-1" class="td01"><span class="ec-lmvtt-10">pdflang </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-24-2" class="td11"> - <!--l. 752--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-24-3" + <!--l. 754--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-24-3" class="td11"> <span class="ec-lmri-10">relax </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-24-4" class="td10"> - <!--l. 752--><p class="noindent" >PDF language identifier (RFC 3066) </td> + <!--l. 754--><p class="noindent" >PDF language identifier (RFC 3066) </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-25-1" class="td01"><span class="ec-lmvtt-10">pdfmenubar </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-25-2" class="td11"> - <!--l. 753--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-25-3" + <!--l. 755--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-25-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-25-4" class="td10"> - <!--l. 753--><p class="noindent" >make PDF viewer’s menu bar visible </td> + <!--l. 755--><p class="noindent" >make PDF viewer’s menu bar visible </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-26-1" class="td01"><span class="ec-lmvtt-10">pdfnewwindow </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-26-2" class="td11"> - <!--l. 754--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-26-3" + <!--l. 756--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-26-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-26-4" class="td10"> - <!--l. 754--><p class="noindent" >make links that open another PDF file start a + <!--l. 756--><p class="noindent" >make links that open another PDF file start a new window </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-27-1" class="td01"><span class="ec-lmvtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-27-2" class="td11"> - <!--l. 756--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-27-3" + <!--l. 758--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-27-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-27-4" class="td10"> - <!--l. 756--><p class="noindent" >page mode setting on exiting full-screen mode</td> + <!--l. 758--><p class="noindent" >page mode setting on exiting full-screen mode</td> </tr><tr style="vertical-align:baseline;" id="TBL-8-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-28-1" class="td01"><span class="ec-lmvtt-10">pdfnumcopies </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-28-2" class="td11"> - <!--l. 758--><p class="noindent" >integer </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-28-3" + <!--l. 760--><p class="noindent" >integer </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-28-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-28-4" class="td10"> - <!--l. 758--><p class="noindent" >number of printed copies </td> + <!--l. 760--><p class="noindent" >number of printed copies </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-29-1" class="td01"><span class="ec-lmvtt-10">pdfpagelayout </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-29-2" class="td11"> - <!--l. 759--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-29-3" + <!--l. 761--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-29-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-29-4" class="td10"> - <!--l. 759--><p class="noindent" >set layout of PDF pages </td> + <!--l. 761--><p class="noindent" >set layout of PDF pages </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-30-1" class="td01"><span class="ec-lmvtt-10">pdfpagelabels </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-30-2" class="td11"> - <!--l. 760--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-30-3" + <!--l. 762--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-30-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-30-4" class="td10"> - <!--l. 760--><p class="noindent" >set PDF page labels </td> + <!--l. 762--><p class="noindent" >set PDF page labels </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-31-1" class="td01"><span class="ec-lmvtt-10">pdfpagetransition </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-31-2" class="td11"> - <!--l. 761--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-31-3" + <!--l. 763--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-31-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-31-4" class="td10"> - <!--l. 761--><p class="noindent" >set PDF page transition style </td> + <!--l. 763--><p class="noindent" >set PDF page transition style </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-32-1" class="td01"><span class="ec-lmvtt-10">pdfpicktraybypdfsize </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-32-2" class="td11"> - <!--l. 762--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-32-3" + <!--l. 764--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-32-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-32-4" class="td10"> - <!--l. 762--><p class="noindent" >set option for print dialog </td> + <!--l. 764--><p class="noindent" >set option for print dialog </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-33-1" class="td01"><span class="ec-lmvtt-10">pdfprintarea </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-33-2" class="td11"> - <!--l. 763--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-33-3" + <!--l. 765--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-33-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-33-4" class="td10"> - <!--l. 763--><p class="noindent" >set /PrintArea of viewer preferences </td> + <!--l. 765--><p class="noindent" >set /PrintArea of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-34-1" class="td01"><span class="ec-lmvtt-10">pdfprintclip </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-34-2" class="td11"> - <!--l. 764--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-34-3" + <!--l. 766--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-34-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-34-4" class="td10"> - <!--l. 764--><p class="noindent" >set /PrintClip of viewer preferences </td> + <!--l. 766--><p class="noindent" >set /PrintClip of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-35-1" class="td01"><span class="ec-lmvtt-10">pdfprintpagerange </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-35-2" class="td11"> - <!--l. 765--><p class="noindent" >n + <!--l. 767--><p class="noindent" >n n (n n)* </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-35-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-35-4" class="td10"> - <!--l. 766--><p class="noindent" >set /PrintPageRange of viewer preferences </td> + <!--l. 768--><p class="noindent" >set /PrintPageRange of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-36-1" class="td01"><span class="ec-lmvtt-10">pdfprintscaling </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-36-2" class="td11"> - <!--l. 768--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-36-3" + <!--l. 770--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-36-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-36-4" class="td10"> - <!--l. 768--><p class="noindent" >page scaling option for print dialog (option + <!--l. 770--><p class="noindent" >page scaling option for print dialog (option /PrintScaling of viewer preferences, PDF 1.6); valid values are <span class="ec-lmvtt-10">None </span>and <span @@ -1970,51 +2154,51 @@ class="ec-lmvtt-10">AppDefault</span> </td> class="td01"><span class="ec-lmvtt-10">pdftoolbar </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-37-2" class="td11"> - <!--l. 773--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-37-3" + <!--l. 775--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-37-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-37-4" class="td10"> - <!--l. 773--><p class="noindent" >make PDF toolbar visible </td> + <!--l. 775--><p class="noindent" >make PDF toolbar visible </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-38-1" class="td01"><span class="ec-lmvtt-10">pdfviewarea </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-38-2" class="td11"> - <!--l. 774--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-38-3" + <!--l. 776--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-38-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-38-4" class="td10"> - <!--l. 774--><p class="noindent" >set /ViewArea of viewer preferences </td> + <!--l. 776--><p class="noindent" >set /ViewArea of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-39-1" class="td01"><span class="ec-lmvtt-10">pdfviewclip </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-39-2" class="td11"> - <!--l. 775--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-39-3" + <!--l. 777--><p class="noindent" >text </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-39-3" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-39-4" class="td10"> - <!--l. 775--><p class="noindent" >set /ViewClip of viewer preferences </td> + <!--l. 777--><p class="noindent" >set /ViewClip of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-40-1" class="td01"><span class="ec-lmvtt-10">pdfwindowui </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-40-2" class="td11"> - <!--l. 776--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-40-3" + <!--l. 778--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-40-3" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-40-4" class="td10"> - <!--l. 776--><p class="noindent" >make PDF user interface elements visible </td> + <!--l. 778--><p class="noindent" >make PDF user interface elements visible </td> </tr><tr style="vertical-align:baseline;" id="TBL-8-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-41-1" class="td01"><span class="ec-lmvtt-10">unicode </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-41-2" class="td11"> - <!--l. 777--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-41-3" + <!--l. 779--><p class="noindent" >boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-41-3" class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-8-41-4" class="td10"> - <!--l. 777--><p class="noindent" >Unicode encoded PDF strings </td> + <!--l. 779--><p class="noindent" >Unicode encoded PDF strings </td> </tr><tr @@ -2030,16 +2214,16 @@ class="td01"> </td> style="vertical-align:baseline;" id="TBL-8-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-45-1" class="td01"> </td></tr> </table></div> -<!--l. 780--><p class="indent" > Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, -which is not the same as <span class="TEX">T<span -class="E">E</span>X</span>’s. The unit is bp and the origin is in the lower left corner. See also -<span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hypercalcbp</span></span></span> that is explained on page <a -href="#x1-180004.2">43<!--tex4ht:ref: hypercalcbp --></a>. pdf<span class="TEX">T<span +<!--l. 782--><p class="noindent" >Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, which +is not the same as <span class="TEX">T<span +class="E">E</span>X</span>’s. The unit is bp and the origin is in the lower left corner. See also <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypercalcbp</span></span></span> +that is explained on page <a +href="#x1-180004.2">46<!--tex4ht:ref: hypercalcbp --></a>. pdf<span class="TEX">T<span class="E">E</span>X</span> works by supplying default values for <span -class="ec-lmvtt-10">XYZ</span> -(horizontal <span -class="lmsy-10">× </span>vertical <span +class="ec-lmvtt-10">XYZ </span>(horizontal <span +class="lmsy-10">×</span> +vertical <span class="lmsy-10">× </span>zoom) and <span class="ec-lmvtt-10">FitBH</span>. However, drivers using <span class="ec-lmvtt-10">pdfmark </span>do not supply defaults, so @@ -2050,9 +2234,8 @@ class="ec-lmvtt-10">pdfview</span>, <span class="ec-lmvtt-10">pdfstartview </span>and <span class="ec-lmvtt-10">pdfremotestartview</span> parameters. -<!--l. 792--><p class="noindent" > <a - id="x1-11002r8"></a> <!--l. 793--><div class="longtable"> <table id="TBL-9" class="longtable" + id="x1-11002r8"></a> <!--l. 795--><div class="longtable"> <table id="TBL-9" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-9-1g"><col id="TBL-9-1"><col @@ -2060,158 +2243,157 @@ id="TBL-9-2"><col id="TBL-9-3"></colgroup> <tr style="vertical-align:baseline;" id="TBL-9-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-1-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">XYZ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-1-2" class="td11"> <span class="ec-lmri-10">left top zoom </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-1-3" -class="td11"> - <!--l. 793--><p class="noindent" >Sets a coordinate and a zoom factor. If any one +class="td10"> + <!--l. 795--><p class="noindent" >Sets a coordinate and a zoom factor. If any one is null, the source link value is used. <span class="ec-lmri-10">null null</span> <span class="ec-lmri-10">null </span>will give the same values as the current - page. </td> + page. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-2-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Fit </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-2-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-9-2-3" -class="td11"> - <!--l. 795--><p class="noindent" >Fits the page to the window. </td> +class="td10"> + <!--l. 797--><p class="noindent" >Fits the page to the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-3-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">FitH </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-3-2" class="td11"> <span class="ec-lmri-10">top </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-3-3" -class="td11"> - <!--l. 796--><p class="noindent" >Fits the width of the page to the window. </td> +class="td10"> + <!--l. 798--><p class="noindent" >Fits the width of the page to the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-4-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">FitV </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-4-2" class="td11"> <span class="ec-lmri-10">left </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-4-3" -class="td11"> - <!--l. 797--><p class="noindent" >Fits the height of the page to the window. </td> +class="td10"> + <!--l. 799--><p class="noindent" >Fits the height of the page to the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-5-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">FitR </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-5-2" class="td11"> <span class="ec-lmri-10">left bottom right top </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-5-3" -class="td11"> - <!--l. 798--><p class="noindent" >Fits the rectangle specified by the four - coordinates to the window. </td> +class="td10"> + <!--l. 800--><p class="noindent" >Fits the rectangle specified by the four + coordinates to the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-6-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">FitB </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-6-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-9-6-3" -class="td11"> - <!--l. 799--><p class="noindent" >Fits the page bounding box to the window. </td> +class="td10"> + <!--l. 801--><p class="noindent" >Fits the page bounding box to the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-7-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">FitBH </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-7-2" class="td11"> <span class="ec-lmri-10">top </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-7-3" -class="td11"> - <!--l. 800--><p class="noindent" >Fits the width of the page bounding box to - the window. </td> +class="td10"> + <!--l. 802--><p class="noindent" >Fits the width of the page bounding box to + the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-8-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">FitBV </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-9-8-2" class="td11"> <span class="ec-lmri-10">left </span></td><td style="white-space:wrap; text-align:left;" id="TBL-9-8-3" -class="td11"> - <!--l. 801--><p class="noindent" >Fits the height of the page bounding box to - the window. </td> +class="td10"> + <!--l. 803--><p class="noindent" >Fits the height of the page bounding box to + the window. </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-9-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-10-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-11-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-12-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-9-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-13-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-13-2" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-9-13-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-9-13-3" -class="td11"></td></tr> +class="td10"></td></tr> </table></div> -<!--l. 804--><p class="indent" > The <span +<!--l. 806--><p class="indent" > The <span class="ec-lmvtt-10">pdfpagelayout </span>can be one of the following values. -<!--l. 806--><p class="noindent" > <a - id="x1-11003r9"></a> <!--l. 807--><div class="longtable"> <table id="TBL-10" class="longtable" + id="x1-11003r9"></a> <!--l. 809--><div class="longtable"> <table id="TBL-10" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-10-1g"><col id="TBL-10-1"><col id="TBL-10-2"></colgroup> <tr style="vertical-align:baseline;" id="TBL-10-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-1-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">SinglePage </span></td><td style="white-space:wrap; text-align:left;" id="TBL-10-1-2" -class="td11"> - <!--l. 807--><p class="noindent" >Displays a single page; advancing flips the page </td> +class="td10"> + <!--l. 809--><p class="noindent" >Displays a single page; advancing flips the page </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">OneColumn </span></td><td style="white-space:wrap; text-align:left;" id="TBL-10-2-2" -class="td11"> - <!--l. 808--><p class="noindent" >Displays the document in one column; continuous scrolling. </td> +class="td10"> + <!--l. 810--><p class="noindent" >Displays the document in one column; continuous scrolling. </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">TwoColumnLeft </span></td><td style="white-space:wrap; text-align:left;" id="TBL-10-3-2" -class="td11"> - <!--l. 809--><p class="noindent" >Displays the document in two columns, odd-numbered pages to - the left. </td> +class="td10"> + <!--l. 811--><p class="noindent" >Displays the document in two columns, odd-numbered pages to + the left. </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">TwoColumnRight </span></td><td style="white-space:wrap; text-align:left;" id="TBL-10-4-2" -class="td11"> - <!--l. 810--><p class="noindent" >Displays the document in two columns, odd-numbered pages to - the right. </td> +class="td10"> + <!--l. 812--><p class="noindent" >Displays the document in two columns, odd-numbered pages to + the right. </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">TwoPageLeft </span></td><td style="white-space:wrap; text-align:left;" id="TBL-10-5-2" -class="td11"> - <!--l. 811--><p class="noindent" >Displays two pages, odd-numbered pages to the left (since PDF - 1.5). </td> +class="td10"> + <!--l. 813--><p class="noindent" >Displays two pages, odd-numbered pages to the left (since PDF + 1.5). </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">TwoPageRight </span></td><td style="white-space:wrap; text-align:left;" id="TBL-10-6-2" -class="td11"> - <!--l. 812--><p class="noindent" >Displays two pages, odd-numbered pages to the right (since PDF - 1.5). </td> +class="td10"> + <!--l. 814--><p class="noindent" >Displays two pages, odd-numbered pages to the right (since PDF + 1.5). </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-7-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-8-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-9-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-10-1" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-10-10-2" -class="td11"></td></tr> +class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-10-10-2" +class="td10"></td></tr> </table></div> -<!--l. 815--><p class="indent" > Finally, the <span +<!--l. 817--><p class="indent" > Finally, the <span class="ec-lmvtt-10">pdfpagetransition </span>can be one of the following values, where <span class="ec-lmri-10">/Di </span>stands for direction of motion in degrees, generally in 90<sup><span @@ -2224,9 +2406,8 @@ class="ec-lmvtt-10">Blinds /Dm /V</span>), and <span class="ec-lmri-10">/M </span>is for motion, either in (<span class="ec-lmvtt-10">/I</span>) or out (<span class="ec-lmvtt-10">/O</span>). -<!--l. 822--><p class="noindent" > <a - id="x1-11004r10"></a> <!--l. 823--><div class="longtable"> <table id="TBL-11" class="longtable" + id="x1-11004r10"></a> <!--l. 825--><div class="longtable"> <table id="TBL-11" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-11-1g"><col id="TBL-11-1"><col @@ -2234,70 +2415,70 @@ id="TBL-11-2"><col id="TBL-11-3"></colgroup> <tr style="vertical-align:baseline;" id="TBL-11-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-1-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Blinds </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-1-2" class="td11"> /Dm </td><td style="white-space:wrap; text-align:left;" id="TBL-11-1-3" -class="td11"> - <!--l. 823--><p class="noindent" >Multiple lines distributed evenly across the screen sweep - in the same direction to reveal the new page. </td> +class="td10"> + <!--l. 825--><p class="noindent" >Multiple lines distributed evenly across the screen sweep + in the same direction to reveal the new page. </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-2-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Box </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-2-2" class="td11"> /M </td><td style="white-space:wrap; text-align:left;" id="TBL-11-2-3" -class="td11"> - <!--l. 825--><p class="noindent" >A box sweeps in or out. </td> +class="td10"> + <!--l. 827--><p class="noindent" >A box sweeps in or out. </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-3-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Dissolve </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-3-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-3-3" -class="td11"> - <!--l. 826--><p class="noindent" >The page image dissolves in a piecemeal fashion to reveal - the new page. </td> +class="td10"> + <!--l. 828--><p class="noindent" >The page image dissolves in a piecemeal fashion to reveal + the new page. </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-4-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Glitter </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-4-2" class="td11"> /Di </td><td style="white-space:wrap; text-align:left;" id="TBL-11-4-3" -class="td11"> - <!--l. 827--><p class="noindent" >Similar to Dissolve, except the effect sweeps across the - screen. </td> +class="td10"> + <!--l. 829--><p class="noindent" >Similar to Dissolve, except the effect sweeps across the + screen. </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-5-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Split </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-5-2" class="td11"> /Dm /M </td><td style="white-space:wrap; text-align:left;" id="TBL-11-5-3" -class="td11"> - <!--l. 828--><p class="noindent" >Two lines sweep across the screen to reveal the new page. </td> +class="td10"> + <!--l. 830--><p class="noindent" >Two lines sweep across the screen to reveal the new page.</td> </tr><tr style="vertical-align:baseline;" id="TBL-11-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-6-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">Wipe </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-11-6-2" class="td11"> /Di </td><td style="white-space:wrap; text-align:left;" id="TBL-11-6-3" -class="td11"> - <!--l. 829--><p class="noindent" >A single line sweeps across the screen to reveal the new - page. </td> +class="td10"> + <!--l. 831--><p class="noindent" >A single line sweeps across the screen to reveal the new + page. </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-7-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-8-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-9-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-11-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-11-10-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-10-2" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-11-10-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-11-10-3" -class="td11"></td></tr> +class="td10"></td></tr> </table></div> -<!--l. 832--><p class="noindent" > +<!--l. 834--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.8 </span> <a id="x1-120003.8"></a>Option <span class="ec-lmvtt-10">pdfinfo</span></h4> -<!--l. 834--><p class="noindent" >The information entries can be set using <span +<!--l. 836--><p class="noindent" >The information entries can be set using <span class="ec-lmvtt-10">pdftitle</span>, <span class="ec-lmvtt-10">pdfsubject</span>, …. Option <span class="ec-lmvtt-10">pdfinfo </span>provides an alternative @@ -2324,15 +2505,14 @@ strings (see PDF specification). Example:  <br />  }  <br />} </div> - <!--l. 853--><p class="nopar" ></div> -<!--l. 856--><p class="noindent" > + <!--l. 855--><p class="nopar" ></div> +<!--l. 858--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">3.9 </span> <a id="x1-130003.9"></a>Big alphabetical list</h4> -<!--l. 858--><p class="noindent" >The following is a complete listing of available options for <span +<!--l. 860--><p class="noindent" >The following is a complete listing of available options for <span class="ec-lmss-10">hyperref</span>, arranged alphabetically. -<!--l. 861--><p class="noindent" > <a - id="x1-13001r11"></a> <!--l. 862--><div class="longtable"> <table id="TBL-12" class="longtable" + id="x1-13001r11"></a> <!--l. 864--><div class="longtable"> <table id="TBL-12" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-12-1g"><col id="TBL-12-1"><col @@ -2345,7 +2525,7 @@ class="ec-lmvtt-10">anchorcolor </span></td><td style="white-space class="td11"> <span class="ec-lmri-10">black </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-1-3" class="td10"> - <!--l. 862--><p class="noindent" >set color of anchors </td> + <!--l. 864--><p class="noindent" >set color of anchors </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-2-1" class="td01"><span @@ -2353,7 +2533,7 @@ class="ec-lmvtt-10">backref </span></td><td style="white-spa class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-2-3" class="td10"> - <!--l. 863--><p class="noindent" >do bibliographical back references </td> + <!--l. 865--><p class="noindent" >do bibliographical back references </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-3-1" class="td01"><span @@ -2361,7 +2541,7 @@ class="ec-lmvtt-10">baseurl </span></td><td style="white-spa class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-3-3" class="td10"> - <!--l. 864--><p class="noindent" >set base URL for document </td> + <!--l. 866--><p class="noindent" >set base URL for document </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-4-1" class="td01"><span @@ -2369,7 +2549,7 @@ class="ec-lmvtt-10">bookmarks </span></td><td style="white-space: class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-4-3" class="td10"> - <!--l. 865--><p class="noindent" >make bookmarks </td> + <!--l. 867--><p class="noindent" >make bookmarks </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-5-1" class="td01"><span @@ -2377,7 +2557,7 @@ class="ec-lmvtt-10">bookmarksnumbered </span></td><td style="white-space:nowra class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-5-3" class="td10"> - <!--l. 866--><p class="noindent" >put section numbers in bookmarks </td> + <!--l. 868--><p class="noindent" >put section numbers in bookmarks </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-6-1" class="td01"><span @@ -2385,7 +2565,7 @@ class="ec-lmvtt-10">bookmarksopen </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-6-3" class="td10"> - <!--l. 867--><p class="noindent" >open up bookmark tree </td> + <!--l. 869--><p class="noindent" >open up bookmark tree </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-7-1" class="td01"><span @@ -2393,7 +2573,7 @@ class="ec-lmvtt-10">bookmarksopenlevel </span></td><td style="white-space:now class="td11"> <span class="ec-lmvtt-10">\maxdimen </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-7-3" class="td10"> - <!--l. 868--><p class="noindent" >level to which bookmarks are open </td> + <!--l. 870--><p class="noindent" >level to which bookmarks are open </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-8-1" class="td01"><span @@ -2401,7 +2581,7 @@ class="ec-lmvtt-10">bookmarkstype </span></td><td style="white-space:no class="td11"> <span class="ec-lmri-10">toc </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-8-3" class="td10"> - <!--l. 869--><p class="noindent" >to specify which ‘toc’ file to mimic </td> + <!--l. 871--><p class="noindent" >to specify which ‘toc’ file to mimic </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-9-1" class="td01"><span @@ -2409,7 +2589,7 @@ class="ec-lmvtt-10">breaklinks </span></td><td style="white-spac class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-9-3" class="td10"> - <!--l. 870--><p class="noindent" >allow links to break over lines </td> + <!--l. 872--><p class="noindent" >allow links to break over lines </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-10-1" class="td01"><span @@ -2417,7 +2597,7 @@ class="ec-lmvtt-10">CJKbookmarks </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-10-3" class="td10"> - <!--l. 871--><p class="noindent" >to produce CJK bookmarks </td> + <!--l. 873--><p class="noindent" >to produce CJK bookmarks </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-11-1" class="td01"><span @@ -2425,7 +2605,7 @@ class="ec-lmvtt-10">citebordercolor </span></td><td style="white-space: class="td11"> <span class="ec-lmri-10">0 1 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-11-3" class="td10"> - <!--l. 872--><p class="noindent" >color of border around cites </td> + <!--l. 874--><p class="noindent" >color of border around cites </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-12-1" class="td01"><span @@ -2433,7 +2613,7 @@ class="ec-lmvtt-10">citecolor </span></td><td style="white-spa class="td11"> <span class="ec-lmri-10">green </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-12-3" class="td10"> - <!--l. 873--><p class="noindent" >color of citation links </td> + <!--l. 875--><p class="noindent" >color of citation links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-13-1" class="td01"><span @@ -2441,14 +2621,14 @@ class="ec-lmvtt-10">colorlinks </span></td><td style="white-spa class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-13-3" class="td10"> - <!--l. 874--><p class="noindent" >color links </td> + <!--l. 876--><p class="noindent" >color links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-14-1" class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-14-2" class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-14-3" class="td10"> - <!--l. 875--><p class="noindent" >(<span + <!--l. 877--><p class="noindent" >(<span class="ec-lmss-10">tex4ht</span>, <span class="ec-lmss-10">dviwindo</span>) </td> </tr><tr @@ -2458,7 +2638,7 @@ class="ec-lmvtt-10">debug </span></td><td style="white-spac class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-15-3" class="td10"> - <!--l. 876--><p class="noindent" >provide details of anchors defined; same as + <!--l. 878--><p class="noindent" >provide details of anchors defined; same as verbose </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-16-1" @@ -2467,11 +2647,9 @@ class="ec-lmvtt-10">destlabel </span></td><td style="white-spac class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-16-3" class="td10"> - <!--l. 877--><p class="noindent" >destinations are named by the first <span class="obeylines-h"><span class="verb"><span + <!--l. 879--><p class="noindent" >destinations are named by the first <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\label</span></span></span> after the anchor creation </td> - - </tr><tr style="vertical-align:baseline;" id="TBL-12-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-17-1" class="td01"><span @@ -2479,14 +2657,15 @@ class="ec-lmvtt-10">draft </span></td><td style="white-sp class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-17-3" class="td10"> - <!--l. 878--><p class="noindent" >do not do any hyperlinking </td> + <!--l. 880--><p class="noindent" >do not do any hyperlinking </td> + </tr><tr style="vertical-align:baseline;" id="TBL-12-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-18-1" class="td01"><span class="ec-lmvtt-10">dvipdfm </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-18-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-18-3" class="td10"> - <!--l. 879--><p class="noindent" >use <span + <!--l. 881--><p class="noindent" >use <span class="ec-lmss-10">dvipdfm </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-19-1" @@ -2494,7 +2673,7 @@ class="td01"><span class="ec-lmvtt-10">dvipdfmx </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-19-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-19-3" class="td10"> - <!--l. 880--><p class="noindent" >use <span + <!--l. 882--><p class="noindent" >use <span class="ec-lmss-10">dvipdfmx </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-20-1" @@ -2502,7 +2681,7 @@ class="td01"><span class="ec-lmvtt-10">dvips </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-20-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-20-3" class="td10"> - <!--l. 881--><p class="noindent" >use <span + <!--l. 883--><p class="noindent" >use <span class="ec-lmss-10">dvips </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-21-1" @@ -2515,7 +2694,7 @@ class="td01"><span class="ec-lmvtt-10">dvipsone </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-22-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-22-3" class="td10"> - <!--l. 882--><p class="noindent" >use <span + <!--l. 884--><p class="noindent" >use <span class="ec-lmss-10">dvipsone </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-23-1" @@ -2523,7 +2702,7 @@ class="td01"><span class="ec-lmvtt-10">dviwindo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-23-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-23-3" class="td10"> - <!--l. 883--><p class="noindent" >use <span + <!--l. 885--><p class="noindent" >use <span class="ec-lmss-10">dviwindo </span>backend </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-24-1" @@ -2531,7 +2710,7 @@ class="td01"><span class="ec-lmvtt-10">encap </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-24-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-24-3" class="td10"> - <!--l. 884--><p class="noindent" >to set encap character for hyperindex </td> + <!--l. 886--><p class="noindent" >to set encap character for hyperindex </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-25-1" class="td01"><span @@ -2539,7 +2718,7 @@ class="ec-lmvtt-10">extension </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">dvi </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-25-3" class="td10"> - <!--l. 885--><p class="noindent" >suffix of linked files </td> + <!--l. 887--><p class="noindent" >suffix of linked files </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-26-1" class="td01"><span @@ -2547,7 +2726,7 @@ class="ec-lmvtt-10">filebordercolor </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">0 .5 .5 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-26-3" class="td10"> - <!--l. 886--><p class="noindent" >color of border around file links </td> + <!--l. 888--><p class="noindent" >color of border around file links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-27-1" class="td01"><span @@ -2555,7 +2734,7 @@ class="ec-lmvtt-10">filecolor </span></td><td style="white-space:n class="td11"> <span class="ec-lmri-10">cyan </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-27-3" class="td10"> - <!--l. 887--><p class="noindent" >color of file links </td> + <!--l. 889--><p class="noindent" >color of file links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-28-1" class="td01"><span @@ -2563,7 +2742,7 @@ class="ec-lmvtt-10">final </span></td><td style="white-space:n class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-28-3" class="td10"> - <!--l. 888--><p class="noindent" >opposite of option draft </td> + <!--l. 890--><p class="noindent" >opposite of option draft </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-29-1" class="td01"><span @@ -2571,7 +2750,7 @@ class="ec-lmvtt-10">frenchlinks </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-29-3" class="td10"> - <!--l. 889--><p class="noindent" >use small caps instead of color for links </td> + <!--l. 891--><p class="noindent" >use small caps instead of color for links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-30-1" class="td01"><span @@ -2579,7 +2758,7 @@ class="ec-lmvtt-10">hyperfigures </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-30-3" class="td10"> - <!--l. 890--><p class="noindent" >make figures hyper links </td> + <!--l. 892--><p class="noindent" >make figures hyper links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-31-1" class="td01"><span @@ -2587,7 +2766,7 @@ class="ec-lmvtt-10">hyperfootnotes </span></td><td style="white-space:nowrap class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-31-3" class="td10"> - <!--l. 891--><p class="noindent" >set up hyperlinked footnotes </td> + <!--l. 893--><p class="noindent" >set up hyperlinked footnotes </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-32-1" class="td01"><span @@ -2595,14 +2774,14 @@ class="ec-lmvtt-10">hyperindex </span></td><td style="white-space:nowra class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-32-3" class="td10"> - <!--l. 892--><p class="noindent" >set up hyperlinked indices </td> + <!--l. 894--><p class="noindent" >set up hyperlinked indices </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-33-1" class="td01"><span class="ec-lmvtt-10">hypertex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-33-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-33-3" class="td10"> - <!--l. 893--><p class="noindent" >use <span + <!--l. 895--><p class="noindent" >use <span class="ec-lmss-10">Hyper</span><span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span @@ -2615,7 +2794,7 @@ class="ec-lmvtt-10">hypertexnames </span></td><td style="white-space:nowrap; class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-34-3" class="td10"> - <!--l. 894--><p class="noindent" >use guessable names for links </td> + <!--l. 896--><p class="noindent" >use guessable names for links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-35-1" class="td01"><span @@ -2623,7 +2802,7 @@ class="ec-lmvtt-10">implicit </span></td><td style="white-space:no class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-35-3" class="td10"> - <!--l. 895--><p class="noindent" >redefine <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span + <!--l. 897--><p class="noindent" >redefine <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span> internals </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-36-1" @@ -2631,7 +2810,7 @@ class="td01"><span class="ec-lmvtt-10">latex2html </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-36-2" class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-36-3" class="td10"> - <!--l. 896--><p class="noindent" >use <span class="LATEX"><span + <!--l. 898--><p class="noindent" >use <span class="LATEX"><span class="ec-lmss-10">L</span><span class="A"><span class="ec-lmss-10">A</span></span><span class="TEX"><span class="ec-lmss-10">T</span><span @@ -2646,7 +2825,7 @@ class="ec-lmvtt-10">linkbordercolor </span></td><td style="white-space:nowra class="td11"> <span class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-37-3" class="td10"> - <!--l. 897--><p class="noindent" >color of border around links </td> + <!--l. 899--><p class="noindent" >color of border around links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-38-1" class="td01"><span @@ -2654,7 +2833,7 @@ class="ec-lmvtt-10">linkcolor </span></td><td style="white-space:no class="td11"> <span class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-38-3" class="td10"> - <!--l. 898--><p class="noindent" >color of links </td> + <!--l. 900--><p class="noindent" >color of links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-39-1" class="td01"><span @@ -2662,7 +2841,7 @@ class="ec-lmvtt-10">linktoc </span></td><td style="white-space:no class="td11"> <span class="ec-lmri-10">section </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-39-3" class="td10"> - <!--l. 899--><p class="noindent" >make text be link on TOC, LOF and LOT </td> + <!--l. 901--><p class="noindent" >make text be link on TOC, LOF and LOT </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-40-1" class="td01"><span @@ -2670,7 +2849,7 @@ class="ec-lmvtt-10">linktocpage </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-40-3" class="td10"> - <!--l. 900--><p class="noindent" >make page number, not text, be link on TOC, + <!--l. 902--><p class="noindent" >make page number, not text, be link on TOC, LOF and LOT </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-41-1" @@ -2679,7 +2858,7 @@ class="ec-lmvtt-10">menubordercolor </span></td><td style="white-space:nowrap; class="td11"> <span class="ec-lmri-10">1 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-41-3" class="td10"> - <!--l. 901--><p class="noindent" >color of border around menu links </td> + <!--l. 903--><p class="noindent" >color of border around menu links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-42-1" class="td01"> </td></tr> @@ -2690,7 +2869,7 @@ class="ec-lmvtt-10">menucolor </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">red </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-43-3" class="td10"> - <!--l. 902--><p class="noindent" >color for menu links </td> + <!--l. 904--><p class="noindent" >color for menu links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-44-1" class="td01"><span @@ -2698,7 +2877,7 @@ class="ec-lmvtt-10">nativepdf </span></td><td style="white-space:no class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-44-3" class="td10"> - <!--l. 903--><p class="noindent" >an alias for <span + <!--l. 905--><p class="noindent" >an alias for <span class="ec-lmss-10">dvips</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-45-1" @@ -2707,7 +2886,7 @@ class="ec-lmvtt-10">naturalnames </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-45-3" class="td10"> - <!--l. 904--><p class="noindent" >use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span + <!--l. 906--><p class="noindent" >use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span class="E">E</span>X</span></span>-computed names for links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-46-1" @@ -2716,7 +2895,7 @@ class="ec-lmvtt-10">nesting </span></td><td style="white-space:n class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-46-3" class="td10"> - <!--l. 905--><p class="noindent" >allow nesting of links </td> + <!--l. 907--><p class="noindent" >allow nesting of links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-47-1" class="td01"><span @@ -2724,7 +2903,7 @@ class="ec-lmvtt-10">pageanchor </span></td><td style="white-space:nowr class="td11"> <span class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-47-3" class="td10"> - <!--l. 906--><p class="noindent" >put an anchor on every page </td> + <!--l. 908--><p class="noindent" >put an anchor on every page </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-48-1" class="td01"><span @@ -2732,9 +2911,7 @@ class="ec-lmvtt-10">pagebackref </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-48-3" class="td10"> - <!--l. 907--><p class="noindent" >backreference by page number </td> - - + <!--l. 909--><p class="noindent" >backreference by page number </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-49-1" class="td01"><span @@ -2742,7 +2919,9 @@ class="ec-lmvtt-10">pdfauthor </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-49-3" class="td10"> - <!--l. 908--><p class="noindent" >text for PDF Author field </td> + <!--l. 910--><p class="noindent" >text for PDF Author field </td> + + </tr><tr style="vertical-align:baseline;" id="TBL-12-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-50-1" class="td01"><span @@ -2750,14 +2929,14 @@ class="ec-lmvtt-10">pdfborder </span></td><td style="white-space:now class="td11"> <span class="ec-lmri-10">0 0 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-50-3" class="td10"> - <!--l. 909--><p class="noindent" >width of PDF link border </td> + <!--l. 911--><p class="noindent" >width of PDF link border </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-51-1" class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-51-2" class="td11"> <span class="ec-lmri-10">0 0 0 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-51-3" class="td10"> - <!--l. 910--><p class="noindent" >(<span + <!--l. 912--><p class="noindent" >(<span class="ec-lmvtt-10">colorlinks)</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-52-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-52-1" @@ -2766,7 +2945,7 @@ class="ec-lmvtt-10">pdfcenterwindow </span></td><td style="white-space:nowrap class="td11"> <span class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-52-3" class="td10"> - <!--l. 911--><p class="noindent" >position the document window in the center + <!--l. 913--><p class="noindent" >position the document window in the center of the screen </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-53-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-53-1" @@ -2775,487 +2954,479 @@ class="ec-lmvtt-10">pdfcreator </span></td><td style="white-space:no class="td11"> <span class="ec-lmri-10">LaTeX with </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-53-3" class="td10"> - <!--l. 912--><p class="noindent" >text for PDF Creator field </td> + <!--l. 914--><p class="noindent" >text for PDF Creator field </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-54-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-54-1" class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-54-2" class="td11"> <span class="ec-lmri-10">hyperref </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-54-3" class="td10"> - <!--l. 914--><p class="noindent" > </td> + <!--l. 916--><p class="noindent" > </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-55-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-55-1" -class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-55-2" +class="td01"><span +class="ec-lmvtt-10">pdfdirection </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-55-2" class="td11"> <span -class="ec-lmri-10">package </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-55-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-55-3" class="td10"> - <!--l. 915--><p class="noindent" > </td> + <!--l. 916--><p class="noindent" >direction setting </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-56-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-56-1" class="td01"><span -class="ec-lmvtt-10">pdfdirection </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-56-2" +class="ec-lmvtt-10">pdfdisplaydoctitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-56-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-56-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-56-3" class="td10"> - <!--l. 915--><p class="noindent" >direction setting </td> + <!--l. 917--><p class="noindent" >display document title instead of file name in + title bar </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-57-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-57-1" class="td01"><span -class="ec-lmvtt-10">pdfdisplaydoctitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-57-2" +class="ec-lmvtt-10">pdfduplex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-57-2" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-57-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-57-3" class="td10"> - <!--l. 916--><p class="noindent" >display document title instead of file name in - title bar </td> + <!--l. 919--><p class="noindent" >paper handling option for print dialog </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-58-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-58-1" class="td01"><span -class="ec-lmvtt-10">pdfduplex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-58-2" +class="ec-lmvtt-10">pdffitwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-58-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-58-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-58-3" class="td10"> - <!--l. 918--><p class="noindent" >paper handling option for print dialog </td> + <!--l. 921--><p class="noindent" >resize document window to fit document size </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-59-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-59-1" class="td01"><span -class="ec-lmvtt-10">pdffitwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-59-2" +class="ec-lmvtt-10">pdfhighlight </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-59-2" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-59-3" +class="ec-lmri-10">/I </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-59-3" class="td10"> - <!--l. 920--><p class="noindent" >resize document window to fit document size </td> + <!--l. 922--><p class="noindent" >set highlighting of PDF links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-60-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-60-1" class="td01"><span -class="ec-lmvtt-10">pdfhighlight </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-60-2" +class="ec-lmvtt-10">pdfinfo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-60-2" class="td11"> <span -class="ec-lmri-10">/I </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-60-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-60-3" class="td10"> - <!--l. 921--><p class="noindent" >set highlighting of PDF links </td> + <!--l. 923--><p class="noindent" >alternative interface for setting document + information </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-61-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-61-1" class="td01"><span -class="ec-lmvtt-10">pdfinfo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-61-2" +class="ec-lmvtt-10">pdfkeywords </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-61-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-61-3" class="td10"> - <!--l. 922--><p class="noindent" >alternative interface for setting document - information </td> + <!--l. 924--><p class="noindent" >text for PDF Keywords field </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-62-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-62-1" class="td01"><span -class="ec-lmvtt-10">pdfkeywords </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-62-2" +class="ec-lmvtt-10">pdflang </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-62-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-62-3" +class="ec-lmri-10">relax </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-62-3" class="td10"> - <!--l. 923--><p class="noindent" >text for PDF Keywords field </td> + <!--l. 925--><p class="noindent" >PDF language identifier (RFC 3066) </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-63-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-63-1" class="td01"> </td></tr> <tr style="vertical-align:baseline;" id="TBL-12-64-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-64-1" class="td01"><span -class="ec-lmvtt-10">pdflang </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-64-2" +class="ec-lmvtt-10">pdfmark </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-64-2" class="td11"> <span -class="ec-lmri-10">relax </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-64-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-64-3" class="td10"> - <!--l. 924--><p class="noindent" >PDF language identifier (RFC 3066) </td> + <!--l. 926--><p class="noindent" >an alias for <span +class="ec-lmss-10">dvips</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-65-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-65-1" class="td01"><span -class="ec-lmvtt-10">pdfmark </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-65-2" +class="ec-lmvtt-10">pdfmenubar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-65-2" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-65-3" +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-65-3" class="td10"> - <!--l. 925--><p class="noindent" >an alias for <span -class="ec-lmss-10">dvips</span> </td> + <!--l. 927--><p class="noindent" >make PDF viewer’s menu bar visible </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-66-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-66-1" class="td01"><span -class="ec-lmvtt-10">pdfmenubar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-66-2" +class="ec-lmvtt-10">pdfnewwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-66-2" class="td11"> <span -class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-66-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-66-3" class="td10"> - <!--l. 926--><p class="noindent" >make PDF viewer’s menu bar visible </td> + <!--l. 928--><p class="noindent" >make links that open another PDF </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-67-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-67-1" -class="td01"><span -class="ec-lmvtt-10">pdfnewwindow </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-67-2" -class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-67-3" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-67-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-67-3" class="td10"> - <!--l. 927--><p class="noindent" >make links that open another PDF </td> + <!--l. 929--><p class="noindent" >file start a new window </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-68-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-68-1" -class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-12-68-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-68-3" +class="td01"><span +class="ec-lmvtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-68-2" +class="td11"> <span +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-68-3" class="td10"> - <!--l. 928--><p class="noindent" >file start a new window </td> + <!--l. 931--><p class="noindent" >page mode setting on exiting full-screen mode</td> </tr><tr style="vertical-align:baseline;" id="TBL-12-69-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-69-1" class="td01"><span -class="ec-lmvtt-10">pdfnonfullscreenpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-69-2" +class="ec-lmvtt-10">pdfnumcopies </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-69-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-69-3" class="td10"> - <!--l. 930--><p class="noindent" >page mode setting on exiting full-screen mode</td> + <!--l. 933--><p class="noindent" >number of printed copies </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-70-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-70-1" class="td01"><span -class="ec-lmvtt-10">pdfnumcopies </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-70-2" +class="ec-lmvtt-10">pdfpagelayout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-70-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-70-3" class="td10"> - <!--l. 932--><p class="noindent" >number of printed copies </td> + <!--l. 934--><p class="noindent" >set layout of PDF pages </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-71-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-71-1" class="td01"><span -class="ec-lmvtt-10">pdfpagelayout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-71-2" +class="ec-lmvtt-10">pdfpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-71-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-71-3" class="td10"> - <!--l. 933--><p class="noindent" >set layout of PDF pages </td> + <!--l. 935--><p class="noindent" >set default mode of PDF display </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-72-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-72-1" class="td01"><span -class="ec-lmvtt-10">pdfpagemode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-72-2" +class="ec-lmvtt-10">pdfpagelabels </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-72-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-72-3" +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-72-3" class="td10"> - <!--l. 934--><p class="noindent" >set default mode of PDF display </td> + <!--l. 936--><p class="noindent" >set PDF page labels </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-73-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-73-1" class="td01"><span -class="ec-lmvtt-10">pdfpagelabels </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-73-2" +class="ec-lmvtt-10">pdfpagescrop </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-73-2" class="td11"> <span -class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-73-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-73-3" class="td10"> - <!--l. 935--><p class="noindent" >set PDF page labels </td> + <!--l. 937--><p class="noindent" >set crop size of PDF document </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-74-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-74-1" class="td01"><span -class="ec-lmvtt-10">pdfpagescrop </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-74-2" +class="ec-lmvtt-10">pdfpagetransition </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-74-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-74-3" class="td10"> - <!--l. 936--><p class="noindent" >set crop size of PDF document </td> + <!--l. 938--><p class="noindent" >set PDF page transition style </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-75-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-75-1" class="td01"><span -class="ec-lmvtt-10">pdfpagetransition </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-75-2" +class="ec-lmvtt-10">pdfpicktraybypdfsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-75-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-75-3" class="td10"> - <!--l. 937--><p class="noindent" >set PDF page transition style </td> + <!--l. 940--><p class="noindent" >set option for print dialog </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-76-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-76-1" class="td01"><span -class="ec-lmvtt-10">pdfpicktraybypdfsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-76-2" +class="ec-lmvtt-10">pdfprintarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-76-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-76-3" class="td10"> - <!--l. 939--><p class="noindent" >set option for print dialog </td> + <!--l. 941--><p class="noindent" >set /PrintArea of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-77-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-77-1" class="td01"><span -class="ec-lmvtt-10">pdfprintarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-77-2" +class="ec-lmvtt-10">pdfprintclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-77-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-77-3" class="td10"> - <!--l. 940--><p class="noindent" >set /PrintArea of viewer preferences </td> + <!--l. 942--><p class="noindent" >set /PrintClip of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-78-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-78-1" class="td01"><span -class="ec-lmvtt-10">pdfprintclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-78-2" +class="ec-lmvtt-10">pdfprintpagerange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-78-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-78-3" class="td10"> - <!--l. 941--><p class="noindent" >set /PrintClip of viewer preferences </td> - - + <!--l. 943--><p class="noindent" >set /PrintPageRange of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-79-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-79-1" class="td01"><span -class="ec-lmvtt-10">pdfprintpagerange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-79-2" +class="ec-lmvtt-10">pdfprintscaling </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-79-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-79-3" class="td10"> - <!--l. 942--><p class="noindent" >set /PrintPageRange of viewer preferences </td> + <!--l. 944--><p class="noindent" >page scaling option for print dialog </td> + + </tr><tr style="vertical-align:baseline;" id="TBL-12-80-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-80-1" class="td01"><span -class="ec-lmvtt-10">pdfprintscaling </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-80-2" +class="ec-lmvtt-10">pdfproducer </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-80-2" class="td11"> <span class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-80-3" class="td10"> - <!--l. 943--><p class="noindent" >page scaling option for print dialog </td> + <!--l. 945--><p class="noindent" >text for PDF Producer field </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-81-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-81-1" class="td01"><span -class="ec-lmvtt-10">pdfproducer </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-81-2" +class="ec-lmvtt-10">pdfremotestartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-81-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-81-3" +class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-81-3" class="td10"> - <!--l. 944--><p class="noindent" >text for PDF Producer field </td> + <!--l. 946--><p class="noindent" >starting view of remote PDF documents </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-82-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-82-1" class="td01"><span -class="ec-lmvtt-10">pdfremotestartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-82-2" +class="ec-lmvtt-10">pdfstartpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-82-2" class="td11"> <span -class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-82-3" +class="ec-lmri-10">1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-82-3" class="td10"> - <!--l. 945--><p class="noindent" >starting view of remote PDF documents </td> + <!--l. 947--><p class="noindent" >page at which PDF document opens </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-83-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-83-1" class="td01"><span -class="ec-lmvtt-10">pdfstartpage </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-83-2" +class="ec-lmvtt-10">pdfstartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-83-2" class="td11"> <span -class="ec-lmri-10">1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-83-3" +class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-83-3" class="td10"> - <!--l. 946--><p class="noindent" >page at which PDF document opens </td> + <!--l. 948--><p class="noindent" >starting view of PDF document </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-84-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-84-1" class="td01"> </td></tr> <tr style="vertical-align:baseline;" id="TBL-12-85-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-85-1" class="td01"><span -class="ec-lmvtt-10">pdfstartview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-85-2" +class="ec-lmvtt-10">pdfsubject </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-85-2" class="td11"> <span -class="ec-lmri-10">Fit </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-85-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-85-3" class="td10"> - <!--l. 947--><p class="noindent" >starting view of PDF document </td> + <!--l. 949--><p class="noindent" >text for PDF Subject field </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-86-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-86-1" class="td01"><span -class="ec-lmvtt-10">pdfsubject </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-86-2" -class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-86-3" -class="td10"> - <!--l. 948--><p class="noindent" >text for PDF Subject field </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-12-87-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-87-1" -class="td01"><span -class="ec-lmvtt-10">pdftex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-87-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-87-3" +class="ec-lmvtt-10">pdftex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-86-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-86-3" class="td10"> - <!--l. 949--><p class="noindent" >use <span + <!--l. 950--><p class="noindent" >use <span class="ec-lmss-10">pdf</span><span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span> backend </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-88-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-88-1" + style="vertical-align:baseline;" id="TBL-12-87-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-87-1" class="td01"><span -class="ec-lmvtt-10">pdftitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-88-2" +class="ec-lmvtt-10">pdftitle </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-87-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-88-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-87-3" class="td10"> - <!--l. 950--><p class="noindent" >text for PDF Title field </td> + <!--l. 951--><p class="noindent" >text for PDF Title field </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-89-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-89-1" + style="vertical-align:baseline;" id="TBL-12-88-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-88-1" class="td01"><span -class="ec-lmvtt-10">pdftoolbar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-89-2" +class="ec-lmvtt-10">pdftoolbar </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-88-2" class="td11"> <span -class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-89-3" +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-88-3" class="td10"> - <!--l. 951--><p class="noindent" >make PDF toolbar visible </td> + <!--l. 952--><p class="noindent" >make PDF toolbar visible </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-90-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-90-1" + style="vertical-align:baseline;" id="TBL-12-89-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-89-1" class="td01"><span -class="ec-lmvtt-10">pdftrapped </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-90-2" +class="ec-lmvtt-10">pdftrapped </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-89-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-90-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-89-3" class="td10"> - <!--l. 952--><p class="noindent" >Sets the document information Trapped entry. + <!--l. 953--><p class="noindent" >Sets the document information Trapped entry. Possible values are <span class="ec-lmvtt-10">True</span>, <span class="ec-lmvtt-10">False </span>and <span class="ec-lmvtt-10">Unknown</span>. An empty value means, the entry is not set. </td> </tr><tr + style="vertical-align:baseline;" id="TBL-12-90-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-90-1" +class="td01"><span +class="ec-lmvtt-10">pdfview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-90-2" +class="td11"> <span +class="ec-lmri-10">XYZ </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-90-3" +class="td10"> + <!--l. 956--><p class="noindent" >PDF ‘view’ when on link traversal </td> +</tr><tr style="vertical-align:baseline;" id="TBL-12-91-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-91-1" class="td01"><span -class="ec-lmvtt-10">pdfview </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-91-2" +class="ec-lmvtt-10">pdfviewarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-91-2" class="td11"> <span -class="ec-lmri-10">XYZ </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-91-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-91-3" class="td10"> - <!--l. 955--><p class="noindent" >PDF ‘view’ when on link traversal </td> + <!--l. 957--><p class="noindent" >set /ViewArea of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-92-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-92-1" class="td01"><span -class="ec-lmvtt-10">pdfviewarea </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-92-2" +class="ec-lmvtt-10">pdfviewclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-92-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-92-3" +class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-92-3" class="td10"> - <!--l. 956--><p class="noindent" >set /ViewArea of viewer preferences </td> + <!--l. 958--><p class="noindent" >set /ViewClip of viewer preferences </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-93-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-93-1" class="td01"><span -class="ec-lmvtt-10">pdfviewclip </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-93-2" +class="ec-lmvtt-10">pdfwindowui </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-93-2" class="td11"> <span -class="ec-lmri-10">empty </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-93-3" +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-93-3" class="td10"> - <!--l. 957--><p class="noindent" >set /ViewClip of viewer preferences </td> + <!--l. 959--><p class="noindent" >make PDF user interface elements visible </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-94-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-94-1" class="td01"><span -class="ec-lmvtt-10">pdfwindowui </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-94-2" +class="ec-lmvtt-10">plainpages </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-94-2" class="td11"> <span -class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-94-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-94-3" class="td10"> - <!--l. 958--><p class="noindent" >make PDF user interface elements visible </td> + <!--l. 960--><p class="noindent" >do page number anchors as plain Arabic </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-95-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-95-1" class="td01"><span -class="ec-lmvtt-10">plainpages </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-95-2" -class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-95-3" -class="td10"> - <!--l. 959--><p class="noindent" >do page number anchors as plain Arabic </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-12-96-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-96-1" -class="td01"><span -class="ec-lmvtt-10">ps2pdf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-96-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-96-3" +class="ec-lmvtt-10">ps2pdf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-95-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-95-3" class="td10"> - <!--l. 960--><p class="noindent" >use <span + <!--l. 961--><p class="noindent" >use <span class="ec-lmss-10">ps2pdf </span>backend </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-97-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-97-1" + style="vertical-align:baseline;" id="TBL-12-96-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-96-1" class="td01"><span -class="ec-lmvtt-10">raiselinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-97-2" +class="ec-lmvtt-10">raiselinks </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-96-2" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-97-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-96-3" class="td10"> - <!--l. 961--><p class="noindent" >raise up links (for <span + <!--l. 962--><p class="noindent" >raise up links (for <span class="ec-lmss-10">Hyper</span><span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span> backend) </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-98-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-98-1" + style="vertical-align:baseline;" id="TBL-12-97-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-97-1" class="td01"><span -class="ec-lmvtt-10">runbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-98-2" +class="ec-lmvtt-10">runbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-97-2" class="td11"> <span -class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-98-3" +class="ec-lmri-10">0 .7 .7 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-97-3" class="td10"> - <!--l. 962--><p class="noindent" >color of border around ‘run’ links </td> + <!--l. 963--><p class="noindent" >color of border around ‘run’ links </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-99-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-99-1" + style="vertical-align:baseline;" id="TBL-12-98-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-98-1" class="td01"><span -class="ec-lmvtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-99-2" +class="ec-lmvtt-10">runcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-98-2" class="td11"> <span -class="ec-lmri-10">filecolor </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-99-3" +class="ec-lmri-10">filecolor </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-98-3" class="td10"> - <!--l. 963--><p class="noindent" >color of ‘run’ links </td> + <!--l. 964--><p class="noindent" >color of ‘run’ links </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-100-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-100-1" + style="vertical-align:baseline;" id="TBL-12-99-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-99-1" class="td01"><span -class="ec-lmvtt-10">setpagesize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-100-2" +class="ec-lmvtt-10">setpagesize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-99-2" class="td11"> <span -class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-100-3" +class="ec-lmri-10">true </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-99-3" class="td10"> - <!--l. 964--><p class="noindent" >set page size by special driver commands </td> + <!--l. 965--><p class="noindent" >set page size by special driver commands </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-101-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-101-1" + style="vertical-align:baseline;" id="TBL-12-100-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-100-1" class="td01"><span -class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-101-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-101-3" +class="ec-lmvtt-10">tex4ht </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-100-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-100-3" class="td10"> - <!--l. 965--><p class="noindent" >use <span class="TEX"><span + <!--l. 966--><p class="noindent" >use <span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span><span class="ec-lmss-10">4ht </span>backend </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-102-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-102-1" + style="vertical-align:baseline;" id="TBL-12-101-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-101-1" class="td01"><span -class="ec-lmvtt-10">textures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-102-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-102-3" +class="ec-lmvtt-10">textures </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-101-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-101-3" class="td10"> - <!--l. 966--><p class="noindent" >use <span + <!--l. 967--><p class="noindent" >use <span class="ec-lmss-10">Textures </span>backend </td> </tr><tr + style="vertical-align:baseline;" id="TBL-12-102-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-102-1" +class="td01"><span +class="ec-lmvtt-10">unicode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-102-2" +class="td11"> <span +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-102-3" +class="td10"> + <!--l. 968--><p class="noindent" >Unicode encoded pdf strings </td> +</tr><tr style="vertical-align:baseline;" id="TBL-12-103-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-103-1" class="td01"><span -class="ec-lmvtt-10">unicode </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-103-2" +class="ec-lmvtt-10">urlbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-103-2" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-103-3" +class="ec-lmri-10">0 1 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-103-3" class="td10"> - <!--l. 967--><p class="noindent" >Unicode encoded pdf strings </td> + <!--l. 969--><p class="noindent" >color of border around URL links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-104-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-104-1" class="td01"><span -class="ec-lmvtt-10">urlbordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-104-2" +class="ec-lmvtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-104-2" class="td11"> <span -class="ec-lmri-10">0 1 1 </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-104-3" +class="ec-lmri-10">magenta </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-104-3" class="td10"> - <!--l. 968--><p class="noindent" >color of border around URL links </td> + <!--l. 970--><p class="noindent" >color of URL links </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-105-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-105-1" class="td01"> </td></tr> <tr style="vertical-align:baseline;" id="TBL-12-106-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-106-1" class="td01"><span -class="ec-lmvtt-10">urlcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-106-2" +class="ec-lmvtt-10">verbose </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-106-2" class="td11"> <span -class="ec-lmri-10">magenta </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-106-3" +class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-106-3" class="td10"> - <!--l. 969--><p class="noindent" >color of URL links </td> + <!--l. 971--><p class="noindent" >be chatty </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-107-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-107-1" class="td01"><span -class="ec-lmvtt-10">verbose </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-107-2" -class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:wrap; text-align:left;" id="TBL-12-107-3" +class="ec-lmvtt-10">vtex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-107-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-107-3" class="td10"> - <!--l. 970--><p class="noindent" >be chatty </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-12-108-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-108-1" -class="td01"><span -class="ec-lmvtt-10">vtex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-108-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-108-3" -class="td10"> - <!--l. 971--><p class="noindent" >use <span + <!--l. 972--><p class="noindent" >use <span class="ec-lmss-10">VTeX </span>backend </td> </tr><tr - style="vertical-align:baseline;" id="TBL-12-109-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-109-1" + style="vertical-align:baseline;" id="TBL-12-108-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-108-1" class="td01"><span -class="ec-lmvtt-10">xetex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-109-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-109-3" +class="ec-lmvtt-10">xetex </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-12-108-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-12-108-3" class="td10"> - <!--l. 972--><p class="noindent" >use <span + <!--l. 973--><p class="noindent" >use <span class="ec-lmss-10">Xe</span><span class="TEX"><span class="ec-lmss-10">T</span><span class="E"><span class="ec-lmss-10">E</span></span><span class="ec-lmss-10">X</span></span> backend </td> </tr><tr + style="vertical-align:baseline;" id="TBL-12-109-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-109-1" +class="td01"> </td> +</tr><tr style="vertical-align:baseline;" id="TBL-12-110-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-110-1" -class="td01"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-111-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-111-1" -class="td01"> </td> - - +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-112-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-112-1" -class="td01"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-12-113-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-113-1" -class="td01"> </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-12-114-"><td style="white-space:nowrap; text-align:left;" id="TBL-12-114-1" -class="td01"> </td></tr> - </table></div> -<!--l. 975--><p class="noindent" > +class="td01"> </td></tr> + </table></div> + +<!--l. 976--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">4 </span> <a id="x1-140004"></a>Additional user macros</h3> -<!--l. 977--><p class="noindent" >If you need to make references to URLs, or write explicit links, the following low-level user macros are +<!--l. 978--><p class="noindent" >If you need to make references to URLs, or write explicit links, the following low-level user macros are provided: -<!--l. 980--><p class="noindent" > +<!--l. 981--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-13" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-13-1g"><col @@ -3272,12 +3443,12 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 984--><p class="noindent" >The <span +<!--l. 985--><p class="noindent" >The <span class="ec-lmri-10">text </span>is made a hyperlink to the <span class="ec-lmri-10">URL</span>; this must be a full URL (relative to the base URL, if that is defined). The special characters # and ˜ do <span class="ec-lmri-10">not </span>need to be escaped in any way. -<!--l. 989--><p class="indent" > The optional argument <span +<!--l. 990--><p class="indent" > The optional argument <span class="ec-lmri-10">options </span>recognizes the hyperref options <span class="ec-lmvtt-10">pdfremotestartview</span>, <span class="ec-lmvtt-10">pdfnewwindow</span> @@ -3299,7 +3470,7 @@ class="description">Boolean key, if set to |true|, the URL should appen class="ec-lmvtk-10">nextactionraw</span><span class="ec-lmbx-10">:</span> </dt><dd class="description">The value of key |/Next| of action dictionaries, see PDF specification.</dd></dl> -<!--l. 1002--><p class="noindent" > +<!--l. 1003--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-14" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-14-1g"><col @@ -3310,7 +3481,7 @@ class="ec-lmvtt-10">\url</span><span class="obeylines-h"><span class="verb"><spa class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> -<!--l. 1006--><p class="noindent" >Similar to <span +<!--l. 1007--><p class="noindent" >Similar to <span class="ec-lmvtt-10">\href</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span @@ -3321,7 +3492,7 @@ class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}}</span></span></span>. Depending on the driver <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\href</span></span></span> also tries to detect the link type. Thus the result can be a url link, file link, … -<!--l. 1011--><p class="noindent" > +<!--l. 1012--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-15" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-15-1g"><col @@ -3332,10 +3503,10 @@ class="ec-lmvtt-10">\nolinkurl</span><span class="obeylines-h"><span class="verb class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> -<!--l. 1015--><p class="noindent" >Write <span +<!--l. 1016--><p class="noindent" >Write <span class="ec-lmri-10">URL </span>in the same way as <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\url</span></span></span>, without creating a hyperlink. -<!--l. 1018--><p class="noindent" > +<!--l. 1019--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-16" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-16-1g"><col @@ -3347,10 +3518,10 @@ class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">URL</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1022--><p class="noindent" >A base <span +<!--l. 1023--><p class="noindent" >A base <span class="ec-lmri-10">URL </span>is established, which is prepended to other specified URLs, to make it easier to write portable documents. -<!--l. 1025--><p class="noindent" > +<!--l. 1026--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-17" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-17-1g"><col @@ -3364,14 +3535,14 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1029--><p class="noindent" >The link to the image referenced by the URL is inserted, using <span +<!--l. 1030--><p class="noindent" >The link to the image referenced by the URL is inserted, using <span class="ec-lmri-10">text </span>as the anchor. - - -<!--l. 1032--><p class="indent" > For drivers that produce HTML, the image itself is inserted by the browser, with the <span +<!--l. 1033--><p class="indent" > For drivers that produce HTML, the image itself is inserted by the browser, with the <span class="ec-lmri-10">text </span>being ignored completely. -<!--l. 1035--><p class="noindent" > + + +<!--l. 1036--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-18" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-18-1g"><col @@ -3387,10 +3558,10 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1039--><p class="noindent" >A target area of the document (the <span +<!--l. 1040--><p class="noindent" >A target area of the document (the <span class="ec-lmri-10">text</span>) is marked, and given the name <span class="ec-lmri-10">category.name</span> -<!--l. 1042--><p class="noindent" > +<!--l. 1043--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-19" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-19-1g"><col @@ -3408,10 +3579,10 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1046--><p class="noindent" ><span +<!--l. 1047--><p class="noindent" ><span class="ec-lmri-10">text </span>is made into a link to <span class="ec-lmri-10">URL#category.name</span> -<!--l. 1048--><p class="noindent" > +<!--l. 1049--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-20" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-20-1g"><col @@ -3425,12 +3596,12 @@ class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1052--><p class="noindent" ><span +<!--l. 1053--><p class="noindent" ><span class="ec-lmri-10">text </span>is made into a link to the same place as <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\ref{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> would be linked. -<!--l. 1056--><p class="noindent" > +<!--l. 1057--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-21" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-21-1g"><col @@ -3444,7 +3615,7 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1059--><p class="noindent" > +<!--l. 1060--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-22" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-22-1g"><col @@ -3458,7 +3629,7 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1063--><p class="noindent" >A simple internal link is created with <span class="obeylines-h"><span class="verb"><span +<!--l. 1064--><p class="noindent" >A simple internal link is created with <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypertarget</span></span></span>, with two parameters of an anchor <span class="ec-lmri-10">name</span>, and anchor <span @@ -3467,11 +3638,11 @@ class="ec-lmvtt-10">\hyperlink</span></span></span> has two arguments, the name class="ec-lmvtt-10">\hypertarget</span></span></span>, and the <span class="ec-lmri-10">text </span>which be used as the link on the page. -<!--l. 1069--><p class="indent" > Note that in HTML parlance, the <span class="obeylines-h"><span class="verb"><span +<!--l. 1070--><p class="indent" > Note that in HTML parlance, the <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyperlink</span></span></span> command inserts a notional # in front of each link, making it relative to the current testdocument; <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\href</span></span></span> expects a full URL. -<!--l. 1073--><p class="noindent" > +<!--l. 1074--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-23" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-23-1g"><col @@ -3480,7 +3651,7 @@ id="TBL-23-1"></colgroup><tr class="td11"> <span class="ec-lmvtt-10">\phantomsection </span></td> </tr></table> </div></span> -<!--l. 1077--><p class="noindent" >This sets an anchor at this location. It works similar to <span class="obeylines-h"><span class="verb"><span +<!--l. 1078--><p class="noindent" >This sets an anchor at this location. It works similar to <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypertarget{}{}</span></span></span> with an automatically chosen anchor name. Often it is used in conjunction with <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\addcontentsline</span></span></span> for sectionlike things (index, @@ -3496,10 +3667,10 @@ Example:  <br />\addcontentsline{toc}{chapter}{\indexname}  <br />\printindex </div> - <!--l. 1090--><p class="nopar" ></div> -<!--l. 1092--><p class="noindent" >Now the entry in the table of contents (and bookmarks) for the index points to the start of the index page, + <!--l. 1091--><p class="nopar" ></div> +<!--l. 1093--><p class="noindent" >Now the entry in the table of contents (and bookmarks) for the index points to the start of the index page, not to a location before this page. -<!--l. 1096--><p class="noindent" > +<!--l. 1097--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-24" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-24-1g"><col @@ -3510,11 +3681,11 @@ class="ec-lmvtt-10">\autoref</span><span class="obeylines-h"><span class="verb"> class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> -<!--l. 1100--><p class="noindent" >This is a replacement for the usual <span class="obeylines-h"><span class="verb"><span +<!--l. 1101--><p class="noindent" >This is a replacement for the usual <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\ref</span></span></span> command that places a contextual label in front of the reference. This gives your users a bigger target to click for hyperlinks (e.g. ‘section 2’ instead of merely the number ‘2’). -<!--l. 1106--><p class="indent" > The label is worked out from the context of the original <span class="obeylines-h"><span class="verb"><span +<!--l. 1107--><p class="indent" > The label is worked out from the context of the original <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\label</span></span></span> command by <span class="ec-lmss-10">hyperref </span>by using the macros listed below (shown with their default values). The macros can be (re)defined in documents using @@ -3522,136 +3693,136 @@ macros listed below (shown with their default values). The macros can be (re)def class="ec-lmvtt-10">\(re)newcommand</span></span></span>; note that some of these macros are already defined in the standard document classes. The mixture of lowercase and uppercase initial letters is deliberate and corresponds to the author’s practice. -<!--l. 1114--><p class="indent" > For each macro below, <span +<!--l. 1115--><p class="indent" > For each macro below, <span class="ec-lmss-10">hyperref </span>checks <span class="ec-lmvtt-10">\*autorefname </span>before <span class="ec-lmvtt-10">\*name</span>. For instance, it looks for <span class="ec-lmvtt-10">\figureautorefname </span>before <span class="ec-lmvtt-10">\figurename</span>. -<!--l. 1118--><p class="noindent" > <a - id="x1-14001r12"></a> <!--l. 1119--><div class="longtable"> <table id="TBL-25" class="longtable" + id="x1-14001r12"></a> <!--l. 1120--><div class="longtable"> <table id="TBL-25" class="longtable" cellspacing="0" cellpadding="0" ><colgroup id="TBL-25-1g"><col id="TBL-25-1"><col id="TBL-25-2"></colgroup> <tr style="vertical-align:baseline;" id="TBL-25-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-1-1" -class="td11"> <span +class="td01"><span class="ec-lmri-10">Macro </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-1-2" -class="td11"> - <!--l. 1119--><p class="noindent" ><span -class="ec-lmri-10">Default</span> </td> +class="td10"> + <!--l. 1120--><p class="noindent" ><span +class="ec-lmri-10">Default</span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-2-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\figurename </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-2-2" -class="td11"> - <!--l. 1120--><p class="noindent" >Figure </td> +class="td10"> + <!--l. 1121--><p class="noindent" >Figure </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-3-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\tablename </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-3-2" -class="td11"> - <!--l. 1121--><p class="noindent" >Table </td> +class="td10"> + <!--l. 1122--><p class="noindent" >Table </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-4-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\partname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-4-2" -class="td11"> - <!--l. 1122--><p class="noindent" >Part </td> +class="td10"> + <!--l. 1123--><p class="noindent" >Part </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-5-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\appendixname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-5-2" -class="td11"> - <!--l. 1123--><p class="noindent" >Appendix </td> +class="td10"> + <!--l. 1124--><p class="noindent" >Appendix </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-6-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\equationname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-6-2" -class="td11"> - <!--l. 1124--><p class="noindent" >Equation </td> +class="td10"> + <!--l. 1125--><p class="noindent" >Equation </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-7-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\Itemname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-7-2" -class="td11"> - <!--l. 1125--><p class="noindent" >item </td> +class="td10"> + <!--l. 1126--><p class="noindent" >item </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-8-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\chaptername </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-8-2" -class="td11"> - <!--l. 1126--><p class="noindent" >chapter </td> +class="td10"> + <!--l. 1127--><p class="noindent" >chapter </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-9-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\sectionname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-9-2" -class="td11"> - <!--l. 1127--><p class="noindent" >section </td> +class="td10"> + <!--l. 1128--><p class="noindent" >section </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-10-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\subsectionname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-10-2" -class="td11"> - <!--l. 1128--><p class="noindent" >subsection </td> +class="td10"> + <!--l. 1129--><p class="noindent" >subsection </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-11-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\subsubsectionname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-11-2" -class="td11"> - <!--l. 1129--><p class="noindent" >subsubsection </td> +class="td10"> + <!--l. 1130--><p class="noindent" >subsubsection </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-12-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\paragraphname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-12-2" -class="td11"> - <!--l. 1130--><p class="noindent" >paragraph </td> +class="td10"> + <!--l. 1131--><p class="noindent" >paragraph </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-13-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\Hfootnotename </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-13-2" -class="td11"> - <!--l. 1131--><p class="noindent" >footnote </td> +class="td10"> + <!--l. 1132--><p class="noindent" >footnote </td> + </tr><tr style="vertical-align:baseline;" id="TBL-25-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-14-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\AMSname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-14-2" -class="td11"> - <!--l. 1132--><p class="noindent" >Equation </td> +class="td10"> + <!--l. 1133--><p class="noindent" >Equation </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-15-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\theoremname </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-15-2" -class="td11"> - <!--l. 1133--><p class="noindent" >Theorem </td> +class="td10"> + <!--l. 1134--><p class="noindent" >Theorem </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-16-1" -class="td11"> <span +class="td01"><span class="ec-lmvtt-10">\page </span></td><td style="white-space:wrap; text-align:left;" id="TBL-25-16-2" -class="td11"> - <!--l. 1134--><p class="noindent" >page </td> +class="td10"> + <!--l. 1135--><p class="noindent" >page </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-17-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-18-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-19-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-20-1" -class="td11"> </td> +class="td01"> </td> </tr><tr style="vertical-align:baseline;" id="TBL-25-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-25-21-1" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-25-21-2" -class="td11"></td></tr> +class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-25-21-2" +class="td10"></td></tr> </table></div> -<!--l. 1137--><p class="indent" > Example for a redefinition if <span +<!--l. 1138--><p class="indent" > Example for a redefinition if <span class="ec-lmss-10">babel </span>is used: <div class="quote"> @@ -3662,8 +3833,8 @@ class="ec-lmss-10">babel </span>is used:  <br />  \def\subsectionautorefname{Unterkapitel}%  <br />} </div> - <!--l. 1144--><p class="nopar" ></div> -<!--l. 1147--><p class="indent" > Hint: <span + <!--l. 1145--><p class="nopar" ></div> +<!--l. 1148--><p class="indent" > Hint: <span class="ec-lmvtt-10">\autoref </span>works via the counter name that the reference is based on. Sometimes <span class="ec-lmvtt-10">\autoref</span> chooses the wrong name, if the counter is used for different things. For example, it happens with @@ -3703,8 +3874,8 @@ lemmas:  <br />  <br />\end{document} </div> - <!--l. 1182--><p class="nopar" ></div> -<!--l. 1185--><p class="noindent" > + <!--l. 1183--><p class="nopar" ></div> +<!--l. 1186--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-26" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-26-1g"><col @@ -3716,14 +3887,14 @@ class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1189--><p class="noindent" >It replaces <span class="obeylines-h"><span class="verb"><span +<!--l. 1190--><p class="noindent" >It replaces <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\pageref</span></span></span> and adds the name for page in front of the page reference. First <span class="ec-lmvtt-10">\pageautorefname</span> is checked before <span class="ec-lmvtt-10">\pagename</span>. -<!--l. 1194--><p class="indent" > For instances where you want a reference to use the correct counter, but not to create a link, there +<!--l. 1195--><p class="indent" > For instances where you want a reference to use the correct counter, but not to create a link, there are starred forms: -<!--l. 1197--><p class="noindent" > +<!--l. 1198--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-27" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-27-1g"><col @@ -3734,7 +3905,7 @@ class="ec-lmvtt-10">\ref*</span><span class="obeylines-h"><span class="verb"><sp class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> -<!--l. 1201--><p class="noindent" > +<!--l. 1202--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-28" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-28-1g"><col @@ -3746,7 +3917,7 @@ class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1205--><p class="noindent" > +<!--l. 1206--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-29" class="tabular" @@ -3759,7 +3930,7 @@ class="ec-lmvtt-10">\autoref*</span><span class="obeylines-h"><span class="verb" class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> -<!--l. 1209--><p class="noindent" > +<!--l. 1210--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-30" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-30-1g"><col @@ -3771,18 +3942,18 @@ class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1213--><p class="indent" > A typical use would be to write +<!--l. 1214--><p class="indent" > A typical use would be to write <div class="verbatim" id="verbatim-17"> \hyperref[other]{that nice section (\ref*{other}) we read before} </div> -<!--l. 1216--><p class="nopar" > -<!--l. 1218--><p class="indent" > We want <span class="obeylines-h"><span class="verb"><span +<!--l. 1217--><p class="nopar" > +<!--l. 1219--><p class="indent" > We want <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\ref*{other}</span></span></span> to generate the correct number, but not to form a link, since we do this ourselves with <span class="ec-lmvtt-10">\hyperref</span>. -<!--l. 1221--><p class="noindent" > +<!--l. 1222--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-31" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-31-1g"><col @@ -3800,7 +3971,7 @@ class="ec-lmri-10">X</span></span><span class="ec-lmri-10">string</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1225--><p class="indent" > <span +<!--l. 1226--><p class="indent" > <span class="ec-lmvtt-10">\pdfstringdef </span>returns a macro containing the PDF string. (Currently this is done globally, but do not rely on it.) All the following tasks, definitions and redefinitions are made in a group to keep them local: @@ -3844,29 +4015,46 @@ class="ec-lmvtt-10">\textbf</span></span></span>, etc. <li class="itemize">Support for <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\xspace</span></span></span> provided by the <span class="ec-lmss-10">xspace </span>package</li></ul> -<!--l. 1241--><p class="indent" > In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in +<!--l. 1242--><p class="indent" > In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in the PDF string. For further details, see Heiko Oberdiek’s Euro<span class="TEX">T<span class="E">E</span>X</span> paper distributed with <span class="ec-lmss-10">hyperref</span>. -<!--l. 1245--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a - id="x1-150004.1"></a>Bookmark macros</h4> +<!--l. 1246--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-32" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-32-1g"><col +id="TBL-32-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-32-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-32-1-1" +class="td11"> <span +class="ec-lmvtt-10">\begin</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{NoHyper}</span></span></span>…<span +class="ec-lmvtt-10">\end</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{NoHyper}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 1249--><p class="indent" > Sometimes we just don’t want the wretched package interfering with us. Define an environment we +can put in manually, or include in a style file, which stops the hypertext functions doing anything. +This is used, for instance, in the Elsevier classes, to stop <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">hyperref</span></span></span> playing havoc in the front +matter. -<!--l. 1247--><p class="noindent" > +<!--l. 1255--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-150004.1"></a>Bookmark macros</h4> +<!--l. 1257--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">4.1.1 </span> <a id="x1-160004.1.1"></a>Setting bookmarks</h5> -<!--l. 1249--><p class="noindent" >Usually <span +<!--l. 1259--><p class="noindent" >Usually <span class="ec-lmss-10">hyperref </span>automatically adds bookmarks for <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\section</span></span></span> and similar macros. But they can also set manually. -<!--l. 1252--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-32" class="tabular" +<!--l. 1262--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-33" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-32-1g"><col -id="TBL-32-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-32-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-32-1-1" +><colgroup id="TBL-33-1g"><col +id="TBL-33-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-33-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-33-1-1" class="td11"> <span class="ec-lmvtt-10">\pdfbookmark</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">[</span></span></span><span @@ -3876,16 +4064,16 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1255--><p class="indent" > creates a bookmark with the specified text and at the given level (default is 0). As name for the +<!--l. 1265--><p class="indent" > creates a bookmark with the specified text and at the given level (default is 0). As name for the internal anchor name is used (in conjunction with level). Therefore the name must be unique (similar to <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\label</span></span></span>). -<!--l. 1259--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-33" class="tabular" +<!--l. 1269--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-34" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-33-1g"><col -id="TBL-33-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-33-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-33-1-1" +><colgroup id="TBL-34-1g"><col +id="TBL-34-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-34-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-34-1-1" class="td11"> <span class="ec-lmvtt-10">\currentpdfbookmark</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span @@ -3894,13 +4082,13 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1262--><p class="indent" > creates a bookmark at the current level. -<!--l. 1264--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-34" class="tabular" +<!--l. 1272--><p class="indent" > creates a bookmark at the current level. +<!--l. 1274--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-35" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-34-1g"><col -id="TBL-34-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-34-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-34-1-1" +><colgroup id="TBL-35-1g"><col +id="TBL-35-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-35-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-35-1-1" class="td11"> <span class="ec-lmvtt-10">\subpdfbookmark</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span @@ -3909,14 +4097,14 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1267--><p class="indent" > creates a bookmark one step down in the bookmark hierarchy. Internally the current level is increased +<!--l. 1277--><p class="indent" > creates a bookmark one step down in the bookmark hierarchy. Internally the current level is increased by one. -<!--l. 1270--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-35" class="tabular" +<!--l. 1280--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-36" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-35-1g"><col -id="TBL-35-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-35-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-35-1-1" +><colgroup id="TBL-36-1g"><col +id="TBL-36-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-36-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-36-1-1" class="td11"> <span class="ec-lmvtt-10">\belowpdfbookmark</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span @@ -3925,9 +4113,9 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">name</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1273--><p class="indent" > creates a bookmark below the current bookmark level. However after the command the current +<!--l. 1283--><p class="indent" > creates a bookmark below the current bookmark level. However after the command the current bookmark level has not changed. -<!--l. 1276--><p class="noindent" ><span +<!--l. 1286--><p class="noindent" ><span class="ec-lmbx-10">Hint: </span>Package <span class="ec-lmss-10">bookmark </span>replaces <span class="ec-lmss-10">hyperref</span>’s bookmark organization by a new algorithm: @@ -3938,21 +4126,23 @@ class="E">E</span>X</span></span> run is needed. <li class="itemize">More control over the bookmark appearance (color, font). </li> <li class="itemize">Different bookmark actions are supported (external file links, URLs, …).</li></ul> -<!--l. 1284--><p class="noindent" >Therefore I recommend using this package. -<!--l. 1286--><p class="noindent" > +<!--l. 1294--><p class="noindent" >Therefore I recommend using this package. +<!--l. 1296--><p class="noindent" > <h5 class="subsubsectionHead"><span class="titlemark">4.1.2 </span> <a id="x1-170004.1.2"></a>Replacement macros</h5> -<!--l. 1288--><p class="noindent" ><span +<!--l. 1298--><p class="noindent" ><span class="ec-lmss-10">hyperref </span>takes the text for bookmarks from the arguments of commands like <span class="ec-lmvtt-10">\section</span>, which can contain things like math, colors, or font changes, none of which will display in bookmarks as is. -<!--l. 1292--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-36" class="tabular" + + +<!--l. 1302--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-37" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-36-1g"><col -id="TBL-36-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-36-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-36-1-1" +><colgroup id="TBL-37-1g"><col +id="TBL-37-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-37-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-37-1-1" class="td11"> <span class="ec-lmvtt-10">\texorpdfstring</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="TEX"><span @@ -3965,7 +4155,8 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">PDFstring</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1296--><p class="indent" > For example, +<!--l. 1306--><p class="indent" > For example, + <div class="verbatim" id="verbatim-18"> \section{Pythagoras: @@ -3976,8 +4167,8 @@ class="ec-lmvtt-10">}</span></span></span> </td>  <br />}  <br />\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars} </div> -<!--l. 1305--><p class="nopar" > -<!--l. 1307--><p class="indent" > <span +<!--l. 1315--><p class="nopar" > +<!--l. 1317--><p class="indent" > <span class="ec-lmvtt-10">\pdfstringdef </span>executes the hook before it expands the string. Therefore, you can use this hook to perform additional tasks or to disable additional commands. @@ -3989,8 +4180,8 @@ perform additional tasks or to disable additional commands.  <br />  \renewcommand{\mycommand}[1]{}%  <br />} </div> -<!--l. 1317--><p class="nopar" > -<!--l. 1319--><p class="indent" > However, for disabling commands, an easier way is via <span +<!--l. 1327--><p class="nopar" > +<!--l. 1329--><p class="indent" > However, for disabling commands, an easier way is via <span class="ec-lmvtt-10">\pdfstringdefDisableCommands</span>, which adds its argument to the definition of <span class="ec-lmvtt-10">\pdfstringdefPreHook </span>(‘@’ can here be used as letter in command @@ -4004,23 +4195,23 @@ names):  <br />  \let\textcolor\@gobble  <br />} </div> -<!--l. 1330--><p class="nopar" > -<!--l. 1332--><p class="noindent" > +<!--l. 1340--><p class="nopar" > +<!--l. 1342--><p class="noindent" > <h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a id="x1-180004.2"></a>Utility macros</h4> -<!--l. 1335--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-37" class="tabular" +<!--l. 1345--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-38" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-37-1g"><col -id="TBL-37-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-37-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-37-1-1" +><colgroup id="TBL-38-1g"><col +id="TBL-38-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-38-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-38-1-1" class="td11"> <span class="ec-lmvtt-10">\hypercalcbp</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">dimen specification</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1338--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +<!--l. 1348--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hypercalcbp</span></span></span> takes a <span class="TEX">T<span class="E">E</span>X</span> dimen specification and converts it to bp and returns the number without the unit. This is useful for options <span class="obeylines-h"><span class="verb"><span @@ -4037,33 +4228,781 @@ Example:  <br />    -\headheight-\headsep}  <br />} </div> - <!--l. 1350--><p class="nopar" ></div> -<!--l. 1352--><p class="noindent" >The origin of the PDF coordinate system is the lower left corner. -<!--l. 1354--><p class="indent" > Note, for calculations you need either package <span + <!--l. 1360--><p class="nopar" ></div> +<!--l. 1362--><p class="noindent" >The origin of the PDF coordinate system is the lower left corner. +<!--l. 1364--><p class="indent" > Note, for calculations you need either package <span class="ec-lmss-10">calc </span>or <span class="lmmi-10">ε</span>-<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span>. Nowadays the latter should automatically be enabled for <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> formats. Users without <span class="lmmi-10">ε</span>-<span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span>, please, look in the source documentation <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">hyperref.dtx</span></span></span> for further limitations. -<!--l. 1360--><p class="indent" > Also <span +<!--l. 1370--><p class="indent" > Also <span class="ec-lmvtt-10">\hypercalcbp </span>cannot be used in option specifications of <span class="ec-lmvtt-10">\documentclass </span>and <span class="ec-lmvtt-10">\usepackage</span>, because <span class="HoLogo-LaTeX">L<span class="HoLogo-a">A</span><span class="HoLogo-TeX">T<span class="HoLogo-e">E</span>X</span></span> expands the option lists of these commands. However package <span class="ec-lmss-10">hyperref </span>is not yet loaded and an undefined control sequence error would arise. -<!--l. 1366--><p class="noindent" > +<!--l. 1377--><p class="noindent" > <h3 class="sectionHead"><span class="titlemark">5 </span> <a - id="x1-190005"></a>Acrobat-specific behavior</h3> -<!--l. 1367--><p class="noindent" >If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided + id="x1-190005"></a>New Features<span class="footnote-mark"><a +href="manual4.html#fn3x0"><sup class="textsuperscript">3</sup></a></span><a + id="x1-19001f3"></a> </h3> + <h4 class="subsectionHead"><span class="titlemark">5.1 </span> <a + id="x1-200005.1"></a>Option ‘pdflinkmargin’</h4> +<!--l. 1382--><p class="noindent" >Option ‘pdflinkmargin’ is an experimental option for specifying a link margin, if the driver supports this. +Default is 1 pt for supporting drivers. +<!--l. 1387--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">pdfTeX</span> </dt><dd +class="description"> + <ul class="itemize1"> + <li class="itemize">The link area also depends on the surrounding box. + </li> + <li class="itemize">Settings have local effect. + </li> + <li class="itemize">When a page is shipped out, pdfTeX uses the current setting of the link margin for all + links on the page.</li></ul> + </dd><dt class="description"> +<span +class="ec-lmbx-10">pdfmark</span> </dt><dd +class="description"> + <ul class="itemize1"> + <li class="itemize">Settings have global effect.</li></ul> + </dd><dt class="description"> +<span +class="ec-lmbx-10">Other drivers</span> </dt><dd +class="description">Unsupported.</dd></dl> + + +<!--l. 1406--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.2 </span> <a + id="x1-210005.2"></a>Field option ‘calculatesortkey’</h4> +<!--l. 1408--><p class="noindent" >Fields with calculated values are calculated in document order by default. If calculated field values +depend on other calculated fields that appear later in the document, then the correct calculation order +can be specified with option ‘calculatesortkey’. Its value is used as key to lexicographically sort the +calculated fields. The sort key do not need to be unique. Fields that share the same key are sorted in +document order. +<!--l. 1418--><p class="indent" > Currently the field option ‘calculatesortkey’ is only supported by the driver for pdfTeX. +<!--l. 1422--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.3 </span> <a + id="x1-220005.3"></a>Option ‘localanchorname’</h4> +<!--l. 1424--><p class="noindent" >When an anchor is set (e.g. via <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\refstepcounter</span></span></span>, then the anchor name is globally set to the current +anchor name. +<!--l. 1428--><p class="indent" > For example: + + + <div class="verbatim" id="verbatim-22"> +    \section{Foobar} + <br />    \begin{equation}\end{equation} + <br />    \label{sec:foobar} +</div> +<!--l. 1433--><p class="nopar" > With the default global setting (localanchorname=false) a reference to ‘sec:foobar’ jumps to the +equation before. With option ‘localanchorname’ the anchor of the equation is forgotten after the +environment and the reference ‘sec:foobar’ jumps to the section title. +<!--l. 1441--><p class="indent" > Option ‘localanchorname’ is an experimental option, there might be situations, where the anchor +name is not available as expected. +<!--l. 1446--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.4 </span> <a + id="x1-230005.4"></a>Option ‘customdriver’</h4> +<!--l. 1448--><p class="noindent" >The value of option ‘customdriver’ is the name of an external driver file without extension ‘.def’. The file +must have <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ProvidesFile</span></span></span> with a version date and number that match the date and number of ‘hyperref’, +otherwise a warning is given. +<!--l. 1453--><p class="indent" > Because the interface, what needs to be defined in the driver, is not well defined and +quite messy, the option is mainly intended to ease developing, testing, debugging the driver +part. +<!--l. 1458--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.5 </span> <a + id="x1-240005.5"></a>Option ‘psdextra’</h4> +<!--l. 1460--><p class="noindent" >LaTeX’s NFSS is used to assist the conversion of arbitrary TeX strings to PDF strings (bookmarks, PDF +information entries). Many math command names (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\geq</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\notin</span></span></span>, ...) are not in control of NFSS, +therefore they are defined with prefix ‘text’ (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textgeq</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textnotin</span></span></span>, ...). They can be mapped to short +names during the processing to PDF strings. The disadvantage is that they are many hundreds macros +that need to be redefined for each PDF string conversion. Therefore this can be enabled or disabled +as option ‘psdextra’. On default the option is turned off (set to ‘false’). Turning the option +on means that the short names are available. Then <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\geq</span></span></span> can directly be used instead of +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textgeq</span></span></span>. +<!--l. 1474--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.6 </span> <a + id="x1-250005.6"></a>\XeTeXLinkBox</h4> +<!--l. 1476--><p class="noindent" >When XeTeX generates a link annotation, it does not look at the boxes (as the other drivers), but only +at the character glyphs. If there are no glyphs (images, rules, ...), then it does not generate a link +annotation. Macro <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\XeTeXLinkBox</span></span></span> puts its argument in a box and adds spaces at the lower left and +upper right corners. An additional margin can be specified by setting it to the dimen register +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\XeTeXLinkMargin</span></span></span>. The default is 2pt. +<!--l. 1485--><p class="indent" > Example: + + + <div class="verbatim" id="verbatim-23"> +    % xelatex + <br />    \documentclass{article} + <br />    \usepackage{hyperref} + <br />    \setlength{\XeTeXLinkMargin}{1pt} + <br />    \begin{document} + <br />    \section{Hello World} + <br />    \newpage + <br />    \label{sec:hello} + <br />    \hyperref[sec:hello]{% + <br />      \XeTeXLinkBox{\rule{10mm}{10mm}}% + <br />    } + <br />    \end{document} +</div> +<!--l. 1501--><p class="nopar" > +<!--l. 1503--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.7 </span> <a + id="x1-260005.7"></a>\IfHyperBooleanExists and \IfHyperBoolean</h4> + + + <div class="verbatim" id="verbatim-24"> + \IfHyperBooleanExists{OPTION}{YES}{NO} +</div> +<!--l. 1506--><p class="nopar" > If a hyperref OPTION is a boolean, that means it takes values ‘true’ or ‘false’, then <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\IfHyperBooleanExists</span></span></span> +calls YES, otherwise NO. + + + <div class="verbatim" id="verbatim-25"> + \IfHyperBoolean{OPTION}{YES}{NO} +</div> +<!--l. 1513--><p class="nopar" > Macro <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\IfHyperBoolean</span></span></span> calls YES, if OPTION exists as boolean and is enabled. Otherwise NO is +executed. +<!--l. 1519--><p class="indent" > Both macros are expandable. Additionally option ‘stoppedearly’ is available. It is enabled if +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\MaybeStopEarly</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\MaybeStopNow</span></span></span> end hyperref prematurely. +<!--l. 1524--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.8 </span> <a + id="x1-270005.8"></a>\unichar</h4> +<!--l. 1526--><p class="noindent" >If a Unicode character is not supported by puenc.def, it can be given by using <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\unichar</span></span></span>. Its name +and syntax is inherited from package ‘ucs’. However it is defined independently for use in +hyperref’s <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfstringdef</span></span></span> (that converts arbitrary TeX code to PDF strings or tries to do +this). +<!--l. 1534--><p class="indent" > Macro <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\unichar</span></span></span> takes a TeX number as argument, examples for U+263A (WHITE SMILING +FACE): + + + <div class="verbatim" id="verbatim-26"> +    \unichar{"263A}% hexadecimal notation + <br />    \unichar{9786}% decimal notation +</div> +<!--l. 1539--><p class="nopar" > ‘"’ must not be a babel shorthand character or otherwise active. Otherwise prefix it with +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\string</span></span></span>: + + + <div class="verbatim" id="verbatim-27"> +    \unichar{\string"263A}% converts ‘"’ to ‘"’ with catcode 12 (other) +</div> +<!--l. 1544--><p class="nopar" > Users of (n)german packages or babel options may use <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\dq</span></span></span> instead: + + + <div class="verbatim" id="verbatim-28"> +    \unichar{\dq 263A}% \dq is double quote with catcode 12 (other) +</div> +<!--l. 1548--><p class="nopar" > +<!--l. 1551--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.9 </span> <a + id="x1-280005.9"></a>\ifpdfstringunicode</h4> +<!--l. 1553--><p class="noindent" >Some features of the PDF specification needs PDF strings. Examples are bookmarks or the entries in the +information dictionary. The PDF specification allows two encodings ‘PDFDocEncoding’ (8-bit encoding) +and ‘Unicode’ (UTF-16). The user can help using <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring</span></span></span> to replace complicate TeX constructs +by a representation for the PDF string. However <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring</span></span></span> does not distinguish the two encodings. +This gap closes <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ifpdfstringunicode</span></span></span>. It is only allowed in the second argument of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring</span></span></span> and +takes two arguments, the first allows the full range of Unicode. The second is limited to the characters +available in PDFDocEncoding. +<!--l. 1567--><p class="indent" > As example we take a macro definition for the Vietnamese name of Han The Thanh. Correctly +written it needs some accented characters, one character even with a double accent. Class ‘tugboat.cls’ +defines a macro for the typesetted name: + + + <div class="verbatim" id="verbatim-29"> +    \def\Thanh{% + <br />      H\‘an~% + <br />      Th\^e\llap{\raise 0.5ex\hbox{\’{}}}% + <br />      ~Th\‘anh% + <br />    } +</div> +<!--l. 1577--><p class="nopar" > It’s not entirely correct, the second accent over the ‘e’ is not an acute, but a hook. However standard +LaTeX does not provide such an accent. +<!--l. 1582--><p class="indent" > Now we can extend the defintion to support hyperref. The first and the last word are already +supported automatically. Characters with two or more accents are a difficult business in LaTeX, because +the NFSS2 macros of the LaTeX kernel do not support more than one accent. Therefore also puenc.def +misses support for them. But we can provide it using <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\unichar</span></span></span>. The character in question +is: + + + <div class="verbatim" id="verbatim-30"> +    % U+1EC3 LATIN SMALL LETTER E WITH CIRCUMFLEX AND HOOK ABOVE +</div> +<!--l. 1591--><p class="nopar" > Thus we can put this together: + + + <div class="verbatim" id="verbatim-31"> +    \def\Thanh{% + <br />      H\‘an~% + <br />      \texorpdfstring{Th\^e\llap{\raise 0.5ex\hbox{\’{}}}}% + <br />      {\ifpdfstringunicode{Th\unichar{"1EC3}}{Th\^e}}% + <br />      ~Th\‘anh% + <br />    } +</div> +<!--l. 1600--><p class="nopar" > For PDFDocEncoding (PD1) the variant above has dropped the second accent. Alternatively we could +provide a representation without accents instead of wrong accents: + + + <div class="verbatim" id="verbatim-32"> +    \def\Thanh{% + <br />      \texorpdfstring{% + <br />        H\‘an~% + <br />        Th\^e\llap{\raise 0.5ex\hbox{\’{}}}}% + <br />        ~Th\‘anh% + <br />      }{% + <br />        \ifpdfstringunicode{% + <br />          H\‘an Th\unichar{"1EC3} Th\‘anh% + <br />        }{% + <br />          Han The Thanh% + <br />        }% + <br />      }% + <br />    } +</div> +<!--l. 1618--><p class="nopar" > +<!--l. 1620--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.10 </span> <a + id="x1-290005.10"></a>Customizing index style file with \nohyperpage</h4> +<!--l. 1622--><p class="noindent" >Since version 2008/08/14 v6.78f. +<!--l. 1626--><p class="indent" > For hyperlink support in the index, hyperref inserts <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> into the index macros. After +processing with Makeindex, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> analyzes its argument to detect page ranges and page comma +lists. However, only the standard settings are supported directly: + + + <div class="verbatim" id="verbatim-33"> +    delim_r "--" + <br />    delim_n ", " +</div> +<!--l. 1633--><p class="nopar" > (See manual page/documentation of Makeindex that explains the keys that can be used in style files for +Makeindex.) Customized versions of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">delim_r,</span><span +class="ec-lmvtt-10"> delim_n,</span><span +class="ec-lmvtt-10"> suffix_2p,</span><span +class="ec-lmvtt-10"> suffix_3p,</span><span +class="ec-lmvtt-10"> suffix_mp</span></span></span> needs +markup that <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> can detect and knows that this stuff does not belong to a page number. Makro +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\nohyperpage</span></span></span> serves as this markup. Put the customized code for these keys inside <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\nohyperpage</span></span></span>, +e.g.: + + + <div class="verbatim" id="verbatim-34"> +    suffix_2p "\\nohyperpage{f.}" + <br />    suffix_3p "\\nohyperpage{ff.}" +</div> +<!--l. 1645--><p class="nopar" > (Depending on the typesetting tradition some space "<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\\</span></span></span>," or "<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">~</span></span></span>" should be put before the first f inside +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\nohyperpage</span></span></span>.) +<!--l. 1650--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.11 </span> <a + id="x1-300005.11"></a>Experimental option ‘ocgcolorlinks’</h4> +<!--l. 1652--><p class="noindent" >The idea are colored links, when viewed, but printed without colors. This new experimental option +‘ocgcolorlinks’ uses Optional Content Groups, a feature introduced in PDF 1.5. + <ul class="itemize1"> + <li class="itemize">The option must be given for package loading: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\usepackage[ocgcolorlinks]{hyperref}</span></span></span> + </li> + <li class="itemize">Main disadvantage: Links cannot be broken across lines. PDF reference 1.7: 4.10.2 "Making + Graphical Content Optional": Graphics state operations, such as setting the color, ..., are + still applied. Therefore the link text is put in a box and set twice, with and without color. + </li> + <li class="itemize">The feature can be switched of by <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypersetup{ocgcolorlinks=false}</span></span></span> inside the document. + </li> + <li class="itemize">Supported drivers: pdftex, dvipdfm + </li> + <li class="itemize">The PDF version should be at least 1.5. It is automatically set for pdfTeX. Users of dvipdfmx + set the version on the command line: dvipdfmx -V 5</li></ul> +<!--l. 1672--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.12 </span> <a + id="x1-310005.12"></a>Option ‘pdfa’</h4> +<!--l. 1674--><p class="noindent" >The new option ‘pdfa’ tries to avoid violations of PDF/A in code generated by hyperref. However, the +result is usually not in PDF/A, because many features aren’t controlled by hyperref (XMP metadata, +fonts, colors, driver dependend low level stuff, ...). +<!--l. 1681--><p class="indent" > Currently, option ‘pdfa’ sets and disables the following items: + <ul class="itemize1"> + <li class="itemize">Enabled annotation flags: Print, NoZoom, NoRotate [PDF/A 6.5.3]. + </li> + <li class="itemize">Disabled annotation flags: Hidden, Invisible, NoView [PDF/A 6.5.3]. + </li> + <li class="itemize">Disabled: Launch action (<a +href="run:..." >[</a>PDF/A 6.6.1]. + </li> + <li class="itemize">Restricted: Named actions (NextPage, PrevPage, FirstPage, LastPage) [PDF/A 6.6.1]. + + + </li> + <li class="itemize">Many things are disabled in PDF formulars: + <ul class="itemize2"> + <li class="itemize">JavaScript actions [PDF/A 6.6.1] + </li> + <li class="itemize">Trigger events (additional actions) [PDF/A 6.6.2] + </li> + <li class="itemize">Push button (because of JavaScript) + </li> + <li class="itemize">Interactive Forms: Flag NeedAppearances is the default ‘false’ (Because of this, + hyperref’s implementation of Forms looks ugly). [PDF/A 6.9]</li></ul> + </li></ul> +<!--l. 1701--><p class="indent" > The default value of the new option ‘pdfa’ is ‘false’. It influences the loading of the package and +cannot be changed after hyperref is loaded (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\usepackage{hyperref}</span></span></span>). +<!--l. 1707--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.13 </span> <a + id="x1-320005.13"></a>Option ‘linktoc’ added</h4> +<!--l. 1709--><p class="noindent" >The new option ‘linktoc’ allows more control which part of an entry in the table of contents is made into +a link: + <ul class="itemize1"> + <li class="itemize">‘linktoc=none’ (no links) + </li> + <li class="itemize">‘linktoc=section’ (default behaviour, same as ‘linktocpage=false’) + </li> + <li class="itemize">‘linktoc=page’ (same as ‘linktocpage=true’) + </li> + <li class="itemize">‘linktoc=all’ (both the section and page part are links)</li></ul> +<!--l. 1718--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.14 </span> <a + id="x1-330005.14"></a>Option ‘pdfnewwindow’ changed</h4> +<!--l. 1720--><p class="noindent" >Before 6.77b: + <ul class="itemize1"> + <li class="itemize">pdfnewwindow=true –> /NewWindow true + </li> + <li class="itemize">pdfnewwindow=false –> (absent) + </li> + <li class="itemize">unused pdfnewwindow –> (absent)</li></ul> +<!--l. 1726--><p class="noindent" >Since 6.77b: + <ul class="itemize1"> + <li class="itemize">pdfnewwindow=true –> /NewWindow true + + </li> + <li class="itemize">pdfnewwindow=false –> /NewWindow false + </li> + <li class="itemize">pdfnewwindow= –> (absent) + </li> + <li class="itemize">unused pdfnewwindow –> (absent)</li></ul> +<!--l. 1736--><p class="indent" > Rationale: There is a difference between setting to ‘false’ and an absent entry. In the former case the +new document replaces the old one, in the latter case the PDF viewer application should respect the user +preference. +<!--l. 1742--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.15 </span> <a + id="x1-340005.15"></a>Flag options for PDF forms</h4> +<!--l. 1744--><p class="noindent" >PDF form field macros (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\TextField</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\CheckBox</span></span></span>, ...) support boolean flag options. The option name is +the lowercase version of the names in the PDF specification (1.7): +<!--l. 1748--><p class="indent" > <a +href="http://www.adobe.com/devnet/pdf/pdf_reference.html" class="url" ><span +class="ec-lmvtt-10">http://www.adobe.com/devnet/pdf/pdf_reference.html</span></a> +<!--l. 1750--><p class="indent" > <a +href="http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf" class="url" ><span +class="ec-lmvtt-10">http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf</span></a> +<!--l. 1752--><p class="indent" > Options (convert to lowercase) except flags in square brackets: + <ul class="itemize1"> + <li class="itemize">Table 8.16 Annotation flags (page 608): + <!--l. 1757--><p class="noindent" ><div class="obeylines-v"> + 1 Invisible + <br />2 Hidden (PDF 1.2) + <br />3 Print (PDF 1.2) + <br />4 NoZoom (PDF 1.3) + <br />5 NoRotate (PDF 1.3) + <br />6 NoView (PDF 1.3) + <br />[7 ReadOnly (PDF 1.3)] ignored for widget annotations, see table 8.70 + <br />8 Locked (PDF 1.4) + <br />9 ToggleNoView (PDF 1.5) + <br />10 LockedContents (PDF 1.7)</div> + </li> + <li class="itemize">Table 8.70 Field flags common to all field types (page 676): + <!--l. 1771--><p class="noindent" ><div class="obeylines-v"> + 1 ReadOnly + <br />2 Required + <br />3 NoExport</div> + </li> + <li class="itemize">Table 8.75 Field flags specific to button fields (page 686): + <!--l. 1778--><p class="noindent" ><div class="obeylines-v"> + 15 NoToggleToOff (Radio buttons only) + + <br />16 Radio (set: radio buttons, clear: check box, pushbutton: clear) + <br />17 Pushbutton + <br />26 RadiosInUniso (PDF 1.5)</div> + </li> + <li class="itemize">Table 8.77 Field flags specific to text fields (page 691): + <!--l. 1786--><p class="noindent" ><div class="obeylines-v"> + 13 Multiline + <br />14 Password + <br />21 FileSelect (PDF 1.4) + <br />23 DoNotSpellCheck (PDF 1.4) + <br />24 DoNotScroll (PDF 1.4) + <br />25 Comb (PDF 1.5) + <br />26 RichText (PDF 1.5)</div> + </li> + <li class="itemize">Table 8.79 Field flags specific to choice fields (page 693): + <!--l. 1797--><p class="noindent" ><div class="obeylines-v"> + 18 Combo (set: combo box, clear: list box) + <br />19 Edit (only useful if Combo is set) + <br />20 (Sort) for authoring tools, not PDF viewers + <br />22 MultiSelect (PDF 1.4) + <br />23 DoNotSpellCheck (PDF 1.4) (only useful if Combo and Edit are set) + <br />27 CommitOnSelChange (PDF 1.5)</div> + </li> + <li class="itemize">Table 8.86 Flags for submit-form actions (page 704): + <!--l. 1807--><p class="noindent" ><div class="obeylines-v"> + [1 Include/Exclude] unsupported, use ‘noexport’ (table 8.70) instead + <br />2 IncludeNoValueFields + <br />[3 ExportFormat] handled by option ‘export’ + <br />4 GetMethod + <br />5 SubmitCoordinates + <br />[6 XFDF (PDF 1.4)] handled by option ‘export’ + <br />7 IncludeAppendSaves (PDF 1.4) + <br />8 IncludeAnnotations (PDF 1.4) + <br />[9 SubmitPDF (PDF 1.4)] handled by option ‘export’ + <br />10 CanonicalFormat (PDF 1.4) + <br />11 ExclNonUserAnnots (PDF 1.4) + <br />12 ExclFKey (PDF 1.4) + <br />14 EmbedForm (PDF 1.5)</div> + </li></ul> + + +<!--l. 1824--><p class="indent" > New option ‘export’ sets the export format of a submit action. Valid values are (upper- or +lowercase): + <ul class="itemize1"> + <li class="itemize">FDF + </li> + <li class="itemize">HTML + </li> + <li class="itemize">XFDF + </li> + <li class="itemize">PDF (not supported by Acrobat Reader)</li></ul> +<!--l. 1833--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.16 </span> <a + id="x1-350005.16"></a>Option ‘pdfversion’</h4> +<!--l. 1835--><p class="noindent" >This is an experimental option. It notifies ‘hyperref’ about the intended PDF version. Currently this is +used in code for PDF forms (implementation notes 116 and 122 of PDF spec 1.7). +<!--l. 1841--><p class="indent" > Values: 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. Values below 1.2 are not supported, because most drivers expect +higher PDF versions. +<!--l. 1846--><p class="indent" > The option must be used early, not after <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\usepackage{hyperref}</span></span></span>. +<!--l. 1849--><p class="indent" > In theory this option should also set the PDF version, but this is not generally supported. + <ul class="itemize1"> + <li class="itemize">pdfTeX below 1.10a: + unsupported. pdfTeX >= 1.10a and < 1.30: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfoptionpdfminorversion</span></span></span> pdfTeX >= 1.30: + <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfminorversion</span></span></span> + </li> + <li class="itemize">dvipdfm: configuration file, example: TeX Live 2007, texmf/dvipdfm/config/config, entry ‘V + 2’. + </li> + <li class="itemize">dvipdfmx: configuration file, example: TeX Live 2007, texmf/dvipdfm/dvipdfmx.cfg, entry + ‘V 4’. + </li> + <li class="itemize">Ghostscript: option -dCompatibilityLevel (this is set in ‘ps2pdf12’, ‘ps2pdf13’, ‘ps2pdf14’).</li></ul> +<!--l. 1864--><p class="indent" > The current PDF version is used as default if this version can be detected (only pdfTeX >= 1.10a). +Otherwise the lowest version 1.2 is assumed. Thus ‘hyperref’ tries to avoid PDF code that breaks this +version, but is free to use ignorable higher PDF features. +<!--l. 1871--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.17 </span> <a + id="x1-360005.17"></a>Field option ‘name’</h4> +<!--l. 1873--><p class="noindent" >Many form objects uses the label argument for several purposes: + <ul class="itemize1"> + <li class="itemize">Layouted label. + </li> + <li class="itemize">As name in HTML structures.</li></ul> + +<!--l. 1879--><p class="noindent" >Code that is suitable for layouting with TeX can break in the structures of the output format. If option +‘name’ is given, then its value is used as name in the different output structures. Thus the value should +consist of letters only. +<!--l. 1886--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.18 </span> <a + id="x1-370005.18"></a>Option ‘pdfencoding’</h4> +<!--l. 1888--><p class="noindent" >The PDF format allows two encodings for bookmarks and entries in the information dictionary: +PDFDocEncoding and Unicode as UTF-16BE. Option "pdfencoding" selects between these +encodings: + <ul class="itemize1"> + <li class="itemize">"pdfdoc" uses PDFDocEncoding. It uses just one byte per character, but the supported + characters are limited (244 in PDF-1.7). + </li> + <li class="itemize">"unicode" sets Unicode. It is encoded as UTF-16BE. Two bytes are used for most characters, + surrogates need four bytes. + </li> + <li class="itemize">"auto" PDFDocEncoding if the string does not contain characters outside the encoding and + Unicode otherwise.</li></ul> +<!--l. 1900--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.19 </span> <a + id="x1-380005.19"></a>Color options/package hycolor</h4> +<!--l. 1902--><p class="noindent" >See documentation of package ‘hycolor’. +<!--l. 1905--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.20 </span> <a + id="x1-390005.20"></a>Option pdfusetitle</h4> +<!--l. 1907--><p class="noindent" >If option pdfusetitle is set then hyperref tries to derive the values for pdftitle and pdfauthor +from <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\title</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\author</span></span></span>. An optional argument for <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\title</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\author</span></span></span> is supported (class +amsart). +<!--l. 1913--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.21 </span> <a + id="x1-400005.21"></a>Starred form of \autoref</h4> +<!--l. 1915--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\autoref*</span></span></span> generates a reference without link as <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ref*</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pageref*</span></span></span>. +<!--l. 1918--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.22 </span> <a + id="x1-410005.22"></a>Link border style</h4> +<!--l. 1920--><p class="noindent" >Links can be underlined instead of the default rectangle or options "colorlinks", "frenchlinks". This is +done by option <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">pdfborderstyle={/S/U/W</span><span +class="ec-lmvtt-10"> 1}</span></span></span> +<!--l. 1924--><p class="indent" > Some remarks: + <ul class="itemize1"> + <li class="itemize">AR7/Linux seems to have a bug, that don’t use the default value "1" for the width, but zero, + thus that the underline is not visible without "/W 1". The same applies for dashed boxes, + eg.: pdfborderstyle=/S/D/D[3 2]/W 1 + + </li> + <li class="itemize">The syntax is described in the PDF specification, look for "border style", eg. Table 8.13 + "Entries in a border style dictionary" (specification for version 1.6) + </li> + <li class="itemize">The border style is removed by pdfborderstyle= This is automatically done if option + colorlinks is enabled. + </li> + <li class="itemize">Be aware that not all PDF viewers support this feature, not even Acrobat Reader itself: + <!--l. 1945--><p class="noindent" >Some support: + <ul class="itemize2"> + <li class="itemize">AR7/Linux: "underline" and "dashed", but the border width must be given. + </li> + <li class="itemize">xpdf 3.00: "underline" and "dashed"</li></ul> + <!--l. 1952--><p class="noindent" >Unsupported: + <ul class="itemize2"> + <li class="itemize">AR5/Linux + </li> + <li class="itemize">ghostscript 8.50</li></ul> + </li></ul> +<!--l. 1959--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.23 </span> <a + id="x1-420005.23"></a>Option "bookmarksdepth"</h4> +<!--l. 1961--><p class="noindent" >The depth of the bookmarks can be controlled by the new option "bookmarksdepth". The option acts +globally and distinguishes three cases: + <ul class="itemize1"> + <li class="itemize">"bookmarksdepth" without value Then hyperref uses the current value of counter "tocdepth". + This is the compatible behaviour and the default. + </li> + <li class="itemize">"bookmarksdepth=<number>", the value is number (also negative): The depth for the + bookmarks are set to this number. + </li> + <li class="itemize">"bookmarksdepth=<name>" The <name> is a document division name (part, chapter, ...). It + must not start with a digit or minus to avoid mixing up with the number case. Internally hyperref + uses the value of macro "<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\toclevel@<name></span></span></span>". Examples: + + + <div class="verbatim" id="verbatim-35"> +     \hypersetup{bookmarksdepth=paragraph} +  <br />    \hypersetup{bookmarksdepth=4} % same as before +  <br />    \hypersetup{bookmarksdepth} % counter "tocdepth" is used +</div> + <!--l. 1980--><p class="nopar" ></li></ul> +<!--l. 1983--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.24 </span> <a + id="x1-430005.24"></a>Option "pdfescapeform"</h4> +<!--l. 1985--><p class="noindent" >There are many places where arbitrary strings end up as PS or PDF strings. The PS/PDF strings in +parentheses form require the protection of some characters, e.g. unmatched left or right parentheses need +escaping or the escape character itself (backslash). Since 2006/02/12 v6.75a the PS/PDF driver +should do this automatically. However I assume a problem with compatibility, especially +regarding the form part where larger amounts of JavaScript code can be present. It would +be a pain to remove all the escaping, because an additional escaping layer can falsify the +code. +<!--l. 1997--><p class="indent" > Therefore a new option pdfescapeform was introduced: + <ul class="itemize1"> + <li class="itemize">pdfescapeform=false Escaping for the formulars are disabled, this is the compatibility + behaviour, therefore this is the default. + </li> + <li class="itemize">pdfescapeform=true Then the PS/PDF drivers do all the necessary escaping. This is the + logical choice and the recommended setting. For example, the user writes JavaScript as + JavaScript and do not care about escaping characters for PS/PDF output.</li></ul> +<!--l. 2010--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.25 </span> <a + id="x1-440005.25"></a>Default driver setting</h4> +<!--l. 2012--><p class="noindent" >(hyperref >= 6.72s) If no driver is given, hyperref tries its best to guess the most suitable +driver. Thus it loads "hpdftex", if pdfTeX is detected running in PDF mode. Or it loads the +corresponding VTeX driver for VTeX’s working modes. Unhappily many driver programs run +after the TeX compiler, so hyperref does not have a chance (dvips, dvipdfm, ...). In this +case driver "hypertex" is loaded that supports the HyperTeX features that are recognized by +xdvi for example. This behaviour, however, can easily be changed in the configuration file +"hyperref.cfg": + + + <div class="verbatim" id="verbatim-36"> +    \providecommand*{\Hy@defaultdriver}{hdvips} +</div> +<!--l. 2025--><p class="nopar" > for dvips, or + + + <div class="verbatim" id="verbatim-37"> +    \providecommand*{\Hy@defaultdriver}{hypertex} +</div> +<!--l. 2029--><p class="nopar" > for the default behaviour of hyperref. +<!--l. 2032--><p class="indent" > See also the new option ‘driverfallback’. +<!--l. 2034--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.26 </span> <a + id="x1-450005.26"></a>Backref entries</h4> +<!--l. 2036--><p class="noindent" >Alternative interface for formatting of backref entries, example: + + + <div class="verbatim" id="verbatim-38"> +\documentclass[12pt,UKenglish]{article} + <br /> + <br />\usepackage{babel} + <br />\usepackage[pagebackref]{hyperref} + <br /> + <br />% Some language options are detected by package backref. + <br />% This affects the following macros: + <br />%   \backrefpagesname + <br />%   \backrefsectionsname + <br />%   \backrefsep + <br />%   \backreftwosep + <br />%   \backreflastsep + <br /> + <br />\renewcommand*{\backref}[1]{ + <br />  % default interface + <br />  % #1: backref list + <br />  % + <br />  % We want to use the alternative interface, + <br />  % therefore the definition is empty here. + <br />} + <br />\renewcommand*{\backrefalt}[4]{% + <br />  % alternative interface + <br />  % #1: number of distinct back references + <br />  % #2: backref list with distinct entries + <br />  % #3: number of back references including duplicates + <br />  % #4: backref list including duplicates + <br />  \par + <br />  #3 citation(s) on #1 page(s): #2,\par + <br />  \ifnum#1=1 % + <br />    \ifnum#3=1 % + <br />      1 citation on page % + <br />    \else + <br />      #3 citations on page % + <br />    \fi + <br />  \else + <br />    #3 citations on #1 pages % + <br />  \fi + <br />  #2,\par + <br />  \ifnum#3=1 % + <br />    1 citation located at page % + <br />  \else + <br />    #3 citations located at pages % + <br />  \fi + <br />  #4.\par + <br />} + <br /> + <br />% The list of distinct entries can be further refined: + <br />\renewcommand*{\backrefentrycount}[2]{% + + + <br />  % #1: the original backref entry + <br />  % #2: the count of citations of this entry, + <br />  %     in case of duplicates greater than one + <br />  #1% + <br />  \ifnum#2>1 % + <br />    ~(#2)% + <br />  \fi + <br />} + <br /> + <br />\begin{document} + <br /> + <br />  \section{Hello} + <br />    \cite{ref1, ref2, ref3, ref4} + <br />  \section{World} + <br />    \cite{ref1, ref3} + <br />  \newpage + <br /> + <br />  \section{Next section} + <br />    \cite{ref1} + <br />  \newpage + <br /> + <br />  \section{Last section} + <br />    \cite{ref1, ref2} + <br />  \newpage + <br /> + <br />  \pdfbookmark[1]{Bibliography}{bib} + <br />  \begin{thebibliography}{99} + <br />    \bibitem{ref1} Dummy entry one. + <br /> + <br />    \bibitem{ref2} Dummy entry two. + <br /> + <br />    \bibitem{ref3} Dummy entry three. + <br /> + <br />    \bibitem{ref4} Dummy entry four. + <br /> + <br />  \end{thebibliography} + <br /> + <br />\end{document} +</div> +<!--l. 2125--><p class="nopar" > +<!--l. 2127--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.27 </span> <a + id="x1-460005.27"></a>\phantomsection</h4> +<!--l. 2129--><p class="noindent" >Set an anchor at this location. It is often used in conjunction with <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\addcontentsline</span></span></span> for sectionlike things +(index, bibliography, preface). <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\addcontentsline</span></span></span> refers to the latest previous location where an anchor is +set. + + + <div class="verbatim" id="verbatim-39"> +  \cleardoublepage + <br />  \phantomsection + <br />  \addcontentsline{toc}{chapter}{\indexname} + <br />  \printindex +</div> +<!--l. 2139--><p class="nopar" > +<!--l. 2141--><p class="indent" > Now the entry in the table of contents (and bookmarks) for the index points to the start of the index +page, not to a location before this page. +<!--l. 2147--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-470006"></a>Acrobat-specific behavior</h3> +<!--l. 2148--><p class="noindent" >If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided in the appropriate drivers: -<!--l. 1370--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-38" class="tabular" +<!--l. 2151--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-39" class="tabular" cellspacing="0" cellpadding="0" -><colgroup id="TBL-38-1g"><col -id="TBL-38-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-38-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-38-1-1" +><colgroup id="TBL-39-1g"><col +id="TBL-39-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-39-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-1-1" class="td11"> <span class="ec-lmvtt-10">\Acrobatmenu</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span @@ -4072,347 +5011,427 @@ class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1374--><p class="noindent" >The <span +<!--l. 2155--><p class="noindent" >The <span class="ec-lmri-10">text </span>is used to create a button which activates the appropriate <span class="ec-lmri-10">menuoption</span>. The following table lists the option names you can use—comparison of this with the menus in Acrobat Reader or Exchange will show what they do. Obviously some are only appropriate to Exchange. -<!--l. 1377--><p class="noindent" > <a - id="x1-19001r13"></a> <!--l. 1378--><div class="longtable"> <table id="TBL-39" class="longtable" + id="x1-47001r13"></a> <!--l. 2159--><div class="longtable"> <table id="TBL-40" class="longtable" cellspacing="0" cellpadding="0" -><colgroup id="TBL-39-1g"><col -id="TBL-39-1"><col -id="TBL-39-2"></colgroup> +><colgroup id="TBL-40-1g"><col +id="TBL-40-1"><col +id="TBL-40-2"></colgroup> <tr - style="vertical-align:baseline;" id="TBL-39-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-1-1" -class="td11"> File </td><td style="white-space:wrap; text-align:left;" id="TBL-39-1-2" -class="td11"> - <!--l. 1378--><p class="noindent" >Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, - Print, PageSetup, Quit </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-2-1" -class="td11"> File<span -class="lmsy-10">→</span>Import </td><td style="white-space:wrap; text-align:left;" id="TBL-39-2-2" -class="td11"> - <!--l. 1379--><p class="noindent" >ImportImage, ImportNotes, AcroForm:ImportFDF </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-3-1" -class="td11"> File<span -class="lmsy-10">→</span>Export </td><td style="white-space:wrap; text-align:left;" id="TBL-39-3-2" -class="td11"> - <!--l. 1380--><p class="noindent" >ExportNotes, AcroForm:ExportFDF </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-4-1" -class="td11"> File<span -class="lmsy-10">→</span>DocumentInfo </td><td style="white-space:wrap; text-align:left;" id="TBL-39-4-2" -class="td11"> - <!--l. 1381--><p class="noindent" >GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, - Weblink:Base, AutoIndex:DocInfo </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-5-1" -class="td11"> File<span -class="lmsy-10">→</span>Preferences </td><td style="white-space:wrap; text-align:left;" id="TBL-39-5-2" -class="td11"> - <!--l. 1382--><p class="noindent" >GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, - AcroSearch:Preferences(Windows) or, - AcroSearch:Prefs(Mac), Cpt:Capture </td> + style="vertical-align:baseline;" id="TBL-40-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-1-1" +class="td01">File </td><td style="white-space:wrap; text-align:left;" id="TBL-40-1-2" +class="td10"> + <!--l. 2159--><p class="noindent" >Open, + Close, + Scan, + Save, + SaveAs, + Optimizer:SaveAsOpt, + Print, + PageSetup, + Quit </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-2-1" +class="td01">File<span +class="lmsy-10">→</span>Import </td><td style="white-space:wrap; text-align:left;" id="TBL-40-2-2" +class="td10"> + <!--l. 2160--><p class="noindent" >ImportImage, + ImportNotes, + AcroForm:ImportFDF </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-3-1" +class="td01">File<span +class="lmsy-10">→</span>Export </td><td style="white-space:wrap; text-align:left;" id="TBL-40-3-2" +class="td10"> + <!--l. 2161--><p class="noindent" >ExportNotes, + AcroForm:ExportFDF </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-4-1" +class="td01">File<span +class="lmsy-10">→</span>DocumentInfo </td><td style="white-space:wrap; text-align:left;" id="TBL-40-4-2" +class="td10"> + <!--l. 2162--><p class="noindent" >GeneralInfo, + OpenInfo, + FontsInfo, + SecurityInfo, + Weblink:Base, + AutoIndex:DocInfo </td> + + </tr><tr - style="vertical-align:baseline;" id="TBL-39-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-6-1" -class="td11"> Edit </td><td style="white-space:wrap; text-align:left;" id="TBL-39-6-2" -class="td11"> - <!--l. 1384--><p class="noindent" >Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, + style="vertical-align:baseline;" id="TBL-40-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-5-1" +class="td01">File<span +class="lmsy-10">→</span>Preferences </td><td style="white-space:wrap; text-align:left;" id="TBL-40-5-2" +class="td10"> + <!--l. 2163--><p class="noindent" >GeneralPrefs, + NotePrefs, + FullScreenPrefs, + Weblink:Prefs, + AcroSearch:Preferences(Windows) + or, + AcroSearch:Prefs(Mac), + Cpt:Capture </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-6-1" +class="td01">Edit </td><td style="white-space:wrap; text-align:left;" id="TBL-40-6-2" +class="td10"> + <!--l. 2165--><p class="noindent" >Undo, + Cut, + Copy, + Paste, + Clear, + SelectAll, + Ole:CopyFile, TouchUp:TextAttributes, - TouchUp:FitTextToSelection, TouchUp:ShowLineMarkers, - TouchUp:ShowCaptureSuspects, TouchUp:FindSuspect, </td> + TouchUp:FitTextToSelection, + TouchUp:ShowLineMarkers, + TouchUp:ShowCaptureSuspects, + TouchUp:FindSuspect, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-7-1" +class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-40-7-2" +class="td10"> + <!--l. 2168--><p class="noindent" >Properties </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-8-1" +class="td01">Edit<span +class="lmsy-10">→</span>Fields </td><td style="white-space:wrap; text-align:left;" id="TBL-40-8-2" +class="td10"> + <!--l. 2169--><p class="noindent" >AcroForm:Duplicate, + AcroForm:TabOrder </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-9-1" +class="td01">Document </td><td style="white-space:wrap; text-align:left;" id="TBL-40-9-2" +class="td10"> + <!--l. 2170--><p class="noindent" >Cpt:CapturePages, + AcroForm:Actions, + CropPages, + RotatePages, + InsertPages, + ExtractPages, + ReplacePages, + DeletePages, + NewBookmark, + SetBookmarkDest, + CreateAllThumbs, + DeleteAllThumbs </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-7-1" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-39-7-2" -class="td11"> - <!--l. 1387--><p class="noindent" >Properties </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-8-1" -class="td11"> Edit<span -class="lmsy-10">→</span>Fields </td><td style="white-space:wrap; text-align:left;" id="TBL-39-8-2" -class="td11"> - <!--l. 1388--><p class="noindent" >AcroForm:Duplicate, AcroForm:TabOrder </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-9-1" -class="td11"> Document </td><td style="white-space:wrap; text-align:left;" id="TBL-39-9-2" -class="td11"> - <!--l. 1389--><p class="noindent" >Cpt:CapturePages, - AcroForm:Actions, CropPages, RotatePages, InsertPages, - ExtractPages, ReplacePages, DeletePages, NewBookmark, - SetBookmarkDest, CreateAllThumbs, DeleteAllThumbs </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-10-1" -class="td11"> View </td><td style="white-space:wrap; text-align:left;" id="TBL-39-10-2" -class="td11"> - <!--l. 1392--><p class="noindent" >ActualSize, FitVisible, FitWidth, FitPage, ZoomTo, - FullScreen, FirstPage, PrevPage, NextPage, LastPage, - GoToPage, GoBack, GoForward, SinglePage, OneColumn, - TwoColumns, ArticleThreads, PageOnly, ShowBookmarks, - ShowThumbs </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-11-1" -class="td11"> Tools </td><td style="white-space:wrap; text-align:left;" id="TBL-39-11-2" -class="td11"> - <!--l. 1395--><p class="noindent" >Hand, ZoomIn, ZoomOut, SelectText, SelectGraphics, - Note, Link, Thread, AcroForm:Tool, - Acro_Movie:MoviePlayer, TouchUp:TextTool, Find, - FindAgain, FindNextNote, CreateNotesFile </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-39-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-12-1" -class="td11"> Tools<span -class="lmsy-10">→</span>Search </td><td style="white-space:wrap; text-align:left;" id="TBL-39-12-2" -class="td11"> - <!--l. 1398--><p class="noindent" >AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, - AcroSrch:Assist, AcroSrch:PrevDoc, AcroSrch:PrevHit, - AcroSrch:NextHit, AcroSrch:NextDoc </td> + style="vertical-align:baseline;" id="TBL-40-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-10-1" +class="td01">View </td><td style="white-space:wrap; text-align:left;" id="TBL-40-10-2" +class="td10"> + <!--l. 2173--><p class="noindent" >ActualSize, + FitVisible, + FitWidth, + FitPage, + ZoomTo, + FullScreen, + FirstPage, + PrevPage, + NextPage, + LastPage, + GoToPage, + GoBack, + GoForward, + SinglePage, + OneColumn, + TwoColumns, + ArticleThreads, + PageOnly, + ShowBookmarks, + ShowThumbs </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-11-1" +class="td01">Tools </td><td style="white-space:wrap; text-align:left;" id="TBL-40-11-2" +class="td10"> + <!--l. 2176--><p class="noindent" >Hand, + ZoomIn, + ZoomOut, + SelectText, + SelectGraphics, + Note, + Link, + Thread, + AcroForm:Tool, + Acro_Movie:MoviePlayer, + TouchUp:TextTool, + Find, + FindAgain, + FindNextNote, + CreateNotesFile </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-40-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-12-1" +class="td01">Tools<span +class="lmsy-10">→</span>Search </td><td style="white-space:wrap; text-align:left;" id="TBL-40-12-2" +class="td10"> + <!--l. 2179--><p class="noindent" >AcroSrch:Query, + AcroSrch:Indexes, + AcroSrch:Results, + AcroSrch:Assist, + AcroSrch:PrevDoc, + AcroSrch:PrevHit, + AcroSrch:NextHit, + AcroSrch:NextDoc </td> + + </tr><tr - style="vertical-align:baseline;" id="TBL-39-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-13-1" -class="td11"> Window </td><td style="white-space:wrap; text-align:left;" id="TBL-39-13-2" -class="td11"> - <!--l. 1400--><p class="noindent" >ShowHideToolBar, ShowHideMenuBar, - ShowHideClipboard, Cascade, TileHorizontal, TileVertical, - CloseAll </td> + style="vertical-align:baseline;" id="TBL-40-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-13-1" +class="td01">Window </td><td style="white-space:wrap; text-align:left;" id="TBL-40-13-2" +class="td10"> + <!--l. 2181--><p class="noindent" >ShowHideToolBar, + ShowHideMenuBar, + ShowHideClipboard, + Cascade, + TileHorizontal, + TileVertical, + CloseAll </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-14-1" -class="td11"> Help </td><td style="white-space:wrap; text-align:left;" id="TBL-39-14-2" -class="td11"> - <!--l. 1402--><p class="noindent" >HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, - HelpCapture, HelpPDFWriter, HelpDistiller, HelpSearch, - HelpCatalog, HelpReader, Weblink:Home </td> + style="vertical-align:baseline;" id="TBL-40-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-14-1" +class="td01">Help </td><td style="white-space:wrap; text-align:left;" id="TBL-40-14-2" +class="td10"> + <!--l. 2183--><p class="noindent" >HelpUserGuide, + HelpTutorial, + HelpExchange, + HelpScan, + HelpCapture, + HelpPDFWriter, + HelpDistiller, + HelpSearch, + HelpCatalog, + HelpReader, + Weblink:Home </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-15-1" -class="td11"> Help(Windows) </td><td style="white-space:wrap; text-align:left;" id="TBL-39-15-2" -class="td11"> - <!--l. 1404--><p class="noindent" >About </td> + style="vertical-align:baseline;" id="TBL-40-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-15-1" +class="td01">Help(Windows) </td><td style="white-space:wrap; text-align:left;" id="TBL-40-15-2" +class="td10"> + <!--l. 2185--><p class="noindent" >About </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-16-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-40-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-16-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-17-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-40-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-17-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-18-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-40-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-18-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-39-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-39-19-1" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-39-19-2" -class="td11"></td></tr> + style="vertical-align:baseline;" id="TBL-40-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-19-1" +class="td01"> </td><td style="white-space:wrap; text-align:left;" id="TBL-40-19-2" +class="td10"></td></tr> </table></div> -<!--l. 1407--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">6 </span> <a - id="x1-200006"></a>PDF and HTML forms</h3> -<!--l. 1408--><p class="noindent" >You must put your fields inside a <span +<!--l. 2188--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-480007"></a>PDF and HTML forms</h3> +<!--l. 2189--><p class="noindent" >You must put your fields inside a <span class="ec-lmvtt-10">Form </span>environment (only one per file). -<!--l. 1410--><p class="indent" > There are six macros to prepare fields: -<!--l. 1412--><p class="noindent" > -<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-40" class="tabular" -cellspacing="0" cellpadding="0" -><colgroup id="TBL-40-1g"><col -id="TBL-40-1"></colgroup><tr - style="vertical-align:baseline;" id="TBL-40-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-40-1-1" -class="td11"> <span -class="ec-lmvtt-10">\TextField</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">[</span></span></span><span -class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">]{</span></span></span><span -class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">}</span></span></span> </td> - </tr></table> </div></span> -<!--l. 1416--><p class="noindent" > - - +<!--l. 2191--><p class="indent" > There are six macros to prepare fields: +<!--l. 2193--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-41" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-41-1g"><col id="TBL-41-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-41-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-41-1-1" class="td11"> <span -class="ec-lmvtt-10">\CheckBox</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\TextField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">[</span></span></span><span class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1420--><p class="noindent" > +<!--l. 2197--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-42" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-42-1g"><col id="TBL-42-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-42-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-42-1-1" class="td11"> <span -class="ec-lmvtt-10">\ChoiceMenu</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\CheckBox</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">[</span></span></span><span class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">}{</span></span></span><span -class="ec-lmri-10">choices</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1424--><p class="noindent" > +<!--l. 2201--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-43" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-43-1g"><col id="TBL-43-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-43-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-43-1-1" class="td11"> <span -class="ec-lmvtt-10">\PushButton</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ChoiceMenu</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">[</span></span></span><span class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">choices</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1428--><p class="noindent" > +<!--l. 2205--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-44" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-44-1g"><col id="TBL-44-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-44-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-44-1-1" class="td11"> <span -class="ec-lmvtt-10">\Submit</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\PushButton</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">[</span></span></span><span class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1432--><p class="noindent" > +<!--l. 2209--><p class="noindent" > + + <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-45" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-45-1g"><col id="TBL-45-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-45-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-45-1-1" class="td11"> <span -class="ec-lmvtt-10">\Reset</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\Submit</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">[</span></span></span><span class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1436--><p class="indent" > The way forms and their labels are laid out is determined by: -<!--l. 1437--><p class="noindent" > +<!--l. 2213--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-46" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-46-1g"><col id="TBL-46-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-46-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-46-1-1" class="td11"> <span -class="ec-lmvtt-10">\LayoutTextField</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmvtt-10">\Reset</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">[</span></span></span><span +class="ec-lmri-10">parameters</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">]{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">}{</span></span></span><span -class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1441--><p class="noindent" > +<!--l. 2217--><p class="indent" > The way forms and their labels are laid out is determined by: +<!--l. 2218--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-47" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-47-1g"><col id="TBL-47-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-47-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-47-1-1" class="td11"> <span -class="ec-lmvtt-10">\LayoutChoiceField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\LayoutTextField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1445--><p class="noindent" > +<!--l. 2222--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-48" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-48-1g"><col id="TBL-48-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-48-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-48-1-1" class="td11"> <span -class="ec-lmvtt-10">\LayoutCheckField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\LayoutChoiceField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1449--><p class="indent" > These macros default to #1 #2 -<!--l. 1451--><p class="indent" > What is actually shown in as the field is determined by: -<!--l. 1452--><p class="noindent" > +<!--l. 2226--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-49" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-49-1g"><col id="TBL-49-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-49-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-49-1-1" class="td11"> <span -class="ec-lmvtt-10">\MakeRadioField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\LayoutCheckField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span -class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmri-10">label</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span -class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmri-10">field</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1456--><p class="noindent" > +<!--l. 2230--><p class="indent" > These macros default to #1 #2 +<!--l. 2232--><p class="indent" > What is actually shown in as the field is determined by: +<!--l. 2233--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-50" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-50-1g"><col id="TBL-50-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-50-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-50-1-1" class="td11"> <span -class="ec-lmvtt-10">\MakeCheckField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\MakeRadioField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1459--><p class="noindent" > +<!--l. 2237--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-51" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-51-1g"><col id="TBL-51-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-51-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-51-1-1" class="td11"> <span -class="ec-lmvtt-10">\MakeTextField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\MakeCheckField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1462--><p class="noindent" > - - +<!--l. 2240--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-52" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-52-1g"><col id="TBL-52-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-52-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-52-1-1" class="td11"> <span -class="ec-lmvtt-10">\MakeChoiceField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\MakeTextField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}{</span></span></span><span class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td> </tr></table> </div></span> -<!--l. 1466--><p class="noindent" > +<!--l. 2243--><p class="noindent" > <span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-53" class="tabular" cellspacing="0" cellpadding="0" ><colgroup id="TBL-53-1g"><col id="TBL-53-1"></colgroup><tr style="vertical-align:baseline;" id="TBL-53-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-53-1-1" class="td11"> <span +class="ec-lmvtt-10">\MakeChoiceField</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">{</span></span></span><span +class="ec-lmri-10">width</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}{</span></span></span><span +class="ec-lmri-10">height</span><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">}</span></span></span> </td> + </tr></table> </div></span> +<!--l. 2247--><p class="noindent" > +<span class="fbox"><!--tex4ht:inline--><div class="tabular"> <table id="TBL-54" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-54-1g"><col +id="TBL-54-1"></colgroup><tr + style="vertical-align:baseline;" id="TBL-54-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-1-1" +class="td11"> <span class="ec-lmvtt-10">\MakeButtonField</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmri-10">text</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">}</span></span></span> </td></tr></table> </div></span> -<!--l. 1470--><p class="indent" > These macros default to <span class="obeylines-h"><span class="verb"><span +<!--l. 2251--><p class="indent" > These macros default to <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\vbox</span><span class="ec-lmvtt-10"> to</span><span class="ec-lmvtt-10"> #2{\hbox</span><span @@ -4421,10 +5440,10 @@ class="ec-lmvtt-10"> #1{\hfill}\vfill}</span></span></span>, except the l to #1; it is used for buttons, and the special <span class="ec-lmvtt-10">\Submit </span>and <span class="ec-lmvtt-10">\Reset </span>macros. -<!--l. 1474--><p class="indent" > You may also want to redefine the following macros: +<!--l. 2255--><p class="indent" > You may also want to redefine the following macros: - <div class="verbatim" id="verbatim-22"> + <div class="verbatim" id="verbatim-40"> \def\DefaultHeightofSubmit{12pt}  <br />\def\DefaultWidthofSubmit{2cm}  <br />\def\DefaultHeightofReset{12pt} @@ -4437,574 +5456,572 @@ class="ec-lmvtt-10">\Reset </span>macros.  <br />\def\DefaultHeightofTextMultiline{4\baselineskip}  <br />\def\DefaultWidthofText{3cm} </div> -<!--l. 1487--><p class="nopar" > -<!--l. 1489--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a - id="x1-210006.1"></a>Forms environment parameters</h4> -<!--l. 1491--><p class="noindent" > +<!--l. 2268--><p class="nopar" > +<!--l. 2270--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.1 </span> <a + id="x1-490007.1"></a>Forms environment parameters</h4> <a - id="x1-21001r14"></a> <!--l. 1492--><div class="longtable"> <table id="TBL-54" class="longtable" + id="x1-49001r14"></a> <!--l. 2274--><div class="longtable"> <table id="TBL-55" class="longtable" cellspacing="0" cellpadding="0" -><colgroup id="TBL-54-1g"><col -id="TBL-54-1"><col -id="TBL-54-2"><col -id="TBL-54-3"></colgroup> +><colgroup id="TBL-55-1g"><col +id="TBL-55-1"><col +id="TBL-55-2"><col +id="TBL-55-3"></colgroup> <tr - style="vertical-align:baseline;" id="TBL-54-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-1-1" -class="td11"> <span -class="ec-lmvtt-10">action </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-54-1-2" + style="vertical-align:baseline;" id="TBL-55-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-1" +class="td01"><span +class="ec-lmvtt-10">action </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-2" class="td11"> <span -class="ec-lmri-10">URL </span></td><td style="white-space:wrap; text-align:left;" id="TBL-54-1-3" -class="td11"> - <!--l. 1492--><p class="noindent" >The URL that will receive the form data if a <span +class="ec-lmri-10">URL </span></td><td style="white-space:wrap; text-align:left;" id="TBL-55-1-3" +class="td10"> + <!--l. 2274--><p class="noindent" >The URL that will receive the form data if a <span class="ec-lmss-10">Submit </span>button - is included in the form </td> + is included in the form </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-2-1" -class="td11"> <span -class="ec-lmvtt-10">encoding </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-54-2-2" + style="vertical-align:baseline;" id="TBL-55-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-2-1" +class="td01"><span +class="ec-lmvtt-10">encoding </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-2-2" class="td11"> <span -class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-54-2-3" -class="td11"> - <!--l. 1493--><p class="noindent" >The encoding for the string set to the URL; FDF-encoding +class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-55-2-3" +class="td10"> + <!--l. 2275--><p class="noindent" >The encoding for the string set to the URL; FDF-encoding is usual, and <span -class="ec-lmvtt-10">html </span>is the only valid value </td> +class="ec-lmvtt-10">html </span>is the only valid value </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-3-1" -class="td11"> <span -class="ec-lmvtt-10">method </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-54-3-2" + style="vertical-align:baseline;" id="TBL-55-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-3-1" +class="td01"><span +class="ec-lmvtt-10">method </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-3-2" class="td11"> <span -class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-54-3-3" -class="td11"> - <!--l. 1495--><p class="noindent" >Used only when generating HTML; values can be <span +class="ec-lmri-10">name </span></td><td style="white-space:wrap; text-align:left;" id="TBL-55-3-3" +class="td10"> + <!--l. 2277--><p class="noindent" >Used only when generating HTML; values can be <span class="ec-lmvtt-10">post </span>or <span -class="ec-lmvtt-10">get</span> </td> +class="ec-lmvtt-10">get</span> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-4-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-55-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-4-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-5-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-55-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-5-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-6-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-55-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-6-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-7-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-55-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-7-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-54-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-54-8-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-54-8-2" -class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-54-8-3" -class="td11"></td></tr> + style="vertical-align:baseline;" id="TBL-55-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-8-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-8-2" +class="td11"> </td><td style="white-space:wrap; text-align:left;" id="TBL-55-8-3" +class="td10"></td></tr> </table></div> -<!--l. 1498--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a - id="x1-220006.2"></a>Forms optional parameters</h4> -<!--l. 1499--><p class="noindent" >Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. <span +<!--l. 2280--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.2 </span> <a + id="x1-500007.2"></a>Forms optional parameters</h4> +<!--l. 2281--><p class="noindent" >Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. <span class="ec-lmvtt-10">color=0 0</span> <span class="ec-lmvtt-10">0.5</span>) -<!--l. 1502--><p class="noindent" > <a - id="x1-22001r15"></a> <!--l. 1503--><div class="longtable"> <table id="TBL-55" class="longtable" + id="x1-50001r15"></a> <!--l. 2286--><div class="longtable"> <table id="TBL-56" class="longtable" cellspacing="0" cellpadding="0" -><colgroup id="TBL-55-1g"><col -id="TBL-55-1"><col -id="TBL-55-2"><col -id="TBL-55-3"><col -id="TBL-55-4"></colgroup> +><colgroup id="TBL-56-1g"><col +id="TBL-56-1"><col +id="TBL-56-2"><col +id="TBL-56-3"><col +id="TBL-56-4"></colgroup> <tr - style="vertical-align:baseline;" id="TBL-55-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-1" -class="td11"> <span -class="ec-lmvtt-10">accesskey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-2" -class="td11"> key </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-1-4" -class="td11"> (as per HTML) </td> + style="vertical-align:baseline;" id="TBL-56-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-1-1" +class="td01"><span +class="ec-lmvtt-10">accesskey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-1-2" +class="td11"> key </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-1-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-1-4" +class="td10"> (as per HTML) </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-2-1" -class="td11"> <span -class="ec-lmvtt-10">align </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-2-2" -class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-2-3" + style="vertical-align:baseline;" id="TBL-56-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-2-1" +class="td01"><span +class="ec-lmvtt-10">align </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-2-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-2-3" class="td11"> <span -class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-2-4" -class="td11"> alignment within text field; 0 is left-aligned, </td> -<td id="TBL-55-2-5" -class="td10"> </td> +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-2-4" +class="td10"> alignment within text field; 0 is left-aligned, </td> +<td id="TBL-56-2-5" +class="td00"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-3-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-3-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-4-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-4-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-4-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-4-4" -class="td11"> 1 is centered, 2 is right-aligned. </td> + style="vertical-align:baseline;" id="TBL-56-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-4-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-4-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-4-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-4-4" +class="td10"> 1 is centered, 2 is right-aligned. </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-5-1" -class="td11"> <span -class="ec-lmvtt-10">altname </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-5-2" -class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-5-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-5-4" -class="td11"> alternative name, </td> - -<td id="TBL-55-5-5" -class="td10"> </td> + style="vertical-align:baseline;" id="TBL-56-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-5-1" +class="td01"><span +class="ec-lmvtt-10">altname </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-5-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-5-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-5-4" +class="td10"> alternative name, </td> +<td id="TBL-56-5-5" +class="td00"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-6-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-6-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-7-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-7-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-7-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-7-4" -class="td11"> the name shown in the user interface </td> + style="vertical-align:baseline;" id="TBL-56-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-7-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-7-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-7-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-7-4" +class="td10"> the name shown in the user interface </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-8-1" -class="td11"> <span -class="ec-lmvtt-10">backgroundcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-8-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-8-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-8-4" -class="td11"> color of box </td> + style="vertical-align:baseline;" id="TBL-56-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-8-1" +class="td01"><span +class="ec-lmvtt-10">backgroundcolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-8-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-8-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-8-4" +class="td10"> color of box </td> + </tr><tr - style="vertical-align:baseline;" id="TBL-55-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-9-1" -class="td11"> <span -class="ec-lmvtt-10">bordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-9-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-9-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-9-4" -class="td11"> color of border </td> + style="vertical-align:baseline;" id="TBL-56-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-9-1" +class="td01"><span +class="ec-lmvtt-10">bordercolor </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-9-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-9-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-9-4" +class="td10"> color of border </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-10-1" -class="td11"> <span -class="ec-lmvtt-10">bordersep </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-10-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-10-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-10-4" -class="td11"> box border gap </td> + style="vertical-align:baseline;" id="TBL-56-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-10-1" +class="td01"><span +class="ec-lmvtt-10">bordersep </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-10-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-10-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-10-4" +class="td10"> box border gap </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-11-1" -class="td11"> <span -class="ec-lmvtt-10">borderwidth </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-11-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-11-3" + style="vertical-align:baseline;" id="TBL-56-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-11-1" +class="td01"><span +class="ec-lmvtt-10">borderwidth </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-11-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-11-3" class="td11"> <span -class="ec-lmri-10">1 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-11-4" -class="td11"> width of box border, the value is a dimension </td> +class="ec-lmri-10">1 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-11-4" +class="td10"> width of box border, the value is a dimension </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-12-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-12-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-12-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-12-4" -class="td11"> or a number with default unit bp </td> + style="vertical-align:baseline;" id="TBL-56-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-12-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-12-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-12-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-12-4" +class="td10"> or a number with default unit bp </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-13-1" -class="td11"> <span -class="ec-lmvtt-10">calculate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-13-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-13-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-13-4" -class="td11"> JavaScript code to calculate the value of the field </td> + style="vertical-align:baseline;" id="TBL-56-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-13-1" +class="td01"><span +class="ec-lmvtt-10">calculate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-13-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-13-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-13-4" +class="td10"> JavaScript code to calculate the value of the field</td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-14-1" -class="td11"> <span -class="ec-lmvtt-10">charsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-14-2" -class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-14-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-14-4" -class="td11"> font size of field text </td> + style="vertical-align:baseline;" id="TBL-56-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-14-1" +class="td01"><span +class="ec-lmvtt-10">charsize </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-14-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-14-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-14-4" +class="td10"> font size of field text </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-15-1" -class="td11"> <span -class="ec-lmvtt-10">checkboxsymbol </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-15-2" -class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-15-3" + style="vertical-align:baseline;" id="TBL-56-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-15-1" +class="td01"><span +class="ec-lmvtt-10">checkboxsymbol </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-15-2" +class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-15-3" class="td11"> <span class="ec-lmri-10">4 (</span><span class="pzdr-">✔</span><span -class="ec-lmri-10">) </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-15-4" -class="td11"> symbol used for check boxes (ZapfDingbats), </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-55-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-16-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-16-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-16-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-16-4" -class="td11"> the value is a character or <span +class="ec-lmri-10">) </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-15-4" +class="td10"> symbol used for check boxes (ZapfDingbats), </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-56-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-16-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-16-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-16-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-16-4" +class="td10"> the value is a character or <span class="ec-lmvtt-10">\ding</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmvtto-10">number</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">}</span></span></span>, </td> +class="ec-lmvtt-10">}</span></span></span>, </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-17-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-17-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-17-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-17-4" -class="td11"> see package <span + style="vertical-align:baseline;" id="TBL-56-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-17-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-17-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-17-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-17-4" +class="td10"> see package <span class="ec-lmss-10">pifont </span>from bundle <span -class="ec-lmss-10">psnfss </span></td> +class="ec-lmss-10">psnfss </span></td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-18-1" -class="td11"> <span -class="ec-lmvtt-10">checked </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-18-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-18-3" + style="vertical-align:baseline;" id="TBL-56-18-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-18-1" +class="td01"><span +class="ec-lmvtt-10">checked </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-18-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-18-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-18-4" -class="td11"> whether option selected by default </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-18-4" +class="td10"> whether option selected by default </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-19-1" -class="td11"> <span -class="ec-lmvtt-10">color </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-19-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-19-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-19-4" -class="td11"> color of text in box </td> + style="vertical-align:baseline;" id="TBL-56-19-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-19-1" +class="td01"><span +class="ec-lmvtt-10">color </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-19-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-19-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-19-4" +class="td10"> color of text in box </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-20-1" -class="td11"> <span -class="ec-lmvtt-10">combo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-20-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-20-3" + style="vertical-align:baseline;" id="TBL-56-20-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-20-1" +class="td01"><span +class="ec-lmvtt-10">combo </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-20-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-20-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-20-4" -class="td11"> choice list is ‘combo’ style </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-20-4" +class="td10"> choice list is ‘combo’ style </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-21-1" -class="td11"> <span -class="ec-lmvtt-10">default </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-21-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-21-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-21-4" -class="td11"> default value </td> + style="vertical-align:baseline;" id="TBL-56-21-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-21-1" +class="td01"><span +class="ec-lmvtt-10">default </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-21-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-21-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-21-4" +class="td10"> default value </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-22-1" -class="td11"> <span -class="ec-lmvtt-10">disabled </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-22-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-22-3" + style="vertical-align:baseline;" id="TBL-56-22-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-22-1" +class="td01"><span +class="ec-lmvtt-10">disabled </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-22-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-22-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-22-4" -class="td11"> field disabled </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-22-4" +class="td10"> field disabled </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-23-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-23-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-23-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-23-4" -class="td11"></td></tr> + style="vertical-align:baseline;" id="TBL-56-23-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-23-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-23-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-23-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-23-4" +class="td10"></td></tr> <tr - style="vertical-align:baseline;" id="TBL-55-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-24-1" -class="td11"> <span -class="ec-lmvtt-10">format </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-24-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-24-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-24-4" -class="td11"> JavaScript code to format the field </td> + style="vertical-align:baseline;" id="TBL-56-24-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-24-1" +class="td01"><span +class="ec-lmvtt-10">format </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-24-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-24-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-24-4" +class="td10"> JavaScript code to format the field </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-25-1" -class="td11"> <span -class="ec-lmvtt-10">height </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-25-2" -class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-25-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-25-4" -class="td11"> height of field box </td> + style="vertical-align:baseline;" id="TBL-56-25-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-25-1" +class="td01"><span +class="ec-lmvtt-10">height </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-25-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-25-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-25-4" +class="td10"> height of field box </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-26-1" -class="td11"> <span -class="ec-lmvtt-10">hidden </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-26-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-26-3" + style="vertical-align:baseline;" id="TBL-56-26-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-26-1" +class="td01"><span +class="ec-lmvtt-10">hidden </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-26-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-26-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-26-4" -class="td11"> field hidden </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-26-4" +class="td10"> field hidden </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-27-1" -class="td11"> <span -class="ec-lmvtt-10">keystroke </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-27-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-27-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-27-4" -class="td11"> JavaScript code to control the keystrokes on entry </td> + style="vertical-align:baseline;" id="TBL-56-27-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-27-1" +class="td01"><span +class="ec-lmvtt-10">keystroke </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-27-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-27-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-27-4" +class="td10"> JavaScript code to control the keystrokes on entry</td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-28-1" -class="td11"> <span -class="ec-lmvtt-10">mappingname </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-28-2" -class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-28-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-28-4" -class="td11"> the mapping name to be used when exporting </td> -<td id="TBL-55-28-5" -class="td10"> </td> + style="vertical-align:baseline;" id="TBL-56-28-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-28-1" +class="td01"><span +class="ec-lmvtt-10">mappingname </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-28-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-28-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-28-4" +class="td10"> the mapping name to be used when exporting </td> +<td id="TBL-56-28-5" +class="td00"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-29-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-29-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-29-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-30-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-30-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-30-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-30-4" -class="td11"> the field data </td> + style="vertical-align:baseline;" id="TBL-56-30-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-30-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-30-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-30-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-30-4" +class="td10"> the field data </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-31-1" -class="td11"> <span -class="ec-lmvtt-10">maxlen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-31-2" -class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-31-3" + style="vertical-align:baseline;" id="TBL-56-31-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-31-1" +class="td01"><span +class="ec-lmvtt-10">maxlen </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-31-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-31-3" class="td11"> <span -class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-31-4" -class="td11"> number of characters allowed in text field </td> +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-31-4" +class="td10"> number of characters allowed in text field </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-32-1" -class="td11"> <span -class="ec-lmvtt-10">menulength </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-32-2" -class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-32-3" + style="vertical-align:baseline;" id="TBL-56-32-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-32-1" +class="td01"><span +class="ec-lmvtt-10">menulength </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-32-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-32-3" class="td11"> <span -class="ec-lmri-10">4 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-32-4" -class="td11"> number of elements shown in list </td> +class="ec-lmri-10">4 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-32-4" +class="td10"> number of elements shown in list </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-33-1" -class="td11"> <span -class="ec-lmvtt-10">multiline </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-33-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-33-3" + style="vertical-align:baseline;" id="TBL-56-33-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-33-1" +class="td01"><span +class="ec-lmvtt-10">multiline </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-33-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-33-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-33-4" -class="td11"> whether text box is multiline </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-33-4" +class="td10"> whether text box is multiline </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-34-1" -class="td11"> <span -class="ec-lmvtt-10">name </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-34-2" -class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-34-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-34-4" -class="td11"> name of field (defaults to label) </td> + style="vertical-align:baseline;" id="TBL-56-34-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-34-1" +class="td01"><span +class="ec-lmvtt-10">name </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-34-2" +class="td11"> name </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-34-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-34-4" +class="td10"> name of field (defaults to label) </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-35-1" -class="td11"> <span -class="ec-lmvtt-10">onblur </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-35-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-35-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-35-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-35-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-35-1" +class="td01"><span +class="ec-lmvtt-10">onblur </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-35-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-35-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-35-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-36-1" -class="td11"> <span -class="ec-lmvtt-10">onchange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-36-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-36-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-36-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-36-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-36-1" +class="td01"><span +class="ec-lmvtt-10">onchange </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-36-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-36-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-36-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-37-1" -class="td11"> <span -class="ec-lmvtt-10">onclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-37-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-37-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-37-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-37-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-37-1" +class="td01"><span +class="ec-lmvtt-10">onclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-37-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-37-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-37-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-38-1" -class="td11"> <span -class="ec-lmvtt-10">ondblclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-38-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-38-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-38-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-38-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-38-1" +class="td01"><span +class="ec-lmvtt-10">ondblclick </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-38-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-38-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-38-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-39-1" -class="td11"> <span -class="ec-lmvtt-10">onfocus </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-39-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-39-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-39-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-39-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-39-1" +class="td01"><span +class="ec-lmvtt-10">onfocus </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-39-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-39-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-39-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-40-1" -class="td11"> <span -class="ec-lmvtt-10">onkeydown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-40-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-40-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-40-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-40-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-40-1" +class="td01"><span +class="ec-lmvtt-10">onkeydown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-40-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-40-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-40-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-41-1" -class="td11"> <span -class="ec-lmvtt-10">onkeypress </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-41-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-41-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-41-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-41-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-41-1" +class="td01"><span +class="ec-lmvtt-10">onkeypress </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-41-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-41-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-41-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-42-1" -class="td11"> <span -class="ec-lmvtt-10">onkeyup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-42-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-42-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-42-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-42-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-42-1" +class="td01"><span +class="ec-lmvtt-10">onkeyup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-42-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-42-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-42-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-43-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-43-1" -class="td11"> <span -class="ec-lmvtt-10">onmousedown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-43-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-43-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-43-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-43-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-43-1" +class="td01"><span +class="ec-lmvtt-10">onmousedown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-43-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-43-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-43-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-44-1" -class="td11"> <span -class="ec-lmvtt-10">onmousemove </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-44-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-44-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-44-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-44-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-44-1" +class="td01"><span +class="ec-lmvtt-10">onmousemove </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-44-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-44-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-44-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-45-1" -class="td11"> </td></tr> + style="vertical-align:baseline;" id="TBL-56-45-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-45-1" +class="td01"> </td></tr> <tr - style="vertical-align:baseline;" id="TBL-55-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-46-1" -class="td11"> <span -class="ec-lmvtt-10">onmouseout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-46-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-46-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-46-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-46-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-46-1" +class="td01"><span +class="ec-lmvtt-10">onmouseout </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-46-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-46-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-46-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-47-1" -class="td11"> <span -class="ec-lmvtt-10">onmouseover </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-47-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-47-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-47-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-47-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-47-1" +class="td01"><span +class="ec-lmvtt-10">onmouseover </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-47-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-47-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-47-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-48-1" -class="td11"> <span -class="ec-lmvtt-10">onmouseup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-48-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-48-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-48-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-48-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-48-1" +class="td01"><span +class="ec-lmvtt-10">onmouseup </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-48-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-48-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-48-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-49-1" -class="td11"> <span -class="ec-lmvtt-10">onselect </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-49-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-49-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-49-4" -class="td11"> JavaScript code </td> + style="vertical-align:baseline;" id="TBL-56-49-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-49-1" +class="td01"><span +class="ec-lmvtt-10">onselect </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-49-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-49-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-49-4" +class="td10"> JavaScript code </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-50-1" -class="td11"> <span -class="ec-lmvtt-10">password </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-50-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-50-3" + style="vertical-align:baseline;" id="TBL-56-50-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-50-1" +class="td01"><span +class="ec-lmvtt-10">password </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-50-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-50-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-50-4" -class="td11"> text field is ‘password’ style </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-50-4" +class="td10"> text field is ‘password’ style </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-51-1" -class="td11"> <span -class="ec-lmvtt-10">popdown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-51-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-51-3" + style="vertical-align:baseline;" id="TBL-56-51-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-51-1" +class="td01"><span +class="ec-lmvtt-10">popdown </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-51-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-51-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-51-4" -class="td11"> choice list is ‘popdown’ style </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-51-4" +class="td10"> choice list is ‘popdown’ style </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-52-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-52-1" -class="td11"> <span -class="ec-lmvtt-10">radio </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-52-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-52-3" + style="vertical-align:baseline;" id="TBL-56-52-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-52-1" +class="td01"><span +class="ec-lmvtt-10">radio </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-52-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-52-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-52-4" -class="td11"> choice list is ‘radio’ style </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-52-4" +class="td10"> choice list is ‘radio’ style </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-53-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-53-1" -class="td11"> <span -class="ec-lmvtt-10">radiosymbol </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-53-2" -class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-53-3" + style="vertical-align:baseline;" id="TBL-56-53-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-53-1" +class="td01"><span +class="ec-lmvtt-10">radiosymbol </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-53-2" +class="td11"> char </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-53-3" class="td11"> <span class="ec-lmri-10">H (</span><span class="pzdr-">★</span><span -class="ec-lmri-10">) </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-53-4" -class="td11"> symbol used for radio fields (ZapfDingbats), </td> -</tr><tr - style="vertical-align:baseline;" id="TBL-55-54-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-54-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-54-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-54-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-54-4" -class="td11"> the value is a character or <span +class="ec-lmri-10">) </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-53-4" +class="td10"> symbol used for radio fields (ZapfDingbats),</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-56-54-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-54-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-54-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-54-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-54-4" +class="td10"> the value is a character or <span class="ec-lmvtt-10">\ding</span><span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">{</span></span></span><span class="ec-lmvtto-10">number</span><span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">}</span></span></span>, </td> +class="ec-lmvtt-10">}</span></span></span>, </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-55-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-55-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-55-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-55-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-55-4" -class="td11"> see package <span + style="vertical-align:baseline;" id="TBL-56-55-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-55-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-55-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-55-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-55-4" +class="td10"> see package <span class="ec-lmss-10">pifont </span>from bundle <span -class="ec-lmss-10">psnfss </span></td> +class="ec-lmss-10">psnfss </span></td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-56-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-56-1" -class="td11"> <span -class="ec-lmvtt-10">readonly </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-56-2" -class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-56-3" + style="vertical-align:baseline;" id="TBL-56-56-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-56-1" +class="td01"><span +class="ec-lmvtt-10">readonly </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-56-2" +class="td11"> boolean </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-56-3" class="td11"> <span -class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-56-4" -class="td11"> field is readonly </td> +class="ec-lmri-10">false </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-56-4" +class="td10"> field is readonly </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-57-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-57-1" -class="td11"> <span -class="ec-lmvtt-10">rotation </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-57-2" -class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-57-3" + style="vertical-align:baseline;" id="TBL-56-57-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-57-1" +class="td01"><span +class="ec-lmvtt-10">rotation </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-57-2" +class="td11"> number </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-57-3" class="td11"> <span -class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-57-4" -class="td11"> rotation of the widget annotation </td> -<td id="TBL-55-57-5" -class="td10"> </td> +class="ec-lmri-10">0 </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-57-4" +class="td10"> rotation of the widget annotation </td> +<td id="TBL-56-57-5" +class="td00"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-58-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-58-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-58-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-58-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-59-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-59-1" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-59-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-59-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-59-4" -class="td11"> (degree, counterclockwise, multiple of 90) </td> + style="vertical-align:baseline;" id="TBL-56-59-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-59-1" +class="td01"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-59-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-59-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-59-4" +class="td10"> (degree, counterclockwise, multiple of 90) </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-60-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-60-1" -class="td11"> <span -class="ec-lmvtt-10">tabkey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-60-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-60-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-60-4" -class="td11"> (as per HTML) </td> + style="vertical-align:baseline;" id="TBL-56-60-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-60-1" +class="td01"><span +class="ec-lmvtt-10">tabkey </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-60-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-60-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-60-4" +class="td10"> (as per HTML) </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-61-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-61-1" -class="td11"> <span -class="ec-lmvtt-10">validate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-61-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-61-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-61-4" -class="td11"> JavaScript code to validate the entry </td> + style="vertical-align:baseline;" id="TBL-56-61-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-61-1" +class="td01"><span +class="ec-lmvtt-10">validate </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-61-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-61-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-61-4" +class="td10"> JavaScript code to validate the entry </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-62-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-62-1" -class="td11"> <span -class="ec-lmvtt-10">value </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-62-2" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-62-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-62-4" -class="td11"> initial value </td> + style="vertical-align:baseline;" id="TBL-56-62-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-62-1" +class="td01"><span +class="ec-lmvtt-10">value </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-62-2" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-62-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-62-4" +class="td10"> initial value </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-63-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-63-1" -class="td11"> <span -class="ec-lmvtt-10">width </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-55-63-2" -class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-63-3" -class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-55-63-4" -class="td11"> width of field box </td> + style="vertical-align:baseline;" id="TBL-56-63-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-63-1" +class="td01"><span +class="ec-lmvtt-10">width </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-56-63-2" +class="td11"> dimen </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-63-3" +class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-56-63-4" +class="td10"> width of field box </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-64-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-64-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-64-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-64-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-65-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-65-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-65-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-65-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-66-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-66-1" -class="td11"> </td> + style="vertical-align:baseline;" id="TBL-56-66-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-66-1" +class="td01"> </td> </tr><tr - style="vertical-align:baseline;" id="TBL-55-67-"><td style="white-space:nowrap; text-align:left;" id="TBL-55-67-1" -class="td11"> </td></tr> + style="vertical-align:baseline;" id="TBL-56-67-"><td style="white-space:nowrap; text-align:left;" id="TBL-56-67-1" +class="td01"> </td></tr> </table></div> -<!--l. 1562--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">7 </span> <a - id="x1-230007"></a>Defining a new driver</h3> +<!--l. 2345--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-510008"></a>Defining a new driver</h3> +<!--l. 2346--><p class="noindent" >A hyperref driver has to provide definitions for eight macros: +<!--l. 2349--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyper@anchor</span></span></span> -<!--l. 1563--><p class="noindent" >A hyperref driver has to provide definitions for eight macros: -<!--l. 1566--><p class="noindent" >1. <span class="obeylines-h"><span class="verb"><span -class="ec-lmvtt-10">\hyper@anchor</span></span></span> -<!--l. 1568--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span +<!--l. 2351--><p class="noindent" >2. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@link</span></span></span> -<!--l. 1570--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span +<!--l. 2353--><p class="noindent" >3. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@linkfile</span></span></span> -<!--l. 1572--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span +<!--l. 2355--><p class="noindent" >4. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@linkurl</span></span></span> -<!--l. 1574--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span +<!--l. 2357--><p class="noindent" >5. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@anchorstart</span></span></span> -<!--l. 1576--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span +<!--l. 2359--><p class="noindent" >6. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@anchorend</span></span></span> -<!--l. 1578--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span +<!--l. 2361--><p class="noindent" >7. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@linkstart</span></span></span> -<!--l. 1580--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span +<!--l. 2363--><p class="noindent" >8. <span class="obeylines-h"><span class="verb"><span class="ec-lmvtt-10">\hyper@linkend</span></span></span> -<!--l. 1583--><p class="indent" > The draft option defines the macros as follows +<!--l. 2366--><p class="indent" > The draft option defines the macros as follows - <div class="verbatim" id="verbatim-23"> + <div class="verbatim" id="verbatim-41"> \let\hyper@@anchor\@gobble  <br />\gdef\hyper@link##1##2##3{##3}%  <br />\def\hyper@linkurl##1##2{##1}% @@ -5014,11 +6031,11 @@ class="ec-lmvtt-10">\hyper@linkend</span></span></span>  <br />\let\hyper@linkstart\@gobbletwo  <br />\let\hyper@linkend\@empty </div> -<!--l. 1593--><p class="nopar" > -<!--l. 1595--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">8 </span> <a - id="x1-240008"></a>Special support for other packages</h3> -<!--l. 1597--><p class="noindent" >Package <span +<!--l. 2376--><p class="nopar" > +<!--l. 2378--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-520009"></a>Special support for other packages</h3> +<!--l. 2380--><p class="noindent" >Package <span class="ec-lmss-10">hyperref </span>aims to cooperate with other packages, but there are several possible sources for conflict, such as <ul class="itemize1"> @@ -5041,7 +6058,7 @@ class="ec-lmvtt-10">implicit=false </span>for these packages to work. </li> <li class="itemize">Packages that do anything serious with the index.</li></ul> -<!--l. 1617--><p class="indent" > The <span +<!--l. 2400--><p class="indent" > The <span class="ec-lmss-10">hyperref </span>package is distributed with variants on two useful packages designed to work especially well with it. These are <span class="ec-lmss-10">xr </span>and <span @@ -5049,10 +6066,966 @@ class="ec-lmss-10">minitoc</span>, which support crossdocument links using <span <span class="ec-lmvtt-10">\label</span>/<span class="ec-lmvtt-10">\ref </span>mechanisms and per-chapter tables of contents, respectively. -<!--l. 1623--><p class="noindent" > - <h3 class="sectionHead"><span class="titlemark">9 </span> <a - id="x1-250009"></a>History and acknowledgments</h3> -<!--l. 1625--><p class="noindent" >The original authors of <span +<!--l. 2407--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.1 </span> <a + id="x1-530009.1"></a>Package Compatibility</h4> +<!--l. 2409--><p class="noindent" >Currently only package loading orders are available: +<!--l. 2413--><p class="indent" > Note: hyperref loads package "nameref" at <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\begin{document}</span></span></span>. Sometimes this is too late, thus this +package must be loaded earlier. +<!--l. 2418--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.1 </span> <a + id="x1-540009.1.1"></a>algorithm</h5> + + + <div class="verbatim" id="verbatim-42"> + \usepackage{float} + <br />  \usepackage{hyperref} + <br />  \usepackage[chapter]{algorithm}% eg. +</div> +<!--l. 2423--><p class="nopar" > +<!--l. 2425--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.2 </span> <a + id="x1-550009.1.2"></a>amsmath</h5> +<!--l. 2427--><p class="noindent" >The environments equation and eqnarray are not supported too well. For example, there might be +spacing problems (eqnarray isn’t recommended anyway, see CTAN:info/l2tabu/, the situation for +equation is unclear, because nobody is interested in investigating). Consider using the environments that +package amsmath provide, e.g. gather for equation. The environment equation can even redefined to use +gather: + + + <div class="verbatim" id="verbatim-43"> +  \usepackage{amsmath} + <br />  \let\equation\gather + <br />  \let\endequation\endgather +</div> +<!--l. 2438--><p class="nopar" > +<!--l. 2440--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.3 </span> <a + id="x1-560009.1.3"></a>amsrefs</h5> +<!--l. 2442--><p class="noindent" >Package loading order: + + + <div class="verbatim" id="verbatim-44"> +  \usepackage{hyperref} + <br />  \usepackage{amsrefs} +</div> +<!--l. 2447--><p class="nopar" > +<!--l. 2449--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.4 </span> <a + id="x1-570009.1.4"></a>arydshln, longtable</h5> +<!--l. 2451--><p class="noindent" >Package longtable must be put before hyperref and arydshln, hyperref after arydshln generates an error, +thus the resulting package order is then: + + + <div class="verbatim" id="verbatim-45"> +  \usepackage{longtable} + <br />  \usepacakge{hyperref} + <br />  \usepackage{arydshln} +</div> +<!--l. 2459--><p class="nopar" > +<!--l. 2461--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.5 </span> <a + id="x1-580009.1.5"></a>babel/magyar.ldf</h5> +<!--l. 2463--><p class="noindent" >The old version 2005/03/30 v1.4j will not work. You need at least version 1.5, maintained by Péter +Szabó, see CTAN:language/hungarian/babel/. +<!--l. 2468--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.6 </span> <a + id="x1-590009.1.6"></a>babel/spanish.ldf</h5> +<!--l. 2470--><p class="noindent" >Babel’s spanish.ldf redefines ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\.</span></span></span>’ to support ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\...</span></span></span>’. In bookmarks (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfstringdef</span></span></span>) only ‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\.</span></span></span>’ is supported. If +‘<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\...</span></span></span>’ is needed, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\texorpdfstring{\...}{\dots}</span></span></span> can be used instead. +<!--l. 2477--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.7 </span> <a + id="x1-600009.1.7"></a>bibentry</h5> +<!--l. 2479--><p class="noindent" >Workaround: + + + <div class="verbatim" id="verbatim-46"> +  \makeatletter + <br />  \let\saved@bibitem\@bibitem + <br />  \makeatother + <br /> + <br />  \usepackage{bibentry} + <br />  \usepackage{hyperref} + <br /> + <br />  \begin{document} + <br /> + <br />  \begingroup + <br />    \makeatletter + <br />    \let\@bibitem\saved@bibitem + <br />    \nobibliography{database} + <br />  \endgroup +</div> +<!--l. 2496--><p class="nopar" > +<!--l. 2498--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.8 </span> <a + id="x1-610009.1.8"></a>bigfoot</h5> +<!--l. 2500--><p class="noindent" >Hyperref does not support package ‘bigfoot’. And package ‘bigfoot’ does not support hyperref’s footnotes +and disables them (hyperfootnotes=false). +<!--l. 2505--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.9 </span> <a + id="x1-620009.1.9"></a>chappg</h5> +<!--l. 2507--><p class="noindent" >Package ‘chappg’ uses <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> that is redefined by ‘hyperref’. The package order is +therefore: + + + <div class="verbatim" id="verbatim-47"> +  \usepackage{hyperref} + <br />  \usepackage{chappg} +</div> +<!--l. 2513--><p class="nopar" > +<!--l. 2515--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.10 </span> <a + id="x1-630009.1.10"></a>cite</h5> +<!--l. 2517--><p class="noindent" >This is from Mike Shell: cite.sty cannot currently be used with hyperref. However, I can do a workaround +via: + + + <div class="verbatim" id="verbatim-48"> + \makeatletter + <br /> \def\NAT@parse{\typeout{This is a fake Natbib command to fool Hyperref.}} + <br /> \makeatother + <br /> + <br /> \usepackage[hypertex]{hyperref} +</div> +<!--l. 2527--><p class="nopar" > +<!--l. 2529--><p class="indent" > so that hyperref will not redefine any of the biblabel stuff - so cite.sty will work as normal - +although the citations will not be hyperlinked, of course (But this may not be an issue for many +people). +<!--l. 2534--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.11 </span> <a + id="x1-640009.1.11"></a>count1to</h5> +<!--l. 2536--><p class="noindent" >Package ‘count1to’ adds several <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> commands that confuse ‘hyperref’. Therefore <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\theH<...></span></span></span> +has to be fixed: + + + <div class="verbatim" id="verbatim-49"> +  \usepackage{count1to} + <br />  \AtBeginDocument{% *after* \usepackage{count1to} + <br />    \renewcommand*{\theHsection}{\theHchapter.\arabic{section}}% + <br />    \renewcommand*{\theHsubsection}{\theHsection.\arabic{subsection}}% + <br />    \renewcommand*{\theHsubsubsection}{\theHsubsection.\arabic{subsubsection}}% + <br />    \renewcommand*{\theHparagraph}{\theHsubsubsection.\arabic{paragraph}}% + <br />    \renewcommand*{\theHsubparagraph}{\theHparagraph.\arabic{subparagraph}}% + <br />  } +</div> +<!--l. 2548--><p class="nopar" > +<!--l. 2550--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.12 </span> <a + id="x1-650009.1.12"></a>dblaccnt</h5> +<!--l. 2552--><p class="noindent" >pd1enc.def or puenc.def should be loaded before: + + + <div class="verbatim" id="verbatim-50"> +  \usepackage{hyperref} + <br />  \usepackage{dblaccnt} +</div> +<!--l. 2556--><p class="nopar" > or see entry for "vietnam". +<!--l. 2560--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.13 </span> <a + id="x1-660009.1.13"></a>easyeqn</h5> +<!--l. 2561--><p class="noindent" >Not compatible, breaks. +<!--l. 2564--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.14 </span> <a + id="x1-670009.1.14"></a>ellipsis</h5> +<!--l. 2566--><p class="noindent" >This packages redefines <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\textellipsis</span></span></span> after package hyperref (pd1enc.def/puenc.def should be loaded +before): + + + <div class="verbatim" id="verbatim-51"> +  \usepackage{hyperref} + <br />  \usepackage{ellipsis} +</div> +<!--l. 2571--><p class="nopar" > +<!--l. 2573--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.15 </span> <a + id="x1-680009.1.15"></a>float</h5> + + + <div class="verbatim" id="verbatim-52"> + \usepackage{float} + <br />  \usepackage{hyperref} +</div> +<!--l. 2577--><p class="nopar" > + <ul class="itemize1"> + <li class="itemize">Several <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\caption</span></span></span> commands are not supported inside one float object. + </li> + <li class="itemize">Anchor are set at top of the float object, if its style is controlled by float.sty.</li></ul> +<!--l. 2584--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.16 </span> <a + id="x1-690009.1.16"></a>endnotes</h5> +<!--l. 2585--><p class="noindent" >Unsupported. +<!--l. 2587--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.17 </span> <a + id="x1-700009.1.17"></a>foiltex</h5> +<!--l. 2588--><p class="noindent" >Update to version 2008/01/28 v2.1.4b: Since version 6.77a hyperref does not hack into <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@begindvi</span></span></span>, it +uses package ‘atbegshi’ instead, that hooks into <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\shipout</span></span></span>. Thus the patch of ‘foils.cls’ regarding hyperref +is now obsolete and causes an undefined error message about <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@hyperfixhead</span></span></span>. This is fixed in FoilTeX +2.1.4b. +<!--l. 2596--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.18 </span> <a + id="x1-710009.1.18"></a>footnote</h5> +<!--l. 2598--><p class="noindent" >This package is not supported, you have to disable hyperref’s footnote support by using option +"hyperfootnotes=false". +<!--l. 2602--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.19 </span> <a + id="x1-720009.1.19"></a>geometry</h5> +<!--l. 2604--><p class="noindent" >Driver ‘dvipdfm’ and program ‘dvipdfm’ might generate a warning: Sorry. Too late to change page size +Then prefer the program ‘dvipdfmx’ or use one of the following workarounds to move the <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> of +geometry to an earlier location: + + + <div class="verbatim" id="verbatim-53"> +    \documentclass[dvipdfm]{article}% or other classes + <br />    \usepackage{atbegshi} + <br />    \AtBeginDocument{% + <br />      \let\OrgAtBeginDvi\AtBeginDvi + <br />      \let\AtBeginDvi\AtBeginShipoutFirst + <br />    } + <br />    \usepackage[ + <br />      paperwidth=170mm, + <br />      paperheight=240mm + <br />    ]{geometry} + <br />    \AtBeginDocument{% + <br />      \let\AtBeginDvi\OrgAtBeginDvi + <br />    } + <br />    \usepackage{hyperref} + <br /> + <br />  or + <br /> + <br />    \documentclass[dvipdfm]{article}% or other classes + <br />    \usepackage{atbegshi} + <br />    \let\AtBeginDvi\AtBeginShipoutFirst + <br />    \usepackage[ + <br />      paperwidth=170mm, + <br />      paperheight=240mm + <br />    ]{geometry} + <br />    \usepackage{hyperref} +</div> +<!--l. 2636--><p class="nopar" > +<!--l. 2638--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.20 </span> <a + id="x1-730009.1.20"></a>IEEEtran.cls</h5> +<!--l. 2640--><p class="noindent" >version >= V1.6b (because of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@makecaption</span></span></span>, see ChangeLog) +<!--l. 2643--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.21 </span> <a + id="x1-740009.1.21"></a>index</h5> +<!--l. 2645--><p class="noindent" >version >= 1995/09/28 v4.1 (because of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\addcontentsline</span></span></span> redefinition) +<!--l. 2648--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.22 </span> <a + id="x1-750009.1.22"></a>lastpage</h5> +<!--l. 2650--><p class="noindent" >Compatible. +<!--l. 2653--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.23 </span> <a + id="x1-760009.1.23"></a>linguex</h5> + + + <div class="verbatim" id="verbatim-54"> + \usepackage{hyperref} + <br />  \usepackage{linguex} +</div> +<!--l. 2657--><p class="nopar" > +<!--l. 2659--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.24 </span> <a + id="x1-770009.1.24"></a>ltabptch</h5> + + + <div class="verbatim" id="verbatim-55"> + \usepackage{longtable} + <br />  \usepackage{ltabptch} + <br />  \usepackage{hyperref} +</div> +<!--l. 2664--><p class="nopar" > +<!--l. 2666--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.25 </span> <a + id="x1-780009.1.25"></a>mathenv</h5> +<!--l. 2668--><p class="noindent" >Unsupported. +<!--l. 2672--><p class="indent" > Both ‘mathenv’ and ‘hyperref’ messes around with environment ‘eqnarray’. You can load ‘mathenv’ +after ‘hyperref’ to avoid an error message. But <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span> will not work inside environment ‘eqnarray’ +properly, for example. +<!--l. 2679--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.26 </span> <a + id="x1-790009.1.26"></a>minitoc-hyper</h5> +<!--l. 2681--><p class="noindent" >This package is obsolete, use the uptodate original package minitoc instead. +<!--l. 2685--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.27 </span> <a + id="x1-800009.1.27"></a>multind</h5> + + + <div class="verbatim" id="verbatim-56"> + \usepackage{multind} + <br />  \usepackage{hyperref} +</div> +<!--l. 2689--><p class="nopar" > +<!--l. 2691--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.28 </span> <a + id="x1-810009.1.28"></a>natbib</h5> + + + <div class="verbatim" id="verbatim-57"> + \usepackage{natbib} + <br />  \usepackage{hyperref} +</div> +<!--l. 2695--><p class="nopar" > +<!--l. 2697--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.29 </span> <a + id="x1-820009.1.29"></a>nomencl</h5> +<!--l. 2698--><p class="noindent" >Example for introducing links for the page numbers: + + + <div class="verbatim" id="verbatim-58"> +      \renewcommand*{\pagedeclaration}[1]{\unskip, \hyperpage{#1}} +</div> +<!--l. 2701--><p class="nopar" > +<!--l. 2704--><p class="indent" > For equations the following might work: + + + <div class="verbatim" id="verbatim-59"> +      \renewcommand*{\eqdeclaration}[1]{% + <br />        \hyperlink{equation.#1}{(Equation~#1)}% + <br />      } + <br />    But the mapping from the equation number to the anchor name + <br />    is not available in general. +</div> +<!--l. 2711--><p class="nopar" > +<!--l. 2713--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.30 </span> <a + id="x1-830009.1.30"></a>parskip</h5> + + + <div class="verbatim" id="verbatim-60"> + \usepackage{parskip} + <br />  \usepackage{hyperref}[2012/08/20] +</div> +<!--l. 2717--><p class="nopar" > +<!--l. 2720--><p class="indent" > Both packages want to redefine <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@starttoc</span></span></span>. +<!--l. 2723--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.31 </span> <a + id="x1-840009.1.31"></a>prettyref</h5> + + + <div class="verbatim" id="verbatim-61"> +%%% example for prettyref %%% + <br />\documentclass{article} + <br />\usepackage{prettyref} + <br />\usepackage[pdftex]{hyperref} + <br /> + <br />%\newrefformat{FIG}{Figure~\ref{#1}}% without hyperref + <br />\newrefformat{FIG}{\hyperref[{#1}]{Figure~\ref*{#1}}} + <br /> + <br />\begin{document} + <br />  This is a reference to \prettyref{FIG:ONE}. + <br />  \newpage + <br />  \begin{figure} + <br />    \caption{This is my figure} + <br />    \label{FIG:ONE} + <br />  \end{figure} + <br />\end{document} + <br />%%% example for prettyref %%% + <br />       +</div> +<!--l. 2742--><p class="nopar" > +<!--l. 2744--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.32 </span> <a + id="x1-850009.1.32"></a>ntheorem</h5> + + + <div class="verbatim" id="verbatim-62"> + ntheorem-hyper.sty is an old patched version of ntheorem.sty. + <br />  Newer versions of ntheorem know the option hyperref: + <br />    \usepackage{hyperref} + <br />    \usepackage[hyperref]{ntheorem} + <br />  But there are still unsolved problems (options thref, ...). +</div> +<!--l. 2751--><p class="nopar" > +<!--l. 2753--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.33 </span> <a + id="x1-860009.1.33"></a>setspace</h5> + + + <div class="verbatim" id="verbatim-63"> + \usepackage{setspace} + <br />  \usepackage{hyperref} +</div> +<!--l. 2757--><p class="nopar" > +<!--l. 2759--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.34 </span> <a + id="x1-870009.1.34"></a>sidecap</h5> + + + <div class="verbatim" id="verbatim-64"> + Before 2002/05/24 v1.5h: + <br />    \usepackage{nameref} + <br />    \usepackage{hyperref} + <br />    \usepackage{sidecap} +</div> +<!--l. 2765--><p class="nopar" > +<!--l. 2767--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.35 </span> <a + id="x1-880009.1.35"></a>subfigure</h5> + + + <div class="verbatim" id="verbatim-65"> + 1995/03/06 v2.0: + <br />    \usepackage{subfigure} + <br />    \usepackage{hyperref} + <br />    % hypertexnames is set to false. + <br />  v2.1: + <br />    \usepackage{nameref} + <br />    \usepackage{subfigure} + <br />    \usepackage{hyperref} + <br />    or + <br />    \usepackage{hyperref} + <br />    \usepackage{subfigure} + <br />  v2.1.2: + <br />    please update + <br />  v2.1.3: + <br />    \usepackage{hyperref} + <br />    \usepackage{subfigure} + <br />    or vice versa? +</div> +<!--l. 2786--><p class="nopar" > +<!--l. 2788--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.36 </span> <a + id="x1-890009.1.36"></a>titleref</h5> + + + <div class="verbatim" id="verbatim-66"> + \usepackage{nameref} + <br />  \usepackage{titleref}% without usetoc + <br />  \usepackage{hyperref} +</div> +<!--l. 2793--><p class="nopar" > +<!--l. 2795--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.37 </span> <a + id="x1-900009.1.37"></a>tabularx</h5> +<!--l. 2797--><p class="noindent" >Linked footnotes are not supported inside environment ‘tabularx’, because they uses the optional +argument of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span>, see section ‘Limitations’. Before version 2011/09/28 6.82i hyperref had +disabled footnotes entirely by ‘hyperfootnotes=false’. +<!--l. 2803--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.38 </span> <a + id="x1-910009.1.38"></a>titlesec</h5> +<!--l. 2805--><p class="noindent" >"nameref" supports titlesec, but hyperref does not (unsolved is the anchor setting, missing with +unnumbered section, perhaps problems with page breaks with numbered ones). +<!--l. 2810--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.39 </span> <a + id="x1-920009.1.39"></a>ucs/utf8x.def</h5> +<!--l. 2812--><p class="noindent" >The first time a multibyte UTF8 sequence is called, it does some calculations and stores the result in a +macro for speeding up the next calls of that UTF8 sequence. However this makes the first call +non-expandable and will break if used in information entries or bookmarks. Package "ucs" offers +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\PrerenderUnicode</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\PreloadUnicodePage</span></span></span> to solve this: + + + <div class="verbatim" id="verbatim-67"> +    \usepackage{ucs} + <br />    \usepackage[utf8x]{inputenc} + <br />    \usepackage{hyperref}% or with option unicode + <br />    \PrerenderUnicode{^^c3^^b6}% or \PrerenderUnicodePage{1} + <br />    \hypersetup{pdftitle={Umlaut example: ^^c3^^b6}} +</div> +<!--l. 2825--><p class="nopar" > The notation with two carets avoids trouble with 8-bit bytes for the README file, you can use the +characters directly. +<!--l. 2830--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.40 </span> <a + id="x1-930009.1.40"></a>varioref</h5> +<!--l. 2831--><p class="noindent" >There are too many problems with varioref. Nobody has time to sort them out. Therefore this package is +now unsupported. +<!--l. 2835--><p class="indent" > Perhaps you are lucky and some of the features of varioref works with the following loading +order: + + + <div class="verbatim" id="verbatim-68"> +    \usepackage{nameref} + <br />    \usepackage{varioref} + <br />    \usepackage{hyperref} +</div> +<!--l. 2841--><p class="nopar" > +<!--l. 2844--><p class="indent" > 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. +<!--l. 2850--><p class="indent" > Also unsupported: + <ul class="itemize1"> + <li class="itemize"><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\Ref</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\Vref</span></span></span> do not uppercase the first letter. + </li> + <li class="itemize"><span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\vpageref[]{...}</span></span></span> On the same page a previous space is not suppressed.</li></ul> +<!--l. 2857--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.41 </span> <a + id="x1-940009.1.41"></a>verse</h5> +<!--l. 2859--><p class="noindent" >Version 2005/08/22 v2.22 contains support for hyperref. +<!--l. 2861--><p class="indent" > For older versions see example from de.comp.text.tex (2005/08/11, slightly modified): + + + <div class="verbatim" id="verbatim-69"> +  \documentclass{article} + <br /> + <br />  % package order does not matter + <br />  \usepackage{verse} + <br />  \usepackage{hyperref} + <br /> + <br />  \makeatletter + <br />  % make unique poemline anchors + <br />  \newcounter{verse@env} + <br />  \setcounter{verse@env}{0} + <br />  \let\org@verse\verse + <br />  \def\verse{% + <br />    \stepcounter{verse@env}% + <br />    \org@verse + <br />  } + <br />  \def\theHpoemline{\arabic{verse@env}.\thepoemline} + <br /> + <br />  % add anchor for before \addcontentsline in \@vsptitle + <br />  \let\org@vsptitle\@vsptitle + <br />  \def\@vsptitle{% + <br />    \phantomsection + <br />    \org@vsptitle + <br />  } + <br />  \makeatother + <br /> + <br />  \begin{document} + <br /> + <br />  \poemtitle{Poem 1} + <br />  \begin{verse} + <br />  An one-liner. + <br />  \end{verse} + <br /> + <br />  \newpage + <br /> + <br />  \poemtitle{Poem 2} + <br />  \begin{verse} + <br />  Another one-liner. + <br />  \end{verse} + <br /> + <br />  \end{document} +</div> +<!--l. 2905--><p class="nopar" > +<!--l. 2907--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.42 </span> <a + id="x1-950009.1.42"></a>vietnam</h5> + + + <div class="verbatim" id="verbatim-70"> + % pd1enc.def should be loaded before package dblaccnt: + <br />  \usepackage[PD1,OT1]{fontenc} + <br />  \usepackage{vietnam} + <br />  \usepackage{hyperref} +</div> +<!--l. 2913--><p class="nopar" > +<!--l. 2915--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">9.1.43 </span> <a + id="x1-960009.1.43"></a>XeTeX</h5> +<!--l. 2917--><p class="noindent" >Default for the encoding of bookmarks is ‘pdfencoding=auto’. That means the strings are always treated +as unicode strings. Only if the string restricts to the printable ASCII set, it is written as ASCII string. +The reason is that the <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\special</span></span></span> does not support PDFDocEncoding. +<!--l. 2925--><p class="indent" > XeTeX uses the program xdvipdfmx for PDF output generation. This program behaves a little +different from dvipdfm, because of the supported Unicode characters. Strings for bookmarks or +information entries can be output directly. The big chars (char code > 255) are written in UTF-8 and +xdvipdfmx tries to convert them to UTF-16BE. However hyperref already provides PDF strings encoded +in UTF-16BE, thus the result is a warning +<!--l. 2934--><p class="indent" > "Failed to convert input string to UTF16..." +<!--l. 2936--><p class="indent" > The best way would be, if xdvipdfm could detect the byte order marker (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\376\377</span></span></span>) and skips the +conversion if that marker is present. +<!--l. 2940--><p class="indent" > For the time being I added the following to hyperref, when option ‘pdfencoding=auto’ is set (default +for XeTeX): The string is converted back to big characters thus that the string is written as UTF-8. But +I am very unhappy with this solution. Main disadvantage: Two versions of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfstringdef</span></span></span> are +needed: +<!--l. 2947--><p class="indent" > a) The string is converted back to big characters for the "tainted keys" of xdvipdfmx +(<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">spc_pdfm.c:</span><span +class="ec-lmvtt-10"> default_taintkeys</span></span></span>). The subset hyperref uses is /Title, /Author, /Subject, +/Keywords, /Creator, /Producer, /T. Any changes of this set in xdvipdfmx cannot be detected by +hyperref. +<!--l. 2953--><p class="indent" > b) Without conversion for the other strings , providing UTF16be directly. Examples: Prefix of page +labels, some elements of formulars. +<!--l. 2957--><p class="indent" > Thus <span +class="ec-lmbx-10">each </span>application that uses <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfstringdef</span></span></span> now must check, if it defines a string +for some of the tained keys. If yes, then the call of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\pdfstringdef</span></span></span> should be preceded by +"<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\csname</span><span +class="ec-lmvtt-10"> HyPsd@XeTeXBigCharstrue\endcsname</span></span></span>". Example: package bookmark. +<!--l. 2965--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">10 </span> <a + id="x1-9700010"></a>Limitations<span class="footnote-mark"><a +href="manual5.html#fn4x0"><sup class="textsuperscript">4</sup></a></span><a + id="x1-97001f4"></a> </h3> + <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a + id="x1-9800010.1"></a>Wrapped/broken link support</h4> +<!--l. 2968--><p class="noindent" >Only few drivers support automatically wrapped/broken links, e.g. pdftex, dvipdfm, hypertex. Other +drivers lack this feature, e.g. dvips, dvipsone. +<!--l. 2972--><p class="indent" > Workarounds: + + + <ul class="itemize1"> + <li class="itemize">For long section or caption titles in the table of contents or list of figures/tables option + "linktocpage" can be used. Then the page number will be a link, and the overlong section + title is not forced into an one line link with overfull <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hbox</span></span></span> warning. + </li> + <li class="itemize">"<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\url</span></span></span>"s are caught by package "breakurl". + </li> + <li class="itemize">The option "breaklinks" is intended for internal use. But it can be used to force link wrapping, + e.g. when printing a document. However, when such a document is converted to PDF and + viewed with a PDF viewer, the active link area will be misplaced. + <!--l. 2986--><p class="noindent" >Another limitation: some penalties are "optimized" by TeX, thus there are missing break + points, especially within <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\url</span></span></span>. (See thread "hyperref.sty, breaklinks and url.sty 3.2" in + comp.text.tex 2005-09).</li></ul> +<!--l. 2992--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a + id="x1-9900010.2"></a>Links across pages</h4> +<!--l. 2994--><p class="noindent" >In general they have problems: + <ul class="itemize1"> + <li class="itemize">Some driver doesn’t support them at all (see above). + </li> + <li class="itemize">The driver allows it, but the link result might include the footer and/or header, or an error + message can occur sometimes.</li></ul> +<!--l. 3002--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a + id="x1-10000010.3"></a>Footnotes</h4> +<!--l. 3004--><p class="noindent" >LaTeX allows the separation of the footnote mark and the footnote text (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span>, +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span>). This interface might be enough for visual typesetting. But the relation between +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> to <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span> is not as strong as <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\ref</span></span></span> to <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\label</span></span></span>. Therefore it is not clear in general +which <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> references which <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span>. But that is necessary to implement hyperlinking. +Thus the implementation of hyperref does not support the optional argument of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark\verb</span></span></span> +and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span>. +<!--l. 3015--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">11 </span> <a + id="x1-10100011"></a>Hints<span class="footnote-mark"><a +href="manual6.html#fn5x0"><sup class="textsuperscript">5</sup></a></span><a + id="x1-101001f5"></a> </h3> + <h4 class="subsectionHead"><span class="titlemark">11.1 </span> <a + id="x1-10200011.1"></a>Spaces in option values</h4> +<!--l. 3019--><p class="noindent" >Unhappily LaTeX strips spaces from options if they are given in <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\documentclass</span></span></span> or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\usepackage</span></span></span> (or +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\RequirePackage</span></span></span>), e.g.: + + + <div class="verbatim" id="verbatim-71"> +    \usepackage[pdfborder=0 0 1]{hyperref} +</div> +<!--l. 3023--><p class="nopar" > Package hyperref now gets + + + <div class="verbatim" id="verbatim-72"> +    pdfborder=001 +</div> +<!--l. 3027--><p class="nopar" > and the result is an invalid PDF file. As workaround braces can be used: + + + <div class="verbatim" id="verbatim-73"> +    \usepackage[pdfborder={0 0 1}]{hyperref} +</div> +<!--l. 3032--><p class="nopar" > Some options can also be given in + + + <div class="verbatim" id="verbatim-74"> +\hypersetup| + <br />\begin{verbatim} + <br />    \hypersetup{pdfborder=0 0 1} +</div> +<!--l. 3036--><p class="nopar" > In <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hypersetup</span></span></span> the options are directly processed as key value options (see package keyval) without +space stripping in the value part. +<!--l. 3042--><p class="indent" > Alternatively, LaTeX’s option handling system can be adapted to key value options by +one of the packages "kvoptions-patch" (from project "kvoptions") or "xkvltxp" (from project +"xsetkeys"). +<!--l. 3047--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.2 </span> <a + id="x1-10300011.2"></a>Index with makeindex</h4> + <ul class="itemize1"> + <li class="itemize">Package hyperref adds <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> commands by the encap mechanism (see documentation + of Makeindex), if option hyperindex is set (default). <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> uses the page anchors that + are set by hyperref at each page (default). However in the default case page numbers are used + in anchor names in arabic form. If the page numbers in other formats are used (book class + with <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\frontmatter</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\romannumbering</span></span></span>, ...), then the page anchors are not unique. Therefore + option "plainpages=false" is recommended. + </li> + <li class="itemize">The encap mechanism of Makeindex allows to use one command only (see documentation of + Makeindex). If the user sets such a command, hyperref suppresses its <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> command. With + logical markup this situation can easily be solved: + + + <div class="verbatim" id="verbatim-75"> +       \usepackage{makeidx} +  <br />      \makeindex +  <br />      \usepackage[hyperindex]{hyperref} +  <br />      \newcommand*{\main}[1]{\textbf{\hyperpage{#1}}} +  <br />      ... +  <br />      \index{Some example|main} +</div> + <!--l. 3071--><p class="nopar" > + </li> + <li class="itemize">Scientic Word/Scientific WorkPlace users can use package robustindex with hyperindex=false. + </li> + <li class="itemize">Other encap characters can be set by option "encap". Example for use of "?": + + + <div class="verbatim" id="verbatim-76"> +       \usepackage[encap=?]{hyperref} +</div> + <!--l. 3078--><p class="nopar" > + </li> + <li class="itemize">An other possibility is the insertion of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> by a style file for makeindex. For this case, + hyperref’s insertion will be disabled by "hyperindex=false". <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\hyperpage</span></span></span> will be defined regardless + of setting of hyperindex. + + + <div class="verbatim" id="verbatim-77"> + %%% cut %%% hyperindex.ist %%% cut %%% +  <br />delim_0 ", \\hyperpage{" +  <br />delim_1 ", \\hyperpage{" +  <br />delim_2 ", \\hyperpage{" +  <br />delim_n "}, \\hyperpage{" +  <br />delim_t "}" +  <br />encap_prefix "}\\" +  <br />encap_infix "{\\hyperpage{" +  <br />encap_suffix "}" +  <br />%%% cut %%% hyperindex.ist %%% cut %%% +</div> + <!--l. 3094--><p class="nopar" ></li></ul> +<!--l. 3097--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.3 </span> <a + id="x1-10400011.3"></a>Warning "bookmark level for unknown <foobar> defaults to 0"</h4> +<!--l. 3099--><p class="noindent" >Getting rid of it: + + + <div class="verbatim" id="verbatim-78"> +\makeatletter + <br />\providecommand*{\toclevel@<foobar>}{0} + <br />\makeatother +</div> +<!--l. 3104--><p class="nopar" > +<!--l. 3106--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.4 </span> <a + id="x1-10500011.4"></a>Link anchors in figures</h4> +<!--l. 3108--><p class="noindent" >The caption command increments the counter and here is the place where hyperref set the corresponding +anchor. Unhappily the caption is set below the figure, so the figure is not visible if a link jumps to a +figure. In this case, try package "hypcap.sty" that implements a method to circumvent the +problem. +<!--l. 3116--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.5 </span> <a + id="x1-10600011.5"></a>Additional unicode characters in bookmarks and pdf information entries:</h4> + + + <div class="verbatim" id="verbatim-79"> +\documentclass[pdftex]{article} + <br />\usepackage[unicode]{hyperref} +</div> +<!--l. 3120--><p class="nopar" > +<!--l. 3122--><p class="indent" > Support for additional unicode characters: +<!--l. 3124--><p class="indent" > Example: <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\.{a}</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\d{a}</span></span></span> +<!--l. 3126--><p class="indent" > 1. Get a list with unicode data, eg: +<!--l. 3128--><p class="indent" > http://www.unicode.org/Public/UNIDATA/UnicodeData.txt +<!--l. 3130--><p class="indent" > 2. Identify the characters (<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\.{a}</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\d{a}</span></span></span>): + + + <div class="verbatim" id="verbatim-80"> +    0227;LATIN SMALL LETTER A WITH DOT ABOVE;... + <br />    1EA1;LATIN SMALL LETTER A WITH DOT BELOW;... +</div> +<!--l. 3134--><p class="nopar" > +<!--l. 3136--><p class="indent" > 3. Calculate the octal code: +<!--l. 3138--><p class="indent" > The first characters of the line in the file are hex values, convert each byte and prepend them with a +backslash. (This will go into the PDF file.) + + + <div class="verbatim" id="verbatim-81"> +    0227 -> \002\047 + <br />    1EA1 -> \036\241 +</div> +<!--l. 3145--><p class="nopar" > +<!--l. 3147--><p class="indent" > 4. Transform into a form understood by hyperref: +<!--l. 3149--><p class="indent" > Hyperref must know where the first byte starts, this is marked by "9" (8 and 9 cannot occur in octal +numbers): + + + <div class="verbatim" id="verbatim-82"> +    \002\047 -> \9002\047 + <br />    \036\241 -> \9036\241 +</div> +<!--l. 3156--><p class="nopar" > +<!--l. 3158--><p class="indent" > Optional: "8" is used for abbreviations: + + + <div class="verbatim" id="verbatim-83"> +    \900 = \80, \901 = \81, \902 = \82, ... + <br /> + <br />    \9002\047 -> \82\047 +</div> +<!--l. 3164--><p class="nopar" > +<!--l. 3166--><p class="indent" > 5. Declare the character with LaTeX: + + + <div class="verbatim" id="verbatim-84"> +\DeclareTextCompositeCommand{\.}{PU}{a}{\82\047} + <br />\DeclareTextCompositeCommand{\d}{PU}{a}{\9036\241} + <br /> + <br />\begin{document} + <br />\section{\={a}, \d{a}, \’{a}, \.{a}} + <br />\end{document} + <br />       +</div> +<!--l. 3175--><p class="nopar" > +<!--l. 3177--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.6 </span> <a + id="x1-10700011.6"></a>Footnotes</h4> +<!--l. 3179--><p class="noindent" >The footnote support is rather limited. It is beyond the scope to use <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotetext</span></span></span> +out of order or reusing <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\footnotemark</span></span></span>. Here you can either disable hyperref’s footnote support by +"hyperfootnotes=false" or fiddle with internal macros, nasty examples: + + + <div class="verbatim" id="verbatim-85"> +\documentclass{article} + <br />\usepackage{hyperref} + <br />\begin{document} + <br />Hello% + <br />\footnote{The first footnote} + <br />World% + <br />\addtocounter{footnote}{-1}% + <br />\addtocounter{Hfootnote}{-1}% + <br />\footnotemark. + <br />\end{document} + <br /> + <br />  or + <br /> + <br />\documentclass{article} + <br /> + <br />\usepackage{hyperref} + <br /> + <br />\begin{document} + <br /> + <br />\makeatletter + <br /> + <br />A% + <br />  \footnotemark + <br />  \let\saved@Href@A\Hy@footnote@currentHref + <br />  % remember link name + <br />B% + <br />  \footnotemark + <br />  \let\saved@Href@B\Hy@footnote@currentHref + <br />b% + <br />  \addtocounter{footnote}{-1}% + <br />  \addtocounter{Hfootnote}{-1}% generate the same anchor + <br />  \footnotemark + <br />C% + <br />  \footnotemark + <br />  \let\saved@Href@C\Hy@footnote@currentHref + <br /> + <br />  \addtocounter{footnote}{-2}% + <br />  \let\Hy@footnote@currentHref\saved@Href@A + <br />\footnotetext{AAAA}% + <br />  \addtocounter{footnote}{1}% + <br />  \let\Hy@footnote@currentHref\saved@Href@B + <br />\footnotetext{BBBBB}% + <br />  \addtocounter{footnote}{1}% + <br />  \let\Hy@footnote@currentHref\saved@Href@C + <br />\footnotetext{CCCC}% + <br /> + <br />\end{document} +</div> +<!--l. 3233--><p class="nopar" > + +<!--l. 3235--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.7 </span> <a + id="x1-10800011.7"></a>Subordinate counters</h4> +<!--l. 3237--><p class="noindent" >Some counters do not have unique values and require the value of other counters to be unique. For +example, sections or figures might be numbered within chapters or <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\newtheorem</span></span></span> is used with an +optional counter argument. Internally LaTeX uses <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> to reset a counter in dependency to +another counter. Package hyperref hooks into <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> to catch this situation. Also <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\numberwithin</span></span></span> +of package amsmath is caught by hyperref. +<!--l. 3247--><p class="indent" > However, if the definition of subordinate counters take place before hyperref is loaded, the old +meaning of <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\@addtoreset</span></span></span> is called without hyperref’s additions. Then the companion counter macro +<span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\theH<counter></span></span></span> can be redefined accordingly. Or move the definition of subordinate counters after +hyperref is loaded. +<!--l. 3253--><p class="indent" > Example for <span class="obeylines-h"><span class="verb"><span +class="ec-lmvtt-10">\newtheorem</span></span></span>, problematic case: + + + <div class="verbatim" id="verbatim-86"> +    \newtheorem{corA}{CorollaryA}[section] + <br />    \usepackage{hyperref} +</div> +<!--l. 3257--><p class="nopar" > Solution a) + + + <div class="verbatim" id="verbatim-87"> +    \usepackage{hyperref} + <br />    \newtheorem{corA}{CorollaryA}[section} +</div> +<!--l. 3262--><p class="nopar" > Solution b) + + + <div class="verbatim" id="verbatim-88"> +    \newtheorem{corA}{CorollaryA}[section] + <br />    \usepackage{hyperref} + <br />    \newcommand*{\theHcorA}{\theHsection.\number\value{corA}} +</div> +<!--l. 3268--><p class="nopar" > +<!--l. 3270--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">12 </span> <a + id="x1-10900012"></a>History and acknowledgments</h3> +<!--l. 3272--><p class="noindent" >The original authors of <span class="ec-lmss-10">hyperbasics.tex </span>and <span class="ec-lmss-10">hypertex.sty</span>, from which this package descends, are Tanmoy Bhattacharya and Thorsten Ohl. Package <span @@ -5065,15 +7038,13 @@ Carlisle, T. V. Raman and Leslie Lamport for comments, requests, t get the package into its first useable state. Various other people are mentioned at the point in the source where I had to change the code in later versions because of problems they found. - - -<!--l. 1638--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has +<!--l. 3285--><p class="indent" > Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has made the package more robust. The days spent on Rev<span class="TEX">T<span class="E">E</span>X</span> are entirely due to him! The investigations of Bill Moss into the later versions including native PDF support uncovered a good many bugs, and his testing is appreciated. Hans Hagen provided a lot of insight into PDF. -<!--l. 1646--><p class="indent" > Berthold Horn provided help, encouragement and sponsorship for the <span +<!--l. 3293--><p class="indent" > Berthold Horn provided help, encouragement and sponsorship for the <span class="ec-lmss-10">dvipsone </span>and <span class="ec-lmss-10">dviwindo </span>drivers. Sergey Lesenko provided the changes needed for <span @@ -5087,14 +7058,14 @@ class="ec-lmss-10">hyper </span>package (developed in parallel with <span class="ec-lmss-10">hyperref</span>) showed me solutions for some problems. Hopefully the two packages will combine one day. -<!--l. 1655--><p class="indent" > The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and +<!--l. 3302--><p class="indent" > The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and ideas; Thomas Merz, whose book <span class="ec-lmri-10">Web Publishing with Acrobat/PDF </span>provided crucial insights; D. P. Story, whose detailed article about pdfmarks and forms solved many practical problems; and Hans Hagen, who explained how to do it in <span class="ec-lmss-10">pdftex</span>. -<!--l. 1661--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost. -<!--l. 1664--><p class="indent" > Especial extra thanks to David Carlisle for the <span +<!--l. 3308--><p class="indent" > Steve Peter recreated the manual source in July 2003 after it had been lost. +<!--l. 3311--><p class="indent" > Especial extra thanks to David Carlisle for the <span class="ec-lmss-10">backref </span>module, the ps2pdf and dviwindo support, frequent general rewrites of my bad code, and for working on changes to the <span class="ec-lmss-10">xr </span>package to suit @@ -5102,10 +7073,9 @@ class="ec-lmss-10">xr </span>package to suit class="ec-lmss-10">hyperref</span>. - <h3 class="sectionHead"><span class="titlemark">10 </span> <a - id="x1-2600010"></a>GNU Free Documentation License</h3> -<!--l. 6--><p class="noindent" >Version 1.2, November 2002<br -class="newline" /> + <h3 class="sectionHead"><span class="titlemark">13 </span> <a + id="x1-11000013"></a>GNU Free Documentation License</h3> +<!--l. 6--><p class="noindent" >Version 1.2, November 2002 <!--l. 9--><p class="indent" > Copyright <span class="lmsy-10">©</span> 2000,2001,2002 Free Software Foundation, Inc.<br class="newline" />59 Temple Place, Suite 330, Boston, MA 02111-1307 USA<br @@ -5113,7 +7083,7 @@ class="newline" />Everyone is permitted to copy and distribute verbatim copies o not allowed. <!--l. 15--><p class="noindent" > <h4 class="likesubsectionHead"><a - id="x1-2700010"></a>Preamble</h4> + id="x1-11100013"></a>Preamble</h4> <!--l. 17--><p class="noindent" >The purpose of this License is to make a manual, textbook, or other functional and useful document “free” in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for @@ -5129,8 +7099,8 @@ be used for any textual work, regardless of subject matter or whether it is publ printed book. We recommend this License principally for works whose purpose is instruction or reference. <!--l. 39--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a - id="x1-2800010.1"></a>Applicability and definitions</h4> + <h4 class="subsectionHead"><span class="titlemark">13.1 </span> <a + id="x1-11200013.1"></a>Applicability and definitions</h4> <!--l. 42--><p class="noindent" >This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under @@ -5152,9 +7122,9 @@ them. Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections +then there are none. -then there are none. <!--l. 75--><p class="indent" > The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 @@ -5194,8 +7164,8 @@ reference in this License, but only as regards disclaiming warranties: any other that these Warranty Disclaimers may have is void and has no effect on the meaning of this License. <!--l. 127--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a - id="x1-2900010.2"></a>Verbatim copying</h4> + <h4 class="subsectionHead"><span class="titlemark">13.2 </span> <a + id="x1-11300013.2"></a>Verbatim copying</h4> <!--l. 130--><p class="noindent" >You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this @@ -5203,14 +7173,14 @@ License. You may not use technical measures to obstruct or control the reading o copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section <a -href="#x1-3000010.3">10.3<!--tex4ht:ref: copying --></a>. +href="#x1-11400013.3">13.3<!--tex4ht:ref: copying --></a>. <!--l. 141--><p class="indent" > You may also lend copies, under the same conditions stated above, and you may publicly display copies. <!--l. 145--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a - id="x1-3000010.3"></a>Copying in quantity</h4> + <h4 class="subsectionHead"><span class="titlemark">13.3 </span> <a + id="x1-11400013.3"></a>Copying in quantity</h4> <!--l. 148--><p class="noindent" >If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document’s license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front @@ -5236,85 +7206,86 @@ public. redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document. <!--l. 184--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.4 </span> <a - id="x1-3100010.4"></a>Modifications</h4> + <h4 class="subsectionHead"><span class="titlemark">13.4 </span> <a + id="x1-11500013.4"></a>Modifications</h4> <!--l. 187--><p class="noindent" >You may copy and distribute a Modified Version of the Document under the conditions of sections <a -href="#x1-2900010.2">10.2<!--tex4ht:ref: verbatim --></a> +href="#x1-11300013.2">13.2<!--tex4ht:ref: verbatim --></a> and <a -href="#x1-3000010.3">10.3<!--tex4ht:ref: copying --></a> above, provided that you release the Modified Version under precisely this License, with the +href="#x1-11400013.3">13.3<!--tex4ht:ref: copying --></a> above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version: <!--l. 196--><p class="indent" > <ol class="enumerate1" > <li - class="enumerate" id="x1-31002x1">Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, + class="enumerate" id="x1-115002x1">Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission. </li> <li - class="enumerate" id="x1-31004x2">List on the Title Page, as authors, one or more persons or entities responsible for authorship + class="enumerate" id="x1-115004x2">List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement. </li> <li - class="enumerate" id="x1-31006x3">State on the Title page the name of the publisher of the Modified Version, as the publisher. + class="enumerate" id="x1-115006x3">State on the Title page the name of the publisher of the Modified Version, as the publisher. + </li> <li - class="enumerate" id="x1-31008x4">Preserve all the copyright notices of the Document. + class="enumerate" id="x1-115008x4">Preserve all the copyright notices of the Document. </li> <li - class="enumerate" id="x1-31010x5">Add an appropriate copyright notice for your modifications adjacent to the other copyright + class="enumerate" id="x1-115010x5">Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. </li> <li - class="enumerate" id="x1-31012x6">Include, immediately after the copyright notices, a license notice giving the public permission + class="enumerate" id="x1-115012x6">Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below. </li> <li - class="enumerate" id="x1-31014x7">Preserve in that license notice the full lists of Invariant Sections and required Cover Texts + class="enumerate" id="x1-115014x7">Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document’s license notice. </li> <li - class="enumerate" id="x1-31016x8">Include an unaltered copy of this License. + class="enumerate" id="x1-115016x8">Include an unaltered copy of this License. </li> <li - class="enumerate" id="x1-31018x9">Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at + class="enumerate" id="x1-115018x9">Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled “History” in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. </li> <li - class="enumerate" id="x1-31020x10">Preserve the network location, if any, given in the Document for public access to a + class="enumerate" id="x1-115020x10">Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the “History” section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. </li> <li - class="enumerate" id="x1-31022x11">For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the + class="enumerate" id="x1-115022x11">For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. </li> <li - class="enumerate" id="x1-31024x12">Preserve all the Invariant Sections of the Document, unaltered in their text and in their + class="enumerate" id="x1-115024x12">Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. </li> <li - class="enumerate" id="x1-31026x13">Delete any section Entitled “Endorsements”. Such a section may not be included in the + class="enumerate" id="x1-115026x13">Delete any section Entitled “Endorsements”. Such a section may not be included in the Modified Version. </li> <li - class="enumerate" id="x1-31028x14">Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with + class="enumerate" id="x1-115028x14">Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with any Invariant Section. </li> <li - class="enumerate" id="x1-31030x15">Preserve any Warranty Disclaimers. + class="enumerate" id="x1-115030x15">Preserve any Warranty Disclaimers. </li></ol> @@ -5336,11 +7307,11 @@ one. <!--l. 270--><p class="indent" > The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. <!--l. 275--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.5 </span> <a - id="x1-3200010.5"></a>Combining documents</h4> + <h4 class="subsectionHead"><span class="titlemark">13.5 </span> <a + id="x1-11600013.5"></a>Combining documents</h4> <!--l. 278--><p class="noindent" >You may combine the Document with other documents released under this License, under the terms defined in section <a -href="#x1-3100010.4">10.4<!--tex4ht:ref: modifications --></a> above for modified versions, provided that you include in the combination all of +href="#x1-11500013.4">13.4<!--tex4ht:ref: modifications --></a> above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers. @@ -5355,8 +7326,8 @@ documents, forming one section Entitled “History”; likewise combine “Acknowledgements”, and any sections Entitled “Dedications”. You must delete all sections Entitled “Endorsements”. <!--l. 302--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.6 </span> <a - id="x1-3300010.6"></a>Collections of documents</h4> + <h4 class="subsectionHead"><span class="titlemark">13.6 </span> <a + id="x1-11700013.6"></a>Collections of documents</h4> <!--l. 305--><p class="noindent" >You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each @@ -5365,8 +7336,8 @@ of the documents in all other respects. License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document. <!--l. 317--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.7 </span> <a - id="x1-3400010.7"></a>Aggregation with independent works</h4> + <h4 class="subsectionHead"><span class="titlemark">13.7 </span> <a + id="x1-11800013.7"></a>Aggregation with independent works</h4> <!--l. 320--><p class="noindent" >A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an “aggregate” if the copyright @@ -5375,17 +7346,17 @@ the individual works permit. When the Document is included in an aggregate, this apply to the other works in the aggregate which are not themselves derivative works of the Document. <!--l. 329--><p class="indent" > If the Cover Text requirement of section <a -href="#x1-3000010.3">10.3<!--tex4ht:ref: copying --></a> is applicable to these copies of the Document, then if +href="#x1-11400013.3">13.3<!--tex4ht:ref: copying --></a> is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document’s Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. <!--l. 338--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.8 </span> <a - id="x1-3500010.8"></a>Translation</h4> + <h4 class="subsectionHead"><span class="titlemark">13.8 </span> <a + id="x1-11900013.8"></a>Translation</h4> <!--l. 341--><p class="noindent" >Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section <a -href="#x1-3100010.4">10.4<!--tex4ht:ref: modifications --></a>. Replacing Invariant Sections with translations requires special +href="#x1-11500013.4">13.4<!--tex4ht:ref: modifications --></a>. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, @@ -5395,20 +7366,20 @@ and the original version of this License or a notice or disclaimer, the original prevail. <!--l. 355--><p class="indent" > If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the requirement (section <a -href="#x1-3100010.4">10.4<!--tex4ht:ref: modifications --></a>) to Preserve its Title (section <a -href="#x1-2800010.1">10.1<!--tex4ht:ref: applicability --></a>) will typically require changing the actual +href="#x1-11500013.4">13.4<!--tex4ht:ref: modifications --></a>) to Preserve its Title (section <a +href="#x1-11200013.1">13.1<!--tex4ht:ref: applicability --></a>) will typically require changing the actual title. <!--l. 362--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.9 </span> <a - id="x1-3600010.9"></a>Termination</h4> + <h4 class="subsectionHead"><span class="titlemark">13.9 </span> <a + id="x1-12000013.9"></a>Termination</h4> <!--l. 365--><p class="noindent" >You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. <!--l. 374--><p class="noindent" > - <h4 class="subsectionHead"><span class="titlemark">10.10 </span> <a - id="x1-3700010.10"></a>Future revisions of this license</h4> + <h4 class="subsectionHead"><span class="titlemark">13.10 </span> <a + id="x1-12100013.10"></a>Future revisions of this license</h4> <!--l. 377--><p class="noindent" >The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. @@ -5422,7 +7393,7 @@ Foundation. <!--l. 393--><p class="noindent" > <h4 class="likesubsectionHead"><a - id="x1-3800010.10"></a>Addendum: how to use this license for your documents</h4> + id="x1-12200013.10"></a>Addendum: how to use this license for your documents</h4> <!--l. 395--><p class="noindent" >To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: <!--l. 399--><p class="indent" > diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.pdf b/Master/texmf-dist/doc/latex/hyperref/manual.pdf Binary files differindex a76850c0575..3dda1e868fe 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/manual.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/manual2.html b/Master/texmf-dist/doc/latex/hyperref/manual2.html index dc86192660c..4d185dc32f9 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual2.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual2.html @@ -11,7 +11,7 @@ </head><body > <div class="footnote-text"> - <!--l. 207--><p class="indent" > <span class="footnote-mark"><a + <!--l. 205--><p class="indent" > <span class="footnote-mark"><a id="fn1x0"> <sup class="textsuperscript">1</sup></a></span><span class="ec-lmr-8">This is borrowed from an article by Arthur Smith.</span></div> diff --git a/Master/texmf-dist/doc/latex/hyperref/manual3.html b/Master/texmf-dist/doc/latex/hyperref/manual3.html index 98eb3fbb4e8..9fe14317eae 100644 --- a/Master/texmf-dist/doc/latex/hyperref/manual3.html +++ b/Master/texmf-dist/doc/latex/hyperref/manual3.html @@ -11,7 +11,7 @@ </head><body > <div class="footnote-text"> - <!--l. 271--><p class="indent" > <span class="footnote-mark"><a + <!--l. 270--><p class="indent" > <span class="footnote-mark"><a id="fn2x0"> <sup class="textsuperscript">2</sup></a></span><span class="ec-lmr-8">Make sure you turn off the partial font downloading supported by </span><span class="ec-lmss-8">dvips </span><span diff --git a/Master/texmf-dist/doc/latex/hyperref/nameref.pdf b/Master/texmf-dist/doc/latex/hyperref/nameref.pdf Binary files differindex 638e92837a1..ba53f145f1b 100644 --- a/Master/texmf-dist/doc/latex/hyperref/nameref.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/nameref.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/options.pdf b/Master/texmf-dist/doc/latex/hyperref/options.pdf Binary files differindex 7dca7806134..becf776dabd 100644 --- a/Master/texmf-dist/doc/latex/hyperref/options.pdf +++ b/Master/texmf-dist/doc/latex/hyperref/options.pdf diff --git a/Master/texmf-dist/source/latex/hyperref/doc/fdl.tex b/Master/texmf-dist/source/latex/hyperref/doc/fdl.tex index 637c1cb63c9..57f9b316217 100644 --- a/Master/texmf-dist/source/latex/hyperref/doc/fdl.tex +++ b/Master/texmf-dist/source/latex/hyperref/doc/fdl.tex @@ -3,7 +3,7 @@ \chapter{GNU Free Documentation License} -Version 1.2, November 2002\\ +Version 1.2, November 2002 Copyright \copyright\ 2000,2001,2002 Free Software Foundation, Inc.\\ diff --git a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex index baf7149c67a..442fe8b0713 100644 --- a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex +++ b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex @@ -12,10 +12,10 @@ % Manual updates: % * Steve Peter and Karl Berry, 7/03. % * Heiko Oberdiek, 2006-2012. -% * HO-support 2017 +% * HO-support 2017-2018 % -\def\mydate{January 2017} +\def\mydate{September 2018} \RequirePackage{ifpdf} \ifpdf % We are running pdfTeX in pdf mode @@ -28,7 +28,6 @@ \documentclass{article} \fi -\usepackage{etex}% for \eTeX \usepackage{pifont} \usepackage{calc} @@ -162,7 +161,6 @@ pdfusetitle,% ]{hyperref} %%?? \def\pdfBorderAttrs{/Border [0 0 0] } % No border arround Links - \usepackage{thumbpdf} \else \usepackage{hyperref} \fi @@ -254,6 +252,7 @@ the \textsf{-z} option), \textsf{\OzTeX}, and \textsf{Textures}) PDF writer; this is basically the same as that for \textsf{dvips}, but a few variations remained before version 5.21 \item[tex4ht] produces \verb|\special| commands for use with \textsf{\TeX4ht} \item[pdftex] pdf\TeX, \Hanh{}'s \TeX{} variant that writes PDF directly +\item[luatex] lua\TeX, Unicode \TeX{} variant that writes PDF directly \item[dvipdfm] produces \verb|\special| commands for Mark Wicks' DVI to PDF driver \textsf{dvipdfm} \item[dvipdfmx] produces \verb|\special| commands for driver \textsf{dvipdfmx}, a successor of \textsf{dvipdfm} @@ -330,6 +329,10 @@ macro. When the package is loaded, a file \texttt{hyperref.cfg} is read if it can be found, and this is a convenient place to set options on a site-wide basis. +Note however that some options (for example \texttt{unicode}) can only be used as +packge options, and not in \verb|\hypersetup| as the option settings are processed +as the package is read. + As an example, the behavior of a particular file could be controlled by: \begin{itemize} @@ -582,7 +585,7 @@ define \cs{Hy@defaultdriver} with \texttt{hdvips}. This is recommended because driver \textsf{dvips} provides much more features than \textsf{hypertex} for PDF generation. -\noindent\begin{longtable}{>{\ttfamily}lp{.8\hsize}} +\begin{longtable}{@{}>{\ttfamily}lp{.8\hsize}@{}} driverfallback & Its value is used as driver option\\ & if the driver is not given or autodetected.\\ dvipdfm & Sets up \textsf{hyperref} for use with the \textsf{dvipdfm} driver.\\ @@ -619,7 +622,7 @@ Explorer might add something like this to hyperref.cfg: \end{verbatim} \subsection{Extension options} -\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{6cm}} +\begin{longtable}{@{}>{\ttfamily}ll>{\itshape}lp{5.5cm}@{}} extension & text & & Set the file extension (e.g.\ \textsf{dvi}) which will be appended to file links created if you use the \xpackage{xr} package. \\ hyperfigures & boolean & & \\ @@ -660,7 +663,7 @@ Note that all color names must be defined before use, following the normal system of the standard \LaTeX\ \xpackage{color} package. \subsection{PDF-specific display options} -\noindent\begin{longtable}{@{}>{\ttfamily}ll>{\itshape}lp{7.5cm}@{}} +\begin{longtable}{@{}>{\ttfamily}ll>{\itshape}lp{7.5cm}@{}} bookmarks & boolean & 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 \texttt{.out}) may be needed to @@ -713,14 +716,13 @@ The bookmark commands are stored in a file called \textit{jobname}\texttt{.out}. The files is not processed by \LaTeX\ so any markup is passed through. You can postprocess this file as needed; as an aid for this, the \texttt{.out} file is not overwritten on the -next \TeX\ run if it is edited to contain the line \\ - +next \TeX\ run if it is edited to contain the line \begin{verbatim} \let\WriteBookmarks\relax \end{verbatim} \subsection{PDF display and information options} -\noindent\begin{longtable}{@{}>{\ttfamily}l>{\raggedright}p{\widthof{key value}}>{\itshape}lp{7cm}@{}} +\begin{longtable}{@{}>{\ttfamily}l>{\raggedright}p{\widthof{key value}}>{\itshape}lp{7cm}@{}} baseurl & URL & & Sets the base URL of the PDF document \\ pdfpagemode & text & empty & Determines how the file is opening in Acrobat; the possibilities are \texttt{UseNone}, \texttt{UseThumbs} (show thumbnails), \texttt{UseOutlines} @@ -731,7 +733,7 @@ pdftitle & text & & Sets the document information Title field pdfauthor & text & & Sets the document information Author field \\ pdfsubject & text & & Sets the document information Subject field \\ pdfcreator & text & & Sets the document information Creator field \\ -pdfproducer & text & & Sets the document information Producer field \\ +addtopdfproducer & text & & Adds additional text to the document information Producer field \\ pdfkeywords & text & & Sets the document information Keywords field \\ pdftrapped & text & empty & Sets the document information Trapped entry.\\ &&& Possible values are \texttt{True}, \texttt{False} and \texttt{Unknown}.\\ @@ -789,7 +791,7 @@ a value of -32768, which causes Acrobat to set (usually) sensible defaults. The following are possible values for the \texttt{pdfview}, \texttt{pdfstartview} and \texttt{pdfremotestartview} parameters. -\noindent\begin{longtable}{>{\ttfamily}l>{\itshape}lp{7cm}} +\begin{longtable}{@{}>{\ttfamily}l>{\itshape}lp{7cm}@{}} XYZ & left top zoom & Sets a coordinate and a zoom factor. If any one is null, the source link value is used. \textit{null null null} will give the same values as the current page. \\ Fit & & Fits the page to the window. \\ @@ -803,7 +805,7 @@ FitBV & left & Fits the height of the page bounding box to the The \texttt{pdfpagelayout} can be one of the following values. -\noindent\begin{longtable}{>{\ttfamily}lp{10cm}} +\begin{longtable}{@{}>{\ttfamily}lp{10cm}@{}} SinglePage & Displays a single page; advancing flips the page \\ OneColumn & Displays the document in one column; continuous scrolling. \\ TwoColumnLeft & Displays the document in two columns, odd-numbered pages to the left. \\ @@ -819,7 +821,7 @@ generally in 90$^{\circ}$\ steps, \textit{/Dm} is a horizontal /Dm /V}), and \textit{/M} is for motion, either in (\texttt{/I}) or out (\texttt{/O}). -\noindent\begin{longtable}{>{\ttfamily}llp{8.5cm}} +\begin{longtable}{@{}>{\ttfamily}llp{8.5cm}@{}} Blinds & /Dm & Multiple lines distributed evenly across the screen sweep in the same direction to reveal the new page. \\ Box & /M & A box sweeps in or out. \\ @@ -858,7 +860,7 @@ Example: The following is a complete listing of available options for \textsf{hyperref}, arranged alphabetically. -\noindent\begin{longtable}{@{}>{\ttfamily}llp{7cm}@{}} +\begin{longtable}{@{}>{\ttfamily}llp{7cm}@{}} anchorcolor & \textit{black} & set color of anchors \\ backref & \textit{false} & do bibliographical back references \\ baseurl & \textit{empty} & set base URL for document \\ @@ -911,7 +913,6 @@ pdfborder & \textit{0 0 1} & width of PDF link border \\ pdfcenterwindow & \textit{false} & position the document window in the center of the screen \\ pdfcreator & \textit{LaTeX with} & text for PDF Creator field \\ & \textit{hyperref} & \\ - & \textit{package} & \\ pdfdirection & \textit{empty} & direction setting \\ pdfdisplaydoctitle & \textit{false} & display document title instead of file name in title bar\\ @@ -1115,7 +1116,7 @@ For each macro below, \textsf{hyperref} checks \ci{*autorefname} before \ci{*name}. For instance, it looks for \ci{figureautorefname} before \ci{figurename}. -\noindent\begin{longtable}{lp{10cm}} +\begin{longtable}{@{}lp{10cm}@{}} \textit{Macro} & \textit{Default} \\ \ci{figurename} & Figure \\ \ci{tablename} & Table \\ @@ -1242,6 +1243,15 @@ In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in the PDF string. For further details, see Heiko Oberdiek's Euro\TeX\ paper distributed with \textsf{hyperref}. +\begin{cmdsyntax} +\ci{begin}\verb|{NoHyper}|\ldots\ci{end}\verb|{NoHyper}| +\end{cmdsyntax} + Sometimes we just don't want the wretched package interfering + with us. Define an environment we can put in manually, or include + in a style file, which stops the hypertext functions doing anything. + This is used, for instance, in the Elsevier classes, to stop + \verb|hyperref| playing havoc in the front matter. + \subsection{Bookmark macros} \subsubsection{Setting bookmarks} @@ -1363,6 +1373,777 @@ of \cs{documentclass} and \cs{usepackage}, because package \xpackage{hyperref} is not yet loaded and an undefined control sequence error would arise. +\section[New Features]{New Features% +\footnote{This section moved from the README file, needs more integration into the manual}} + + +\subsection{Option `pdflinkmargin'} + + Option `pdflinkmargin' is an experimental option for specifying + a link margin, if the driver supports this. Default is 1 pt for + supporting drivers. + + +\begin{description} +\item[pdfTeX] +\begin{itemize} + \item The link area also depends on the surrounding box. + \item Settings have local effect. + \item When a page is shipped out, pdfTeX uses the current setting + of the link margin for all links on the page. +\end{itemize} + +\item[pdfmark] +\begin{itemize} + \item Settings have global effect. +\end{itemize} + +\item[Other drivers] + Unsupported. +\end{description} + + +\subsection{Field option `calculatesortkey'} + + Fields with calculated values are calculated in document order + by default. If calculated field values depend on other calculated + fields that appear later in the document, then the correct calculation + order can be specified with option `calculatesortkey'. Its value is + used as key to lexicographically sort the calculated fields. + The sort key do not need to be unique. Fields that share the same + key are sorted in document order. + + + + Currently the field option `calculatesortkey' is only supported by + the driver for pdfTeX. + + +\subsection{Option `localanchorname'} + + When an anchor is set (e.g. via \verb|\refstepcounter|, then the + anchor name is globally set to the current anchor name. + + + For example: +\begin{verbatim} + \section{Foobar} + \begin{equation}\end{equation} + \label{sec:foobar} +\end{verbatim} + With the default global setting (localanchorname=false) + a reference to `sec:foobar' jumps to the equation before. + With option `localanchorname' the anchor of the equation + is forgotten after the environment and the reference + `sec:foobar' jumps to the section title. + + + Option `localanchorname' is an experimental option, there + might be situations, where the anchor name is not available + as expected. + + +\subsection{Option `customdriver'} + + The value of option `customdriver' is the name of an external + driver file without extension `.def'. The file must have + \verb|\ProvidesFile| with a version date and number that match the + date and number of `hyperref', otherwise a warning is given. + + Because the interface, what needs to be defined in the driver, + is not well defined and quite messy, the option is mainly intended + to ease developing, testing, debugging the driver part. + + +\subsection{Option `psdextra'} + + LaTeX's NFSS is used to assist the conversion of arbitrary + TeX strings to PDF strings (bookmarks, PDF information entries). + Many math command names (\verb|\geq|, \verb|\notin|, ...) are not in control + of NFSS, therefore they are defined with prefix `text' + (\verb|\textgeq|, \verb|\textnotin|, ...). They can be mapped to short names + during the processing to PDF strings. The disadvantage is that + they are many hundreds macros that need to be redefined for + each PDF string conversion. Therefore this can be enabled or + disabled as option `psdextra'. On default the option is turned + off (set to `false'). Turning the option on means + that the short names are available. Then \verb|\geq| can directly + be used instead of \verb|\textgeq|. + + +\subsection{\textbackslash XeTeXLinkBox} + + When XeTeX generates a link annotation, it does not look + at the boxes (as the other drivers), but only at the character + glyphs. If there are no glyphs (images, rules, ...), then + it does not generate a link annotation. Macro \verb|\XeTeXLinkBox| + puts its argument in a box and adds spaces at the lower left + and upper right corners. An additional margin can be specified + by setting it to the dimen register \verb|\XeTeXLinkMargin|. The default + is 2pt. + + Example: + + +\begin{verbatim} + % xelatex + \documentclass{article} + \usepackage{hyperref} + \setlength{\XeTeXLinkMargin}{1pt} + \begin{document} + \section{Hello World} + \newpage + \label{sec:hello} + \hyperref[sec:hello]{% + \XeTeXLinkBox{\rule{10mm}{10mm}}% + } + \end{document} +\end{verbatim} + +\subsection{\textbackslash IfHyperBooleanExists and \textbackslash IfHyperBoolean} +\begin{verbatim} + \IfHyperBooleanExists{OPTION}{YES}{NO} +\end{verbatim} + If a hyperref OPTION is a boolean, that means it takes values + `true' or `false', then \verb|\IfHyperBooleanExists| calls YES, otherwise NO. + + +\begin{verbatim} + \IfHyperBoolean{OPTION}{YES}{NO} +\end{verbatim} + Macro \verb|\IfHyperBoolean| calls YES, if OPTION exists as boolean and is + enabled. Otherwise NO is executed. + + + + Both macros are expandable. Additionally option `stoppedearly' is + available. It is enabled if \verb|\MaybeStopEarly| or \verb|\MaybeStopNow| + end hyperref prematurely. + + +\subsection{\textbackslash unichar} + + If a Unicode character is not supported by puenc.def, it can + be given by using \verb|\unichar|. Its name and syntax is inherited + from package `ucs'. However it is defined independently for + use in hyperref's \verb|\pdfstringdef| (that converts arbitrary + TeX code to PDF strings or tries to do this). + + + + Macro \verb|\unichar| takes a TeX number as argument, + examples for U+263A (WHITE SMILING FACE): +\begin{verbatim} + \unichar{"263A}% hexadecimal notation + \unichar{9786}% decimal notation +\end{verbatim} + `"' must not be a babel shorthand character or otherwise + active. Otherwise prefix it with \verb|\string|: +\begin{verbatim} + \unichar{\string"263A}% converts `"' to `"' with catcode 12 (other) +\end{verbatim} + Users of (n)german packages or babel options may use \verb|\dq| instead: +\begin{verbatim} + \unichar{\dq 263A}% \dq is double quote with catcode 12 (other) +\end{verbatim} + + +\subsection{\textbackslash ifpdfstringunicode} + + Some features of the PDF specification needs PDF strings. + Examples are bookmarks or the entries in the information dictionary. + The PDF specification allows two encodings `PDFDocEncoding' + (8-bit encoding) and `Unicode' (UTF-16). The user can help + using \verb|\texorpdfstring| to replace complicate TeX constructs + by a representation for the PDF string. However \verb|\texorpdfstring| + does not distinguish the two encodings. This gap closes + \verb|\ifpdfstringunicode|. It is only allowed in the second argument + of \verb|\texorpdfstring| and takes two arguments, the first allows + the full range of Unicode. The second is limited to the + characters available in PDFDocEncoding. + + + + As example we take a macro definition for the Vietnamese + name of Han The Thanh. Correctly written it needs some + accented characters, one character even with a double accent. + Class `tugboat.cls' defines a macro for the typesetted name: +\begin{verbatim} + \def\Thanh{% + H\`an~% + Th\^e\llap{\raise 0.5ex\hbox{\'{}}}% + ~Th\`anh% + } +\end{verbatim} + It's not entirely correct, the second accent over the `e' is not + an acute, but a hook. However standard LaTeX does not provide + such an accent. + + Now we can extend the defintion to support hyperref. + The first and the last word are already supported automatically. + Characters with two or more accents are a difficult business in + LaTeX, because the NFSS2 macros of the LaTeX kernel do not support + more than one accent. Therefore also puenc.def misses support for + them. But we can provide it using \verb|\unichar|. The character + in question is: +\begin{verbatim} + % U+1EC3 LATIN SMALL LETTER E WITH CIRCUMFLEX AND HOOK ABOVE +\end{verbatim} + Thus we can put this together: +\begin{verbatim} + \def\Thanh{% + H\`an~% + \texorpdfstring{Th\^e\llap{\raise 0.5ex\hbox{\'{}}}}% + {\ifpdfstringunicode{Th\unichar{"1EC3}}{Th\^e}}% + ~Th\`anh% + } +\end{verbatim} + For PDFDocEncoding (PD1) the variant above has dropped the + second accent. Alternatively we could provide a representation + without accents instead of wrong accents: +\begin{verbatim} + \def\Thanh{% + \texorpdfstring{% + H\`an~% + Th\^e\llap{\raise 0.5ex\hbox{\'{}}}}% + ~Th\`anh% + }{% + \ifpdfstringunicode{% + H\`an Th\unichar{"1EC3} Th\`anh% + }{% + Han The Thanh% + }% + }% + } +\end{verbatim} + +\subsection{Customizing index style file with \textbackslash nohyperpage} + + Since version 2008/08/14 v6.78f. + + + + For hyperlink support in the index, hyperref inserts \verb|\hyperpage| + into the index macros. After processing with Makeindex, \verb|\hyperpage| + analyzes its argument to detect page ranges and page comma lists. + However, only the standard settings are supported directly: +\begin{verbatim} + delim_r "--" + delim_n ", " +\end{verbatim} + (See manual page/documentation of Makeindex that explains + the keys that can be used in style files for Makeindex.) + Customized versions of + \verb|delim_r, delim_n, suffix_2p, suffix_3p, suffix_mp| + needs markup that \verb|\hyperpage| can detect and knows that + this stuff does not belong to a page number. Makro + \verb|\nohyperpage| serves as this markup. Put the customized + code for these keys inside \verb|\nohyperpage|, e.g.: +\begin{verbatim} + suffix_2p "\\nohyperpage{f.}" + suffix_3p "\\nohyperpage{ff.}" +\end{verbatim} + (Depending on the typesetting tradition some space "\verb|\\|," or "\verb|~|" + should be put before the first f inside \verb|\nohyperpage|.) + + +\subsection{Experimental option `ocgcolorlinks'} + + The idea are colored links, when viewed, but printed without colors. + This new experimental option `ocgcolorlinks' uses Optional Content + Groups, a feature introduced in PDF 1.5. +\begin{itemize} + \item The option must be given for package loading: + \verb|\usepackage[ocgcolorlinks]{hyperref}| + \item Main disadvantage: Links cannot be broken across lines. + PDF reference 1.7: 4.10.2 "Making Graphical Content Optional": + Graphics state operations, such as setting the color, ..., + are still applied. + Therefore the link text is put in a box and set twice, with and + without color. + \item The feature can be switched of by \verb|\hypersetup{ocgcolorlinks=false}| + inside the document. + \item Supported drivers: pdftex, dvipdfm + \item The PDF version should be at least 1.5. It is automatically + set for pdfTeX. Users of dvipdfmx set the version on the command + line: dvipdfmx -V 5 +\end{itemize} + +\subsection{Option `pdfa'} + + The new option `pdfa' tries to avoid violations of PDF/A in code + generated by hyperref. However, the result is usually not in PDF/A, + because many features aren't controlled by hyperref (XMP metadata, + fonts, colors, driver dependend low level stuff, ...). + + + + Currently, option `pdfa' sets and disables the following items: +\begin{itemize} + \item Enabled annotation flags: Print, NoZoom, NoRotate [PDF/A 6.5.3]. + \item Disabled annotation flags: Hidden, Invisible, NoView [PDF/A 6.5.3]. + \item Disabled: Launch action (\href{run:...} [PDF/A 6.6.1]. + \item Restricted: Named actions (\Acrobatmenu: NextPage, PrevPage, + FirstPage, LastPage) [PDF/A 6.6.1]. + \item Many things are disabled in PDF formulars: + \begin{itemize} + \item JavaScript actions [PDF/A 6.6.1] + \item Trigger events (additional actions) [PDF/A 6.6.2] + \item Push button (because of JavaScript) + \item Interactive Forms: Flag NeedAppearances is the default `false' + (Because of this, hyperref's implementation of Forms looks ugly). + [PDF/A 6.9] + \end{itemize} +\end{itemize} + + + + The default value of the new option `pdfa' is `false'. It influences + the loading of the package and cannot be changed after hyperref is + loaded (\verb|\usepackage{hyperref}|). + + + +\subsection{Option `linktoc' added} + + The new option `linktoc' allows more control which part + of an entry in the table of contents is made into a link: +\begin{itemize} + \item `linktoc=none' (no links) + \item `linktoc=section' (default behaviour, same as `linktocpage=false') + \item `linktoc=page' (same as `linktocpage=true') + \item `linktoc=all' (both the section and page part are links) +\end{itemize} + +\subsection{Option `pdfnewwindow' changed} + + Before 6.77b: +\begin{itemize} + \item pdfnewwindow=true --> /NewWindow true + \item pdfnewwindow=false --> (absent) + \item unused pdfnewwindow --> (absent) +\end{itemize} + Since 6.77b: +\begin{itemize} + \item pdfnewwindow=true --> /NewWindow true + \item pdfnewwindow=false --> /NewWindow false + \item pdfnewwindow={} --> (absent) + \item unused pdfnewwindow --> (absent) +\end{itemize} + + + + Rationale: There is a difference between setting to `false' + and an absent entry. In the former case the new document + replaces the old one, in the latter case the PDF viewer + application should respect the user preference. + + +\subsection{Flag options for PDF forms} + + PDF form field macros (\verb|\TextField|, \verb|\CheckBox|, ...) support + boolean flag options. The option name is the lowercase + version of the names in the PDF specification (1.7): + + \url{http://www.adobe.com/devnet/pdf/pdf_reference.html} + + \url{http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference.pdf} + + Options (convert to lowercase) except flags in square brackets: + +\begin{itemize} + \item Table 8.16 Annotation flags (page 608): + +{\obeylines + 1 Invisible + 2 Hidden (PDF 1.2) + 3 Print (PDF 1.2) + 4 NoZoom (PDF 1.3) + 5 NoRotate (PDF 1.3) + 6 NoView (PDF 1.3) + [7 ReadOnly (PDF 1.3)] ignored for widget annotations, see table 8.70 + 8 Locked (PDF 1.4) + 9 ToggleNoView (PDF 1.5) + 10 LockedContents (PDF 1.7) +} + \item Table 8.70 Field flags common to all field types (page 676): + +{\obeylines + 1 ReadOnly + 2 Required + 3 NoExport +} + \item Table 8.75 Field flags specific to button fields (page 686): + +{\obeylines + 15 NoToggleToOff (Radio buttons only) + 16 Radio (set: radio buttons, clear: check box, pushbutton: clear) + 17 Pushbutton + 26 RadiosInUniso (PDF 1.5) +} + \item Table 8.77 Field flags specific to text fields (page 691): + +{\obeylines + 13 Multiline + 14 Password + 21 FileSelect (PDF 1.4) + 23 DoNotSpellCheck (PDF 1.4) + 24 DoNotScroll (PDF 1.4) + 25 Comb (PDF 1.5) + 26 RichText (PDF 1.5) +} + \item Table 8.79 Field flags specific to choice fields (page 693): + +{\obeylines + 18 Combo (set: combo box, clear: list box) + 19 Edit (only useful if Combo is set) + 20 (Sort) for authoring tools, not PDF viewers + 22 MultiSelect (PDF 1.4) + 23 DoNotSpellCheck (PDF 1.4) (only useful if Combo and Edit are set) + 27 CommitOnSelChange (PDF 1.5) +} + \item Table 8.86 Flags for submit-form actions (page 704): + +{\obeylines + [1 Include/Exclude] unsupported, use `noexport' (table 8.70) instead + 2 IncludeNoValueFields + [3 ExportFormat] handled by option `export' + 4 GetMethod + 5 SubmitCoordinates + [6 XFDF (PDF 1.4)] handled by option `export' + 7 IncludeAppendSaves (PDF 1.4) + 8 IncludeAnnotations (PDF 1.4) + [9 SubmitPDF (PDF 1.4)] handled by option `export' + 10 CanonicalFormat (PDF 1.4) + 11 ExclNonUserAnnots (PDF 1.4) + 12 ExclFKey (PDF 1.4) + 14 EmbedForm (PDF 1.5) +} +\end{itemize} + + New option `export' sets the export format of a submit action. + Valid values are (upper- or lowercase): +\begin{itemize} + \item FDF + \item HTML + \item XFDF + \item PDF (not supported by Acrobat Reader) +\end{itemize} + +\subsection{Option `pdfversion'} + + This is an experimental option. It notifies `hyperref' about + the intended PDF version. Currently this is used in code for + PDF forms (implementation notes 116 and 122 of PDF spec 1.7). + + + + Values: 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. Values below 1.2 are not + supported, because most drivers expect higher PDF versions. + + + + The option must be used early, not after \verb|\usepackage{hyperref}|. + + + In theory this option should also set the PDF version, + but this is not generally supported. +\begin{itemize} + \item pdfTeX below 1.10a: unsupported. + pdfTeX >= 1.10a and < 1.30: \verb|\pdfoptionpdfminorversion| + pdfTeX >= 1.30: \verb|\pdfminorversion| + \item dvipdfm: configuration file, example: + TeX Live 2007, texmf/dvipdfm/config/config, entry `V 2'. + \item dvipdfmx: configuration file, example: + TeX Live 2007, texmf/dvipdfm/dvipdfmx.cfg, entry `V 4'. + \item Ghostscript: option -dCompatibilityLevel (this is set in + `ps2pdf12', `ps2pdf13', `ps2pdf14'). +\end{itemize} + + + The current PDF version is used as default if this version + can be detected (only pdfTeX >= 1.10a). Otherwise the lowest + version 1.2 is assumed. Thus `hyperref' tries to avoid PDF code + that breaks this version, but is free to use ignorable higher PDF + features. + + +\subsection{Field option `name'} + + Many form objects uses the label argument + for several purposes: +\begin{itemize} + \item Layouted label. + \item As name in HTML structures. +\end{itemize} + Code that is suitable for layouting with TeX can + break in the structures of the output format. + If option `name' is given, then its value is used + as name in the different output structures. Thus + the value should consist of letters only. + + +\subsection{Option `pdfencoding'} + + The PDF format allows two encodings for bookmarks and entries + in the information dictionary: PDFDocEncoding and Unicode + as UTF-16BE. Option "pdfencoding" selects between these encodings: +\begin{itemize} + \item "pdfdoc" uses PDFDocEncoding. It uses just one byte per character, + but the supported characters are limited (244 in PDF-1.7). + \item "unicode" sets Unicode. It is encoded as UTF-16BE. Two bytes + are used for most characters, surrogates need four bytes. + \item "auto" PDFDocEncoding if the string does not contain characters + outside the encoding and Unicode otherwise. +\end{itemize} + +\subsection{Color options/package hycolor} + + See documentation of package `hycolor'. + + +\subsection{Option pdfusetitle} + + If option pdfusetitle is set then hyperref tries to + derive the values for pdftitle and pdfauthor from + \verb|\title| and \verb|\author|. An optional argument for \verb|\title| and + \verb|\author| is supported (class amsart). + + +\subsection{Starred form of \textbackslash autoref} + + \verb|\autoref*| generates a reference without link as \verb|\ref*| or \verb|\pageref*|. + + +\subsection{Link border style} + + Links can be underlined instead of the default rectangle or + options "colorlinks", "frenchlinks". This is done by option + \verb|pdfborderstyle={/S/U/W 1}| + + Some remarks: + +\begin{itemize} + \item AR7/Linux seems to have a bug, that don't use the default + value "1" for the width, but zero, thus that the underline + is not visible without "/W 1". The same applies for + dashed boxes, eg.: + pdfborderstyle={/S/D/D[3 2]/W 1} + + \item The syntax is described in the PDF specification, look for + "border style", eg. + Table 8.13 "Entries in a border style dictionary" + (specification for version 1.6) + + \item The border style is removed by + pdfborderstyle={} + This is automatically done if option colorlinks is enabled. + + \item Be aware that not all PDF viewers support this feature, not + even Acrobat Reader itself: + + Some support: + \begin{itemize} + \item AR7/Linux: "underline" and "dashed", but the border width + must be given. + \item xpdf 3.00: "underline" and "dashed" + \end{itemize} + + Unsupported: + \begin{itemize} + \item AR5/Linux + \item ghostscript 8.50 + \end{itemize} +\end{itemize} + +\subsection{Option "bookmarksdepth"} + + The depth of the bookmarks can be controlled by the new + option "bookmarksdepth". The option acts globally and + distinguishes three cases: +\begin{itemize} + \item "bookmarksdepth" without value + Then hyperref uses the current value of counter "tocdepth". + This is the compatible behaviour and the default. + \item "bookmarksdepth=<number>", the value is number (also negative): + The depth for the bookmarks are set to this number. + \item "bookmarksdepth=<name>" + The <name> is a document division name (part, chapter, ...). + It must not start with a digit or minus to avoid mixing up + with the number case. Internally hyperref uses the value + of macro "\verb|\toclevel@<name>|". + Examples: +\begin{verbatim} + \hypersetup{bookmarksdepth=paragraph} + \hypersetup{bookmarksdepth=4} % same as before + \hypersetup{bookmarksdepth} % counter "tocdepth" is used +\end{verbatim} +\end{itemize} + +\subsection{Option "pdfescapeform"} + + There are many places where arbitrary strings end up as + PS or PDF strings. The PS/PDF strings in parentheses form + require the protection of some characters, e.g. unmatched + left or right parentheses need escaping or the escape + character itself (backslash). + Since 2006/02/12 v6.75a the PS/PDF driver should do + this automatically. However I assume a problem with + compatibility, especially regarding the form part where + larger amounts of JavaScript code can be present. + It would be a pain to remove all the escaping, because + an additional escaping layer can falsify the code. + + Therefore a new option pdfescapeform was introduced: +\begin{itemize} + \item pdfescapeform=false + Escaping for the formulars are disabled, this is + the compatibility behaviour, therefore this is the default. + \item pdfescapeform=true + Then the PS/PDF drivers do all the necessary escaping. + This is the logical choice and the recommended setting. + For example, the user writes JavaScript as JavaScript + and do not care about escaping characters for PS/PDF + output. +\end{itemize} + +\subsection{Default driver setting} + + (hyperref >= 6.72s) + If no driver is given, hyperref tries its best to guess the + most suitable driver. Thus it loads "hpdftex", if pdfTeX is + detected running in PDF mode. Or it loads the corresponding + VTeX driver for VTeX's working modes. + Unhappily many driver programs run after the TeX compiler, + so hyperref does not have a chance (dvips, dvipdfm, ...). + In this case driver "hypertex" is loaded that supports the + HyperTeX features that are recognized by xdvi for example. + This behaviour, however, can easily be changed in the configuration + file "hyperref.cfg": +\begin{verbatim} + \providecommand*{\Hy@defaultdriver}{hdvips} +\end{verbatim} + for dvips, or +\begin{verbatim} + \providecommand*{\Hy@defaultdriver}{hypertex} +\end{verbatim} + for the default behaviour of hyperref. + + See also the new option `driverfallback'. + +\subsection{Backref entries} + + Alternative interface for formatting of backref entries, example: + +\begin{verbatim} +\documentclass[12pt,UKenglish]{article} + +\usepackage{babel} +\usepackage[pagebackref]{hyperref} + +% Some language options are detected by package backref. +% This affects the following macros: +% \backrefpagesname +% \backrefsectionsname +% \backrefsep +% \backreftwosep +% \backreflastsep + +\renewcommand*{\backref}[1]{ + % default interface + % #1: backref list + % + % We want to use the alternative interface, + % therefore the definition is empty here. +} +\renewcommand*{\backrefalt}[4]{% + % alternative interface + % #1: number of distinct back references + % #2: backref list with distinct entries + % #3: number of back references including duplicates + % #4: backref list including duplicates + \par + #3 citation(s) on #1 page(s): #2,\par + \ifnum#1=1 % + \ifnum#3=1 % + 1 citation on page % + \else + #3 citations on page % + \fi + \else + #3 citations on #1 pages % + \fi + #2,\par + \ifnum#3=1 % + 1 citation located at page % + \else + #3 citations located at pages % + \fi + #4.\par +} + +% The list of distinct entries can be further refined: +\renewcommand*{\backrefentrycount}[2]{% + % #1: the original backref entry + % #2: the count of citations of this entry, + % in case of duplicates greater than one + #1% + \ifnum#2>1 % + ~(#2)% + \fi +} + +\begin{document} + + \section{Hello} + \cite{ref1, ref2, ref3, ref4} + \section{World} + \cite{ref1, ref3} + \newpage + + \section{Next section} + \cite{ref1} + \newpage + + \section{Last section} + \cite{ref1, ref2} + \newpage + + \pdfbookmark[1]{Bibliography}{bib} + \begin{thebibliography}{99} + \bibitem{ref1} Dummy entry one. + + \bibitem{ref2} Dummy entry two. + + \bibitem{ref3} Dummy entry three. + + \bibitem{ref4} Dummy entry four. + + \end{thebibliography} + +\end{document} +\end{verbatim} + +\subsection{\textbackslash phantomsection} + +Set an anchor at this location. It is often used in conjunction +with \verb|\addcontentsline| for sectionlike things (index, bibliography, +preface). \verb|\addcontentsline| refers to the latest previous location +where an anchor is set. + +\begin{verbatim} + \cleardoublepage + \phantomsection + \addcontentsline{toc}{chapter}{\indexname} + \printindex +\end{verbatim} + +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. + + + \section{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: @@ -1374,7 +2155,7 @@ macro is provided in the appropriate drivers: \noindent The \emph{text} is used to create a button which activates the appropriate \emph{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. \medskip -\noindent\begin{longtable}{lp{9cm}} +\begin{longtable}{@{}l>{\raggedright\arraybackslash}p{9cm}@{}} File & Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, Print, PageSetup, Quit \\ File$\rightarrow$Import & ImportImage, ImportNotes, AcroForm:ImportFDF \\ File$\rightarrow$Export & ExportNotes, AcroForm:ExportFDF \\ @@ -1488,7 +2269,8 @@ You may also want to redefine the following macros: \subsection{Forms environment parameters} -\smallskip\noindent\begin{longtable}{>{\ttfamily}l>{\itshape}lp{9cm}} +\smallskip +\begin{longtable}{@{}>{\ttfamily}l>{\itshape}lp{9cm}@{}} action & URL & The URL that will receive the form data if a \textsf{Submit} button is included in the form \\ encoding & name & The encoding for the string set to the URL; FDF-encoding is usual, and \texttt{html} is the only valid value \\ @@ -1499,7 +2281,8 @@ method & name & Used only when generating HTML; values can be \texttt{post} or Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e.\ \texttt{color=0 0 0.5}) -\smallskip\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}ll} +\smallskip +\begin{longtable}{@{}>{\ttfamily}ll>{\itshape}ll@{}} accesskey & key & & (as per HTML) \\ align & number & 0 & alignment within text field; 0 is left-aligned,\\* & & & 1 is centered, 2 is right-aligned. \\ @@ -1581,7 +2364,7 @@ A hyperref driver has to provide definitions for eight macros: \smallskip The draft option defines the macros as follows -\qquad\begin{verbatim} +\begin{verbatim} \let\hyper@@anchor\@gobble \gdef\hyper@link##1##2##3{##3}% \def\hyper@linkurl##1##2{##1}% @@ -1620,6 +2403,870 @@ and \xpackage{minitoc}, which support crossdocument links using \hologo{LaTeX}'s normal \cs{label}/\cs{ref} mechanisms and per-chapter tables of contents, respectively. + +\subsection{Package Compatibility} + +Currently only package loading orders are available: + + + +Note: hyperref loads package "nameref" at \verb|\begin{document}|. +Sometimes this is too late, thus this package must be loaded +earlier. + + +\subsubsection{algorithm} +\begin{verbatim} + \usepackage{float} + \usepackage{hyperref} + \usepackage[chapter]{algorithm}% eg. +\end{verbatim} + +\subsubsection{amsmath} + + The environments equation and eqnarray are not supported too well. + For example, there might be spacing problems (eqnarray isn't recommended + anyway, see CTAN:info/l2tabu/, the situation for equation is unclear, + because nobody is interested in investigating). Consider using the + environments that package amsmath provide, e.g. gather for equation. + The environment equation can even redefined to use gather: + +\begin{verbatim} + \usepackage{amsmath} + \let\equation\gather + \let\endequation\endgather +\end{verbatim} + +\subsubsection{amsrefs} + + Package loading order: + +\begin{verbatim} + \usepackage{hyperref} + \usepackage{amsrefs} +\end{verbatim} + +\subsubsection{arydshln, longtable} + + Package longtable must be put before hyperref and arydshln, + hyperref after arydshln generates an error, thus the + resulting package order is then: + +\begin{verbatim} + \usepackage{longtable} + \usepacakge{hyperref} + \usepackage{arydshln} +\end{verbatim} + +\subsubsection{babel/magyar.ldf} + + The old version 2005/03/30 v1.4j will not work. + You need at least version 1.5, maintained by P\'eter Szab\'o, + see CTAN:language/hungarian/babel/. + + +\subsubsection{babel/spanish.ldf} + + Babel's spanish.ldf redefines `\verb|\.|' to support `\verb|\...|'. + In bookmarks (\verb|\pdfstringdef|) only `\verb|\.|' is supported. + If `\verb|\...|' is needed, + \verb|\texorpdfstring{\...}{\dots}| + can be used instead. + + +\subsubsection{bibentry} + + Workaround: + +\begin{verbatim} + \makeatletter + \let\saved@bibitem\@bibitem + \makeatother + + \usepackage{bibentry} + \usepackage{hyperref} + + \begin{document} + + \begingroup + \makeatletter + \let\@bibitem\saved@bibitem + \nobibliography{database} + \endgroup +\end{verbatim} + +\subsubsection{bigfoot} + + Hyperref does not support package `bigfoot'. And package + `bigfoot' does not support hyperref's footnotes and disables + them (hyperfootnotes=false). + + +\subsubsection{chappg} + + Package `chappg' uses \verb|\@addtoreset| that is redefined by `hyperref'. + The package order is therefore: + +\begin{verbatim} + \usepackage{hyperref} + \usepackage{chappg} +\end{verbatim} + +\subsubsection{cite} + + This is from Mike Shell: + cite.sty cannot currently be used with hyperref. + However, I can do a workaround via: + +\begin{verbatim} + \makeatletter + \def\NAT@parse{\typeout{This is a fake Natbib command to fool Hyperref.}} + \makeatother + + \usepackage[hypertex]{hyperref} +\end{verbatim} + + so that hyperref will not redefine any of the biblabel stuff - so cite.sty + will work as normal - although the citations will not be hyperlinked, of + course (But this may not be an issue for many people). + + +\subsubsection{count1to} + + Package `count1to' adds several \verb|\@addtoreset| commands that confuse + `hyperref'. Therefore \verb|\theH<...>| has to be fixed: + +\begin{verbatim} + \usepackage{count1to} + \AtBeginDocument{% *after* \usepackage{count1to} + \renewcommand*{\theHsection}{\theHchapter.\arabic{section}}% + \renewcommand*{\theHsubsection}{\theHsection.\arabic{subsection}}% + \renewcommand*{\theHsubsubsection}{\theHsubsection.\arabic{subsubsection}}% + \renewcommand*{\theHparagraph}{\theHsubsubsection.\arabic{paragraph}}% + \renewcommand*{\theHsubparagraph}{\theHparagraph.\arabic{subparagraph}}% + } +\end{verbatim} + +\subsubsection{dblaccnt} + + pd1enc.def or puenc.def should be loaded before: +\begin{verbatim} + \usepackage{hyperref} + \usepackage{dblaccnt} +\end{verbatim} + or see entry for "vietnam". + + +\subsubsection{easyeqn} + Not compatible, breaks. + + +\subsubsection{ellipsis} + + This packages redefines \verb|\textellipsis| + after package hyperref (pd1enc.def/puenc.def should be loaded before): +\begin{verbatim} + \usepackage{hyperref} + \usepackage{ellipsis} +\end{verbatim} + +\subsubsection{float} +\begin{verbatim} + \usepackage{float} + \usepackage{hyperref} +\end{verbatim} +\begin{itemize} + \item Several \verb|\caption| commands are not supported inside one float object. + \item Anchor are set at top of the float object, if its style is controlled + by float.sty. +\end{itemize} + +\subsubsection{endnotes} + Unsupported. + +\subsubsection{foiltex} + Update to version 2008/01/28 v2.1.4b: + Since version 6.77a hyperref does not hack into \verb|\@begindvi|, + it uses package `atbegshi' instead, that hooks into \verb|\shipout|. + Thus the patch of `foils.cls' regarding hyperref is now obsolete + and causes an undefined error message about \verb|\@hyperfixhead|. + This is fixed in FoilTeX 2.1.4b. + + +\subsubsection{footnote} + + This package is not supported, you have to disable hyperref's footnote + support by using option "hyperfootnotes=false". + + +\subsubsection{geometry} + + Driver `dvipdfm' and program `dvipdfm' might generate a warning: + Sorry. Too late to change page size + Then prefer the program `dvipdfmx' or use one of the following + workarounds to move the \verb|\special| of geometry to an earlier + location: + +\begin{verbatim} + \documentclass[dvipdfm]{article}% or other classes + \usepackage{atbegshi} + \AtBeginDocument{% + \let\OrgAtBeginDvi\AtBeginDvi + \let\AtBeginDvi\AtBeginShipoutFirst + } + \usepackage[ + paperwidth=170mm, + paperheight=240mm + ]{geometry} + \AtBeginDocument{% + \let\AtBeginDvi\OrgAtBeginDvi + } + \usepackage{hyperref} + + or + + \documentclass[dvipdfm]{article}% or other classes + \usepackage{atbegshi} + \let\AtBeginDvi\AtBeginShipoutFirst + \usepackage[ + paperwidth=170mm, + paperheight=240mm + ]{geometry} + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{IEEEtran.cls} + + version >= V1.6b (because of \verb|\@makecaption|, see ChangeLog) + + +\subsubsection{index} + + version >= 1995/09/28 v4.1 (because of \verb|\addcontentsline| redefinition) + + +\subsubsection{lastpage} + + Compatible. + + +\subsubsection{linguex} +\begin{verbatim} + \usepackage{hyperref} + \usepackage{linguex} +\end{verbatim} + +\subsubsection{ltabptch} +\begin{verbatim} + \usepackage{longtable} + \usepackage{ltabptch} + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{mathenv} + + Unsupported. + + + + Both `mathenv' and `hyperref' messes around with + environment `eqnarray'. You can load `mathenv' after + `hyperref' to avoid an error message. But \verb|\label| + will not work inside environment `eqnarray' properly, + for example. + + +\subsubsection{minitoc-hyper} + + This package is obsolete, use the uptodate original + package minitoc instead. + + +\subsubsection{multind} +\begin{verbatim} + \usepackage{multind} + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{natbib} +\begin{verbatim} + \usepackage{natbib} + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{nomencl} +Example for introducing links for the page numbers: +\begin{verbatim} + \renewcommand*{\pagedeclaration}[1]{\unskip, \hyperpage{#1}} +\end{verbatim} + + +For equations the following might work: +\begin{verbatim} + \renewcommand*{\eqdeclaration}[1]{% + \hyperlink{equation.#1}{(Equation~#1)}% + } + But the mapping from the equation number to the anchor name + is not available in general. +\end{verbatim} + +\subsubsection{parskip} +\begin{verbatim} + \usepackage{parskip} + \usepackage{hyperref}[2012/08/20] +\end{verbatim} + + + Both packages want to redefine \verb|\@starttoc|. + + +\subsubsection{prettyref} +\begin{verbatim} +%%% example for prettyref %%% +\documentclass{article} +\usepackage{prettyref} +\usepackage[pdftex]{hyperref} + +%\newrefformat{FIG}{Figure~\ref{#1}}% without hyperref +\newrefformat{FIG}{\hyperref[{#1}]{Figure~\ref*{#1}}} + +\begin{document} + This is a reference to \prettyref{FIG:ONE}. + \newpage + \begin{figure} + \caption{This is my figure} + \label{FIG:ONE} + \end{figure} +\end{document} +%%% example for prettyref %%% + \end{verbatim} + +\subsubsection{ntheorem} +\begin{verbatim} + ntheorem-hyper.sty is an old patched version of ntheorem.sty. + Newer versions of ntheorem know the option hyperref: + \usepackage{hyperref} + \usepackage[hyperref]{ntheorem} + But there are still unsolved problems (options thref, ...). +\end{verbatim} + +\subsubsection{setspace} +\begin{verbatim} + \usepackage{setspace} + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{sidecap} +\begin{verbatim} + Before 2002/05/24 v1.5h: + \usepackage{nameref} + \usepackage{hyperref} + \usepackage{sidecap} +\end{verbatim} + +\subsubsection{subfigure} +\begin{verbatim} + 1995/03/06 v2.0: + \usepackage{subfigure} + \usepackage{hyperref} + % hypertexnames is set to false. + v2.1: + \usepackage{nameref} + \usepackage{subfigure} + \usepackage{hyperref} + or + \usepackage{hyperref} + \usepackage{subfigure} + v2.1.2: + please update + v2.1.3: + \usepackage{hyperref} + \usepackage{subfigure} + or vice versa? +\end{verbatim} + +\subsubsection{titleref} +\begin{verbatim} + \usepackage{nameref} + \usepackage{titleref}% without usetoc + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{tabularx} + + Linked footnotes are not supported inside environment `tabularx', + because they uses the optional argument of \verb|\footnotetext|, see + section `Limitations'. Before version 2011/09/28 6.82i + hyperref had disabled footnotes entirely by `hyperfootnotes=false'. + + +\subsubsection{titlesec} + + "nameref" supports titlesec, but hyperref does not + (unsolved is the anchor setting, missing with unnumbered + section, perhaps problems with page breaks with numbered ones). + + +\subsubsection{ucs/utf8x.def} + + The first time a multibyte UTF8 sequence is called, it + does some calculations and stores the result in a macro + for speeding up the next calls of that UTF8 sequence. + However this makes the first call non-expandable and + will break if used in information entries or bookmarks. + Package "ucs" offers \verb|\PrerenderUnicode| or \verb|\PreloadUnicodePage| + to solve this: +\begin{verbatim} + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + \usepackage{hyperref}% or with option unicode + \PrerenderUnicode{^^c3^^b6}% or \PrerenderUnicodePage{1} + \hypersetup{pdftitle={Umlaut example: ^^c3^^b6}} +\end{verbatim} + The notation with two carets avoids trouble with 8-bit bytes + for the README file, you can use the characters directly. + + +\subsubsection{varioref} + 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: +\begin{verbatim} + \usepackage{nameref} + \usepackage{varioref} + \usepackage{hyperref} +\end{verbatim} + + + 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: +\begin{itemize} +\item \verb|\Ref|, \verb|\Vref| do not uppercase the first letter. +\item \verb|\vpageref[]{...}| + On the same page a previous space is not suppressed. +\end{itemize} + +\subsubsection{verse} + + Version 2005/08/22 v2.22 contains support for hyperref. + + For older versions see example from + de.comp.text.tex (2005/08/11, slightly modified): + +\begin{verbatim} + \documentclass{article} + + % package order does not matter + \usepackage{verse} + \usepackage{hyperref} + + \makeatletter + % make unique poemline anchors + \newcounter{verse@env} + \setcounter{verse@env}{0} + \let\org@verse\verse + \def\verse{% + \stepcounter{verse@env}% + \org@verse + } + \def\theHpoemline{\arabic{verse@env}.\thepoemline} + + % add anchor for before \addcontentsline in \@vsptitle + \let\org@vsptitle\@vsptitle + \def\@vsptitle{% + \phantomsection + \org@vsptitle + } + \makeatother + + \begin{document} + + \poemtitle{Poem 1} + \begin{verse} + An one-liner. + \end{verse} + + \newpage + + \poemtitle{Poem 2} + \begin{verse} + Another one-liner. + \end{verse} + + \end{document} +\end{verbatim} + +\subsubsection{vietnam} +\begin{verbatim} + % pd1enc.def should be loaded before package dblaccnt: + \usepackage[PD1,OT1]{fontenc} + \usepackage{vietnam} + \usepackage{hyperref} +\end{verbatim} + +\subsubsection{XeTeX} + + Default for the encoding of bookmarks is `pdfencoding=auto'. + That means the strings are always treated as unicode strings. + Only if the string restricts to the printable ASCII set, + it is written as ASCII string. The reason is that the + \verb|\special| does not support PDFDocEncoding. + + + + XeTeX uses the program xdvipdfmx for PDF output generation. + This program behaves a little different from dvipdfm, because + of the supported Unicode characters. Strings for bookmarks + or information entries can be output directly. The + big chars (char code > 255) are written in UTF-8 and + xdvipdfmx tries to convert them to UTF-16BE. However + hyperref already provides PDF strings encoded in UTF-16BE, + thus the result is a warning + + "Failed to convert input string to UTF16..." + + The best way would be, if xdvipdfm could detect the + byte order marker (\verb|\376\377|) and skips the conversion + if that marker is present. + + For the time being I added the following to hyperref, + when option `pdfencoding=auto' is set (default for XeTeX): + The string is converted back to big characters thus that the + string is written as UTF-8. But I am very unhappy with this + solution. Main disadvantage: + Two versions of \verb|\pdfstringdef| are needed: + + a) The string is converted back to big characters for + the "tainted keys" of xdvipdfmx (\verb|spc_pdfm.c: default_taintkeys|). + The subset hyperref uses is /Title, /Author, /Subject, + /Keywords, /Creator, /Producer, /T. Any changes of this + set in xdvipdfmx cannot be detected by hyperref. + + b) Without conversion for the other strings , providing UTF16be + directly. Examples: Prefix of page labels, some elements + of formulars. + + Thus \textbf{each} application that uses \verb|\pdfstringdef| now must + check, if it defines a string for some of the tained keys. + If yes, then the call of \verb|\pdfstringdef| should be preceded + by "\verb|\csname HyPsd@XeTeXBigCharstrue\endcsname|". + Example: package bookmark. + + +\section[Limitiations]{Limitations% +\footnote{This section moved from the README file, needs more integration into the manual}} +\subsection{Wrapped/broken link support} + + Only few drivers support automatically wrapped/broken links, + e.g. pdftex, dvipdfm, hypertex. Other drivers lack this + feature, e.g. dvips, dvipsone. + + Workarounds: +\begin{itemize} +\item For long section or caption titles in the table of contents + or list of figures/tables option "linktocpage" can be used. + Then the page number will be a link, and the overlong section + title is not forced into an one line link with overfull \verb|\hbox| + warning. +\item "\verb|\url|"s are caught by package "breakurl". +\item The option "breaklinks" is intended for internal use. But it + can be used to force link wrapping, e.g. when printing a + document. However, when such a document is converted to PDF + and viewed with a PDF viewer, the active link area will be + misplaced. + + Another limitation: some penalties are "optimized" by TeX, + thus there are missing break points, especially within + \verb|\url|. (See thread "hyperref.sty, breaklinks and url.sty 3.2" + in comp.text.tex 2005-09). +\end{itemize} + +\subsection{Links across pages} + + In general they have problems: +\begin{itemize} + \item Some driver doesn't support them at all (see above). + \item The driver allows it, but the link result might include + the footer and/or header, or an error message can + occur sometimes. +\end{itemize} + +\subsection{Footnotes} + + LaTeX allows the separation of the footnote mark and the + footnote text (\verb|\footnotemark|, \verb|\footnotetext|). This interface + might be enough for visual typesetting. But the relation between + \verb|\footnotemark| to \verb|\footnotetext| is not as strong as \verb|\ref| to \verb|\label|. + Therefore it is not clear in general which \verb|\footnotemark| references + which \verb|\footnotetext|. But that is necessary to implement hyperlinking. + Thus the implementation of hyperref does not support the optional + argument of \verb|\footnotemark\verb| and \verb|\footnotetext|. + + +\section[Hints]{Hints% +\footnote{This section moved from the README file, needs more integration into the manual}} + +\subsection{Spaces in option values} + + Unhappily LaTeX strips spaces from options if they are given + in \verb|\documentclass| or \verb|\usepackage| (or \verb|\RequirePackage|), e.g.: +\begin{verbatim} + \usepackage[pdfborder=0 0 1]{hyperref} +\end{verbatim} + Package hyperref now gets +\begin{verbatim} + pdfborder=001 +\end{verbatim} + and the result is an invalid PDF file. + As workaround braces can be used: +\begin{verbatim} + \usepackage[pdfborder={0 0 1}]{hyperref} +\end{verbatim} + Some options can also be given in \begin{verbatim}\hypersetup| +\begin{verbatim} + \hypersetup{pdfborder=0 0 1} +\end{verbatim} + In \verb|\hypersetup| the options are directly processed as key value + options (see package keyval) without space stripping in the value part. + + + + Alternatively, LaTeX's option handling system can be adapted + to key value options by one of the packages "kvoptions-patch" + (from project "kvoptions") or "xkvltxp" (from project "xsetkeys"). + + +\subsection{Index with makeindex} +\begin{itemize} + \item Package hyperref adds \verb|\hyperpage| commands by the encap + mechanism (see documentation of Makeindex), + if option hyperindex is set (default). + \verb|\hyperpage| uses the page anchors that are set by + hyperref at each page (default). However in the + default case page numbers are used in anchor names + in arabic form. If the page numbers in other formats + are used (book class with \verb|\frontmatter|, \verb|\romannumbering|, ...), + then the page anchors are not unique. Therefore option + "plainpages=false" is recommended. + \item The encap mechanism of Makeindex allows to use one command only + (see documentation of Makeindex). + If the user sets such a command, hyperref suppresses its + \verb|\hyperpage| command. With logical markup this situation + can easily be solved: +\begin{verbatim} + \usepackage{makeidx} + \makeindex + \usepackage[hyperindex]{hyperref} + \newcommand*{\main}[1]{\textbf{\hyperpage{#1}}} + ... + \index{Some example|main} +\end{verbatim} + \item Scientic Word/Scientific WorkPlace users can use + package robustindex with hyperindex=false. + \item Other encap characters can be set by option "encap". + Example for use of "?": +\begin{verbatim} + \usepackage[encap=?]{hyperref} +\end{verbatim} + \item An other possibility is the insertion of \verb|\hyperpage| by + a style file for makeindex. For this case, hyperref's + insertion will be disabled by "hyperindex=false". + \verb|\hyperpage| will be defined regardless of setting of hyperindex. +\begin{verbatim} +%%% cut %%% hyperindex.ist %%% cut %%% +delim_0 ", \\hyperpage{" +delim_1 ", \\hyperpage{" +delim_2 ", \\hyperpage{" +delim_n "}, \\hyperpage{" +delim_t "}" +encap_prefix "}\\" +encap_infix "{\\hyperpage{" +encap_suffix "}" +%%% cut %%% hyperindex.ist %%% cut %%% +\end{verbatim} +\end{itemize} + +\subsection{Warning "bookmark level for unknown <foobar> defaults to 0"} + + Getting rid of it: +\begin{verbatim} +\makeatletter +\providecommand*{\toclevel@<foobar>}{0} +\makeatother +\end{verbatim} + +\subsection{Link anchors in figures} + + The caption command increments the counter and here is the + place where hyperref set the corresponding anchor. Unhappily + the caption is set below the figure, so the figure is not + visible if a link jumps to a figure. + In this case, try package "hypcap.sty" that implements + a method to circumvent the problem. + + +\subsection{Additional unicode characters in bookmarks and pdf information entries:} +\begin{verbatim} +\documentclass[pdftex]{article} +\usepackage[unicode]{hyperref} +\end{verbatim} + +Support for additional unicode characters: + + Example: \verb|\.{a}| and \verb|\d{a}| + + 1. Get a list with unicode data, eg: + + http://www.unicode.org/Public/UNIDATA/UnicodeData.txt + + 2. Identify the characters (\verb|\.{a}|, \verb|\d{a}|): +\begin{verbatim} + 0227;LATIN SMALL LETTER A WITH DOT ABOVE;... + 1EA1;LATIN SMALL LETTER A WITH DOT BELOW;... +\end{verbatim} + + 3. Calculate the octal code: + + The first characters of the line in the file are + hex values, convert each byte and prepend them + with a backslash. (This will go into the PDF file.) + +\begin{verbatim} + 0227 -> \002\047 + 1EA1 -> \036\241 +\end{verbatim} + + 4. Transform into a form understood by hyperref: + + Hyperref must know where the first byte starts, + this is marked by "9" (8 and 9 cannot occur in + octal numbers): + +\begin{verbatim} + \002\047 -> \9002\047 + \036\241 -> \9036\241 +\end{verbatim} + + Optional: "8" is used for abbreviations: + +\begin{verbatim} + \900 = \80, \901 = \81, \902 = \82, ... + + \9002\047 -> \82\047 +\end{verbatim} + + 5. Declare the character with LaTeX: + +\begin{verbatim} +\DeclareTextCompositeCommand{\.}{PU}{a}{\82\047} +\DeclareTextCompositeCommand{\d}{PU}{a}{\9036\241} + +\begin{document} +\section{\={a}, \d{a}, \'{a}, \.{a}} +\end{document} + \end{verbatim} + +\subsection{Footnotes} + + The footnote support is rather limited. It is beyond the scope + to use \verb|\footnotemark| and \verb|\footnotetext| out of order or reusing + \verb|\footnotemark|. Here you can either disable hyperref's footnote + support by "hyperfootnotes=false" or fiddle with internal macros, + nasty examples: + +\begin{verbatim} +\documentclass{article} +\usepackage{hyperref} +\begin{document} +Hello% +\footnote{The first footnote} +World% +\addtocounter{footnote}{-1}% +\addtocounter{Hfootnote}{-1}% +\footnotemark. +\end{document} + + or + +\documentclass{article} + +\usepackage{hyperref} + +\begin{document} + +\makeatletter + +A% + \footnotemark + \let\saved@Href@A\Hy@footnote@currentHref + % remember link name +B% + \footnotemark + \let\saved@Href@B\Hy@footnote@currentHref +b% + \addtocounter{footnote}{-1}% + \addtocounter{Hfootnote}{-1}% generate the same anchor + \footnotemark +C% + \footnotemark + \let\saved@Href@C\Hy@footnote@currentHref + + \addtocounter{footnote}{-2}% + \let\Hy@footnote@currentHref\saved@Href@A +\footnotetext{AAAA}% + \addtocounter{footnote}{1}% + \let\Hy@footnote@currentHref\saved@Href@B +\footnotetext{BBBBB}% + \addtocounter{footnote}{1}% + \let\Hy@footnote@currentHref\saved@Href@C +\footnotetext{CCCC}% + +\end{document} +\end{verbatim} + +\subsection{Subordinate counters} + + Some counters do not have unique values and require the value + of other counters to be unique. For example, sections or figures + might be numbered within chapters or \verb|\newtheorem| is used with + an optional counter argument. Internally LaTeX uses \verb|\@addtoreset| + to reset a counter in dependency to another counter. Package + hyperref hooks into \verb|\@addtoreset| to catch this situation. + Also \verb|\numberwithin| of package amsmath is caught by hyperref. + + + + However, if the definition of subordinate counters take place + before hyperref is loaded, the old meaning of \verb|\@addtoreset| is + called without hyperref's additions. Then the companion counter + macro \verb|\theH<counter>| can be redefined accordingly. Or move the + definition of subordinate counters after hyperref is loaded. + + Example for \verb|\newtheorem|, problematic case: +\begin{verbatim} + \newtheorem{corA}{CorollaryA}[section] + \usepackage{hyperref} +\end{verbatim} + Solution a) +\begin{verbatim} + \usepackage{hyperref} + \newtheorem{corA}{CorollaryA}[section} +\end{verbatim} + Solution b) +\begin{verbatim} + \newtheorem{corA}{CorollaryA}[section] + \usepackage{hyperref} + \newcommand*{\theHcorA}{\theHsection.\number\value{corA}} +\end{verbatim} + \section{History and acknowledgments} The original authors of \textsf{hyperbasics.tex} and diff --git a/Master/texmf-dist/source/latex/hyperref/hyperref.dtx b/Master/texmf-dist/source/latex/hyperref/hyperref.dtx index 587275bcf3f..7749997cc0b 100644 --- a/Master/texmf-dist/source/latex/hyperref/hyperref.dtx +++ b/Master/texmf-dist/source/latex/hyperref/hyperref.dtx @@ -48,7 +48,7 @@ %<puvnenc>\ProvidesFile{puvnenc.def} %<puarenc>\ProvidesFile{puarenc.def} %<psdextra>\ProvidesFile{psdextra.def} -%<!none> [2018/02/06 v6.86b % +%<!none> [2018/09/30 v6.88a % %<package> Hypertext links for LaTeX] %<nohyperref> Dummy hyperref (SR)] %<driver> Hyperref documentation driver file] @@ -1378,6 +1378,7 @@ \let\foreignlanguage\@secondoftwo \let\textlatin\@firstofone \ltx@IfUndefined{language@group}{}{% + \let\bbl@info\@gobble \csname HyPsd@babel@\language@group\endcsname }% \HyPsd@GreekPatch @@ -5982,6 +5983,27 @@ \def\pageautorefname{Trang}% } % \end{macrocode} +% Greek, see github issue 52 +% \begin{macrocode} +\def\HyLang@greek{% + \def\equationautorefname{\textEpsilon\textxi\acctonos\textiota\textsigma\textomega\textsigma\texteta}% + \def\footnoteautorefname{\textupsilon\textpi\textomicron\textsigma\texteta\textmu\textepsilon\acctonos\textiota\textomega\textsigma\texteta}% + \def\itemautorefname{\textalpha\textnu\texttau\textiota\textkappa\textepsilon\acctonos\textiota\textmu\textepsilon\textnu\textomicron}% + \def\figureautorefname{\textSigma\textchi\acctonos\texteta\textmu\textalpha}% + \def\tableautorefname{\textPi\acctonos\textiota\textnu\textalpha\textkappa\textalpha}% + \def\partautorefname{\textMu\acctonos\textepsilon\textrho\textomicron\textvarsigma}% + \def\appendixautorefname{\textPi\textalpha\textrho\acctonos\textalpha\textrho\texttau\texteta\textmu\textalpha}% + \def\chapterautorefname{\textkappa\textepsilon\textphi\acctonos\textalpha\textlambda\textalpha\textiota\textomicron}% + \def\sectionautorefname{\textepsilon\textnu\acctonos\textomicron\texttau\texteta\texttau\textalpha}% + \def\subsectionautorefname{\textupsilon\textpi\textomicron\textepsilon\textnu\acctonos\textomicron\texttau\texteta\texttau\textalpha}% + \def\subsubsectionautorefname{\textupsilon\textpi\textomicron-\textupsilon\textpi\textomicron\textepsilon\textnu\acctonos\textomicron\texttau\texteta\texttau\textalpha}% + \def\paragraphautorefname{\textpi\textalpha\textrho\acctonos\textalpha\textgamma\textrho\textalpha\textphi\textomicron\textvarsigma}% + \def\subparagraphautorefname{\textupsilon\textpi\textomicron\textpi\textalpha\textrho\acctonos\textalpha\textgamma\textrho\textalpha\textphi\textomicron\textvarsigma}% + \def\FancyVerbLineautorefname{\textgamma\textrho\textalpha\textmu\textmu\acctonos\texteta}% + \def\theoremautorefname{\textTheta\textepsilon\acctonos\textomega\textrho\texteta\textmu\textalpha}% + \def\pageautorefname{\textsigma\textepsilon\textlambda\acctonos\textiota\textdelta\textalpha}% +} +% \end{macrocode} % % Instead of package babel's definition of \cmd{\addto} the % implementation of package varioref is used. Additionally @@ -6057,6 +6079,7 @@ \HyLang@DeclareLang{italian}{italian}{} \HyLang@DeclareLang{magyar}{magyar}{} \HyLang@DeclareLang{hungarian}{magyar}{} +\HyLang@DeclareLang{greek}{greek}{} % \end{macrocode} % More work is needed in case of options |vietnamese| and |vietnam|. % \begin{macrocode} @@ -6581,6 +6604,12 @@ \HyPsd@PrerenderUnicode{#1}% \pdfstringdef\@pdfcreator{#1}% } +\define@key{Hyp}{addtopdfcreator}{% + \HyXeTeX@CheckUnicode + \HyPsd@XeTeXBigCharstrue + \HyPsd@PrerenderUnicode{#1}% + \pdfstringdef\@pdfcreator{\@pdfcreator, #1}% +} \define@key{Hyp}{pdfcreationdate}{% \begingroup \Hy@unicodefalse @@ -7009,7 +7038,7 @@ \let\@pdftitle\ltx@empty \let\@pdfauthor\ltx@empty \let\@pdfproducer\relax -\def\@pdfcreator{LaTeX with hyperref package} +\def\@pdfcreator{LaTeX with hyperref} \let\@pdfcreationdate\ltx@empty \let\@pdfmoddate\ltx@empty \let\@pdfsubject\ltx@empty @@ -7650,7 +7679,7 @@ \Hy@Info{Link coloring ON}% \else \ifHy@frenchlinks - \def\Hy@colorlink#1{\begingroup\fontshape{sc}\selectfont}% + \def\Hy@colorlink#1{\begingroup\fontshape{\scdefault}\selectfont}% \def\Hy@endcolorlink{\endgroup}% \Hy@Info{French linking ON}% \else @@ -8055,7 +8084,10 @@ % \end{macrocode} % We also have a need to give a \LaTeX\ \emph{label} to a % hyper reference, to ease the pain of referring to it later. +% \verb|\hyperrefundefinedlink| may be redefined by a user +% to add colour or other formatting. % \begin{macrocode} +\let\hyperrefundefinedlink\@firstofone \def\label@hyperref[#1]{% \expandafter\label@@hyperref\csname r@#1\endcsname{#1}% }% @@ -8066,7 +8098,7 @@ Hyper reference `#2' on page \thepage \space undefined% }% \begingroup - #3% + \hyperrefundefinedlink{#3}% \endgroup \else \hyper@@link{\expandafter\@fifthoffive#1}% @@ -9947,7 +9979,7 @@ % % If options |pdftitle| and |pdfauthor| are not used, % these informations for the pdf information dictionary -% can be extracted by the \title and \author. +% can be extracted by the \cmd{\title} and \cmd{\author}. % \begin{macrocode} \ifHy@pdfusetitle \let\HyOrg@title\title @@ -9972,9 +10004,9 @@ }% % \end{macrocode} % -% The case, that \title, or \author are given before +% The case, that \cmd{\title}, or \cmd{\author} are given before % hyperref is loaded, is much more complicate, because -% LaTeX initializes the macros \@title and \@author with +% LaTeX initializes the macros \cmd{\@title} and \cmd{\@author} with % LaTeX error and warning messages. % \begin{macrocode} \begingroup @@ -12460,6 +12492,13 @@ % destination is empty. But if `the most recent destination' is not % what you expect, you will be in trouble. % \begin{macrocode} +% In newer \LaTeX\ releases this is defined to put a \verb|%| at the end of the +% line in the \textt{toc}file. +% \begin{macrocode} +\providecommand\protected@file@percent{} +% \end{macrocode} +% +% \begin{macrocode} \def\addcontentsline#1#2#3{% toc extension, type, tag \begingroup \let\label\@gobble @@ -12506,7 +12545,7 @@ \endgroup \fi \addtocontents{#1}{% - \protect\contentsline{#2}{#3}{\thepage}{\@currentHref}% + \protect\contentsline{#2}{#3}{\thepage}{\@currentHref}\protected@file@percent }% \endgroup } @@ -14161,6 +14200,7 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% @@ -14793,6 +14833,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% @@ -15308,6 +15350,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% @@ -16235,6 +16279,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% @@ -16572,6 +16618,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% @@ -17715,6 +17763,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/hdvipdfm.def b/Master/texmf-dist/tex/latex/hyperref/hdvipdfm.def index 7614c999c97..214f032d372 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hdvipdfm.def +++ b/Master/texmf-dist/tex/latex/hyperref/hdvipdfm.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hdvipdfm.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for dvipdfm] \Hy@VersionCheck{hdvipdfm.def} \def\Hy@PutCatalog#1{\@pdfm@mark{docview <<#1>>}} @@ -536,6 +536,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/hdvips.def b/Master/texmf-dist/tex/latex/hyperref/hdvips.def index 8f4b8b748e1..58dc910b5a8 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hdvips.def +++ b/Master/texmf-dist/tex/latex/hyperref/hdvips.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hdvips.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for dvips] \Hy@VersionCheck{hdvips.def} \providecommand*{\XR@ext}{pdf} diff --git a/Master/texmf-dist/tex/latex/hyperref/hdvipson.def b/Master/texmf-dist/tex/latex/hyperref/hdvipson.def index f09845bf19d..f11c3915fea 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hdvipson.def +++ b/Master/texmf-dist/tex/latex/hyperref/hdvipson.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hdvipson.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for dvipsone] \Hy@VersionCheck{hdvipson.def} \providecommand*{\XR@ext}{pdf} @@ -69,6 +69,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/hdviwind.def b/Master/texmf-dist/tex/latex/hyperref/hdviwind.def index 4878a783a01..fae4fe794ba 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hdviwind.def +++ b/Master/texmf-dist/tex/latex/hyperref/hdviwind.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hdviwind.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for dviwindo] \Hy@VersionCheck{hdviwind.def} \begingroup @@ -323,6 +323,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/hluatex.def b/Master/texmf-dist/tex/latex/hyperref/hluatex.def index e771d65e875..7c8dbcf2051 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hluatex.def +++ b/Master/texmf-dist/tex/latex/hyperref/hluatex.def @@ -32,7 +32,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hluatex.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for luaTeX] \Hy@VersionCheck{hluatex.def} %% Source File: hluatex.dtx diff --git a/Master/texmf-dist/tex/latex/hyperref/hpdftex.def b/Master/texmf-dist/tex/latex/hyperref/hpdftex.def index 281466c4b4c..326d3b0418b 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hpdftex.def +++ b/Master/texmf-dist/tex/latex/hyperref/hpdftex.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hpdftex.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for pdfTeX] \Hy@VersionCheck{hpdftex.def} \pdf@ifdraftmode{% @@ -684,6 +684,7 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/htex4ht.cfg b/Master/texmf-dist/tex/latex/hyperref/htex4ht.cfg index 7481dcb1914..e85ac418905 100644 --- a/Master/texmf-dist/tex/latex/hyperref/htex4ht.cfg +++ b/Master/texmf-dist/tex/latex/hyperref/htex4ht.cfg @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{htex4ht.cfg} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref configuration file for TeX4ht] \IfFileExists{\jobname.cfg}{\endinput}{} \Preamble{html} diff --git a/Master/texmf-dist/tex/latex/hyperref/htex4ht.def b/Master/texmf-dist/tex/latex/hyperref/htex4ht.def index d6f017a8ca0..336d718ecdc 100644 --- a/Master/texmf-dist/tex/latex/hyperref/htex4ht.def +++ b/Master/texmf-dist/tex/latex/hyperref/htex4ht.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{htex4ht.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for TeX4ht] \Hy@VersionCheck{htex4ht.def} \providecommand*{\XR@ext}{html} diff --git a/Master/texmf-dist/tex/latex/hyperref/htexture.def b/Master/texmf-dist/tex/latex/hyperref/htexture.def index 8eb80b594e0..7a2b726e34e 100644 --- a/Master/texmf-dist/tex/latex/hyperref/htexture.def +++ b/Master/texmf-dist/tex/latex/hyperref/htexture.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{htexture.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for Textures] \Hy@VersionCheck{htexture.def} \providecommand*{\XR@ext}{pdf} diff --git a/Master/texmf-dist/tex/latex/hyperref/hvtex.def b/Master/texmf-dist/tex/latex/hyperref/hvtex.def index 12f3fcb3300..22fba2ab4bc 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hvtex.def +++ b/Master/texmf-dist/tex/latex/hyperref/hvtex.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hvtex.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for VTeX in PDF/PS mode] \Hy@VersionCheck{hvtex.def} \providecommand*{\XR@ext}{pdf} @@ -630,6 +630,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/hvtexhtm.def b/Master/texmf-dist/tex/latex/hyperref/hvtexhtm.def index a49215a7a6f..614298ca3a6 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hvtexhtm.def +++ b/Master/texmf-dist/tex/latex/hyperref/hvtexhtm.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hvtexhtml.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for VTeX in HTML mode] \Hy@VersionCheck{hvtexhtm.def} \providecommand*{\XR@ext}{htm} diff --git a/Master/texmf-dist/tex/latex/hyperref/hvtexmrk.def b/Master/texmf-dist/tex/latex/hyperref/hvtexmrk.def index 5a9a79feccb..368f50196ec 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hvtexmrk.def +++ b/Master/texmf-dist/tex/latex/hyperref/hvtexmrk.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hvtexmrk.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for VTeX in PDF/PS mode (pdfmark specials)] \Hy@VersionCheck{hvtexmrk.def} \providecommand*{\XR@ext}{pdf} diff --git a/Master/texmf-dist/tex/latex/hyperref/hxetex.def b/Master/texmf-dist/tex/latex/hyperref/hxetex.def index a45c9593e9b..3b8d630977b 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hxetex.def +++ b/Master/texmf-dist/tex/latex/hyperref/hxetex.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hxetex.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for XeTeX] \Hy@VersionCheck{hxetex.def} \HyPsd@LoadUnicode @@ -618,6 +618,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/hyperref.sty b/Master/texmf-dist/tex/latex/hyperref/hyperref.sty index 1573de7c4e8..f9a40356fbd 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hyperref.sty +++ b/Master/texmf-dist/tex/latex/hyperref/hyperref.sty @@ -32,7 +32,7 @@ %% \NeedsTeXFormat{LaTeX2e}[1995/12/01] \ProvidesPackage{hyperref} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hypertext links for LaTeX] \begingroup \@makeother\`% @@ -517,6 +517,7 @@ \let\foreignlanguage\@secondoftwo \let\textlatin\@firstofone \ltx@IfUndefined{language@group}{}{% + \let\bbl@info\@gobble \csname HyPsd@babel@\language@group\endcsname }% \HyPsd@GreekPatch @@ -3401,6 +3402,24 @@ \def\theoremautorefname{\DJ{}\d{i}nh l\'y}% \def\pageautorefname{Trang}% } +\def\HyLang@greek{% + \def\equationautorefname{\textEpsilon\textxi\acctonos\textiota\textsigma\textomega\textsigma\texteta}% + \def\footnoteautorefname{\textupsilon\textpi\textomicron\textsigma\texteta\textmu\textepsilon\acctonos\textiota\textomega\textsigma\texteta}% + \def\itemautorefname{\textalpha\textnu\texttau\textiota\textkappa\textepsilon\acctonos\textiota\textmu\textepsilon\textnu\textomicron}% + \def\figureautorefname{\textSigma\textchi\acctonos\texteta\textmu\textalpha}% + \def\tableautorefname{\textPi\acctonos\textiota\textnu\textalpha\textkappa\textalpha}% + \def\partautorefname{\textMu\acctonos\textepsilon\textrho\textomicron\textvarsigma}% + \def\appendixautorefname{\textPi\textalpha\textrho\acctonos\textalpha\textrho\texttau\texteta\textmu\textalpha}% + \def\chapterautorefname{\textkappa\textepsilon\textphi\acctonos\textalpha\textlambda\textalpha\textiota\textomicron}% + \def\sectionautorefname{\textepsilon\textnu\acctonos\textomicron\texttau\texteta\texttau\textalpha}% + \def\subsectionautorefname{\textupsilon\textpi\textomicron\textepsilon\textnu\acctonos\textomicron\texttau\texteta\texttau\textalpha}% + \def\subsubsectionautorefname{\textupsilon\textpi\textomicron-\textupsilon\textpi\textomicron\textepsilon\textnu\acctonos\textomicron\texttau\texteta\texttau\textalpha}% + \def\paragraphautorefname{\textpi\textalpha\textrho\acctonos\textalpha\textgamma\textrho\textalpha\textphi\textomicron\textvarsigma}% + \def\subparagraphautorefname{\textupsilon\textpi\textomicron\textpi\textalpha\textrho\acctonos\textalpha\textgamma\textrho\textalpha\textphi\textomicron\textvarsigma}% + \def\FancyVerbLineautorefname{\textgamma\textrho\textalpha\textmu\textmu\acctonos\texteta}% + \def\theoremautorefname{\textTheta\textepsilon\acctonos\textomega\textrho\texteta\textmu\textalpha}% + \def\pageautorefname{\textsigma\textepsilon\textlambda\acctonos\textiota\textdelta\textalpha}% +} \def\HyLang@addto#1#2{% #2% \@temptokena{#2}% @@ -3468,6 +3487,7 @@ \HyLang@DeclareLang{italian}{italian}{} \HyLang@DeclareLang{magyar}{magyar}{} \HyLang@DeclareLang{hungarian}{magyar}{} +\HyLang@DeclareLang{greek}{greek}{} \DeclareVoidOption{vietnamese}{% \HyLang@addto\extrasvietnamese\HyLang@vietnamese \Hy@AtEndOfPackage{% @@ -3886,6 +3906,12 @@ \HyPsd@PrerenderUnicode{#1}% \pdfstringdef\@pdfcreator{#1}% } +\define@key{Hyp}{addtopdfcreator}{% + \HyXeTeX@CheckUnicode + \HyPsd@XeTeXBigCharstrue + \HyPsd@PrerenderUnicode{#1}% + \pdfstringdef\@pdfcreator{\@pdfcreator, #1}% +} \define@key{Hyp}{pdfcreationdate}{% \begingroup \Hy@unicodefalse @@ -4297,7 +4323,7 @@ \let\@pdftitle\ltx@empty \let\@pdfauthor\ltx@empty \let\@pdfproducer\relax -\def\@pdfcreator{LaTeX with hyperref package} +\def\@pdfcreator{LaTeX with hyperref} \let\@pdfcreationdate\ltx@empty \let\@pdfmoddate\ltx@empty \let\@pdfsubject\ltx@empty @@ -4846,7 +4872,7 @@ \Hy@Info{Link coloring ON}% \else \ifHy@frenchlinks - \def\Hy@colorlink#1{\begingroup\fontshape{sc}\selectfont}% + \def\Hy@colorlink#1{\begingroup\fontshape{\scdefault}\selectfont}% \def\Hy@endcolorlink{\endgroup}% \Hy@Info{French linking ON}% \else @@ -5156,6 +5182,7 @@ \expandafter\hyper@@anchor\expandafter{\Hy@AnchorName}{\relax}#3% \fi } +\let\hyperrefundefinedlink\@firstofone \def\label@hyperref[#1]{% \expandafter\label@@hyperref\csname r@#1\endcsname{#1}% }% @@ -5166,7 +5193,7 @@ Hyper reference `#2' on page \thepage \space undefined% }% \begingroup - #3% + \hyperrefundefinedlink{#3}% \endgroup \else \hyper@@link{\expandafter\@fifthoffive#1}% @@ -8094,6 +8121,7 @@ \g@addto@macro\Hy@EveryPageBoxHook{% \Hy@EveryPageAnchor } +\providecommand\protected@file@percent{} \def\addcontentsline#1#2#3{% toc extension, type, tag \begingroup \let\label\@gobble @@ -8140,7 +8168,7 @@ \endgroup \fi \addtocontents{#1}{% - \protect\contentsline{#2}{#3}{\thepage}{\@currentHref}% + \protect\contentsline{#2}{#3}{\thepage}{\@currentHref}\protected@file@percent }% \endgroup } diff --git a/Master/texmf-dist/tex/latex/hyperref/hypertex.def b/Master/texmf-dist/tex/latex/hyperref/hypertex.def index 00117194bce..1a62de384fe 100644 --- a/Master/texmf-dist/tex/latex/hyperref/hypertex.def +++ b/Master/texmf-dist/tex/latex/hyperref/hypertex.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{hypertex.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref driver for HyperTeX specials] \Hy@VersionCheck{hypertex.def} \providecommand*{\XR@ext}{dvi} diff --git a/Master/texmf-dist/tex/latex/hyperref/nohyperref.sty b/Master/texmf-dist/tex/latex/hyperref/nohyperref.sty index 05e9df8a968..c37c61cd67e 100644 --- a/Master/texmf-dist/tex/latex/hyperref/nohyperref.sty +++ b/Master/texmf-dist/tex/latex/hyperref/nohyperref.sty @@ -32,7 +32,7 @@ %% \NeedsTeXFormat{LaTeX2e}[1995/12/01] \ProvidesPackage{nohyperref} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Dummy hyperref (SR)] \RequirePackage{letltxmacro}[2008/06/13] \let\hyper@@anchor\@gobble diff --git a/Master/texmf-dist/tex/latex/hyperref/pd1enc.def b/Master/texmf-dist/tex/latex/hyperref/pd1enc.def index d3216dd053e..43e7da2b3ff 100644 --- a/Master/texmf-dist/tex/latex/hyperref/pd1enc.def +++ b/Master/texmf-dist/tex/latex/hyperref/pd1enc.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{pd1enc.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref: PDFDocEncoding definition (HO)] \DeclareFontEncoding{PD1}{}{} \DeclareTextAccent{\`}{PD1}{\textasciigrave} diff --git a/Master/texmf-dist/tex/latex/hyperref/pdfmark.def b/Master/texmf-dist/tex/latex/hyperref/pdfmark.def index d0dc442c8f3..294f9fede13 100644 --- a/Master/texmf-dist/tex/latex/hyperref/pdfmark.def +++ b/Master/texmf-dist/tex/latex/hyperref/pdfmark.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{pdfmark.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref definitions for pdfmark specials] \Hy@VersionCheck{pdfmark.def} \begingroup @@ -397,6 +397,8 @@ \Hy@DisableOption{pdftitle}% \Hy@DisableOption{pdfsubject}% \Hy@DisableOption{pdfcreator}% + \Hy@DisableOption{addtopdfcreator}% + \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfcreationdate}% \Hy@DisableOption{pdfmoddate}% \Hy@DisableOption{pdfproducer}% diff --git a/Master/texmf-dist/tex/latex/hyperref/psdextra.def b/Master/texmf-dist/tex/latex/hyperref/psdextra.def index 726c5513f88..7860cb31c30 100644 --- a/Master/texmf-dist/tex/latex/hyperref/psdextra.def +++ b/Master/texmf-dist/tex/latex/hyperref/psdextra.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{psdextra.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref: Additions to PDF string support] \Hy@VersionCheck{psdextra.def} \newcommand*{\psdmapshortnames}{% diff --git a/Master/texmf-dist/tex/latex/hyperref/puarenc.def b/Master/texmf-dist/tex/latex/hyperref/puarenc.def index a9652bb5ebf..7d3a6f55025 100644 --- a/Master/texmf-dist/tex/latex/hyperref/puarenc.def +++ b/Master/texmf-dist/tex/latex/hyperref/puarenc.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{puarenc.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref: Additions to puenc.def for Arabi] \DeclareTextCommand{\hamza}{PU}{\86\041}% U+0621 \DeclareTextCommand{\alefmadda}{PU}{\86\042}% U+0622 diff --git a/Master/texmf-dist/tex/latex/hyperref/puenc.def b/Master/texmf-dist/tex/latex/hyperref/puenc.def index 9b6cb4a939c..367dd2d9b8d 100644 --- a/Master/texmf-dist/tex/latex/hyperref/puenc.def +++ b/Master/texmf-dist/tex/latex/hyperref/puenc.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{puenc.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref: PDF Unicode definition (HO)] \DeclareFontEncoding{PU}{}{} \DeclareTextCommand{\`}{PU}[1]{#1\83\000}% U+0300 diff --git a/Master/texmf-dist/tex/latex/hyperref/puvnenc.def b/Master/texmf-dist/tex/latex/hyperref/puvnenc.def index b1ac9e12239..be872d38b59 100644 --- a/Master/texmf-dist/tex/latex/hyperref/puvnenc.def +++ b/Master/texmf-dist/tex/latex/hyperref/puvnenc.def @@ -31,7 +31,7 @@ %% given in the file `manifest.txt'. %% \ProvidesFile{puvnenc.def} - [2018/02/06 v6.86b % + [2018/09/30 v6.88a % Hyperref: Additions to puenc.def for VnTeX] \DeclareTextCommand{\abreve}{PU}{\81\003}% U+0103 \DeclareTextCommand{\acircumflex}{PU}{\80\342}% U+00E2 |