diff options
| author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
| commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
| tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/hyperref | |
| parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) | |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref')
55 files changed, 13586 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/ChangeLog b/Master/texmf-dist/doc/latex/hyperref/ChangeLog new file mode 100644 index 00000000000..bede770d64d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/ChangeLog @@ -0,0 +1,1656 @@ +2003-12-03 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * nameref 2.21 + * \ref and \pageref are defined at any case, if hyperref + is not loaded. + +2003-11-30 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74m + * \textcolor disabled in bookmarks. + +2003-11-15 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74l + * Typo fixed by Werner Lemberg: s/CJK@punktcharx/CJK@punctcharx/ + +2003-10-30 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * nameref 2.10: titlesec support added. + +2003-10-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74k + * Fix for more than one footnote in longtable's + columns of type "p". + +2003-10-06 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74j + * Bug fix: automatic link type detection failed for + url field in references (eg. imported labels by xr-hyper). + +2003-09-15 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74i + * Bug fix (\if-commands after \ifx of 6.74h's "fleqn" detection). + +2003-07-27 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74h + * The lost source for the manual is rewritten by Steve Peter + and updated by Karl Berry. + * Bug fix of 6.74f does not work for amsmath's option "fleqn", + the \label does not detect the equation number, therefore + the fix is disabled, if "fleqn" is detected. + +2003-07-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74g + * Bug fixed in pdfmark.def: definition of \strip@pt@and@otherjunk + moved before \endinput by implicit=false. + +2003-07-10 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74f + * Fix for wrong vertical spacing between amsmath's + equation environments (Dmitri Chubarov <chubarik@gorodok.net>). + +2003-06-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74e + * README: Hint for hypcap added. + * pdfmark.def: "cvn" added for named GoToR destination + (Reinhard Jahraus). + +2003-05-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74d + * An empty dictionary /ViewerPreferences is now suppressed. + +2003-05-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74c + * \@addtoreset: \edef replaced by \xdef. + +2003-04-28 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74b + * Patch for float.sty compatibility (Anselm Lingnau/Marco Kuhlmann). + * Tried better anchor setting for floats that are controlled + by float.sty. Several captions inside one float are not supported. + +2003-04-27 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.74a + * \newcounter{foo}[bar]: using \theHbar, if available. + +2003-04-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73z + * New option "pdfdisplaydoctitle" (PDF 1.4). + * New option "pdfnonfullscreenpagemode". + +2003-03-31 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73y + * Also the KOMA-Script classes redefine \LT@array, therefore + longtable fix extended. + +2003-03-25 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73x + * Behaviour of warning "bookmark level for unknown ..." changed: + * The missing \toclevel@... command is globally defined + to avoid further warnings. + * If this entry is not used for the bookmarks, the + warning is changed into a \PackageInfo. + * Language support for Afrikaans added. + +2003-03-21 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73w + * Errors corrected in documentation part. + +2003-03-21 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73v + * \hyperpage now ignores spaces and empty arguments. + +2003-03-21 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73u + * Option "encap", other encap character for use with hyperindex + can be given. + +2003-03-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73t + * hyperref now uses the same method for language support as + backref 1.23. + * Change from \captions<lang> to \extras<lang>. + * backref 1.23 + Babel support for language strings added + (suggestion of Danie Els). + +2003-03-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73s + * Default for \itemautorefname added. + * backref 1.22 + Bug fixes and additions of Danie Els <dnjels@sun.ac.za>: + * Typo fixed in \backreflastsep. + * Package natbib support, if hyperref is not loaded. + * Language Afrikaans added. + * hyperref.ins: + hyperref.drv and hycheck.tex are put outside the scope + of \usedir. + +2003-03-19 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73r + * \hyper@link@: \@safe@activestrue used for internal name + * backref 1.21: + * Continued with inserting of \@safe@activestrue. + * \backrefxxxdupe added for comparision and detection + of dupes. + * \backrefalt added with more powerful interface with macros + \backrefsep, \backreftwosep, and \backreflastsep. + * Language options added. + * More documentation. + +2003-03-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73q + * Suppressing /URI entry if \@baseurl is empty (hpdftex, hdvipsone). + * /URI moved to Cataloge (hdvipsone). + * Some locations of "file:" replaced by \Hy@linkfileprefix. + +2003-03-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73p + * Patch for longtable added (problem reported by Thomas Beuthe). + +2003-02-11 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73o + * Support for babel's shorthands in \autoref fixed. + * Support for \autoref in bookmarks added. + * Option final added similar to graphics.sty, article.cls, ... + * \hyperref[#1] does now use babel's \@safe@activestrue. + +2003-01-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73n + * Unsafe key value pair: Action=<<...#2...#3...>> + replaced by: Action={<<...#2...#3...>>} + because it breaks, if #2 or #3 contain a comma. + +2003-01-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73m + * Support for \@makecaption of class IEEEtran with + three arguments removed, because version V1.6b uses + the standard LaTeX interface with two arguments. + +2003-01-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73l + * Footnote fix: Initialization of \Hy@footnote@currentHref + added (Thorsten Schwander <schwander@horse.lanl.gov>). + +2003-01-17 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73k + * Footnote fix: \label commands inside \footnote do + not need nameref support (\@currentlabelname). + +2003-01-17 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73j + * Fix for footnote code: a \label after \footnote + commands refers to the previous section or similar + and not to the footnote. + +2002-12-15 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73i + * \texteuro fixed for PU encoding, + Maksym Polyakov <polyama@myrealbox.com>. + +2002-12-10 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73h + * Bugreport of Michael W Daniels <daniels@ling.ohio-state.edu>: + height in \TextField is not respected, if multiline is set. + * Fixed by moving the height setting code in the default + section. + * Also "4\DefaultHeightofText" replaced by a more robust + construct. + +2002-12-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73g + * \edef instead of \def for comparison with value of option + bookmarkstype (in \@@writetorep), the following should + work: bookmarkstype=lof + +2002-12-03 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73f + * Option "setpagesize" added also for VTeX's \mediawidth/height. + * VTeX: \mediawidth/height is only set with positive dimen values. + +2002-11-29 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73e + * Option "setpagesize" added. + +2002-11-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73d + * Support for \@addtoreset added, similar to + \numberwithin (idea of Markus Kohm in + de.comp.text.tex). + +2002-11-07 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73c + * Added "hyperpage" also after "closing range" + (\index{...|)hyperpage}), because it is allowed + for makeindex and necessary for XIndy. + +2002-11-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73b + * \Hy@raisedlink for caption without option nesting. + * Support for \@makecaption of class IEEEtran that + uses three arguments. + +2002-10-24 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.73a + * vtexpdfmark: pdfborder={0 0 1} (Walter Schmidt). + +2002-10-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72z + * A small remainder of option 4 removed. + * options.tex: option pdfpagelabels added, + option 4 removed. + +2002-09-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72y + * Addition to \hyper@normalise: \_, \textunderscore, + \textasciitilde. + +2002-09-04 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72x + * \ReadBookmarks is disabled if bookmarks=false is given. + * \Hy@raisedlink introduced into \hyper@natanchorstart + (Thanks to Macro Kuhlmann <mk@mcqm.net>). + +2002-08-24 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72w + * "\let\pdfoutput\@undefined" removed. + * Bug fix: option bookmarksnumbered is now respected, + if package slidesec is used. + +2002-08-04 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72v + * Koma classes: optional argument for \maketitle. + +2002-08-03 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72u + * \appendix: \Hy@org@appendix moved to the end + and renamed to \HyOrg@appendix. + +2002-07-25 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72t + * Support for footnotes in p-columns of longtables. + +2002-06-06 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72s + * \Hy@defaultdriver used, so that "hypertex" can + be redefined in hyperref.cfg (eg. "dvips"). + +2002-06-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * backref 1.20 + * Babel's \@safe@activestrue inserted to bibitem commands. + But problems with \cite remains (frenchb.ldf). + +2002-05-27 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72r + * Problem with varioref's \vref@pagenum fixed + (Thanks to Felix Neubauer <felix.neubauer@gmx.net>). + +2002-05-10 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72q + * Some spaces in PDF output of driver pdftex removed. + +2002-05-09 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72p + * Option `pdfusetitle' now correctly disabled. + +2002-04-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72o + * Bug fix of 6.72n is wrong: + Octal escape sequences (\000) are not detected by the method + with \meaning. Now another method, based on \dospecials, is + used to protect active characters while reading the .out file. + +2002-04-19 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72n + * Bug fixed in \ReadBookmarks of driver vtex: + the text arguments in the .out file are + now protected. + +2002-04-15 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72m + * Adaption to subfigure 2002/03/26 v2.1.2. It uses + \AtBeginDocument{...\newcommand{\toclevel@subfigure}...}. + +2002-04-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72l + * Fix from Werner Lemberg <wl@gnu.org> for + bookmarks with Big5 encoded strings, + preprocessed by package cjk. + +2002-04-09 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72k + * \protected@edef instead of \edef in \hyper@link@. + +2002-03-27 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72j + * Tried to fix the problem that links to + bibliography points to baseline if pdfTeX is + used by inserting \Hy@raisedlink. + * \Hy@raisedlink disabled for pdfmark drivers, + because they use a PostScript method. + +2002-03-15 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72i + * \toclevel@subfigure and \toclevel@subtable fixed. + +2002-03-15 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72h + * New structure on tug server. + * Makefile: target "distrib" removed. + * Textures update by Ross Moore <ross@maths.mq.edu.au>. + +2002-03-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72g + * Added fix for subfigure 2002/02/14 v2.1. + Loading order: nameref, subfigure, hyperref. + +2002-03-08 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72f + * dvipdfm: pdfstartpage and pdfstartview fixed + (Akira Kakuto <kakuto@fuk.kindai.ac.jp>). + +2002-02-16 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72e + * \pdfstringdef: \cyr disabled for russian.ldf + * \pdfstringdef: shorthands for macedonian.ldf + * VTeX 7.54: pdfnewwindow supported in \hyper@linkfile. + +2002-01-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72d + * Bug fix: \Hy@title, \Hy@author. + +2002-01-08 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72c + * pdfmark.def: /URI moved from /DOCVIEW to {Catalog}. + * pdfmark.def: Unused \@dobaseurl removed. + +2002-01-07 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72b + * Support of \stockwidth and \stockheight (memoir class). + +2002-01-06 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.72a + * Annotation's additinal-actions dictionary for form fields: + Supported: keystroke (/K), validate (/V), format (/F) + and now added: onfocus (/Fo), onblur (/Bl), + onmousedown (/D), onmouseup (/U), + onenter (/E), onexit(/X) + * Additional-actions dictionary added in \PDFForm@List and + \PDFForm@Radio. + * \PDFForm@Text: "/Ff 1" added, if only \ifFld@readonly is set. + +2001-12-23 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71z + * Some \providecommand replaced by \providecommand*. + * Babel's \@number of file lrbabel.def inserts + unexpandable tokens into the expansion of \arabic. + At some places dummy for \@number inserted, where + anchor and link names are expanded. + +2001-12-21 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71y + * Support for chapterbib added, provided by + Julian Gilbey <J.D.Gilbey@qmul.ac.uk>. + +2001-12-06 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71x + * Added fix by Denis Girou for pst-key.tex (1998, + derived from old keyval.dtx). Any initial brace group + in the value field is removed. + +2001-11-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71w + * Added suggestion of Didier Verna <didier@lrde.epita.fr>: + The fix for multind is also applied for package index. + +2001-11-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71v + * The feature of 6.71r with automatic detection of + title and author can be enabled by option + pdfusetitle. The default is disabled. + * If pdfusetitle is enabled, an optional argument + is detected for \title and \author (amsart class). + +2001-11-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71u + * \literalps@out for dviwindo (D.P. Story). + +2001-11-04 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71t + * The patch for harvard is delayed by \AtBeginDocument + to solve a problem with the package load order, if + html.sty is present (Command \harvarditem already + defined). + * The fix for the Adobe bug introduced in 6.71n + is changed completely, because Adobe's suggestion + generates an extra empty page at the end. + (\literalps@out for dviwindo is currently only a dummy.) + +2001-10-30 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71s + * If "\\" or "\newline" are used in \title or + \author and reused for the pdf information + entries, then they are replaced by a space + or a comma and space, see hyperref.dtx. + +2001-10-11 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71r + * Detection of \author and \title added for + defaults of pdf information entries. + +2001-09-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71q + * Fix for Adobe bug of 6.71n: + * VTeX in PS mode with GeX: \immediate\special{!=...} + +2001-09-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71p + * Fix for Adobe bug of 6.71n improved: + * Support for dviwindo added (D.P. Story). + * Check for product added (product is level 2). + +2001-09-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71o + * Warning, if \hypercalcbp is used without + package calc or e-TeX. + * Use of \hypercalcbp removed to avoid the above warning. + * \usepackage{calc} added in testams.tex. + +2001-09-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71n + * If package tex4ht is loaded, option tex4ht + is added to hyperref's option list + (Eitan Gurari <gurari@cis.ohio-state.edu>). + * Bug fix added for Adobe Distiller 5 + (Adobe bug number 466320, thanks to + D.P. Story and M. Vulis). + * testams.tex fixed. + +2001-08-19 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71m + * VTeX's \OpMode=3 is accepted the same way as 1 and 2. + +2001-08-19 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71l + * OS part in VTeX's /Producer default corrected. + +2001-08-19 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71k + * Default of /Producer string: + * updated for pdfTeX >= 1.00a, + * pdfeTeX detection added, + * \VTeXOS added for VTeX >= 7.45. + +2001-08-16 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71j + * Translation of \autoref names to brazil/portuges by + Willie Dresler Leiva <dreslerleiva@hotmail.com>. + * test/test0.dvi removed. + * test/test7.tex: \usepackage{times} to get smaller test7.pdf. + * Makefile: targets clean and distrib updated, $(RM) introduced. + +2001-08-10 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71i + * Compatibility problem with xypic, introduced by + version 6.71g, fixed. + +2001-07-03 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * Two small fixes of Makefile, provided by + Martin Maechler <maechler@stat.math.ethz.ch>. + +2001-06-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71h + * Option pdfpagemode with empty argument sets + default behaviour (an alternative would be "UseNone") + in order to avoid the wrong name "/". +2001-05-26 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71g + * Contributions by Ross Moore <ross@ics.mq.edu.au> and + Daniel Steffen: + a. patch to htexture.def that adjusts the PDF@SetupDoc + so that it includes the setup information from pdfmark.def + as well as the tokens needed by Textures itself. + b. changes to the \AtBeginDocument usage to implement + compatibility with the ldump.sty package. + * Bug fix in multind support (forgotten backslash). + * Fix for driver pdftex: \pdfpagewidth and \pdfpageheight + are not set, if \paperwidth or \paperheight are zero, + because it is likely that the settings of pdftex.cfg + are better than the heuristics of pdfTeX, if the dimen + lengths are zero. + +2001-04-13 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71f + * Feature request of Jens-Uwe Morawski <morawski@gmx.net>: + \thispdfpagelabel introduced. + +2001-04-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71e + * \@begindvi changed: + * \Hy@begindvi for hyperref stuff in \@begindvi introduced, + * small bug fix (first page with options + pdfpagelabels + pageanchor=false). + +2001-04-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71d + * Fix for \@@Radio in hdvipdfm.def for AR5, provided + by D. P. Story <story@uakron.edu>. + * Spell error corrected (\Hy@captionsspanish). + * The fix of 6.71b for VTeX paper size was introduced + to solve problem with prosper, but because of new problem + with pdfscreen, the fix is redone. + +2001-02-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71c + * Bug fix, introduced in 6.71b. + +2001-02-20 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71b + * Fixes by Markus Kohm: + * Applying the \@addchap hack for scrreprt. + * Disabling the \@addchap hack for komascript + versions since 2001/01/01, because these + versions contain hyperref support. + * The \@ssect, \@schapter, ... hacks are also applied + to driver hypertex. + * Fixes by Alex (VTeX): + * Correction of paper size setting. + * /Replace transition supported. + +2001-01-27 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * nameref 2.19: + option final of showkeys now detected. + +2000-11-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.71a + * Two errorneous garbage lines removed, they cause + an infinite loop with \autoref{<equation|footnote>}. + +2000-10-04 Sebastian Rathz <sebastian.rahtz@oucs.ox.ac.uk> + * 6.71 CTAN release + +2000-09-29 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70y + * Check of empty /Dest and /DestAnchor values + improved (\pdfmark). + +2000-09-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70x + * Next typo fixed (option american). + +2000-09-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70w + * \DeclareRobustCommand: \href, \url, \hyperimage, + \hyperref + * Typo fixed (option american). + +2000-09-07 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70v + * Fix for option CJKbookmarks. + +2000-09-06 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70u + * Fix of \pdf@rect and \@hyperfixhead for seminar + * Default for \special@paper with values for + packages typearea or geometry. + * Fix for seminar: true values for \pdf{h,v}origin + and \pdfpage{width,height} (Thanks to + Stephan Lehmke). + * File `test/seminar.con' replaced by environment + `filecontents' in file `testslide.tex'. + +2000-09-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70t + * Fixes for packages listings and listing. + * Some \setbox...=\hbox replaced by color safer + constructs. + * Patch for bookmarks with package cjk, enabled + with option `CJKbookmarks'. + +2000-08-31 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70s + * URLs, broken by bibTeX, work now: + \url{% + http://www.% + dante.de/% + } + ("%^^M" are detected and removed, thanks + Stefan Ulrich <ulrich@cis.uni-muenchen.de> + for his suggestion.) + * Checks added to hycheck.tex + * \caption checks whether \@captype is defined. + +2000-08-30 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70r + * Shorter PostScript names (/H.X) for drivers of dvips type. + * Bug fix (hvpdfmark.def): /pdf@voff + * New test file `hycheck.tex'. + * Bug fix: latex/2318 fix added to \@caption. + * Bug fix: \numberwithin + +2000-07-30 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70q + * VTeX: further fixes. + +2000-07-17 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70p + * \test@reftype fixed (used for \autoref). + * autorefnames: german fixed, spanish added. + * VTeX: additions and fixes from Alex Kostin. + +2000-07-04 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70o + * Test files testbm{oe,sc,zc,yi,l}.tex merged to testbma.tex. + * Added correct \@hyper@launch for hvtex.def (Alex Kostin). + +2000-07-03 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70n + * Default for \Hy@pageheight changed from A4 to + setting via \hypercalcbp and \paperheight. + +2000-07-02 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70m + * Feature added: \hypercalcbp (see hyperref.dtx). + +2000-07-02 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70l + * Bugfix in onopen of 6.70k undoned. It will + be fixed in VTeX itself. + +2000-07-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70k + * Own section for vtexpdfmark driver and + PostScript code fixed. + * Bug in hvtex.def fixed: missing space in onopen special. + +2000-07-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70j + * hyperref.ins for vtexpdfmark corrected. + +2000-07-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70i + * Start of new VTeX driver that support pdfmark specials. + Option `vtexpdfmark', file `vtexmrk.def' + (contributed by Michael Vulis). + * hyperref.ins: hvtexmrk.def added. + +2000-06-30 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70h + * nohyperref: \hyperpage disabled. + * Defaults for \autoref's names only define \...autorefname. + * Problem with \hyper@hash fixed. + * \nolinkurl added (variant of \url, that does not make + a link, eg. for use in the second argument of \href). + * Problem fixed, that warning ``Label(s) may have changed.'' + always appears with `babel' and `\bibcite'. + * Update of htextures.def by Ross Moore <ross@ics.mq.edu.au>: + * the blue rectangles no longer appear with `colorlinks', + * pdfmark support, + * the built-in support for hypertex specials is + utilised. + * Update of hvtex.def by Michael Vulis + <support@micropress-inc.com>: + * Bug in \Acrobatmenu fixed. + * Transition effects added (written by Alex Kostin). + * pdfmark.def: Character slash `/' now works + in destination names (eg: "cite.OMG:formal/98-12-01"). + +2000-05-08 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70g + * \autoref names: To solve the uppercase problem, + first the names \...autorefname are used in \autoref. + Language options added for english and german languages. + +2000-05-08 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70f, nameref: 2.18 + * Anchor of foonotes raised. + * showkey support (nameref.dtx: \label, \ref, \pageref, \nameref, + not checked and tested is \cite). + * \@xfootnotetext calls \H@@mpfootnotetext, if called in minipage. + * Bug \href{foo.pdf#bar} fixed, introduced in 6.70c. + * Bug harvard/backref fixed ({\thepage}{\current@label}). + +2000-04-12 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70e + * Empty reference causes crash of distiller, therefore + empty references replaced by UNDEFINED + (pdftex, pdfmark, dvips, vtex, dvipdfm). + +2000-04-11 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70d + * hvtexhtm detected as default driver. + * Bug fix (undefined \pageref within \ifthenelse). + +2000-03-31 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70c + * \hyper@normalise: %, \%, #, \# expands to catcode `other' + characters, \url{http://foo.bar/%2e_~#hash} should work. + * \pdfBorderAttrs removed and replaced by + "/Border [\@pdfborder]". + If option colorlinks is set, the border is set to zero + immediately, not \AtBeginDocument (for people who + want to have both borders and colored links). + +2000-03-31 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70b + * Definition of \x remains unchanged (bug introduced in 6.67g). + * Packages titlesec and titletoc support by Javier Bezos + <jbezos@arrakis.es>. + * \MP added (\pdfbookmarkstring, htex4ht.cfg). + * All files of hyperref.dtx now identify themselves + by \Provides{File,Package}. + * Start with nohyperref.sty (SR), toc-level addtions by HO. + * Updated: testbm{gl,u}.tex + +2000-03-23 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.70a + * New option: pdfpageduration for the /Dur key + in the pdf page object, the value is empty or + contains the length in seconds (real). + Supported drivers: pdftex, pdfmark. + * New option: pdfpagehidden for the /Hid key + in the pdf page object, the value is a boolean. + Supported drivers: pdftex, pdfmark. + +2000-03-22 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * 6.70 CTAN release (TeX Live 5) + +2000-03-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.69f + * \@ifundefined{thechapter} changed to \@ifundefined{chapter} + because of compatibility with french.sty. + * xr-hyper.sty: \xdef changed to \protected@xdef + (Stephan Lehmke <Stephan.Lehmke@cs.uni-dortmund.de>). + * hvtex.def: default for pdfview changed to xyz. + +2000-03-07 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.69e + * Fix for babel/3174 (\@save@activestrue in \hyper@normalise). + +2000-03-02 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.69d + * Fix for \texttilde with babel's spanish, estonian, galician + * Expandable versions without link of \ref and \pageref: + \hypergetref and \hypergetpageref. + * \ifthenelse: \ref and \pageref use the \hyperget... variants. + * \hyper@chars added in \hyper@anchor of drivers + hypertex, vtexhtml, and vtex. + * Forms: checkboxsymbol introduced (Michael Wiedmann + <michael.wiedmann@detewe.de>). + * Redefinitions in \appendix are made globally + (Tim J Harding <Tim.Harding@quadstone.com>). + * If \chapter is undefined, it remains now undefined. + +2000-01-22 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.69c + * D. P. Story <story@uakron.edu> has adapted forms + part of pdfTeX to dvipdfm. + +2000-01-21 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.69b + * \@writetorep: destination and level check added. + * \addcontentsline: \phantomsection added, if no destination. + +2000-01-19 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.69a + * Bug fixed: tabularx+\maketitle+\footnote. + * LPPL 1.2, manifest.txt updated. + +2000-01-18 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * 6.69 CTAN release + * Missing test files added. + +2000-01-17 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.68a + * pdfpagescrop works now with dvipdfm (D. P. Story + <story@uakron.edu>). + +2000-01-13 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * 6.68 CTAN release + +2000-01-11 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67h + * pdfpagemode: /None corrected to /UseNone. + * \pdfstringdef: \halign disabled (because of errors by #). + * Option draft: bookmarks are disabled (thanks to Michael Vulis). + * Outdated bookmark documentation removed. + * hvtex.def: \media{width,height} supported. + * Space after \@pdfhighlight inserted (hpdftex.def). + * Bug fixed in redefinition of \@chapter. + * Small bug fixed in \Hy@boolkey. + +1999-12-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67g + * test/phys332-{1,2}.jpg renamed to test/phys{1,2}.jpg + * Improved \catcode check and settings at the beginning + of hyperref.sty. + * [#1]-Bug fixed by [{#1}] in the definition of \htmlref + and \@newctr and in many uses of \pdfmark. + +1999-11-24 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67f + * Test files checked by Sebastian Rahtz. + * Unwanted spaces removed (dviwindo, outline). + * Redone: \def\texorpdfstring to \newcommand* + * Other implementation of \HyPSD@tocsection by Michael Downes. + * ps2pdf: Default for pdfborder: 0 0 1 + * \belowpdfbookmark added (setting bookmark below current + level without changing it). + * \@ChoiceMenu: coiled "{\if}\fi" cleared to "{\if\fi}". + * Fix for \citeN and \shortciteN of package chicago. + +1999-11-09 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67e + * Detection of VTeX PS mode (OpMode=2). + * Added \tocsection fix for AMS classes + (thanks to Michael Downes/Tom Kacvinsky). + * Changed \newcommand*{\texorpdfstring} to \def\texorpdfstring + (a wish of Tom Kacvinsky). + * INSTALLDIRVAR added to makefile (default: TEXMFMAIN). + +1999-11-09 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67d + * Unwanted space removed in \hyper@linkstart (hvtex.def). + * <hvtex,hvtexhtml> renamed to <vtex,vtexhtml> + * If no driver is given, VTeX in PDF mode is now detected. + +1999-11-08 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67c + * hog.{eps,pdf} added for test0.tex + * Bug in \Acrobatmenu of hvtex.def fixed. + +1999-11-04 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67b + * New feature: With option `pdfpagelabels' the + /PageLabels entry in the /Catalog object of PDF 1.3 + is supported. + With `pdftex' and `vtex' one TeX run suffices, + other pdf driver, that work via \special, need + two TeX runs. + * Option `4' removed, because it is not used. + +1999-10-23 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67a + * \Hy@boolkey with optional argument for option name, if it + is different. + * hpdftex.def: \pdfrefform\OBJ@acroform, ... added. + +1999-10-18 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.67 public release on CTAN + +1999-10-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66m + * makefile fixes. + +1999-10-13 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66l + * dvipdfm driver updated by Sebastian Rahtz. + * LPPL 1.1, manifest.txt added. + * \hyperlinkfileprefix for Ross Moore. + * Option baseurl disabled after first use. + * Option debug = verbose. + * Used global options are removed from the unused option list. + * \pdfstringdef: \leavevmode disabled, + \guill@spacing (frenchb.ldf) properly defined. + * Directory structure: test/ and doc/ + * Slides and paper of Heiko's talk at EuroTeX'99 added in doc/. + +1999-10-07 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66k + * hyperref.ins: eight times faster by \generate (docstrip 2.4) + (Suggestion by Werner Lemberg <wl@gnu.org>). + * backref.dtx 1.19: + * \backcite ignores entries that are already present. + * Some cosmetic clean up. + * nameref.dtx 2.17: Some cosmetic clean up. + * \Hy@boolkey with error checking. + * Code for options backref and pagebackref rewritten. + * Options are disabled after use. + +1999-10-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66j + * foiltex: \ext@table, \ext@figure defined. + +1999-10-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66i + * \pdfstringdef: support of shorthands of some babel + languages added. + * \ij, \IJ added in PD1 and PU encoding for Dutch. + +1999-10-05 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66h + * Making destination for \addcontentsline in + \@chapter, if \c@secnumdepth<0, \frontmatter, or \backmatter. + * `(' and `)' added to \Hy@{Set,Restore}Catcodes. + +1999-10-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66g + * \index{test|(} supported. + +1999-09-28 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66f + * options.tex with bookmarkstype + * Bug in \autoref fixed: chapter/appendix detection + * \\ and \newline produces a warning in \pdfstringdef + * draft=false should work. + +1999-09-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66e + * Unwanted space in \HyPsd@LetUnexpandableSpace removed. + +1999-09-13 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66d + * \@footnotemark is also disabled, if package + tabularx is loaded. + +1999-09-10 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66c + * Bug fix: Definition of \Hy@SaveLastSkip is moved before \MaybeStopEarly. + +1999-09-10 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66b + * Starting with option warnings, if the option is + set at a wrong place. + * Support for package multind. + * \textnumero added to testbmu.tex. + +1999-09-08 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.66a + * Catcodes are set at begin of package and restored at the end. + (Bug fix: ltxdoc.cls makes '|' active...) + +1999-09-08 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * Release 6.66 + +1999-09-01 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.65e + * Test for \XR@addURL instead of the package name, because + they exist different versions of xr and xr-hyper. + +1999-08-31 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.65d + * Bug fixed (use of \renewcommand in \pdfstringdefDisableCommands) + * Weak support for \ref and \pageref in bookmarks added. + * Made bookmark code less slow (testbmu.tex compiles 20% faster): + \HyPsd@ConvertToUnicode rewritten, \HyPsd@string introduced, ... + * Bug detected by Ian Bruce: hyperref has a different spacing + with theorem environments. + Cause: The \lastskip value is destroyd by the specials that + set the anchor. + Fix: Saving the \lastskip value before the specials, and after + setting \nobreak\{h,v}skip-\lastskip\{h,v}skip\lastskip. + See \Hy@SaveLastskip - \Hy@RestoreLastskip. + (most drivers: \hyper@anchor, \hyper@anchorstart - \hyper@anchorend; + pdftex: \new@pdflink; dvipdfm: \@pdfm@dest) + * \CYRCHDSC and \cyrchdsc corrected to \CYRCHRDSC and \cyrchrdsc + (Thanks to Vladimir Volovich <vvv@vvv.vsu.ru>) + * Bug fixed: \HAR@checkcitations redefined to add \hyper@@link. + Without this the "Changed labels" warning would always appear. + +1999-08-24 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.65c + * Unicode bookmark support 0x0000..0x04FF. + * testbmu.tex: detailed test file for Unicode bookmarks. + * Default setting of \@pdfborder with \providecommand, + so package option `pdfborder' does work now. + * \hv@pdf@char: support of octal codes with VTeX + versions greater or equal 6.50. + * Typo in option 'vtex' corrected. + * Again backref 1.18. + * Various drivers (dviwindo, hypertex, ...): \leavevmode in + \hyper@linkurl, \hyper@linkfile, ... added where missing. + * testform2.tex renamed to testfor2.tex (8+3 file name). + +1999-08-17 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.65b + * Unicode bookmark support, starting with Cyrillic. + +1999-08-14 Heiko Oberdiek <oberdiek@uni-freiburg.de> + * 6.65a + * Module pdfstringdef: bug (\space) and typo fixed. + +1999-08-12 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * RELEASE 6.65 + +1999-08-10 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * 6.64h + * Moved some sections to before \MaybeStopEarly. Otherwise + implicit=false mode never saw some important stuff. + * hyperref.dtx: added \href to list of ignored commands in + bookmarks. cleaned up VTEX stuff as per diagnosis by Heiko + +1999-08-06 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * 6.64g + * hyperref.dtx: typos and little fixes from Heiko + * added another special thing for typexml + +1999-07-29 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * version 6.64c. hyperref.dtx: some typos corrected, and form + primitives of pdftex + +1999-07-28 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * cut out any footnote work if tabularx is + loaded. add some form stuff from D P Story + +1999-07-28 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * version 6.64b + * hyperref.dtx: + Changes from Heiko: + Module pdfstringdef: + * Small bug in \HyPsd@ProtectSpaces/HyPsd@RemoveMask fixed. + * \@ifnextchar because of \futurelet disabled. + * Disabling of \@ifstar removed, because it calls \@ifnextchar. + * \@protected@testopt disabled to show the problematic macro in + the warning message (commands with an optional argument). + * \pdfstringdefWarn#1 prints a warning message with token #1, + it can be used in code that disables macros by the user. + * \pdfstringdefDisableCommands#1 is a easier interface for + the hook \pdfstringdefPreHook. It appends its argument to the + meaning of \pdfstringdefPreHook. The character @ can be used + in command names. + * \penalty is removed silently. + * \kern and \hskip are detected with a warning: + * At the beginning or, if the value is less than 1ex, + they are removed. + * Else they are replaced by a space. + + Fix for \pdfpage(s)attr: + * Setting the /CropBox with \pdfpagesattr: + The old meaning of \pdfpagesattr is appended. + * Initial value of \@pdfpagestransition is \relax + to differentiate between a unused or empty option. + * \hyper@pagetransition (hpdftex): + * The old entry /Trans is removed from \pdfpageattr. + * The remaining old meaning retains and + * the new /Trans is appended. + * \hyper@pagetransition (pdfmark): + * \if-switch for \relax added to get the old behaviour. + ? (1) Need to delete an old entry? + ? If 1=yes, how to delete? + +1999-07-21 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + *version 6.64a, corrected typos in VTEX stuff + +1999-07-19 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * RELEASE 6.64 + * hyperref.dtx: support pdftex > 0.14 with new primitive names + * hyperref.dtx: bookmark patches from Stephan Haller, to allow + local changes of open status + * hyperref.dtx: small patche for \seteqlabel. obscure problem in + amstex compatibility mode, found by Michael Downes. + * hyperref.dtx: patches to VTEX bookmark processing, from Taco + Hoekwater, following patches by Denis Girou. + +1999-07-08 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * RELEASE 6.63 + * hyperref.dtx: added "typexml" option for typexml package + Some cleanups from Heiko + +1999-06-29 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * RELEASE 6.62 + * hyperref.dtx: (from Heiko), gobble \discretionary in bookmarks + +1999-06-27 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * RELEASE 6.61 + * hyperref.dtx: for Babel compatibility, use its \@safe@actives + switch in cross-refs (also in nameref.dtx), plus be nicer about + * in \pdfstringdef (from Heiko). Move \phantomsection to main package. + +1999-06-11 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * RELEASE 6.60 + * nameref.dtx: changed \Sectionformat to a \providecommand, as it + now comes \AtBeginDocument + +1999-06-10 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * hyperref.dtx: * Increment of version letter to 6.58f + * hyperref.dtx: add \phantomsection, to make a section-like anchor + Missing {} after \@ifpackageloaded{subfigure} + * nameref.dtx define \section@level for pdfscreen + From Heiko: + * lastpage fix (added page anchor name, ...). + * documentation for lastpage support added. + * \pdfstringdef: \Generic{Error,Warn,Info} disabled while + expanding. + * \pdfstringdef: french fix changed to get rid of hard coded + numbers for the guillemets. + +1999-06-09 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * hyperref.dtx: * Increment of version letter to 6.58b + Loads of cleanups by Heiko: + * \def\@pdfpagecrop{} removed, because it isn't used further + * Loading of \Hy@driver part replaced (see previous email) + * Old name \Hy@PDFDef found, replaced by \pdfstringdef + * Module \pdfstringdef: Use of prefix "\HyPsd@" (it's shorter + and easier to read than "\Hy@psd@". + * \let\add@accent\HyPsd@add@accent instead of the definition + in \pdfstringdef (saving run time). + * Corrected to \begin{macro}{\HyPsd@ITALCORR}. + * old ifbookmark replaced by texorpdfstring in description. + * Missing lines added in pd1enc.def (\",\r,\v,\.,\c) + * Bugs in \define@key{Field}{maxlen}{\Fld@maxlen=#1} + and \define@key{Field}{menulength}{% + * Changed \orig@appendix to \Hy@orig@appendix. + \orig@maketitle to \Hy@orig@maketitle. + * Replaced \global\def --> \gdef + * Replaced \global\edef --> \xdef + * Starting with identing (length 2) and checking the line length. + +1999-06-08 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * hyperref.dtx. make "subfigure" force hypertexnames=false; remove + exactdef option (obsolete), and set default of 0 for bookmark + level of unknown objects (\toclevel@...) + + * a lot of cleaning up of code layout, requested by Heiko, and bug + fixing related to \addcontentsline + +1999-05-30 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * backref.dtx: added debugging/verbose output + * hyperref.dtx: considerable reworking of \addcontentsline, with + wide-reaching effects + * Some more PD1 fixes from Heiko. Stop using \@foo, too common a + choice by others + * Some fixes for TeX4ht, from Eitan Gurari + +1999-05-19 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * RELEASE 6.57 + * hyperref.dtx: a good many missing or extra spaces in and around + line endings were found by Heiko and corrected. + +1999-05-18 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + * hyperref.dtx: fixes to \textLF etc from Heiko + +1999-05-17 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * hyperref.dtx: Raise equation anchors by \baselineskip; + dangerous, but its the only hope for XYZ views + * Some fixes for tex4ht from Eitan Gurari + * stop defaulting papersize \special + * make bookmarks use tocdepth not secnumdepth + * Some fixes for AMS equations, will probably break something! + * some characters changed, and some added, in PD1 + encoding, to allow for silly behaviour of Acrobat, and to help + Poles (via Wojciech A. Myszka <W.Myszka@immt.pwr.wroc.pl>) + + * backref.dtx: added support for chicago.sty (requested by Alan Reese) + +1999-05-14 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * hyperref.dtx: added new option hypertexnames. if it is *false*, + unique arbitrary names are given for anchors and links, to avoid + any conflict caused by counters being redefined etc. Long overdue. + + Guillemet fix from Heiko. + +1999-04-13 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.56 + * hyperref.dtx: missed a \if@filesw (Heiko spotted), and removed + the <repere> section + +1999-04-12 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.55 + * hyperref.dtx: when the run: type of URL is used, a \relax creeps + into the output with pdfmark drivers. corrected. + + Add some missing \if@filesw code (from Heiko) + + Proper dummy initialisation of \pdfbookmark + + Correct serious error over detecting whether seminar is being used + (added new test, and defined \ifhy@seminarslides) + + If implicit=false is used, ensure that \PDF@FinishDoc (to add + DOCINFO stuff) is still done, \AtBeginDocument (it was tied to the + redefinition of \@thehead) + +1999-03-31 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.54 + * hyperref.dtx: fixes from Heiko in pdf doc encoding stuff + +1999-03-30 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.53 + * hyperref.dtx: complete replacement of Heiko's part by nicely + documented dtx.... + + Name changes: + \newif\ifPDFbookmark ==> \newif\ifHy@pdfstring (internal name) + \ifbookmark ==> \texorpdfstring (user command) + \Hy@PDFDef ==> \pdfstringdef (user or package command) + + Heiko summarizes the features of this \Hy@PDFDef: + * PD1 encoding + * Unknown glyphs don't cause an infinite error loop now (see + bug report few weeks ago in pdftex@tug.org). + * Grouping characters can be used, they are removed silently, + so things like "\TeX{}" can be written. + * With this version of \Hy@PDFDef the option exactdef can be + removed now because of the warning messages. + * All non-expandible commands like unknown glyphs or stomach + commands are catched by this version: a comprehensive + warning message is produced and the tokens are removed. + * xspace support. + * Support for unbalanced parentheses, hyparen.sty is now obsolete. + + +1999-03-26 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.52 + + * hyperref.dtx: Wherever "naturalnames" is used, disable + \textlatin (from Babel 3.6k). Thanks to Felix Neubauer + <Felix.Neubauer@gmx.net> + + * Fixes for seminar (Denis Girou <denis.girou@idris.fr>) + +1999-03-12 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.51 (unreleased) + * hyperref.dtx: yet more bookmark magic from Heiko Oberdiek! + +1999-02-21 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: trap a URL type of "run:" and attempt to use it to + launch an application. In dvips, dvipdfm and pdftex drivers; it + seems to work in Windows. By default it translates to file: + +1999-02-17 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + Changed the copyright notice + + * hyperref.dtx: some (more) corrections from Heiko + +1999-02-16 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.50 + * hyperref.dtx: some corrections from Heiko + +1999-02-14 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.49 + * hyperref.dtx: remove grouping around PDF@SetupDoc, allowing + \pdfpagesttr in pdftex to work properly (ie CropBox) + move PD@FinishDoc to happen at start of dvi (in page header); + this allows for documents ending in \clearpage in which case the + stuff never happened. sigh. + +1999-02-06 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.48 + * hyperref.dtx: add option "naturalnames", which makes hyperref use + eg \thesection instead of \theHsection. may help some people. + Add option "verbose" to provide a debugging hook. + Set some more commands to no-op in bookmarks. + remove all pdfinfo from PDF@SetupDoc, and transfer to new + PDF@FinishDoc, which happens \AtEndDocument. This allows + \maketitle to do \hypersetup{pdftitle=\@title} etc + + Rearranged some lines of code. + +1999-02-01 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.47 + * hyperref.dtx: removed code from dvipdfm by mistake. restored. + +1999-01-27 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.46 + * hyperref.dtx: add support for colorlinks to dvipdfm driver + (missed out by mistake before), and \AcrobatMenu + +1999-01-20 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: changed \texttilde to \textasciitilde; removed + \textbeta + +1998-12-17 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.45 + * hyperref.dtx: make \footnotemark and \footnotetext use original + non-hyper definitions. from pzezza@facec.cce.unifi.it. + +1998-12-07 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.44 + * hyperref.dtx: corrected bookmark writing errors. again... + removed some spurious \makeat s. removed a spurious { in tex4ht + +1998-12-01 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 6.43 + * hyperref.dtx: fixes for \addcontentsline from + kevin@rodin.wustl.edu (Kevin Ruland) + - make \EndOfPackage things happen \AtBeginDocument instead, for + consistency + - fixes to hy@temp from Heiko + - added optional first parameter to \BOOKMARK in order to provide + dvipdfm with what it wants + +1998-11-27 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * hyperref.dtx: added dvipdfm driver from + Mark Wicks <mwicks@kettering.edu>. + cleaned up more bookmark code (from Heiko) + +1998-11-11 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.42 + * hyperref.dtx: replaced bookmark and docinfo writing with new code + from Heiko Oberdiek which seems to do a better job + + Support for lastpage package. + +Tue Nov 3 21:06:33 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.41 + * hyperref.dtx: cleaned up test for existence of pdftex again, to + avoid trampling on other packages. Thomas Esser and David Carlisle + pointed out the mess. + +Sun Nov 1 18:53:20 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 6.40 + * hyperref.dtx: checked various drivers, and had to introduce mew + docstrip guards to add some pdfmark to dviwindo. dvipdf broken, so + removed from hyperref.ins. Thanks to Thomas Esser for testing so + quickly. + +Fri Oct 30 14:13:39 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.39 + * hyperref.dtx: serious error in where colorlinks and frenchlinks + were checked. now all at EndOfPackage, after driver load. + +Fri Oct 23 16:30:32 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.38 + * hyperref.dtx: rework handling of driver options so that driver + is only loaded at the end, with whatever is the latest name given + in config file, document etc. (Thanks to Thomas Esser for suggestion) + +Sat Oct 17 23:29:26 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 6.37 + * hyperref.dtx: back out change of link to use Action dictionary, + it seems to break some Distiller setups, and Ghostscript + +Tue Oct 06 10:52:32 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: make all eqnarray stop being an anchor, as it may + break over pages. + Whoops. PDF@SetupDoc was after \MayBeStopEarly... + +Thu Sep 24 11:27:41 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.36 + * hyperref.dtx: even if bookmark writing disable, \pdfbookmark still + needs to make anchors + +Tue Sep 22 11:04:49 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: xdef not edef in \@writetorep (thanks to Christian + Kumpf <kumpf@igd.fhg.de>) + +Sat Sep 12 21:09:55 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: added option pdfnumberbookmarks to include section + numbers in PDF bookmarks + +Mon Sep 07 12:58:58 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.35 + * hyperref.dtx: added DOCVIEW stuff to dviwindo driver + better check for playing in head, means no more overfull hbox + messages + +Fri Sep 04 23:38:00 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: added DOCVIEW stuff to dvipsone driver (pointed + out by D P Story) + +Thu Sep 03 21:16:47 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: + a) added new option linktocpage to make TOC have links on page + numbers + b) rewrote or checked all uses of \colorlink, so that they + have a corresponding \hy@endcolorlink (was \hyper@resetcolor), + and so are in a \begingroup ... \endgroup group (requested by + Patrick Daly, for consistency if nothing else). Renamed + \colorlink to \hy@colorlink + +Wed Sep 02 13:31:05 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.34 + * hyperref.dtx: chivvied around pdfview so that it worked, and did + not override hyperref.cfg. concept of \@pdfviewparam for size + parameters + +Tue Aug 11 15:55:47 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.33 + * hyperref.dtx: fix up some forms problems for Laurent Guillope + +Sat Aug 08 15:01:14 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: add option `implicit' to allow (with value of + false) for no redefinition of LaTeX internals. Re-ordered some + code sections to allow for this. + +Sun Aug 02 12:10:08 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: corrected some typos and mistakes in form support + +Mon Jul 20 01:22:51 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: change check of empty head (from test by Denis + Roegel) + +Mon Jul 06 15:09:08 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.32 + * backref.dtx: better test for natbib-like styles + * hyperref.dtx: add natbib link break macro + dvipsone: use same pdfsetup as dviwindo + +Sat Jun 27 10:09:36 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.31 + * hyperref.dtx: correct order of part and writetorep + * hyperref.dtx: more fixes from MicroPress for their driver. zero + width hidden fields -> width of 1sp. Piet van Oostrum's additions + to bookmark writing code. + * add support for "pdfstartview={}", to get `default' + magnification. hyper@linkfile for pdftex always does a user action + now + * Patrick Daly's addition of \ifvmode\nobreak\fi in pdftex start + anchor fixes his section problems, but is not entirely general. + +Thu Jun 25 14:24:23 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * hyperref.dtx: fix NoHyper bug *properly* this time. + +Thu Jun 25 14:24:23 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 6.30 + * hyperref.dtx: zero width hidden fields. support pdfstartview of + {}. allow NewWindow false with pdfnewwindow option. correct bug in + default value of centerwindow and fitwindow. fix bug in NoHyper. + fix bug in \pageref*. + + Add \autoref macro to generate tagged references. + +Wed Jun 24 13:40:29 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.29 + * hyperref.dtx: add \ref* and \pageref* to produce unlinked + references, and fix bug in label@hyperref. + add page transitions for pdftex driver + +Tue Jun 23 12:49:35 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: add support for page transitions in pdfmark driver + * hyperref.dtx: add key pdfpagelayout + * hyperref.dtx: revise form lists, now support Display=Value syntax + * hyperref.dtx: change test for whether natbib-like code is + present (if NAT@parse is defined), since things like aguplus dont + load natbib per se, but use the same code. + + +Sun Jun 21 22:08:47 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * hyperref.dtx: if form list value starts with a [, its assumed to + be an array of two strings, display and use values. + * hyperref.dtx: add `readonly' key for pdf forms, and hidden for + HTML + * hyperref.dtx: restructure form drivers to isolate common code + for pdftex and pdfmark. + +Sat Jun 20 21:41:30 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: add `hidden' key for forms + +Fri Jun 19 10:04:44 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * hyperref.dtx: use pdftex version and revision numbers + + * RELEASE 6.28 + * hyperref.dtx: corrected stupid error which meant that the + bookmark file was not being opened. + +Tue Jun 16 00:05:31 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.27 + * hyperref.dtx: finished pdftex forms, and reworked several + aspects of forms in general. + +Mon Jun 15 14:37:33 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: use \filename@parse to decide whether a file: URL + is a local open or a URL. makes ../../xxx work. + + VTEX drivers driven by single `vtex' option which checks + \OpMode + +Sat Jun 13 16:59:03 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * hyperref.dtx: merge in material from MicroPress to provide support + for VTEX's two new modes of operation, PDF and HTML. Drivers hvtex + and hvtexhtml. + +Fri Jun 12 01:12:05 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * (private) RELEASE 6.26 + addition from DPC to provide better support for encoding in + .out files (must use inputenc) + * (private) RELEASE 6.25 + * hyperref.dtx: + removed quotes from names in dviwindo (DP Story) + comma after file destination in dviwindo (DP Story) + rejig parsing of file: to cope with ../foo/bar, at the + cost of files having to be at least two characters long. ../.. + doesn't work either :-} + +Fri Jun 05 12:35:11 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * (private) RELEASE 6.24 + * hyperref.dtx: unset \@tempa at start of ProcessKVOptions (David + Carlisle) + * hyperref.dtx: pdftex base url syntax wrong; and if baseurl + provided, need to strip file: from URL (corrections by + daly@linpwd.mpae.gwdg.de (P.W.Daly, MPAe, Lindau, Germany) + +Wed May 27 21:41:12 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * (private) RELEASE 6.23 + * hyperref.dtx: remove spurious space in pdfview in pdftex driver + +Sat May 16 22:02:34 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * (private) RELEASE 6.22 + * hyperref.dtx: in draft mode, need fifth and secondoffive to be + really secondoffive + +Fri May 08 11:21:45 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * (private) RELEASE 6.21 + * hyperref.dtx: added new key "pdfhighlight" to set Acrobat + behaviour when a link is pressed. Make destinations use the Action + dictionary. Added first cut at forms support. + +Wed Mar 25 14:22:46 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * (private) RELEASE 6.20 + * RELEASE 6.19 + * pdftex seems to have changed, added goto page for openaction + * hyperref.dtx: put / in front of pdfstartview + still changing textures driver + +Sun Mar 22 21:01:07 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.18 + +Sat Mar 21 14:13:23 1998 Sebastian Rahtz <srahtz@ogre> + * hyperref.dtx: add conditional code for fancyvrb, to stop + links being made to fancyvrb lines. + * experimental textures driver + * pdftex as 0.12 the default; use guard pdftexold to select 0.11 + behaviour + +Sat Mar 07 22:40:06 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 6.17 + * hyperref.dtx: patches from Piotr Krysiuk + <pkrysiuk@mimuw.edu.pl> to make it run under LaTeX 209 + compatibility mode + +Thu Mar 5 23:55:14 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: put braces around URL in pdfmark driver, to stop + keyval splitting at an = sign within the URL (bug report from Ahmed + Hindawi <hindawi@ephouse.com>) + +Tue Mar 03 23:24:34 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: add first cut at tex4ht driver + * hyperref.dtx: changes for pdftex 0.12 driver (syntax changes) + +Sat Feb 28 12:41:02 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * (private) RELEASE 6.16 + * hyperref.dtx: AMSLaTeX does everything twice; pdftex actually + *executes* the hyper code twice, so that destinations are defined + twice. Make use of \ifmeasuring@ to avoid this. + +Wed Feb 25 13:31:36 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.15 + * Sigh. Messed up counters again. Fixed. It had better be right + this time. + * RELEASE 6.14 + * hyperref.dtx: added key bookmarksopen to dictate whether or not + the bookmark tree is expanded (from Brian Ripley) + * cleaned up the *horrible* mess created by me over items, which + mean that I had turned off the incrementing.... + * typo in \pdfbookmark corrected + +Mon Feb 23 22:37:12 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 6.13 + * changes to \item had totally wrecked natbib :-} + * added keys for PDF creator and producer + * re-fix \@footnotemark in \maketitle + * reverse parameters of \htmladdnormallink + +Fri Feb 20 21:54:38 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.12 + * RELEASE 6.11 + * hyperref.dtx: play around with items again for Tanmoy. ugh, all + sorts of changes to stop bibitems getting 3 destinations defined. + +Mon Jan 26 22:37:48 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: define \@makefnmark instead of \@footnotemark, to + take advantage of white space and hyphenation fudges (from DPC) + * backref.dtx: remove white space in for loop of \backcite + +Thu Jan 22 13:50:35 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.10 + * more dealing with \url, allowing for _ + +Wed Jan 21 12:04:41 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * release 6.9 + * fixed some small bugs (though more remain) and added + \Acrobatmenu command. + +Thu Dec 11 21:12:09 1997 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: altered algorithm of tocdepth for pdf bookmarks; + rewrote nesting again. still concerned about global allocation + of `current' tokens, and lack of nesting in PS file. + +Tue Dec 09 13:40:28 1997 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * hyperref.dtx: rewrote handling of (non) nesting. the innards of + an anchor are now processing inside {\stop@hyper...} which + hopefully makes all hyper commands no-ops. ripley@stats.ox.ac.uk + (Prof Brian Ripley) found several things which forced me to do + *something* (ie a \cite inside a \caption gave the destination of + the cite to the caption) + + Daniel T. Cobra <cobra@gyron.acate.com.br> gave me a new + incompatibility with ps2pdf + +Mon Nov 24 14:59:40 1997 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * RELEASE 6.7 + * started hyperref ChangeLog. cleanup of copyright for Debian inclusion diff --git a/Master/texmf-dist/doc/latex/hyperref/README b/Master/texmf-dist/doc/latex/hyperref/README new file mode 100644 index 00000000000..4baa2d9454b --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/README @@ -0,0 +1,396 @@ +README for hyperref bundle 2003/07/27 + +TABLE OF CONTENTS +================= + +Introduction +Download +Installation +Additional Packages +New Features +Package Compatibility +Hints +Authors/Maintainers +Bugreports +Known Problems +ToDo + + +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 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. + +Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> +Heiko Oberdiek <oberdiek@ruf.uni-freiburg.de> + +December 1994-March 2002 + +DOWNLOAD +======== + +`hyperref' is available on CTAN: + CTAN:macros/latex/contrib/supported/hyperref/ + +`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 files are organized in three, sometimes four directories: + ./ + Root directory that contains `README', `.dtx', + and `.ins' files. + doc/ + Directory for documentation files. + test/ + Directory for some test files. + beta/ + Sometimes this directory exists and contains + the latest beta/test versions of some files, + often `hyperref.dtx'. + +The main repository of hyperref is located at the server +of the international `TeX User Group' (TUG). The hyperref +directory at the TUG server + http://www.tug.org/applications/hyperref/ +contains the following files: + hyperref.zip + hyperref-doc.zip + hyperref-test.zip + hyperref-beta.zip + The files of the four directories, described above, are + packed into four ZIP archives, so that they can be easily + downloaded. (The ZIP files do not contain directories.) + + manual.html + manual2.html + manual.css + HTML version of the quite old hyperref manual in `doc/manual.pdf'. + +The CTAN stuff will be mirrored automatically from the +ftp server, so + ftp://ftp.tug.org/pub/tex/hyperref/ +corresponds to + CTAN:macros/latex/contrib/supported/hyperref/ + +INSTALLATION +============ + +a) Download the hyperref files from CTAN or the TUG server. + If necessary, unpack them. +b) Replace the files by the counterparts in the beta 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 .../texmf/tex/latex/hyperref/ + Replace `...' by the prefix of your TDS tree. +e) Update the databases if necessary, eg. for teTeX: + mktexlsr .../texmf + +ADDITIONAL PACKAGES +=================== + +Depending on the driver, hyperref loads other packages: +* url.sty + CTAN:macros/latex/contrib/other/misc/url.sty +* keyval.sty, color.sty: + CTAN:macros/latex/required/graphics/ + An uptodate pdftex.def is available at + http://www.tug.org/applications/pdftex/pdftex.def + CTAN:macros/pdftex/graphics/pdftex.def + +NEW FEATURES +============ + +* 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 changed in the configuration + file "hyperref.cfg": + \providecommand*{\Hy@defaultdriver}{hdvips} + for dvips, or + \providecommand*{\Hy@defaultdriver}{hypertex} + for the default behaviour of hyperref. + +PACKAGE COMPATIBILITY +===================== + +Currently only package loading orders are available: + +algorithm: + \usepackage{hyperref} + \usepackage[chapter]{algorithm}% eg. + +babel/magyar.ldf: unsupported + magyar.ldf's redefinitions of many LaTeX internals conflict + with hyperref's redefinitions of these commands. + +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). + +dblaccnt: + pd1enc.def or puenc.def should be loaded before: + \usepackage{hyperref} + \usepackage{dblaccnt} + or see entry for "vietnam". + +easyeqn: not compatible, breaks. + +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. + +footnote: + This package is not supported, you have to disable hyperref's footnote + support by using option "hyperfootnotes=false". + +IEEEtran.cls: + version >= V1.6b (because of \@makecaption, see ChangeLog) + +lastpage: compatible + +linguex: + \usepackage{hyperref} + \usepackage{linguex} + +ltabptch: + \usepackage{longtable} + \usepackage{ltabptch} + \usepackage{hyperref} + +minitoc-hyper: + This package is obsolete, use the uptodate original + package minitoc instead. + +natbib: + \usepackage{natbib} + \usepackage{hyperref} + +nomencl: +Example for introducing links for the page numbers: +\renewcommand*{\pagedeclaration}[1]{\unskip, \hyperpage{#1}} + +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} + +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. +subfigure v2.1: + \usepackage{nameref} + \usepackage{subfigure} + \usepackage{hyperref} + or + \usepackage{hyperref} + \usepackage{subfigure} +subfigure v2.1.2: + please update +subfigure v2.1.3: + \usepackage{hyperref} + \usepackage{subfigure} + or vice versa? + +titleref: + \usepackage{nameref} + \usepackage{titleref}% without usetoc + \usepackage{hyperref} + +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). + +varioref: + \usepackage{nameref} + \usepackage{varioref} + \usepackage{hyperref} + +vietnam: + % pd1enc.def should be loaded before package dblaccnt: + \usepackage[PD1,OT1]{fontenc} + \usepackage{vietnam} + \usepackage{hyperref} + + +HINTS +===== + +* Index with makeindex + * Package hyperref adds \hyperpage commands by the encap + mechanism, 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 hyperref allows one command only. + If the user sets such a command, hyperref suppresses its + \hyperpage command. With logical markup this situation + can easily solved: + \usepackage{makeidx} + \makeindex + \usepackage[hyperindex]{hyperref} + \newcommand*{\main}[1]{\textbf{\hyperpage{#1}}} + ... + \index{Some example|main} + * 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. + + +AUTHORS/MAINTAINERS +=================== + +* Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> +* Heiko Oberdiek <oberdiek@uni-freiburg.de> + + +BUGREPORTS +========== + +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" to get + a list of version informations 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: Heiko Oberdiek <oberdiek@uni-freiburg.de> + + +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 +* better color interface for *bordercolor options +* ... diff --git a/Master/texmf-dist/doc/latex/hyperref/cmmi10-22.gif b/Master/texmf-dist/doc/latex/hyperref/cmmi10-22.gif Binary files differnew file mode 100644 index 00000000000..ab41b85ae24 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/cmmi10-22.gif diff --git a/Master/texmf-dist/doc/latex/hyperref/cmsy10-21.gif b/Master/texmf-dist/doc/latex/hyperref/cmsy10-21.gif Binary files differnew file mode 100644 index 00000000000..dd190e44e91 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/cmsy10-21.gif diff --git a/Master/texmf-dist/doc/latex/hyperref/fdl.tex b/Master/texmf-dist/doc/latex/hyperref/fdl.tex new file mode 100644 index 00000000000..637c1cb63c9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/fdl.tex @@ -0,0 +1,422 @@ +% This file is a chapter. It must be included in a larger document to work +% properly. + +\chapter{GNU Free Documentation License} + +Version 1.2, November 2002\\ + + + Copyright \copyright\ 2000,2001,2002 Free Software Foundation, Inc.\\ + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA\\ + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + +\section*{PREAMBLE} + +The purpose of this License is to make a manual, textbook, or other +functional and useful document ``free'' in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + +This License is a kind of ``copyleft'', which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +\section{APPLICABILITY AND DEFINITIONS} +\label{applicability} + +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The ``Document'', below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as ``you''. You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + +A ``Modified Version'' of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A ``Secondary Section'' is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall subject +(or to related matters) and contains nothing that could fall directly +within that overall subject. (Thus, if the Document is in part a +textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The ``Invariant Sections'' are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + +The ``Cover Texts'' are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A ``Transparent'' copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not ``Transparent'' is called ``Opaque''. + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, \LaTeX\ input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. + +The ``Title Page'' means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, ``Title Page'' means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + +A section ``Entitled XYZ'' means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as ``Acknowledgements'', +``Dedications'', ``Endorsements'', or ``History''.) To ``Preserve the Title'' +of such a section when you modify the Document means that it remains a +section ``Entitled XYZ'' according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + + +\section{VERBATIM COPYING} +\label{verbatim} + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in +section~\ref{copying}. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + +\section{COPYING IN QUANTITY} +\label{copying} + +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + + +\section{MODIFICATIONS} +\label{modifications} + +You may copy and distribute a Modified Version of the Document under +the conditions of sections~\ref{verbatim} and \ref{copying} 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: + +\renewcommand{\labelenumi}{\Alph{enumi}.} +\begin{enumerate} +\item 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. +\item 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. +\item State on the Title page the name of the publisher of the + Modified Version, as the publisher. +\item Preserve all the copyright notices of the Document. +\item Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. +\item 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. +\item Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +\item Include an unaltered copy of this License. +\item 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. +\item 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. +\item 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. +\item 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. +\item Delete any section Entitled ``Endorsements''. Such a section + may not be included in the Modified Version. +\item Do not retitle any existing section to be Entitled ``Endorsements'' + or to conflict in title with any Invariant Section. +\item Preserve any Warranty Disclaimers. + +\end{enumerate} + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled ``Endorsements'', provided it contains +nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + +\section{COMBINING DOCUMENTS} +\label{combining} + +You may combine the Document with other documents released under this +License, under the terms defined in section~\ref{modifications} +above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled ``History'' +in the various original documents, forming one section Entitled +``History''; likewise combine any sections Entitled ``Acknowledgements'', +and any sections Entitled ``Dedications''. You must delete all sections +Entitled ``Endorsements''. + + +\section{COLLECTIONS OF DOCUMENTS} +\label{collections} + +You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + + +\section{AGGREGATION WITH INDEPENDENT WORKS} +\label{aggregation} + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an ``aggregate'' if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section~\ref{copying} 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. + + +\section{TRANSLATION} +\label{translation} + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of +section~\ref{modifications}. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled ``Acknowledgements'', +``Dedications'', or ``History'', the requirement +(section~\ref{modifications}) to Preserve +its Title (section~\ref{applicability}) will typically require +changing the actual title. + + +\section{TERMINATION} +\label{termination} + +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. + + +\section{FUTURE REVISIONS OF THIS LICENSE} +\label{future} + +The Free Software Foundation may publish new, revised versions +of the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +http://www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License ``or any later version'' applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + + +\section*{ADDENDUM: How to use this License for your documents} + +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: + +\begin{quote} + Copyright \copyright\ YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled ``GNU + Free Documentation License''. +\end{quote} + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the ``with...Texts.'' line with this: + + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. diff --git a/Master/texmf-dist/doc/latex/hyperref/hycheck.tex b/Master/texmf-dist/doc/latex/hyperref/hycheck.tex new file mode 100644 index 00000000000..d56c78aedf9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hycheck.tex @@ -0,0 +1,297 @@ +%% +%% This is file `hycheck.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% hyperref.dtx (with options: `check') +%% +%% File: hyperref.dtx Copyright 1995-2001 Sebastian Rahtz, +%% RCS: $Id: hyperref.dtx 6.71 2000/10/04 rahtz Exp rahtz $ +%% +%% This file is part of the `Hyperref Bundle'. +%% ------------------------------------------- +%% +%% It may be distributed under the conditions of the LaTeX Project Public +%% License, either version 1.2 of this license or (at your option) any +%% later version. The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.2 or later is part of all distributions of LaTeX +%% version 1999/12/01 or later. +%% +%% The list of all files belonging to the `Hyperref Bundle' is +%% given in the file `manifest.txt'. +%% +\NeedsTeXFormat{LaTeX2e} +\ProvidesFile{hycheck.tex} + [2003/11/30 v6.74m + Hyperref test file] +\documentclass{article} +\makeatletter +\newcommand*{\checklatex}[1][]{% + \typeout{}% + \typeout{* Format: `LaTeX2e' #1}% + \typeout{\space\space Loaded: `\fmtname' \fmtversion}% +}% +\newcommand*{\checkpackage}[1]{% + \def\HyC@package{#1}% + \let\HyC@date\@empty + \@ifnextchar[\HyC@getDate\HyC@checkPackage +} +\def\HyC@getDate[#1]{% + \def\HyC@date{#1}% + \HyC@checkPackage +} +\def\HyC@checkPackage{% + \typeout{} + \begingroup + \edef\x{\endgroup + \noexpand\RequirePackage{\HyC@package}% + \ifx\HyC@date\@empty\relax\else[\HyC@date]\fi% + }% + \x + \typeout{}% + \typeout{% + * Package `\HyC@package'% + \ifx\HyC@date\@empty + \else + \space\HyC@date + \fi + }% + \@ifundefined{ver@\HyC@package.sty}{% + }{% + \typeout{% + \space\space Loaded: `\HyC@package' % + \csname ver@\HyC@package.sty\endcsname + }% + }% +} +\newcommand*{\checkcommand}[1]{% + \begingroup + \ifx\long#1\relax + \expandafter\HyC@checklong + \else + \def\HyC@defcmd{#1}% + \expandafter\let\expandafter\HyC@next + \csname HyC@\expandafter\@gobble\string#1\endcsname + \expandafter\HyC@checkcommand + \fi +} +\def\HyC@checklong#1{% + \def\HyC@defcmd{\long#1}% + \expandafter\let\expandafter\HyC@next + \csname HyC@\expandafter\@gobble\string#1\endcsname + \HyC@checkcommand +} +\def\HyC@checkcommand{% + \ifx\HyC@next\relax + \PackageError{hycheck}{% + Unknown command `\expandafter\strip@prefix\meaning\HyC@cmd'% + }\@ehd + \expandafter\endinput + \fi + \@ifstar{% + \def\HyC@star{*}% + \HyC@check + }{% + \let\HyC@star\@empty + \HyC@check + }% +} +\def\HyC@check#1{% + \def\HyC@cmd{#1}% + \let\HyC@org@cmd#1% + \let#1\relax + \let\HyC@param\@empty + \HyC@Toks{}% + \let\HyC@org@optcmd\HyC@noValue + \let\HyC@org@robustcmd\HyC@noValue + \let\HyC@org@robustoptcmd\HyC@noValue + \HyC@next +} +\def\HyC@noValue{NoValue} +\def\HyC@newcommand{% + \let\HyC@@cmd\HyC@cmd + \@ifnextchar[\HyC@nc@opt\HyC@nc@noopt +} +\newtoks\HyC@Toks +\long\def\HyC@nc@noopt#1{% + \edef\x{% + \expandafter\noexpand\HyC@defcmd + \HyC@star + \expandafter\noexpand\HyC@cmd + \HyC@param\the\HyC@Toks + }% + \x{#1}% + \HyC@doCheck +} +\def\HyC@nc@opt[#1]{% + \def\HyC@param{[#1]}% + \@ifnextchar[\HyC@nc@default\HyC@nc@noopt +} +\def\HyC@nc@default[#1]{% + \HyC@Toks={[{#1}]}% + \edef\HyC@optcmd{% + \expandafter\noexpand + \csname\expandafter\string\HyC@@cmd\endcsname + }% + \expandafter\let\expandafter\HyC@org@optcmd\HyC@optcmd + \HyC@nc@noopt +} +\def\HyC@DeclareRobustCommand{% + \edef\HyC@robustcmd{% + \expandafter\noexpand + \csname\expandafter\expandafter\expandafter\@gobble + \expandafter\string\HyC@cmd\space\endcsname + }% + \expandafter\let\expandafter\HyC@org@robustcmd\HyC@robustcmd + \expandafter\let\HyC@robustcmd\relax + \let\HyC@@cmd\HyC@robustcmd + \@ifnextchar[\HyC@nc@opt\HyC@nc@noopt +} +\def\HyC@def#1#{% + \HyC@Toks={#1}% + \HyC@nc@noopt +} +\let\HyC@edef\HyC@def +\def\HyC@doCheck{% + \typeout{* Checking `\HyC@string\HyC@cmd':}% + \HyC@checkItem{cmd}% + \HyC@checkItem{robustcmd}% + \HyC@checkItem{optcmd}% + \HyC@checkItem{robustoptcmd}% + \endgroup +} +\def\HyC@checkItem#1{% + \expandafter\ifx\csname HyC@org@#1\endcsname\HyC@noValue + \else + \expandafter\expandafter\expandafter\ifx + \csname HyC@#1\expandafter\endcsname + \csname HyC@org@#1\endcsname + \expandafter\HyC@checkOk\csname HyC@#1\endcsname + \else + \expandafter\HyC@checkFailed + \csname HyC@#1\expandafter\endcsname + \csname HyC@org@#1\endcsname + \fi + \fi +} +\def\HyC@string#1{\expandafter\string#1} +\def\HyC@meaning#1{\expandafter\meaning#1} +\def\HyC@checkOk#1{% + \typeout{\space\space`\HyC@string#1' ok.}} +\def\HyC@checkFailed#1#2{% + \typeout{\space\space`\HyC@string#1' failed.}% + \typeout{\space\space* original: \meaning#2}% + \typeout{\space\space* expected: \HyC@meaning#1}% +} +\checkpackage{lastpage}[1994/06/25] +\checkcommand\def\lastpage@putlabel{% + \addtocounter{page}{-1}% + \immediate\write\@auxout{% + \string\newlabel{LastPage}{{}{\thepage}}% + }% + \addtocounter{page}{1}% +} +\checklatex +\checkcommand\def\@xfootnotenext[#1]{% + \begingroup + \csname c@\@mpfn\endcsname #1\relax + \unrestored@protected@xdef\@thefnmark{\thempfn}% + \endgroup + \@footnotetext +} +\checkcommand\def\@xfootnotemark[#1]{% + \begingroup + \c@footnote #1\relax + \unrestored@protected@xdef\@thefnmark{\thefootnote}% + \endgroup + \@footnotemark +} +\checkcommand\def\@footnotemark{% + \leavevmode + \ifhmode\edef\@x@sf{\the\spacefactor}\nobreak\fi + \@makefnmark + \ifhmode\spacefactor\@x@sf\fi + \relax +} +\checklatex[1999/06/01 - 2000/06/01] +\checkcommand\def\caption{% + \ifx\@captype\@undefined + \@latex@error{\noexpand\caption outside float}\@ehd + \expandafter\@gobble + \else + \refstepcounter\@captype + \expandafter\@firstofone + \fi + {\@dblarg{\@caption\@captype}}% +} +\checkcommand\long\def\@caption#1[#2]#3{% + \par + \addcontentsline{\csname ext@#1\endcsname}{#1}% + {\protect\numberline{\csname the#1\endcsname}{\ignorespaces #2}}% + \begingroup + \@parboxrestore + \if@minipage + \@setminipage + \fi + \normalsize + \@makecaption{\csname fnum@#1\endcsname}{\ignorespaces #3}\par + \endgroup +} +\checklatex +\checkcommand\def\@lbibitem[#1]#2{% + \item[\@biblabel{#1}\hfill]% + \if@filesw + {% + \let\protect\noexpand + \immediate\write\@auxout{% + \string\bibcite{#2}{#1}% + }% + }% + \fi + \ignorespaces +} +\checkcommand\def\@bibitem#1{% + \item + \if@filesw + \immediate\write\@auxout{% + \string\bibcite{#1}{\the\value{\@listctr}}% + }% + \fi + \ignorespaces +} +\checklatex +\checkcommand\def\addcontentsline#1#2#3{% + \addtocontents{#1}{\protect\contentsline{#2}{#3}{\thepage}}% +} +\checkcommand\def\contentsline#1{\csname l@#1\endcsname} +\checkpackage{amsmath}[1999/12/14 - 2000/06/06] +\checkcommand\newcommand{\numberwithin}[3][\arabic]{% + \@ifundefined{c@#2}{\@nocounterr{#2}}{% + \@ifundefined{c@#3}{\@nocnterr{#3}}{% + \@addtoreset{#2}{#3}% + \@xp\xdef\csname the#2\endcsname{% + \@xp\@nx\csname the#3\endcsname .\@nx#1{#2}% + }% + }% + }% +}% +\checklatex +\checkcommand\def\@setref#1#2#3{% + \ifx#1\relax + \protect\G@refundefinedtrue + \nfss@text{\reset@font\bfseries ??}% + \@latex@warning{% + Reference `#3' on page \thepage\space undefined% + }% + \else + \expandafter#2#1\null + \fi +} +\typeout{} +\begin{document} +\end{document} +\endinput +%% +%% End of file `hycheck.tex'. diff --git a/Master/texmf-dist/doc/latex/hyperref/hylatex.ltx b/Master/texmf-dist/doc/latex/hyperref/hylatex.ltx new file mode 100644 index 00000000000..7eb223db30d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/hylatex.ltx @@ -0,0 +1,43 @@ +% +% hylatex.ltx +% Tanmoy Bhattacharya and Sebastian Rahtz, June 1995 +% +% Use this file to make a format which includes the +% hyperref package in every LaTeX job. +% +% In web2c 7-based TeX world, we create the format file with +% tex -ini \&latex hylatex.ltx +% and then use with +% tex \&hylatex +% +% In teTeX (TeX version 3.14159 (C version 6.1), LaTeX2e <1996/12/01> +% patch level 1), I create the format file with +% initex \&latex hylatex.ltx +% and then use with +% virtex \&hylatex +% +% This method is not supported by the LaTeX2e team, so +% I will try to find a better way. \AtBeginDocument does not +% work for reasons which I do not understand. +% +\makeatletter +\expandafter\everyjob\expandafter{\the\everyjob + \typeout{ ********* Hyperref Macros loaded ******* }} +% +\expandafter\let\csname REAL document\endcsname\document +% +\def\document{% + \endgroup +% +% NOTE: +% This setup sets up no options by default; +% change to suit your needs, by writing a hyperref.cfg control +% file. +% + \RequirePackage{hyperref} + \begingroup + \@endpefalse\csname REAL document\endcsname +} +\makeatother +\dump + diff --git a/Master/texmf-dist/doc/latex/hyperref/manifest.txt b/Master/texmf-dist/doc/latex/hyperref/manifest.txt new file mode 100644 index 00000000000..b059408bf5c --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manifest.txt @@ -0,0 +1,106 @@ +% \iffalse meta-comment +% +% 2002/03/15 +% +% Copyright 1999-2002 Sebastian Rahtz, Heiko Oberdiek +% +% This file is part of the `Hyperref Bundle'. +% ------------------------------------------- +% +% It may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.2 +% of this license or (at your option) any later version. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% The list of all files belonging to the LaTeX `Hyperref Bundle' is +% given in the file `manifest.txt'. +% +% \fi +% +% CONTENTS OF THE HYPERREF BUNDLE +% =============================== + +hyperref.dtx + Main package with various drivers. +backref.dtx + Bibliographical back referencing. +nameref.dtx + Cross-referencing by name of section. + +hyperref.ins + Docstrip batch file. + +minitoc-hyper.sty + Patched version of `minitoc.sty' to work with `hyperref.sty'. +ntheorem-hyper.sty + Patched version of `ntheorem.sty' to work with `hyperref.sty'. +xr-hyper.sty + Patched version of `xr.sty' to work with `hyperref.sty'. + +ChangeLog + Versions history +hylatex.ltx + For creating format file. +Makefile + Makefile for installing and other things. +manifest.txt + Short description of the files. +README + Short readme file. + +% Directory doc/ +% ============= + +manual.pdf + Manual, but a little out of date. +options.tex + Short description of options from package `hyperref'. +paper.pdf + Online version of paper for Heiko Oberdiek's talk + at EuroTeX'99. +slides.pdf + Slides for Heiko Oberdiek's talk at EuroTeX'99. + +% Directory test/ +% ============== + +test0.tex, test0.dvi, hog.eps, hog.pdf +test1.tex +test2.tex +test3.tex, phys1.jpg, phys2.jpg +test4.tex, bit.tex +test5.tex +test6.tex +test7.tex, test7.pdf +test8.tex +testams.tex +testbib.tex, testbib.bib, testbib.bbl +testbookmark.tex +testfor2.tex +testform.tex +testnb.tex +testoz.tex +testslide.tex, seminar.con +testurl.tex, testurl.bib, testurl.bbl +picture.eps, picture.pdf, picture.png + Used in `test0.tex' and `test1.tex'. + +testbmgl.tex + Test file that produces all glyphs of PDFDocEncoding + in the bookmarks and shows the commands to produce them. +testbmu.tex + Test file that produces glyphs 0x0000 until 0x04FF + of Unicode in the bookmarks and the commands. + (Caution: large pool size needed.) + +testbma.tex + Test files that shows some AcrobatReaders's problems + with some Unicode glyphs in bookmarks, screenshots: + bml.png: Lslash/lslash + bmoe.png: OE/oe + bmsc.png: Scaron/scaron + bmyi.png: Ydieresis/dotlessi + bmzc.png: Zcaron/zcaron diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.html b/Master/texmf-dist/doc/latex/hyperref/manual.html new file mode 100644 index 00000000000..afaaa8fa142 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual.html @@ -0,0 +1,4109 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title>Hypertext marks in LaTeX: a manual for hyperref</title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<!-- html --> +<meta name="src" content="manual.tex"> +<meta name="date" content="2004-02-12 15:16:00"> +<link rel="stylesheet" type="text/css" href="manual.css"> +</head><body +> + <div class="maketitle"> + + + + +<h2 class="titleHead">Hypertext marks in <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>: a manual for hyperref</h2> + <div class="author" ><span +class="ecrm-1200">Sebastian Rahtz </span><br class="and"><span +class="ecrm-1200">Heiko Oberdiek</span></div> +<br> +<div class="date" ><span +class="ecrm-1200">February 2004</span></div> + </div> + <h3 class="likesectionHead"><a + id="x1-1000"></a>Contents</h3> + <div class="tableofcontents"> + <span class="sectionToc">1 <a +href="#x1-20001" id="QQ2-1-2">Introduction</a></span> +<br> <span class="sectionToc">2 <a +href="#x1-30002" id="QQ2-1-3">Implicit behavior</a></span> +<br> <span class="sectionToc">3 <a +href="#x1-40003" id="QQ2-1-4">Package options</a></span> +<br> <span class="subsectionToc">3.1 <a +href="#x1-50003.1" id="QQ2-1-5">General options</a></span> +<br> <span class="subsectionToc">3.2 <a +href="#x1-60003.2" id="QQ2-1-6">Configuration options</a></span> +<br> <span class="subsectionToc">3.3 <a +href="#x1-70003.3" id="QQ2-1-7">Backend drivers</a></span> +<br> <span class="subsectionToc">3.4 <a +href="#x1-80003.4" id="QQ2-1-8">Extension options</a></span> +<br> <span class="subsectionToc">3.5 <a +href="#x1-90003.5" id="QQ2-1-9">PDF-specific display options</a></span> +<br> <span class="subsectionToc">3.6 <a +href="#x1-100003.6" id="QQ2-1-10">PDF display and information options</a></span> +<br> <span class="subsectionToc">3.7 <a +href="#x1-110003.7" id="QQ2-1-11">Big alphabetical list</a></span> +<br> <span class="sectionToc">4 <a +href="#x1-120004" id="QQ2-1-12">Additional user macros</a></span> +<br> <span class="subsectionToc">4.1 <a +href="#x1-130004.1" id="QQ2-1-13">Replacement macros</a></span> +<br> <span class="sectionToc">5 <a +href="#x1-140005" id="QQ2-1-14">Acrobat-specific behavior</a></span> +<br> <span class="sectionToc">6 <a +href="#x1-150006" id="QQ2-1-15">PDF and HTML forms</a></span> +<br> <span class="subsectionToc">6.1 <a +href="#x1-160006.1" id="QQ2-1-16">Forms environment parameters</a></span> +<br> <span class="subsectionToc">6.2 <a +href="#x1-170006.2" id="QQ2-1-17">Forms optional parameters</a></span> +<br> <span class="sectionToc">7 <a +href="#x1-180007" id="QQ2-1-18">Defining a new driver</a></span> +<br> <span class="sectionToc">8 <a +href="#x1-190008" id="QQ2-1-19">Special support for other packages</a></span> +<br> <span class="sectionToc">9 <a +href="#x1-200009" id="QQ2-1-20">History and acknowledgments</a></span> +<br> <span class="sectionToc">10 <a +href="#x1-2100010" id="QQ2-1-21">GNU Free Documentation License</a></span> +<br> <span class="subsectionToc">10.1 <a +href="#x1-2300010.1" id="QQ2-1-23">Applicability and definitions</a></span> +<br> <span class="subsectionToc">10.2 <a +href="#x1-2400010.2" id="QQ2-1-24">Verbatim copying</a></span> +<br> <span class="subsectionToc">10.3 <a +href="#x1-2500010.3" id="QQ2-1-25">Copying in quantity</a></span> +<br> <span class="subsectionToc">10.4 <a +href="#x1-2600010.4" id="QQ2-1-26">Modifications</a></span> +<br> <span class="subsectionToc">10.5 <a +href="#x1-2700010.5" id="QQ2-1-27">Combining documents</a></span> +<br> <span class="subsectionToc">10.6 <a +href="#x1-2800010.6" id="QQ2-1-28">Collections of documents</a></span> +<br> <span class="subsectionToc">10.7 <a +href="#x1-2900010.7" id="QQ2-1-29">Aggregation with independent works</a></span> +<br> <span class="subsectionToc">10.8 <a +href="#x1-3000010.8" id="QQ2-1-30">Translation</a></span> +<br> <span class="subsectionToc">10.9 <a +href="#x1-3100010.9" id="QQ2-1-31">Termination</a></span> +<br> <span class="subsectionToc">10.10 <a +href="#x1-3200010.10" id="QQ2-1-32">Future revisions of this license</a></span> + + + </div> +<!--l. 123--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">1 </span> <a + id="x1-20001"></a>Introduction</h3> +<!--l. 125--><p class="noindent">The package derives from, and builds on, the work of the Hyper<span class="TEX">T<span +class="E">E</span>X</span> project, described at +<a +href="http://xxx.lanl.gov/hypertex/" class="url" ><span +class="ectt-1000">http://xxx.lanl.gov/hypertex/</span></a>. It extends the functionality of all the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> cross-referencing +commands (including the table of contents, bibliographies etc) to produce <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands which a +driver can turn into hypertext links; it also provides new commands to allow the user to write <span +class="ecti-1000">ad hoc</span> +hypertext links, including those to external documents and URLs. +<!--l. 133--><p class="indent"> This manual provides a brief overview of the <span +class="ecss-1000">hyperref </span>package. For more details, you should read the +additional documentation distributed with the package, as well as the complete documentation by +processing <span +class="ectt-1000">hyperref.dtx</span>. You should also read the chapter on <span +class="ecss-1000">hyperref </span>in <span +class="ecti-1000">The </span><span class="LATEX"><span +class="ecti-1000">L</span><span class="A"><span +class="ecti-1000">A</span></span><span class="TEX"><span +class="ecti-1000">T</span><span +class="E"><span +class="ecti-1000">E</span></span><span +class="ecti-1000">X</span></span></span><span +class="ecti-1000"> Web Companion</span>, +where you will find additional examples. +<!--l. 140--><p class="indent"> The Hyper<span class="TEX">T<span +class="E">E</span>X</span> specification<a +href="manual2.html" id="manual2.html" ><sup>1</sup></a> +says that conformant viewers/translators must recognize the following set of <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> constructs: + <dl class="description"><dt class="description"> +<span +class="ecbx-1000">href:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<a</span><span +class="ectt-1000"> href</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "href_string"></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">name:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<a</span><span +class="ectt-1000"> name</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "name_string"></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">end:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:</a></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">image:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<img</span><span +class="ectt-1000"> src</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "href_string"></span></span></span> + </dd><dt class="description"> +<span +class="ecbx-1000">base_name:</span> </dt><dd +class="description"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">html:<base</span><span +class="ectt-1000"> href</span><span +class="ectt-1000"> =</span><span +class="ectt-1000"> "href_string"></span></span></span></dd></dl> +<!--l. 152--><p class="indent"> The <span +class="ecti-1000">href</span>, <span +class="ecti-1000">name </span>and <span +class="ecti-1000">end </span>commands are used to do the basic hypertext operations of establishing links +between sections of documents. The <span +class="ecti-1000">image </span>command is intended (as with current HTML +viewers) to place an image of arbitrary graphical format on the page in the current location. +The <span +class="ecti-1000">base_name </span>command is be used to communicate to the DVI viewer the full (URL) +location of the current document so that files specified by relative URL’s may be retrieved +correctly. +<!--l. 161--><p class="indent"> The <span +class="ecti-1000">href </span>and <span +class="ecti-1000">name </span>commands must be paired with an <span +class="ecti-1000">end </span>command later in the <span class="TEX">T<span +class="E">E</span>X</span> file—the +<span class="TEX">T<span +class="E">E</span>X</span> commands between the two ends of a pair form an <span +class="ecti-1000">anchor </span>in the document. In the case of an <span +class="ecti-1000">href</span> +command, the <span +class="ecti-1000">anchor </span>is to be highlighted in the <span +class="ecti-1000">DVI viewer</span>, and when clicked on will cause the scene to +shift to the destination specified by <span +class="ecti-1000">href_string</span>. The <span +class="ecti-1000">anchor </span>associated with a name command +represents a possible location to which other hypertext links may refer, either as local references +(of the form <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">href="#name_string"</span></span></span> with the <span +class="ecti-1000">name_string </span>identical to the one in the name +command) or as part of a URL (of the form <span +class="ecti-1000">URL#name_string</span>). Here <span +class="ecti-1000">href_string </span>is a valid URL +or local identifier, while <span +class="ecti-1000">name_string </span>could be any string at all: the only caveat is that ‘<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">"</span></span></span>’ +characters should be escaped with a backslash (<span +class="cmsy-10">\</span>), and if it looks like a URL name it may cause +problems. +<!--l. 177--><p class="indent"> However, the drivers intended to produce <span +class="ecti-1000">only </span>PDF use literal PostScript or PDF <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> +commands. The commands are defined in configuration files for different drivers, selected by package +options; at present, the following drivers are supported: + + <dl class="description"><dt class="description"> +<span +class="ecbx-1000">hypertex</span> </dt><dd +class="description">DVI processors conforming to the Hyper<span class="TEX">T<span +class="E">E</span>X</span> guidelines (i.e. <span +class="ecss-1000">xdvi</span>, <span +class="ecss-1000">dvips </span>(with the <span +class="ecss-1000">-z</span> + option), <span +class="ecss-1000">OzTeX</span>, and <span +class="ecss-1000">Textures</span>) + </dd><dt class="description"> +<span +class="ecbx-1000">dvips</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands tailored for <span +class="ecss-1000">dvips</span> + </dd><dt class="description"> +<span +class="ecbx-1000">dvipsone</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands tailored for <span +class="ecss-1000">dvipsone</span> + </dd><dt class="description"> +<span +class="ecbx-1000">ps2pdf</span> </dt><dd +class="description">a special case of output suitable for processing by earlier versions of Ghostscript’s PDF + writer; this is basically the same as that for <span +class="ecss-1000">dvips</span>, but a few variations remained before + version 5.21 + </dd><dt class="description"> +<span +class="ecbx-1000">tex4ht</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands for use with <span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span><span +class="ecss-1000">4ht</span> + </dd><dt class="description"> +<span +class="ecbx-1000">pdftex</span> </dt><dd +class="description">pdf<span class="TEX">T<span +class="E">E</span>X</span>, Hàn Thê' Thành’s <span class="TEX">T<span +class="E">E</span>X</span> variant that writes PDF directly + </dd><dt class="description"> +<span +class="ecbx-1000">dvipdf</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands for the DVI to PDF driver <span +class="ecss-1000">dvipdf</span> + </dd><dt class="description"> +<span +class="ecbx-1000">dvipdfm</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands for Mark Wicks’ DVI to PDF driver <span +class="ecss-1000">dvipdfm</span> + </dd><dt class="description"> +<span +class="ecbx-1000">dviwindo</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands that Y&Y’s Windows previewer interprets as hypertext + jumps within the previewer + </dd><dt class="description"> +<span +class="ecbx-1000">vtex</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands that MicroPress’ HTML and PDF-producing <span class="TEX">T<span +class="E">E</span>X</span> variants + interpret as hypertext jumps within the previewer + </dd><dt class="description"> +<span +class="ecbx-1000">textures</span> </dt><dd +class="description">produces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands that <span +class="ecss-1000">Textures </span>interprets as hypertext jumps within the + previewer</dd></dl> +<!--l. 200--><p class="indent"> Output from <span +class="ecss-1000">dvips </span>or <span +class="ecss-1000">dvipsone </span>must be processed using Acrobat Distiller to obtain a PDF +file.<a +href="manual3.html" id="manual3.html" ><sup>2</sup></a> +The result is generally preferable to that produced by using the <span +class="ecss-1000">hypertex </span>driver, and then +processing with <span +class="ecss-1000">dvips -z</span>, but the DVI file is not portable. The main advantage of using the +Hyper<span class="TEX">T<span +class="E">E</span>X</span> <span +class="ectt-1000">\special </span>commands is that you can also use the document in hypertext DVI viewers, such +as <span +class="ecss-1000">xdvi</span>. + <h3 class="sectionHead"><span class="titlemark">2 </span> <a + id="x1-30002"></a>Implicit behavior</h3> +<!--l. 212--><p class="noindent">This package can be used with more or less any normal <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> document by specifying in the +document preamble + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\usepackage{hyperref} +</div> +</td></tr></table> +<!--l. 217--><p class="nopar"> +<!--l. 219--><p class="indent"> Make sure it comes <span +class="ecti-1000">last </span>of your loaded packages, to give it a fighting chance of not being over-written, +since its job is to redefine many <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> commands. Hopefully you will find that all cross-references +work correctly as hypertext. For example, <span +class="ectt-1000">\section </span>commands will produce a bookmark and a +link, whereas <span +class="ectt-1000">\section* </span>commands will only show links when paired with a corresponding +<span +class="ectt-1000">\addcontentsline </span>command. +<!--l. 227--><p class="indent"> In addition, the <span +class="ectt-1000">hyperindex </span>option (see below) attempts to make items in the index by hyperlinked +back to the text, and the option <span +class="ectt-1000">backref </span>inserts extra ‘back’ links into the bibliography for each entry. +Other options control the appearance of links, and give extra control over PDF output. For example, +<span +class="ectt-1000">colorlinks</span>, as its name well implies, colors the links instead of using boxes; this is the option used in +this document. +<!--l. 236--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">3 </span> <a + id="x1-40003"></a>Package options</h3> +<!--l. 238--><p class="noindent">All user-configurable aspects of <span +class="ecss-1000">hyperref </span>are set using a single ‘key=value’ scheme (using the <span +class="ecss-1000">keyval</span> +package) with the key <span +class="ectt-1000">Hyp</span>. The options can be set either in the optional argument to the +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\usepackage</span></span></span> command, or using the <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypersetup</span></span></span> macro. When the package is loaded, a file +<span +class="ectt-1000">hyperref.cfg </span>is read if it can be found, and this is a convenient place to set options on a site-wide +basis. +<!--l. 246--><p class="indent"> As an example, the behavior of a particular file could be controlled by: + <ul class="itemize1"> + <li class="itemize">a site-wide <span +class="ectt-1000">hyperref.cfg </span>setting up the look of links, adding backreferencing, and setting + a PDF display default: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \hypersetup{backref, + <br />pdfpagemode=FullScreen, + <br />colorlinks=true} +</div> + </td></tr></table> + <!--l. 256--><p class="nopar"> + </li> + <li class="itemize">A global option in the file, which is passed down to <span +class="ecss-1000">hyperref</span>: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \documentclass[dvips]{article} +</div> + </td></tr></table> + <!--l. 263--><p class="nopar"> + </li> + <li class="itemize">File-specific options in the <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\usepackage</span></span></span> commands, which override the ones set in + <span +class="ectt-1000">hyperref.cfg</span>: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> + \usepackage[pdftitle={A Perfect Day},colorlinks=false]{hyperref} +</div> + </td></tr></table> + <!--l. 270--><p class="nopar"></li></ul> +<!--l. 273--><p class="indent"> Some options can be given at any time, but many are restricted: before <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\begin{document}</span></span></span>, only in +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\usepackage[...]{hyperref}</span></span></span>, before first use, etc. +<!--l. 277--><p class="indent"> In the key descriptions that follow, many options do not need a value, as they default to the value +true if used. These are the ones classed as ‘boolean’. The values true and false can always be specified, +however. +<!--l. 281--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.1 </span> <a + id="x1-50003.1"></a>General options</h4> +<!--l. 283--><p class="noindent">Firstly, the options to specify general behavior and page size. +<!--l. 286--><p class="noindent"> +<a + id="x1-5001r1"></a> <!--l. 287--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-2-1g"><col +id="TBL-2-1"><col +id="TBL-2-2"><col +id="TBL-2-3"><col +id="TBL-2-4"></colgroup> +<tr + valign="baseline" id="TBL-2-1-"><td align="left" style="white-space:nowrap;" id="TBL-2-1-1" +class="td11"> <span +class="ectt-1000">draft </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-1-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-1-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-1-4" +class="td11"> all hypertext options are turned off </td> +</tr><tr + valign="baseline" id="TBL-2-2-"><td align="left" style="white-space:nowrap;" id="TBL-2-2-1" +class="td11"> <span +class="ectt-1000">final </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-2-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-2-4" +class="td11"> all hypertext options are turned on </td> +</tr><tr + valign="baseline" id="TBL-2-3-"><td align="left" style="white-space:nowrap;" id="TBL-2-3-1" +class="td11"> <span +class="ectt-1000">debug </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-3-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-3-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-3-4" +class="td11"> extra diagnostic messages are printed in </td> +</tr><tr + valign="baseline" id="TBL-2-4-"><td align="left" style="white-space:nowrap;" id="TBL-2-4-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-4-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-4-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-4-4" +class="td11"> the log file </td> +</tr><tr + valign="baseline" id="TBL-2-5-"><td align="left" style="white-space:nowrap;" id="TBL-2-5-1" +class="td11"> <span +class="ectt-1000">verbose </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-5-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-5-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-5-4" +class="td11"> same as debug </td> +</tr><tr + valign="baseline" id="TBL-2-6-"><td align="left" style="white-space:nowrap;" id="TBL-2-6-1" +class="td11"> <span +class="ectt-1000">implicit </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-6-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-6-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-6-4" +class="td11"> redefines <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> internals </td> +</tr><tr + valign="baseline" id="TBL-2-7-"><td align="left" style="white-space:nowrap;" id="TBL-2-7-1" +class="td11"> <span +class="ectt-1000">hypertexnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-7-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-7-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-7-4" +class="td11"> use guessable names for links </td> +</tr><tr + valign="baseline" id="TBL-2-8-"><td align="left" style="white-space:nowrap;" id="TBL-2-8-1" +class="td11"> <span +class="ectt-1000">naturalnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-8-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-8-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-8-4" +class="td11"> use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-computed names for links </td> +</tr><tr + valign="baseline" id="TBL-2-9-"><td align="left" style="white-space:nowrap;" id="TBL-2-9-1" +class="td11"> <span +class="ectt-1000">a4paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-9-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-9-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-9-4" +class="td11"> sets paper size to 210mm <span +class="cmsy-10">× </span>297mm </td> +</tr><tr + valign="baseline" id="TBL-2-10-"><td align="left" style="white-space:nowrap;" id="TBL-2-10-1" +class="td11"> <span +class="ectt-1000">a5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-10-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-10-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-10-4" +class="td11"> sets paper size to 148mm <span +class="cmsy-10">× </span>210mm </td> +</tr><tr + valign="baseline" id="TBL-2-11-"><td align="left" style="white-space:nowrap;" id="TBL-2-11-1" +class="td11"> <span +class="ectt-1000">b5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-11-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-11-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-11-4" +class="td11"> sets paper size to 176mm <span +class="cmsy-10">× </span>250mm </td> +</tr><tr + valign="baseline" id="TBL-2-12-"><td align="left" style="white-space:nowrap;" id="TBL-2-12-1" +class="td11"> <span +class="ectt-1000">letterpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-12-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-12-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-12-4" +class="td11"> sets paper size to 8.5in <span +class="cmsy-10">× </span>11in </td> +</tr><tr + valign="baseline" id="TBL-2-13-"><td align="left" style="white-space:nowrap;" id="TBL-2-13-1" +class="td11"> <span +class="ectt-1000">legalpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-13-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-13-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-13-4" +class="td11"> sets paper size to 8.5in <span +class="cmsy-10">× </span>14in </td> +</tr><tr + valign="baseline" id="TBL-2-14-"><td align="left" style="white-space:nowrap;" id="TBL-2-14-1" +class="td11"> <span +class="ectt-1000">executivepaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-14-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-14-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-14-4" +class="td11"> sets paper size to 7.25in <span +class="cmsy-10">× </span>10.5in </td> +</tr><tr + valign="baseline" id="TBL-2-15-"><td align="left" style="white-space:nowrap;" id="TBL-2-15-1" +class="td11"> <span +class="ectt-1000">setpagesize </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-15-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-2-15-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" style="white-space:nowrap;" id="TBL-2-15-4" +class="td11"> sets page size by special driver commands </td> +</tr><tr + valign="baseline" id="TBL-2-16-"><td align="left" style="white-space:nowrap;" id="TBL-2-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-2-17-"><td align="left" style="white-space:nowrap;" id="TBL-2-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-2-18-"><td align="left" style="white-space:nowrap;" id="TBL-2-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-2-19-"><td align="left" style="white-space:nowrap;" id="TBL-2-19-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-19-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-19-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-2-19-4" +class="td11"></td></tr> + </table></div> +<!--l. 304--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.2 </span> <a + id="x1-60003.2"></a>Configuration options</h4> +<!--l. 306--><p class="noindent"> +<a + id="x1-6001r2"></a> <!--l. 307--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-3-1g"><col +id="TBL-3-1"><col +id="TBL-3-2"><col +id="TBL-3-3"><col +id="TBL-3-4"></colgroup> + + +<tr + valign="baseline" id="TBL-3-1-"><td align="left" style="white-space:nowrap;" id="TBL-3-1-1" +class="td11"> <span +class="ectt-1000">raiselinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-1-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-1-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-3-1-4" +class="td11"> + <!--l. 307--><p class="noindent">In the hypertex driver, the height of links is + normally calculcated by the driver as simply + the base line of contained text; this options + forces <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\special</span></span></span> commands to reflect the real + height of the link (which could contain a + graphic) </td> +</tr><tr + valign="baseline" id="TBL-3-2-"><td align="left" style="white-space:nowrap;" id="TBL-3-2-1" +class="td11"> <span +class="ectt-1000">breaklinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-2-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-3-2-4" +class="td11"> + <!--l. 310--><p class="noindent">Allows link text to break across lines; since + this cannot be accommodated in PDF, it is + only set true by default if the pdftex driver is + used. This makes links on multiple lines into + different PDF links to the same target. </td> +</tr><tr + valign="baseline" id="TBL-3-3-"><td align="left" style="white-space:nowrap;" id="TBL-3-3-1" +class="td11"> <span +class="ectt-1000">pageanchor </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-3-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-3-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-3-3-4" +class="td11"> + <!--l. 313--><p class="noindent">Determines whether every page is given an + implicit anchor at the top left corner. If + this is turned off, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\tableofcontents</span></span></span> will not + contain hyperlinks. </td> +</tr><tr + valign="baseline" id="TBL-3-4-"><td align="left" style="white-space:nowrap;" id="TBL-3-4-1" +class="td11"> <span +class="ectt-1000">plainpages </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-4-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-4-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-3-4-4" +class="td11"> + <!--l. 315--><p class="noindent">Forces page anchors to be named by the arabic + form of the page number, rather than the + formatted form. </td> +</tr><tr + valign="baseline" id="TBL-3-5-"><td align="left" style="white-space:nowrap;" id="TBL-3-5-1" +class="td11"> <span +class="ectt-1000">nesting </span></td><td align="left" style="white-space:nowrap;" id="TBL-3-5-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-3-5-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-3-5-4" +class="td11"> + <!--l. 317--><p class="noindent">Allows links to be nested; no drivers currently + support this. </td> +</tr><tr + valign="baseline" id="TBL-3-6-"><td align="left" style="white-space:nowrap;" id="TBL-3-6-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-3-7-"><td align="left" style="white-space:nowrap;" id="TBL-3-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-3-8-"><td align="left" style="white-space:nowrap;" id="TBL-3-8-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-3-9-"><td align="left" style="white-space:nowrap;" id="TBL-3-9-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-3-9-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-3-9-3" +class="td11"> </td><td align="left" id="TBL-3-9-4" +class="td11"></td></tr> + </table></div> +<!--l. 320--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.3 </span> <a + id="x1-70003.3"></a>Backend drivers</h4> +<!--l. 322--><p class="noindent">If no driver is specified, the package defaults to loading the <span +class="ecss-1000">hypertex </span>driver. All of these are boolean +options. +<!--l. 325--><p class="noindent"> +<a + id="x1-7001r3"></a> <!--l. 326--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-4-1g"><col +id="TBL-4-1"><col +id="TBL-4-2"></colgroup> +<tr + valign="baseline" id="TBL-4-1-"><td align="left" style="white-space:nowrap;" id="TBL-4-1-1" +class="td11"> <span +class="ectt-1000">dvips </span></td><td align="left" id="TBL-4-1-2" +class="td11"> + <!--l. 326--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">dvips </span>driver. </td> +</tr><tr + valign="baseline" id="TBL-4-2-"><td align="left" style="white-space:nowrap;" id="TBL-4-2-1" +class="td11"> <span +class="ectt-1000">dvipsone </span></td><td align="left" id="TBL-4-2-2" +class="td11"> + <!--l. 327--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">dvipsone </span>driver. </td> +</tr><tr + valign="baseline" id="TBL-4-3-"><td align="left" style="white-space:nowrap;" id="TBL-4-3-1" +class="td11"> <span +class="ectt-1000">dviwindo </span></td><td align="left" id="TBL-4-3-2" +class="td11"> + <!--l. 328--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">dviwindo </span>Windows previewer. </td> +</tr><tr + valign="baseline" id="TBL-4-4-"><td align="left" style="white-space:nowrap;" id="TBL-4-4-1" +class="td11"> <span +class="ectt-1000">hypertex </span></td><td align="left" id="TBL-4-4-2" +class="td11"> + <!--l. 329--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the Hyper<span class="TEX">T<span +class="E">E</span>X</span>-compliant drivers. </td> +</tr><tr + valign="baseline" id="TBL-4-5-"><td align="left" style="white-space:nowrap;" id="TBL-4-5-1" +class="td11"> <span +class="ectt-1000">latex2html </span></td><td align="left" id="TBL-4-5-2" +class="td11"> + <!--l. 330--><p class="noindent">Redefines a few macros for compatibility with <span +class="ecss-1000">latex2html</span>. </td> +</tr><tr + valign="baseline" id="TBL-4-6-"><td align="left" style="white-space:nowrap;" id="TBL-4-6-1" +class="td11"> <span +class="ectt-1000">nativepdf </span></td><td align="left" id="TBL-4-6-2" +class="td11"> + <!--l. 331--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> + + +</tr><tr + valign="baseline" id="TBL-4-7-"><td align="left" style="white-space:nowrap;" id="TBL-4-7-1" +class="td11"> <span +class="ectt-1000">pdfmark </span></td><td align="left" id="TBL-4-7-2" +class="td11"> + <!--l. 332--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> +</tr><tr + valign="baseline" id="TBL-4-8-"><td align="left" style="white-space:nowrap;" id="TBL-4-8-1" +class="td11"> <span +class="ectt-1000">pdftex </span></td><td align="left" id="TBL-4-8-2" +class="td11"> + <!--l. 333--><p class="noindent">Sets up <span +class="ecss-1000">hyperref </span>for use with the <span +class="ecss-1000">pdftex </span>program. </td> +</tr><tr + valign="baseline" id="TBL-4-9-"><td align="left" style="white-space:nowrap;" id="TBL-4-9-1" +class="td11"> <span +class="ectt-1000">ps2pdf </span></td><td align="left" id="TBL-4-9-2" +class="td11"> + <!--l. 334--><p class="noindent">Redefines a few macros for compatibility with Ghostscript’s PDF writer, + otherwise identical to <span +class="ecss-1000">dvips</span>. </td> +</tr><tr + valign="baseline" id="TBL-4-10-"><td align="left" style="white-space:nowrap;" id="TBL-4-10-1" +class="td11"> <span +class="ectt-1000">tex4ht </span></td><td align="left" id="TBL-4-10-2" +class="td11"> + <!--l. 337--><p class="noindent">for use with <span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span><span +class="ecss-1000">4ht</span> </td> +</tr><tr + valign="baseline" id="TBL-4-11-"><td align="left" style="white-space:nowrap;" id="TBL-4-11-1" +class="td11"> <span +class="ectt-1000">textures </span></td><td align="left" id="TBL-4-11-2" +class="td11"> + <!--l. 338--><p class="noindent">for use with <span +class="ecss-1000">Textures</span> </td> +</tr><tr + valign="baseline" id="TBL-4-12-"><td align="left" style="white-space:nowrap;" id="TBL-4-12-1" +class="td11"> <span +class="ectt-1000">vtex </span></td><td align="left" id="TBL-4-12-2" +class="td11"> + <!--l. 339--><p class="noindent">For use with MicroPress’ <span +class="ecss-1000">VTeX</span>; the PDF and HTML backends are detected + automatically. </td> +</tr><tr + valign="baseline" id="TBL-4-13-"><td align="left" style="white-space:nowrap;" id="TBL-4-13-1" +class="td11"> <span +class="ectt-1000">vtexpdfmark </span></td><td align="left" id="TBL-4-13-2" +class="td11"> + <!--l. 341--><p class="noindent">for use with <span +class="ecss-1000">VTeX</span>’s PostScript backend. </td> +</tr><tr + valign="baseline" id="TBL-4-14-"><td align="left" style="white-space:nowrap;" id="TBL-4-14-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-15-"><td align="left" style="white-space:nowrap;" id="TBL-4-15-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-16-"><td align="left" style="white-space:nowrap;" id="TBL-4-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-17-"><td align="left" style="white-space:nowrap;" id="TBL-4-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-4-18-"><td align="left" style="white-space:nowrap;" id="TBL-4-18-1" +class="td11"> </td><td align="left" id="TBL-4-18-2" +class="td11"></td></tr> + </table></div> +<!--l. 344--><p class="indent"> If you use <span +class="ecss-1000">dviwindo</span>, you may need to redefine the macro <span +class="ectt-1000">\wwwbrowser </span>(the default is +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">C:\netscape\netscape</span></span></span>) to tell <span +class="ecss-1000">dviwindo </span>what program to launch. Thus, users of Internet Explorer might +add something like this to hyperref.cfg: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\renewcommand{wwwbrowser}{C:\string\Program\space + <br /> Files\string\Plus!\string\Microsoft\space + <br /> Internet\string\iexplore.exe} +</div> +</td></tr></table> +<!--l. 353--><p class="nopar"> +<!--l. 355--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.4 </span> <a + id="x1-80003.4"></a>Extension options</h4> +<!--l. 356--><p class="noindent"> +<a + id="x1-8001r4"></a> <!--l. 357--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-5-1g"><col +id="TBL-5-1"><col +id="TBL-5-2"><col +id="TBL-5-3"><col +id="TBL-5-4"></colgroup> +<tr + valign="baseline" id="TBL-5-1-"><td align="left" style="white-space:nowrap;" id="TBL-5-1-1" +class="td11"> <span +class="ectt-1000">extension </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-1-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-5-1-3" +class="td11"> </td><td align="left" id="TBL-5-1-4" +class="td11"> + <!--l. 357--><p class="noindent">Set the file extension (e.g. <span +class="ecss-1000">dvi</span>) which + will be appended to file links created if + you use the <span +class="ecss-1000">xr </span>package. </td> +</tr><tr + valign="baseline" id="TBL-5-2-"><td align="left" style="white-space:nowrap;" id="TBL-5-2-1" +class="td11"> <span +class="ectt-1000">hyperfigures </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-2-3" +class="td11"> </td><td align="left" id="TBL-5-2-4" +class="td11"> + <!--l. 360--><p class="noindent"> </td> +</tr><tr + valign="baseline" id="TBL-5-3-"><td align="left" style="white-space:nowrap;" id="TBL-5-3-1" +class="td11"> <span +class="ectt-1000">backref </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-3-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-3-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-3-4" +class="td11"> + <!--l. 360--><p class="noindent">Adds ‘backlink’ text to the end of each + item in the bibliography, as a list of + section numbers. This can only work + properly <span +class="ecti-1000">if </span>there is a blank line after + each <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\bibitem</span></span></span>. </td> +</tr><tr + valign="baseline" id="TBL-5-4-"><td align="left" style="white-space:nowrap;" id="TBL-5-4-1" +class="td11"> <span +class="ectt-1000">pagebackref </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-4-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-4-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-4-4" +class="td11"> + <!--l. 363--><p class="noindent">Adds ‘backlink’ text to the end of each + item in the bibliography, as a list of + page numbers. </td> +</tr><tr + valign="baseline" id="TBL-5-5-"><td align="left" style="white-space:nowrap;" id="TBL-5-5-1" +class="td11"> <span +class="ectt-1000">hyperindex </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-5-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-5-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-5-4" +class="td11"> + <!--l. 365--><p class="noindent">Makes the text of index entries into + hyperlinks. Easily broken . . . </td> +</tr><tr + valign="baseline" id="TBL-5-6-"><td align="left" style="white-space:nowrap;" id="TBL-5-6-1" +class="td11"> <span +class="ectt-1000">encap </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-6-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-5-6-3" +class="td11"> </td><td align="left" id="TBL-5-6-4" +class="td11"> + <!--l. 366--><p class="noindent">Sets encap character for hyperindex </td> +</tr><tr + valign="baseline" id="TBL-5-7-"><td align="left" style="white-space:nowrap;" id="TBL-5-7-1" +class="td11"> <span +class="ectt-1000">linktocpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-7-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-7-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-7-4" +class="td11"> + <!--l. 367--><p class="noindent">make page number, not text, be link on + TOC, LOF and LOT </td> +</tr><tr + valign="baseline" id="TBL-5-8-"><td align="left" style="white-space:nowrap;" id="TBL-5-8-1" +class="td11"> <span +class="ectt-1000">breaklinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-8-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-8-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-8-4" +class="td11"> + <!--l. 368--><p class="noindent">allow links to break over lines by + making links over multiple lines into + PDF links to the same target </td> +</tr><tr + valign="baseline" id="TBL-5-9-"><td align="left" style="white-space:nowrap;" id="TBL-5-9-1" +class="td11"> <span +class="ectt-1000">colorlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-9-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-9-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-9-4" +class="td11"> + <!--l. 370--><p class="noindent">Colors the text of links and anchors. + The colors chosen depend on the the + type of link. At present the only types + of link distinguished are citations, page + references, URLs, local file references, + and other links. </td> + + +</tr><tr + valign="baseline" id="TBL-5-10-"><td align="left" style="white-space:nowrap;" id="TBL-5-10-1" +class="td11"> <span +class="ectt-1000">linkcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-10-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-10-3" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-5-10-4" +class="td11"> + <!--l. 373--><p class="noindent">Color for normal internal links. </td> +</tr><tr + valign="baseline" id="TBL-5-11-"><td align="left" style="white-space:nowrap;" id="TBL-5-11-1" +class="td11"> <span +class="ectt-1000">anchorcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-11-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-11-3" +class="td11"> <span +class="ecti-1000">black </span></td><td align="left" id="TBL-5-11-4" +class="td11"> + <!--l. 374--><p class="noindent">Color for anchor text. </td> +</tr><tr + valign="baseline" id="TBL-5-12-"><td align="left" style="white-space:nowrap;" id="TBL-5-12-1" +class="td11"> <span +class="ectt-1000">citecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-12-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-12-3" +class="td11"> <span +class="ecti-1000">green </span></td><td align="left" id="TBL-5-12-4" +class="td11"> + <!--l. 375--><p class="noindent">Color for bibliographical citations in + text. </td> +</tr><tr + valign="baseline" id="TBL-5-13-"><td align="left" style="white-space:nowrap;" id="TBL-5-13-1" +class="td11"> <span +class="ectt-1000">filecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-13-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-13-3" +class="td11"> <span +class="ecti-1000">magenta </span></td><td align="left" id="TBL-5-13-4" +class="td11"> + <!--l. 376--><p class="noindent">Color for URLs which open local files. </td> +</tr><tr + valign="baseline" id="TBL-5-14-"><td align="left" style="white-space:nowrap;" id="TBL-5-14-1" +class="td11"> <span +class="ectt-1000">menucolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-14-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-14-3" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-5-14-4" +class="td11"> + <!--l. 377--><p class="noindent">Color for Acrobat menu items. </td> +</tr><tr + valign="baseline" id="TBL-5-15-"><td align="left" style="white-space:nowrap;" id="TBL-5-15-1" +class="td11"> <span +class="ectt-1000">pagecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-15-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-15-3" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-5-15-4" +class="td11"> + <!--l. 378--><p class="noindent">Color for links to other pages. </td> +</tr><tr + valign="baseline" id="TBL-5-16-"><td align="left" style="white-space:nowrap;" id="TBL-5-16-1" +class="td11"> <span +class="ectt-1000">urlcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-16-2" +class="td11"> color </td><td align="left" style="white-space:nowrap;" id="TBL-5-16-3" +class="td11"> <span +class="ecti-1000">cyan </span></td><td align="left" id="TBL-5-16-4" +class="td11"> + <!--l. 379--><p class="noindent">Color for linked URLs. </td> +</tr><tr + valign="baseline" id="TBL-5-17-"><td align="left" style="white-space:nowrap;" id="TBL-5-17-1" +class="td11"> <span +class="ectt-1000">frenchlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-5-17-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-5-17-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-5-17-4" +class="td11"> + <!--l. 380--><p class="noindent">use small caps instead of color for links </td> +</tr><tr + valign="baseline" id="TBL-5-18-"><td align="left" style="white-space:nowrap;" id="TBL-5-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-5-19-"><td align="left" style="white-space:nowrap;" id="TBL-5-19-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-5-20-"><td align="left" style="white-space:nowrap;" id="TBL-5-20-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-5-21-"><td align="left" style="white-space:nowrap;" id="TBL-5-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-5-21-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-5-21-3" +class="td11"> </td><td align="left" id="TBL-5-21-4" +class="td11"></td></tr> + </table></div> +<!--l. 383--><p class="indent"> Note that all color names must be defined before use, following the normal system of the standard +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> <span +class="ecss-1000">color </span>package. +<!--l. 386--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a + id="x1-90003.5"></a>PDF-specific display options</h4> +<!--l. 387--><p class="noindent"> +<a + id="x1-9001r5"></a> <!--l. 388--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-6-1g"><col +id="TBL-6-1"><col +id="TBL-6-2"><col +id="TBL-6-3"><col +id="TBL-6-4"></colgroup> +<tr + valign="baseline" id="TBL-6-1-"><td align="left" style="white-space:nowrap;" id="TBL-6-1-1" +class="td11"> <span +class="ectt-1000">bookmarks </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-1-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-6-1-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-6-1-4" +class="td11"> + <!--l. 388--><p class="noindent">A set of Acrobat bookmarks are + written, in + a manner similar to the table of + contents, requiring two passes of + <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>. Some postprocessing of + the bookmark file (file extension + <span +class="ectt-1000">.out</span>) may be needed to translate + <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> codes, since bookmarks + must + be written in PDFEncoding. To + aid this process, the <span +class="ectt-1000">.out </span>file + is not rewritten by <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> if + it is edited to contain a line + <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\let\WriteBookmarks\relax</span></span></span> </td> +</tr><tr + valign="baseline" id="TBL-6-2-"><td align="left" style="white-space:nowrap;" id="TBL-6-2-1" +class="td11"> <span +class="ectt-1000">bookmarksopen </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-2-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-6-2-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-6-2-4" +class="td11"> + <!--l. 394--><p class="noindent">If Acrobat bookmarks + are requested, show them with + all the subtrees expanded. </td> + + +</tr><tr + valign="baseline" id="TBL-6-3-"><td align="left" style="white-space:nowrap;" id="TBL-6-3-1" +class="td11"> <span +class="ectt-1000">bookmarksopenlevel </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-3-2" +class="td11"> parameter </td><td align="left" style="white-space:nowrap;" id="TBL-6-3-3" +class="td11"> </td><td align="left" id="TBL-6-3-4" +class="td11"> + <!--l. 396--><p class="noindent">level (<span +class="ectt-1000">\maxdimen</span>) to which + bookmarks are open </td> +</tr><tr + valign="baseline" id="TBL-6-4-"><td align="left" style="white-space:nowrap;" id="TBL-6-4-1" +class="td11"> <span +class="ectt-1000">bookmarksnumbered </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-4-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-6-4-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-6-4-4" +class="td11"> + <!--l. 397--><p class="noindent">If Acrobat bookmarks + are requested, include section + numbers. </td> +</tr><tr + valign="baseline" id="TBL-6-5-"><td align="left" style="white-space:nowrap;" id="TBL-6-5-1" +class="td11"> <span +class="ectt-1000">bookmarkstype </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-5-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-6-5-3" +class="td11"> <span +class="ecti-1000">toc </span></td><td align="left" id="TBL-6-5-4" +class="td11"> + <!--l. 398--><p class="noindent">to specify which ‘toc’ file to + mimic </td> +</tr><tr + valign="baseline" id="TBL-6-6-"><td align="left" style="white-space:nowrap;" id="TBL-6-6-1" +class="td11"> <span +class="ectt-1000">pdfhighlight </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-6-2" +class="td11"> name </td><td align="left" style="white-space:nowrap;" id="TBL-6-6-3" +class="td11"> <span +class="ecti-1000">/I </span></td><td align="left" id="TBL-6-6-4" +class="td11"> + <!--l. 399--><p class="noindent">How link buttons behave when + selected; /I is for inverse (the + default); the other possibilities + are /N (no effect), /O (outline), + and /P (inset highlighting). </td> +</tr><tr + valign="baseline" id="TBL-6-7-"><td align="left" style="white-space:nowrap;" id="TBL-6-7-1" +class="td11"> <span +class="ectt-1000">citebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-7-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-7-3" +class="td11"> <span +class="ecti-1000">0 1 0 </span></td><td align="left" id="TBL-6-7-4" +class="td11"> + <!--l. 402--><p class="noindent">The color of the box around + citations </td> +</tr><tr + valign="baseline" id="TBL-6-8-"><td align="left" style="white-space:nowrap;" id="TBL-6-8-1" +class="td11"> <span +class="ectt-1000">filebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-8-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-8-3" +class="td11"> <span +class="ecti-1000">0 .5 .5 </span></td><td align="left" id="TBL-6-8-4" +class="td11"> + <!--l. 403--><p class="noindent">The color of the box around links + to files </td> +</tr><tr + valign="baseline" id="TBL-6-9-"><td align="left" style="white-space:nowrap;" id="TBL-6-9-1" +class="td11"> <span +class="ectt-1000">linkbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-9-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-9-3" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-6-9-4" +class="td11"> + <!--l. 404--><p class="noindent">The color of the box around + normal links </td> +</tr><tr + valign="baseline" id="TBL-6-10-"><td align="left" style="white-space:nowrap;" id="TBL-6-10-1" +class="td11"> <span +class="ectt-1000">menubordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-10-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-10-3" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-6-10-4" +class="td11"> + <!--l. 405--><p class="noindent">The color of the box around + Acrobat menu links </td> +</tr><tr + valign="baseline" id="TBL-6-11-"><td align="left" style="white-space:nowrap;" id="TBL-6-11-1" +class="td11"> <span +class="ectt-1000">pagebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-11-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-11-3" +class="td11"> <span +class="ecti-1000">1 1 0 </span></td><td align="left" id="TBL-6-11-4" +class="td11"> + <!--l. 406--><p class="noindent">The color of the box around links + to pages </td> +</tr><tr + valign="baseline" id="TBL-6-12-"><td align="left" style="white-space:nowrap;" id="TBL-6-12-1" +class="td11"> <span +class="ectt-1000">urlbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-12-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-12-3" +class="td11"> <span +class="ecti-1000">0 1 1 </span></td><td align="left" id="TBL-6-12-4" +class="td11"> + <!--l. 407--><p class="noindent">The color of the box around links + to URLs </td> +</tr><tr + valign="baseline" id="TBL-6-13-"><td align="left" style="white-space:nowrap;" id="TBL-6-13-1" +class="td11"> <span +class="ectt-1000">runbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-13-2" +class="td11"> RGB color </td><td align="left" style="white-space:nowrap;" id="TBL-6-13-3" +class="td11"> <span +class="ecti-1000">0 .7 .7 </span></td><td align="left" id="TBL-6-13-4" +class="td11"> + <!--l. 408--><p class="noindent">color of border around ‘run’ links </td> +</tr><tr + valign="baseline" id="TBL-6-14-"><td align="left" style="white-space:nowrap;" id="TBL-6-14-1" +class="td11"> <span +class="ectt-1000">pdfborder </span></td><td align="left" style="white-space:nowrap;" id="TBL-6-14-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-6-14-3" +class="td11"> <span +class="ecti-1000">0 0 1 </span></td><td align="left" id="TBL-6-14-4" +class="td11"> + <!--l. 409--><p class="noindent">The style of box around links; + defaults to a box with lines of + 1pt thickness, but the colorlinks + option resets it to produce no + border. </td> +</tr><tr + valign="baseline" id="TBL-6-15-"><td align="left" style="white-space:nowrap;" id="TBL-6-15-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-6-16-"><td align="left" style="white-space:nowrap;" id="TBL-6-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-6-17-"><td align="left" style="white-space:nowrap;" id="TBL-6-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-6-18-"><td align="left" style="white-space:nowrap;" id="TBL-6-18-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-6-18-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-6-18-3" +class="td11"> </td><td align="left" id="TBL-6-18-4" +class="td11"></td></tr> + </table></div> +<!--l. 413--><p class="indent"> Note that the color of link borders can be specified <span +class="ecti-1000">only </span>as 3 numbers in the range 0..1, giving an +RGB color. You cannot use colors defined in <span class="TEX">T<span +class="E">E</span>X</span>. +<!--l. 417--><p class="indent"> The bookmark commands are stored in a file called <span +class="ecti-1000">jobname</span><span +class="ectt-1000">.out</span>. The files is not processed by +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> so any markup is passed through. You can postprocess this file as needed; as an aid + +for this, the <span +class="ectt-1000">.out </span>file is not overwritten on the next <span class="TEX">T<span +class="E">E</span>X</span> run if it is edited to contain the +line +<br class="newline"> + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\let\WriteBookmarks\relax +</div> +</td></tr></table> +<!--l. 425--><p class="nopar"> +<!--l. 427--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.6 </span> <a + id="x1-100003.6"></a>PDF display and information options</h4> +<!--l. 428--><p class="noindent"> +<a + id="x1-10001r6"></a> <!--l. 429--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-7-1g"><col +id="TBL-7-1"><col +id="TBL-7-2"><col +id="TBL-7-3"><col +id="TBL-7-4"></colgroup> +<tr + valign="baseline" id="TBL-7-1-"><td align="left" style="white-space:nowrap;" id="TBL-7-1-1" +class="td11"> <span +class="ectt-1000">baseurl </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-1-2" +class="td11"> URL </td><td align="left" style="white-space:nowrap;" id="TBL-7-1-3" +class="td11"> </td><td align="left" id="TBL-7-1-4" +class="td11"> + <!--l. 429--><p class="noindent">Sets the base URL of the PDF + document </td> +</tr><tr + valign="baseline" id="TBL-7-2-"><td align="left" style="white-space:nowrap;" id="TBL-7-2-1" +class="td11"> <span +class="ectt-1000">pdfpagemode </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-2-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-2-3" +class="td11"> <span +class="ecti-1000">None </span></td><td align="left" id="TBL-7-2-4" +class="td11"> + <!--l. 430--><p class="noindent">Determines how the file is + opening in Acrobat; the possibilities are + <span +class="ectt-1000">None</span>, <span +class="ectt-1000">UseThumbs </span>(show thumbnails), + <span +class="ectt-1000">UseOutlines </span>(show bookmarks), and + <span +class="ectt-1000">FullScreen</span>. If no mode if explicitly + chosen, but the bookmarks option is + set, <span +class="ectt-1000">UseOutlines </span>is used. </td> +</tr><tr + valign="baseline" id="TBL-7-3-"><td align="left" style="white-space:nowrap;" id="TBL-7-3-1" +class="td11"> <span +class="ectt-1000">pdftitle </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-3-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-3-3" +class="td11"> </td><td align="left" id="TBL-7-3-4" +class="td11"> + <!--l. 434--><p class="noindent">Sets the document information Title + field </td> +</tr><tr + valign="baseline" id="TBL-7-4-"><td align="left" style="white-space:nowrap;" id="TBL-7-4-1" +class="td11"> <span +class="ectt-1000">pdfauthor </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-4-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-4-3" +class="td11"> </td><td align="left" id="TBL-7-4-4" +class="td11"> + <!--l. 435--><p class="noindent">Sets the document information Author + field </td> +</tr><tr + valign="baseline" id="TBL-7-5-"><td align="left" style="white-space:nowrap;" id="TBL-7-5-1" +class="td11"> <span +class="ectt-1000">pdfsubject </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-5-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-5-3" +class="td11"> </td><td align="left" id="TBL-7-5-4" +class="td11"> + <!--l. 436--><p class="noindent">Sets the document information Subject + field </td> +</tr><tr + valign="baseline" id="TBL-7-6-"><td align="left" style="white-space:nowrap;" id="TBL-7-6-1" +class="td11"> <span +class="ectt-1000">pdfcreator </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-6-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-6-3" +class="td11"> </td><td align="left" id="TBL-7-6-4" +class="td11"> + <!--l. 437--><p class="noindent">Sets the document information Creator + field </td> +</tr><tr + valign="baseline" id="TBL-7-7-"><td align="left" style="white-space:nowrap;" id="TBL-7-7-1" +class="td11"> <span +class="ectt-1000">pdfproducer </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-7-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-7-3" +class="td11"> </td><td align="left" id="TBL-7-7-4" +class="td11"> + <!--l. 438--><p class="noindent">Sets the document information + Producer field </td> +</tr><tr + valign="baseline" id="TBL-7-8-"><td align="left" style="white-space:nowrap;" id="TBL-7-8-1" +class="td11"> <span +class="ectt-1000">pdfkeywords </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-8-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-8-3" +class="td11"> </td><td align="left" id="TBL-7-8-4" +class="td11"> + <!--l. 439--><p class="noindent">Sets the document information + Keywords field </td> +</tr><tr + valign="baseline" id="TBL-7-9-"><td align="left" style="white-space:nowrap;" id="TBL-7-9-1" +class="td11"> <span +class="ectt-1000">pdfview </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-9-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-9-3" +class="td11"> <span +class="ecti-1000">FitBH </span></td><td align="left" id="TBL-7-9-4" +class="td11"> + <!--l. 440--><p class="noindent">Sets the default PDF ‘view’ for each + link </td> +</tr><tr + valign="baseline" id="TBL-7-10-"><td align="left" style="white-space:nowrap;" id="TBL-7-10-1" +class="td11"> <span +class="ectt-1000">pdfstartpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-10-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-10-3" +class="td11"> <span +class="ecti-1000">1 </span></td><td align="left" id="TBL-7-10-4" +class="td11"> + <!--l. 441--><p class="noindent">Determines on which page the PDF file + is opened. </td> +</tr><tr + valign="baseline" id="TBL-7-11-"><td align="left" style="white-space:nowrap;" id="TBL-7-11-1" +class="td11"> <span +class="ectt-1000">pdfstartview </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-11-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-11-3" +class="td11"> <span +class="ecti-1000">FitB </span></td><td align="left" id="TBL-7-11-4" +class="td11"> + <!--l. 442--><p class="noindent">Set the startup page view </td> + + +</tr><tr + valign="baseline" id="TBL-7-12-"><td align="left" style="white-space:nowrap;" id="TBL-7-12-1" +class="td11"> <span +class="ectt-1000">pdfpagescrop </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-12-2" +class="td11"> n n n n </td><td align="left" style="white-space:nowrap;" id="TBL-7-12-3" +class="td11"> </td><td align="left" id="TBL-7-12-4" +class="td11"> + <!--l. 443--><p class="noindent">Sets the default PDF crop box for + pages. This should be a set of four + numbers </td> +</tr><tr + valign="baseline" id="TBL-7-13-"><td align="left" style="white-space:nowrap;" id="TBL-7-13-1" +class="td11"> <span +class="ectt-1000">pdfcenterwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-13-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-13-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-13-4" +class="td11"> + <!--l. 444--><p class="noindent">position the document window in the + center of the screen </td> +</tr><tr + valign="baseline" id="TBL-7-14-"><td align="left" style="white-space:nowrap;" id="TBL-7-14-1" +class="td11"> <span +class="ectt-1000">pdffitwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-14-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-14-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-14-4" +class="td11"> + <!--l. 445--><p class="noindent">resize document window to fit + document size </td> +</tr><tr + valign="baseline" id="TBL-7-15-"><td align="left" style="white-space:nowrap;" id="TBL-7-15-1" +class="td11"> <span +class="ectt-1000">pdfmenubar </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-15-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-15-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-7-15-4" +class="td11"> + <!--l. 446--><p class="noindent">make PDF viewer’s menu bar visible </td> +</tr><tr + valign="baseline" id="TBL-7-16-"><td align="left" style="white-space:nowrap;" id="TBL-7-16-1" +class="td11"> <span +class="ectt-1000">pdfnewwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-16-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-16-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-16-4" +class="td11"> + <!--l. 447--><p class="noindent">make links that open another PDF file + start a new window </td> +</tr><tr + valign="baseline" id="TBL-7-17-"><td align="left" style="white-space:nowrap;" id="TBL-7-17-1" +class="td11"> <span +class="ectt-1000">pdfpagelayout </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-17-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-17-3" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-7-17-4" +class="td11"> + <!--l. 448--><p class="noindent">set layout of PDF pages </td> +</tr><tr + valign="baseline" id="TBL-7-18-"><td align="left" style="white-space:nowrap;" id="TBL-7-18-1" +class="td11"> <span +class="ectt-1000">pdfpagelabels </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-18-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-18-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-7-18-4" +class="td11"> + <!--l. 449--><p class="noindent">set PDF page labels </td> +</tr><tr + valign="baseline" id="TBL-7-19-"><td align="left" style="white-space:nowrap;" id="TBL-7-19-1" +class="td11"> <span +class="ectt-1000">pdfpagetransition </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-19-2" +class="td11"> text </td><td align="left" style="white-space:nowrap;" id="TBL-7-19-3" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-7-19-4" +class="td11"> + <!--l. 450--><p class="noindent">set PDF page transition style </td> +</tr><tr + valign="baseline" id="TBL-7-20-"><td align="left" style="white-space:nowrap;" id="TBL-7-20-1" +class="td11"> <span +class="ectt-1000">pdftoolbar </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-20-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-20-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-7-20-4" +class="td11"> + <!--l. 451--><p class="noindent">make PDF toolbar visible </td> +</tr><tr + valign="baseline" id="TBL-7-21-"><td align="left" style="white-space:nowrap;" id="TBL-7-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-7-21-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-7-21-3" +class="td11"> </td><td align="left" id="TBL-7-21-4" +class="td11"></td></tr> +<tr + valign="baseline" id="TBL-7-22-"><td align="left" style="white-space:nowrap;" id="TBL-7-22-1" +class="td11"> <span +class="ectt-1000">pdfwindowui </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-22-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-7-22-3" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-7-22-4" +class="td11"> + <!--l. 452--><p class="noindent">make PDF user interface elements + visible </td> +</tr><tr + valign="baseline" id="TBL-7-23-"><td align="left" style="white-space:nowrap;" id="TBL-7-23-1" +class="td11"> <span +class="ectt-1000">unicode </span></td><td align="left" style="white-space:nowrap;" id="TBL-7-23-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-7-23-3" +class="td11"> </td><td align="left" id="TBL-7-23-4" +class="td11"> + <!--l. 453--><p class="noindent">Unicode encoded PDF strings </td> +</tr><tr + valign="baseline" id="TBL-7-24-"><td align="left" style="white-space:nowrap;" id="TBL-7-24-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-7-25-"><td align="left" style="white-space:nowrap;" id="TBL-7-25-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-7-26-"><td align="left" style="white-space:nowrap;" id="TBL-7-26-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-7-27-"><td align="left" style="white-space:nowrap;" id="TBL-7-27-1" +class="td11"> </td> + </tr> + </table></div> +<!--l. 456--><p class="indent"> Each link in Acrobat carries its own magnification level, which is set using PDF coordinate space, +which is not the same as <span class="TEX">T<span +class="E">E</span>X</span>’s. pdf<span class="TEX">T<span +class="E">E</span>X</span> works by supplying default values for <span +class="ectt-1000">XYZ </span>(horizontal <span +class="cmsy-10">×</span> +vertical <span +class="cmsy-10">× </span>zoom) and <span +class="ectt-1000">FitBH</span>. However, drivers using <span +class="ectt-1000">pdfmark </span>do not supply defaults, so <span +class="ecss-1000">hyperref </span>passes in +a value of -32768, which causes Acrobat to set (usually) sensible defaults. The following are possible +values for the <span +class="ectt-1000">pdfview </span>and <span +class="ectt-1000">pdfstartview </span>parameters. +<!--l. 465--><p class="noindent"> +<a + id="x1-10002r7"></a> <!--l. 466--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-8-1g"><col +id="TBL-8-1"><col +id="TBL-8-2"><col +id="TBL-8-3"></colgroup> +<tr + valign="baseline" id="TBL-8-1-"><td align="left" style="white-space:nowrap;" id="TBL-8-1-1" +class="td11"> <span +class="ectt-1000">XYZ </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-1-2" +class="td11"> <span +class="ecti-1000">left top zoom </span></td><td align="left" id="TBL-8-1-3" +class="td11"> + <!--l. 466--><p class="noindent">Sets a coordinate and a zoom factor. If any one + is null, the source link value is used. <span +class="ecti-1000">null null</span> + <span +class="ecti-1000">null </span>will give the same values as the current + page. </td> +</tr><tr + valign="baseline" id="TBL-8-2-"><td align="left" style="white-space:nowrap;" id="TBL-8-2-1" +class="td11"> <span +class="ectt-1000">Fit </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-2-2" +class="td11"> </td><td align="left" id="TBL-8-2-3" +class="td11"> + <!--l. 468--><p class="noindent">Fits the page to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-3-"><td align="left" style="white-space:nowrap;" id="TBL-8-3-1" +class="td11"> <span +class="ectt-1000">FitH </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-3-2" +class="td11"> <span +class="ecti-1000">top </span></td><td align="left" id="TBL-8-3-3" +class="td11"> + <!--l. 469--><p class="noindent">Fits the width of the page to the window. </td> + + +</tr><tr + valign="baseline" id="TBL-8-4-"><td align="left" style="white-space:nowrap;" id="TBL-8-4-1" +class="td11"> <span +class="ectt-1000">FitV </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-4-2" +class="td11"> <span +class="ecti-1000">left </span></td><td align="left" id="TBL-8-4-3" +class="td11"> + <!--l. 470--><p class="noindent">Fits the height of the page to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-5-"><td align="left" style="white-space:nowrap;" id="TBL-8-5-1" +class="td11"> <span +class="ectt-1000">FitR </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-5-2" +class="td11"> <span +class="ecti-1000">left bottom right top </span></td><td align="left" id="TBL-8-5-3" +class="td11"> + <!--l. 471--><p class="noindent">Fits the rectangle specified by the four + coordinates to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-6-"><td align="left" style="white-space:nowrap;" id="TBL-8-6-1" +class="td11"> <span +class="ectt-1000">FitB </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-6-2" +class="td11"> </td><td align="left" id="TBL-8-6-3" +class="td11"> + <!--l. 472--><p class="noindent">Fits the page bounding box to the window. </td> +</tr><tr + valign="baseline" id="TBL-8-7-"><td align="left" style="white-space:nowrap;" id="TBL-8-7-1" +class="td11"> <span +class="ectt-1000">FitBH </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-7-2" +class="td11"> <span +class="ecti-1000">top </span></td><td align="left" id="TBL-8-7-3" +class="td11"> + <!--l. 473--><p class="noindent">Fits the width of the page bounding box to + the window. </td> +</tr><tr + valign="baseline" id="TBL-8-8-"><td align="left" style="white-space:nowrap;" id="TBL-8-8-1" +class="td11"> <span +class="ectt-1000">FitBV </span></td><td align="left" style="white-space:nowrap;" id="TBL-8-8-2" +class="td11"> <span +class="ecti-1000">left </span></td><td align="left" id="TBL-8-8-3" +class="td11"> + <!--l. 474--><p class="noindent">Fits the height of the page bounding box to + the window. </td> +</tr><tr + valign="baseline" id="TBL-8-9-"><td align="left" style="white-space:nowrap;" id="TBL-8-9-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-10-"><td align="left" style="white-space:nowrap;" id="TBL-8-10-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-11-"><td align="left" style="white-space:nowrap;" id="TBL-8-11-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-12-"><td align="left" style="white-space:nowrap;" id="TBL-8-12-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-8-13-"><td align="left" style="white-space:nowrap;" id="TBL-8-13-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-8-13-2" +class="td11"> </td><td align="left" id="TBL-8-13-3" +class="td11"></td></tr> + </table></div> +<!--l. 477--><p class="indent"> The <span +class="ectt-1000">pdfpagelayout </span>can be one of the following values. +<!--l. 479--><p class="noindent"> +<a + id="x1-10003r8"></a> <!--l. 480--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-9-1g"><col +id="TBL-9-1"><col +id="TBL-9-2"></colgroup> +<tr + valign="baseline" id="TBL-9-1-"><td align="left" style="white-space:nowrap;" id="TBL-9-1-1" +class="td11"> <span +class="ectt-1000">SinglePage </span></td><td align="left" id="TBL-9-1-2" +class="td11"> + <!--l. 480--><p class="noindent">Displays a single page; advancing flips the page </td> +</tr><tr + valign="baseline" id="TBL-9-2-"><td align="left" style="white-space:nowrap;" id="TBL-9-2-1" +class="td11"> <span +class="ectt-1000">OneColumn </span></td><td align="left" id="TBL-9-2-2" +class="td11"> + <!--l. 481--><p class="noindent">Displays the document in one column; continuous scrolling. </td> +</tr><tr + valign="baseline" id="TBL-9-3-"><td align="left" style="white-space:nowrap;" id="TBL-9-3-1" +class="td11"> <span +class="ectt-1000">TwoColumnLeft </span></td><td align="left" id="TBL-9-3-2" +class="td11"> + <!--l. 482--><p class="noindent">Displays the document in two columns, odd-numbered pages to + the left. </td> +</tr><tr + valign="baseline" id="TBL-9-4-"><td align="left" style="white-space:nowrap;" id="TBL-9-4-1" +class="td11"> <span +class="ectt-1000">TwoColumnRight </span></td><td align="left" id="TBL-9-4-2" +class="td11"> + <!--l. 483--><p class="noindent">Displays the document in two columns, odd-numbered pages to + the right. </td> +</tr><tr + valign="baseline" id="TBL-9-5-"><td align="left" style="white-space:nowrap;" id="TBL-9-5-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-9-6-"><td align="left" style="white-space:nowrap;" id="TBL-9-6-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-9-7-"><td align="left" style="white-space:nowrap;" id="TBL-9-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-9-8-"><td align="left" style="white-space:nowrap;" id="TBL-9-8-1" +class="td11"> </td><td align="left" id="TBL-9-8-2" +class="td11"></td></tr> + </table></div> +<!--l. 486--><p class="indent"> Finally, the <span +class="ectt-1000">pdfpagetransition </span>can be one of the following values, where <span +class="ecti-1000">/Di </span>stands for direction of +motion in degrees, generally in 90<sup ><span +class="cmsy-7"><span class="htf-cmbx">o</span></span></sup> steps, <span +class="ecti-1000">/Dm </span>is a horizontal (<span +class="ectt-1000">/H</span>) or vertical (<span +class="ectt-1000">/V</span>) dimension +(e.g. <span +class="ectt-1000">Blinds /Dm /V</span>), and <span +class="ecti-1000">/M </span>is for motion, either in (<span +class="ectt-1000">/I</span>) or out (<span +class="ectt-1000">/O</span>). +<!--l. 493--><p class="noindent"> +<a + id="x1-10004r9"></a> <!--l. 494--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-10-1g"><col +id="TBL-10-1"><col +id="TBL-10-2"><col +id="TBL-10-3"></colgroup> +<tr + valign="baseline" id="TBL-10-1-"><td align="left" style="white-space:nowrap;" id="TBL-10-1-1" +class="td11"> <span +class="ectt-1000">Blinds </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-1-2" +class="td11"> /Dm </td><td align="left" id="TBL-10-1-3" +class="td11"> + <!--l. 494--><p class="noindent">Multiple lines distributed evenly across the screen sweep + in the same direction to reveal the new page. </td> +</tr><tr + valign="baseline" id="TBL-10-2-"><td align="left" style="white-space:nowrap;" id="TBL-10-2-1" +class="td11"> <span +class="ectt-1000">Box </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-2-2" +class="td11"> /M </td><td align="left" id="TBL-10-2-3" +class="td11"> + <!--l. 496--><p class="noindent">A box sweeps in or out. </td> + + +</tr><tr + valign="baseline" id="TBL-10-3-"><td align="left" style="white-space:nowrap;" id="TBL-10-3-1" +class="td11"> <span +class="ectt-1000">Dissolve </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-3-2" +class="td11"> </td><td align="left" id="TBL-10-3-3" +class="td11"> + <!--l. 497--><p class="noindent">The page image dissolves in a piecemeal fashion to reveal + the new page. </td> +</tr><tr + valign="baseline" id="TBL-10-4-"><td align="left" style="white-space:nowrap;" id="TBL-10-4-1" +class="td11"> <span +class="ectt-1000">Glitter </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-4-2" +class="td11"> /Di </td><td align="left" id="TBL-10-4-3" +class="td11"> + <!--l. 498--><p class="noindent">Similar to Dissolve, except the effect sweeps across the + screen. </td> +</tr><tr + valign="baseline" id="TBL-10-5-"><td align="left" style="white-space:nowrap;" id="TBL-10-5-1" +class="td11"> <span +class="ectt-1000">Split </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-5-2" +class="td11"> /Dm /M </td><td align="left" id="TBL-10-5-3" +class="td11"> + <!--l. 499--><p class="noindent">Two lines sweep across the screen to reveal the new page. </td> +</tr><tr + valign="baseline" id="TBL-10-6-"><td align="left" style="white-space:nowrap;" id="TBL-10-6-1" +class="td11"> <span +class="ectt-1000">Wipe </span></td><td align="left" style="white-space:nowrap;" id="TBL-10-6-2" +class="td11"> /Di </td><td align="left" id="TBL-10-6-3" +class="td11"> + <!--l. 500--><p class="noindent">A single line sweeps across the screen to reveal the new + page. </td> +</tr><tr + valign="baseline" id="TBL-10-7-"><td align="left" style="white-space:nowrap;" id="TBL-10-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-10-8-"><td align="left" style="white-space:nowrap;" id="TBL-10-8-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-10-9-"><td align="left" style="white-space:nowrap;" id="TBL-10-9-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-10-10-"><td align="left" style="white-space:nowrap;" id="TBL-10-10-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-10-10-2" +class="td11"> </td><td align="left" id="TBL-10-10-3" +class="td11"></td></tr> + </table></div> +<!--l. 503--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">3.7 </span> <a + id="x1-110003.7"></a>Big alphabetical list</h4> +<!--l. 505--><p class="noindent">The following is a complete listing of available options for <span +class="ecss-1000">hyperref</span>, arranged alphabetically. +<!--l. 508--><p class="noindent"> +<a + id="x1-11001r10"></a> <!--l. 509--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-11-1g"><col +id="TBL-11-1"><col +id="TBL-11-2"><col +id="TBL-11-3"></colgroup> +<tr + valign="baseline" id="TBL-11-1-"><td align="left" style="white-space:nowrap;" id="TBL-11-1-1" +class="td11"> <span +class="ectt-1000">a4paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-1-2" +class="td11"> </td><td align="left" id="TBL-11-1-3" +class="td11"> + <!--l. 509--><p class="noindent">use A4 paper </td> +</tr><tr + valign="baseline" id="TBL-11-2-"><td align="left" style="white-space:nowrap;" id="TBL-11-2-1" +class="td11"> <span +class="ectt-1000">a5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-2-2" +class="td11"> </td><td align="left" id="TBL-11-2-3" +class="td11"> + <!--l. 510--><p class="noindent">use A5 paper </td> +</tr><tr + valign="baseline" id="TBL-11-3-"><td align="left" style="white-space:nowrap;" id="TBL-11-3-1" +class="td11"> <span +class="ectt-1000">anchorcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-3-2" +class="td11"> <span +class="ecti-1000">black </span></td><td align="left" id="TBL-11-3-3" +class="td11"> + <!--l. 511--><p class="noindent">set color of anchors </td> +</tr><tr + valign="baseline" id="TBL-11-4-"><td align="left" style="white-space:nowrap;" id="TBL-11-4-1" +class="td11"> <span +class="ectt-1000">b5paper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-4-2" +class="td11"> </td><td align="left" id="TBL-11-4-3" +class="td11"> + <!--l. 512--><p class="noindent">use B5 paper </td> +</tr><tr + valign="baseline" id="TBL-11-5-"><td align="left" style="white-space:nowrap;" id="TBL-11-5-1" +class="td11"> <span +class="ectt-1000">backref </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-5-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-5-3" +class="td11"> + <!--l. 513--><p class="noindent">do bibliographical back references </td> +</tr><tr + valign="baseline" id="TBL-11-6-"><td align="left" style="white-space:nowrap;" id="TBL-11-6-1" +class="td11"> <span +class="ectt-1000">baseurl </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-6-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-6-3" +class="td11"> + <!--l. 514--><p class="noindent">set base URL for document </td> +</tr><tr + valign="baseline" id="TBL-11-7-"><td align="left" style="white-space:nowrap;" id="TBL-11-7-1" +class="td11"> <span +class="ectt-1000">bookmarks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-7-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-7-3" +class="td11"> + <!--l. 515--><p class="noindent">make bookmarks </td> +</tr><tr + valign="baseline" id="TBL-11-8-"><td align="left" style="white-space:nowrap;" id="TBL-11-8-1" +class="td11"> <span +class="ectt-1000">bookmarksnumbered </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-8-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-8-3" +class="td11"> + <!--l. 516--><p class="noindent">put section numbers in bookmarks </td> +</tr><tr + valign="baseline" id="TBL-11-9-"><td align="left" style="white-space:nowrap;" id="TBL-11-9-1" +class="td11"> <span +class="ectt-1000">bookmarksopen </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-9-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-9-3" +class="td11"> + <!--l. 517--><p class="noindent">open up bookmark tree </td> +</tr><tr + valign="baseline" id="TBL-11-10-"><td align="left" style="white-space:nowrap;" id="TBL-11-10-1" +class="td11"> <span +class="ectt-1000">bookmarksopenlevel </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-10-2" +class="td11"> <span +class="ectt-1000">\maxdimen </span></td><td align="left" id="TBL-11-10-3" +class="td11"> + <!--l. 518--><p class="noindent">level to which bookmarks are open </td> +</tr><tr + valign="baseline" id="TBL-11-11-"><td align="left" style="white-space:nowrap;" id="TBL-11-11-1" +class="td11"> <span +class="ectt-1000">bookmarkstype </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-11-2" +class="td11"> <span +class="ecti-1000">toc </span></td><td align="left" id="TBL-11-11-3" +class="td11"> + <!--l. 519--><p class="noindent">to specify which ‘toc’ file to mimic </td> +</tr><tr + valign="baseline" id="TBL-11-12-"><td align="left" style="white-space:nowrap;" id="TBL-11-12-1" +class="td11"> <span +class="ectt-1000">breaklinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-12-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-12-3" +class="td11"> + <!--l. 520--><p class="noindent">allow links to break over lines </td> +</tr><tr + valign="baseline" id="TBL-11-13-"><td align="left" style="white-space:nowrap;" id="TBL-11-13-1" +class="td11"> <span +class="ectt-1000">citebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-13-2" +class="td11"> <span +class="ecti-1000">0 1 0 </span></td><td align="left" id="TBL-11-13-3" +class="td11"> + <!--l. 521--><p class="noindent">color of border around cites </td> + + +</tr><tr + valign="baseline" id="TBL-11-14-"><td align="left" style="white-space:nowrap;" id="TBL-11-14-1" +class="td11"> <span +class="ectt-1000">citecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-14-2" +class="td11"> <span +class="ecti-1000">green </span></td><td align="left" id="TBL-11-14-3" +class="td11"> + <!--l. 522--><p class="noindent">color of citation links </td> +</tr><tr + valign="baseline" id="TBL-11-15-"><td align="left" style="white-space:nowrap;" id="TBL-11-15-1" +class="td11"> <span +class="ectt-1000">colorlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-15-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-15-3" +class="td11"> + <!--l. 523--><p class="noindent">color links </td> +</tr><tr + valign="baseline" id="TBL-11-16-"><td align="left" style="white-space:nowrap;" id="TBL-11-16-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-16-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-16-3" +class="td11"> + <!--l. 524--><p class="noindent">(<span +class="ecss-1000">tex4ht</span>, <span +class="ecss-1000">dviwindo</span>) </td> +</tr><tr + valign="baseline" id="TBL-11-17-"><td align="left" style="white-space:nowrap;" id="TBL-11-17-1" +class="td11"> <span +class="ectt-1000">debug </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-17-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-17-3" +class="td11"> + <!--l. 525--><p class="noindent">provide details of anchors defined; same + as verbose </td> +</tr><tr + valign="baseline" id="TBL-11-18-"><td align="left" style="white-space:nowrap;" id="TBL-11-18-1" +class="td11"> <span +class="ectt-1000">draft </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-18-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-18-3" +class="td11"> + <!--l. 526--><p class="noindent">do not do any hyperlinking </td> +</tr><tr + valign="baseline" id="TBL-11-19-"><td align="left" style="white-space:nowrap;" id="TBL-11-19-1" +class="td11"> <span +class="ectt-1000">dvipdf </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-19-2" +class="td11"> </td><td align="left" id="TBL-11-19-3" +class="td11"> + <!--l. 527--><p class="noindent">use <span +class="ecss-1000">dvipdf </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-20-"><td align="left" style="white-space:nowrap;" id="TBL-11-20-1" +class="td11"> <span +class="ectt-1000">dvipdfm </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-20-2" +class="td11"> </td><td align="left" id="TBL-11-20-3" +class="td11"> + <!--l. 528--><p class="noindent">use <span +class="ecss-1000">dvipdfm </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-21-"><td align="left" style="white-space:nowrap;" id="TBL-11-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-21-2" +class="td11"> </td><td align="left" id="TBL-11-21-3" +class="td11"></td></tr> +<tr + valign="baseline" id="TBL-11-22-"><td align="left" style="white-space:nowrap;" id="TBL-11-22-1" +class="td11"> <span +class="ectt-1000">dvips </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-22-2" +class="td11"> </td><td align="left" id="TBL-11-22-3" +class="td11"> + <!--l. 529--><p class="noindent">use <span +class="ecss-1000">dvips </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-23-"><td align="left" style="white-space:nowrap;" id="TBL-11-23-1" +class="td11"> <span +class="ectt-1000">dvipsone </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-23-2" +class="td11"> </td><td align="left" id="TBL-11-23-3" +class="td11"> + <!--l. 530--><p class="noindent">use <span +class="ecss-1000">dvipsone </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-24-"><td align="left" style="white-space:nowrap;" id="TBL-11-24-1" +class="td11"> <span +class="ectt-1000">dviwindo </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-24-2" +class="td11"> </td><td align="left" id="TBL-11-24-3" +class="td11"> + <!--l. 531--><p class="noindent">use <span +class="ecss-1000">dviwindo </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-25-"><td align="left" style="white-space:nowrap;" id="TBL-11-25-1" +class="td11"> <span +class="ectt-1000">encap </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-25-2" +class="td11"> </td><td align="left" id="TBL-11-25-3" +class="td11"> + <!--l. 532--><p class="noindent">to set encap character for hyperindex </td> +</tr><tr + valign="baseline" id="TBL-11-26-"><td align="left" style="white-space:nowrap;" id="TBL-11-26-1" +class="td11"> <span +class="ectt-1000">executivepaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-26-2" +class="td11"> </td><td align="left" id="TBL-11-26-3" +class="td11"> + <!--l. 533--><p class="noindent">use executivepaper </td> +</tr><tr + valign="baseline" id="TBL-11-27-"><td align="left" style="white-space:nowrap;" id="TBL-11-27-1" +class="td11"> <span +class="ectt-1000">extension </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-27-2" +class="td11"> <span +class="ecti-1000">dvi </span></td><td align="left" id="TBL-11-27-3" +class="td11"> + <!--l. 534--><p class="noindent">suffix of linked files </td> +</tr><tr + valign="baseline" id="TBL-11-28-"><td align="left" style="white-space:nowrap;" id="TBL-11-28-1" +class="td11"> <span +class="ectt-1000">filebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-28-2" +class="td11"> <span +class="ecti-1000">0 .5 .5 </span></td><td align="left" id="TBL-11-28-3" +class="td11"> + <!--l. 535--><p class="noindent">color of border around file links </td> +</tr><tr + valign="baseline" id="TBL-11-29-"><td align="left" style="white-space:nowrap;" id="TBL-11-29-1" +class="td11"> <span +class="ectt-1000">filecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-29-2" +class="td11"> <span +class="ecti-1000">cyan </span></td><td align="left" id="TBL-11-29-3" +class="td11"> + <!--l. 536--><p class="noindent">color of file links </td> +</tr><tr + valign="baseline" id="TBL-11-30-"><td align="left" style="white-space:nowrap;" id="TBL-11-30-1" +class="td11"> <span +class="ectt-1000">final </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-30-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-30-3" +class="td11"> + <!--l. 537--><p class="noindent">opposite of option draft </td> +</tr><tr + valign="baseline" id="TBL-11-31-"><td align="left" style="white-space:nowrap;" id="TBL-11-31-1" +class="td11"> <span +class="ectt-1000">frenchlinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-31-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-31-3" +class="td11"> + <!--l. 538--><p class="noindent">use small caps instead of color for links </td> +</tr><tr + valign="baseline" id="TBL-11-32-"><td align="left" style="white-space:nowrap;" id="TBL-11-32-1" +class="td11"> <span +class="ectt-1000">hyperfigures </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-32-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-32-3" +class="td11"> + <!--l. 539--><p class="noindent">make figures hyper links </td> +</tr><tr + valign="baseline" id="TBL-11-33-"><td align="left" style="white-space:nowrap;" id="TBL-11-33-1" +class="td11"> <span +class="ectt-1000">hyperindex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-33-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-33-3" +class="td11"> + <!--l. 540--><p class="noindent">set up hyperlinked indices </td> +</tr><tr + valign="baseline" id="TBL-11-34-"><td align="left" style="white-space:nowrap;" id="TBL-11-34-1" +class="td11"> <span +class="ectt-1000">hypertex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-34-2" +class="td11"> </td><td align="left" id="TBL-11-34-3" +class="td11"> + <!--l. 541--><p class="noindent">use <span +class="ecss-1000">Hyper</span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span> backend </td> +</tr><tr + valign="baseline" id="TBL-11-35-"><td align="left" style="white-space:nowrap;" id="TBL-11-35-1" +class="td11"> <span +class="ectt-1000">hypertexnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-35-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-35-3" +class="td11"> + <!--l. 542--><p class="noindent">use guessable names for links </td> +</tr><tr + valign="baseline" id="TBL-11-36-"><td align="left" style="white-space:nowrap;" id="TBL-11-36-1" +class="td11"> <span +class="ectt-1000">implicit </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-36-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-36-3" +class="td11"> + <!--l. 543--><p class="noindent">redefine <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> internals </td> +</tr><tr + valign="baseline" id="TBL-11-37-"><td align="left" style="white-space:nowrap;" id="TBL-11-37-1" +class="td11"> <span +class="ectt-1000">latex2html </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-37-2" +class="td11"> </td><td align="left" id="TBL-11-37-3" +class="td11"> + <!--l. 544--><p class="noindent">use <span class="LATEX"><span +class="ecss-1000">L</span><span class="A"><span +class="ecss-1000">A</span></span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span></span><span +class="ecss-1000">2HTML </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-38-"><td align="left" style="white-space:nowrap;" id="TBL-11-38-1" +class="td11"> <span +class="ectt-1000">legalpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-38-2" +class="td11"> </td><td align="left" id="TBL-11-38-3" +class="td11"> + <!--l. 545--><p class="noindent">use legalpaper </td> +</tr><tr + valign="baseline" id="TBL-11-39-"><td align="left" style="white-space:nowrap;" id="TBL-11-39-1" +class="td11"> <span +class="ectt-1000">letterpaper </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-39-2" +class="td11"> </td><td align="left" id="TBL-11-39-3" +class="td11"> + <!--l. 546--><p class="noindent">use letterpaper </td> + + +</tr><tr + valign="baseline" id="TBL-11-40-"><td align="left" style="white-space:nowrap;" id="TBL-11-40-1" +class="td11"> <span +class="ectt-1000">linkbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-40-2" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-11-40-3" +class="td11"> + <!--l. 547--><p class="noindent">color of border around links </td> +</tr><tr + valign="baseline" id="TBL-11-41-"><td align="left" style="white-space:nowrap;" id="TBL-11-41-1" +class="td11"> <span +class="ectt-1000">linkcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-41-2" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-11-41-3" +class="td11"> + <!--l. 548--><p class="noindent">color of links </td> +</tr><tr + valign="baseline" id="TBL-11-42-"><td align="left" style="white-space:nowrap;" id="TBL-11-42-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-11-43-"><td align="left" style="white-space:nowrap;" id="TBL-11-43-1" +class="td11"> <span +class="ectt-1000">linktocpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-43-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-43-3" +class="td11"> + <!--l. 549--><p class="noindent">make page number, not text, be link on + TOC, LOF and LOT </td> +</tr><tr + valign="baseline" id="TBL-11-44-"><td align="left" style="white-space:nowrap;" id="TBL-11-44-1" +class="td11"> <span +class="ectt-1000">menubordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-44-2" +class="td11"> <span +class="ecti-1000">1 0 0 </span></td><td align="left" id="TBL-11-44-3" +class="td11"> + <!--l. 550--><p class="noindent">color of border around menu links </td> +</tr><tr + valign="baseline" id="TBL-11-45-"><td align="left" style="white-space:nowrap;" id="TBL-11-45-1" +class="td11"> <span +class="ectt-1000">menucolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-45-2" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-11-45-3" +class="td11"> + <!--l. 551--><p class="noindent">color for menu links </td> +</tr><tr + valign="baseline" id="TBL-11-46-"><td align="left" style="white-space:nowrap;" id="TBL-11-46-1" +class="td11"> <span +class="ectt-1000">nativepdf </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-46-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-46-3" +class="td11"> + <!--l. 552--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> +</tr><tr + valign="baseline" id="TBL-11-47-"><td align="left" style="white-space:nowrap;" id="TBL-11-47-1" +class="td11"> <span +class="ectt-1000">naturalnames </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-47-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-47-3" +class="td11"> + <!--l. 553--><p class="noindent">use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-computed names for links </td> +</tr><tr + valign="baseline" id="TBL-11-48-"><td align="left" style="white-space:nowrap;" id="TBL-11-48-1" +class="td11"> <span +class="ectt-1000">nesting </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-48-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-48-3" +class="td11"> + <!--l. 554--><p class="noindent">allow nesting of links </td> +</tr><tr + valign="baseline" id="TBL-11-49-"><td align="left" style="white-space:nowrap;" id="TBL-11-49-1" +class="td11"> <span +class="ectt-1000">pageanchor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-49-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-49-3" +class="td11"> + <!--l. 555--><p class="noindent">put an anchor on every page </td> +</tr><tr + valign="baseline" id="TBL-11-50-"><td align="left" style="white-space:nowrap;" id="TBL-11-50-1" +class="td11"> <span +class="ectt-1000">pagebackref </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-50-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-50-3" +class="td11"> + <!--l. 556--><p class="noindent">backreference by page number </td> +</tr><tr + valign="baseline" id="TBL-11-51-"><td align="left" style="white-space:nowrap;" id="TBL-11-51-1" +class="td11"> <span +class="ectt-1000">pagebordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-51-2" +class="td11"> <span +class="ecti-1000">1 1 0 </span></td><td align="left" id="TBL-11-51-3" +class="td11"> + <!--l. 557--><p class="noindent">color of border around page links </td> +</tr><tr + valign="baseline" id="TBL-11-52-"><td align="left" style="white-space:nowrap;" id="TBL-11-52-1" +class="td11"> <span +class="ectt-1000">pagecolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-52-2" +class="td11"> <span +class="ecti-1000">red </span></td><td align="left" id="TBL-11-52-3" +class="td11"> + <!--l. 558--><p class="noindent">color of page links </td> +</tr><tr + valign="baseline" id="TBL-11-53-"><td align="left" style="white-space:nowrap;" id="TBL-11-53-1" +class="td11"> <span +class="ectt-1000">pdfauthor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-53-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-53-3" +class="td11"> + <!--l. 559--><p class="noindent">text for PDF Author field </td> +</tr><tr + valign="baseline" id="TBL-11-54-"><td align="left" style="white-space:nowrap;" id="TBL-11-54-1" +class="td11"> <span +class="ectt-1000">pdfborder </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-54-2" +class="td11"> <span +class="ecti-1000">0 0 1 </span></td><td align="left" id="TBL-11-54-3" +class="td11"> + <!--l. 560--><p class="noindent">width of PDF link border </td> +</tr><tr + valign="baseline" id="TBL-11-55-"><td align="left" style="white-space:nowrap;" id="TBL-11-55-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-55-2" +class="td11"> <span +class="ecti-1000">0 0 0 </span></td><td align="left" id="TBL-11-55-3" +class="td11"> + <!--l. 561--><p class="noindent">(<span +class="ectt-1000">colorlinks)</span> </td> +</tr><tr + valign="baseline" id="TBL-11-56-"><td align="left" style="white-space:nowrap;" id="TBL-11-56-1" +class="td11"> <span +class="ectt-1000">pdfcenterwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-56-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-56-3" +class="td11"> + <!--l. 562--><p class="noindent">position the document window in the + center of the screen </td> +</tr><tr + valign="baseline" id="TBL-11-57-"><td align="left" style="white-space:nowrap;" id="TBL-11-57-1" +class="td11"> <span +class="ectt-1000">pdfcreator </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-57-2" +class="td11"> <span +class="ecti-1000">LaTeX with </span></td><td align="left" id="TBL-11-57-3" +class="td11"> + <!--l. 563--><p class="noindent">text for PDF Creator field </td> +</tr><tr + valign="baseline" id="TBL-11-58-"><td align="left" style="white-space:nowrap;" id="TBL-11-58-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-58-2" +class="td11"> <span +class="ecti-1000">hyperref </span></td><td align="left" id="TBL-11-58-3" +class="td11"> + <!--l. 565--><p class="noindent"> </td> +</tr><tr + valign="baseline" id="TBL-11-59-"><td align="left" style="white-space:nowrap;" id="TBL-11-59-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-59-2" +class="td11"> <span +class="ecti-1000">package </span></td><td align="left" id="TBL-11-59-3" +class="td11"> + <!--l. 566--><p class="noindent"> </td> +</tr><tr + valign="baseline" id="TBL-11-60-"><td align="left" style="white-space:nowrap;" id="TBL-11-60-1" +class="td11"> <span +class="ectt-1000">pdffitwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-60-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-60-3" +class="td11"> + <!--l. 566--><p class="noindent">resize document window to fit + document size </td> +</tr><tr + valign="baseline" id="TBL-11-61-"><td align="left" style="white-space:nowrap;" id="TBL-11-61-1" +class="td11"> <span +class="ectt-1000">pdfhighlight </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-61-2" +class="td11"> <span +class="ecti-1000">/I </span></td><td align="left" id="TBL-11-61-3" +class="td11"> + <!--l. 567--><p class="noindent">set highlighting of PDF links </td> +</tr><tr + valign="baseline" id="TBL-11-62-"><td align="left" style="white-space:nowrap;" id="TBL-11-62-1" +class="td11"> <span +class="ectt-1000">pdfkeywords </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-62-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-62-3" +class="td11"> + <!--l. 568--><p class="noindent">text for PDF Keywords field </td> +</tr><tr + valign="baseline" id="TBL-11-63-"><td align="left" style="white-space:nowrap;" id="TBL-11-63-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-11-64-"><td align="left" style="white-space:nowrap;" id="TBL-11-64-1" +class="td11"> <span +class="ectt-1000">pdfmark </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-64-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-64-3" +class="td11"> + <!--l. 569--><p class="noindent">an alias for <span +class="ecss-1000">dvips</span> </td> + + +</tr><tr + valign="baseline" id="TBL-11-65-"><td align="left" style="white-space:nowrap;" id="TBL-11-65-1" +class="td11"> <span +class="ectt-1000">pdfmenubar </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-65-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-65-3" +class="td11"> + <!--l. 570--><p class="noindent">make PDF viewer’s menu bar visible </td> +</tr><tr + valign="baseline" id="TBL-11-66-"><td align="left" style="white-space:nowrap;" id="TBL-11-66-1" +class="td11"> <span +class="ectt-1000">pdfnewwindow </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-66-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-66-3" +class="td11"> + <!--l. 571--><p class="noindent">make links that open another PDF </td> +</tr><tr + valign="baseline" id="TBL-11-67-"><td align="left" style="white-space:nowrap;" id="TBL-11-67-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-11-67-2" +class="td11"> </td><td align="left" id="TBL-11-67-3" +class="td11"> + <!--l. 572--><p class="noindent">file start a new window </td> +</tr><tr + valign="baseline" id="TBL-11-68-"><td align="left" style="white-space:nowrap;" id="TBL-11-68-1" +class="td11"> <span +class="ectt-1000">pdfpagelayout </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-68-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-68-3" +class="td11"> + <!--l. 573--><p class="noindent">set layout of PDF pages </td> +</tr><tr + valign="baseline" id="TBL-11-69-"><td align="left" style="white-space:nowrap;" id="TBL-11-69-1" +class="td11"> <span +class="ectt-1000">pdfpagemode </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-69-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-69-3" +class="td11"> + <!--l. 574--><p class="noindent">set default mode of PDF display </td> +</tr><tr + valign="baseline" id="TBL-11-70-"><td align="left" style="white-space:nowrap;" id="TBL-11-70-1" +class="td11"> <span +class="ectt-1000">pdfpagelabels </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-70-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-70-3" +class="td11"> + <!--l. 575--><p class="noindent">set PDF page labels </td> +</tr><tr + valign="baseline" id="TBL-11-71-"><td align="left" style="white-space:nowrap;" id="TBL-11-71-1" +class="td11"> <span +class="ectt-1000">pdfpagescrop </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-71-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-71-3" +class="td11"> + <!--l. 576--><p class="noindent">set crop size of PDF document </td> +</tr><tr + valign="baseline" id="TBL-11-72-"><td align="left" style="white-space:nowrap;" id="TBL-11-72-1" +class="td11"> <span +class="ectt-1000">pdfpagetransition </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-72-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-72-3" +class="td11"> + <!--l. 577--><p class="noindent">set PDF page transition style </td> +</tr><tr + valign="baseline" id="TBL-11-73-"><td align="left" style="white-space:nowrap;" id="TBL-11-73-1" +class="td11"> <span +class="ectt-1000">pdfproducer </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-73-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-73-3" +class="td11"> + <!--l. 578--><p class="noindent">text for PDF Producer field </td> +</tr><tr + valign="baseline" id="TBL-11-74-"><td align="left" style="white-space:nowrap;" id="TBL-11-74-1" +class="td11"> <span +class="ectt-1000">pdfstartpage </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-74-2" +class="td11"> <span +class="ecti-1000">1 </span></td><td align="left" id="TBL-11-74-3" +class="td11"> + <!--l. 579--><p class="noindent">page at which PDF document opens </td> +</tr><tr + valign="baseline" id="TBL-11-75-"><td align="left" style="white-space:nowrap;" id="TBL-11-75-1" +class="td11"> <span +class="ectt-1000">pdfstartview </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-75-2" +class="td11"> <span +class="ecti-1000">/Fit </span></td><td align="left" id="TBL-11-75-3" +class="td11"> + <!--l. 580--><p class="noindent">starting view of PDF document </td> +</tr><tr + valign="baseline" id="TBL-11-76-"><td align="left" style="white-space:nowrap;" id="TBL-11-76-1" +class="td11"> <span +class="ectt-1000">pdfsubject </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-76-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-76-3" +class="td11"> + <!--l. 581--><p class="noindent">text for PDF Subject field </td> +</tr><tr + valign="baseline" id="TBL-11-77-"><td align="left" style="white-space:nowrap;" id="TBL-11-77-1" +class="td11"> <span +class="ectt-1000">pdftex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-77-2" +class="td11"> </td><td align="left" id="TBL-11-77-3" +class="td11"> + <!--l. 582--><p class="noindent">use <span +class="ecss-1000">pdf</span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span> backend </td> +</tr><tr + valign="baseline" id="TBL-11-78-"><td align="left" style="white-space:nowrap;" id="TBL-11-78-1" +class="td11"> <span +class="ectt-1000">pdftitle </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-78-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-78-3" +class="td11"> + <!--l. 583--><p class="noindent">text for PDF Title field </td> +</tr><tr + valign="baseline" id="TBL-11-79-"><td align="left" style="white-space:nowrap;" id="TBL-11-79-1" +class="td11"> <span +class="ectt-1000">pdftoolbar </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-79-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-79-3" +class="td11"> + <!--l. 584--><p class="noindent">make PDF toolbar visible </td> +</tr><tr + valign="baseline" id="TBL-11-80-"><td align="left" style="white-space:nowrap;" id="TBL-11-80-1" +class="td11"> <span +class="ectt-1000">pdfview </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-80-2" +class="td11"> <span +class="ecti-1000">empty </span></td><td align="left" id="TBL-11-80-3" +class="td11"> + <!--l. 585--><p class="noindent">PDF ‘view’ when on link traversal </td> +</tr><tr + valign="baseline" id="TBL-11-81-"><td align="left" style="white-space:nowrap;" id="TBL-11-81-1" +class="td11"> <span +class="ectt-1000">pdfwindowui </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-81-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-81-3" +class="td11"> + <!--l. 586--><p class="noindent">make PDF user interface elements + visible </td> +</tr><tr + valign="baseline" id="TBL-11-82-"><td align="left" style="white-space:nowrap;" id="TBL-11-82-1" +class="td11"> <span +class="ectt-1000">plainpages </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-82-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-82-3" +class="td11"> + <!--l. 587--><p class="noindent">do page number anchors as plain arabic </td> +</tr><tr + valign="baseline" id="TBL-11-83-"><td align="left" style="white-space:nowrap;" id="TBL-11-83-1" +class="td11"> <span +class="ectt-1000">ps2pdf </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-83-2" +class="td11"> </td><td align="left" id="TBL-11-83-3" +class="td11"> + <!--l. 588--><p class="noindent">use <span +class="ecss-1000">ps2pdf </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-84-"><td align="left" style="white-space:nowrap;" id="TBL-11-84-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-11-85-"><td align="left" style="white-space:nowrap;" id="TBL-11-85-1" +class="td11"> <span +class="ectt-1000">raiselinks </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-85-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-85-3" +class="td11"> + <!--l. 589--><p class="noindent">raise up links (for <span +class="ecss-1000">Hyper</span><span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span> backend) </td> +</tr><tr + valign="baseline" id="TBL-11-86-"><td align="left" style="white-space:nowrap;" id="TBL-11-86-1" +class="td11"> <span +class="ectt-1000">runbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-86-2" +class="td11"> <span +class="ecti-1000">0 .7 .7 </span></td><td align="left" id="TBL-11-86-3" +class="td11"> + <!--l. 590--><p class="noindent">color of border around ‘run’ links </td> +</tr><tr + valign="baseline" id="TBL-11-87-"><td align="left" style="white-space:nowrap;" id="TBL-11-87-1" +class="td11"> <span +class="ectt-1000">setpagesize </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-87-2" +class="td11"> <span +class="ecti-1000">true </span></td><td align="left" id="TBL-11-87-3" +class="td11"> + <!--l. 591--><p class="noindent">set page size by special driver + commands </td> +</tr><tr + valign="baseline" id="TBL-11-88-"><td align="left" style="white-space:nowrap;" id="TBL-11-88-1" +class="td11"> <span +class="ectt-1000">tex4ht </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-88-2" +class="td11"> </td><td align="left" id="TBL-11-88-3" +class="td11"> + <!--l. 592--><p class="noindent">use <span class="TEX"><span +class="ecss-1000">T</span><span +class="E"><span +class="ecss-1000">E</span></span><span +class="ecss-1000">X</span></span><span +class="ecss-1000">4ht </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-89-"><td align="left" style="white-space:nowrap;" id="TBL-11-89-1" +class="td11"> <span +class="ectt-1000">textures </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-89-2" +class="td11"> </td><td align="left" id="TBL-11-89-3" +class="td11"> + <!--l. 593--><p class="noindent">use <span +class="ecss-1000">Textures </span>backend </td> + + +</tr><tr + valign="baseline" id="TBL-11-90-"><td align="left" style="white-space:nowrap;" id="TBL-11-90-1" +class="td11"> <span +class="ectt-1000">unicode </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-90-2" +class="td11"> </td><td align="left" id="TBL-11-90-3" +class="td11"> + <!--l. 594--><p class="noindent">Unicode encoded pdf strings </td> +</tr><tr + valign="baseline" id="TBL-11-91-"><td align="left" style="white-space:nowrap;" id="TBL-11-91-1" +class="td11"> <span +class="ectt-1000">urlbordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-91-2" +class="td11"> <span +class="ecti-1000">0 1 1 </span></td><td align="left" id="TBL-11-91-3" +class="td11"> + <!--l. 595--><p class="noindent">color of border around URL links </td> +</tr><tr + valign="baseline" id="TBL-11-92-"><td align="left" style="white-space:nowrap;" id="TBL-11-92-1" +class="td11"> <span +class="ectt-1000">urlcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-92-2" +class="td11"> <span +class="ecti-1000">magenta </span></td><td align="left" id="TBL-11-92-3" +class="td11"> + <!--l. 596--><p class="noindent">color of URL links </td> +</tr><tr + valign="baseline" id="TBL-11-93-"><td align="left" style="white-space:nowrap;" id="TBL-11-93-1" +class="td11"> <span +class="ectt-1000">verbose </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-93-2" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" id="TBL-11-93-3" +class="td11"> + <!--l. 597--><p class="noindent">be chatty </td> +</tr><tr + valign="baseline" id="TBL-11-94-"><td align="left" style="white-space:nowrap;" id="TBL-11-94-1" +class="td11"> <span +class="ectt-1000">vtex </span></td><td align="left" style="white-space:nowrap;" id="TBL-11-94-2" +class="td11"> </td><td align="left" id="TBL-11-94-3" +class="td11"> + <!--l. 598--><p class="noindent">use <span +class="ecss-1000">VTeX </span>backend </td> +</tr><tr + valign="baseline" id="TBL-11-95-"><td align="left" style="white-space:nowrap;" id="TBL-11-95-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-96-"><td align="left" style="white-space:nowrap;" id="TBL-11-96-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-97-"><td align="left" style="white-space:nowrap;" id="TBL-11-97-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-98-"><td align="left" style="white-space:nowrap;" id="TBL-11-98-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-11-99-"><td align="left" style="white-space:nowrap;" id="TBL-11-99-1" +class="td11"> </td> + </tr> + </table></div> +<!--l. 601--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-120004"></a>Additional user macros</h3> +<!--l. 603--><p class="noindent">If you need to make references to URLs, or write explicit links, the following low-level user macros are +provided: +<!--l. 606--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\href{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 610--><p class="noindent">The <span +class="ecti-1000">text </span>is made a hyperlink to the <span +class="ecti-1000">URL</span>; this must be a full URL (relative to the base URL, if that is +defined). The special characters # and ~ do <span +class="ecti-1000">not </span>need to be escaped in any way. +<!--l. 615--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\url{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}</span> </span> +<!--l. 619--><p class="noindent">Equivalent to <span +class="ectt-1000">\href</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">{</span></span></span><span +class="ecti-1000">URL</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}{</span></span></span><span +class="ecti-1000">URL</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}</span></span></span>. +<!--l. 622--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\nolinkurl{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}</span> </span> +<!--l. 626--><p class="noindent">Write <span +class="ecti-1000">URL </span>as plain text, without creating a hyperlink. +<!--l. 628--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperbaseurl{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}</span> </span> +<!--l. 632--><p class="noindent">A base <span +class="ecti-1000">URL </span>is established, which is prepended to other specified URLs, to make it easier to write +portable documents. +<!--l. 635--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperimage{</span><span +class="ecti-1000">imageURL</span><span +class="ectt-1000">}</span> </span> +<!--l. 639--><p class="noindent">The image referenced by the <span +class="ecti-1000">URL </span>is inserted. + +<!--l. 641--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperdef{</span><span +class="ecti-1000">category</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 645--><p class="noindent">A target area of the document (the <span +class="ecti-1000">text</span>) is marked, and given the name <span +class="ecti-1000">category.name</span> +<!--l. 648--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperref{</span><span +class="ecti-1000">URL</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">category</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 652--><p class="noindent"><span +class="ecti-1000">text </span>is made into a link to <span +class="ecti-1000">URL#category.name</span> +<!--l. 654--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hyperlink{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 657--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\hypertarget{</span><span +class="ecti-1000">name</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 661--><p class="noindent">A simple internal link is created with <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypertarget</span></span></span>, with two parameters of an anchor <span +class="ecti-1000">name</span>, and +anchor <span +class="ecti-1000">text</span>. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperlink</span></span></span> has two arguments, the name of a hypertext object defined somewhere by +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypertarget</span></span></span>, and the <span +class="ecti-1000">text </span>which be used as the link on the page. +<!--l. 667--><p class="indent"> Note that in HTML parlance, the <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperlink</span></span></span> command inserts a notional # in front of each link, +making it relative to the current testdocument; <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\href</span></span></span> expects a full URL. +<!--l. 672--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\autoref{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 676--><p class="indent"> This is a replacement for the usual <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ref</span></span></span> command that places a contextual label in front of the +reference. This gives your users a bigger target to click for hyperlinks (e.g. ‘section 2’ instead of merely +the number ‘2’). +<!--l. 681--><p class="indent"> The label is worked out from the context of the original <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\label</span></span></span> command by <span +class="ecss-1000">hyperref </span>by using the +macros listed below (shown with their default values). The macros can be redefined in documents using +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\renewcommand</span></span></span>; note that some of these macros are already defined in the standard document classes. +The mixture of lowercase and uppercase initial letters is deliberate and corresponds to the author’s +practice. +<!--l. 689--><p class="indent"> For each macro below, <span +class="ecss-1000">hyperref </span>checks <span +class="ectt-1000">\*autorefname </span>before <span +class="ectt-1000">\*name</span>. For instance, it looks for +<span +class="ectt-1000">\figureautorefname </span>before <span +class="ectt-1000">\figurename</span>. +<!--l. 693--><p class="noindent"> +<a + id="x1-12001r11"></a> <!--l. 694--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-12-1g"><col +id="TBL-12-1"><col +id="TBL-12-2"></colgroup> +<tr + valign="baseline" id="TBL-12-1-"><td align="left" style="white-space:nowrap;" id="TBL-12-1-1" +class="td11"> <span +class="ecti-1000">Macro </span></td><td align="left" id="TBL-12-1-2" +class="td11"> + <!--l. 694--><p class="noindent"><span +class="ecti-1000">Default</span> </td> +</tr><tr + valign="baseline" id="TBL-12-2-"><td align="left" style="white-space:nowrap;" id="TBL-12-2-1" +class="td11"> <span +class="ectt-1000">\figurename </span></td><td align="left" id="TBL-12-2-2" +class="td11"> + <!--l. 695--><p class="noindent">Figure </td> +</tr><tr + valign="baseline" id="TBL-12-3-"><td align="left" style="white-space:nowrap;" id="TBL-12-3-1" +class="td11"> <span +class="ectt-1000">\tablename </span></td><td align="left" id="TBL-12-3-2" +class="td11"> + <!--l. 696--><p class="noindent">Table </td> +</tr><tr + valign="baseline" id="TBL-12-4-"><td align="left" style="white-space:nowrap;" id="TBL-12-4-1" +class="td11"> <span +class="ectt-1000">\partname </span></td><td align="left" id="TBL-12-4-2" +class="td11"> + <!--l. 697--><p class="noindent">Part </td> +</tr><tr + valign="baseline" id="TBL-12-5-"><td align="left" style="white-space:nowrap;" id="TBL-12-5-1" +class="td11"> <span +class="ectt-1000">\appendixname </span></td><td align="left" id="TBL-12-5-2" +class="td11"> + <!--l. 698--><p class="noindent">Appendix </td> +</tr><tr + valign="baseline" id="TBL-12-6-"><td align="left" style="white-space:nowrap;" id="TBL-12-6-1" +class="td11"> <span +class="ectt-1000">\equationname </span></td><td align="left" id="TBL-12-6-2" +class="td11"> + <!--l. 699--><p class="noindent">Equation </td> + + +</tr><tr + valign="baseline" id="TBL-12-7-"><td align="left" style="white-space:nowrap;" id="TBL-12-7-1" +class="td11"> <span +class="ectt-1000">\Itemname </span></td><td align="left" id="TBL-12-7-2" +class="td11"> + <!--l. 700--><p class="noindent">item </td> +</tr><tr + valign="baseline" id="TBL-12-8-"><td align="left" style="white-space:nowrap;" id="TBL-12-8-1" +class="td11"> <span +class="ectt-1000">\Chaptername </span></td><td align="left" id="TBL-12-8-2" +class="td11"> + <!--l. 701--><p class="noindent">chapter </td> +</tr><tr + valign="baseline" id="TBL-12-9-"><td align="left" style="white-space:nowrap;" id="TBL-12-9-1" +class="td11"> <span +class="ectt-1000">\sectionname </span></td><td align="left" id="TBL-12-9-2" +class="td11"> + <!--l. 702--><p class="noindent">section </td> +</tr><tr + valign="baseline" id="TBL-12-10-"><td align="left" style="white-space:nowrap;" id="TBL-12-10-1" +class="td11"> <span +class="ectt-1000">\subsectionname </span></td><td align="left" id="TBL-12-10-2" +class="td11"> + <!--l. 703--><p class="noindent">subsection </td> +</tr><tr + valign="baseline" id="TBL-12-11-"><td align="left" style="white-space:nowrap;" id="TBL-12-11-1" +class="td11"> <span +class="ectt-1000">\subsubsectionname </span></td><td align="left" id="TBL-12-11-2" +class="td11"> + <!--l. 704--><p class="noindent">subsubsection </td> +</tr><tr + valign="baseline" id="TBL-12-12-"><td align="left" style="white-space:nowrap;" id="TBL-12-12-1" +class="td11"> <span +class="ectt-1000">\paragraphname </span></td><td align="left" id="TBL-12-12-2" +class="td11"> + <!--l. 705--><p class="noindent">paragraph </td> +</tr><tr + valign="baseline" id="TBL-12-13-"><td align="left" style="white-space:nowrap;" id="TBL-12-13-1" +class="td11"> <span +class="ectt-1000">\Hfootnotename </span></td><td align="left" id="TBL-12-13-2" +class="td11"> + <!--l. 706--><p class="noindent">footnote </td> +</tr><tr + valign="baseline" id="TBL-12-14-"><td align="left" style="white-space:nowrap;" id="TBL-12-14-1" +class="td11"> <span +class="ectt-1000">\AMSname </span></td><td align="left" id="TBL-12-14-2" +class="td11"> + <!--l. 707--><p class="noindent">Equation </td> +</tr><tr + valign="baseline" id="TBL-12-15-"><td align="left" style="white-space:nowrap;" id="TBL-12-15-1" +class="td11"> <span +class="ectt-1000">\theoremname </span></td><td align="left" id="TBL-12-15-2" +class="td11"> + <!--l. 708--><p class="noindent">Theorem </td> +</tr><tr + valign="baseline" id="TBL-12-16-"><td align="left" style="white-space:nowrap;" id="TBL-12-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-12-17-"><td align="left" style="white-space:nowrap;" id="TBL-12-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-12-18-"><td align="left" style="white-space:nowrap;" id="TBL-12-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-12-19-"><td align="left" style="white-space:nowrap;" id="TBL-12-19-1" +class="td11"> </td><td align="left" id="TBL-12-19-2" +class="td11"></td></tr> + </table></div> +<!--l. 711--><p class="indent"> For instances where you want a reference to use the correct counter, but not to create a link, there +are two starred forms: +<!--l. 714--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\ref*{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 718--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\pageref*{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 722--><p class="indent"> A typical use would be to write + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\hyperref[other]{that nice section (\ref*{other}) we read before} +</div> +</td></tr></table> +<!--l. 725--><p class="nopar"> +<!--l. 727--><p class="indent"> We want <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ref*{other}</span></span></span> to generate the correct number, but not to form a link, since we do this +ourselves with <span +class="ectt-1000">\hyperref</span>. +<!--l. 730--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\pdfstringdef{</span><span +class="ecti-1000">macroname</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">TEXstring</span><span +class="ectt-1000">}</span> </span> +<!--l. 734--><p class="indent"> <span +class="ectt-1000">\pdfstringdef </span>returns a macro containing the PDF string. (Currently this is done globally, but do +not rely on it.) All the following tasks, definitions and redefinitions are made in a group to keep them +local: +<!--l. 738--><p class="indent"> + <ul class="itemize1"> + <li class="itemize">Switching to PD1 or PU encoding + </li> + <li class="itemize">Defining the “octal sequence commands” (<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\345</span></span></span>): <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\edef\3{\string\3}</span></span></span> + </li> + <li class="itemize">Special glyphs of <span class="TEX">T<span +class="E">E</span>X</span>: <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\{</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\%</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\&</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\space</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\dots</span></span></span>, etc. + </li> + <li class="itemize">National glyphs (<span +class="ecss-1000">german.sty</span>, <span +class="ecss-1000">french.sty</span>, etc.) + </li> + <li class="itemize">Logos: <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\TeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\eTeX</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\MF</span></span></span>, etc. + </li> + <li class="itemize">Disabling commands that do not provide useful functionality in bookmarks: <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\label</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\index</span></span></span>, + <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\discretionary</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\def</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\let</span></span></span>, etc. + </li> + <li class="itemize"><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>’s font commands like <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textbf</span></span></span>, etc. + </li> + <li class="itemize">Support for <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\xspace</span></span></span> provided by the <span +class="ecss-1000">xspace </span>package</li></ul> +<!--l. 750--><p class="indent"> In addition, parentheses are protected to avoid the danger of unsafe unbalanced parentheses in +the PDF string. For further details, see Heiko Oberdiek’s Euro<span class="TEX">T<span +class="E">E</span>X</span> paper distributed with +<span +class="ecss-1000">hyperref</span>. +<!--l. 755--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-130004.1"></a>Replacement macros</h4> +<!--l. 757--><p class="noindent"><span +class="ecss-1000">hyperref </span>takes the text for bookmarks from the arguments of commands like <span +class="ectt-1000">\section</span>, which can +contain things like math, colors, or font changes, none of which will display in bookmarks as +is. + + +<!--l. 761--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\texorpdfstring{</span><span +class="ecti-1000">TEXstring</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">PDFstring</span><span +class="ectt-1000">}</span> </span> +<!--l. 765--><p class="indent"> For example, + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\section{Pythagoras: + <br />\texorpdfstring{$ a^2 + b^2 = c^2 $}{% + <br />a\texttwosuperior\ + b\texttwosuperior\ = + <br />c\texttwosuperior}} + <br />\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars} +</div> +</td></tr></table> +<!--l. 772--><p class="nopar"> +<!--l. 774--><p class="indent"> <span +class="ectt-1000">\pdfstringdef </span>executes the hook before it expands the string. Therefore, you can use this hook to +perform additional tasks or to disable additional commands. + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\expandafter\def\expandafter\pdfstringdefPreHook + <br />\expandafter{% + <br />\pdfstringdefPreHook + <br />\renewcommand{\mycommand}[1]{}% + <br />} +</div> +</td></tr></table> +<!--l. 784--><p class="nopar"> +<!--l. 786--><p class="indent"> However, for disabling commands, an easier way is via <span +class="ectt-1000">\pdfstringdefDisableCommands</span>, which adds +its argument to the definition of <span +class="ectt-1000">\pdfstringdefPreHook </span>(‘@’ can here be used as letter in command +names): + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\pdfstringdefDisableCommands{% + <br />\let~\textasciitilde + <br />\def\url{\pdfstringdefwarn\url}% + <br />\let\textcolor\@gobble + <br />} +</div> +</td></tr></table> +<!--l. 797--><p class="nopar"> +<!--l. 800--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">5 </span> <a + id="x1-140005"></a>Acrobat-specific behavior</h3> +<!--l. 801--><p class="noindent">If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided +in the appropriate drivers: +<!--l. 804--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\Acrobatmenu{</span><span +class="ecti-1000">menuoption</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 808--><p class="noindent">The <span +class="ecti-1000">text </span>is used to create a button which activates the appropriate <span +class="ecti-1000">menuoption</span>. The following table lists +the option names you can use—comparison of this with the menus in Acrobat Reader or Exchange will +show what they do. Obviously some are only appropriate to Exchange. +<!--l. 811--><p class="noindent"> +<a + id="x1-14001r12"></a> <!--l. 812--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-13-1g"><col +id="TBL-13-1"><col +id="TBL-13-2"></colgroup> +<tr + valign="baseline" id="TBL-13-1-"><td align="left" style="white-space:nowrap;" id="TBL-13-1-1" +class="td11"> File </td><td align="left" id="TBL-13-1-2" +class="td11"> + <!--l. 812--><p class="noindent">Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, + Print, PageSetup, Quit </td> +</tr><tr + valign="baseline" id="TBL-13-2-"><td align="left" style="white-space:nowrap;" id="TBL-13-2-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Import </td><td align="left" id="TBL-13-2-2" +class="td11"> + <!--l. 813--><p class="noindent">ImportImage, ImportNotes, AcroForm:ImportFDF </td> +</tr><tr + valign="baseline" id="TBL-13-3-"><td align="left" style="white-space:nowrap;" id="TBL-13-3-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Export </td><td align="left" id="TBL-13-3-2" +class="td11"> + <!--l. 814--><p class="noindent">ExportNotes, AcroForm:ExportFDF </td> +</tr><tr + valign="baseline" id="TBL-13-4-"><td align="left" style="white-space:nowrap;" id="TBL-13-4-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>DocumentInfo </td><td align="left" id="TBL-13-4-2" +class="td11"> + <!--l. 815--><p class="noindent">GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, + Weblink:Base, AutoIndex:DocInfo </td> +</tr><tr + valign="baseline" id="TBL-13-5-"><td align="left" style="white-space:nowrap;" id="TBL-13-5-1" +class="td11"> File<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Preferences </td><td align="left" id="TBL-13-5-2" +class="td11"> + <!--l. 816--><p class="noindent">GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, + AcroSearch:Preferences(Windows) or, + AcroSearch:Prefs(Mac), Cpt:Capture </td> +</tr><tr + valign="baseline" id="TBL-13-6-"><td align="left" style="white-space:nowrap;" id="TBL-13-6-1" +class="td11"> Edit </td><td align="left" id="TBL-13-6-2" +class="td11"> + <!--l. 818--><p class="noindent">Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, + TouchUp:TextAttributes, + TouchUp:FitTextToSelection, TouchUp:ShowLineMarkers, + TouchUp:ShowCaptureSuspects, TouchUp:FindSuspect, </td> +</tr><tr + valign="baseline" id="TBL-13-7-"><td align="left" style="white-space:nowrap;" id="TBL-13-7-1" +class="td11"> </td><td align="left" id="TBL-13-7-2" +class="td11"> + <!--l. 821--><p class="noindent">Properties </td> +</tr><tr + valign="baseline" id="TBL-13-8-"><td align="left" style="white-space:nowrap;" id="TBL-13-8-1" +class="td11"> Edit<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Fields </td><td align="left" id="TBL-13-8-2" +class="td11"> + <!--l. 822--><p class="noindent">AcroForm:Duplicate, AcroForm:TabOrder </td> + + +</tr><tr + valign="baseline" id="TBL-13-9-"><td align="left" style="white-space:nowrap;" id="TBL-13-9-1" +class="td11"> Document </td><td align="left" id="TBL-13-9-2" +class="td11"> + <!--l. 823--><p class="noindent">Cpt:CapturePages, + AcroForm:Actions, CropPages, RotatePages, InsertPages, + ExtractPages, ReplacePages, DeletePages, NewBookmark, + SetBookmarkDest, CreateAllThumbs, DeleteAllThumbs </td> +</tr><tr + valign="baseline" id="TBL-13-10-"><td align="left" style="white-space:nowrap;" id="TBL-13-10-1" +class="td11"> View </td><td align="left" id="TBL-13-10-2" +class="td11"> + <!--l. 826--><p class="noindent">ActualSize, FitVisible, FitWidth, FitPage, ZoomTo, + FullScreen, FirstPage, PrevPage, NextPage, LastPage, + GoToPage, GoBack, GoForward, SinglePage, OneColumn, + TwoColumns, ArticleThreads, PageOnly, ShowBookmarks, + ShowThumbs </td> +</tr><tr + valign="baseline" id="TBL-13-11-"><td align="left" style="white-space:nowrap;" id="TBL-13-11-1" +class="td11"> Tools </td><td align="left" id="TBL-13-11-2" +class="td11"> + <!--l. 829--><p class="noindent">Hand, ZoomIn, ZoomOut, SelectText, SelectGraphics, + Note, Link, Thread, AcroForm:Tool, + Acro_Movie:MoviePlayer, TouchUp:TextTool, Find, + FindAgain, FindNextNote, CreateNotesFile </td> +</tr><tr + valign="baseline" id="TBL-13-12-"><td align="left" style="white-space:nowrap;" id="TBL-13-12-1" +class="td11"> Tools<span +class="cmsy-10"><img +src="cmsy10-21.gif" alt="-->" class="10x-x-21" /></span>Search </td><td align="left" id="TBL-13-12-2" +class="td11"> + <!--l. 832--><p class="noindent">AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, + AcroSrch:Assist, AcroSrch:PrevDoc, AcroSrch:PrevHit, + AcroSrch:NextHit, AcroSrch:NextDoc </td> +</tr><tr + valign="baseline" id="TBL-13-13-"><td align="left" style="white-space:nowrap;" id="TBL-13-13-1" +class="td11"> Window </td><td align="left" id="TBL-13-13-2" +class="td11"> + <!--l. 834--><p class="noindent">ShowHideToolBar, ShowHideMenuBar, + ShowHideClipboard, Cascade, TileHorizontal, TileVertical, + CloseAll </td> +</tr><tr + valign="baseline" id="TBL-13-14-"><td align="left" style="white-space:nowrap;" id="TBL-13-14-1" +class="td11"> Help </td><td align="left" id="TBL-13-14-2" +class="td11"> + <!--l. 836--><p class="noindent">HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, + HelpCapture, HelpPDFWriter, HelpDistiller, HelpSearch, + HelpCatalog, HelpReader, Weblink:Home </td> +</tr><tr + valign="baseline" id="TBL-13-15-"><td align="left" style="white-space:nowrap;" id="TBL-13-15-1" +class="td11"> Help(Windows) </td><td align="left" id="TBL-13-15-2" +class="td11"> + <!--l. 838--><p class="noindent">About </td> +</tr><tr + valign="baseline" id="TBL-13-16-"><td align="left" style="white-space:nowrap;" id="TBL-13-16-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-13-17-"><td align="left" style="white-space:nowrap;" id="TBL-13-17-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-13-18-"><td align="left" style="white-space:nowrap;" id="TBL-13-18-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-13-19-"><td align="left" style="white-space:nowrap;" id="TBL-13-19-1" +class="td11"> </td><td align="left" id="TBL-13-19-2" +class="td11"></td></tr> + </table></div> +<!--l. 841--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-150006"></a>PDF and HTML forms</h3> +<!--l. 842--><p class="noindent">You must put your fields inside a <span +class="ectt-1000">Form </span>environment (only one per file). +<!--l. 844--><p class="indent"> There are six macros to prepare fields: +<!--l. 846--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\TextField[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 850--><p class="noindent"> + + +<span class="fbox"> <span +class="ectt-1000">\CheckBox[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 854--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\ChoiceMenu[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">choices</span><span +class="ectt-1000">}</span> </span> +<!--l. 858--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\PushButton[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 862--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\Submit[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 866--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\Reset[</span><span +class="ecti-1000">parameters</span><span +class="ectt-1000">]{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}</span> </span> +<!--l. 870--><p class="indent"> The way forms and their labels are laid out is determined by: +<!--l. 871--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\LayoutTextField{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">field</span><span +class="ectt-1000">}</span> </span> +<!--l. 875--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\LayoutChoiceField{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">field</span><span +class="ectt-1000">}</span> </span> +<!--l. 879--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\LayoutCheckboxField{</span><span +class="ecti-1000">label</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">field</span><span +class="ectt-1000">}</span> </span> +<!--l. 883--><p class="indent"> These macros default to #1 #2 +<!--l. 885--><p class="indent"> What is actually shown in as the field is determined by: +<!--l. 886--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeRadioField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 890--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeCheckField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 893--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeTextField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 896--><p class="noindent"> + + +<span class="fbox"> <span +class="ectt-1000">\MakeChoiceField{</span><span +class="ecti-1000">width</span><span +class="ectt-1000">}{</span><span +class="ecti-1000">height</span><span +class="ectt-1000">}</span> </span> +<!--l. 900--><p class="noindent"> +<span class="fbox"> <span +class="ectt-1000">\MakeButtonField{</span><span +class="ecti-1000">text</span><span +class="ectt-1000">}</span> </span> +<!--l. 904--><p class="indent"> These macros default to <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\vbox</span><span +class="ectt-1000"> to</span><span +class="ectt-1000"> #2{\hbox</span><span +class="ectt-1000"> to</span><span +class="ectt-1000"> #1{\hfill}\vfill}</span></span></span>, except the last, which defaults +to #1; it is used for buttons, and the special <span +class="ectt-1000">\Submit </span>and <span +class="ectt-1000">\Reset </span>macros. +<!--l. 908--><p class="indent"> You may also want to redefine the following macros: + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\def\DefaultHeightofSubmit{12pt} + <br />\def\DefaultWidthofSubmit{2cm} + <br />\def\DefaultHeightofReset{12pt} + <br />\def\DefaultWidthofReset{2cm} + <br />\def\DefaultHeightofCheckBox{0.8\baselineskip} + <br />\def\DefaultWidthofCheckBox{0.8\baselineskip} + <br />\def\DefaultHeightofChoiceMenu{0.8\baselineskip} + <br />\def\DefaultWidthofChoiceMenu{0.8\baselineskip} + <br />\def\DefaultHeightofText{\baselineskip} + <br />\def\DefaultWidthofText{3cm} +</div> +</td></tr></table> +<!--l. 920--><p class="nopar"> +<!--l. 922--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a + id="x1-160006.1"></a>Forms environment parameters</h4> +<!--l. 924--><p class="noindent"> +<a + id="x1-16001r13"></a> <!--l. 925--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-14-1g"><col +id="TBL-14-1"><col +id="TBL-14-2"><col +id="TBL-14-3"></colgroup> +<tr + valign="baseline" id="TBL-14-1-"><td align="left" style="white-space:nowrap;" id="TBL-14-1-1" +class="td11"> <span +class="ectt-1000">action </span></td><td align="left" style="white-space:nowrap;" id="TBL-14-1-2" +class="td11"> <span +class="ecti-1000">URL </span></td><td align="left" id="TBL-14-1-3" +class="td11"> + <!--l. 925--><p class="noindent">The URL that will receive the form data if a <span +class="ecss-1000">Submit </span>button + is included in the form </td> +</tr><tr + valign="baseline" id="TBL-14-2-"><td align="left" style="white-space:nowrap;" id="TBL-14-2-1" +class="td11"> <span +class="ectt-1000">encoding </span></td><td align="left" style="white-space:nowrap;" id="TBL-14-2-2" +class="td11"> <span +class="ecti-1000">name </span></td><td align="left" id="TBL-14-2-3" +class="td11"> + <!--l. 926--><p class="noindent">The encoding for the string set to the URL; FDF-encoding + is usual, and <span +class="ectt-1000">html </span>is the only valid value </td> +</tr><tr + valign="baseline" id="TBL-14-3-"><td align="left" style="white-space:nowrap;" id="TBL-14-3-1" +class="td11"> <span +class="ectt-1000">method </span></td><td align="left" style="white-space:nowrap;" id="TBL-14-3-2" +class="td11"> <span +class="ecti-1000">name </span></td><td align="left" id="TBL-14-3-3" +class="td11"> + <!--l. 928--><p class="noindent">Used only when generating HTML; values can be <span +class="ectt-1000">post </span>or + <span +class="ectt-1000">get</span> </td> +</tr><tr + valign="baseline" id="TBL-14-4-"><td align="left" style="white-space:nowrap;" id="TBL-14-4-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-5-"><td align="left" style="white-space:nowrap;" id="TBL-14-5-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-6-"><td align="left" style="white-space:nowrap;" id="TBL-14-6-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-7-"><td align="left" style="white-space:nowrap;" id="TBL-14-7-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-14-8-"><td align="left" style="white-space:nowrap;" id="TBL-14-8-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-14-8-2" +class="td11"> </td><td align="left" id="TBL-14-8-3" +class="td11"></td></tr> + </table></div> +<!--l. 931--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a + id="x1-170006.2"></a>Forms optional parameters</h4> +<!--l. 932--><p class="noindent">Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. <span +class="ectt-1000">color=0 0</span> +<span +class="ectt-1000">0.5</span>) +<!--l. 935--><p class="noindent"> +<a + id="x1-17001r14"></a> <!--l. 936--><div class="longtable"><table class="longtable" +cellspacing="0" cellpadding="0" +frame="void" ><colgroup id="TBL-15-1g"><col +id="TBL-15-1"><col +id="TBL-15-2"><col +id="TBL-15-3"><col +id="TBL-15-4"></colgroup> +<tr + valign="baseline" id="TBL-15-1-"><td align="left" style="white-space:nowrap;" id="TBL-15-1-1" +class="td11"> <span +class="ectt-1000">accesskey </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-1-2" +class="td11"> key </td><td align="left" style="white-space:nowrap;" id="TBL-15-1-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-1-4" +class="td11"> (as per HTML) </td> +</tr><tr + valign="baseline" id="TBL-15-2-"><td align="left" style="white-space:nowrap;" id="TBL-15-2-1" +class="td11"> <span +class="ectt-1000">align </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-2-2" +class="td11"> number </td><td align="left" style="white-space:nowrap;" id="TBL-15-2-3" +class="td11"> <span +class="ecti-1000">0 </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-2-4" +class="td11"> alignment within text field; 0 is left-aligned, </td> +</tr><tr + valign="baseline" id="TBL-15-3-"><td align="left" style="white-space:nowrap;" id="TBL-15-3-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-3-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-3-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-3-4" +class="td11"> 1 is centered, 2 is right-aligned. </td> + + +</tr><tr + valign="baseline" id="TBL-15-4-"><td align="left" style="white-space:nowrap;" id="TBL-15-4-1" +class="td11"> <span +class="ectt-1000">backgroundcolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-4-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-4-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-4-4" +class="td11"> color of box </td> +</tr><tr + valign="baseline" id="TBL-15-5-"><td align="left" style="white-space:nowrap;" id="TBL-15-5-1" +class="td11"> <span +class="ectt-1000">bordercolor </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-5-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-5-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-5-4" +class="td11"> color of border </td> +</tr><tr + valign="baseline" id="TBL-15-6-"><td align="left" style="white-space:nowrap;" id="TBL-15-6-1" +class="td11"> <span +class="ectt-1000">bordersep </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-6-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-6-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-6-4" +class="td11"> box border gap </td> +</tr><tr + valign="baseline" id="TBL-15-7-"><td align="left" style="white-space:nowrap;" id="TBL-15-7-1" +class="td11"> <span +class="ectt-1000">borderwidth </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-7-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-7-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-7-4" +class="td11"> width of box border </td> +</tr><tr + valign="baseline" id="TBL-15-8-"><td align="left" style="white-space:nowrap;" id="TBL-15-8-1" +class="td11"> <span +class="ectt-1000">calculate </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-8-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-8-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-8-4" +class="td11"> JavaScript code to calculate the value of the field </td> +</tr><tr + valign="baseline" id="TBL-15-9-"><td align="left" style="white-space:nowrap;" id="TBL-15-9-1" +class="td11"> <span +class="ectt-1000">charsize </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-9-2" +class="td11"> dimen </td><td align="left" style="white-space:nowrap;" id="TBL-15-9-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-9-4" +class="td11"> font size of field text </td> +</tr><tr + valign="baseline" id="TBL-15-10-"><td align="left" style="white-space:nowrap;" id="TBL-15-10-1" +class="td11"> <span +class="ectt-1000">checked </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-10-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-10-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-10-4" +class="td11"> whether option selected by default </td> +</tr><tr + valign="baseline" id="TBL-15-11-"><td align="left" style="white-space:nowrap;" id="TBL-15-11-1" +class="td11"> <span +class="ectt-1000">color </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-11-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-11-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-11-4" +class="td11"> color of text in box </td> +</tr><tr + valign="baseline" id="TBL-15-12-"><td align="left" style="white-space:nowrap;" id="TBL-15-12-1" +class="td11"> <span +class="ectt-1000">combo </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-12-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-12-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-12-4" +class="td11"> choice list is ‘combo’ style </td> +</tr><tr + valign="baseline" id="TBL-15-13-"><td align="left" style="white-space:nowrap;" id="TBL-15-13-1" +class="td11"> <span +class="ectt-1000">default </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-13-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-13-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-13-4" +class="td11"> default value </td> +</tr><tr + valign="baseline" id="TBL-15-14-"><td align="left" style="white-space:nowrap;" id="TBL-15-14-1" +class="td11"> <span +class="ectt-1000">disabled </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-14-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-14-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-14-4" +class="td11"> field disabled </td> +</tr><tr + valign="baseline" id="TBL-15-15-"><td align="left" style="white-space:nowrap;" id="TBL-15-15-1" +class="td11"> <span +class="ectt-1000">format </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-15-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-15-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-15-4" +class="td11"> JavaScript code to format the field </td> +</tr><tr + valign="baseline" id="TBL-15-16-"><td align="left" style="white-space:nowrap;" id="TBL-15-16-1" +class="td11"> <span +class="ectt-1000">height </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-16-2" +class="td11"> dimen </td><td align="left" style="white-space:nowrap;" id="TBL-15-16-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-16-4" +class="td11"> height of field box </td> +</tr><tr + valign="baseline" id="TBL-15-17-"><td align="left" style="white-space:nowrap;" id="TBL-15-17-1" +class="td11"> <span +class="ectt-1000">hidden </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-17-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-17-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-17-4" +class="td11"> field hidden </td> +</tr><tr + valign="baseline" id="TBL-15-18-"><td align="left" style="white-space:nowrap;" id="TBL-15-18-1" +class="td11"> <span +class="ectt-1000">ketstroke </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-18-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-18-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-18-4" +class="td11"> JavaScript code to control the keystrokes on entry </td> +</tr><tr + valign="baseline" id="TBL-15-19-"><td align="left" style="white-space:nowrap;" id="TBL-15-19-1" +class="td11"> <span +class="ectt-1000">maxlen </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-19-2" +class="td11"> number </td><td align="left" style="white-space:nowrap;" id="TBL-15-19-3" +class="td11"> <span +class="ecti-1000">0 </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-19-4" +class="td11"> number of characters allowed in text field </td> +</tr><tr + valign="baseline" id="TBL-15-20-"><td align="left" style="white-space:nowrap;" id="TBL-15-20-1" +class="td11"> <span +class="ectt-1000">menulength </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-20-2" +class="td11"> number </td><td align="left" style="white-space:nowrap;" id="TBL-15-20-3" +class="td11"> <span +class="ecti-1000">4 </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-20-4" +class="td11"> number of elements shown in list </td> +</tr><tr + valign="baseline" id="TBL-15-21-"><td align="left" style="white-space:nowrap;" id="TBL-15-21-1" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-21-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-21-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-21-4" +class="td11"></td></tr> +<tr + valign="baseline" id="TBL-15-22-"><td align="left" style="white-space:nowrap;" id="TBL-15-22-1" +class="td11"> <span +class="ectt-1000">multiline </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-22-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-22-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-22-4" +class="td11"> whether text box is multiline </td> +</tr><tr + valign="baseline" id="TBL-15-23-"><td align="left" style="white-space:nowrap;" id="TBL-15-23-1" +class="td11"> <span +class="ectt-1000">name </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-23-2" +class="td11"> name </td><td align="left" style="white-space:nowrap;" id="TBL-15-23-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-23-4" +class="td11"> name of field (defaults to label) </td> +</tr><tr + valign="baseline" id="TBL-15-24-"><td align="left" style="white-space:nowrap;" id="TBL-15-24-1" +class="td11"> <span +class="ectt-1000">onblur </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-24-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-24-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-24-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-25-"><td align="left" style="white-space:nowrap;" id="TBL-15-25-1" +class="td11"> <span +class="ectt-1000">onchange </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-25-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-25-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-25-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-26-"><td align="left" style="white-space:nowrap;" id="TBL-15-26-1" +class="td11"> <span +class="ectt-1000">onclick </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-26-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-26-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-26-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-27-"><td align="left" style="white-space:nowrap;" id="TBL-15-27-1" +class="td11"> <span +class="ectt-1000">ondblclick </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-27-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-27-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-27-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-28-"><td align="left" style="white-space:nowrap;" id="TBL-15-28-1" +class="td11"> <span +class="ectt-1000">onfocus </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-28-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-28-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-28-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-29-"><td align="left" style="white-space:nowrap;" id="TBL-15-29-1" +class="td11"> <span +class="ectt-1000">onkeydown </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-29-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-29-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-29-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-30-"><td align="left" style="white-space:nowrap;" id="TBL-15-30-1" +class="td11"> <span +class="ectt-1000">onkeypress </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-30-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-30-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-30-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-31-"><td align="left" style="white-space:nowrap;" id="TBL-15-31-1" +class="td11"> <span +class="ectt-1000">onkeyup </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-31-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-31-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-31-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-32-"><td align="left" style="white-space:nowrap;" id="TBL-15-32-1" +class="td11"> <span +class="ectt-1000">onmousedown </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-32-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-32-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-32-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-33-"><td align="left" style="white-space:nowrap;" id="TBL-15-33-1" +class="td11"> <span +class="ectt-1000">onmousemove </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-33-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-33-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-33-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-34-"><td align="left" style="white-space:nowrap;" id="TBL-15-34-1" +class="td11"> <span +class="ectt-1000">onmouseout </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-34-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-34-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-34-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-35-"><td align="left" style="white-space:nowrap;" id="TBL-15-35-1" +class="td11"> <span +class="ectt-1000">onmouseover </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-35-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-35-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-35-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-36-"><td align="left" style="white-space:nowrap;" id="TBL-15-36-1" +class="td11"> <span +class="ectt-1000">onmouseup </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-36-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-36-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-36-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-37-"><td align="left" style="white-space:nowrap;" id="TBL-15-37-1" +class="td11"> <span +class="ectt-1000">onselect </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-37-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-37-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-37-4" +class="td11"> JavaScript code </td> +</tr><tr + valign="baseline" id="TBL-15-38-"><td align="left" style="white-space:nowrap;" id="TBL-15-38-1" +class="td11"> <span +class="ectt-1000">password </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-38-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-38-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-38-4" +class="td11"> text field is ‘password’ style </td> +</tr><tr + valign="baseline" id="TBL-15-39-"><td align="left" style="white-space:nowrap;" id="TBL-15-39-1" +class="td11"> <span +class="ectt-1000">popdown </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-39-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-39-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-39-4" +class="td11"> choice list is ‘popdown’ style </td> +</tr><tr + valign="baseline" id="TBL-15-40-"><td align="left" style="white-space:nowrap;" id="TBL-15-40-1" +class="td11"> <span +class="ectt-1000">radio </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-40-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-40-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-40-4" +class="td11"> choice list is ‘radio’ style </td> +</tr><tr + valign="baseline" id="TBL-15-41-"><td align="left" style="white-space:nowrap;" id="TBL-15-41-1" +class="td11"> <span +class="ectt-1000">readonly </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-41-2" +class="td11"> boolean </td><td align="left" style="white-space:nowrap;" id="TBL-15-41-3" +class="td11"> <span +class="ecti-1000">false </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-41-4" +class="td11"> field is readonly </td> +</tr><tr + valign="baseline" id="TBL-15-42-"><td align="left" style="white-space:nowrap;" id="TBL-15-42-1" +class="td11"> </td> + </tr> +<tr + valign="baseline" id="TBL-15-43-"><td align="left" style="white-space:nowrap;" id="TBL-15-43-1" +class="td11"> <span +class="ectt-1000">tabkey </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-43-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-43-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-43-4" +class="td11"> (as per HTML) </td> +</tr><tr + valign="baseline" id="TBL-15-44-"><td align="left" style="white-space:nowrap;" id="TBL-15-44-1" +class="td11"> <span +class="ectt-1000">validate </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-44-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-44-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-44-4" +class="td11"> JavaScript code to validate the entry </td> +</tr><tr + valign="baseline" id="TBL-15-45-"><td align="left" style="white-space:nowrap;" id="TBL-15-45-1" +class="td11"> <span +class="ectt-1000">value </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-45-2" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-45-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-45-4" +class="td11"> initial value </td> +</tr><tr + valign="baseline" id="TBL-15-46-"><td align="left" style="white-space:nowrap;" id="TBL-15-46-1" +class="td11"> <span +class="ectt-1000">width </span></td><td align="left" style="white-space:nowrap;" id="TBL-15-46-2" +class="td11"> dimen </td><td align="left" style="white-space:nowrap;" id="TBL-15-46-3" +class="td11"> </td><td align="left" style="white-space:nowrap;" id="TBL-15-46-4" +class="td11"> width of field box </td> +</tr><tr + valign="baseline" id="TBL-15-47-"><td align="left" style="white-space:nowrap;" id="TBL-15-47-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-15-48-"><td align="left" style="white-space:nowrap;" id="TBL-15-48-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-15-49-"><td align="left" style="white-space:nowrap;" id="TBL-15-49-1" +class="td11"> </td> +</tr><tr + valign="baseline" id="TBL-15-50-"><td align="left" style="white-space:nowrap;" id="TBL-15-50-1" +class="td11"> </td> + </tr> + </table></div> + + +<!--l. 982--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-180007"></a>Defining a new driver</h3> +<!--l. 983--><p class="noindent">A hyperref driver has to provide definitions for eight macros: +<!--l. 986--><p class="noindent">1. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@anchor</span></span></span> +<!--l. 988--><p class="noindent">2. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@link</span></span></span> +<!--l. 990--><p class="noindent">3. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkfile</span></span></span> +<!--l. 992--><p class="noindent">4. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkurl</span></span></span> +<!--l. 994--><p class="noindent">5. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@anchorstart</span></span></span> +<!--l. 996--><p class="noindent">6. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@anchorend</span></span></span> +<!--l. 998--><p class="noindent">7. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkstart</span></span></span> +<!--l. 1000--><p class="noindent">8. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyper@linkend</span></span></span> +<!--l. 1003--><p class="indent"> The draft option defines the macros as follows + + + <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><div class="verbatim"> +\let\hyper@@anchor\@gobble + <br />\gdef\hyper@link##1##2##3{##3}% + <br />\def\hyper@linkurl##1##2{##1}% + <br />\def\hyper@linkfile##1##2##3{##1}% + <br />\let\hyper@anchorstart\@gobble + <br />\let\hyper@anchorend\@empty + <br />\let\hyper@linkstart\@gobbletwo + <br />\let\hyper@linkend\@empty +</div> +</td></tr></table> +<!--l. 1013--><p class="nopar"> +<!--l. 1015--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-190008"></a>Special support for other packages</h3> +<!--l. 1017--><p class="noindent"><span +class="ecss-1000">hyperref </span>aims to cooperate with other packages, but there are several possible sources for conflict, such +as +<!--l. 1020--><p class="indent"> + <ul class="itemize1"> + <li class="itemize">Packages that manipulate the bibliographic mechanism. Peter William’s <span +class="ecss-1000">harvard </span>package is + supported. However, the recommended package is Patrick Daly’s <span +class="ecss-1000">natbib </span>package that has + specific <span +class="ecss-1000">hyperref </span>hooks to allow reliable interaction. This package covers a very wide variety + of layouts and citation styles, all of which work with <span +class="ecss-1000">hyperref</span>. + </li> + <li class="itemize">Packages that typeset the contents of the <span +class="ectt-1000">\label </span>and <span +class="ectt-1000">\ref </span>macros, such as <span +class="ecss-1000">showkeys</span>. Since + the <span +class="ecss-1000">hyperref </span>package redefines these commands, you must set <span +class="ectt-1000">implicit=false </span>for these + packages to work. + </li> + <li class="itemize">Packages that do anything serious with the index.</li></ul> +<!--l. 1037--><p class="indent"> The <span +class="ecss-1000">hyperref </span>package is distributed with variants on two useful packages designed to work especially +well with it. These are <span +class="ecss-1000">xr </span>and <span +class="ecss-1000">minitoc</span>, which support crossdocument links using <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>’s normal +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\label/\ref</span></span></span> mechanisms and per-chapter tables of contents, respectively. +<!--l. 1043--><p class="noindent"> + <h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-200009"></a>History and acknowledgments</h3> +<!--l. 1045--><p class="noindent">The original authors of <span +class="ecss-1000">hyperbasics.tex </span>and <span +class="ecss-1000">hypertex.sty</span>, from which this package +descends, are Tanmoy Bhattacharya (<span +class="ectt-1000">tanmoy@qcd.lanl.gov</span>) and Thorsten Ohl +(<span +class="ectt-1000">thorsten.ohl@physik.th-darmstadt.de</span>). <span +class="ecss-1000">hyperref </span>started as a simple port of their work to +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>2<span +class="cmmi-10"><img +src="cmmi10-22.gif" alt="e" class="10x-x-22" /></span> standards, but eventually I rewrote nearly everything, because I didn’t understand a lot of +the original, and was only interested in getting it to work with <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>. I would like to thank Arthur +Smith, Tanmoy Bhattacharya, Mark Doyle, Paul Ginsparg, David Carlisle, T. V. Raman and Leslie +Lamport for comments, requests, thoughts and code to get the package into its first useable state. +Various other people are mentioned at the point in the source where I had to change the code in later +versions because of problems they found. + +<!--l. 1059--><p class="indent"> Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has made the +package more robust. The days spent on Rev<span class="TEX">T<span +class="E">E</span>X</span> are entirely due to him! The investigations of Bill +Moss (<span +class="ectt-1000">bmoss@math.clemson.edu</span>) into the later versions including native PDF support uncovered a good +many bugs, and his testing is appreciated. Hans Hagen (<span +class="ectt-1000">pragma@pi.net</span>) provided a lot of insight into +PDF. +<!--l. 1067--><p class="indent"> Berthold Horn provided help, encouragement and sponsorship for the <span +class="ecss-1000">dvipsone </span>and <span +class="ecss-1000">dviwindo </span>drivers. +Sergey Lesenko provided the changes needed for <span +class="ecss-1000">dvipdf</span>, and Hàn Thê' Thành supplied all +the information needed for <span +class="ecss-1000">pdftex</span>. Patrick Daly kindly updated his <span +class="ecss-1000">natbib </span>package to allow +easy integration with <span +class="ecss-1000">hyperref</span>. Michael Mehlich’s <span +class="ecss-1000">hyper </span>package (developed in parallel with +<span +class="ecss-1000">hyperref</span>) showed me solutions for some problems. Hopefully the two packages will combine one +day. +<!--l. 1076--><p class="indent"> The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and +ideas; Thomas Merz, whose book <span +class="ecti-1000">Web Publishing with Acrobat/PDF </span>provided crucial insights; +D. P. Story, whose detailed article about pdfmarks and forms solved many practical problems; and Hans +Hagen, who explained how to do it in <span +class="ecss-1000">pdftex</span>. +<!--l. 1082--><p class="indent"> Steve Dandy recreated the manual source in July 2003 after it had been lost. +<!--l. 1085--><p class="indent"> Especial extra thanks to David Carlisle for the <span +class="ecss-1000">backref </span>module, the ps2pdf and dviwindo support, +frequent general rewrites of my bad code, and for working on changes to the <span +class="ecss-1000">xr </span>package to suit +<span +class="ecss-1000">hyperref</span>. + + + <h3 class="sectionHead"><span class="titlemark">10 </span> <a + id="x1-2100010"></a>GNU Free Documentation License</h3> +<!--l. 6--><p class="noindent">Version 1.2, November 2002 +<br class="newline"> +<!--l. 9--><p class="indent"> Copyright <span +class="cmsy-10">©</span> 2000,2001,2002 Free Software Foundation, Inc. +<br class="newline">59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +<br class="newline">Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is +not allowed. +<!--l. 15--><p class="noindent"> + <h4 class="likesubsectionHead"><a + id="x1-2200010"></a>Preamble</h4> +<!--l. 17--><p class="noindent">The purpose of this License is to make a manual, textbook, or other functional and useful document +“free” in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or +without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the +author and publisher a way to get credit for their work, while not being considered responsible for +modifications made by others. +<!--l. 25--><p class="indent"> This License is a kind of “copyleft”, which means that derivative works of the document must +themselves be free in the same sense. It complements the GNU General Public License, which is a +copyleft license designed for free software. +<!--l. 30--><p class="indent"> We have designed this License in order to use it for manuals for free software, because free software +needs free documentation: a free program should come with manuals providing the same +freedoms that the software does. But this License is not limited to software manuals; it can +be used for any textual work, regardless of subject matter or whether it is published as a +printed book. We recommend this License principally for works whose purpose is instruction or +reference. +<!--l. 39--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.1 </span> <a + id="x1-2300010.1"></a>Applicability and definitions</h4> +<!--l. 42--><p class="noindent">This License applies to any manual or other work, in any medium, that contains a notice placed by +the copyright holder saying it can be distributed under the terms of this License. Such a +notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under +the conditions stated herein. The “Document”, below, refers to any such manual or work. +Any member of the public is a licensee, and is addressed as “you”. You accept the license +if you copy, modify or distribute the work in a way requiring permission under copyright +law. +<!--l. 52--><p class="indent"> A “Modified Version” of the Document means any work containing the Document or a +portion of it, either copied verbatim, or with modifications and/or translated into another +language. +<!--l. 56--><p class="indent"> A “Secondary Section” is a named appendix or a front-matter section of the Document that deals +exclusively with the relationship of the publishers or authors of the Document to the Document’s overall +subject (or to related matters) and contains nothing that could fall directly within that overall subject. +(Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical connection with the subject or with +related matters, or of legal, commercial, philosophical, ethical or political position regarding +them. +<!--l. 67--><p class="indent"> The “Invariant Sections” are certain Secondary Sections whose titles are designated, as being those of +Invariant Sections, in the notice that says that the Document is released under this License. If a section +does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The +Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections + + +then there are none. +<!--l. 75--><p class="indent"> The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts or +Back-Cover Texts, in the notice that says that the Document is released under this License. +A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 +words. +<!--l. 80--><p class="indent"> A “Transparent” copy of the Document means a machine-readable copy, represented in a format +whose specification is available to the general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or +(for drawings) some widely available drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an +otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or +discourage subsequent modification by readers is not Transparent. An image format is not +Transparent if used for any substantial amount of text. A copy that is not “Transparent” is called +“Opaque”. +<!--l. 93--><p class="indent"> Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo +input format, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> input format, SGML or XML using a publicly available DTD, and +standard-conforming simple HTML, PostScript or PDF designed for human modification. +Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include +proprietary formats that can be read and edited only by proprietary word processors, SGML +or XML for which the DTD and/or processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word processors for output purposes +only. +<!--l. 104--><p class="indent"> The “Title Page” means, for a printed book, the title page itself, plus such following pages as are +needed to hold, legibly, the material this License requires to appear in the title page. For works +in formats which do not have any title page as such, “Title Page” means the text near the +most prominent appearance of the work’s title, preceding the beginning of the body of the +text. +<!--l. 111--><p class="indent"> A section “Entitled XYZ” means a named subunit of the Document whose title either is precisely +XYZ or contains XYZ in parentheses following text that translates XYZ in another language. +(Here XYZ stands for a specific section name mentioned below, such as “Acknowledgements”, +“Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section when you +modify the Document means that it remains a section “Entitled XYZ” according to this +definition. +<!--l. 119--><p class="indent"> The Document may include Warranty Disclaimers next to the notice which states that this +License applies to the Document. These Warranty Disclaimers are considered to be included by +reference in this License, but only as regards disclaiming warranties: any other implication +that these Warranty Disclaimers may have is void and has no effect on the meaning of this +License. +<!--l. 127--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.2 </span> <a + id="x1-2400010.2"></a>Verbatim copying</h4> +<!--l. 130--><p class="noindent">You may copy and distribute the Document in any medium, either commercially or noncommercially, +provided that this License, the copyright notices, and the license notice saying this License applies to the +Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this +License. You may not use technical measures to obstruct or control the reading or further copying of the +copies you make or distribute. However, you may accept compensation in exchange for copies. If you +distribute a large enough number of copies you must also follow the conditions in section +<a +href="#x1-2500010.3">10.3<!--tex4ht:ref: copying --></a>. +<!--l. 141--><p class="indent"> You may also lend copies, under the same conditions stated above, and you may publicly display +copies. + + +<!--l. 145--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.3 </span> <a + id="x1-2500010.3"></a>Copying in quantity</h4> +<!--l. 148--><p class="noindent">If you publish printed copies (or copies in media that commonly have printed covers) of the Document, +numbering more than 100, and the Document’s license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front +cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly +identify you as the publisher of these copies. The front cover must present the full title with all +words of the title equally prominent and visible. You may add other material on the covers +in addition. Copying with changes limited to the covers, as long as they preserve the title +of the Document and satisfy these conditions, can be treated as verbatim copying in other +respects. +<!--l. 161--><p class="indent"> If the required texts for either cover are too voluminous to fit legibly, you should put the first ones +listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent +pages. +<!--l. 166--><p class="indent"> If you publish or distribute Opaque copies of the Document numbering more than 100, you must +either include a machine-readable Transparent copy along with each Opaque copy, or state in or with +each Opaque copy a computer-network location from which the general network-using public has access +to download using public-standard network protocols a complete Transparent copy of the Document, free +of added material. If you use the latter option, you must take reasonably prudent steps, when you +begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will +remain thus accessible at the stated location until at least one year after the last time you +distribute an Opaque copy (directly or through your agents or retailers) of that edition to the +public. +<!--l. 179--><p class="indent"> It is requested, but not required, that you contact the authors of the Document well before +redistributing any large number of copies, to give them a chance to provide you with an updated version +of the Document. +<!--l. 184--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.4 </span> <a + id="x1-2600010.4"></a>Modifications</h4> +<!--l. 187--><p class="noindent">You may copy and distribute a Modified Version of the Document under the conditions of sections <a +href="#x1-2400010.2">10.2<!--tex4ht:ref: verbatim --></a> +and <a +href="#x1-2500010.3">10.3<!--tex4ht:ref: copying --></a> above, provided that you release the Modified Version under precisely this License, with the +Modified Version filling the role of the Document, thus licensing distribution and modification of the +Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified +Version: +<!--l. 196--><p class="indent"> + <ol type="1" class="enumerate1" > + <li class="enumerate" value="1" +><a + id="x1-26002x1"></a>Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, + and from those of previous versions (which should, if there were any, be listed in the History + section of the Document). You may use the same title as a previous version if the original + publisher of that version gives permission. + </li> + <li class="enumerate" value="2" +><a + id="x1-26004x2"></a>List on the Title Page, as authors, one or more persons or entities responsible for authorship + of the modifications in the Modified Version, together with at least five of the principal + authors of the Document (all of its principal authors, if it has fewer than five), unless they + release you from this requirement. + </li> + <li class="enumerate" value="3" +><a + id="x1-26006x3"></a>State on the Title page the name of the publisher of the Modified Version, as the publisher. + + </li> + <li class="enumerate" value="4" +><a + id="x1-26008x4"></a>Preserve all the copyright notices of the Document. + </li> + <li class="enumerate" value="5" +><a + id="x1-26010x5"></a>Add an appropriate copyright notice for your modifications adjacent to the other copyright + notices. + </li> + <li class="enumerate" value="6" +><a + id="x1-26012x6"></a>Include, immediately after the copyright notices, a license notice giving the public permission + to use the Modified Version under the terms of this License, in the form shown in the + Addendum below. + </li> + <li class="enumerate" value="7" +><a + id="x1-26014x7"></a>Preserve in that license notice the full lists of Invariant Sections and required Cover Texts + given in the Document’s license notice. + </li> + <li class="enumerate" value="8" +><a + id="x1-26016x8"></a>Include an unaltered copy of this License. + </li> + <li class="enumerate" value="9" +><a + id="x1-26018x9"></a>Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at + least the title, year, new authors, and publisher of the Modified Version as given on the Title + Page. If there is no section Entitled “History” in the Document, create one stating the title, + year, authors, and publisher of the Document as given on its Title Page, then add an item + describing the Modified Version as stated in the previous sentence. + </li> + <li class="enumerate" value="10" +><a + id="x1-26020x10"></a>Preserve the network location, if any, given in the Document for public access to a + Transparent copy of the Document, and likewise the network locations given in the Document + for previous versions it was based on. These may be placed in the “History” section. You + may omit a network location for a work that was published at least four years before the + Document itself, or if the original publisher of the version it refers to gives permission. + </li> + <li class="enumerate" value="11" +><a + id="x1-26022x11"></a>For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the + section, and preserve in the section all the substance and tone of each of the contributor + acknowledgements and/or dedications given therein. + </li> + <li class="enumerate" value="12" +><a + id="x1-26024x12"></a>Preserve all the Invariant Sections of the Document, unaltered in their text and in their + titles. Section numbers or the equivalent are not considered part of the section titles. + </li> + <li class="enumerate" value="13" +><a + id="x1-26026x13"></a>Delete any section Entitled “Endorsements”. Such a section may not be included in the + Modified Version. + </li> + <li class="enumerate" value="14" +><a + id="x1-26028x14"></a>Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with + any Invariant Section. + </li> + <li class="enumerate" value="15" +><a + id="x1-26030x15"></a>Preserve any Warranty Disclaimers. + </li></ol> + + +<!--l. 247--><p class="indent"> If the Modified Version includes new front-matter sections or appendices that qualify as Secondary +Sections and contain no material copied from the Document, you may at your option designate some or +all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in +the Modified Version’s license notice. These titles must be distinct from any other section +titles. +<!--l. 254--><p class="indent"> You may add a section Entitled “Endorsements”, provided it contains nothing but endorsements of +your Modified Version by various parties–for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a standard. +<!--l. 260--><p class="indent"> You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as +a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any +one entity. If the Document already includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, you may not add another; but you +may replace the old one, on explicit permission from the previous publisher that added the old +one. +<!--l. 270--><p class="indent"> The author(s) and publisher(s) of the Document do not by this License give permission to use their +names for publicity for or to assert or imply endorsement of any Modified Version. +<!--l. 275--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.5 </span> <a + id="x1-2700010.5"></a>Combining documents</h4> +<!--l. 278--><p class="noindent">You may combine the Document with other documents released under this License, under the terms +defined in section <a +href="#x1-2600010.4">10.4<!--tex4ht:ref: modifications --></a> above for modified versions, provided that you include in the combination all of +the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant +Sections of your combined work in its license notice, and that you preserve all their Warranty +Disclaimers. +<!--l. 286--><p class="indent"> The combined work need only contain one copy of this License, and multiple identical Invariant +Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name +but different contents, make the title of each such section unique by adding at the end of it, in +parentheses, the name of the original author or publisher of that section if known, or else a unique +number. Make the same adjustment to the section titles in the list of Invariant Sections in the license +notice of the combined work. +<!--l. 295--><p class="indent"> In the combination, you must combine any sections Entitled “History” in the various original +documents, forming one section Entitled “History”; likewise combine any sections Entitled +“Acknowledgements”, and any sections Entitled “Dedications”. You must delete all sections Entitled +“Endorsements”. +<!--l. 302--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.6 </span> <a + id="x1-2800010.6"></a>Collections of documents</h4> +<!--l. 305--><p class="noindent">You may make a collection consisting of the Document and other documents released under this License, +and replace the individual copies of this License in the various documents with a single copy that is +included in the collection, provided that you follow the rules of this License for verbatim copying of each +of the documents in all other respects. +<!--l. 311--><p class="indent"> You may extract a single document from such a collection, and distribute it individually under this +License, provided you insert a copy of this License into the extracted document, and follow this License +in all other respects regarding verbatim copying of that document. +<!--l. 317--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.7 </span> <a + id="x1-2900010.7"></a>Aggregation with independent works</h4> + +<!--l. 320--><p class="noindent">A compilation of the Document or its derivatives with other separate and independent documents or +works, in or on a volume of a storage or distribution medium, is called an “aggregate” if the copyright +resulting from the compilation is not used to limit the legal rights of the compilation’s users beyond what +the individual works permit. When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves derivative works of the +Document. +<!--l. 329--><p class="indent"> If the Cover Text requirement of section <a +href="#x1-2500010.3">10.3<!--tex4ht:ref: copying --></a> is applicable to these copies of the Document, then if +the Document is less than one half of the entire aggregate, the Document’s Cover Texts may be placed +on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the +Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole +aggregate. +<!--l. 338--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.8 </span> <a + id="x1-3000010.8"></a>Translation</h4> +<!--l. 341--><p class="noindent">Translation is considered a kind of modification, so you may distribute translations of the Document +under the terms of section <a +href="#x1-2600010.4">10.4<!--tex4ht:ref: modifications --></a>. Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include translations of some or all Invariant +Sections in addition to the original versions of these Invariant Sections. You may include a translation of +this License, and all the license notices in the Document, and any Warranty Disclaimers, +provided that you also include the original English version of this License and the original +versions of those notices and disclaimers. In case of a disagreement between the translation +and the original version of this License or a notice or disclaimer, the original version will +prevail. +<!--l. 355--><p class="indent"> If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the +requirement (section <a +href="#x1-2600010.4">10.4<!--tex4ht:ref: modifications --></a>) to Preserve its Title (section <a +href="#x1-2300010.1">10.1<!--tex4ht:ref: applicability --></a>) will typically require changing the actual +title. +<!--l. 362--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.9 </span> <a + id="x1-3100010.9"></a>Termination</h4> +<!--l. 365--><p class="noindent">You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under +this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, parties who have received copies, or +rights, from you under this License will not have their licenses terminated so long as such parties remain +in full compliance. +<!--l. 374--><p class="noindent"> + <h4 class="subsectionHead"><span class="titlemark">10.10 </span> <a + id="x1-3200010.10"></a>Future revisions of this license</h4> +<!--l. 377--><p class="noindent">The Free Software Foundation may publish new, revised versions of the GNU Free Documentation +License from time to time. Such new versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. +<!--l. 383--><p class="indent"> Each version of the License is given a distinguishing version number. If the Document specifies that a +particular numbered version of this License “or any later version” applies to it, you have the option of +following the terms and conditions either of that specified version or of any later version that has been +published (not as a draft) by the Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not as a draft) by the Free Software +Foundation. + + +<!--l. 393--><p class="noindent"> + <h4 class="likesubsectionHead"><a + id="x1-3300010.10"></a>Addendum: how to use this license for your documents</h4> +<!--l. 395--><p class="noindent">To use this License in a document you have written, include a copy of the License in the document and +put the following copyright and license notices just after the title page: +<!--l. 399--><p class="indent"> + <div class="quote"> + <!--l. 400--><p class="noindent">Copyright <span +class="cmsy-10">©</span> YEAR YOUR NAME. Permission is granted to copy, distribute and/or + modify this document under the terms of the GNU Free Documentation License, + Version 1.2 or any later version published by the Free Software Foundation; with no + Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the + license is included in the section entitled “GNU Free Documentation License”.</div> +<!--l. 409--><p class="indent"> If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” +line with this: +<!--l. 412--><p class="indent"> with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and +with the Back-Cover Texts being LIST. +<!--l. 415--><p class="indent"> If you have Invariant Sections without Cover Texts, or some other combination of the three, merge +those two alternatives to suit the situation. +<!--l. 419--><p class="indent"> If your document contains nontrivial examples of program code, we recommend releasing these +examples in parallel under your choice of free software license, such as the GNU General Public License, +to permit their use in free software. + + + +</body></html> + + + + diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.pdf b/Master/texmf-dist/doc/latex/hyperref/manual.pdf Binary files differnew file mode 100644 index 00000000000..1dc5ff35b93 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/manual.tex b/Master/texmf-dist/doc/latex/hyperref/manual.tex new file mode 100644 index 00000000000..0fab1a1953d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual.tex @@ -0,0 +1,1123 @@ +% This is the manual for the LaTeX hyperref package. +% +% Copyright (C) 1998, 2003 Sebastian Rahtz. +% +% Permission is granted to copy, distribute and/or modify this document +% under the terms of the GNU Free Documentation License, Version 1.1 or +% any later version published by the Free Software Foundation; with no +% Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +% Texts. A copy of the license is included in the section entitled +% ``GNU Free Documentation License.'' + +\RequirePackage{ifpdf} +\ifpdf % We are running pdfTeX in pdf mode +\documentclass[pdftex]{article} +\else +\documentclass{article} +\fi + +% Page layout. +\advance\textwidth by 1.1in +\advance\oddsidemargin by -.55in +\advance\evensidemargin by -.55in +% +\advance\textheight by 1in +\advance\topmargin by -.5in +\advance\footskip by -.5in +% +\pagestyle{headings} +% +% Avoid some overfull boxes. +\emergencystretch=.1\hsize +\hbadness = 3000 + +% these are from lshort.sty, but lshort.sty pulls in so many other +% packages it seems cleaner to just include them here. +% +\newcommand{\bs}{\symbol{'134}}%Print backslash +\newcommand{\ci}[1]{\texttt{\bs#1}} + +\makeatletter +\@ifpackageloaded{tex4ht}{% + % separate definition for HTML case to avoid + % nasty borders with double horizontal lines with + % large gaps. + \newsavebox{\cmdsyntaxbox}% + \newenvironment{cmdsyntax}{% + \par + % \small + \addvspace{3.2ex plus 0.8ex minus 0.2ex}% + \vskip -\parskip + \noindent + \begin{lrbox}{\cmdsyntaxbox}% + \begin{tabular}{l}% + \rule{0pt}{1em}% + \ignorespaces + }{% + \end{tabular}% + \end{lrbox}% + \fbox{\usebox{\cmdsyntaxbox}}% + \par + \nopagebreak + \addvspace{3.2ex plus 0.8ex minus 0.2ex}% + \vskip -\parskip + }% +}{% + \newenvironment{cmdsyntax}{% + \par + \small + \addvspace{3.2ex plus 0.8ex minus 0.2ex}% + \vskip -\parskip + \noindent + \begin{tabular}{|l|}% + \hline + \rule{0pt}{1em}% + \ignorespaces + }{% + \\% + \hline + \end{tabular}% + \par + \nopagebreak + \addvspace{3.2ex plus 0.8ex minus 0.2ex}% + \vskip -\parskip + }% +} +\makeatother + +\usepackage{array,longtable} +\usepackage[T1]{fontenc} + +\newcommand*{\Quote}[1]{\textquotedblleft#1\textquotedblright} + +\def\Hanh{H\`an Th\^e\llap{\raise 0.5ex\hbox{\'{}}} Th\`anh} + +\ifpdf + \usepackage[% + pdftex,% + colorlinks,% + hyperindex,% + plainpages=false,% + bookmarksopen,% + bookmarksnumbered% + ]{hyperref} + %%?? \def\pdfBorderAttrs{/Border [0 0 0] } % No border arround Links + \usepackage{thumbpdf} +\else + \usepackage{hyperref} +\fi + +\title{Hypertext marks in \LaTeX: a manual for \textsf{hyperref}} +\author{Sebastian Rahtz \and Heiko Oberdiek} +% Manual updated by Steve Peter and Karl Berry, 7/03. +\date{February 2004} + +\begin{document} + +% comes out too close to the toc, and we know it's page one anyway. +\thispagestyle{empty} +\maketitle +\tableofcontents +\setcounter{tocdepth}{2}% for bookmark levels + +\section{Introduction} + +The package derives from, and builds on, the work of the Hyper\TeX\ +project, described at \url{http://xxx.lanl.gov/hypertex/}. It extends +the functionality of all the \LaTeX\ cross-referencing commands +(including the table of contents, bibliographies etc) to produce +\verb|\special| commands which a driver can turn into hypertext links; +it also provides new commands to allow the user to write \emph{ad hoc} +hypertext links, including those to external documents and URLs. + +This manual provides a brief overview of the \textsf{hyperref} +package. For more details, you should read the additional documentation +distributed with the package, as well as the complete documentation by +processing \texttt{hyperref.dtx}. You should also read the chapter on +\textsf{hyperref} in \textit{The \LaTeX\ Web Companion}, where you will +find additional examples. + +The Hyper\TeX\ specification\footnote{This is borrowed from an article +by Arthur Smith.} says that conformant viewers/translators must +recognize the following set of \verb|\special| constructs: + +\begin{description} +\item[href:] \verb|html:<a href = "href_string">| +\item[name:] \verb|html:<a name = "name_string">| +\item[end:] \verb|html:</a>| +\item[image:] \verb|html:<img src = "href_string">| +\item[base\_name:] \verb|html:<base href = "href_string">| +\end{description} + +The \emph{href}, \emph{name} and \emph{end} commands are used to do the +basic hypertext operations of establishing links between sections of +documents. The \emph{image} command is intended (as with current HTML +viewers) to place an image of arbitrary graphical format on the page in +the current location. The \emph{base\_name} command is be used to +communicate to the DVI viewer the full (URL) location of the current +document so that files specified by relative URL's may be retrieved +correctly. + +The \emph{href} and \emph{name} commands must be paired with an +\emph{end} command later in the \TeX\ file---the \TeX\ commands between +the two ends of a pair form an \emph{anchor} in the document. In the +case of an \emph{href} command, the \emph{anchor} is to be highlighted +in the \emph{DVI viewer}, and when clicked on will cause the scene to +shift to the destination specified by \emph{href\_string}. The +\emph{anchor} associated with a name command represents a possible +location to which other hypertext links may refer, either as local +references (of the form \verb|href="#name_string"| with the +\emph{name\_string} identical to the one in the name command) or as part +of a URL (of the form \emph{URL\#name\_string}). Here +\emph{href\_string} is a valid URL or local identifier, while +\emph{name\_string} could be any string at all: the only caveat is that +`$\verb|"|$' characters should be escaped with a backslash +($\backslash$), and if it looks like a URL name it may cause problems. + +However, the drivers intended to produce \emph{only} PDF use literal +PostScript or PDF \verb|\special| commands. The commands are defined in +configuration files for different drivers, selected by package options; +at present, the following drivers are supported: + +\begin{description} +\item[hypertex] DVI processors conforming to the Hyper\TeX\ guidelines (i.e.\ \textsf{xdvi}, \textsf{dvips} (with +the \textsf{-z} option), \textsf{OzTeX}, and \textsf{Textures}) +\item[dvips] produces \verb|\special| commands tailored for \textsf{dvips} +\item[dvipsone] produces \verb|\special| commands tailored for \textsf{dvipsone} +\item[ps2pdf] a special case of output suitable for processing by earlier versions of Ghost\-script's +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[dvipdf] produces \verb|\special| commands for the DVI to PDF driver \textsf{dvipdf} +\item[dvipdfm] produces \verb|\special| commands for Mark Wicks' DVI to PDF driver \textsf{dvipdfm} +\item[dviwindo] produces \verb|\special| commands that Y\&Y's Windows previewer interprets as hypertext jumps within the previewer +\item[vtex] produces \verb|\special| commands that MicroPress' HTML and + PDF-producing \TeX\ variants interpret as hypertext jumps within the + previewer +\item[textures] produces \verb|\special| commands that \textsf{Textures} interprets as hypertext jumps within the previewer +\end{description} + +Output from \textsf{dvips} or \textsf{dvipsone} must be processed using +Acrobat Distiller to obtain a PDF file.\footnote{Make sure you turn off +the partial font downloading supported by \textsf{dvips} and +\textsf{dvipsone} in favor of Distiller's own system.} The result is +generally preferable to that produced by using the \textsf{hypertex} +driver, and then processing with \textsf{dvips -z}, but the DVI file is +not portable. The main advantage of using the Hyper\TeX\ \ci{special} +commands is that you can also use the document in hypertext DVI viewers, +such as \textsf{xdvi}. + +\section{Implicit behavior} + +This package can be used with more or less any normal \LaTeX\ document +by specifying in the document preamble + +\begin{verbatim} +\usepackage{hyperref} +\end{verbatim} + +Make sure it comes \emph{last} of your loaded packages, to give it a +fighting chance of not being over-written, since its job is to redefine +many \LaTeX\ commands. Hopefully you will find that all cross-references +work correctly as hypertext. For example, \ci{section} commands will +produce a bookmark and a link, whereas \ci{section*} commands will only +show links when paired with a corresponding \ci{addcontentsline} +command. + +In addition, the \texttt{hyperindex} option (see below) attempts to make +items in the index by hyperlinked back to the text, and the option +\texttt{backref} inserts extra `back' links into the bibliography for +each entry. Other options control the appearance of links, and give +extra control over PDF output. For example, \texttt{colorlinks}, as its +name well implies, colors the links instead of using boxes; this is the +option used in this document. + + +\section{Package options} + +All user-configurable aspects of \textsf{hyperref} are set using a +single `key=value' scheme (using the \textsf{keyval} package) with the +key \texttt{Hyp}. The options can be set either in the optional argument +to the \verb|\usepackage| command, or using the \verb|\hypersetup| +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. + +As an example, the behavior of a particular file could be controlled by: +\begin{itemize} + +\item a site-wide \texttt{hyperref.cfg} setting up the look of links, +adding backreferencing, and setting a PDF display default: + +\begin{verbatim} +\hypersetup{backref, +pdfpagemode=FullScreen, +colorlinks=true} +\end{verbatim} + +\item A global option in the file, which is passed down to +\textsf{hyperref}: + +\begin{verbatim} +\documentclass[dvips]{article} +\end{verbatim} + +\item File-specific options in the \verb|\usepackage| commands, which +override the ones set in \texttt{hyperref.cfg}: + +\begin{verbatim} +\usepackage[pdftitle={A Perfect Day},colorlinks=false]{hyperref} +\end{verbatim} +\end{itemize} + +Some options can be given at any time, but many are restricted: before +\verb|\begin{document}|, only in \verb|\usepackage[...]{hyperref}|, +before first use, etc. + +In the key descriptions that follow, many options do not need a value, +as they default to the value true if used. These are the ones classed as +`boolean'. The values true and false can always be specified, however. + +\subsection{General options} + +Firstly, the options to specify general behavior and page size. + +\medskip +\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}ll} +draft & boolean & false & all hypertext options are turned off \\ +final & boolean & true & all hypertext options are turned on \\ +debug & boolean & false & extra diagnostic messages are printed in \\ + & & & the log file \\ +verbose & boolean & false & same as debug \\ +implicit & boolean & true & redefines \LaTeX\ internals \\ +hypertexnames & boolean & true & use guessable names for links \\ +naturalnames & boolean & false & use \LaTeX-computed names for links \\ +a4paper & boolean & true & sets paper size to 210mm $\times$ 297mm \\ +a5paper & boolean & false & sets paper size to 148mm $\times$ 210mm \\ +b5paper & boolean & false & sets paper size to 176mm $\times$ 250mm \\ +letterpaper & boolean & false & sets paper size to 8.5in $\times$ 11in \\ +legalpaper & boolean & false & sets paper size to 8.5in $\times$ 14in \\ +executivepaper & boolean & false & sets paper size to 7.25in $\times$ 10.5in \\ +setpagesize & boolean & true & sets page size by special driver commands +\end{longtable} + +\subsection{Configuration options} + +\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{7cm}} +raiselinks & boolean & true & In the hypertex driver, the height of links is normally calculcated by the driver as + simply the base line of contained text; this options forces \verb|\special| commands to + reflect the real height of the link (which could contain a graphic) \\ +breaklinks & boolean & false & Allows link text to break across lines; since this cannot be accommodated in PDF, it is + only set true by default if the pdftex driver is used. This makes links on multiple lines + into different PDF links to the same target. \\ +pageanchor & boolean & true & Determines whether every page is given an implicit anchor at the top left corner. If this + is turned off, \verb|\tableofcontents| will not contain hyperlinks. \\ +plainpages & boolean & true & Forces page anchors to be named by the arabic form of the page number, rather than the + formatted form. \\ +nesting & boolean & false & Allows links to be nested; no drivers currently support this. +\end{longtable} + +\subsection{Backend drivers} + +If no driver is specified, the package defaults to loading the +\textsf{hypertex} driver. All of these are boolean options. + +\noindent\begin{longtable}{>{\ttfamily}lp{.8\hsize}} +dvips & Sets up \textsf{hyperref} for use with the \textsf{dvips} driver. \\ +dvipsone & Sets up \textsf{hyperref} for use with the \textsf{dvipsone} driver. \\ +dviwindo & Sets up \textsf{hyperref} for use with the \textsf{dviwindo} Windows previewer. \\ +hypertex & Sets up \textsf{hyperref} for use with the Hyper\TeX-compliant drivers. \\ +latex2html & Redefines a few macros for compatibility with \textsf{latex2html}. \\ +nativepdf & an alias for \textsf{dvips} \\ +pdfmark & an alias for \textsf{dvips} \\ +pdftex & Sets up \textsf{hyperref} for use with the \textsf{pdftex} program.\\ +ps2pdf & Redefines a few macros for compatibility with + Ghostscript's PDF writer, otherwise identical to + \textsf{dvips}. \\ +tex4ht & for use with \textsf{\TeX4ht} \\ +textures & for use with \textsf{Textures} \\ +vtex & For use with MicroPress' \textsf{VTeX}; the PDF + and HTML backends are detected automatically. \\ +vtexpdfmark & for use with \textsf{VTeX}'s PostScript backend. \\ +\end{longtable} \smallskip + +If you use \textsf{dviwindo}, you may need to redefine the macro +\ci{wwwbrowser} (the default is \verb|C:\netscape\netscape|) to tell +\textsf{dviwindo} what program to launch. Thus, users of Internet +Explorer might add something like this to hyperref.cfg: + +\begin{verbatim} +\renewcommand{wwwbrowser}{C:\string\Program\space + Files\string\Plus!\string\Microsoft\space + Internet\string\iexplore.exe} +\end{verbatim} + +\subsection{Extension options} +\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{6cm}} +extension & text & & Set the file extension (e.g.\ \textsf{dvi}) which will be appended to file links + created if you use the \textsf{xr} package. \\ +hyperfigures & boolean & & \\ +backref & boolean & false & Adds `backlink' text to the end of each item in the bibliography, as a list of + section numbers. This can only work properly \emph{if} there is a blank line after + each \verb|\bibitem|. \\ +pagebackref & boolean & false & Adds `backlink' text to the end of each item in the bibliography, as a list of page + numbers. \\ +hyperindex & boolean & false & Makes the text of index entries into hyperlinks. Easily broken \ldots \\ +encap & & & Sets encap character for hyperindex \\ +linktocpage & boolean & false & make page number, not text, be link on TOC, LOF and LOT \\ +breaklinks & boolean & false & allow links to break over lines by making links over multiple lines into PDF links to + the same target \\ +colorlinks & boolean & false & 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. \\ +linkcolor & color & red & Color for normal internal links. \\ +anchorcolor & color & black & Color for anchor text. \\ +citecolor & color & green & Color for bibliographical citations in text. \\ +filecolor & color & magenta & Color for URLs which open local files. \\ +menucolor & color & red & Color for Acrobat menu items. \\ +pagecolor & color & red & Color for links to other pages. \\ +urlcolor & color & cyan & Color for linked URLs. \\ +frenchlinks & boolean & false & use small caps instead of color for links +\end{longtable} \smallskip + +Note that all color names must be defined before use, following the +normal system of the standard \LaTeX\ \textsf{color} package. + +\subsection{PDF-specific display options} +\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{5cm}} +bookmarks & boolean & false & 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 + translate \LaTeX\ codes, since bookmarks must be written in PDFEncoding. + To aid this process, the \texttt{.out} file is not rewritten by \LaTeX\ + if it is edited to contain a line \verb|\let\WriteBookmarks\relax| \\ +bookmarksopen & boolean & false & If Acrobat bookmarks are requested, show them with all the subtrees + expanded. \\ +bookmarksopenlevel & parameter & & level (\ci{maxdimen}) to which bookmarks are open \\ +bookmarksnumbered & boolean & false & If Acrobat bookmarks are requested, include section numbers. \\ +bookmarkstype & text & toc & to specify which `toc' file to mimic \\ +pdfhighlight & name & /I & How link buttons behave when selected; /I is for inverse (the default); + the other possibilities are /N (no effect), /O (outline), and /P (inset + highlighting). \\ +citebordercolor & RGB color & 0 1 0 & The color of the box around citations \\ +filebordercolor & RGB color & 0 .5 .5 & The color of the box around links to files \\ +linkbordercolor & RGB color & 1 0 0 & The color of the box around normal links \\ +menubordercolor & RGB color & 1 0 0 & The color of the box around Acrobat menu links \\ +pagebordercolor & RGB color & 1 1 0 & The color of the box around links to pages \\ +urlbordercolor & RGB color & 0 1 1 & The color of the box around links to URLs \\ +runbordercolor & RGB color & 0 .7 .7 & color of border around `run' links \\ +pdfborder & & 0 0 1 & 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. +\end{longtable} + +Note that the color of link borders can be specified \emph{only} as 3 +numbers in the range 0..1, giving an RGB color. You cannot use colors +defined in \TeX. + +The bookmark commands are stored in a file called +\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 \\ + +\begin{verbatim} +\let\WriteBookmarks\relax +\end{verbatim} + +\subsection{PDF display and information options} +\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{6cm}} +baseurl & URL & & Sets the base URL of the PDF document \\ +pdfpagemode & text & None & Determines how the file is opening in Acrobat; the possibilities are + \texttt{None}, \texttt{UseThumbs} (show thumbnails), \texttt{UseOutlines} (show + bookmarks), and \texttt{FullScreen}. If no mode if explicitly chosen, but the + bookmarks option is set, \texttt{UseOutlines} is used. \\ +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 \\ +pdfkeywords & text & & Sets the document information Keywords field \\ +pdfview & text & FitBH & Sets the default PDF `view' for each link \\ +pdfstartpage & text & 1 & Determines on which page the PDF file is opened. \\ +pdfstartview & text & FitB & Set the startup page view \\ +pdfpagescrop & n n n n & & Sets the default PDF crop box for pages. This should be a set of four numbers \\ +pdfcenterwindow & boolean & false & position the document window in the center of the screen \\ +pdffitwindow & boolean & false & resize document window to fit document size \\ +pdfmenubar & boolean & true & make PDF viewer's menu bar visible \\ +pdfnewwindow & boolean & false & make links that open another PDF file start a new window \\ +pdfpagelayout & text & empty & set layout of PDF pages \\ +pdfpagelabels & boolean & false & set PDF page labels \\ +pdfpagetransition & text & empty & set PDF page transition style \\ +pdftoolbar & boolean & true & make PDF toolbar visible \\ +pdfwindowui & boolean & true & make PDF user interface elements visible \\ +unicode & & & Unicode encoded PDF strings +\end{longtable} + +Each link in Acrobat carries its own magnification level, which is set +using PDF coordinate space, which is not the same as \TeX's. pdf\TeX\ +works by supplying default values for \texttt{XYZ} (horizontal $\times$ +vertical $\times$ zoom) and \texttt{FitBH}. However, drivers using +\texttt{pdfmark} do not supply defaults, so \textsf{hyperref} passes in +a value of -32768, which causes Acrobat to set (usually) sensible +defaults. The following are possible values for the \texttt{pdfview} and +\texttt{pdfstartview} parameters. + +\noindent\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. \\ +FitH & top & Fits the width of the page to the window. \\ +FitV & left & Fits the height of the page to the window. \\ +FitR & left bottom right top & Fits the rectangle specified by the four coordinates to the window. \\ +FitB & & Fits the page bounding box to the window. \\ +FitBH & top & Fits the width of the page bounding box to the window. \\ +FitBV & left & Fits the height of the page bounding box to the window. \\ +\end{longtable} + +The \texttt{pdfpagelayout} can be one of the following values. + +\noindent\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. \\ +TwoColumnRight & Displays the document in two columns, odd-numbered pages to the right. +\end{longtable} + +Finally, the \texttt{pdfpagetransition} can be one of the following +values, where \textit{/Di} stands for direction of motion in degrees, +generally in 90$^{\circ}$\ steps, \textit{/Dm} is a horizontal +(\texttt{/H}) or vertical (\texttt{/V}) dimension (e.g.\ \texttt{Blinds +/Dm /V}), and \textit{/M} is for motion, either in (\texttt{/I}) or out +(\texttt{/O}). + +\noindent\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. \\ +Dissolve & & The page image dissolves in a piecemeal fashion to reveal the new page. \\ +Glitter & /Di & Similar to Dissolve, except the effect sweeps across the screen. \\ +Split & /Dm /M & Two lines sweep across the screen to reveal the new page. \\ +Wipe & /Di & A single line sweeps across the screen to reveal the new page. +\end{longtable} + +\subsection{Big alphabetical list} + +The following is a complete listing of available options for +\textsf{hyperref}, arranged alphabetically. + +\noindent\begin{longtable}{>{\ttfamily}llp{6cm}} +a4paper & & use A4 paper \\ +a5paper & & use A5 paper \\ +anchorcolor & \textit{black} & set color of anchors \\ +b5paper & & use B5 paper \\ +backref & \textit{false} & do bibliographical back references \\ +baseurl & \textit{empty} & set base URL for document \\ +bookmarks & \textit{true} & make bookmarks \\ +bookmarksnumbered & \textit{false} & put section numbers in bookmarks \\ +bookmarksopen & \textit{false} & open up bookmark tree \\ +bookmarksopenlevel & \ttfamily\ci{maxdimen} & level to which bookmarks are open \\ +bookmarkstype & \textit{toc} & to specify which `toc' file to mimic \\ +breaklinks & \textit{false} & allow links to break over lines \\ +citebordercolor & \textit{0 1 0} & color of border around cites \\ +citecolor & \textit{green} & color of citation links \\ +colorlinks & \textit{false} & color links \\ + & \textit{true} & (\textsf{tex4ht}, \textsf{dviwindo}) \\ +debug & \textit{false} & provide details of anchors defined; same as verbose \\ +draft & \textit{false} & do not do any hyperlinking \\ +dvipdf & & use \textsf{dvipdf} backend \\ +dvipdfm & & use \textsf{dvipdfm} backend \\ +dvips & & use \textsf{dvips} backend \\ +dvipsone & & use \textsf{dvipsone} backend \\ +dviwindo & & use \textsf{dviwindo} backend \\ +encap & & to set encap character for hyperindex \\ +executivepaper & & use executivepaper \\ +extension & \textit{dvi} & suffix of linked files \\ +filebordercolor & \textit{0 .5 .5} & color of border around file links \\ +filecolor & \textit{cyan} & color of file links \\ +final & \textit{true} & opposite of option draft \\ +frenchlinks & \textit{false} & use small caps instead of color for links \\ +hyperfigures & \textit{false} & make figures hyper links \\ +hyperindex & \textit{true} & set up hyperlinked indices \\ +hypertex & & use \textsf{Hyper\TeX} backend \\ +hypertexnames & \textit{true} & use guessable names for links \\ +implicit & \textit{true} & redefine \LaTeX\ internals \\ +latex2html & & use \textsf{\LaTeX2HTML} backend \\ +legalpaper & & use legalpaper \\ +letterpaper & & use letterpaper \\ +linkbordercolor & \textit{1 0 0} & color of border around links \\ +linkcolor & \textit{red} & color of links \\ +linktocpage & \textit{false} & make page number, not text, be link on TOC, LOF and LOT \\ +menubordercolor & \textit{1 0 0} & color of border around menu links \\ +menucolor & \textit{red} & color for menu links \\ +nativepdf & \textit{false} & an alias for \textsf{dvips} \\ +naturalnames & \textit{false} & use \LaTeX-computed names for links \\ +nesting & \textit{false} & allow nesting of links \\ +pageanchor & \textit{true} & put an anchor on every page \\ +pagebackref & \textit{false} & backreference by page number \\ +pagebordercolor & \textit{1 1 0} & color of border around page links \\ +pagecolor & \textit{red} & color of page links \\ +pdfauthor & \textit{empty} & text for PDF Author field \\ +pdfborder & \textit{0 0 1} & width of PDF link border \\ + & \textit{0 0 0} & (\texttt{colorlinks)} \\ +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} & \\ +pdffitwindow & \textit{false} & resize document window to fit document size \\ +pdfhighlight & \textit{/I} & set highlighting of PDF links \\ +pdfkeywords & \textit{empty} & text for PDF Keywords field \\ +pdfmark & \textit{false} & an alias for \textsf{dvips} \\ +pdfmenubar & \textit{true} & make PDF viewer's menu bar visible \\ +pdfnewwindow & \textit{false} & make links that open another PDF \\ + & & file start a new window \\ +pdfpagelayout & \textit{empty} & set layout of PDF pages \\ +pdfpagemode & \textit{empty} & set default mode of PDF display \\ +pdfpagelabels & \textit{false} & set PDF page labels \\ +pdfpagescrop & \textit{empty} & set crop size of PDF document \\ +pdfpagetransition & \textit{empty} & set PDF page transition style \\ +pdfproducer & \textit{empty} & text for PDF Producer field \\ +pdfstartpage & \textit{1} & page at which PDF document opens \\ +pdfstartview & \textit{/Fit} & starting view of PDF document \\ +pdfsubject & \textit{empty} & text for PDF Subject field \\ +pdftex & & use \textsf{pdf\TeX} backend \\ +pdftitle & \textit{empty} & text for PDF Title field \\ +pdftoolbar & \textit{true} & make PDF toolbar visible \\ +pdfview & \textit{empty} & PDF `view' when on link traversal \\ +pdfwindowui & \textit{true} & make PDF user interface elements visible \\ +plainpages & \textit{true} & do page number anchors as plain arabic \\ +ps2pdf & & use \textsf{ps2pdf} backend \\ +raiselinks & \textit{false} & raise up links (for \textsf{Hyper\TeX} backend) \\ +runbordercolor & \textit{0 .7 .7} & color of border around `run' links \\ +setpagesize & \textit{true} & set page size by special driver commands \\ +tex4ht & & use \textsf{\TeX4ht} backend \\ +textures & & use \textsf{Textures} backend \\ +unicode & & Unicode encoded pdf strings \\ +urlbordercolor & \textit{0 1 1} & color of border around URL links \\ +urlcolor & \textit{magenta} & color of URL links \\ +verbose & \textit{false} & be chatty \\ +vtex & & use \textsf{VTeX} backend\\ +\end{longtable} + +\section{Additional user macros} + +If you need to make references to URLs, or write explicit links, the +following low-level user macros are provided: + +\begin{cmdsyntax} +\ci{href}\verb|{|\emph{URL}\verb|}{|\emph{text}\verb|}| +\end{cmdsyntax} + +\noindent The \emph{text} is made a hyperlink to the \emph{URL}; this +must be a full URL (relative to the base URL, if that is defined). The +special characters \# and \~{} do \emph{not} need to be escaped in any +way. + +\begin{cmdsyntax} +\ci{url}\verb|{|\emph{URL}\verb|}| +\end{cmdsyntax} + +\noindent Equivalent to +\ci{href}\verb|{|\emph{URL}\verb|}{|\emph{URL}\verb|}|. + +\begin{cmdsyntax} +\ci{nolinkurl}\verb|{|\emph{URL}\verb|}| +\end{cmdsyntax} + +\noindent Write \emph{URL} as plain text, without creating a hyperlink. + +\begin{cmdsyntax} +\ci{hyperbaseurl}\verb|{|\emph{URL}\verb|}| +\end{cmdsyntax} + +\noindent A base \emph{URL} is established, which is prepended to other +specified URLs, to make it easier to write portable documents. + +\begin{cmdsyntax} +\ci{hyperimage}\verb|{|\emph{imageURL}\verb|}| +\end{cmdsyntax} + +\noindent The image referenced by the \emph{URL} is inserted. + +\begin{cmdsyntax} +\ci{hyperdef}\verb|{|\emph{category}\verb|}{|\emph{name}\verb|}{|\emph{text}\verb|}| +\end{cmdsyntax} + +\noindent A target area of the document (the \emph{text}) is marked, and +given the name \emph{category.name} + +\begin{cmdsyntax} +\ci{hyperref}\verb|{|\emph{URL}\verb|}{|\emph{category}\verb|}{|\emph{name}\verb|}{|\emph{text}\verb|}| +\end{cmdsyntax} + +\noindent \emph{text} is made into a link to \emph{URL\#category.name} + +\begin{cmdsyntax} +\ci{hyperlink}\verb|{|\emph{name}\verb|}{|\emph{text}\verb|}| +\end{cmdsyntax} +\begin{cmdsyntax} +\ci{hypertarget}\verb|{|\emph{name}\verb|}{|\emph{text}\verb|}| +\end{cmdsyntax} + +\noindent A simple internal link is created with \verb|\hypertarget|, +with two parameters of an anchor \emph{name}, and anchor +\emph{text}. \verb|\hyperlink| has two arguments, the name of a +hypertext object defined somewhere by \verb|\hypertarget|, and the +\emph{text} which be used as the link on the page. + +Note that in HTML parlance, the \verb|\hyperlink| command inserts a +notional \# in front of each link, making it relative to the current +testdocument; \verb|\href| expects a full URL. + + +\begin{cmdsyntax} +\ci{autoref}\verb|{|\emph{label}\verb|}| +\end{cmdsyntax} + +This is a replacement for the usual \verb|\ref| command that places a +contextual label in front of the reference. This gives your users a +bigger target to click for hyperlinks (e.g.\ `section 2' instead of +merely the number `2'). + +The label is worked out from the context of the original \verb|\label| +command by \textsf{hyperref} by using the macros listed below (shown +with their default values). The macros can be redefined in documents +using \verb|\renewcommand|; note that some of these macros are already +defined in the standard document classes. The mixture of lowercase and +uppercase initial letters is deliberate and corresponds to the author's +practice. + +For each macro below, \textsf{hyperref} checks \ci{*autorefname} before +\ci{*name}. For instance, it looks for \ci{figureautorefname} before +\ci{figurename}. + +\noindent\begin{longtable}{lp{10cm}} +\textit{Macro} & \textit{Default} \\ +\ci{figurename} & Figure \\ +\ci{tablename} & Table \\ +\ci{partname} & Part \\ +\ci{appendixname} & Appendix \\ +\ci{equationname} & Equation \\ +\ci{Itemname} & item \\ +\ci{Chaptername} & chapter \\ +\ci{sectionname} & section \\ +\ci{subsectionname} & subsection \\ +\ci{subsubsectionname} & subsubsection \\ +\ci{paragraphname} & paragraph \\ +\ci{Hfootnotename} & footnote \\ +\ci{AMSname} & Equation \\ +\ci{theoremname} & Theorem +\end{longtable} + +For instances where you want a reference to use the correct counter, but +not to create a link, there are two starred forms: + +\begin{cmdsyntax} +\ci{ref*}\verb|{|\emph{label}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{pageref*}\verb|{|\emph{label}\verb|}| +\end{cmdsyntax} + +A typical use would be to write +\begin{verbatim} +\hyperref[other]{that nice section (\ref*{other}) we read before} +\end{verbatim} + +We want \verb|\ref*{other}| to generate the correct number, but not to +form a link, since we do this ourselves with \ci{hyperref}. + +\begin{cmdsyntax} +\ci{pdfstringdef}\verb|{|\emph{macroname}\verb|}{|\emph{\TeX string}\verb|}| +\end{cmdsyntax} + +\ci{pdfstringdef} returns a macro containing the PDF string. (Currently +this is done globally, but do not rely on it.) All the following tasks, +definitions and redefinitions are made in a group to keep them local: + +\begin{itemize} +\item Switching to PD1 or PU encoding +\item Defining the \Quote{octal sequence commands} (\verb|\345|): \verb|\edef\3{\string\3}| +\item Special glyphs of \TeX: \verb|\{|, \verb|\%|, \verb|\&|, \verb|\space|, \verb|\dots|, etc. +\item National glyphs (\textsf{german.sty}, \textsf{french.sty}, etc.) +\item Logos: \verb|\TeX|, \verb|\eTeX|, \verb|\MF|, etc. +\item Disabling commands that do not provide useful functionality in bookmarks: +\verb|\label|, \verb|\index|, \verb|\glossary|, \verb|\discretionary|, \verb|\def|, \verb|\let|, etc. +\item \LaTeX's font commands like \verb|\textbf|, etc. +\item Support for \verb|\xspace| provided by the \textsf{xspace} package +\end{itemize} + +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}. + + +\subsection{Replacement macros} + +\textsf{hyperref} takes the text for bookmarks from the arguments of +commands like \ci{section}, which can contain things like math, colors, +or font changes, none of which will display in bookmarks as is. + +\begin{cmdsyntax} +\ci{texorpdfstring}\verb|{|\emph{\TeX string}\verb|}{|\emph{PDFstring}\verb|}| +\end{cmdsyntax} + +For example, +\begin{verbatim} +\section{Pythagoras: +\texorpdfstring{$ a^2 + b^2 = c^2 $}{% +a\texttwosuperior\ + b\texttwosuperior\ = +c\texttwosuperior}} +\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars} +\end{verbatim} + +\ci{pdfstringdef} executes the hook \pdfstringdefPreHook before it +expands the string. Therefore, you can use this hook to perform +additional tasks or to disable additional commands. + +\begin{verbatim} +\expandafter\def\expandafter\pdfstringdefPreHook +\expandafter{% +\pdfstringdefPreHook +\renewcommand{\mycommand}[1]{}% +} +\end{verbatim} + +However, for disabling commands, an easier way is via +\ci{pdfstringdefDisableCommands}, which adds its argument to the +definition of \ci{pdfstringdefPreHook} (`@' can here be used as letter in +command names): + +\begin{verbatim} +\pdfstringdefDisableCommands{% +\let~\textasciitilde +\def\url{\pdfstringdefwarn\url}% +\let\textcolor\@gobble +} +\end{verbatim} + + +\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: + +\begin{cmdsyntax} +\ci{Acrobatmenu}\verb|{|\emph{menuoption}\verb|}{|\emph{text}\verb|}| +\end{cmdsyntax} + +\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}} +File & Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, Print, PageSetup, Quit \\ +File$\rightarrow$Import & ImportImage, ImportNotes, AcroForm:ImportFDF \\ +File$\rightarrow$Export & ExportNotes, AcroForm:ExportFDF \\ +File$\rightarrow$DocumentInfo & GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, Weblink:Base, AutoIndex:DocInfo \\ +File$\rightarrow$Preferences & GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, AcroSearch:Preferences(Windows) + or, AcroSearch:Prefs(Mac), Cpt:Capture \\ +Edit & Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, TouchUp:TextAttributes, + TouchUp:FitTextToSelection, TouchUp:ShowLineMarkers, TouchUp:ShowCaptureSuspects, + TouchUp:FindSuspect, \\ + & Properties \\ +Edit$\rightarrow$Fields & AcroForm:Duplicate, AcroForm:TabOrder \\ +Document & Cpt:CapturePages, AcroForm:Actions, CropPages, RotatePages, InsertPages, ExtractPages, + ReplacePages, DeletePages, NewBookmark, SetBookmarkDest, CreateAllThumbs, + DeleteAllThumbs \\ +View & ActualSize, FitVisible, FitWidth, FitPage, ZoomTo, FullScreen, FirstPage, PrevPage, + NextPage, LastPage, GoToPage, GoBack, GoForward, SinglePage, OneColumn, TwoColumns, + ArticleThreads, PageOnly, ShowBookmarks, ShowThumbs \\ +Tools & Hand, ZoomIn, ZoomOut, SelectText, SelectGraphics, Note, Link, Thread, AcroForm:Tool, + Acro\_Movie:MoviePlayer, TouchUp:TextTool, Find, FindAgain, FindNextNote, + CreateNotesFile \\ +Tools$\rightarrow$Search & AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, AcroSrch:Assist, AcroSrch:PrevDoc, + AcroSrch:PrevHit, AcroSrch:NextHit, AcroSrch:NextDoc \\ +Window & ShowHideToolBar, ShowHideMenuBar, ShowHideClipboard, Cascade, TileHorizontal, + TileVertical, CloseAll \\ +Help & HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, HelpCapture, HelpPDFWriter, + HelpDistiller, HelpSearch, HelpCatalog, HelpReader, Weblink:Home \\ +Help(Windows) & About +\end{longtable} + +\section{PDF and HTML forms} +You must put your fields inside a \texttt{Form} environment (only one per file). + +There are six macros to prepare fields: + +\begin{cmdsyntax} +\ci{TextField}\verb|[|\emph{parameters}\verb|]{|\emph{label}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{CheckBox}\verb|[|\emph{parameters}\verb|]{|\emph{label}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{ChoiceMenu}\verb|[|\emph{parameters}\verb|]{|\emph{label}\verb|}{|\emph{choices}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{PushButton}\verb|[|\emph{parameters}\verb|]{|\emph{label}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{Submit}\verb|[|\emph{parameters}\verb|]{|\emph{label}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{Reset}\verb|[|\emph{parameters}\verb|]{|\emph{label}\verb|}| +\end{cmdsyntax} + +The way forms and their labels are laid out is determined by: +\begin{cmdsyntax} +\ci{LayoutTextField}\verb|{|\emph{label}\verb|}{|\emph{field}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{LayoutChoiceField}\verb|{|\emph{label}\verb|}{|\emph{field}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{LayoutCheckboxField}\verb|{|\emph{label}\verb|}{|\emph{field}\verb|}| +\end{cmdsyntax} + +These macros default to \#1 \#2 + +What is actually shown in as the field is determined by: +\begin{cmdsyntax} +\ci{MakeRadioField}\verb|{|\emph{width}\verb|}{|\emph{height}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{MakeCheckField}\verb|{|\emph{width}\verb|}{|\emph{height}\verb|}| +\end{cmdsyntax} +\begin{cmdsyntax} +\ci{MakeTextField}\verb|{|\emph{width}\verb|}{|\emph{height}\verb|}| +\end{cmdsyntax} +\begin{cmdsyntax} +\ci{MakeChoiceField}\verb|{|\emph{width}\verb|}{|\emph{height}\verb|}| +\end{cmdsyntax} + +\begin{cmdsyntax} +\ci{MakeButtonField}\verb|{|\emph{text}\verb|}| +\end{cmdsyntax} + +These macros default to \verb|\vbox to #2{\hbox to #1{\hfill}\vfill}|, except the +last, which defaults to \#1; it is used for buttons, and the special \ci{Submit} and \ci{Reset} +macros. + +You may also want to redefine the following macros: +\begin{verbatim} +\def\DefaultHeightofSubmit{12pt} +\def\DefaultWidthofSubmit{2cm} +\def\DefaultHeightofReset{12pt} +\def\DefaultWidthofReset{2cm} +\def\DefaultHeightofCheckBox{0.8\baselineskip} +\def\DefaultWidthofCheckBox{0.8\baselineskip} +\def\DefaultHeightofChoiceMenu{0.8\baselineskip} +\def\DefaultWidthofChoiceMenu{0.8\baselineskip} +\def\DefaultHeightofText{\baselineskip} +\def\DefaultWidthofText{3cm} +\end{verbatim} + +\subsection{Forms environment parameters} + +\smallskip\noindent\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 \\ +method & name & Used only when generating HTML; values can be \texttt{post} or \texttt{get} \\ +\end{longtable} + +\subsection{Forms optional parameters} +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} +accesskey & key & & (as per HTML) \\ +align & number & 0 & alignment within text field; 0 is left-aligned, \\ + & & & 1 is centered, 2 is right-aligned. \\ +backgroundcolor & & & color of box \\ +bordercolor & & & color of border \\ +bordersep & & & box border gap \\ +borderwidth & & & width of box border \\ +calculate & & & JavaScript code to calculate the value of the field \\ +charsize & dimen & & font size of field text \\ +checked & boolean & false & whether option selected by default \\ +color & & & color of text in box \\ +combo & boolean & false & choice list is `combo' style \\ +default & & & default value \\ +disabled & boolean & false & field disabled \\ +format & & & JavaScript code to format the field \\ +height & dimen & & height of field box \\ +hidden & boolean & false & field hidden \\ +ketstroke & & & JavaScript code to control the keystrokes on entry \\ +maxlen & number & 0 & number of characters allowed in text field \\ +menulength & number & 4 & number of elements shown in list \\ +multiline & boolean & false & whether text box is multiline \\ +name & name & & name of field (defaults to label) \\ +onblur & & & JavaScript code \\ +onchange & & & JavaScript code \\ +onclick & & & JavaScript code \\ +ondblclick & & & JavaScript code \\ +onfocus & & & JavaScript code \\ +onkeydown & & & JavaScript code \\ +onkeypress & & & JavaScript code \\ +onkeyup & & & JavaScript code \\ +onmousedown & & & JavaScript code \\ +onmousemove & & & JavaScript code \\ +onmouseout & & & JavaScript code \\ +onmouseover & & & JavaScript code \\ +onmouseup & & & JavaScript code \\ +onselect & & & JavaScript code \\ +password & boolean & false & text field is `password' style \\ +popdown & boolean & false & choice list is `popdown' style \\ +radio & boolean & false & choice list is `radio' style \\ +readonly & boolean & false & field is readonly \\ +tabkey & & & (as per HTML) \\ +validate & & & JavaScript code to validate the entry \\ +value & & & initial value \\ +width & dimen & & width of field box +\end{longtable} + +\section{Defining a new driver} +A hyperref driver has to provide definitions for eight macros: + +\smallskip +\noindent 1. \verb|\hyper@anchor| + +\noindent 2. \verb|\hyper@link| + +\noindent 3. \verb|\hyper@linkfile| + +\noindent 4. \verb|\hyper@linkurl| + +\noindent 5. \verb|\hyper@anchorstart| + +\noindent 6. \verb|\hyper@anchorend| + +\noindent 7. \verb|\hyper@linkstart| + +\noindent 8. \verb|\hyper@linkend| +\smallskip + +The draft option defines the macros as follows +\qquad\begin{verbatim} +\let\hyper@@anchor\@gobble +\gdef\hyper@link##1##2##3{##3}% +\def\hyper@linkurl##1##2{##1}% +\def\hyper@linkfile##1##2##3{##1}% +\let\hyper@anchorstart\@gobble +\let\hyper@anchorend\@empty +\let\hyper@linkstart\@gobbletwo +\let\hyper@linkend\@empty +\end{verbatim} + +\section{Special support for other packages} + +\textsf{hyperref} aims to cooperate with other packages, but there are +several possible sources for conflict, such as + +\begin{itemize} + +\item Packages that manipulate the bibliographic mechanism. Peter +William's \textsf{harvard} package is supported. However, the +recommended package is Patrick Daly's \textsf{natbib} package that has +specific \textsf{hyperref} hooks to allow reliable interaction. This +package covers a very wide variety of layouts and citation styles, all +of which work with \textsf{hyperref}. + +\item Packages that typeset the contents of the \ci{label} and \ci{ref} +macros, such as \textsf{showkeys}. Since the \textsf{hyperref} package +redefines these commands, you must set \texttt{implicit=false} for these +packages to work. + +\item Packages that do anything serious with the index. +\end{itemize} + +The \textsf{hyperref} package is distributed with variants on two useful +packages designed to work especially well with it. These are \textsf{xr} +and \textsf{minitoc}, which support crossdocument links using \LaTeX's +normal \verb|\label/\ref| mechanisms and per-chapter tables of contents, +respectively. + +\section{History and acknowledgments} + +The original authors of \textsf{hyperbasics.tex} and +\textsf{hypertex.sty}, from which this package descends, are Tanmoy +Bhattacharya (\texttt{tanmoy@qcd.lanl.gov}) and Thorsten Ohl +\linebreak(\texttt{thorsten.ohl@physik.th-darmstadt.de}). \textsf{hyperref} +started as a simple port of their work to \LaTeXe\ standards, but +eventually I rewrote nearly everything, because I didn't understand a +lot of the original, and was only interested in getting it to work with +\LaTeX. I would like to thank Arthur Smith, Tanmoy Bhattacharya, Mark +Doyle, Paul Ginsparg, David Carlisle, T.\ V.\ Raman and Leslie Lamport +for comments, requests, thoughts and code to get the package into its +first useable state. Various other people are mentioned at the point in +the source where I had to change the code in later versions because of +problems they found. + +Tanmoy found a great many of the bugs, and (even better) often provided +fixes, which has made the package more robust. The days spent on +Rev\TeX\ are entirely due to him! The investigations of Bill Moss +(\texttt{bmoss@math.clemson.edu}) into the later versions including +native PDF support uncovered a good many bugs, and his testing is +appreciated. Hans Hagen (\texttt{pragma@pi.net}) provided a lot of +insight into PDF. + +Berthold Horn provided help, encouragement and sponsorship for the +\textsf{dvipsone} and \textsf{dviwindo} drivers. Sergey Lesenko provided +the changes needed for \textsf{dvipdf}, and \Hanh{} supplied all the +information needed for \textsf{pdftex}. Patrick Daly kindly updated his +\textsf{natbib} package to allow easy integration with +\textsf{hyperref}. Michael Mehlich's \textsf{hyper} package (developed +in parallel with \textsf{hyperref}) showed me solutions for some +problems. Hopefully the two packages will combine one day. + +The forms creation section owes a great deal to: T.\ V.\ Raman, for +encouragement, support and ideas; Thomas Merz, whose book \emph{Web +Publishing with Acrobat/PDF} provided crucial insights; D.\ P.\ Story, +whose detailed article about pdfmarks and forms solved many practical +problems; and Hans Hagen, who explained how to do it in \textsf{pdftex}. + +Steve Dandy recreated the manual source in July 2003 after it had been +lost. + +Especial extra thanks to David Carlisle for the \textsf{backref} module, +the ps2pdf and dviwindo support, frequent general rewrites of my bad +code, and for working on changes to the \textsf{xr} package to suit +\textsf{hyperref}. + +\begingroup + \makeatletter + \let\chapter=\section + % subsections goes into bookmarks but not toc + \hypersetup{bookmarksopenlevel=1} + \addtocontents{toc}{\protect\setcounter{tocdepth}{1}} + % The \section command acts as \subsection. + % Additionally the title is converted to lowercase except + % for the first letter. + \def\section{% + \let\section\lc@subsection + \lc@subsection + } + \def\lc@subsection{% + \@ifstar{\def\mystar{*}\lc@sec}% + {\let\mystar\@empty\lc@sec}% + } + \def\lc@sec#1{% + \lc@@sec#1\@nil + } + \def\lc@@sec#1#2\@nil{% + \begingroup + \def\a{#1}% + \lowercase{% + \edef\x{\endgroup + \noexpand\subsection\mystar{\a#2}% + }% + }% + \x + } + \include{fdl} +\endgroup + +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/manual2.html b/Master/texmf-dist/doc/latex/hyperref/manual2.html new file mode 100644 index 00000000000..cb6254858ef --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual2.html @@ -0,0 +1,17 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title> </title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<!-- html --> +<meta name="src" content="manual.tex"> +<meta name="date" content="2004-02-12 15:16:00"> +<link rel="stylesheet" type="text/css" href="manual.css"> +</head><body +> + <!--l. 141--><p class="noindent"> <a + id="x2-2001f1"></a>This is borrowed from an article by Arthur Smith. + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/manual3.html b/Master/texmf-dist/doc/latex/hyperref/manual3.html new file mode 100644 index 00000000000..6909f811d63 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/manual3.html @@ -0,0 +1,20 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head><title> </title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> +<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> +<!-- html --> +<meta name="src" content="manual.tex"> +<meta name="date" content="2004-02-12 15:16:00"> +<link rel="stylesheet" type="text/css" href="manual.css"> +</head><body +> + <!--l. 203--><p class="noindent"> <a + id="x3-2002f2"></a>Make sure you turn off the partial font downloading supported by <span +class="ecss-1000">dvips </span>and <span +class="ecss-1000">dvipsone </span>in favor of + Distiller’s own system. + +</body></html> diff --git a/Master/texmf-dist/doc/latex/hyperref/options.tex b/Master/texmf-dist/doc/latex/hyperref/options.tex new file mode 100644 index 00000000000..c24bc62a688 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/options.tex @@ -0,0 +1,103 @@ +\documentclass{article} +\usepackage{array,longtable,pslatex} +\title{hyperref package options} +\author{Sebastian Rahtz} +%\date{October 7th 1999} +\date{April 14th 2003}% HO +\newcommand{\optempty}{{\rmfamily\textit{empty}}} +\newcommand*{\for}[1]{{\rmfamily(#1)}} +\begin{document} +\maketitle +\begin{longtable}{>{\ttfamily}lp{5cm}>{\ttfamily}l} +\hline +a4paper &use A4 paper\\ +a5paper &use A5 paper\\ +anchorcolor &set color of anchors&black\\ +b5paper &use B5 paper\\ +backref &do bibliographical back references&false\\ +baseurl &set base URL for document&\optempty\\ +bookmarks &make bookmarks&true\\ +bookmarksnumbered &put section numbers in bookmarks&false\\ +bookmarksopen &open up bookmark tree&false\\ +bookmarksopenlevel &level to which bookmarks are open&\string\maxdimen\\ +bookmarkstype &to specify which `toc' file to mimic&toc\\ +breaklinks &allow links to break over lines&false\\ +citebordercolor &color of border around cites& 0 1 0\\ +citecolor &color of citation links&green\\ +colorlinks &color links&false\\ +&&true \for{tex4ht, dviwindo}\\ +debug &provide details of anchors defined&false\\ +&same as verbose&\\ +draft &do not do any hyper linking&false\\ +dvipdf &use dvipdf backend\\ +dvipdfm &use dvipdfm backend\\ +dvips &use dvips backend\\ +dvipsone &use dvipsone backend\\ +dviwindo &use dviwindo backend\\ +encap &to set encap character for hyperindex\\ +executivepaper &use executivepaper\\ +extension &suffix of linked files&dvi\\ +filebordercolor &color of border around file links& 0 .5 .5\\ +filecolor &color of file links&cyan\\ +final &opposite of option draft&true\\ +frenchlinks &use small caps instead of color for links&false\\ +hyperfigures &make figures hyper links&false\\ +hyperindex &set up hyperlinked indices&true\\ +hypertex &use HyperTeX backend\\ +hypertexnames &use guessable names for links&true\\ +implicit &redefine \LaTeX\ internals&true\\ +latex2html &use \LaTeX2HTML backend\\ +legalpaper &use legalpaper\\ +letterpaper &use letterpaper\\ +linkbordercolor &color of border around links& 1 0 0\\ +linkcolor &color of links&red\\ +linktocpage &make page number, not text, be link on TOC, LOF and LOT&false\\ +menubordercolor &color of border around menu links& 1 0 0\\ +menucolor &color for menu links&red\\ +naturalnames &use \LaTeX-computed names for links&false\\ +nesting &allow nesting of links&false\\ +pageanchor &put an anchor on every page&true\\ +pagebackref &backreference by page number&false\\ +pagebordercolor &color of border around page links& 1 1 0\\ +pagecolor &color of page links&red\\ +pdfauthor &text for PDF Author field&\optempty\\ +pdfborder &width of PDF link border&0 0 1\\ +&&0 0 0 \for{colorlinks}\\ +pdfcenterwindow &position the document window center of the screen&false\\ +pdfcreator &text for PDF Creator field&LaTeX with hyperref package\\ +pdfdisplaydoctitle &display document title instead of file name in title bar&true\\ +pdffitwindow &resize document window to fit document size&false\\ +pdfhighlight &set highlighting of PDF links& /I\\ +pdfkeywords &text for PDF Keywords field&\optempty\\ +pdfmenubar &make PDF viewer's menu bar visible&true\\ +pdfnewwindow &make links that open another PDF file start a new window&false\\ +pdfnonfullscreenpagemode &page mode setting on exiting full-screen mode&\optempty\\ +pdfpagelayout &set layout of PDF pages&\optempty\\ +pdfpagemode &set default mode of PDF display&\optempty\\ +pdfpagelabels &set PDF page labels&false\\ +pdfpagescrop &set crop size of PDF document&\optempty\\ +pdfpagetransition &set PDF page transition style&\optempty\\ +pdfproducer &text for PDF Producer field&\optempty\\ +pdfstartpage &page at which PDF document opens&1\\ +pdfstartview &starting view of PDF document& /Fit\\ +pdfsubject &text for PDF Subject field&\optempty\\ +pdftex &use pdf\TeX\ backend\\ +pdftitle &text for PDF Title field&\optempty\\ +pdftoolbar &make PDF toolbar visible&true\\ +pdfview &PDF `view' when on link traversal&\optempty\\ +pdfwindowui &make PDF user interface elements visible&true\\ +plainpages &do page number anchors as plain arabic&true\\ +ps2pdf &use ps2pdf backend\\ +raiselinks &raise up links (for HyperTeX backend)&false\\ +runbordercolor &color of border around `run' links& 0 .7 .7\\ +setpagesize &set page size by special driver commands&true\\ +tex4ht &use \TeX4ht backend\\ +textures &use Textures backend\\ +unicode &Unicode encoded pdf strings\\ +urlbordercolor &color of border around URL links& 0 1 1\\ +urlcolor &color of URL links&magenta\\ +verbose &be chatty&false\\ +vtex &use V\TeX\ backend\\ +vtexpdfmark &use backend for V\TeX\ in PDF/PS mode (pdfmark specials)\hline +\end{longtable} +\end{document}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/hyperref/paper.pdf b/Master/texmf-dist/doc/latex/hyperref/paper.pdf Binary files differnew file mode 100644 index 00000000000..2568cf56429 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/paper.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/slides.pdf b/Master/texmf-dist/doc/latex/hyperref/slides.pdf Binary files differnew file mode 100644 index 00000000000..173a80dbdab --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/slides.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/test/Makefile b/Master/texmf-dist/doc/latex/hyperref/test/Makefile new file mode 100644 index 00000000000..8b39cd2ecb2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/Makefile @@ -0,0 +1,5 @@ +all: + (for i in test*.tex; do pdflatex $$i;pdflatex $$i; done) + +clean: + -rm test*pdf *.aux *.log *.toc *.lof *.lot *.idx *.ind *.out diff --git a/Master/texmf-dist/doc/latex/hyperref/test/bit.tex b/Master/texmf-dist/doc/latex/hyperref/test/bit.tex new file mode 100644 index 00000000000..9e5b4fedbaf --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/bit.tex @@ -0,0 +1,2 @@ +sssssssss +\newpage diff --git a/Master/texmf-dist/doc/latex/hyperref/test/bml.png b/Master/texmf-dist/doc/latex/hyperref/test/bml.png Binary files differnew file mode 100644 index 00000000000..ad526156bb0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/bml.png diff --git a/Master/texmf-dist/doc/latex/hyperref/test/bmoe.png b/Master/texmf-dist/doc/latex/hyperref/test/bmoe.png Binary files differnew file mode 100644 index 00000000000..faa115cf772 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/bmoe.png diff --git a/Master/texmf-dist/doc/latex/hyperref/test/bmsc.png b/Master/texmf-dist/doc/latex/hyperref/test/bmsc.png Binary files differnew file mode 100644 index 00000000000..0990c5fe85c --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/bmsc.png diff --git a/Master/texmf-dist/doc/latex/hyperref/test/bmyi.png b/Master/texmf-dist/doc/latex/hyperref/test/bmyi.png Binary files differnew file mode 100644 index 00000000000..8e7e1ecb472 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/bmyi.png diff --git a/Master/texmf-dist/doc/latex/hyperref/test/bmzc.png b/Master/texmf-dist/doc/latex/hyperref/test/bmzc.png Binary files differnew file mode 100644 index 00000000000..a1652a85eae --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/bmzc.png diff --git a/Master/texmf-dist/doc/latex/hyperref/test/hog.eps b/Master/texmf-dist/doc/latex/hyperref/test/hog.eps new file mode 100644 index 00000000000..7e685f8b489 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/hog.eps @@ -0,0 +1,463 @@ +%!PS-Adobe-2.0 EPSF-2.0 +%%Title: h.eps +%%Creator: fig2dev Version 3.2 Patchlevel 1a +%%CreationDate: Mon Jul 19 12:28:51 1999 +%%For: rahtz@spqr (Sebastian Rahtz,,,) +%%Orientation: Portrait +%%BoundingBox: 0 0 251 213 +%%Pages: 0 +%%BeginSetup +%%EndSetup +%%Magnification: 1.0000 +%%EndComments +/MyAppDict 100 dict dup begin def +/$F2psDict 200 dict def +$F2psDict begin +$F2psDict /mtrx matrix put +/col-1 {0 setgray} bind def +/col0 {0.000 0.000 0.000 srgb} bind def +/col1 {0.000 0.000 1.000 srgb} bind def +/col2 {0.000 1.000 0.000 srgb} bind def +/col3 {0.000 1.000 1.000 srgb} bind def +/col4 {1.000 0.000 0.000 srgb} bind def +/col5 {1.000 0.000 1.000 srgb} bind def +/col6 {1.000 1.000 0.000 srgb} bind def +/col7 {1.000 1.000 1.000 srgb} bind def +/col8 {0.000 0.000 0.560 srgb} bind def +/col9 {0.000 0.000 0.690 srgb} bind def +/col10 {0.000 0.000 0.820 srgb} bind def +/col11 {0.530 0.810 1.000 srgb} bind def +/col12 {0.000 0.560 0.000 srgb} bind def +/col13 {0.000 0.690 0.000 srgb} bind def +/col14 {0.000 0.820 0.000 srgb} bind def +/col15 {0.000 0.560 0.560 srgb} bind def +/col16 {0.000 0.690 0.690 srgb} bind def +/col17 {0.000 0.820 0.820 srgb} bind def +/col18 {0.560 0.000 0.000 srgb} bind def +/col19 {0.690 0.000 0.000 srgb} bind def +/col20 {0.820 0.000 0.000 srgb} bind def +/col21 {0.560 0.000 0.560 srgb} bind def +/col22 {0.690 0.000 0.690 srgb} bind def +/col23 {0.820 0.000 0.820 srgb} bind def +/col24 {0.500 0.190 0.000 srgb} bind def +/col25 {0.630 0.250 0.000 srgb} bind def +/col26 {0.750 0.380 0.000 srgb} bind def +/col27 {1.000 0.500 0.500 srgb} bind def +/col28 {1.000 0.630 0.630 srgb} bind def +/col29 {1.000 0.750 0.750 srgb} bind def +/col30 {1.000 0.880 0.880 srgb} bind def +/col31 {1.000 0.840 0.000 srgb} bind def + +end +save +-191.0 342.0 translate +1 -1 scale +.9 .9 scale % to make patterns same scale as in xfig + +% This junk string is used by the show operators +/PATsstr 1 string def +/PATawidthshow { % cx cy cchar rx ry string + % Loop over each character in the string + { % cx cy cchar rx ry char + % Show the character + dup % cx cy cchar rx ry char char + PATsstr dup 0 4 -1 roll put % cx cy cchar rx ry char (char) + false charpath % cx cy cchar rx ry char + /clip load PATdraw + % Move past the character (charpath modified the + % current point) + currentpoint % cx cy cchar rx ry char x y + newpath + moveto % cx cy cchar rx ry char + % Reposition by cx,cy if the character in the string is cchar + 3 index eq { % cx cy cchar rx ry + 4 index 4 index rmoveto + } if + % Reposition all characters by rx ry + 2 copy rmoveto % cx cy cchar rx ry + } forall + pop pop pop pop pop % - + currentpoint + newpath + moveto +} bind def +/PATcg { + 7 dict dup begin + /lw currentlinewidth def + /lc currentlinecap def + /lj currentlinejoin def + /ml currentmiterlimit def + /ds [ currentdash ] def + /cc [ currentrgbcolor ] def + /cm matrix currentmatrix def + end +} bind def +% PATdraw - calculates the boundaries of the object and +% fills it with the current pattern +/PATdraw { % proc + save exch + PATpcalc % proc nw nh px py + 5 -1 roll exec % nw nh px py + newpath + PATfill % - + restore +} bind def +% PATfill - performs the tiling for the shape +/PATfill { % nw nh px py PATfill - + PATDict /CurrentPattern get dup begin + setfont + % Set the coordinate system to Pattern Space + PatternGState PATsg + % Set the color for uncolored pattezns + PaintType 2 eq { PATDict /PColor get PATsc } if + % Create the string for showing + 3 index string % nw nh px py str + % Loop for each of the pattern sources + 0 1 Multi 1 sub { % nw nh px py str source + % Move to the starting location + 3 index 3 index % nw nh px py str source px py + moveto % nw nh px py str source + % For multiple sources, set the appropriate color + Multi 1 ne { dup PC exch get PATsc } if + % Set the appropriate string for the source + 0 1 7 index 1 sub { 2 index exch 2 index put } for pop + % Loop over the number of vertical cells + 3 index % nw nh px py str nh + { % nw nh px py str + currentpoint % nw nh px py str cx cy + 2 index show % nw nh px py str cx cy + YStep add moveto % nw nh px py str + } repeat % nw nh px py str + } for + 5 { pop } repeat + end +} bind def + +% PATkshow - kshow with the current pattezn +/PATkshow { % proc string + exch bind % string proc + 1 index 0 get % string proc char + % Loop over all but the last character in the string + 0 1 4 index length 2 sub { + % string proc char idx + % Find the n+1th character in the string + 3 index exch 1 add get % string proe char char+1 + exch 2 copy % strinq proc char+1 char char+1 char + % Now show the nth character + PATsstr dup 0 4 -1 roll put % string proc chr+1 chr chr+1 (chr) + false charpath % string proc char+1 char char+1 + /clip load PATdraw + % Move past the character (charpath modified the current point) + currentpoint newpath moveto + % Execute the user proc (should consume char and char+1) + mark 3 1 roll % string proc char+1 mark char char+1 + 4 index exec % string proc char+1 mark... + cleartomark % string proc char+1 + } for + % Now display the last character + PATsstr dup 0 4 -1 roll put % string proc (char+1) + false charpath % string proc + /clip load PATdraw + neewath + pop pop % - +} bind def +% PATmp - the makepattern equivalent +/PATmp { % patdict patmtx PATmp patinstance + exch dup length 7 add % We will add 6 new entries plus 1 FID + dict copy % Create a new dictionary + begin + % Matrix to install when painting the pattern + TilingType PATtcalc + /PatternGState PATcg def + PatternGState /cm 3 -1 roll put + % Check for multi pattern sources (Level 1 fast color patterns) + currentdict /Multi known not { /Multi 1 def } if + % Font dictionary definitions + /FontType 3 def + % Create a dummy encoding vector + /Encoding 256 array def + 3 string 0 1 255 { + Encoding exch dup 3 index cvs cvn put } for pop + /FontMatrix matrix def + /FontBBox BBox def + /BuildChar { + mark 3 1 roll % mark dict char + exch begin + Multi 1 ne {PaintData exch get}{pop} ifelse % mark [paintdata] + PaintType 2 eq Multi 1 ne or + { XStep 0 FontBBox aload pop setcachedevice } + { XStep 0 setcharwidth } ifelse + currentdict % mark [paintdata] dict + /PaintProc load % mark [paintdata] dict paintproc + end + gsave + false PATredef exec true PATredef + grestore + cleartomark % - + } bind def + currentdict + end % newdict + /foo exch % /foo newlict + definefont % newfont +} bind def +% PATpcalc - calculates the starting point and width/height +% of the tile fill for the shape +/PATpcalc { % - PATpcalc nw nh px py + PATDict /CurrentPattern get begin + gsave + % Set up the coordinate system to Pattern Space + % and lock down pattern + PatternGState /cm get setmatrix + BBox aload pop pop pop translate + % Determine the bounding box of the shape + pathbbox % llx lly urx ury + grestore + % Determine (nw, nh) the # of cells to paint width and height + PatHeight div ceiling % llx lly urx qh + 4 1 roll % qh llx lly urx + PatWidth div ceiling % qh llx lly qw + 4 1 roll % qw qh llx lly + PatHeight div floor % qw qh llx ph + 4 1 roll % ph qw qh llx + PatWidth div floor % ph qw qh pw + 4 1 roll % pw ph qw qh + 2 index sub cvi abs % pw ph qs qh-ph + exch 3 index sub cvi abs exch % pw ph nw=qw-pw nh=qh-ph + % Determine the starting point of the pattern fill + %(px, py) + 4 2 roll % nw nh pw ph + PatHeight mul % nw nh pw py + exch % nw nh py pw + PatWidth mul exch % nw nh px py + end +} bind def + +% Save the original routines so that we can use them later on +/oldfill /fill load def +/oldeofill /eofill load def +/oldstroke /stroke load def +/oldshow /show load def +/oldashow /ashow load def +/oldwidthshow /widthshow load def +/oldawidthshow /awidthshow load def +/oldkshow /kshow load def + +% These defs are necessary so that subsequent procs don't bind in +% the originals +/fill { oldfill } bind def +/eofill { oldeofill } bind def +/stroke { oldstroke } bind def +/show { oldshow } bind def +/ashow { oldashow } bind def +/widthshow { oldwidthshow } bind def +/awidthshow { oldawidthshow } bind def +/kshow { oldkshow } bind def +/PATredef { + MyAppDict begin + { + /fill { /clip load PATdraw newpath } bind def + /eofill { /eoclip load PATdraw newpath } bind def + /stroke { PATstroke } bind def + /show { 0 0 null 0 0 6 -1 roll PATawidthshow } bind def + /ashow { 0 0 null 6 3 roll PATawidthshow } + bind def + /widthshow { 0 0 3 -1 roll PATawidthshow } + bind def + /awidthshow { PATawidthshow } bind def + /kshow { PATkshow } bind def + } { + /fill { oldfill } bind def + /eofill { oldeofill } bind def + /stroke { oldstroke } bind def + /show { oldshow } bind def + /ashow { oldashow } bind def + /widthshow { oldwidthshow } bind def + /awidthshow { oldawidthshow } bind def + /kshow { oldkshow } bind def + } ifelse + end +} bind def +false PATredef +% Conditionally define setcmykcolor if not available +/setcmykcolor where { pop } { + /setcmykcolor { + 1 sub 4 1 roll + 3 { + 3 index add neg dup 0 lt { pop 0 } if 3 1 roll + } repeat + setrgbcolor - pop + } bind def +} ifelse +/PATsc { % colorarray + aload length % c1 ... cn length + dup 1 eq { pop setgray } { 3 eq { setrgbcolor } { setcmykcolor + } ifelse } ifelse +} bind def +/PATsg { % dict + begin + lw setlinewidth + lc setlinecap + lj setlinejoin + ml setmiterlimit + ds aload pop setdash + cc aload pop setrgbcolor + cm setmatrix + end +} bind def + +/PATDict 3 dict def +/PATsp { + true PATredef + PATDict begin + /CurrentPattern exch def + % If it's an uncolored pattern, save the color + CurrentPattern /PaintType get 2 eq { + /PColor exch def + } if + /CColor [ currentrgbcolor ] def + end +} bind def +% PATstroke - stroke with the current pattern +/PATstroke { + countdictstack + save + mark + { + currentpoint strokepath moveto + PATpcalc % proc nw nh px py + clip newpath PATfill + } stopped { + (*** PATstroke Warning: Path is too complex, stroking + with gray) = + cleartomark + restore + countdictstack exch sub dup 0 gt + { { end } repeat } { pop } ifelse + gsave 0.5 setgray oldstroke grestore + } { pop restore pop } ifelse + newpath +} bind def +/PATtcalc { % modmtx tilingtype PATtcalc tilematrix + % Note: tiling types 2 and 3 are not supported + gsave + exch concat % tilingtype + matrix currentmatrix exch % cmtx tilingtype + % Tiling type 1 and 3: constant spacing + 2 ne { + % Distort the pattern so that it occupies + % an integral number of device pixels + dup 4 get exch dup 5 get exch % tx ty cmtx + XStep 0 dtransform + round exch round exch % tx ty cmtx dx.x dx.y + XStep div exch XStep div exch % tx ty cmtx a b + 0 YStep dtransform + round exch round exch % tx ty cmtx a b dy.x dy.y + YStep div exch YStep div exch % tx ty cmtx a b c d + 7 -3 roll astore % { a b c d tx ty } + } if + grestore +} bind def +/PATusp { + false PATredef + PATDict begin + CColor PATsc + end +} bind def + +% right45 +11 dict begin +/PaintType 1 def +/PatternType 1 def +/TilingType 1 def +/BBox [0 0 1 1] def +/XStep 1 def +/YStep 1 def +/PatWidth 1 def +/PatHeight 1 def +/Multi 2 def +/PaintData [ + { clippath } bind + { 32 32 true [ 32 0 0 -32 0 32 ] + {<010101010202020204040404080808081010101020202020 + 404040408080808001010101020202020404040408080808 + 101010102020202040404040808080800101010102020202 + 040404040808080810101010202020204040404080808080 + 010101010202020204040404080808081010101020202020 + 4040404080808080>} + imagemask } bind +] def +/PaintProc { + pop + exec fill +} def +currentdict +end +/P5 exch def +1.1111 1.1111 scale %restore scale + +/cp {closepath} bind def +/ef {eofill} bind def +/gr {grestore} bind def +/gs {gsave} bind def +/sa {save} bind def +/rs {restore} bind def +/l {lineto} bind def +/m {moveto} bind def +/rm {rmoveto} bind def +/n {newpath} bind def +/s {stroke} bind def +/sh {show} bind def +/slc {setlinecap} bind def +/slj {setlinejoin} bind def +/slw {setlinewidth} bind def +/srgb {setrgbcolor} bind def +/rot {rotate} bind def +/sc {scale} bind def +/sd {setdash} bind def +/ff {findfont} bind def +/sf {setfont} bind def +/scf {scalefont} bind def +/sw {stringwidth} bind def +/tr {translate} bind def +/tnt {dup dup currentrgbcolor + 4 -2 roll dup 1 exch sub 3 -1 roll mul add + 4 -2 roll dup 1 exch sub 3 -1 roll mul add + 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} + bind def +/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul + 4 -2 roll mul srgb} bind def + /DrawEllipse { + /endangle exch def + /startangle exch def + /yrad exch def + /xrad exch def + /y exch def + /x exch def + /savematrix mtrx currentmatrix def + x y tr xrad yrad sc 0 0 1 startangle endangle arc + closepath + savematrix setmatrix + } def + +/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def +/$F2psEnd {$F2psEnteredState restore end} def +%%EndProlog + +$F2psBegin +10 setmiterlimit +n -1000 6429 m -1000 -1000 l 8005 -1000 l 8005 6429 l cp clip n + 0.06299 0.06299 sc +% Polyline +7.500 slw +n 3060 2070 m 6975 2070 l 6975 5400 l 3060 5400 l cp gs /PC [[0.00 0.82 0.00] [0.00 0.00 0.00]] def +15.00 15.00 sc P5 [16 0 0 -16 204.00 138.00] PATmp PATsp ef gr PATusp gs col0 s gr +/Times-Roman ff 420.00 scf sf +3330 2880 m +gs 1 -1 sc (Hogwarts) col6 sh gr +45.000 slw +% Ellipse +n 5760 4410 1215 990 0 360 DrawEllipse gs col5 1.00 shd ef gr gs col11 s gr + +$F2psEnd +rs +end diff --git a/Master/texmf-dist/doc/latex/hyperref/test/hog.pdf b/Master/texmf-dist/doc/latex/hyperref/test/hog.pdf Binary files differnew file mode 100644 index 00000000000..c298340675d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/hog.pdf diff --git a/Master/texmf-dist/doc/latex/hyperref/test/phys1.jpg b/Master/texmf-dist/doc/latex/hyperref/test/phys1.jpg Binary files differnew file mode 100644 index 00000000000..7a30e6019dd --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/phys1.jpg diff --git a/Master/texmf-dist/doc/latex/hyperref/test/phys2.jpg b/Master/texmf-dist/doc/latex/hyperref/test/phys2.jpg Binary files differnew file mode 100644 index 00000000000..98d503f3de1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/phys2.jpg diff --git a/Master/texmf-dist/doc/latex/hyperref/test/picture.eps b/Master/texmf-dist/doc/latex/hyperref/test/picture.eps new file mode 100644 index 00000000000..0be39ee9b1d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/picture.eps @@ -0,0 +1,311 @@ +%!PS-Adobe-2.0 EPSF-2.0 +%%PDFready: TeXUtil 6.5 - ConTeXt / PRAGMA 1992-1998 +%%BoundingBox: 0 0 36 34 +<< /PageSize [36 34] >> setpagedevice +gsave -44 -525 translate +%%Creator: COREL DRAW +%%Title: CAT.TMP +%%CreationDate: Sat Jan 18 17:29:05 1992 + +%%DocumentFonts: +%%EndComments +%%BeginProlog +% -------------- POSTSCRIPT PROLOG FOR CORELDRAW 2.X ------ +% Copyright Corel Systems Corporation 1990 +/AutoFlatness 0 def/wCorelDict 300 dict def +wCorelDict begin/bd{bind def}bind def/ld{load def}bd +/xd{exch def}bd/_ null def/$c 0 def/$m 0 def +/$y 0 def/$k 0 def/$t 1 def/$n _ def/$o 0 def +/$fil 0 def/$C 0 def/$M 0 def/$Y 0 def/$K 0 def +/$T 1 def/$N _ def/$O 0 def/$PF false def +/$pan 0 def/$h false def/$al 0 def/$tr 0 def +/$le 0 def/$lx 0 def/$ly 0 def/$ctm matrix currentmatrix def +/$ptm matrix def/$ttm matrix def/$stm matrix def +/$skm matrix def/$fst 128 def/$pad 0 def/$rox 0 def +/$roy 0 def currentscreen/@dsp xd/$dsp/@dsp def +/$dsa xd/$dsf xd/$sdf false def/$SDF false def +/$Scra 0.0 def statusdict/pageparams known{statusdict begin +pageparams end 1 ne{/$Scra -90.0 def}if pop pop pop}if +/$sv 0 def/@cp/closepath ld/@gs/gsave ld/@gr/grestore ld +/@np/newpath ld/@sv{/$sv save def}bd/@rs{$sv restore}bd +/@ss{load setscreen}bd AutoFlatness 1 eq{/$cpx ([Error: PathTooComplex; OffendingCommand: AnyPaintingOperator;\n) def +/@err1{$cpx print flush newpath}bd/@ifl{currentflat dup 10 gt{pop @err1 exit}if 2 add setflat}bd +/@fill/fill ld/fill{currentflat{{@fill}stopped{@ifl}{exit}ifelse}bind loop setflat}bd +/@eofill/eofill ld/eofill{currentflat{{@eofill}stopped{@ifl}{exit}ifelse}bind loop setflat}bd +/@clip/clip ld/clip{currentflat{{@clip}stopped{initclip @ifl}{exit}ifelse}bind loop setflat}bd +/@eoclip/eoclip ld/eoclip{currentflat{{@eoclip}stopped{initclip @ifl}{exit}ifelse}bind loop setflat}bd +/@stroke/stroke ld/stroke{currentflat{{@stroke}stopped{@ifl}{exit}ifelse}bind loop setflat}bd +}if/InRange{3 -1 roll 2 copy le{pop}{exch pop}ifelse +2 copy ge{pop}{exch pop}ifelse}bd/wDstChck{2 1 roll dup 3 -1 roll +eq{1 add}if}bd/@dot{dup mul exch dup mul add 1 exch sub 2 div}bd +/@lin{exch pop abs 1 exch sub}bd/@MN{2 copy le{pop}{exch pop}ifelse}bd +/setcmykcolor where{pop}{/setcmykcolor{4 1 roll +3{3 index add 1 @MN 1 exch sub 3 1 roll}repeat +setrgbcolor pop}bd}ifelse/colorimage where{pop}{/colorimage{/$ncl xd +pop pop pop pop{currentfile $dat readhexstring pop}repeat +pop}bd}ifelse/@tc{dup 1 ge{pop}{4{dup 6 -1 roll +mul exch}repeat pop}ifelse}bd/@spc{7 2 roll +ColorSeparationMode 1 eq{6 index @tc 0 4 $ink sub index +exch pop}{5 index dup _ eq{pop 0 4 $ink sub index +exch pop}{CurrentInkName eq{6 index}{0}ifelse}ifelse}ifelse +5 1 roll 8 -2 roll 6{pop}repeat 1 exch sub dup setgray +1 eq exch 1 eq and not}bd/@scc{$ink -1 eq +{$c $m $y $k $t @tc setcmykcolor true}{$o $c $m $y $k $t $n @spc +}ifelse}bd/@SCC{$ink -1 eq{$C $M $Y $K $T @tc setcmykcolor true}{ +$O $C $M $Y $K $T $N @spc}ifelse}bd/@sft{ +/$tx $tllx $pxf add dup $tllx gt{$pwid sub}if def +/$ty $tury $pyf sub dup $tury lt{$phei add}if def}bd +/@stb{pathbbox/$ury xd/$urx xd/$lly xd/$llx xd}bd +/@ep{{cvx exec}forall}bd/@tp{@sv/$in true def +2 copy dup $lly le{/$in false def}if $phei sub $ury ge{/$in false def}if +dup $urx ge{/$in false def}if $pwid add $llx le{/$in false def}if +$in{@np 2 copy moveto $pwid 0 rlineto 0 $phei neg rlineto +$pwid neg 0 rlineto 0 $phei rlineto clip @np +$pn cvlit load aload pop 7 -1 roll 5 index sub +7 -1 roll 3 index sub translate/$ctm matrix currentmatrix def +@ep pop pop pop pop}{pop pop}ifelse @rs}bd/@th{@sft +0 1 $tly 1 sub{dup $psx mul $tx add{dup $llx gt{$pwid sub}{exit}ifelse +}loop exch $phei mul $ty exch sub 0 1 $tlx 1 sub{$pwid mul +3 copy 3 -1 roll add exch @tp pop}for pop pop}for}bd +/@tv{@sft 0 1 $tlx 1 sub{dup $pwid mul $tx add +exch $psy mul $ty exch sub{dup $ury lt{$phei add}{exit}ifelse}loop +0 1 $tly 1 sub{$phei mul 3 copy sub @tp pop}for +pop pop}for}bd/@pf{@gs $ctm setmatrix $pm concat +@stb @gs ColorSeparationMode 0 eq{1 setgray eofill}{ +$o 0 0 0 0 0 (Black) @spc{eofill}if}ifelse +@gr eoclip Bburx Bbury $pm itransform/$tury xd/$turx xd +Bbllx Bblly $pm itransform/$tlly xd/$tllx xd +/$wid $turx $tllx sub def/$hei $tury $tlly sub def +$wid 0 gt $hei 0 gt and{$pn cvlit load aload pop +/$pd xd 3 -1 roll sub/$phei xd exch sub/$pwid xd +/$tlx $wid $pwid div ceiling 1 add def/$tly $hei $phei div ceiling 1 add def +$psx 0 eq{@tv}{@th}ifelse}if @gr @np}bd/@dlt{ColorSeparationMode 0 eq{ +/$dc $toc $tot mul $frc $frt mul dup/$c xd sub $fst 1 sub div def +/$dm $tom $tot mul $frm $frt mul dup/$m xd sub $fst 1 sub div def +/$dy $toy $tot mul $fry $frt mul dup/$y xd sub $fst 1 sub div def +/$dk $tok $tot mul $frk $frt mul dup/$k xd sub $fst 1 sub div def +true}{$o $frc $frm $fry $frk $frt $frn @spc +dup{/$frk 1 currentgray sub def}{/$frk 0 def}ifelse +$o $toc $tom $toy $tok $tot $ton @spc dup{/$tok 1 currentgray sub def} +{/$tok 0 def}ifelse or dup{/$c 0 def/$m 0 def/$y 0 def/$k $frk def +/$dc 0 def/$dm 0 def/$dy 0 def/$dk $tok $frk sub $fst 1 sub div def}if +}ifelse}bd/@ftl{1 index 4 index sub dup $pad mul dup/$pdw xd +2 mul sub $fst div/$wid xd 2 index sub/$hei xd +pop translate $c $m $y $k 4 copy ColorSeparationMode 0 ne +{1 exch sub setgray pop pop pop}{setcmykcolor}ifelse +0 0 moveto 0 $hei lineto $pdw $hei lineto $pdw 0 lineto 0 0 lineto fill +$pdw 0 translate $fst{4 copy ColorSeparationMode 0 ne +{1 exch sub setgray pop pop pop}{setcmykcolor}ifelse +0 0 moveto 0 $hei lineto $wid $hei lineto $wid 0 lineto 0 0 lineto fill +$wid 0 translate $dk add 4 1 roll $dy add 4 1 roll +$dm add 4 1 roll $dc add 4 1 roll}repeat $dk sub 4 1 roll +$dy sub 4 1 roll $dm sub 4 1 roll $dc sub 4 1 roll +ColorSeparationMode 0 ne{1 exch sub setgray pop pop pop} +{setcmykcolor}ifelse 0 0 moveto 0 $hei lineto $pdw $hei lineto $pdw 0 lineto 0 0 lineto fill +}bd/@ftr{1 index 4 index sub dup $rox mul/$row xd +2 div 1 index 4 index sub dup $roy mul/$roh xd +2 div 2 copy dup mul exch dup mul add sqrt +$row dup mul $roh dup mul add sqrt add dup/$hei xd $fst div/$wid xd +4 index add $roh add exch 5 index add $row add +exch translate pop pop pop pop currentflat 5 mul setflat +$c $m $y $k 4 copy ColorSeparationMode 0 ne +{1 exch sub setgray pop pop pop}{setcmykcolor}ifelse +$wid 0 moveto 0 0 $hei 0 360 arc fill 1.0 $pad 2 mul sub dup scale +$fst{4 copy ColorSeparationMode 0 ne{1 exch sub setgray pop pop pop} +{setcmykcolor}ifelse $wid 0 moveto 0 0 $hei 0 360 arc fill +/$hei $hei $wid sub def $dk add 4 1 roll $dy add 4 1 roll +$dm add 4 1 roll $dc add 4 1 roll}repeat pop pop pop pop}bd +/@ff{@gs @dlt{$ctm setmatrix eoclip newpath Bbllx Bblly moveto +Bbllx Bbury lineto Bburx Bbury lineto Bburx Bblly lineto +$fan rotate pathbbox newpath $fty 1 eq{@ftr}{@ftl}ifelse}if +@gr @np}bd/@Pf{@sv ColorSeparationMode 0 eq $ink 3 eq or{$ctm setmatrix +72 1000 div dup matrix scale dup concat dup Bburx exch Bbury exch itransform +ceiling cvi/Bbury xd ceiling cvi/Bburx xd Bbllx exch Bblly exch itransform +floor cvi/Bblly xd floor cvi/Bbllx xd $Prm aload pop +$Psn load exec}{1 setgray eofill}ifelse @rs +@np}bd/@ftx{{(0) dup 3 -1 roll 0 exch put +@gs true charpath currentpoint $ctm setmatrix +@@txt @gr @np moveto $tr 0 rmoveto}forall pop}bd +/@sm{/$ctm $ctm currentmatrix def}bd/@lorg{$lx $ly moveto +/$ly $ly $le sub def}bd/@ft{matrix currentmatrix 3 1 roll +$sdf{$scf $sca $scp @ss}if $fil 1 eq{/@@txt/@pf ld @ftx}{$fil 2 eq +{/@@txt/@ff ld @ftx}{$fil 3 eq{/@@txt/@Pf ld @ftx}{@scc +{dup $tr exch 0 exch ashow}if pop pop}ifelse}ifelse}ifelse +$sdf{$dsf $dsa $dsp @ss}if setmatrix}bd/@st{ +matrix currentmatrix 3 1 roll $SDF{$SCF $SCA $SCP @ss}if +@SCC{{(0) dup 3 -1 roll 0 exch put @gs true charpath currentpoint +$ctm setmatrix $ptm concat stroke @gr moveto $tr 0 rmoveto}forall +pop}{pop pop}ifelse $SDF{$dsf $dsa $dsp @ss}if +setmatrix}bd/@pt{dup length exch}bd/@te{@pt +@lorg @ft cleartomark [}bd/@tr{@pt @lorg @st cleartomark [}bd +/@ta{@pt @lorg 2 copy @gs @ft @gr @st cleartomark [}bd +/@t@a{@pt @lorg 2 copy @gs @st @gr @ft cleartomark [}bd +/g{1 exch sub/$k xd/$c 0 def/$m 0 def/$y 0 def/$t 1 def/$n _ def/$fil 0 def +}bd/G{1 exch sub/$K xd/$C 0 def/$M 0 def/$Y 0 def/$T 1 def/$N _ def}bd +/k{/$k xd/$y xd/$m xd/$c xd/$t 1 def/$n _ def/$fil 0 def}bd +/K{/$K xd/$Y xd/$M xd/$C xd/$T 1 def/$N _ def}bd +/x{1 exch sub/$t xd/$n xd/$k xd/$y xd/$m xd/$c xd/$fil 0 def}bd +/X{1 exch sub/$T xd/$N xd/$K xd/$Y xd/$M xd/$C xd}bd +/d/setdash ld/i{dup 0 ne{setflat}{pop}ifelse}bd +/j/setlinejoin ld/J/setlinecap ld/M/setmiterlimit ld +/w/setlinewidth ld/O{/$o xd}bd/R{/$O xd}bd +/c/curveto ld/C/c ld/v{4 -2 roll 2 copy 6 -2 roll curveto}bd +/V/v ld/y{2 copy curveto}bd/Y/y ld/l/lineto ld +/L/l ld/m/moveto ld/n/newpath ld/N/newpath ld +/F{matrix currentmatrix $sdf{$scf $sca $scp @ss}if +$fil 1 eq{@pf}{$fil 2 eq{@ff}{$fil 3 eq{@Pf}{@scc{eofill}{@np}ifelse +}ifelse}ifelse}ifelse $sdf{$dsf $dsa $dsp @ss}if +setmatrix}bd/f{@cp F}bd/S{matrix currentmatrix +$ctm setmatrix $SDF{$SCF $SCA $SCP @ss}if @SCC{$skm currentmatrix +$ptm concat stroke setmatrix}{@np}ifelse $SDF{$dsf $dsa $dsp @ss}if +setmatrix}bd/s{@cp S}bd/B{@gs F @gr S}bd/b{@cp B}bd +/W{eoclip}bd/p{/$pm xd 7{pop}repeat/$pyf xd/$pxf xd +/$pn xd/$fil 1 def}bd/P{11{pop}repeat}bd/z{/$al xd +/$tr xd/$le xd exch findfont exch scalefont setfont}bd +/Z{dup type 0 type eq{/$bDir xd}if findfont +dup maxlength 1 add dict exch dup{1 index/FID ne{3 index +3 1 roll put}{pop pop}ifelse}forall pop dup dup/Encoding get +256 array copy dup/$fe xd/Encoding exch put +dup/Fontname 3 index put 3 -1 roll dup length 0 ne{0 exch{ +dup type 0 type eq{exch pop}{$fe exch 2 index exch put +1 add}ifelse}forall pop}if definefont pop}bd +/e{@sm concat [/t{@te}def}bd/r{@sm concat [/t{@tr}def}bd +/o{@sm concat [/t{pop}def}bd/a{@sm concat [/t{@ta}def}bd +/t{@te}def/T{cleartomark @np/$lx 0 def/$ly 0 def +$ctm setmatrix/$ttm matrix def}bd/u{}bd/U{}bd +/A{pop}bd/H{/$h true def}bd/h{@cp H}bd/q/@gs ld +/Q/@gr ld/E{5 array astore exch cvlit exch def}bd +/`{}bd/~{}bd/@{}bd/&{}bd/CorelDrawRencodeVect [ +16#80/grave/circumflex/tilde/dotlessi/florin/quotedblleft/quotedblright/guilsinglleft +16#88/guilsinglright/fi/fl/dagger/daggerdbl/endash/periodcentered/breve +16#90/quotedblbase/ellipsis/perthousand/trademark/Pt/fractionbar +16#98/divide 16#a1/exclamdown/cent/sterling/currency/yen/bar/section +16#a8/dieresis/copyright/ordfeminine/guillemotleft/logicalnot/emdash/registered/overbar +16#b0/ring/plusminus/twosuperior/threesuperior/acute/mu/paragraph/bullet +16#b8/cedilla/onesuperior/ordmasculine/guillemotright/onequarter/onehalf/threequarters/questiondown +16#c0/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE/Ccedilla +16#c8/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex/Idieresis +16#d0/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis/OE +16#d8/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn/germandbls +16#e0/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla +16#e8/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis +16#f0/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/oe +16#f8/oslash/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis +] def/@cc{currentfile $dat readhexstring pop}bd +/@ii{concat 3 index 3 index m 3 index 1 index l +2 copy l 1 index 3 index l 3 index 3 index l +clip pop pop pop pop}bd/@E{/Bbury xd/Bburx xd +/Bblly xd/Bbllx xd}bd/@c{@cp}bd/@p{/$fil 1 def +/$pm xd/$psy xd/$psx xd/$pyf xd/$pxf xd/$pn xd}bd +/@P{/$fil 3 def/$Psn xd array astore/$Prm xd}bd +/@k{/$fil 2 def/$roy xd/$rox xd/$pad xd/$fty xd/$fan xd +$fty 1 eq{/$fan 0 def}if/$tok xd/$toy xd/$tom xd/$toc xd +/$frk xd/$fry xd/$frm xd/$frc xd/$frn _ def/$frt 1 def/$ton _ def/$tot 1 def +}bd/@x{/$fil 2 def/$roy xd/$rox xd/$pad xd +/$fty xd/$fan xd 1 exch sub/$tot xd/$ton xd/$tok xd/$toy xd/$tom xd/$toc xd +1 exch sub/$frt xd/$frn xd/$frk xd/$fry xd/$frm xd/$frc xd}bd +/@i{@sm @gs @ii 5 index 1 ne{@gs 1 g F @gr}if +1 eq 5 index 1 eq and{@gs $ctm setmatrix F @gr}if +@np/$ury xd/$urx xd/$lly xd/$llx xd/$bts xd +/$hei xd/$wid xd/$dat $wid $bts mul 8 div ceiling cvi string def +$bts 1 eq{@SCC/$frg xd}{1 G @SCC/$frg xd}ifelse +$frg{$SDF{$SCF $SCA $SCP @ss}if $llx $lly translate +$urx $llx sub $ury $lly sub scale $wid $hei abs +$bts 1 eq{false}{$bts}ifelse [ $wid 0 0 $hei neg 0 +$hei 0 gt{$hei}{0}ifelse]/@cc load $bts 1 eq{imagemask}{image}ifelse +$SDF{$dsf $dsa $dsp @ss}if}{$hei{@cc pop}repeat}ifelse +@gr $ctm setmatrix}def/@M {@sv}bd/@N{/@cc{}def +12 -1 roll neg 12 1 roll @i @rs}bd/@I{@sm @gs +@ii @np/$ury xd/$urx xd/$lly xd/$llx xd/$ncl xd +/$bts xd/$hei xd/$wid xd/$dat $wid $bts mul $ncl mul 8 div ceiling cvi string def +$llx $lly translate $urx $llx sub $ury $lly sub scale +$wid $hei $bts [ $wid 0 0 $hei neg 0 $hei]/@cc load +false $ncl colorimage @gr $ctm setmatrix}bd +/@t{/$lx 0 def/$ly 0 def/$stm $stm currentmatrix def +3 1 roll translate $ttm concat 1 exch t $stm setmatrix}def +/@n{/$ttm exch matrix rotate def}bd/@z{ exch findfont exch scalefont setfont +}bd/@s{}bd/@l{}bd/@B{@gs S @gr F}bd/@b{@cp @B}bd +/@a{@sm concat [/t{@t@a}def}bd/@w{5 2 roll dup/$pan xd +matrix rotate/$ptm xd matrix scale $ptm dup concatmatrix/$ptm xd +1 eq{$ptm exch dup concatmatrix/$ptm xd}{pop}ifelse +1 w}bd/@g{1 eq dup/$sdf xd{/$scp xd/$sca xd +/$scf xd}if}bd/@G{1 eq dup/$SDF xd{/$SCP xd +/$SCA xd/$SCF xd}if}bd/@D{3 copy @ss/$dsp xd +/$dsa xd/$dsf xd}bd/@j{@sv @np}bind def/@J{@rs}bind def +/@sep{/ColorSeparationMode where{pop}{/ColorSeparationMode 0 def +/CurrentInkName (Composite) def}ifelse ColorSeparationMode 0 eq +{/CurrentInkName (Composite) def}if/CurrentInkName where{pop}{ +/CurrentInkName (Composite) def}ifelse CurrentInkName (Composite) eq{/$ink -1 def} +{CurrentInkName (Cyan) eq{/$ink 0 def} {CurrentInkName (Magenta) eq{/$ink 1 def} +{CurrentInkName (Yellow) eq{/$ink 2 def} {CurrentInkName (Black) eq{/$ink 3 def} +{/$ink 4 def}ifelse}ifelse}ifelse}ifelse}ifelse}bd +@sep/@whi{@gs -72000 dup moveto -72000 72000 lineto +72000 dup lineto 72000 -72000 lineto closepath 1 setgray fill +@gr}bd/@neg{ [{1 exch sub}/exec cvx currenttransfer/exec cvx] cvx settransfer +@whi}bd/@reg{[] 0 d 0 setgray .3 setlinewidth +2 copy 5.4 0 360 arc closepath 2 copy moveto 9 0 rlineto +2 copy moveto -9 0 rlineto 2 copy moveto 0 9 rlineto +moveto 0 -9 rlineto stroke}bd/leftbracket{(\050)}def +/rightbracket{(\051)}def + +%%EndProlog +%%BeginSetup +11.4737 setmiterlimit +1.00 setflat +/$fst 128 def + +%%EndSetup +@sv +/$ctm matrix currentmatrix def +u +%%Note: Object +45.22 528.19 78.98 558.14 @E +0 J 0 j [] 0 d 0 R 0 @G +0.00 0.00 0.00 1.00 K +1.01 1.01 0.00 [1.00000 0.00000 0.00000 1.00000 0.00000 0.00000] 0 @w +%%CURV 106 +73.30 539.78 m +73.08 538.42 72.22 537.26 71.78 536.33 C +72.79 534.67 73.73 531.43 74.81 530.64 C +74.59 530.64 77.04 528.84 73.87 529.06 C +73.08 529.34 73.08 530.93 70.20 533.81 C +69.70 533.74 70.56 530.57 71.50 529.63 c +73.15 528.19 70.27 528.55 70.13 528.62 C +68.98 529.34 68.62 534.60 67.03 536.26 c +66.24 537.19 65.16 536.98 64.30 536.90 C +63.22 536.62 60.62 537.19 60.55 534.02 C +60.62 532.66 62.14 530.21 62.86 529.78 c +65.30 528.41 62.06 528.34 61.70 528.77 C +61.13 529.34 60.19 530.64 59.26 531.65 C +57.74 532.44 56.38 533.66 56.02 534.96 C +54.94 534.74 53.86 534.17 53.64 533.23 C +53.42 532.22 53.86 531.58 54.86 530.14 C +56.02 529.85 56.38 529.27 56.02 528.98 c +55.87 528.84 53.71 528.62 53.57 528.91 C +52.70 529.49 51.70 531.86 51.19 533.16 c +50.90 533.88 49.97 535.82 51.55 537.77 C +51.98 538.49 51.91 539.86 51.77 540.65 c +51.55 541.94 51.55 542.74 52.42 544.46 C +49.75 546.77 45.22 551.23 49.61 557.14 C +50.11 557.64 51.55 558.14 50.76 556.27 C +49.82 553.68 46.66 551.45 53.42 546.19 C +54.50 546.91 58.97 546.48 60.48 546.19 c +64.66 545.33 65.52 545.33 68.40 546.05 C +68.76 546.19 68.83 547.99 70.34 549.22 C +70.06 550.15 72.00 551.45 72.22 552.53 C +72.65 553.39 73.66 550.73 73.66 550.66 C +73.58 551.23 74.66 552.31 74.81 552.96 C +75.74 553.25 75.10 550.94 75.89 549.50 c +76.32 548.93 76.68 549.07 77.11 547.70 C +77.47 546.34 78.98 545.18 76.54 543.89 c +75.17 543.17 74.59 543.31 73.58 542.88 C +73.58 542.23 73.51 540.79 73.30 539.78 c +@c +S +U +@rs +%%Trailer + end +grestore +%%EOF +%%RestOfFileIgnored: TeXUtil 6.5 - ConTeXt / PRAGMA 1992-1998 diff --git a/Master/texmf-dist/doc/latex/hyperref/test/picture.pdf b/Master/texmf-dist/doc/latex/hyperref/test/picture.pdf new file mode 100644 index 00000000000..d175f9668ca --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/picture.pdf @@ -0,0 +1,93 @@ +%PDF-1.2 +%Çì¢ +4 0 obj +<</Length 5 0 R>> +stream +0.1 0 0 0.1 0 0 cm +q +1 i +10.1 w +11.4737 M +293 147.8 m +290.8 134.2 282.2 122.6 277.8 113.3 c +287.9 96.6997 297.3 64.2998 308.1 56.4001 c +305.9 56.4001 330.4 38.4001 298.7 40.5999 c +290.8 43.4001 290.8 59.2998 262 88.0999 c +257 87.3999 265.6 55.7 275 46.3 c +291.5 31.8999 262.7 35.4998 261.3 36.2 c +249.8 43.4001 246.2 95.9998 230.3 112.6 c +222.4 121.9 211.6 119.8 203 119 c +192.2 116.2 166.2 121.9 165.5 90.2002 c +166.2 76.5996 181.4 52.1001 188.6 47.8003 c +213 34.0996 180.6 33.4001 177 37.7002 c +171.3 43.4001 161.9 56.4001 152.6 66.5002 c +137.4 74.3999 123.8 86.5996 120.2 99.6001 c +109.4 97.3999 98.5999 91.6997 96.3999 82.2998 c +94.2 72.1997 98.5999 65.8 108.6 51.4001 c +120.2 48.4998 123.8 42.7002 120.2 39.7998 c +118.7 38.4001 97.0999 36.2 95.7 39.0996 c +87 44.8999 77 68.5999 71.8999 81.5996 c +69 88.8 59.7 108.2 75.4998 127.7 c +79.7998 134.9 79.0999 148.6 77.7 156.5 c +75.4998 169.4 75.4998 177.4 84.2 194.6 c +57.5 217.7 12.2 262.3 56.0999 321.4 c +61.0999 326.4 75.4998 331.4 67.5999 312.7 c +58.2 286.8 26.5999 264.5 94.2 211.9 c +105 219.1 149.7 214.8 164.8 211.9 c +206.6 203.3 215.2 203.3 244 210.5 c +247.6 211.9 248.3 229.9 263.4 242.2 c +260.6 251.5 280 264.5 282.2 275.3 c +286.5 283.9 296.6 257.3 296.6 256.6 c +295.8 262.3 306.6 273.1 308.1 279.6 c +317.4 282.5 311 259.4 318.9 245 c +323.2 239.3 326.8 240.7 331.1 227 c +334.7 213.4 349.8 201.8 325.4 188.9 c +311.7 181.7 305.9 183.1 295.8 178.8 c +295.8 172.3 295.1 157.9 293 147.8 c +s +Q +endstream +endobj +5 0 obj +1446 +endobj +3 0 obj +<< +/Type /Page +/MediaBox [0 0 36 34] +/Parent 2 0 R +/Resources << /ProcSet [/PDF] +>> +/Contents 4 0 R +>> +endobj +2 0 obj +<< /Type /Pages /Kids [ +3 0 R +] /Count 1 +>> +endobj +1 0 obj +<< /Type /Catalog /Pages 2 0 R +>> +endobj +6 0 obj +<< /CreationDate (D:19980613150900) +/Producer (Aladdin Ghostscript 5.10) +>> +endobj +xref +0 7 +0000000000 65535 f +0000001708 00000 n +0000001649 00000 n +0000001531 00000 n +0000000015 00000 n +0000001511 00000 n +0000001757 00000 n +trailer +<< /Size 7 /Root 1 0 R /Info 6 0 R +>> +startxref +1848 +%%EOF diff --git a/Master/texmf-dist/doc/latex/hyperref/test/picture.png b/Master/texmf-dist/doc/latex/hyperref/test/picture.png Binary files differnew file mode 100644 index 00000000000..86686ca5896 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/picture.png diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test0.tex b/Master/texmf-dist/doc/latex/hyperref/test/test0.tex new file mode 100644 index 00000000000..154d103518b --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test0.tex @@ -0,0 +1,99 @@ +\documentclass[]{article} +\def\thepage{E\arabic{page}} +\usepackage{color,graphicx} +\usepackage{lastpage} +\usepackage{xspace} +\usepackage{makeidx} +\usepackage{amsmath} +\usepackage[pdflinkmargin=5pt,pdfstartview={FitBH -32768},pdfpagemode=None,plainpages=false]{hyperref} +%\usepackage[screen,article]{pdfscreen} +\hypersetup{pdfauthor=?`\c C\"asar M\"uller n\~ao!`} +\setcounter{tocdepth}{4} +\setcounter{secnumdepth}{4} +\makeindex +\hypersetup{pdftitle=Welcome to the Monkey House} +\newcommand{\ANS}{\textsf{ANSYS}\xspace} +\begin{document} +\tableofcontents +\section*{Abstract} +\addtocontents{toc}{\protect\addvspace{10pt}} +\addcontentsline{toc}{section}{\protect\numberline{}{ABSTRACT}} +\section{A first, simple, section heading} +And some text +\section{A funny \ANS-section with a \texorpdfstring{$\log$}{log}} +Page 1; See \textcolor{red}{page} --\pageref{page2}-- +\newpage +Page 2; this is page 2\label{page2} +\newpage +\index{an item on page 3} + +\htmladdnormallink{A dummy URL}{http://www.tug.org/A-Fake_URL.html} + +\Acrobatmenu{Quit}{End Acrobat Reader} + +\Acrobatmenu{FullScreen}{Switch to full screen} + +\Acrobatmenu{ZoomIn}{Zoom in} + +$\int\!dx$ +\section{Yet another ?`\c C\"asar M\"uller n\~ao!`} + +\section{Testing Int\'ernal J\oe mps}\label{ss:intjmps} + +This is some text and this is a \hypertarget{target}{target}. + +\newpage + +Now lets jump to \hyperlink{target}{Target}. + +Let's try going to Section~\ref{ss:intjmps} + +\section{A \ss ection with $\leq$} +xx +xx +\subsubsection{A subsubsection \texorpdfstring{$a+b$}{a+b}} +xx +\paragraph{A paragraph} +xx +\subparagraph{A subparagraph} +xxx +Pictures: + +Normal \includegraphics{hog} + +Scaled 0.75 \includegraphics[scale=0.75]{hog} + +Width 1in height 0.5in + \includegraphics[width=1in,height=0.5in]{hog} + +Rotated 50 \includegraphics[scale=0.5,angle=50]{hog} + +Rotated -50 \includegraphics[scale=0.5,angle=-50]{hog} + + +\section{Testing External Jumps}\label{ss:extjmps} + +\begin{enumerate} + +\item Jump to an external: The jump +\href{file:test7#TestTarget}{target} should open test7.pdf on +page 2, +\item Jump to an external: The jump +\href{file:test7#page.1}{page 1} should open test7.pdf on +page 1. + +%\item Jump to an relative external strange file +%\href{/D/srahtz/skills.doc}{destination} + +\href{run:picture.eps}{a PS file to launch} + +\href{run:fontman.exe}{an application} + +\href{run:e:\string\\mdraw\string\\mdraw.exe#picture.eps}{a PS file to launch (2)} +\end{enumerate} +\printindex +\clearpage +\end{document} + + + diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test1.tex b/Master/texmf-dist/doc/latex/hyperref/test/test1.tex new file mode 100644 index 00000000000..f1894597fee --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test1.tex @@ -0,0 +1,328 @@ +\documentclass[11pt]{book} +\makeatletter +\def\listoffigures{\@restonecolfalse\if@twocolumn\@restonecoltrue\onecolumn\fi +\chapter*{List of Figures} +{\let\\ \ \markboth{Title}{List of Figures}} +\addcontentsline{toc}{chapter}{\protect + \numberline{}LIST OF FIGURES}\@starttoc{lof}\if@restonecol \twocolumn\fi} +\makeatother +\usepackage{epsfig,longtable} +\usepackage{makeidx} +\usepackage{varioref} +\usepackage{xr-hyper} +\usepackage{amsmath} +\usepackage[verbose,hypertexnames=false,bookmarksopenlevel=1,bookmarksopen,bookmarksnumbered,colorlinks,plainpages=false,linktocpage]{hyperref} +\def\boldindex#1{\textbf{\hyperpage{#1}}} +\makeindex +\makeatletter +\externaldocument{test2} +\makeatother +%\setcounter{page}{34} +\title{Testing Hyperref} +\author{Sebastian Rahtz} +\date{May 1999} +\setcounter{secnumdepth}{2} +\setcounter{tocdepth}{1} +\begin{document} +\pagenumbering{roman} +% +\makeatletter +\long\def\hyper@section@backref#1#2#3{% + \typeout{BACK REF #1 / #2 / #3}% +\hyperlink{#3}{#2}} +% +\makeatother +\pdfbookmark{Title}{tit} +\setlongtables +\maketitle\index{title} +\tableofcontents +\listoftables +\listoffigures +\pagenumbering{arabic} +\newcommand{\eqnref}[1]{{\autoref{#1}}} +\newtheorem{Argument}{Here we go}[section] +\def\thesubsection{\Roman{section} -- \arabic{subsection}} +\setcounter{tocdepth}{1} + +\chapter[First part]{First part, leading to \protect\autoref{horrid} + next} +\section[Test section]{Our \protect\LaTeX\ test section (leading to \autoref{One}) + for 100\% of \AE horrid $X[Y]Z$ +things, like $42$\label{horrid}} +and so see \autoref{horrid} on page \pageref{horrid}. + +\section{Section One --- cats}\label{One} +see section \vref{Three} about +cats\index{animals!cats} and cite +\cite{Barcelo:1992:caa} + +\section{one.1 -- can we see} +some text with a footnote\footnote{WISH UPON A STAR} +and another one with an extended +footnote\footnote{\protect\label{foot}This is the way the world ends not with a + bang but a whimper. This is the way the world ends not with a + bang but a whimper. This is the way the world ends not with a + bang but a whimper.} +and a reference to a long table\index{tables!long!longtables}, +\autoref{mylongtab}. + +\subsection{one.2} +dogs + +\href{file:test2#page.2}{See page 2 in file test2}, +on page 3 of this file. + +\href{file:test2.pdf#page.2}{See page 2 in file test2.pdf} +on page 3 of this file. + +And can we see \autoref{ss:first} + +in the file test2.pdf? alternatively, +\href{file:test2.pdf#subsection.1.2}{the link like this} + +All Or this? \url{test2.pdf#section.1} + +\newpage +\section{Section Two --- \TeX\ is a dog} +\subsection{two.1} +\subsection{two.2} +\newpage +cite \cite{Barcelo:1992:caa} again. + +\chapter{Second part} +\section{Section Three --- Camels}\label{Three} +see \autoref{One} +\subsection{three.1} + some text with a footnote\footnote{OVER THE RAINBOW} +\index{rainbows} +\subsection{three.2} + +\newpage +\section[Section Four --- Butterflies]{Section Four --- Butterflies and so on} +\subsection{four.1} +\subsection{four.2} +camels +Refer to \hyperref{}{test}{test1}{with these words} +\newpage +\section{Introduction}\label{sec1} +\subsection{subsec} +\newpage +\subsection{subsec}\label{subsec1.2} +Define a marker \hyperdef{test}{test1}{here} while this one is a +PostScript picture acting as marker: +\index{PS pictures} +\hyperlink{testpiccy}{\epsfig{figure=picture,height=1in}} + +This is a picture: \epsfig{figure=picture,height=1in} +\newpage +\section{two}\label{sec2} +\subsection{Subsection 2} +\subsection{Subsection 3} +\newpage +\section{three} +This is a reference to section 1 (\autoref{sec1}), subsection 1.2 +(\autoref{subsec1.2}) and section 2 (\autoref{sec2}). References to +\cite{Barcelo:1992:caa,Dallas:aia}. + + +\begin{figure} + +xxxx + +\hypertarget{testpiccy}{Test picture} + +xxxxx + +xxxxx +\caption{{A cat}} +\label{fig1} +\end{figure} + +\begin{figure} + +xxxx + +xxxxx +\caption{Another cat with a link inside it, +so see \cite{Dallas:aia} xxxx \label{fig2}} +\end{figure} + +\texttt{<<where is \eqnref{eq1}>>} + +\section{Some URLs} + +\begin{minipage}{1.5in} +\url{http://www.aw.com/cp/tlgc.html#Describe} + +\url{http://nsi.net.kiae.su/latex/latex2e.html} + +\url{http://www.lehigh.edu/~dlj0/LyriX.html} + +\url{http://www.cs.wisc.edu/~ghost/index.html} + +\url{http://www.win.tue.nl/win/math/dw/personalpages/dickie/idvi/} + +\url{http://www.tug.org/interest.html#projects} + +\url{ftp://ftp.cbr.dit.csiro.au/staff/gjw/www/tex.html} + + +This is a URL: \url{http://srahtz/attend.html#sebastian} + +\hyperref{file:test2.pdf}{equation}{1}{hello} +\end{minipage} + +\newpage + +\section{Back to math} +\begin{equation} + zzzz + b + \label{eq1} +\end{equation} +and what next? + +\begin{equation} + d - e + \label{eq2} +\end{equation} + +\begin{eqnarray} + y &=&z\\ + g &=&h\\ + \label{eq3} +\end{eqnarray} +We need some lists: +\begin{enumerate} +\item oranges\index{oranges|boldindex} +\item lemons\index{lemons|boldindex} +\item beer\index{beer|boldindex} + \begin{enumerate} + \item Samuel Smiths + \item Labatts + \end{enumerate} +\end{enumerate} + +Lets look at labels in lists: +\begin{enumerate} +\item oranges\label{oranges} +\item lemons\label{lemons} +\item beer\label{beer} + \begin{enumerate} + \item Samuel Smiths\label{smiths} + \item Labatts\label{labatts} + \end{enumerate} +\end{enumerate} +\clearpage + +from which see \autoref{oranges}, \ref{lemons}, \ref{smiths} and +\autoref{labatts} + + +see +sec1: \autoref{sec1} +sec2: \autoref{sec2} +eq1: \autoref{eq1} +fig1: \autoref{fig1} +and cite \cite{Barcelo:1992:caa} again. +\onecolumn +\begin{longtable}{lll} +\caption{A test long table (see \protect\cite{Dallas:aia} +and section \protect\ref{sec1}}\label{mylongtab}\\ +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +a & b & c \\a +\end{longtable} + +% !!! Does not work with hypertexnames=false !!! +Does \hyperref{}{equation}{2.2}{this} point to the second equation? + +Does anything point to the eqnarray (\autoref{eq3})? +\index{cats} + +\begin{thebibliography}{99} +\addcontentsline{toc}{chapter}{Bibliography} +\bibitem{Barcelo:1992:caa} +{Barcel\'o, J.} 1992. +\newblock Programming an intelligent database in archaeology. In \emph{Computer + Applications and Quantitative Methods in Archaeology 1991}, {Lock, G. \& + J.~Moffett} (eds), 21--28, Oxford: British Archaeological Reports. + +\bibitem[Dallas 1992]{Dallas:aia} +{Dallas, C.~J.} 1992. +\newblock Syntax and semantics of figurative art: a formal approach. In + \emph{Archaeology and the Information Age}, {Reilly, P. \& S.~Rahtz} (eds), + chapter~16, London: Routledge. + +\bibitem[Stankovic 1988]{stankovic:88} +J.~Stankovic, ``Misconceptions about real-time computing: a serious problem for + next-generation systems,'' {\em Computer}, vol.~21, no.~10, pp.~10--19, Oct. + 1988. + +\end{thebibliography} + +\clearpage +An index entry for gnus\index{gnus} +\clearpage +An index entry for gnus\index{gnus} +\clearpage +An index entry for gnus\index{gnus} +\clearpage +An index entry for gnus\index{gnus} +\clearpage +An index entry for gnus\index{gnus} +\clearpage +An index entry for gnus\index{gnus} +\chapter*{An appendix --- the Index} +\printindex +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test2.tex b/Master/texmf-dist/doc/latex/hyperref/test/test2.tex new file mode 100644 index 00000000000..ec8639a9c17 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test2.tex @@ -0,0 +1,63 @@ +\documentclass[reqno]{amsart} +\usepackage{amsfonts} +\usepackage{amssymb} +\usepackage[T1]{fontenc} +\usepackage{ae} +\usepackage{hyperref} + + +\numberwithin{equation}{subsection} + +\begin{document} + +\section{My section title} + +Some text. + +\subsection{My first subsection} +\label{ss:first} + +\begin{equation} +\label{eq:A} +p^{\prime\prime} + \dfrac{S^\prime}{S}p^\prime +k^2p = 0 +\end{equation} + +Let's refer to equations~\ref{eqs:C} in +subsection\ref{ss:second}. + +\begin{equation} +\label{eq:B} +g(x)=const \times f(x) \int^{x} \dfrac{d\xi}{S(\xi)f^{2}(\xi)} . +\end{equation} + +Now I'll force a new page so the hyper-references will bridge a page +boundary. +\newpage + +\subsection{My second subsection} +\label{ss:second} +Now some subequations. + +\begin{subequations} +\label{eqs:C} +\begin{align} +p^\prime& = -Z(x)U \label{eq:pC} \\ +U^\prime & = -Y(x)p \label{eq:UC} +\end{align} +\end{subequations} + +These are related to equation~\ref{eq:A} in subsection~\ref{ss:first}. + +{% +\begin{subequations} +\label{eqs:D} +\begin{align} +p^\prime& = -j \omega {\dfrac{\rho}{S(x)}}U + = -jk {\dfrac{\rho c}{S(x)}}U \label{eq:pD} \\ +U^\prime & = -j \omega {\dfrac{S(x)}{\rho c^{2}}}p + = -jk {\dfrac{S(x)}{\rho c}}p \label{eq:UD} +\end{align} +\end{subequations} +} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test3.tex b/Master/texmf-dist/doc/latex/hyperref/test/test3.tex new file mode 100644 index 00000000000..cbfe6d3a3c7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test3.tex @@ -0,0 +1,556 @@ +\documentclass{article} +\usepackage{graphicx,ae} +\usepackage[T1]{fontenc} +\usepackage[latin1]{inputenc} +%\def\rmdefault{mbv} +\usepackage{url} +%\textwidth3in +\let\SetRowColor\relax +%\usepackage[times,symbolmenu,spaced=false,zebra,paperwidth=6in,paperheight=4in]{screenpdf} +\usepackage[]{hyperref} +\title{Simulation of Energy Loss Straggling} +\author{Maria Physicist} +\newcommand{\Emax}{\ensuremath{E_{\mathrm{max}}}} +\newcommand{\GEANT}{\texttt{GEANT}} +\begin{document} +\maketitle + +\section{Introduction} + +Due to the statistical nature of ionisation energy loss, large +fluctuations can occur in the amount of energy deposited by a particle +traversing an absorber element. Continuous processes such as multiple +scattering and energy loss play a relevant role in the longitudinal +and lateral development of electromagnetic and hadronic +showers, and in the case of sampling calorimeters the +measured resolution can be significantly affected by such fluctuations +in their active layers. The description of ionisation fluctuations is +characterised by the significance parameter $\kappa$, which is +proportional to the ratio of mean energy loss to the maximum allowed +energy transfer in a single collision with an atomic electron +\[ +\kappa =\frac{\xi}{\Emax} +\] +\Emax{} +is the maximum transferable energy in a single collision with +an atomic electron. +\[ +\Emax =\frac{2 m_e \beta^2\gamma^2 } +{1 + 2\gamma m_e/m_x + \left ( m_e/m_x\right)^2}, +\] +where $\gamma = E/m_x$, $E$ is energy and +$m_x$ the mass of the incident particle, +$\beta^2 = 1 - 1/\gamma^2$ and $m_e$ is the electron mass. +$\xi$ comes from the Rutherford scattering cross section +and is defined as: +\begin{eqnarray*} \xi = \frac{2\pi z^2 e^4 N_{Av} Z \rho \delta x} + {m_e \beta^2 c^2 A} = 153.4 \frac{z^2} {\beta^2} \frac{Z}{A} + \rho \delta x \quad\mathrm{keV}, +\end{eqnarray*} +where + +\begin{tabular}{ll} +\SetRowColor $z$ & charge of the incident particle \\ +\SetRowColor $N_{Av}$ & Avogadro's number \\ +\SetRowColor $Z$ & atomic number of the material \\ +\SetRowColor $A$ & atomic weight of the material \\ +\SetRowColor $\rho$ & density \\ +\SetRowColor $ \delta x$ & thickness of the material \\ +\end{tabular} + +$\kappa$ measures the contribution of the collisions with energy +transfer close to \Emax. For a given absorber, $\kappa$ tends +towards large values if $\delta x$ is large and/or if $\beta$ is +small. Likewise, $\kappa$ tends towards zero if $\delta x $ is small +and/or if $\beta$ approaches 1. + +The value of $\kappa$ distinguishes two regimes which occur in the +description of ionisation fluctuations : + +\begin{enumerate} +\item A large number of collisions involving the loss of all or most + of the incident particle energy during the traversal of an absorber. + + As the total energy transfer is composed of a multitude of small + energy losses, we can apply the central limit theorem and describe + the fluctuations by a Gaussian distribution. This case is + applicable to non-relativistic particles and is described by the + inequality $\kappa > 10 $ (i.e. when the mean energy loss in the + absorber is greater than the maximum energy transfer in a single + collision). + +\item Particles traversing thin counters and incident electrons under + any conditions. + + The relevant inequalities and distributions are $ 0.01 < \kappa < 10 + $, Vavilov distribution, and $\kappa < 0.01 $, Landau distribution. +\end{enumerate} + +An additional regime is defined by the contribution of the collisions +with low energy transfer which can be estimated with the relation +$\xi/I_0$, where $I_0$ is the mean ionisation potential of the atom. +Landau theory assumes that the number of these collisions is high, and +consequently, it has a restriction $\xi/I_0 \gg 1$. In \GEANT{} +(see URL \url{http://wwwinfo.cern.ch/asdoc/geant/geantall.html}), the +limit of Landau theory has been set at $\xi/I_0 = 50$. Below this +limit special models taking into account the atomic structure of the +material are used. This is important in thin layers and gaseous +materials. \autoref{fg:phys332-1} shows the behaviour of $\xi/I_0$ +as a function of the layer thickness for an electron of 100 keV and 1 +GeV of kinetic energy in Argon, Silicon and Uranium. + +\begin{figure} + \centering + \includegraphics[width=.6\linewidth]{phys1} + \caption{The variable $\xi/I_0$ can be used to measure the + validity range of the Landau theory. It depends + on the type and energy of the particle, $Z$, $A$ + and the ionisation potential of the material and + the layer thickness. + } + \label{fg:phys332-1} +\end{figure} + +In the following sections, the different theories and models for the +energy loss fluctuation are described. First, the Landau theory and +its limitations are discussed, and then, the Vavilov and Gaussian +straggling functions and the methods in the thin layers and gaseous +materials are presented. + +\section{Landau theory} +\label{sec:phys332-1} + +For a particle of mass $m_x$ traversing a thickness of material +$\delta x $, the Landau probability distribution may be written in +terms of the universal Landau function $\phi(\lambda)$ +as\cite{bib-LAND}: +\begin{eqnarray*} +f( \epsilon , \delta x ) & = &\frac{1}{\xi} \phi ( \lambda ) +\end{eqnarray*} +where +\begin{eqnarray*} +\phi(\lambda )& = & \frac{1} {2 \pi i}\int^{c+i\infty}_{c-i\infty} +\exp \left ( u \ln u + \lambda u \right ) du \hspace{2cm} c \geq 0 \\ +\lambda & = & \frac{\epsilon -\bar{\epsilon} }{\xi} + - \gamma' - \beta^2 - \ln \frac{\xi}{\Emax} \\ +\gamma' & = & 0.422784\dots = 1 - \gamma \\ +\gamma & = & 0.577215\dots \mbox{(Euler's constant)} \\ +\bar{\epsilon} & = & \mbox{average energy loss} \\ +\epsilon & = & \mbox{actual energy loss} +\end{eqnarray*} + +\subsection{Restrictions} + +The Landau formalism makes two restrictive assumptions : +\begin{enumerate} +\item The typical energy loss is small compared to the maximum energy + loss in a single collision. This restriction is removed in the + Vavilov theory (see \autoref{vavref}). +\item The typical energy loss in the absorber should be large compared + to the binding energy of the most tightly bound electron. For + gaseous detectors, typical energy losses are a few keV which is + comparable to the binding energies of the inner electrons. In such + cases a more sophisticated approach which accounts for atomic energy + levels\cite{bib-TALM} is necessary to accurately simulate data + distributions. In \GEANT, a parameterised model by L. Urb\'{a}n is + used (see section \ref{urban}). +\end{enumerate} + +In addition, the average value of the Landau distribution is infinite. +Summing the Landau fluctuation obtained to the average energy from the +$dE/dx$ tables, we obtain a value which is larger than the one coming +from the table. The probability to sample a large value is small, so +it takes a large number of steps (extractions) for the average +fluctuation to be significantly larger than zero. This introduces a +dependence of the energy loss on the step size which can affect +calculations. + +A solution to this has been to introduce a limit on the value of the +variable sampled by the Landau distribution in order to keep the +average fluctuation to 0. The value obtained from the \texttt{GLANDO} +routine is: +\[ +\delta dE/dx = \epsilon - \bar{\epsilon} = \xi ( \lambda - \gamma' ++\beta^2 +\ln \frac{\xi}{\Emax}) +\] +In order for this to have average 0, we must impose that: +\[ +\bar{\lambda} = -\gamma' - \beta^2 -\ln \frac{\xi}{\Emax} +\] + +This is realised introducing a $\lambda_{\mathrm{max}}(\bar{\lambda})$ +such that if only values of $\lambda \leq \lambda_{\mathrm{max}}$ are +accepted, the average value of the distribution is $\bar{\lambda}$. + +A parametric fit to the universal Landau distribution has been +performed, with following result: +\[ +\lambda_{\mathrm{max}} = 0.60715 + + 1.1934\bar{\lambda}+(0.67794+0.052382\bar{\lambda}) + \exp(0.94753+0.74442\bar{\lambda}) +\] +only values smaller than $\lambda_{\mathrm{max}}$ are accepted, otherwise the +distribution is resampled. + + + +\section{Vavilov theory} +\label{vavref} + +Vavilov\cite{bib-VAVI} derived a more accurate straggling distribution +by introducing the kinematic limit on the maximum transferable energy +in a single collision, rather than using $ \Emax = \infty $. +Now we can write\cite{bib-SCH1}: +\begin{eqnarray*} +f \left ( \epsilon, \delta s \right ) & = & \frac{1}{\xi} \phi_{v} +\left ( \lambda_{v}, \kappa, \beta^{2} \right ) +\end{eqnarray*} +where +\begin{eqnarray*} +\phi_{v} \left ( \lambda_{v}, \kappa, \beta^{2} \right ) & = & +\frac{1}{2 \pi i} \int^{c+i\infty}_{c-i\infty}\phi \left( s \right ) +e^{\lambda s} ds \hspace{2cm} c \geq 0 \\ +\phi \left ( s \right ) & = & +\exp \left [ \kappa ( 1 + \beta^{2}\gamma ) \right ] +~ \exp \left [ \psi \left ( s \right ) \right ], \\ +\psi \left ( s \right ) & = & s \ln \kappa + ( s + \beta^{2} \kappa ) +\left [ \ln (s/\kappa) + E_{1} (s/\kappa) \right ] - \kappa e^{-s/\kappa}, +\end{eqnarray*} +and +\begin{eqnarray*} +E_{1}(z) & = & \int^{\infty}_{z} t^{-1} e^{-t} dt +\mbox{\hspace{1cm} (the exponential integral)} \\ +\lambda_v & = & \kappa \left [ \frac{\epsilon - \bar{\epsilon}}{\xi} +- \gamma' - \beta^2 \right] +\end{eqnarray*} + +The Vavilov parameters are simply related to the Landau parameter by +$\lambda_L = \lambda_v/\kappa - \ln\kappa $. It can be shown that as +$\kappa \rightarrow 0$, the distribution of the variable $\lambda_L$ +approaches that of Landau. For $\kappa \leq 0.01$ the two +distributions are already practically identical. Contrary to what many +textbooks report, the Vavilov distribution \emph{does not} approximate +the Landau distribution for small $\kappa$, but rather the +distribution of $\lambda_L$ defined above tends to the distribution of +the true $\lambda$ from the Landau density function. Thus the routine +\texttt{GVAVIV} samples the variable $\lambda_L$ rather than +$\lambda_v$. For $\kappa \geq 10$ the Vavilov distribution tends to a +Gaussian distribution (see next section). + +\section{Gaussian Theory} + +Various conflicting forms have been proposed for Gaussian straggling +functions, but most of these appear to have little theoretical or +experimental basis. However, it has been shown\cite{bib-SELT} that +for $\kappa \geq 10 $ the Vavilov distribution can be replaced by a +Gaussian of the form : +\begin{eqnarray*} +f( \epsilon , \delta s) \approx \frac{1} +{\xi \sqrt{\frac{2 \pi}{\kappa} \left( 1 - \beta^2/2 \right)}} + \exp \left [ \frac{( \epsilon - \bar{\epsilon} )^2}{2} \frac{\kappa} + {\xi^2 (1- \beta^2/2)}\right ] +\end{eqnarray*} +thus implying +\begin{eqnarray*} +\mathrm{mean} & = & \bar{\epsilon} \\ +\sigma^2 & = & \frac{\xi^2}{\kappa} (1-\beta^2/2) = \xi + \Emax (1-\beta^2/2) +\end{eqnarray*} + +\section{Urb\'an model} +\label{urban} + +The method for computing restricted energy losses with $\delta$-ray +production above given threshold energy in \GEANT{} is a Monte +Carlo method that can be used for thin layers. It is fast and it can +be used for any thickness of a medium. Approaching the limit of the +validity of Landau's theory, the loss distribution approaches smoothly +the Landau form as shown in \autoref{fg:phys332-2}. +\begin{figure} + \centering + \includegraphics[width=.6\linewidth]{phys2} + \caption{Energy loss distribution for a 3 GeV electron in + Argon as given by standard \GEANT. The width of the layers is + given in centimeters.} + \label{fg:phys332-2} +\end{figure} + +It is assumed that the atoms have only two energy levels with binding +energy $E_1$ and $E_2$. The particle--atom interaction will then be +an excitation with energy loss $E_1$ or $E_2$, or an ionisation with +an energy loss distributed according to a function $g(E) \sim 1/E^2$: +\begin{equation} +g(E) = \frac{(\Emax + I)I}{\Emax} \frac{1}{E^2} +\end{equation} + +The macroscopic cross-section for excitations ($i=1,2$) is +\begin{equation} +\label{eq:sigex} +\Sigma_i = C \frac{f_i}{E_i} \frac{\ln (2 m \beta^2 \gamma^2/E_i) - \beta^2} + {\ln (2 m \beta^2 \gamma^2/ I) - \beta^2}(1-r) +\end{equation} +and the macroscopic cross-section for ionisation is +\begin{equation} +\label{eq:sigion} +\Sigma_3 = C \frac{\Emax}{I(\Emax+I) \ln(\frac{\Emax+I}{I})} + ~ r +\end{equation} +\Emax{} is the \GEANT{} cut for $\delta$-production, or the maximum +energy transfer minus mean ionisation energy, if it is smaller than +this cut-off value. The following notation is used: + +\begin{tabular}{ll} +\SetRowColor $r, C$ & parameters of the model \\ +\SetRowColor $E_i$ & atomic energy levels \\ +\SetRowColor $I$ & mean ionisation energy \\ +\SetRowColor ${f_i}$ & oscillator strengths +\end{tabular} + +The model has the parameters $f_i$, $E_i$, $C$ and $r ~(0\leq r\leq +1)$. The oscillator strengths $f_i$ and the atomic level energies +$E_i$ should satisfy the constraints +\begin{eqnarray} +f_1 + f_2 & = & 1 \label{eq:fisum}\\ +f_1 \ln E_1 + f_2 \ln E_2 & = & \ln I \label{eq:flnsum} +\end{eqnarray} +The parameter $C$ can be defined with the help of the mean energy loss +$dE/dx$ in the following way: The numbers of collisions ($n_i$, i = +1,2 for the excitation and 3 for the ionisation) follow the Poisson +distribution with a mean number $ \langle n_i \rangle $. In a step +$\Delta x$ the mean number of collisions is +\begin{equation} +\langle n_i \rangle = \Sigma_i \Delta x +\end{equation} +The mean energy loss $dE/dx$ in a step is the sum of the excitation +and ionisation contributions +\begin{equation} +\frac{dE}{dx} \Delta x = \left[ \Sigma_1 E_1 + \Sigma_2 E_2 + + \Sigma_3 \int_{I}^{\Emax+I} E~g(E)~dE \right] + \Delta x +\end{equation} +From this, using the equations (\ref{eq:sigex}), (\ref{eq:sigion}), +(\ref{eq:fisum}) and (\ref{eq:flnsum}), one can define the parameter +$C$ +\begin{equation} +C = \frac{dE}{dx} +\end{equation} + +The following values have been chosen in \GEANT{} for the other +parameters: +\[ +\begin{array}{lcl} +f_2 = \left\{ \begin{array}{ll} + 0 & \mathrm{if} Z \leq 2 \\ + 2/Z & \mathrm{if} Z > 2 \\ + \end{array} \right. & \Rightarrow & f_1 = 1 - f_2 \\ +E_2 = 10 Z^2 \mathrm{eV} & \Rightarrow & E_1 = \left(\frac{I}{E_{2}^{f_2}} + \right)^{\frac{1}{f_1}} \\ +r = 0.4 & & \\ +\end{array} +\] +With these values the atomic level $E_2$ corresponds approximately +the K-shell energy of the atoms and $Zf_2$ the number of K-shell +electrons. $r$ is the only variable which can be tuned freely. It +determines the relative contribution of ionisation and +excitation to the energy loss. + +The energy loss is computed with the assumption that the step length +(or the relative energy loss) is small, and---in consequence---the +cross-section can be considered constant along the path length. The +energy loss due to the excitation is +\begin{equation} +\Delta E_e = n_1 E_1 + n_2 E_2 +\end{equation} +where $n_1$ and $n_2$ are sampled from Poisson distribution as +discussed above. The loss due to the ionisation can be generated from +the distribution $g(E)$ by the inverse transformation method: +\begin{eqnarray} +u = F(E) & = & \int_{I}^E g(x) dx \nonumber \\ +E = F^{-1}(u) & = & \frac{I}{1 - u \frac {\Emax}{\Emax+I}} \\ +\end{eqnarray} +where $u$ is a uniform random number between $F(I)=0$ and +$F(\Emax+I)=1$. The contribution from the ionisations will be +\begin{equation} +\Delta E_i = \sum_{j=1}^{n_3} \frac{I} + {1 - u_j \frac {\Emax}{\Emax + I}} +\end{equation} +where $n_3$ is the number of ionisation (sampled from Poisson +distribution). The energy loss in a step will then be $\Delta E = +\Delta E_e + \Delta E_i$. + + +\subsection{Fast simulation for $n_3 \geq 16$} + +If the number of ionisation $n_3$ is bigger than 16, a faster sampling +method can be used. The possible energy loss interval is divided in +two parts: one in which the number of collisions is large and the +sampling can be done from a Gaussian distribution and the other in +which the energy loss is sampled for each collision. Let us call the +former interval $[I, \alpha I]$ the interval A, and the latter +$[\alpha I,\Emax]$ the interval B. $\alpha$ lies between 1 and +$\Emax/I$. A collision with a loss in the interval A happens with +the probability +\begin{equation} +\label{eq:phys332-5} +P(\alpha) = \int_I^{\alpha I} g(\!E\!) \, dE = + \frac {( \Emax + I) (\alpha - 1)}{\Emax \alpha} +\end{equation} +The mean energy loss and the standard deviation for this type +of collision are +\begin{equation} +\langle \Delta E(\alpha) \rangle = \frac{1}{P(\alpha)} + \int_I^{\alpha I} E \, g(\!E\!) \, dE = + \frac{I \alpha \ln \alpha}{\alpha - 1} +\end{equation} +and +\begin{equation} +\sigma^2(\alpha) = \frac{1}{P(\alpha)} + \int_I^{\alpha I} E^2 \, g(\!E\!) \, dE = + I^2 \alpha \left( 1 - \frac{\alpha \ln \! ^2 \alpha}{(\alpha - 1)^2} \right) +\end{equation} +If the collision number is high , we assume that the number of the +type A collisions can be calculated from a Gaussian distribution +with the following mean value and standard deviation: +\begin{eqnarray} +\label{eq:phys332-1} +\langle n_A \rangle & = & n_3 P(\alpha) \\ +\label{eq:phys332-2} +\sigma_A^2 & = & n_3 P(\alpha) ( 1 - P(\alpha)) +\end{eqnarray} +It is further assumed that the energy loss in these collisions +has a Gaussian distribution with +\begin{eqnarray} +\label{eq:phys332-3} +\langle \Delta E_A \rangle & = & n_A \langle \Delta E(\alpha) \rangle \\ +\label{eq:phys332-4} +\sigma_{E,A}^2 & = & n_A \sigma^2(\alpha) +\end{eqnarray} +The energy loss of these collision can then be sampled from the +Gaussian distribution. + +The collisions where the energy loss is in the interval B are sampled +directly from +\begin{equation} +\Delta E_B = \sum_{i=1}^{n_3 - n_A} \frac{\alpha I} + {1 - u_i \frac{\Emax + I - \alpha I}{\Emax + I}} +\end{equation} +The total energy loss is the sum of these two types of collisions: +\begin{equation} +\Delta E = \Delta E_A + \Delta E_B +\end{equation} + +The approximation of equations (\ref{eq:phys332-1}), +(\ref{eq:phys332-2}), (\ref{eq:phys332-3}) and (\ref{eq:phys332-4}) +can be used under the following conditions: +\begin{eqnarray} +\label{eq:phys332-6} +\langle n_A \rangle - c \, \sigma_A & \geq & 0 \\ +\label{eq:phys332-7} +\langle n_A \rangle + c \, \sigma_A & \leq & n_3 \\ +\label{eq:phys332-8} +\langle \Delta E_A \rangle - c \, \sigma_{E,A} & \geq & 0 +\end{eqnarray} +where $c \geq 4$. From the equations (\ref{eq:phys332-5}), +(\ref{eq:phys332-1}) and (\ref{eq:phys332-3}) and from the conditions +(\ref{eq:phys332-6}) and (\ref{eq:phys332-7}) the following limits can +be derived: +\begin{equation} +\alpha_{\mathrm{min}} = \frac{(n_3 + c^2)(\Emax+I)} + {n_3 (\Emax + I) + c^2 I} \; \leq \alpha \; \leq +\alpha_{\mathrm{max}} = \frac{(n_3 + c^2)(\Emax+I)} + {c^2 (\Emax + I) + n_3 I} +\end{equation} +This conditions gives a lower limit to number of the ionisations $n_3$ +for which the fast sampling can be done: +\begin{equation} +n_3 \; \geq \; c^2 +\end{equation} +As in the conditions (\ref{eq:phys332-6}), (\ref{eq:phys332-7}) and +(\ref{eq:phys332-8}) the value of $c$ is as minimum 4, one gets $n_3 +\; \geq 16$. In order to speed the simulation, the maximum value is +used for $\alpha$. + +The number of collisions with energy loss in the interval B (the +number of interactions which has to be simulated directly) increases +slowly with the total number of collisions $n_3$. The maximum number +of these collisions can be estimated as +\begin{equation} +n_{B,max} = n_3 - n_{A,min} \approx n_3 (\langle n_A \rangle + - \sigma_A) +\end{equation} +From the previous expressions for $\langle n_A \rangle$ and $\sigma_A$ +one can derive the condition +\begin{equation} +n_B \; \leq \; n_{B,max} = \frac{2 n_3 c^2}{n_3+c^2} +\end{equation} +The following values are obtained with $c=4$: + +\begin{tabular}{llcrr} +$n_3$ & $n_{B,max}$ & & $n_3$ & $n_{B,max}$\\ +\hline +\SetRowColor 16 & 16 & & 200 & 29.63\\ +\SetRowColor 20 & 17.78 & & 500 & 31.01 \\ +\SetRowColor 50 & 24.24 & & 1000 & 31.50 \\ +\SetRowColor 100 & 27.59 & & $\infty$ & 32.00 +\end{tabular} + +\subsection{Special sampling for lower part of the spectrum} + +If the step length is very small ($\leq 5$ mm in gases, $\leq$ 2-3 +$\mu$m in solids) the model gives 0 energy loss for some events. To +avoid this, the probability of 0 energy loss is computed +\begin{equation} +P( \Delta E=0) = e^{-( \langle n_1 \rangle + \langle n_2 \rangle + + \langle n_3 \rangle )} +\end{equation} +If the probability is bigger than 0.01 a special sampling is done, +taking into account the fact that in these cases the projectile +interacts only with the outer electrons of the atom. An energy level +$E_0 = 10$ eV is chosen to correspond to the outer electrons. The mean +number of collisions can be calculated from +\begin{equation} +\langle n \rangle = \frac{1}{E_0} \frac{dE}{dx} \Delta x +\end{equation} +The number of collisions $n$ is sampled from Poisson distribution. +In the case of the thin layers, all the collisions are considered as +ionisations and the energy loss is computed as +\begin{equation} +\Delta E = \sum_{i=1}^n \frac{E_0} + {1 - \frac {\Emax}{\Emax + E_0} u_i} +\end{equation} + + +\begin{thebibliography}{10} +\bibitem{bib-LAND} +L.Landau. +\newblock On the Energy Loss of Fast Particles by Ionisation. +\newblock Originally published in \emph{J. Phys.}, 8:201, 1944. +\newblock Rerpinted in D.ter Haar, Editor, \emph{L.D.Landau, Collected + papers}, page 417. Pergamon Press, Oxford, 1965. + +\bibitem{bib-SCH1} +B.Schorr. +\newblock Programs for the Landau and the Vavilov distributions and the + corresponding random numbers. +\newblock \emph{Comp. Phys. Comm.}, 7:216, 1974. + +\bibitem{bib-SELT} +S.M.Seltzer and M.J.Berger. +\newblock Energy loss straggling of protons and mesons. +\newblock In \emph{Studies in Penetration of Charged Particles in + Matter}, Nuclear Science Series~39, Nat. Academy of Sciences, + Washington DC, 1964. + +\bibitem{bib-TALM} +R.Talman. +\newblock On the statistics of particle identification using ionization. +\newblock \emph{Nucl. Inst. Meth.}, 159:189, 1979. + +\bibitem{bib-VAVI} +P.V.Vavilov. +\newblock Ionisation losses of high energy heavy particles. +\newblock \emph{Soviet Physics JETP}, 5:749, 1957. + +\end{thebibliography} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test4.tex b/Master/texmf-dist/doc/latex/hyperref/test/test4.tex new file mode 100644 index 00000000000..60f6206ee16 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test4.tex @@ -0,0 +1,36 @@ +\documentclass{article} +\usepackage{hyperref} + + +\begin{document} + +\section{My section title} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\include{bit} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test6.tex b/Master/texmf-dist/doc/latex/hyperref/test/test6.tex new file mode 100644 index 00000000000..42c80b61de9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test6.tex @@ -0,0 +1,18 @@ +\documentclass{book} +\usepackage[extension=xxx]{hyperref} +\begin{document} +A\footnote{\texttt{abc}} + +\href{file://localhost/d:/test2.ps}{foo1} + +\href{file://localhost/d:/test2.pdf}{foo2} + +\href{d:/test2.pdf}{foo3} + +\href{d:/test2.ps}{foo4} + +\href{http://www-fourier.ujf-grenoble.fr:80/cgi-bin/zbfr/ZB/math-fr.html?AU=Taylor,+R&format=complete&type=html&maxdocs=10}{weird} + +\href{a%b}{hello} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test7.pdf b/Master/texmf-dist/doc/latex/hyperref/test/test7.pdf new file mode 100644 index 00000000000..1ed1c8dfd81 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test7.pdf @@ -0,0 +1,179 @@ +%PDF-1.3 +5 0 obj +<< /S /GoTo /D (section.1) >> +endobj +8 0 obj +(The first section) +endobj +9 0 obj +<< /S /GoTo /D (section.2) >> +endobj +12 0 obj +(The second section) +endobj +13 0 obj +<< /S /GoTo /D [14 0 R /Fit ] >> +endobj +16 0 obj << +/Length 135 +/Filter /FlateDecode +>> +stream +xÚ-±Â0 D÷|…Çdˆ±Ä%+ ÌÙ€©©P‰öÿEhÑM§{wÇ@M vºM JHп̡˜ÝIZ1D…òXÑr¿Xvž‰È–¡:/‰ì•H>ó²™¹öËsz»[9·>CƬa«{Õud¨ã8ý `Í4O1¡Rü´È ‹ùŽ’%¿endstream +endobj +14 0 obj << +/Type /Page +/Contents 16 0 R +/Resources 15 0 R +/MediaBox [0 0 612 792] +/Parent 23 0 R +>> endobj +17 0 obj << +/D [14 0 R /XYZ 133.768 692.105 null] +>> endobj +18 0 obj << +/D [14 0 R /XYZ 133.768 667.198 null] +>> endobj +6 0 obj << +/D [14 0 R /XYZ 133.768 667.198 null] +>> endobj +15 0 obj << +/Font << /F20 20 0 R /F21 22 0 R >> +/ProcSet [ /PDF /Text ] +>> endobj +26 0 obj << +/Length 135 +/Filter /FlateDecode +>> +stream +xÚ=½1 ƒ÷>EÆvhh“&ÇH00wC,\ËÏÀu€…·§ y±äÏv„Ð!2ã kPX`º›M6« õ0!'…|^Ð\–œ!›¯Õy’` ujsùûçÍî˜÷½ aÄQùÛöDHªËÆ¥µrzÕQGdð’5¤ßIÌ6›7íÂ&Ëendstream +endobj +25 0 obj << +/Type /Page +/Contents 26 0 R +/Resources 24 0 R +/MediaBox [0 0 612 792] +/Parent 23 0 R +>> endobj +27 0 obj << +/D [25 0 R /XYZ 133.768 692.105 null] +>> endobj +10 0 obj << +/D [25 0 R /XYZ 133.768 667.198 null] +>> endobj +28 0 obj << +/D [25 0 R /XYZ 133.768 646.723 null] +>> endobj +24 0 obj << +/Font << /F20 20 0 R /F21 22 0 R >> +/ProcSet [ /PDF /Text ] +>> endobj +29 0 obj << +/Type /Encoding +/Differences [ 0 /.notdef 1/dotaccent/fi/fl/fraction/hungarumlaut/Lslash/lslash/ogonek/ring 10/.notdef 11/breve/minus 13/.notdef 14/Zcaron/zcaron/caron/dotlessi/dotlessj/ff/ffi/ffl 22/.notdef 30/grave/quotesingle/space/exclam/quotedbl/numbersign/dollar/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/asciicircum/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/asciitilde 127/.notdef 130/quotesinglbase/florin/quotedblbase/ellipsis/dagger/daggerdbl/circumflex/perthousand/Scaron/guilsinglleft/OE 141/.notdef 147/quotedblleft/quotedblright/bullet/endash/emdash/tilde/trademark/scaron/guilsinglright/oe 157/.notdef 159/Ydieresis 160/.notdef 161/exclamdown/cent/sterling/currency/yen/brokenbar/section/dieresis/copyright/ordfeminine/guillemotleft/logicalnot/hyphen/registered/macron/degree/plusminus/twosuperior/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior/ordmasculine/guillemotright/onequarter/onehalf/threequarters/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis] +>> endobj +22 0 obj << +/Type /Font +/Subtype /Type1 +/Encoding 29 0 R +/BaseFont /Times-Roman +>> endobj +20 0 obj << +/Type /Font +/Subtype /Type1 +/Encoding 29 0 R +/BaseFont /Times-Bold +>> endobj +23 0 obj << +/Type /Pages +/Count 2 +/Kids [14 0 R 25 0 R] +>> endobj +30 0 obj << +/Type /Outlines +/First 7 0 R +/Last 11 0 R +/Count 2 +>> endobj +11 0 obj << +/Title 12 0 R +/A 9 0 R +/Parent 30 0 R +/Prev 7 0 R +>> endobj +7 0 obj << +/Title 8 0 R +/A 5 0 R +/Parent 30 0 R +/Next 11 0 R +>> endobj +31 0 obj << +/Names [(Doc-Start) 18 0 R (TestTarget) 28 0 R (page.1) 17 0 R (page.2) 27 0 R (section.1) 6 0 R (section.2) 10 0 R] +/Limits [(Doc-Start) (section.2)] +>> endobj +32 0 obj << +/Kids [31 0 R] +>> endobj +33 0 obj << +/Dests 32 0 R +>> endobj +34 0 obj << +/Type /Catalog +/Pages 23 0 R +/Outlines 30 0 R +/Names 33 0 R + /PageMode /UseOutlines /URI << /Base () >> /ViewerPreferences << >> +/OpenAction 13 0 R +>> endobj +35 0 obj << +/Producer (pdfTeX-0.14h-pdfcrypt) +/Author () /Title () /Subject () /Creator (LaTeX with hyperref package) /Producer (pdfTeX14.h) /Keywords () +/CreationDate (D:20010816055100) +>> endobj +xref +0 36 +0000000001 65535 f +0000000002 00000 f +0000000003 00000 f +0000000004 00000 f +0000000019 00000 f +0000000009 00000 n +0000000663 00000 n +0000003567 00000 n +0000000054 00000 n +0000000089 00000 n +0000001186 00000 n +0000003495 00000 n +0000000134 00000 n +0000000171 00000 n +0000000435 00000 n +0000000722 00000 n +0000000221 00000 n +0000000543 00000 n +0000000603 00000 n +0000000021 00000 f +0000003267 00000 n +0000000000 00000 f +0000003177 00000 n +0000003356 00000 n +0000001306 00000 n +0000001018 00000 n +0000000804 00000 n +0000001126 00000 n +0000001246 00000 n +0000001388 00000 n +0000003422 00000 n +0000003638 00000 n +0000003811 00000 n +0000003848 00000 n +0000003884 00000 n +0000004056 00000 n +trailer +<< +/Size 36 +/Root 34 0 R +/Info 35 0 R +>> +startxref +4254 +%%EOF diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test7.tex b/Master/texmf-dist/doc/latex/hyperref/test/test7.tex new file mode 100644 index 00000000000..bce6eb5629a --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test7.tex @@ -0,0 +1,12 @@ +\documentclass{article} +\usepackage{hyperref} +\usepackage{times} +\begin{document} + +\section{The first section} +hello +\newpage +\section{The second section} +\hypertarget{TestTarget}{goodbye} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/test8.tex b/Master/texmf-dist/doc/latex/hyperref/test/test8.tex new file mode 100644 index 00000000000..25a2d3dbfb8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/test8.tex @@ -0,0 +1,41 @@ +% Test file from Stephan Haller <stk@snafu.de> that shows how +% bookmark open levels can vary during the document. + +\documentclass{article} + +\usepackage{times} + +\def\OpMode{1} % fake vtex + +\usepackage{hyperref} + +\begin{document} + +\section{I'm closed (default)} +\subsection{x} + +\hypersetup{bookmarksopen=true} + +\section{I'm open,} +\subsection{and so} +\subsection{are my} +\subsubsection{children} + +\hypersetup{bookmarksopen=false} + +\section{I'm closed,} + +\hypersetup{bookmarksopen=true} + +\subsection{but my} +\subsubsection{children} +\subsection{are} +\subsubsection{open} + +\hypersetup{bookmarksopenlevel=2} + +\section{level is two now} +\subsection{so this is closed} +\subsubsection{y} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testams.tex b/Master/texmf-dist/doc/latex/hyperref/test/testams.tex new file mode 100644 index 00000000000..25e254806b1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testams.tex @@ -0,0 +1,253 @@ +\documentclass{article} +\usepackage[latin1]{inputenc} +\usepackage{amsmath} +\usepackage{amsfonts} +\usepackage[spanish]{babel} +\usepackage{calc}% or e-TeX, for \hypercalcbp + +\usepackage[% + verbose, + colorlinks=true, + naturalnames=true, + linkcolor=blue, +]{hyperref} + +\addtolength{\topmargin}{-10mm} +\setlength{\oddsidemargin}{-5mm} +\setlength{\evensidemargin}{-5mm} +\setlength{\textwidth}{165mm} +\addtolength{\textheight}{3.5cm} % alargar longitud página + +\hypersetup{% + pdftitle={Notas sobre Control por computador, de Hilario Lopez},% + % Note /XYZ takes three arguments, the X and Y offsets and the + % zoom factor. Omitting these values breaks Distiller. + pdfstartview={% + XYZ \hypercalcbp{1in+\oddsidemargin-2mm} % + \hypercalcbp{\paperheight-1in-\topmargin + -\headheight-\headsep+2mm} % + 1% + }% +} + +% The numbering of the equations is done by the \tag command +% explicitly. Problematic is the equation environment, because +% it generates also an anchor named "equation.1". This would +% produce a lot of warnings. Changing equation to gather +% supresses the warnings. The links should work in both +% cases. +\let\equation\gather +\let\endequation\endgather + +\newcommand{\fdt}{\hbox{f.d.t.\@}} + +\newcommand{\pagina}[1]{\textsl{{\tiny \mbox{[#1]}}}}% << la del fichero grainger-stevenson.tex +\newcommand{\ingles}[1]{\emph{#1}} + + +\newcommand{\ojo}[1]{ } +% +% Crear una caja de texto con borde para destacar ciertos párrafos +% +\newcommand{\destacaP}[1]{ } + + +% +\begin{document} + +\section{Diseño mediante síntesis directa} +Se calculan reguladores por el método de Truxal. +\begin{itemize} + \item Si el proceso tiene un tiempo muerto $d$, el sistema en cadena cerrada no puede + tener un valor menor. +\begin{equation}\label{eq:SintesisDirectaGradosEnBucleCerrado} + gr[L(z)] -gr[N(z)] \ge gr[A(z)]-gr[B(z)] \tag{2.14} +\end{equation} + \item Se obtendrá el mismo tiempo muerto $d$, salvo que en el regulador $G_R$ se + introduzca un nuevo retardo por tener más ceros que polos. + \item Los polos y ceros del proceso externos a la circunferencia unidad no se deben + cancelar con los ceros y polos del regulador, por lo que dichos factores no pueden + aparecer en $G_R(z)$. + \item Asignación de polos (del sistema en cadena cerrada). + Permite especificar (en parte\footnote{Es debido a que los ceros que resulten del regulador + pueden modificar la dinámica que hemos calculado mediante los polos. Habrá que comprobar que + su efecto es despreciable, que implica que los ceros deben ser poco significativos + en comparación con las raíces de $z^2+ \alpha \, z + \beta = 0$} (interesa por tanto que + estén alejados de la circunferencia unidad).) la respuesta transitoria, a + través de un sistema de segundo orden, y poniendo el resto de los polos en $z=0$. + \item Tiempo finito. Todos sus polos están en el origen. Se caracterizan porque alcanzan + el valor final de la respuesta ante una entrada dada en un tiempo finito, + \textsc{sin oscilar la secuencia discreta}. En el caso de control en tiempo real, el + sistema continuo si oscilaría ligeramente. Se refiere a que aunque en los instantes de + muestreo los valores sean los dados por el sistema discreto, el sistema continuo + asociado podría tomar valores distintos entre los instantes de muestreo. + \item Tiempo mínimo. Como los de tiempo finito, pero realizando \textsc{todas} + las cancelaciones \textsc{posibles} (no se consideran posibles las de polos y ceros externos). + \item Respuesta en permanente. Si se desea obtener error de posición nulo y el proceso + no posee un polo en $z=1$, entonces el regulador debe incluir un polo (por lo menos) en + dicho punto. También es necesario esto para eliminar el efecto sobre el permanente de + las perturbaciones deterministas. + \item Simplicidad. Interesa que el número de polos y ceros del regulador sea mínimo. + Esta propiedad es opuesta a la minimización de $m$ (para obtener un sistema de tiempo mínimo). +\end{itemize} +\subsection{Métodos de cálculo} +\subsubsection{Método de asignación de polos} El transitorio puede venir especificado por +$M_p$, $n_p$, y $n_s$. Las fórmulas aplicables son +\begin{align}\label{eq:AsignacionPolosFormulasParametrosTransitorio} + n_p &= \frac{\pi}{\theta} \tag{2.27} \\ + M_p &= |p|^{n_p} \tag{2.28} \\ + n_s &= \frac{\pi}{\sigma} \tag{2.29} \\ + |p| &= e^{-\sigma} \tag{2.30} +\end{align} +La ecuación característica para realimentación unitaria ($H=1$) es +\begin{equation}\label{eq:AsignacionPolosEcuacionCaracteristica} + 1 + G_R(z) \, BG(z) = 0 \tag{2.32} +\end{equation} +o sea +\begin{equation}\label{eq:AsignacionPolosEcuacionCaracteristicaFactorizada} + 1 + \frac{Q(z)}{P(z)} \, \frac{B(z)}{A(z)} = 0 \tag{2.33} +\end{equation} +en la que se observa que puede haber factores que se anulen entre numerador de $G_R$ y +denominador de $G_P$, y viceversa. Operando, resultaría que +\begin{equation}\label{eq:AsignacionPolosEcuacionCaracteristicaNumerador} + A(z) \, P(z) + B(z) \, Q(z) = 0 \tag{2.34} +\end{equation} +% +Debe hacerse notar que si en la ec. +(\ref{eq:AsignacionPolosEcuacionCaracteristicaFactorizada}) se hubiesen anulado factores +entre numerador y denominador, la ecuación +(\ref{eq:AsignacionPolosEcuacionCaracteristicaNumerador}) una vez simplificada sería del +estilo +\begin{equation}\label{eq:AsignacionPolosEcuacionCaracteristicaNumeradorSimplificada} + A'(z) \, P'(z) + B'(z) \, Q'(z) = 0 \tag{2.34-bis} +\end{equation} +en la que $A'(z)$ sería los polos de $A(z)$ que no se cancelan, $B'(z)$ los ceros del +proceso no cancelados (y que por tanto aparecerán en la \fdt de cadena cerrada), y $P'(z)$ +y $Q'(z)$ los polinomios que necesitamos calcular. El factor $Q'(z)$ no se deja como tal, +sino que se pone en función del polinomio $N(z)$, que es el numerador de la \fdt de cadena +cerrada. Para ello se hace uso de la propiedad que dice que los ceros en cadena cerrada +son los del sistema más los del regulador (a menos que se hayan cancelado ceros del +proceso con polos del regulador). +% +La ecuación que debemos plantear para hallar los coeficientes del regulador es +\begin{equation}\label{eq:AsignacionPolosIdentificacionCoeficientes} + z^m (z^2+ \alpha \, z + \beta) = A(z) \, P(z) + B(z) \, Q(z) \tag{2.35} +\end{equation} +% +La solución es única cuando se tengan tantas ecuaciones como incógnitas. Igualando grados, +se tiene que +\begin{equation}\label{eq:AsignacionPolosGradosPolinomios} + m+2 = p+a \tag{2.36} +\end{equation} +y al aplicar la condición (\ref{eq:SintesisDirectaGradosEnBucleCerrado}) a la ecuación +(\ref{eq:AsignacionPolosIdentificacionCoeficientes}) resulta +\begin{equation}\label{AsignacionPolosCondicionGradosBucleCerrado} + (m+2)-n \ge a-b \tag{2.38} +\end{equation} +\subsubsection{Método de tiempo finito} +Todos los polos de cadena cerrada están en el origen ($z=0$). En dichos sistemas, la +respuesta impulsional se puede obtener fácilmente como la secuencia formada por los +coeficientes de $\{b_0, b_1, b_2, \ldots \}$, que es la que resulta de multiplicar la \fdt +por $z^{-m}$, siendo $m$ en número de polos en cadena cerrada (todos en el origen). La +respuesta ante escalón se puede conseguir como suma de la secuencia impulsional: $\{b_0, +b_0+b_1, b_0+b_1+b_2, \ldots \}$. +\ojo{Para los reguladores de tiempo finito, el número de muestras en el origen (valor +cero) coincide con el tiempo muerto, mientras que el número de muestras del transitorio +coincide con el número de ceros. Revisar\pagina{H26} ¿Por que se consideran tres muestras +de transitorio, y no se cuenta la del origen ni la que marca el fin del transitorio, si en +un sistema continuo se contaría todo el tiempo?} +\subsubsection{Método de tiempo mínimo} +Se cancelan todos los polos y ceros de $BG(z)$ interiores a la circunferencia unidad. +\subsection{Mejora del régimen permanente} +Para evitar errores en permanente, puede interesar poner una serie de polos en $z=1$, lo +que se traduce en que en el denominador del regulador habrá un factor $(z-1)^i$, siendo +$G_R$, por tanto, de la forma +\begin{equation}\label{SintesisDirectaPolosEnZIgualAUno} + G_R = \frac{Q(z)}{(z-1)^i \, P(z)} \tag{2.29} +\end{equation} +\subsection{Mejora del régimen transitorio} +Pueden conseguirse respuestas menos bruscas (menor sobreoscilación, etc.) dando más tiempo +para que el sistema se estabilice, lo cual puede conseguirse aumentando $m$ en una unidad, +mientras se mantiene fijo $T_m$, por lo que tendremos un grado de libertad. Otra +posibilidad es poner un filtro entre la señal de consigna y la entrada al bucle de +realimentación, de forma que éste perciba una variación más lenta de la señal de consigna +\pagina{28}. +\subsection{Notas acerca de los problemas propuestos} +\begin{itemize} + \item Son interesantes los ejemplos para ver como se aplican en la práctica las + ecuaciones del estilo a la (\ref{eq:AsignacionPolosIdentificacionCoeficientes}), sobre + todo al cálculo de los valores del grado $n$ y a la aplicación correcta de la + ecuación (\ref{AsignacionPolosCondicionGradosBucleCerrado}). + \item Al incluir integrador en el regulador, la sobreoscilación tiende a aumentar\pagina{40}. + \item Se indica un ejemplo donde se permite incrementar $m$ para obtener el grado de + libertad que nos permita obtener menor sobreoscilación. También se hace uso del + ``truco'' de poner el denominador $z^m$ en la forma $((z-1) + 1)^m$, por lo que haciendo + el desarrollo del binomio de Newton, nos permite poner la \fdt de cadena cerrada como + factores de $(z-1)^k$ en vez de $z^k$, lo que permite simplificar a la hora de igualar + coeficientes, a la vez que garantizamos que no habrá error en permanente, ya que $M(1) = + 1$. + Hay que andarse con ojo si el factor $K$ que multiplica al proceso no es 1 (estando dicho + proceso expresado en la forma de factores $K \cdot \prod (z-c_i)/\prod (z-p_j)$). + En ese caso\pagina{45}, el factor $K$ aparecería multiplicando al cociente de polinomios + que definen $M(z)$ y el coeficiente $n_0$ no sería 1, sino $1/K$. Un ejemplo de este + caso, si se intenta resolver de esta forma, está en el examen del $1^{\textrm{er}}$ parcial + del 25 de Marzo de 1999. +\end{itemize} +\ojo{¿Es cierto que si no se cancelan ceros del proceso, entonces se tiene que la señal de +control $u(k)$ también presenta un comportamiento de tiempo finito? ¿De dónde se deduce +dicha propiedad?} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\section{Algoritmos de diseño (I)} +\subsection{Algoritmos de tiempo finito (reguladores de Isermann)} +\begin{itemize} + \item La función de transferencia en cadena cerrada no es preespecificada, sino que + viene determinada como resultado del diseño. Todos los polos estarán en el origen. + \item No se cancela ningún cero, pero sí todos los polos. + \item Se incluye integrador, que anula el error en permanente + \item Son muy sencillos de calcular. +\end{itemize} +\subsection{Regulador de tiempo finito de orden normal} +La señal de control $u$ estará estabilizada tras $m$ periodos de muestreo, y la de salida +$y$ tras $m+d$, siendo $d$ el tiempo muerto del proceso. +\subsubsection{Para procesos con tiempo muerto % + \texorpdfstring{$d=0$}{d=0}} +Los coeficientes resultantes para el +regulador son: +\begin{equation}\label{eq:IsermannTiempoFinitoOrdenNormalCoeficientesQCero} + q_0 = \frac{1}{\sum b_i} \tag{3.20a} +\end{equation} +% +\begin{equation}\label{eq:IsermannTiempoFinitoOrdenNormalCoeficientesQi} + q_i = q_0 \, a_i, \quad i=1,\ldots,m + \quad \textrm{(además $\sum q_i = u(m)$, por (3.12, H53))}\tag{3.20b} +\end{equation} +% +\begin{equation}\label{eq:IsermannTiempoFinitoOrdenNormalCoeficientesPi} + p_i = q_0 \, b_i, \quad i=1,\ldots,m + \quad \textrm{(además $\sum p_i = 1$, por (3.11))}\tag{3.20c} +\end{equation} +% +El regulador resultante ($d=0$) es +\begin{equation}\label{eq:IsermannTiempoFinitoOrdenNormalSinTiempoMuerto} + G_R = \frac{Q(z^{-1}))}{1-P(z^{-1}))} = + \frac{q_0 \, A(z^{-1})}{1-q_0 \, B(z^{-1})} \tag{3.21} +\end{equation} +El primer valor de la acción de control es +\begin{equation}\label{eq:IsermannTiempoFinitoOrdenNormalUCero} + u(0) = q_0 = \frac{1}{\sum b_i} \tag{3.22} +\end{equation} + + +\end{document} + +-- ++----------------------------------------------------------------------------+ +| Oscar Fernandez Sierra | +| Escuela Tecnica Superior de Ingenieros Industriales de Gijon | +| Departamento de Construccion e Ingenieria de Fabricacion | +| Campus de Viesques 33204 - Gijon (Spain) | +| | +| E-mail: oscar@charpy.etsiig.uniovi.es Voice: INT +34+ 985.18.22.29/19.30 | +| WWW: http://www1.uniovi.es/ FAX: INT +34+ 985.18.20.55 | ++----------------------------------------------------------------------------+ diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbib.bbl b/Master/texmf-dist/doc/latex/hyperref/test/testbib.bbl new file mode 100644 index 00000000000..d1f4e25862c --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbib.bbl @@ -0,0 +1,4 @@ +\begin{thebibliography}{0} +\expandafter\ifx\csname natexlab\endcsname\relax\def\natexlab#1{#1}\fi + +\end{thebibliography} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbib.bib b/Master/texmf-dist/doc/latex/hyperref/test/testbib.bib new file mode 100644 index 00000000000..e2070e7454c --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbib.bib @@ -0,0 +1,27 @@ +@article{Clark:1987, + author = "Adrian Clark", + title = "Halftone output from {\TeX}", + journal = TUB, + volume = "8", + number = "3", + year = "1987", + pages = "270--274" +} + +@unpublished{Clark:1989, + author = "James Clark", + title = "{DVITOPS} User Manual", + year = "1989", + note = "unpublished machine-readable documentation" +} + +@article{Clark:1991, + author = "Adrian Clark", + title = "Practical halftoning with {\TeX}", + journal = TUB, + volume = "12", + number = "1", + year = "1991", + pages = "157--165" +} + diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbib.tex b/Master/texmf-dist/doc/latex/hyperref/test/testbib.tex new file mode 100644 index 00000000000..81e8930e567 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbib.tex @@ -0,0 +1,57 @@ +\errorcontextlines=10 +\documentclass{article} +\usepackage{times} +\usepackage{natbib} +\bibliographystyle{agu} +\usepackage[colorlinks,citecolor=red,pagebackref,hypertexnames=false]{hyperref} +\begin{document} +\title{Another test} +\author{Sergey Lesenko} +\maketitle + +\section{Introduction} +(PDF), described in +\cite{Adobe,Deutsch}, and also available from +\TeX{} $\longrightarrow$ DVIPS\cite{Rokicki} +GhostScript\cite{Deutsch} +TeX2PDF\cite{Sojka} +\cite{Haralambous:TB16-2-162}. We may compare this route with that + +\citeyear{Adobe}, and also available from +\TeX{} $\longrightarrow$ DVIPS\citeyear{Rokicki} +GhostScript\citeyear{Deutsch} +TeX2PDF\citeyear{Sojka} +\citeyear{Haralambous:TB16-2-162}. We may compare this route with that + +\citeauthor{Adobe}, and also available from +\TeX{} $\longrightarrow$ DVIPS\citeauthor{Rokicki} +GhostScript\citeauthor{Deutsch} +TeX2PDF\citeauthor{Sojka} +\citeauthor{Haralambous:TB16-2-162}. We may compare this route with that + +\citefullauthor{Adobe}, and also available from +\TeX{} $\longrightarrow$ DVIPS\citefullauthor{Rokicki} +GhostScript\citefullauthor{Deutsch} +TeX2PDF\citefullauthor{Sojka} +\citefullauthor{Haralambous:TB16-2-162}. We may compare this route with that + +\citet{Adobe}, and also available from +\TeX{} $\longrightarrow$ DVIPS\citet{Rokicki} +GhostScript\citet{Deutsch} +TeX2PDF\citet{Sojka} +\citet{Haralambous:TB16-2-162}. We may compare this route with that + +\citealt{Adobe}, and also available from +\TeX{} $\longrightarrow$ DVIPS\citealt{Rokicki} +GhostScript\citealt{Deutsch} +TeX2PDF\citealt{Sojka} +\citealt{Haralambous:TB16-2-162}. We may compare this route with that + +\cite*{Adobe}, and also available from +\TeX{} $\longrightarrow$ DVIPS\cite*{Rokicki} +GhostScript\cite*{Deutsch} +TeX2PDF\cite*{Sojka} +\cite*{Haralambous:TB16-2-162}. We may compare this route with that + +\bibliography{testbib} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbma.tex b/Master/texmf-dist/doc/latex/hyperref/test/testbma.tex new file mode 100644 index 00000000000..2bc603cc5ce --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbma.tex @@ -0,0 +1,157 @@ +% testbma.tex +% +% Function: +% * How display a pdf reader the bookmarks? +% * Some problematic unicode glyphs are shown +% * in the bookmarks +% * as screenshots. +% +% Copyright (c) 2000 by Heiko Oberdiek. +% +% This file is part of the `Hyperref Bundle'. +% ------------------------------------------- +% +% It may be distributed under the conditions of the LaTeX Project Public +% License, either version 1.2 of this license or (at your option) any +% later version. The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% The list of all files belonging to the `Hyperref Bundle' is +% given in the file `manifest.txt'. +% +% Please send error reports and suggestions for improvements to +% Heiko Oberdiek <oberdiek@ruf.uni-freiburg.de>. +% +\NeedsTeXFormat{LaTeX2e} +\ProvidesFile{testbma.tex}[2000/07/04 v1.0 Test bookmark artefacts (HO)] +\documentclass[12pt]{article} +\usepackage{graphicx} +\usepackage[unicode]{hyperref} +\ifx\dimexpr\undefined + \usepackage{calc} +\fi +\hypersetup{ + pdftitle={Bookmark artefacts of AcrobatReader}, + pdfsubject={Unicode pdf bookmarks}, + pdfauthor={Heiko Oberdiek}, + pdfkeywords={PDF,bookmark,unicode}, + pdfstartview= + {FitH \hypercalcbp{\paperheight-\topmargin-1in-\headheight}}, + bookmarksopen +} +\usepackage{xspace} +\usepackage{times} +\pagestyle{empty} +\newcounter{abc} +\setcounter{abc}{0} +\newcommand*{\test}[1]{% + \stepcounter{abc}% + \pdfbookmark[2]{#1}{x.\theabc}% +} +\newenvironment{testsec}[1]{% + \stepcounter{abc}% + \pdfbookmark[1]{#1}{sec.\theabc}% + \textbf{#1}\par +}{ + \clearpage +} +\newcommand*\x[2]{{} #1-#2 \xspace} +\newcommand{\dotest}{% + \testskip + \test{\A\a} + \test{\B\b} + \test{\A\B} + \test{\a\b} + \test{\A\a\B\b} + \test{\B\b\A\a} +} +\newenvironment{testtab}{% + \begin{tabular}{l@{\quad=\quad}ll}% +}{% + \end{tabular}% + \par +} +\newcommand*{\testpic}[1]{% + \testskip + \fbox{\includegraphics[width=.8\linewidth]{#1}}% +} +\newcommand{\testskip}{% + \vspace{3ex plus 1ex minus .5ex}% +} +\setlength{\parindent}{0pt} +\begin{document} +\centering +\huge +\begin{testsec}{OE oe} + \def\A{\x A{\80\226}} + \def\a{\x a{\80\234}} + \def\B{\x B{\81\122}} + \def\b{\x b{\81\123}} + \dotest + \begin{testtab} + A&\verb+\80\226+&(OE)\\ + a&\verb+\80\234+&(oe)\\ + B&\verb+\81\122+&(OE)\\ + b&\verb+\81\123+&(oe)\\ + \end{testtab} + \testpic{bmoe} +\end{testsec} +\begin{testsec}{Scaron scaron} + \def\A{\x A{\80\227}} + \def\a{\x a{\80\235}} + \def\B{\x B{\81\140}} + \def\b{\x b{\81\141}} + \dotest + \begin{testtab} + A&\verb+\80\227+&(Scaron)\\ + a&\verb+\80\235+&(scaron)\\ + B&\verb+\81\140+&(Scaron)\\ + b&\verb+\81\141+&(scaron)\\ + \end{testtab} + \testpic{bmsc} +\end{testsec} +\begin{testsec}{Zcaron zcaron} + \def\A{\x A{\80\231}} + \def\a{\x a{\80\236}} + \def\B{\x B{\81\175}} + \def\b{\x b{\81\176}} + \dotest + \begin{testtab} + A&\verb+\80\231+&(Zcaron)\\ + a&\verb+\80\236+&(zcaron)\\ + B&\verb+\81\175+&(Zcaron)\\ + b&\verb+\81\176+&(zcaron)\\ + \end{testtab} + \testpic{bmzc} +\end{testsec} +\begin{testsec}{Ydieresis dotlessi} + \def\A{\x A{\80\230}} + \def\a{\x a{\80\232}} + \def\B{\x B{\81\170}} + \def\b{\x b{\81\061}} + \dotest + \begin{testtab} + A&\verb+\80\230+&(Ydieresis)\\ + a&\verb+\80\232+&(dotlessi)\\ + B&\verb+\81\170+&(Ydieresis)\\ + b&\verb+\81\061+&(dotlessi)\\ + \end{testtab} + \testpic{bmyi} +\end{testsec} +\begin{testsec}{Lslash lslash} + \def\A{\x A{\80\225}} + \def\a{\x a{\80\233}} + \def\B{\x B{\81\101}} + \def\b{\x b{\81\102}} + \dotest + \begin{testtab} + A&\verb+\80\225+&(Lslash)\\ + a&\verb+\80\233+&(lslash)\\ + B&\verb+\81\101+&(Lslash)\\ + b&\verb+\81\102+&(lslash)\\ + \end{testtab} + \testpic{bml} +\end{testsec} +\end{document}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbmgl.tex b/Master/texmf-dist/doc/latex/hyperref/test/testbmgl.tex new file mode 100644 index 00000000000..f971606fab2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbmgl.tex @@ -0,0 +1,522 @@ +% testbmgl.tex +% +% Function: +% * How display a pdf reader the bookmarks? +% * Do hyperref.sty and pd1enc.def work properly? +% * Shows the LaTeX code to get the glyphs. +% +% Copyright (c) 1999, 2000 by Heiko Oberdiek. +% +% This file is part of the `Hyperref Bundle'. +% ------------------------------------------- +% +% It may be distributed under the conditions of the LaTeX Project Public +% License, either version 1.2 of this license or (at your option) any +% later version. The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% The list of all files belonging to the `Hyperref Bundle' is +% given in the file `manifest.txt'. +% +% Please send error reports and suggestions for improvements to +% Heiko Oberdiek <oberdiek@ruf.uni-freiburg.de>. +% +\NeedsTeXFormat{LaTeX2e} +\ProvidesFile{testbmgl.tex}[2000/03/31 v1.2 Test bookmark glyphs (HO)] +\documentclass[12pt,a4paper]{article} +\usepackage[ + bookmarks, + colorlinks, +]{hyperref}[1999/08/31]% v6.65d or later +\pdfstringdefDisableCommands{\let\\\textbackslash} +\IfFileExists{times.sty}{\usepackage{times}}{} +\pagestyle{empty} + +\makeatletter +% from doc.sty: +\def\GetFileInfo#1{% + \def\filename{#1}% + \def\@tempb##1 ##2 ##3\relax##4\relax{% + \def\filedate{##1}% + \def\fileversion{##2}% + \def\fileinfo{##3}% + }% + \edef\@tempa{\csname ver@#1\endcsname}% + \expandafter\@tempb\@tempa\relax? ? \relax\relax +} +\GetFileInfo{testbmgl.tex} +\hypersetup{ + pdftitle={\fileinfo}, + pdfsubject={\filename\space[\filedate\space\fileversion]}, + pdfauthor={Heiko Oberdiek}, + pdfkeywords={bookmarks hyperref PDFDocEncoding glyph slot}, +} + +\edef\BackSlash{\expandafter\@car\string\\\@nil}% +\edef\0{\string\0}% +\edef\1{\string\1}% +\edef\2{\string\2}% +\edef\3{\string\3}% + +\newcommand*\oct[2]{% + \typeout{Processing glyphs #1#20..#1#27}% + \begingroup + \edef\x{\csname#1\endcsname#2}% + \pdfbookmark[1]{#1#20..#1#27: + \_\x0\_\x1\_\x2\_\x3\_\x4\_\x5\_\x6\_\x7\_% + }{#1#2}% + \endgroup +} + +\newcommand*{\@defbookmarkverbcmd}[2]{% + \def#1{#2}% + \edef#1{\expandafter\strip@prefix\meaning#1}% + \edef#1{\expandafter\@removespace#1 \| \|\@nil#1}% + \edef\first{\expandafter\@car#1\@nil}% + \ifx\first\BackSlash + \edef#1{\noexpand\textbackslash\expandafter\@gobble#1}% + \fi +} +\def\@removespace#1 \|#2\@nil#3{\ifx\relax#2\relax#3\else#1\fi} + +\newcounter{alias} +\renewcommand{\thealias}{\alph{alias}} + +% #1#2#3: octal code +% #4: glyph name +% #5: pd1enc-command +\newcommand*\E[6]{% + \setcounter{alias}{0}% + \begingroup + \@defbookmarkverbcmd\x{#5}% + \def\comment{#6}% + \ifx\comment\@empty + \else + \def\comment{ (#6)}% + \fi + \pdfbookmark[2]{% + \textbackslash#1#2#3: + \_\csname#1\endcsname#2#3\_#5\_ + #4 - \x\comment}{#1#2#3}% + \endgroup + \renewcommand*{\alias}[2][]{% + \stepcounter{alias}% + \begingroup + \ifx\relax##1\relax% + \@defbookmarkverbcmd\x{##2}% + \else + \def\x{##1}% + \fi + \pdfbookmark[3]{alias: \_##2\_ \x}{#1#2#3\thealias}% + \endgroup + }% +} +\newcommand*\alias[2][]{} +\newcommand*\e[5]{\E#1#2#3{#4}{#5}{}}% + +\newcommand*\un[3]{% + \pdfbookmark[2]{\textbackslash#1#2#3: unused % + (\_\csname#1\endcsname#2#3\_)}{#1#2#3}% +} + +\newcounter{symlist} +\newcounter{symbol}[symlist] +\newcommand*\symlist[1]{% + \stepcounter{symlist}% + \typeout{Processing symbol list \thesymlist}% + \begingroup + \def\x{\_}% + \@tfor\glyph:=#1\do{% + \expandafter\@addtox\glyph\_\@nil + }% + \pdfbookmark[1]{Symbols: \x}{symbol-\thesymlist}% + \@tfor\glyph:=#1\do{% + \stepcounter{symbol}% + \expandafter\@defbookmarkverbcmd\expandafter\x\expandafter{\glyph}% + \pdfbookmark[2]{\_\glyph\_ \x}{symbol-\thesymlist.\thesymbol}% + }% + \endgroup +} +\def\@addtox#1\@nil{% + \expandafter\def\expandafter\x\expandafter{\x#1}% +} + +\makeatother + +\begin{document} + \oct00 + \un000 + \un001 + \un002 + \un003 + \un004 + \un005 + \un006 + \un007 + \oct01 + \e010{back space}\textBS + \e011{horizontal tab}\textHT + \e012{line feed}\textLF + \un013 + \e014{form feed}\textFF + \e015{carriage return}\textCR + \un016 + \un017 + \oct02 + \un020 + \un021 + \un022 + \un023 + \un024 + \un025 + \un026 + \un027 + \oct03 + \e030{breve}\textbreve + \e031{caron}\textcaron + \alias{\v{}} + \e032{circumflex}\textcircumflex + \alias{\^{}} + \e033{dotaccent}\textdotaccent + \alias{\.{}} + \e034{hungarumlaut}\texthungarumlaut + \e035{ogonek}\textogonek + \e036{ring}\textring + \alias{\r{}} + \e037{tilde}\texttilde + \alias{\~{}} + \oct04 + \e040{space}\space + \alias[\\\space]\ + \alias~ + \e041{exclam}! + \e042{quotedbl}\textquotedbl + \e043{numbersign}\textnumbersign + \alias[\textbackslash\#]\# + \e044{dollar}\textdollar + \alias[\textbackslash\$]\$ + \e045{percent}\textpercent + \alias[\textbackslash\%]\% + \e046{ampersand}\textampersand + \alias[\textbackslash\&]\& + \e047{quotesingle}' + \oct05 + \e050{parenleft}\textparenleft + \e051{parenright}\textparenright + \e052{asterisk}* + \e053{plus}+ + \e054{comma}, + \e055{hyphen}- + \e056{period}. + \e057{slash}/ + \oct06 + \e060{zero}0 + \e061{one}1 + \e062{two}2 + \e063{three}3 + \e064{four}4 + \e065{five}5 + \e066{six}6 + \e067{seven}7 + \oct07 + \e070{eight}8 + \e071{nine}9 + \e072{colon}: + \e073{semicolon}; + \e074{less}\textless + \alias< + \e075{equal}= + \e076{greater}\textgreater + \alias> + \e077{question}? + \oct10 + \e100{at}@ + \e101AA + \e102BB + \e103CC + \e104DD + \e105EE + \e106FF + \e107GG + \oct11 + \e110HH + \e111II + \e112JJ + \e113KK + \e114LL + \e115MM + \e116NN + \e117OO + \oct12 + \e120PP + \e121QQ + \e122RR + \e123SS + \e124TT + \e125UU + \e126VV + \e127WW + \oct13 + \e130XX + \e131YY + \e132ZZ + \e133{bracketleft}[ + \e134{backslash}\textbackslash + \alias[\\\\]\\ + \e135{bracketright}] + \e136{asciicircum}\textasciicircum + \e137{underscore}\textunderscore + \alias[\textbackslash\_]\_ + \oct14 + \e140{grave}\textgrave + \alias{\`{}} + \e141aa + \e142bb + \e143cc + \e144dd + \e145ee + \e146ff + \e147gg + \oct15 + \e150hh + \e151ii + \e152jj + \e153kk + \e154ll + \e155mm + \e156nn + \e157oo + \oct16 + \e160pp + \e161qq + \e162rr + \e163ss + \e164tt + \e165uu + \e166vv + \e167ww + \oct17 + \e170xx + \e171yy + \e172zz + \e173{braceleft}\textbraceleft + \alias[\textbackslash\{]\{ + \e174{bar}\textbar + \e175{braceright}\textbraceright + \alias[\textbackslash\}]\} + \e176{asciitilde}\textasciitilde + \un177 + \oct20 + \e200{bullet}\textbullet + \e201{dagger}\textdagger + \e202{daggerdbl}\textdaggerdbl + \e203{ellipsis}\textellipsis + \alias\dots + \alias\ldots + \e204{emdash}\textemdash + \e205{endash}\textendash + \e206{florin}\textflorin + \e207{fraction}\textfractionmark + \oct21 + \e210{guilsinglleft}\guilsinglleft + \e211{guilsinglright}\guilsinglright + \e212{minus}\textminus + \e213{perthousand}\textperthousand + \e214{quotedblbase}\quotedblbase + \alias\textglqq + \alias\glqq + \e215{quotedblleft}\textquotedblleft + \alias\textgrqq + \alias\grqq + \e216{quotedblright}\textquotedblright + \e217{quoteleft}\textquoteleft + \oct22 + \e220{quoteright}\textquoteright + \e221{quotesinglbase}\quotesinglbase + \e222{trademark}\texttrademark + \e223{fi}\textfi + \e224{fl}\textfl + \e225{Lslash}\L + \e226{OE}\OE + \e227{Scaron}{\v S} + \oct23 + \e230{Ydieresis}{\"Y} + \E231{Zcaron}{\v Z}{PDF 1.3} + \e232{dotlessi}\i + \e233{lslash}\l + \e234{oe}\oe + \e235{scaron}{\v s} + \E236{zcaron}{\v z}{PDF 1.3} + \un237 + \oct24 + \E240{Euro}{\texteuro}{PDF 1.3} + \e241{exclamdown}\textexclamdown + \alias[!{}']{!`} + \e242{cent}\textcent + \e243{sterling}\textsterling + \e244{currency}\textcurrency + \e245{yen}\textyen + \e246{brokenbar}\textbrokenbar + \e247{section}\textsection + \oct25 + \e250{dieresis}\textdieresis + \alias{\"{}} + \e251{copyright}\textcopyright + \e252{ordfeminine}\textordfeminine + \e253{guillemotleft}\guillemotleft + \alias\textflqq + \alias\flqq + \e254{logicalnot}\textlogicalnot + \alias\textneg + \un255 + \e256{registered}\textregistered + \e257{macron}\textmacron + \oct26 + \e260{degree}\textdegree + \e261{plusminus}\textplusminus + \alias\textpm + \e262{twosuperior}\texttwosuperior + \e263{threesuperior}\textthreesuperior + \e264{acute}\textacute + \alias{\'{}} + \e265{mu}\textmu + \e266{paragraph}\textparagraph + \alias\P + \e267{periodcentered}\textperiodcentered + \alias\textcdot + \oct27 + \e270{cedilla}\textcedilla + \alias{\c{}} + \e271{onesuperior}\textonesuperior + \e272{ordmasculine}\textordmasculine + \e273{guillemotright}\guillemotright + \alias\textfrqq + \alias\frqq + \e274{onequarter}\textonequarter + \e275{onehalf}\textonehalf + \e276{threequarters}\textthreequarters + \e277{questiondown}\textquestiondown + \alias[?{}']{?`} + \oct30 + \e300{Agrave}{\`A} + \e301{Aacute}{\'A} + \e302{Acircumflex}{\^A} + \e303{Atilde}{\~A} + \e304{Adieresis}{\"A} + \e305{Aring}{\r A} + \e306{AE}{\AE} + \e307{Ccedilla}{\c C} + \oct31 + \e310{Egrave}{\`E} + \e311{Eacute}{\'E} + \e312{Ecircumflex}{\^E} + \e313{Edieresis}{\"E} + \e314{Igrave}{\`I} + \e315{Iacute}{\'I} + \e316{Icircumflex}{\^I} + \e317{Idieresis}{\"I} + \oct32 + \e320{Eth}\DH + \alias\DJ + \e321{Ntilde}{\~N} + \e322{Ograve}{\`O} + \e323{Oacute}{\'O} + \e324{Ocircumflex}{\^O} + \e325{Otilde}{\~O} + \e326{Odieresis}{\"O} + \e327{multiply}\textmultiply + \alias\texttimes + \oct33 + \e330{Oslash}\O + \e331{Ugrave}{\`U} + \e332{Uacute}{\'U} + \e333{Ucircumflex}{\^U} + \e334{Udieresis}{\"U} + \e335{Yacute}{\'Y} + \e336{Thorn}\TH + \e337{germandbls}\ss + \alias\textbeta + \oct34 + \e340{agrave}{\`a} + \e341{aacute}{\'a} + \e342{acircumflex}{\^a} + \e343{atilde}{\~a} + \e344{adieresis}{\"a} + \e345{aring}{\r a} + \e346{ae}{\ae} + \e347{ccedilla}{\c c} + \oct35 + \e350{egrave}{\`e} + \e351{eacute}{\'e} + \e352{ecircumflex}{\^e} + \e353{edieresis}{\"e} + \e354{igrave}{\`i} + \alias[\\`\\i]{\`\i} + \e355{iacute}{\'i} + \alias[\\'\\i]{\'\i} + \e356{icircumflex}{\^i} + \alias[\\\textcircumflex\\i]{\^\i} + \e357{idieresis}{\"i} + \alias[\\"\\i]{\"\i} + \oct36 + \e360{eth}\dh + \e361{ntilde}{\~n} + \e362{ograve}{\`o} + \e363{oacute}{\'o} + \e364{ocircumflex}{\^o} + \e365{otilde}{\~o} + \e366{odieresis}{\"o} + \e367{divide}\textdivide + \alias\textdiv + \oct37 + \e370{oslash}\o + \e371{ugrave}{\`u} + \e372{uacute}{\'u} + \e373{ucircumflex}{\^u} + \e374{udieresis}{\"u} + \e375{yacute}{\'y} + \e376{thorn}\th + \e377{ydieresis}{\"y} + \symlist{\SS\textcelsius} + \symlist{\TeX\LaTeX\LaTeXe} + \symlist{\eTeX\MF\MP} + + \section*{\fileinfo} + Document: \textbf{\filename\space[\filedate\space\fileversion]} + \subsection*{Function} + This test file has several tasks: + \begin{itemize} + \item Testing package \emph{hyperref} with encoding file + \emph{pd1enc.def}. + \item Showing glyph commands and aliases that are supported by + package \emph{hyperref}. + \item Test for the pdf reader, especially \emph{AcrobatReader}. + Which glyphs of the \emph{PDFDocEncoding} are + correctly displayed? + \item These glyphs are shown that package \emph{hyperref} + replaces with simpler letters in order to avoid missing glyphs. + \end{itemize} + \subsection*{Short explanation of the bookmarks} + \begin{enumerate} + \item The outline entries of the first level show a summary of their + subentries. Second a screenshot with closed bookmarks + will contain all slots of the \emph{PDFDocEncoding}. + \item The second level of outline entries describes each slot or glyph: + \begin{enumerate} + \item \label{oct}% + Octal code of the slot in the \emph{PDFDocEncoding}. + \item The glyph is shown twice, surrounded by underscores: + The first one is produced by the octal sequence, see \ref{oct}. + The second one is the result of the higher glyph command, + see \ref{high}. + \item The glyph name of \emph{PDFDocEncoding}. + \item \label{high}% + The higher glyph \TeX-command, supported by + package \emph{hyperref}. + \end{enumerate} + \item Aliases of the glyph commands are shown as subentries of the + outline that describes the slot of that glyph command. + \end{enumerate} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbmu.tex b/Master/texmf-dist/doc/latex/hyperref/test/testbmu.tex new file mode 100644 index 00000000000..5244c372c51 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbmu.tex @@ -0,0 +1,1723 @@ +% testbmu.tex +% +% Function: +% * How display a pdf reader the bookmarks? +% * Do hyperref.sty and puenc.def work properly? +% * Shows the LaTeX code to get the glyphs. +% +% Copyright (c) 1999, 2000 by Heiko Oberdiek. +% +% This file is part of the `Hyperref Bundle'. +% ------------------------------------------- +% +% It may be distributed under the conditions of the LaTeX Project Public +% License, either version 1.2 of this license or (at your option) any +% later version. The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% The list of all files belonging to the `Hyperref Bundle' is +% given in the file `manifest.txt'. +% +% Please send error reports and suggestions for improvements to +% Heiko Oberdiek <oberdiek@ruf.uni-freiburg.de>. +% +\NeedsTeXFormat{LaTeX2e} +\ProvidesFile{testbmu.tex}[2000/03/31 v1.2 Test bookmark glyphs (HO)] +\documentclass[12pt,a4paper]{article} +\usepackage[ + unicode, + bookmarks, + bookmarksopen, + bookmarksopenlevel=0, + colorlinks, +]{hyperref}[1999/08/31]% 6.65d or later +\pdfstringdefDisableCommands{\let\\\textbackslash} +\IfFileExists{times.sty}{\usepackage{times}}{} +\pagestyle{empty} + +\makeatletter +% from doc.sty: +\def\GetFileInfo#1{% + \def\filename{#1}% + \def\@tempb##1 ##2 ##3\relax##4\relax{% + \def\filedate{##1}% + \def\fileversion{##2}% + \def\fileinfo{##3}% + }% + \edef\@tempa{\csname ver@#1\endcsname}% + \expandafter\@tempb\@tempa\relax? ? \relax\relax +} +\GetFileInfo{testbmu.tex} +\hypersetup{ + pdftitle={\fileinfo}, + pdfsubject={\filename\space[\filedate\space\fileversion]}, + pdfauthor={Heiko Oberdiek}, + pdfkeywords={bookmarks hyperref Unicode glyph slot}, +} + +\edef\BackSlash{\expandafter\@car\string\\\@nil}% +\edef\0{\string\0}% +\edef\1{\string\1}% +\edef\2{\string\2}% +\edef\3{\string\3}% +\edef\9{\string\9}% + +\newcommand*\tit[3]{% + \typeout{Unicode high byte #1#2#3}% + \def\highbyte{#1#2#3}% + \def\hb{\9#1#2#3}% + \pdfbookmark[0]{Unicode high byte: #1#2#3}{#1#2#3}% +} + +\newcommand*\oct[2]{% + \typeout{Processing glyphs \highbyte/#1#20..#1#27}% + \begingroup + \edef\x{\hb\csname#1\endcsname#2}% + \pdfbookmark[1]{\highbyte/#1#20..#1#27: + \_\x0\_\x1\_\x2\_\x3\_\x4\_\x5\_\x6\_\x7\_% + }{\highbyte.#1#2}% + \endgroup +} + +\newcommand*{\@defbookmarkverbcmd}[2]{% + \def#1{#2}% + \edef#1{\expandafter\strip@prefix\meaning#1}% + \edef#1{\expandafter\@removespace#1 \| \|\@nil#1}% + \edef\first{\expandafter\@car#1\@nil}% + \ifx\first\BackSlash + \edef#1{\noexpand\textbackslash\expandafter\@gobble#1}% + \fi + \edef#1{\expandafter\@changebackslash\expandafter{#1}}% +} +\def\@removespace#1 \|#2\@nil#3{\ifx\relax#2\relax#3\else#1\fi} +\begingroup + \catcode`\|=0 + \catcode`\\=12 + |gdef|@changebackslash#1{|@@change#1\|END}% + |gdef|@@change#1\#2|END{% + |noexpand#1|@empty + |ifx|\#2|\% + |else + |noexpand|textbackslash + |@removeback#2% + |fi + } + |gdef|@removeback#1\{#1} +|endgroup + +\newcounter{alias} +\renewcommand{\thealias}{\alph{alias}} + +% #1#2#3: octal code +% #4: glyph name +% #5: pd1enc-command +\newcommand*\E[6]{% + \setcounter{alias}{0}% + \begingroup + \@defbookmarkverbcmd\x{#5}% + \def\comment{#6}% + \ifx\comment\@empty + \else + \def\comment{ (#6)}% + \fi + \pdfbookmark[2]{% + \textbackslash#1#2#3: + \_\hb\csname#1\endcsname#2#3\_#5\_ + #4 - \x\comment}{\highbyte.#1#2#3}% + \endgroup + \renewcommand*{\alias}[2][]{% + \stepcounter{alias}% + \begingroup + \ifx\relax##1\relax% + \@defbookmarkverbcmd\x{##2}% + \else + \def\x{##1}% + \fi + \pdfbookmark[3]{alias: \_##2\_ \x}{\highbyte.#1#2#3\thealias}% + \endgroup + }% +} +\newcommand*\alias[2][]{} +\newcommand*\e[5]{\E#1#2#3{#4}{#5}{}}% + +\newcommand*\un[3]{% + \pdfbookmark[2]{\textbackslash#1#2#3: unused % + (\_\hb\csname#1\endcsname#2#3\_)}{\highbyte.#1#2#3}% +} +\newcommand*\na[3]{% + \pdfbookmark[2]{\textbackslash#1#2#3: n. a. % + (\_\hb\csname#1\endcsname#2#3\_)}{\highbyte.#1#2#3}% +} + +\newcounter{symlist} +\newcounter{symbol}[symlist] +\newcommand*\symlist[1]{% + \stepcounter{symlist}% + \typeout{Processing symbol list \thesymlist}% + \begingroup + \def\x{\_}% + \@tfor\glyph:=#1\do{% + \expandafter\@addtox\glyph\_\@nil + }% + \pdfbookmark[1]{Symbols: \x}{symbol-\thesymlist}% + \@tfor\glyph:=#1\do{% + \stepcounter{symbol}% + \expandafter\@defbookmarkverbcmd\expandafter\x\expandafter{\glyph}% + \pdfbookmark[2]{\_\glyph\_ \x}{symbol-\thesymlist.\thesymbol}% + }% + \endgroup +} +\def\@addtox#1\@nil{% + \expandafter\def\expandafter\x\expandafter{\x#1}% +} + +\makeatother + +\begin{document} + \tit000 + \oct00 + \un000 + \un001 + \un002 + \un003 + \un004 + \un005 + \un006 + \un007 + \oct01 + \e010{back space}\textBS + \e011{horizontal tab}\textHT + \e012{line feed}\textLF + \un013 + \e014{form feed}\textFF + \e015{carriage return}\textCR + \un016 + \un017 + \oct02 + \un020 + \un021 + \un022 + \un023 + \un024 + \un025 + \un026 + \un027 + \oct03 + \e030{breve}\textbreve + \e031{caron}\textcaron + \alias{\v{}} + \e032{circumflex}\textcircumflex + \alias{\^{}} + \e033{dotaccent}\textdotaccent + \alias{\.{}} + \e034{hungarumlaut}\texthungarumlaut + \e035{ogonek}\textogonek + \e036{ring}\textring + \alias{\r{}} + \e037{tilde}\texttilde + \alias{\~{}} + \oct04 + \e040{space}\space + \alias[\\\space]\ + \alias~ + \e041{exclam}! + \e042{quotedbl}\textquotedbl + \e043{numbersign}\textnumbersign + \alias[\textbackslash\#]\# + \e044{dollar}\textdollar + \alias[\textbackslash\$]\$ + \e045{percent}\textpercent + \alias[\textbackslash\%]\% + \e046{ampersand}\textampersand + \alias[\textbackslash\&]\& + \e047{quotesingle}' + \oct05 + \e050{parenleft}\textparenleft + \e051{parenright}\textparenright + \e052{asterisk}* + \e053{plus}+ + \e054{comma}, + \e055{hyphen}- + \e056{period}. + \e057{slash}/ + \oct06 + \e060{zero}0 + \e061{one}1 + \e062{two}2 + \e063{three}3 + \e064{four}4 + \e065{five}5 + \e066{six}6 + \e067{seven}7 + \oct07 + \e070{eight}8 + \e071{nine}9 + \e072{colon}: + \e073{semicolon}; + \e074{less}\textless + \alias< + \e075{equal}= + \e076{greater}\textgreater + \alias> + \e077{question}? + \oct10 + \e100{at}@ + \e101AA + \e102BB + \e103CC + \e104DD + \e105EE + \e106FF + \e107GG + \oct11 + \e110HH + \e111II + \e112JJ + \e113KK + \e114LL + \e115MM + \e116NN + \e117OO + \oct12 + \e120PP + \e121QQ + \e122RR + \e123SS + \e124TT + \e125UU + \e126VV + \e127WW + \oct13 + \e130XX + \e131YY + \e132ZZ + \e133{bracketleft}[ + \e134{backslash}\textbackslash + \alias[\\\\]\\ + \e135{bracketright}] + \e136{asciicircum}\textasciicircum + \e137{underscore}\textunderscore + \alias[\textbackslash\_]\_ + \oct14 + \e140{grave}\textgrave + \alias{\`{}} + \e141aa + \e142bb + \e143cc + \e144dd + \e145ee + \e146ff + \e147gg + \oct15 + \e150hh + \e151ii + \e152jj + \e153kk + \e154ll + \e155mm + \e156nn + \e157oo + \oct16 + \e160pp + \e161qq + \e162rr + \e163ss + \e164tt + \e165uu + \e166vv + \e167ww + \oct17 + \e170xx + \e171yy + \e172zz + \e173{braceleft}\textbraceleft + \alias[\textbackslash\{]\{ + \e174{bar}\textbar + \e175{braceright}\textbraceright + \alias[\textbackslash\}]\} + \e176{asciitilde}\textasciitilde + \un177 + \oct20 + \e200{bullet}\textbullet + \e201{dagger}\textdagger + \e202{daggerdbl}\textdaggerdbl + \e203{ellipsis}\textellipsis + \alias\dots + \alias\ldots + \e204{emdash}\textemdash + \e205{endash}\textendash + \e206{florin}\textflorin + \e207{fraction}\textfractionmark + \oct21 + \e210{guilsinglleft}\guilsinglleft + \e211{guilsinglright}\guilsinglright + \e212{minus}\textminus + \e213{perthousand}\textperthousand + \e214{quotedblbase}\quotedblbase + \alias\textglqq + \alias\glqq + \e215{quotedblleft}\textquotedblleft + \alias\textgrqq + \alias\grqq + \e216{quotedblright}\textquotedblright + \e217{quoteleft}\textquoteleft + \oct22 + \e220{quoteright}\textquoteright + \e221{quotesinglbase}\quotesinglbase + \e222{trademark}\texttrademark + \e223{fi}\textfi + \e224{fl}\textfl + \e225{Lslash}\L + \e226{OE}\OE + \e227{Scaron}{\v S} + \oct23 + \e230{Ydieresis}{\"Y} + \E231{Zcaron}{\v Z}{PDF 1.3} + \e232{dotlessi}\i + \e233{lslash}\l + \e234{oe}\oe + \e235{scaron}{\v s} + \E236{zcaron}{\v z}{PDF 1.3} + \un237 + \oct24 + \E240{Euro}{\texteuro}{PDF 1.3} + \e241{exclamdown}\textexclamdown + \alias[!{}']{!`} + \e242{cent}\textcent + \e243{sterling}\textsterling + \e244{currency}\textcurrency + \e245{yen}\textyen + \e246{brokenbar}\textbrokenbar + \e247{section}\textsection + \oct25 + \e250{dieresis}\textdieresis + \alias{\"{}} + \e251{copyright}\textcopyright + \e252{ordfeminine}\textordfeminine + \e253{guillemotleft}\guillemotleft + \alias\textflqq + \alias\flqq + \e254{logicalnot}\textlogicalnot + \alias\textneg + \un255 + \e256{registered}\textregistered + \e257{macron}\textmacron + \oct26 + \e260{degree}\textdegree + \e261{plusminus}\textplusminus + \alias\textpm + \e262{twosuperior}\texttwosuperior + \e263{threesuperior}\textthreesuperior + \e264{acute}\textacute + \alias{\'{}} + \e265{mu}\textmu + \e266{paragraph}\textparagraph + \alias\P + \e267{periodcentered}\textperiodcentered + \alias\textcdot + \oct27 + \e270{cedilla}\textcedilla + \alias{\c{}} + \e271{onesuperior}\textonesuperior + \e272{ordmasculine}\textordmasculine + \e273{guillemotright}\guillemotright + \alias\textfrqq + \alias\frqq + \e274{onequarter}\textonequarter + \e275{onehalf}\textonehalf + \e276{threequarters}\textthreequarters + \e277{questiondown}\textquestiondown + \alias[?{}']{?`} + \oct30 + \e300{Agrave}{\`A} + \e301{Aacute}{\'A} + \e302{Acircumflex}{\^A} + \e303{Atilde}{\~A} + \e304{Adieresis}{\"A} + \e305{Aring}{\r A} + \e306{AE}{\AE} + \e307{Ccedilla}{\c C} + \oct31 + \e310{Egrave}{\`E} + \e311{Eacute}{\'E} + \e312{Ecircumflex}{\^E} + \e313{Edieresis}{\"E} + \e314{Igrave}{\`I} + \e315{Iacute}{\'I} + \e316{Icircumflex}{\^I} + \e317{Idieresis}{\"I} + \oct32 + \e320{Eth}\DH + \alias\DJ + \e321{Ntilde}{\~N} + \e322{Ograve}{\`O} + \e323{Oacute}{\'O} + \e324{Ocircumflex}{\^O} + \e325{Otilde}{\~O} + \e326{Odieresis}{\"O} + \e327{multiply}\textmultiply + \alias\texttimes + \oct33 + \e330{Oslash}\O + \e331{Ugrave}{\`U} + \e332{Uacute}{\'U} + \e333{Ucircumflex}{\^U} + \e334{Udieresis}{\"U} + \e335{Yacute}{\'Y} + \e336{Thorn}\TH + \e337{germandbls}\ss + \alias\textbeta + \oct34 + \e340{agrave}{\`a} + \e341{aacute}{\'a} + \e342{acircumflex}{\^a} + \e343{atilde}{\~a} + \e344{adieresis}{\"a} + \e345{aring}{\r a} + \e346{ae}{\ae} + \e347{ccedilla}{\c c} + \oct35 + \e350{egrave}{\`e} + \e351{eacute}{\'e} + \e352{ecircumflex}{\^e} + \e353{edieresis}{\"e} + \e354{igrave}{\`i} + \alias[\\`\\i]{\`\i} + \e355{iacute}{\'i} + \alias[\\'\\i]{\'\i} + \e356{icircumflex}{\^i} + \alias[\\\textcircumflex\\i]{\^\i} + \e357{idieresis}{\"i} + \alias[\\"\\i]{\"\i} + \oct36 + \e360{eth}\dh + \e361{ntilde}{\~n} + \e362{ograve}{\`o} + \e363{oacute}{\'o} + \e364{ocircumflex}{\^o} + \e365{otilde}{\~o} + \e366{odieresis}{\"o} + \e367{divide}\textdivide + \alias\textdiv + \oct37 + \e370{oslash}\o + \e371{ugrave}{\`u} + \e372{uacute}{\'u} + \e373{ucircumflex}{\^u} + \e374{udieresis}{\"u} + \e375{yacute}{\'y} + \e376{thorn}\th + \e377{ydieresis}{\"y} + \symlist{\SS\textcelsius} + \symlist{\TeX\LaTeX\LaTeXe} + \symlist{\eTeX\MF\MP} +% + \tit001 + \oct00 + \e000{Amacron}{\=A} + \e001{amacron}{\=a} + \e002{Abreve}{\u A} + \e003{abreve}{\u a} + \e004{Aogonek}{\k A} + \e005{aogonek}{\k a} + \e006{Cacute}{\'C} + \e007{cacute}{\'c} + \oct01 + \e010{Ccircumflex}{\^C} + \e011{ccircumflex}{\^c} + \e012{Cdot}{\.C} + \e013{cdot}{\.c} + \e014{Ccaron}{\v C} + \e015{ccaron}{\v c} + \e016{Dcaron}{\v D} + \e017{dcaron}{\v d} + \oct02 + \e020{Dslash}{\DJ} + \e021{dslash}{\dj} + \e022{Emacron}{\=E} + \e023{emacron}{\=e} + \e024{Ebreve}{\u E} + \e025{ebreve}{\u e} + \e026{Edot}{\.E} + \e027{edot}{\.e} + \oct03 + \e030{Eogonek}{\k E} + \e031{eogonek}{\k e} + \e032{Ecaron}{\v E} + \e033{ecaron}{\v e} + \e034{Gcircumflex}{\^G} + \e035{gcircumflex}{\^g} + \e036{Gbreve}{\u G} + \e037{gbreve}{\u g} + \oct04 + \e040{Gdot}{\.G} + \e041{gdot}{\.g} + \e042{Gcedilla}{\c G} + \e043{gcedilla}{\c g} + \e044{Hcircumflex}{\^H} + \e045{hcircumflex}{\^h} + \e046{Hslash}\textHslash + \e047{hslash}\texthslash + \oct05 + \e050{Itilde}{\~I} + \e051{itilde}{\~i} + \alias[\\~\\i]{\~\i} + \e052{Imacron}{\=I} + \e053{imacron}{\=i} + \alias[\\=\\i]{\=\i} + \e054{Ibreve}{\u I} + \e055{ibreve}{\u i} + \alias[\\u\\i]{\u\i} + \e056{Iogonek}{\k I} + \e057{iogonek}{\k i} + \alias[\\k\\i]{\k\i} + \oct06 + \e060{Idot}{\.I} + \e061{idotless}{\i} + \na062 + \na063 + \e064{Jcircumflex}{\^J} + \e065{jcircumflex}{\^j} + \alias[\\\string^\\j]{\^\j} + \e066{Kcedilla}{\c K} + \e067{kcedilla}{\c k} + \oct07 + \na070 + \e071{Lacute}{\'L} + \e072{lacute}{\'l} + \e073{Lcedilla}{\c L} + \e074{lcedilla}{\c l} + \e075{Lcaron}{\v L} + \e076{lcaron}{\v l} + \na077 + \oct10 + \na100 + \e101{Lslash}{\L} + \e102{lslash}{\l} + \e103{Nacute}{\'N} + \e104{nacute}{\'n} + \e105{Ncedilla}{\c N} + \e106{ncedilla}{\c n} + \e107{Ncaron}{\v N} + \oct11 + \e110{ncaron}{\v n} + \na111 + \e112{NG}\NG + \e113{ng}\ng + \e114{Omacron}{\=O} + \e115{omacron}{\=o} + \e116{Obreve}{\u O} + \e117{obreve}{\u o} + \oct12 + \e120{Odoubleacute}{\H O} + \e121{odoubleacute}{\H o} + \e122{OE}{\OE} + \e123{oe}{\oe} + \e124{Racute}{\'R} + \e125{racute}{\'r} + \e126{Rcedilla}{\c R} + \e127{rcedilla}{\c r} + \oct13 + \e130{Rcaron}{\v R} + \e131{rcaron}{\v r} + \e132{Sacute}{\'S} + \e133{sacute}{\'s} + \e134{Scircumflex}{\^S} + \e135{scircumflex}{\^s} + \e136{Scedilla}{\c S} + \e137{scedilla}{\c s} + \oct14 + \e140{Scaron}{\v S} + \e141{scaron}{\v s} + \e142{Tcedilla}{\c T} + \e143{tcedilla}{\c t} + \e144{Tcaron}{\v T} + \e145{tcaron}{\v t} + \e146{Tslash}{\textTslash} + \e147{tslash}{\texttslash} + \oct15 + \e150{Utilde}{\~U} + \e151{utilde}{\~u} + \e152{Umacron}{\=U} + \e153{umacron}{\=u} + \e154{Ubreve}{\u U} + \e155{ubreve}{\u u} + \e156{Uring}{\r U} + \e157{uring}{\r u} + \oct16 + \e160{Udoubleacute}{\H U} + \e161{udoubleacute}{\H u} + \e162{Uogonek}{\k U} + \e163{uogonek}{\k u} + \e164{Wcircumflex}{\^W} + \e165{wcircumflex}{\^w} + \e166{Ycircumflex}{\^Y} + \e167{ycircumflex}{\^y} + \oct17 + \e170{Ydieresis}{\"Y} + \e171{Zacute}{\'Z} + \e172{zacute}{\'z} + \e173{Zdot}{\.Z} + \e174{zdot}{\.z} + \e175{Zcaron}{\v Z} + \e176{zcaron}{\v z} + \na177 + \oct20 + \na200 + \na201 + \na202 + \na203 + \na204 + \na205 + \na206 + \na207 + \oct21 + \na210 + \na211 + \na212 + \na213 + \na214 + \na215 + \na216 + \na217 + \oct22 + \na220 + \na221 + \na222 + \na223 + \na224 + \na225 + \na226 + \na227 + \oct23 + \na230 + \na231 + \na232 + \na233 + \na234 + \na235 + \na236 + \na237 + \oct24 + \na240 + \na241 + \na242 + \na243 + \na244 + \na245 + \na246 + \na247 + \oct25 + \na250 + \na251 + \na252 + \na253 + \na254 + \na255 + \na256 + \na257 + \oct26 + \na260 + \na261 + \na262 + \na263 + \na264 + \na265 + \na266 + \na267 + \oct27 + \na270 + \na271 + \na272 + \na273 + \na274 + \na275 + \na276 + \na277 + \oct30 + \na300 + \na301 + \na302 + \na303 + \na304 + \na305 + \na306 + \na307 + \oct31 + \na310 + \na311 + \na312 + \na313 + \na314 + \e315{Acaron}{\v A} + \e316{acaron}{\v a} + \e317{Icaron}{\v I} + \oct32 + \e320{icaron}{\v i} + \alias[\\v\\i]{\v\i} + \e321{Ocaron}{\v O} + \e322{ocaron}{\v o} + \e323{Ucaron}{\v U} + \e324{ucaron}{\v u} + \na325 + \na326 + \na327 + \oct33 + \na330 + \na331 + \na332 + \na333 + \na334 + \na335 + \na336 + \na337 + \oct34 + \na340 + \na341 + \na342 + \na343 + \e344{Gslash}{\textGslash} + \e345{gslash}{\textgslash} + \e346{Gcaron}{\v G} + \e347{gcaron}{\v g} + \oct35 + \e350{Kcaron}{\v K} + \e351{kcaron}{\v k} + \e352{Oogonek}{\k O} + \e353{oogonek}{\k o} + \na354 + \na355 + \na356 + \na357 + \oct36 + \na360 + \na361 + \na362 + \na363 + \na364 + \na365 + \na366 + \na367 + \oct37 + \na370 + \na371 + \na372 + \na373 + \na374 + \na375 + \na376 + \na377 +% + \tit002 + \oct00 + \na000 + \na001 + \na002 + \na003 + \na004 + \na005 + \na006 + \na007 + \oct01 + \na010 + \na011 + \na012 + \na013 + \na014 + \na015 + \na016 + \na017 + \oct02 + \na020 + \na021 + \na022 + \na023 + \na024 + \na025 + \na026 + \na027 + \oct03 + \na030 + \na031 + \na032 + \na033 + \na034 + \na035 + \na036 + \na037 + \oct04 + \na040 + \na041 + \na042 + \na043 + \na044 + \na045 + \na046 + \na047 + \oct05 + \na050 + \na051 + \na052 + \na053 + \na054 + \na055 + \na056 + \na057 + \oct06 + \na060 + \na061 + \na062 + \na063 + \na064 + \na065 + \na066 + \na067 + \oct07 + \na070 + \na071 + \na072 + \na073 + \na074 + \na075 + \na076 + \na077 + \oct10 + \na100 + \na101 + \na102 + \na103 + \na104 + \na105 + \na106 + \na107 + \oct11 + \na110 + \na111 + \na112 + \na113 + \na114 + \na115 + \na116 + \na117 + \oct12 + \na120 + \na121 + \na122 + \na123 + \na124 + \na125 + \na126 + \na127 + \oct13 + \na130 + \na131 + \na132 + \na133 + \na134 + \na135 + \na136 + \na137 + \oct14 + \na140 + \na141 + \na142 + \na143 + \na144 + \na145 + \na146 + \na147 + \oct15 + \na150 + \na151 + \na152 + \na153 + \na154 + \na155 + \na156 + \na157 + \oct16 + \na160 + \na161 + \na162 + \na163 + \na164 + \na165 + \na166 + \na167 + \oct17 + \na170 + \na171 + \na172 + \na173 + \na174 + \na175 + \na176 + \na177 + \oct20 + \na200 + \na201 + \na202 + \na203 + \na204 + \na205 + \na206 + \na207 + \oct21 + \na210 + \na211 + \na212 + \na213 + \na214 + \na215 + \na216 + \na217 + \oct22 + \na220 + \na221 + \na222 + \na223 + \na224 + \na225 + \na226 + \na227 + \oct23 + \na230 + \na231 + \na232 + \na233 + \na234 + \na235 + \na236 + \na237 + \oct24 + \na240 + \na241 + \na242 + \na243 + \na244 + \na245 + \na246 + \na247 + \oct25 + \na250 + \na251 + \na252 + \na253 + \na254 + \na255 + \na256 + \na257 + \oct26 + \na260 + \na261 + \na262 + \na263 + \na264 + \na265 + \na266 + \na267 + \oct27 + \na270 + \na271 + \na272 + \na273 + \na274 + \na275 + \na276 + \na277 + \oct30 + \na300 + \na301 + \na302 + \na303 + \na304 + \na305 + \na306 + \na307 + \oct31 + \na310 + \na311 + \na312 + \na313 + \na314 + \na315 + \na316 + \na317 + \oct32 + \na320 + \na321 + \na322 + \na323 + \na324 + \na325 + \na326 + \na327 + \oct33 + \na330 + \na331 + \na332 + \na333 + \na334 + \na335 + \na336 + \na337 + \oct34 + \na340 + \na341 + \na342 + \na343 + \na344 + \na345 + \na346 + \na347 + \oct35 + \na350 + \na351 + \na352 + \na353 + \na354 + \na355 + \na356 + \na357 + \oct36 + \na360 + \na361 + \na362 + \na363 + \na364 + \na365 + \na366 + \na367 + \oct37 + \na370 + \na371 + \na372 + \na373 + \na374 + \na375 + \na376 + \na377 +% + \tit003 + \oct00 + \na000 + \na001 + \na002 + \na003 + \na004 + \na005 + \na006 + \na007 + \oct01 + \na010 + \na011 + \na012 + \na013 + \na014 + \na015 + \na016 + \na017 + \oct02 + \na020 + \na021 + \na022 + \na023 + \na024 + \na025 + \na026 + \na027 + \oct03 + \na030 + \na031 + \na032 + \na033 + \na034 + \na035 + \na036 + \na037 + \oct04 + \na040 + \na041 + \na042 + \na043 + \na044 + \na045 + \na046 + \na047 + \oct05 + \na050 + \na051 + \na052 + \na053 + \na054 + \na055 + \na056 + \na057 + \oct06 + \na060 + \na061 + \na062 + \na063 + \na064 + \na065 + \na066 + \na067 + \oct07 + \na070 + \na071 + \na072 + \na073 + \na074 + \na075 + \na076 + \na077 + \oct10 + \na100 + \na101 + \na102 + \na103 + \na104 + \na105 + \na106 + \na107 + \oct11 + \na110 + \na111 + \na112 + \na113 + \na114 + \na115 + \na116 + \na117 + \oct12 + \na120 + \na121 + \na122 + \na123 + \na124 + \na125 + \na126 + \na127 + \oct13 + \na130 + \na131 + \na132 + \na133 + \na134 + \na135 + \na136 + \na137 + \oct14 + \na140 + \na141 + \na142 + \na143 + \na144 + \na145 + \na146 + \na147 + \oct15 + \na150 + \na151 + \na152 + \na153 + \na154 + \na155 + \na156 + \na157 + \oct16 + \na160 + \na161 + \na162 + \na163 + \na164 + \na165 + \na166 + \na167 + \oct17 + \na170 + \na171 + \na172 + \na173 + \na174 + \na175 + \na176 + \na177 + \oct20 + \na200 + \na201 + \na202 + \na203 + \na204 + \na205 + \e206{Alpha tonos}{\'\textAlpha} + \na207 + \oct21 + \e210{Epsilon tonos}{\'\textEpsilon} + \e211{Eta tonos}{\'\textEta} + \e212{Iota tonos}{\'\textIota} + \na213 + \e214{Omicron tonos}{\'\textOmicron} + \na215 + \e216{Upsilon tonos}{\'\textUpsilon} + \e217{Omega tonos}{\'\textOmega} + \oct22 + \e220{Iota dialytika tonos}{\'\textIotadieresis} + \e221{Alpha}\textAlpha + \e222{Beta}\textBeta + \e223{Gamma}\textGamma + \e224{Delta}\textDelta + \e225{Epsilon}\textEpsilon + \e226{Zeta}\textZeta + \e227{Eta}\textEta + \oct23 + \e230{Theta}\textTheta + \e231{Iota}\textIota + \e232{Kappa}\textKappa + \e233{Lambda}\textLambda + \e234{Mu}\textMu + \e235{Nu}\textNu + \e236{Xi}\textXi + \e237{Omicron}\textOmicron + \oct24 + \e240{Pi}\textPi + \e241{Rho}\textRho + \na242 + \e243{Sigma}\textSigma + \e244{Tau}\textTau + \e245{Upsilon}\textUpsilon + \e246{Phi}\textPhi + \e247{Chi}\textChi + \oct25 + \e250{Psi}\textPsi + \e251{Omega}\textOmega + \e252{Iota dialytika}{\"\textIota} + \e253{Upsilon dialytika}{\"\textUpsilon} + \e254{alpha tonos}{\'\textalpha} + \e255{epsilon tonos}{\'\textepsilon} + \e256{eta tonos}{\'\texteta} + \e257{iota tonos}{\'\textiota} + \oct26 + \e260{upsilon dialytika tonos}{\"\textupsilonacute} + \e261{alpha}\textalpha + \e262{beta}\textbeta + \e263{gamma}\textgamma + \e264{delta}\textdelta + \e265{epsilon}\textepsilon + \e266{zeta}\textzeta + \e267{eta}\texteta + \oct27 + \e270{theta}\texttheta + \e271{iota}\textiota + \e272{kappa}\textkappa + \e273{lambda}\textlambda + \e274{mu}\textmu + \e275{nu}\textnu + \e276{xi}\textxi + \e277{omicron}\textomicron + \oct30 + \e300{pi}\textpi + \e301{rho}\textrho + \e302{varsigma}\textvarsigma + \e303{sigma}\textsigma + \e304{tau}\texttau + \e305{upsilon}\textupsilon + \e306{phi}\textphi + \e307{chi}\textchi + \oct31 + \e310{psi}\textpsi + \e311{omega}\textomega + \e312{iota dialytika}{\"\textiota} + \e313{upsilon dialytika}{\"\textupsilon} + \e314{omicron tonos}{\'\textomicron} + \e315{upsilon tonos}{\'\textupsilon} + \e316{omega tonos}{\'\textomega} + \na317 + \oct32 + \na320 + \na321 + \na322 + \na323 + \na324 + \na325 + \na326 + \na327 + \oct33 + \na330 + \na331 + \na332 + \na333 + \na334 + \na335 + \na336 + \na337 + \oct34 + \na340 + \na341 + \na342 + \na343 + \na344 + \na345 + \na346 + \na347 + \oct35 + \na350 + \na351 + \na352 + \na353 + \na354 + \na355 + \na356 + \na357 + \oct36 + \na360 + \na361 + \na362 + \na363 + \na364 + \na365 + \na366 + \na367 + \oct37 + \na370 + \na371 + \na372 + \na373 + \na374 + \na375 + \na376 + \na377 +% + \tit004 + \oct00 + \na000 + \e001{IO}\CYRYO + \alias[\\"\\CYRE]{\"\CYRE} + \e002{DJE}\CYRDJE + \e003{GJE}{\'\CYRG} + \e004{ukrainian IE}\CYRIE + \e005{DZE}\CYRDZE + \e006{byelorussian-ukrainian I}\CYRII + \e007{YI}\CYRYI + \oct01 + \e010{JE}\CYRJE + \e011{LJE}\CYRLJE + \e012{NJE}\CYRNJE + \e013{TSHE}\CYRTSHE + \e014{KJE}{\'\CYRK} + \na015 + \e016{short U}\CYRUSHRT + \e017{DZHE}\CYRDZHE + \oct02 + \e020{A}\CYRA + \e021{BE}\CYRB + \e022{VE}\CYRV + \e023{GHE}\CYRG + \e024{DE}\CYRD + \e025{IE}\CYRE + \e026{ZHE}\CYRZH + \e027{ZE}\CYRZ + \oct03 + \e030{I}\CYRI + \e031{short I}\CYRISHRT + \alias[\\U\\CYRI]{\U\CYRI} + \e032{KA}\CYRK + \e033{EL}\CYRL + \e034{EM}\CYRM + \e035{EN}\CYRN + \e036{O}\CYRO + \e037{PE}\CYRP + \oct04 + \e040{ER}\CYRR + \e041{ES}\CYRS + \e042{TE}\CYRT + \e043{U}\CYRU + \e044{EF}\CYRF + \e045{HA}\CYRH + \e046{TSE}\CYRC + \e047{CHE}\CYRCH + \oct05 + \e050{SHA}\CYRSH + \e051{SHCHA}\CYRSHCH + \e052{HARD SIGN}\CYRHRDSN + \e053{YERU}\CYRERY + \e054{SOFT SIGN}\CYRSFTSN + \e055{E}\CYREREV + \e056{YU}\CYRYU + \e057{YA}\CYRYA + \oct06 + \e060{a}\cyra + \e061{be}\cyrb + \e062{ve}\cyrv + \e063{ghe}\cyrg + \e064{de}\cyrd + \e065{ie}\cyre + \e066{zhe}\cyrzh + \e067{ze}\cyrz + \oct07 + \e070{i}\cyri + \e071{short i}\cyrishrt + \alias[\\U\\cyri]{\U\cyri} + \e072{ka}\cyrk + \e073{el}\cyrl + \e074{em}\cyrm + \e075{en}\cyrn + \e076{o}\cyro + \e077{pe}\cyrp + \oct10 + \e100{er}\cyrr + \e101{es}\cyrs + \e102{te}\cyrt + \e103{u}\cyru + \e104{ef}\cyrf + \e105{ha}\cyrh + \e106{tse}\cyrc + \e107{che}\cyrch + \oct11 + \e110{sha}\cyrsh + \e111{shcha}\cyrshch + \e112{hard sign}\cyrhrdsn + \e113{yeru}\cyrery + \e114{soft sign}\cyrsftsn + \e115{e}\cyrerev + \e116{yu}\cyryu + \e117{ya}\cyrya + \oct12 + \na120 + \e121{io}\cyryo + \e122{dje}\cyrdje + \e123{gje}{\'\cyrg} + \e124{ukrainian ie}\cyrie + \e125{dze}\cyrdze + \e126{byelorussian-ukrainian i}\cyrii + \e127{yi}\cyryi + \oct13 + \e130{je}\cyrje + \e131{lje}\cyrlje + \e132{nje}\cyrnje + \e133{tshe}\cyrtshe + \e134{kje}{\'\cyrk} + \na135 + \e136{short u}\cyrushrt + \e137{dzhe}\cyrdzhe + \oct14 + \e140{OMEGA}\CYROMEGA + \e141{omega}\cyromega + \e142{YAT}\CYRYAT + \e143{yat}\cyryat + \e144{iotified E}\CYRIOTE + \e145{iotified e}\cyriote + \e146{little YUS}\CYRLYUS + \e147{little yus}\cyrlyus + \oct15 + \e150{iotified little YUS}\CYRIOTLYUS + \e151{iotified little yos}\cyriotlyus + \e152{big YUS}\CYRBYUS + \e153{big yus}\cyrbyus + \e154{iotified big YUS}\CYRIOTBYUS + \e155{iotified big yus}\cyriotbyus + \e156{KSI}\CYRKSI + \e157{ksi}\cyrksi + \oct16 + \e160{PSI}\CYRPSI + \e161{psi}\cyrpsi + \e162{FITA}\CYRFITA + \e163{fita}\cyrfita + \e164{IZHISA}\CYRIZH + \e165{izhisa}\cyrizh + \e166{IZHISA double grave}{\C\CYRIZH} + \e167{izhisa double grave}{\C\cyrizh} + \oct17 + \e170{UK}\CYRUK + \e171{uk}\cyruk + \e172{round OMEGA}\CYROMEGARND + \e173{round omega}\cyromegarnd + \e174{OMEGA titlo}\CYROMEGATITLO + \e175{omega titlo}\cyromegatitlo + \e176{OT}\CYROT + \e177{ot}\cyrot + \oct20 + \e200{KOPPA}\CYRKOPPA + \e201{koppa}\cyrkoppa + \e202{thousands sign}\cyrthousands + \na203 + \na204 + \na205 + \na206 + \na207 + \oct21 + \na210 + \na211 + \na212 + \na213 + \na214 + \na215 + \na216 + \na217 + \oct22 + \e220{GHE upturn}\CYRGUP + \e221{ghe upturn}\cyrgup + \e222{GHE stroke}\CYRGHCRS + \e223{ghe stroke}\cyrghcrs + \e224{GHE middle hook}\CYRGHK + \e225{ghe middle hook}\cyrghk + \e226{ZHE descender}\CYRZHDSC + \e227{zhe descender}\cyrzhdsc + \oct23 + \e230{ZE descender}\CYRZDSC + \e231{ze descender}\cyrzdsc + \e232{KA descender}\CYRKDSC + \e233{ka descender}\cyrkdsc + \e234{KA vertical stroke}\CYRKVCRS + \e235{ka vertical stroke}\cyrkvcrs + \e236{KA stroke}\CYRKHCRS + \e237{ka stroke}\cyrkhcrs + \oct24 + \e240{bashkir KA}\CYRKBEAK + \e241{bashkir ka}\cyrkbeak + \e242{EN descender}\CYRNDSC + \e243{en descender}\cyrndsc + \e244{ligature EN GHE}\CYRNG + \e245{ligature en ghe}\cyrng + \e246{PE middle hook}\CYRPHK + \e247{pe middle hook}\cyrphk + \oct25 + \e250{abkhasian HA}\CYRABHHA + \e251{abkhasian ha}\cyrabhha + \e252{ES descender}\CYRSDSC + \e253{es descender}\cyrsdsc + \e254{TE descender}\CYRTDSC + \e255{te descender}\cyrtdsc + \e256{straight U}\CYRY + \e257{straight u}\cyry + \oct26 + \e260{straight U stroke}\CYRYHCRS + \e261{straight u stroke}\cyryhcrs + \e262{HA descender}\CYRHDSC + \e263{ha descender}\cyrhdsc + \e264{ligature TE TSE}\CYRTETSE + \e265{ligature te tse}\cyrtetse + \e266{CHE right descender}\CYRCHRDSC + \e267{che right descender}\cyrchrdsc + \oct27 + \e270{CHE vertical stroke}\CYRCHVCRS + \e271{che vertical stroke}\cyrchvcrs + \e272{SHHA}\CYRSHHA + \e273{shha}\cyrshha + \e274{abkhasian CHE}\CYRABHCH + \e275{abkhasian che}\cyrabhch + \e276{abkhasian CHE descender}\CYRABHCHDSC + \e277{abkhasian che descender}\cyrabhchdsc + \oct30 + \e300{palochka}\CYRpalochka + \e301{ZHE breve}{\U\CYRZH} + \e302{zhe breve}{\U\cyrzh} + \e303{KA hook}\CYRKHK + \e304{ka hook}\cyrkhk + \na305 + \na306 + \e307{EN hook}\CYRNHK + \oct31 + \e310{en hook}\cyrnhk + \na311 + \na312 + \e313{khakassian CHE}\CYRCHLDSC + \e314{khakassian che}\cyrchldsc + \na315 + \na316 + \na317 + \oct32 + \e320{A breve}{\U\CYRA} + \e321{a breve}{\U\cyra} + \e322{A diaeresis}{\"\CYRA} + \e323{a diaeresis}{\"\cyra} + \e324{ligature A IE}\CYRAE + \e325{ligature a ie}\cyrae + \e326{IE breve}{\U\CYRE} + \e327{ie breve}{\U\cyre} + \oct33 + \e330{SCHWA}\CYRSCHWA + \e331{schwa}\cyrschwa + \e332{SCHWA diaeresis}{\"\CYRSCHWA} + \e333{schwa diaeresis}{\"\cyrschwa} + \e334{ZHE diaeresis}{\"\CYRZH} + \e335{zhe diaeresis}{\"\cyrzh} + \e336{ZE diaeresis}{\"\CYRZ} + \e337{ze diaeresis}{\"\cyrz} + \oct34 + \e340{abkhasian DZE}\CYRABHDZE + \e341{abkhasian dze}\cyrabhdze + \e342{I macron}{\=\CYRI} + \e343{i macron}{\=\cyri} + \e344{I diaeresis}{\"\CYRI} + \e345{i diaeresis}{\"\cyri} + \e346{O diaeresis}{\"\CYRO} + \e347{o diaeresis}{\"\cyro} + \oct35 + \e350{barred O}\CYROTLD + \e351{barred o}\cyrotld + \e352{barred O diaeresis}{\"\CYROTLD} + \e353{barred o diaeresis}{\"\cyrotld} + \na354 + \na355 + \e356{U macron}{\=\CYRU} + \e357{u macron}{\=\cyru} + \oct36 + \e360{U diaeresis}{\"\CYRU} + \e361{u diaeresis}{\"\cyru} + \e362{U double acute}{\H\CYRU} + \e363{u double acute}{\H\cyru} + \e364{CHE diaeresis}{\"\CYRCH} + \e365{che diaeresis}{\"\cyrch} + \na366 + \na367 + \oct37 + \e370{YERU diaeresis}{\"\CYRERY} + \e371{yeru diaeresis}{\"\cyrery} + \na372 + \na373 + \na374 + \na375 + \na376 + \na377 + \symlist{\textnumero} + + \section*{\fileinfo} + Document: \textbf{\filename\space[\filedate\space\fileversion]} + \subsection*{Function} + This test file has several tasks: + \begin{itemize} + \item Testing package \emph{hyperref} with encoding file + \emph{puenc.def}. + \item Showing glyph commands and aliases that are supported by + package \emph{hyperref}. + \item Test for the pdf reader, especially \emph{AcrobatReader}. + Which glyphs of the \emph{Unicode} encoding are + correctly displayed? + \item These glyphs are shown that package \emph{hyperref} + replaces with simpler letters in order to avoid missing glyphs. + \end{itemize} + \subsection*{Short explanation of the bookmarks} + \begin{enumerate} + \item The outline entries of the first level show a summary of their + subentries. Second a screenshot with closed bookmarks + will contain all slots of the \emph{Unicode} encoding. + \item The second level of outline entries describes each slot or glyph: + \begin{enumerate} + \item \label{oct}% + Octal code of the slot in the \emph{Unicode} encoding. + \item The glyph is shown twice, surrounded by underscores: + The first one is produced by the octal sequence, see \ref{oct}. + The second one is the result of the higher glyph command, + see \ref{high}. + \item The glyph name of \emph{Unicode} encoding. + \item \label{high}% + The higher glyph \TeX-command, supported by + package \emph{hyperref}. + \end{enumerate} + \item Aliases of the glyph commands are shown as subentries of the + outline that describes the slot of that glyph command. + \end{enumerate} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testbookmark.tex b/Master/texmf-dist/doc/latex/hyperref/test/testbookmark.tex new file mode 100644 index 00000000000..bb6397061de --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testbookmark.tex @@ -0,0 +1,17 @@ +\documentclass[12pt]{article} +\usepackage{xspace} +\usepackage{hyperref} +\newcommand{\x}{x\xspace} + +\begin{document} + \section{Implicite space: \x world} + \section{Explicite spaces: \x\ world \x\space world \x~world} + \section{\x.+\x,+\x!+\x?+\x-+\x:+\x;+\x/+last-\x} + \makeatletter + \section{~|~~|~~~|~~~~|~~~~~|~~~~|~~~|~~|~} + \section{\x()(\x) } + \section{Italic correction: [\x\/]} + \section{::Nothing follows:} + \section{} + \section{\x} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testfor2.tex b/Master/texmf-dist/doc/latex/hyperref/test/testfor2.tex new file mode 100644 index 00000000000..d91596d5aad --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testfor2.tex @@ -0,0 +1,61 @@ +\documentclass{article} +\usepackage[dvips]{web} + +\def\r{\string\r} +\def\n{\string\n} + +\begin{document} +\begin{Form} + +\noindent First Sub total. + +\medskip\noindent +\makebox[.75in][l]{Number 1:} \TextField[width=1in,name=firstnum, +keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + +\medskip\noindent +\makebox[.75in][l]{Number 2:} \TextField[width=1in,name=secondnum, +keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + +\medskip\noindent +\makebox[.75in][l]{Sub total:} \TextField[width=1in,name=total1,align={0 /_objdef {total1}}, +format={AFNumber_Format(2,0,0,0,"",true);}, keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +calculate={AFSimple_Calculate("SUM",new Array("firstnum", "secondnum"));\string\040}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + +\bigskip\noindent Second Sub total: + +\medskip\noindent +\makebox[.75in][l]{Number 1:} \TextField[width=1in,name=Number.1, +keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + +\medskip\noindent +\makebox[.75in][l]{Number 2:} \TextField[width=1in,name=Number.2, +keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + +\medskip\noindent +\makebox[.75in][l]{Total:} \TextField[width=1in,name=total2, +format={AFNumber_Format(2,0,0,0,"",true);},align={0 /_objdef {total2}}, +keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +calculate={AFSimple_Calculate("SUM",new Array("Number"));\r}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + + + +\bigskip\noindent +\makebox[.75in][l]{Grand Total:} \TextField[width=1in,name=total, +format={AFNumber_Format(2,0,0,0,"",true);},align={0 /_objdef {total}}, +keystroke={AFNumber_Keystroke(2,0,0,0,"",true);}, +calculate={this.getField("total").value=this.getField("total1").value+% + this.getField("total2").value;\r}, +format={AFNumber_Format(2,0,0,0,"",true);}]{} + + +\special{! [ {corder} 0 [ {total1} {total2} {total} ] /PUTINTERVAL pdfmark} + +\end{Form} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testform.tex b/Master/texmf-dist/doc/latex/hyperref/test/testform.tex new file mode 100644 index 00000000000..8ddc3f7d9b9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testform.tex @@ -0,0 +1,50 @@ +%\begin{Form}[action=http:www.rhbnc.ac.uk/htbin/shew-fields,html,method=post] + +\documentclass{article} +\usepackage[bookmarks=false]{hyperref} +\setlength{\parindent}{0pt} +\setlength{\parskip}{10pt} +\begin{document} +\begin{Form}[action=mailto:srahtz,encoding=html,method=post] + +\TextField[width=3in,name=xname,value={Bilbo Baggins}] + {Full name: } + +%\TextField[name=warfs,validate={AFRange_Validate\string\(true, 1, true, 13\string\);}] +% {How many dwarves came along: } + +\TextField[multiline,width=1in,name=address,borderstyle=D, + color=1 1 1,backgroundcolor=0 0 .5, + value={Bag End, The Hill, Hobbiton}]{Address: } + +\ChoiceMenu[default=Home,menulength=3,width=2in,name=travel,default=Beorn] + {Favorite part of your travels:} + {Trolls,Misty Mountains,Beorn,Mirkwood,Elves,Laketown,% + Smaug,The Battle} + +Have you still got your: +\CheckBox[]{Sword} +\CheckBox[name=coat]{Mithril coat} +%\CheckBox[name=ring,checked]{\textbf{Ring!}} +\CheckBox[name=ring,checked]{Ring!} + +\ChoiceMenu[radio,default=Again,name=next,borderwidth=3,bordercolor=0 1 0] + {Do you want to:} + {Do it all again=Again, + Pretend it never happened=Forget, + Write a book about it=Write} + +%\TextField[password,name=made]{\emph{Who} made the ring? } +\TextField[password,name=made]{Who made the ring? } + +\ChoiceMenu[combo,default=Bofur,name=whatdwarf, + ]{Select funniest name, or add one} + {Bofur,Thorin,Gollum,Smaug,Gandalf} + +%\PushButton[name=xxx,onclick={app.beep(0)}]{Make a horrid beep} + +\Submit{Send} +\Reset{Clear} + +\end{Form} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testnb.tex b/Master/texmf-dist/doc/latex/hyperref/test/testnb.tex new file mode 100644 index 00000000000..42abd8e0ac6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testnb.tex @@ -0,0 +1,50 @@ +\documentclass{article} +\usepackage[german]{babel} +\usepackage[numbers,sort&compress]{natbib} +\usepackage{hyperref} +\usepackage{times} + +\begin{document} + +In addition, this theory---that of the German sociologist Niklas +Luhmann---is one +of the most (if not the most) powerful +contemporary general sociological theories +\citep{luhm:DoS,Luhm:Soc&int,luhm:WrtdG}. Therefore, in the rest of +this section, rather than making an eclectic use of different social +theories, I briefly present portions of Luhmann's theory. + +\begin{thebibliography}{3} +\expandafter\ifx\csname natexlab\endcsname\relax\def\natexlab#1{#1}\fi + +\bibitem[Luhmann(1982)]{luhm:DoS} +Niklas Luhmann. +\newblock {\em The Differentiation of Society}. +\newblock New York: Columbia University Press, 1982. + +\bibitem[Luhmann(1987)]{Luhm:Soc&int} +Niklas Luhmann. +\newblock The evolutionary differentiation between society and interaction. +\newblock In Jeffrey~C. Alexander, Bernhard Giesen, Richard Muench, and Neil~J. + Smelser, editors, {\em The Micro-Macro Link}, pages 112--31. Berkeley: + University of California Press, 1987. + +\bibitem[Luhmann(1988)]{luhm:WrtdG} +Niklas Luhmann. +\newblock {\em Die Wirtschaft der Gesellschaft}. +\newblock Frankfurt am Main: Suhrkamp, 1988. + +\end{thebibliography} +\end{document} +\usepackage +[%linkcolor=yellow, + citecolor=yellow, + citebordercolor={.5 .5 0}, + pdftitle={Testing natbib and hyperref}, + pdfauthor={SPQR and PWD}, + pdfsubject={Dummy stuff}, + pdfkeywords=Luhmann, +% pdfstartview=/FitB, + pdfpagemode=UseThumbs +] +{hyperref} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testoz.tex b/Master/texmf-dist/doc/latex/hyperref/test/testoz.tex new file mode 100644 index 00000000000..f56c111a976 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testoz.tex @@ -0,0 +1,38 @@ +\documentclass{article} +\usepackage{hyperref} +\begin{document} +\section{Pointing to dvi names} +\href{dvi::TeX-docs:nasty.dvi}{relative path to nasty.dvi}!\par +\href{:TeX-docs:nasty.dvi}{relative path to nasty.dvi}!\par +\href{HD:OzTeX:TeX-docs:nasty.dvi}{full path to nasty.dvi}!\par +\href{dvi:HD:OzTeX:TeX-docs:nasty.dvi}{full path to nasty.dvi}!\par +\href{dvi:nasty.dvi}{nasty.dvi in current folder}!\par +\href{dvi:nasty.dvi@3}{page 3 in nasty.dvi}!\par +\href{nasty.dvi@3}{page 3 in nasty.dvi}!\par +\href{nasty.dvi}{nasty.dvi}!\par +\href{file:nasty.dvi}{nasty.dvi}!\par +\href{file:HD:OzTeX:TeX-docs:nasty.dvi}{full path to nasty.dvi}!\par +\href{dvi:ozuser.dvi#section.12}{section 12 in user guide}!\par + +\href{x/y/z.dvi}{x/y/z.dvi} +\href{/x/y/z.dvi}{/x/y/z.dvi} +\href{http://x/y/z.dvi}{http://x/y/z.dvi} +\href{http://x:80/y/z.dvi}{http://x:80/y/z.dvi} +\section{Pointing to pdf names} +\href{dvi::TeX-docs:nasty.pdf}{relative path to nasty.pdf}!\par +\href{:TeX-docs:nasty.pdf}{relative path to nasty.pdf}!\par +\href{HD:OzTeX:TeX-docs:nasty.pdf}{full path to nasty.pdf}!\par +\href{dvi:HD:OzTeX:TeX-docs:nasty.pdf}{full path to nasty.pdf}!\par +\href{dvi:nasty.pdf}{nasty.pdf in current folder}!\par +\href{dvi:nasty.pdf@3}{page 3 in nasty.pdf}!\par +\href{nasty.pdf@3}{page 3 in nasty.pdf}!\par +\href{nasty.pdf}{nasty.pdf}!\par +\href{file:nasty.pdf}{nasty.pdf}!\par +\href{file:HD:OzTeX:TeX-docs:nasty.pdf}{full path to nasty.pdf}!\par +\href{dvi:ozuser.pdf#section.12}{section 12 in user guide}!\par + +\href{x/y/z.pdf}{x/y/z.pdf} +\href{/x/y/z.pdf}{/x/y/z.pdf} +\href{http://x/y/z.pdf}{http://x/y/z.pdf} +\href{http://x:80/y/z.pdf}{http://x:80/y/z.pdf} +\end{document} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testslide.tex b/Master/texmf-dist/doc/latex/hyperref/test/testslide.tex new file mode 100644 index 00000000000..fa367b556a2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testslide.tex @@ -0,0 +1,101 @@ +% dummy file seminar.con, if it does not exist. +\begin{filecontents}{seminar.con} +\end{filecontents} +\documentclass[]{seminar} +\usepackage{slidesec} +\def\thepage{E\arabic{page}} +\usepackage{lastpage} +\usepackage{xspace} +\usepackage{makeidx} +\usepackage[pdfstartview={FitBH -32768},pdfpagemode=None,plainpages=false,colorlinks]{hyperref} +\hypersetup{pdfauthor=?`\c C\"asar M\"uller n\~ao!`} +\setcounter{tocdepth}{4} +\setcounter{secnumdepth}{4} +\makeindex +\hypersetup{pdftitle=Welcome to the Monkey House} +\newcommand{\ANS}{\textsf{ANSYS}\xspace} +\begin{document} +\begin{slide} +\slideheading{xx} +\end{slide} +\begin{slide} +\listofslides +\end{slide} + +\begin{slide} +\slideheading{A funny \ANS-section} +Page 1; See \textcolor{red}{page} --\pageref{page2}-- +\end{slide} +\begin{slide} +Page 2; this is page 2\label{page2} +\end{slide} + +\begin{slide} +\index{an item on slide 3} + +\htmladdnormallink{A dummy URL}{http://www.tug.org/A-Fake_URL.html} + +\Acrobatmenu{Quit}{End Acrobat Reader} + +\Acrobatmenu{FullScreen}{Switch to full screen} + +\Acrobatmenu{ZoomIn}{Zoom in} + +$\int\!dx$ +\end{slide} +\begin{slide} +\slideheading{Yet another ?`\c C\"asar M\"uller n\~ao!`} + +\end{slide} +\begin{slide} +\slideheading{Testing Int\'ernal J\oe mps}\label{ss:intjmps} + +This is some text and this is a \hypertarget{target}{target}. + +\end{slide} +\begin{slide} +Now lets jump to \hyperlink{target}{Target}. + +Let's try going to Section~\ref{ss:intjmps} + +\end{slide} +\begin{slide} +\slideheading{A \ss ection with $\leq$} +xx +xx +\subsubsection{A subsubsection \texorpdfstring{$a+b$}{a+b}} +xx +\paragraph{A paragraph} +xx +\subparagraph{A subparagraph} +xxx +\end{slide} +\begin{slide} +\slideheading{Testing External Jumps}\label{ss:extjmps} + +\begin{enumerate} + +\item Jump to an external: The jump +\href{file:test7#TestTarget}{target} should open test7.pdf on +page 2, +\item Jump to an external: The jump +\href{file:test7#page.1}{page 1} should open test7.pdf on +page 1. + +%\item Jump to an relative external strange file +%\href{/D/srahtz/skills.doc}{destination} + +\href{run:picture.eps}{a PS file to launch} + +\href{run:fontman.exe}{an application} + +\href{run:e:\string\\mdraw\string\\mdraw.exe#picture.eps}{a PS file to launch (2)} +\end{enumerate} +\end{slide} +\begin{slide} +\printindex +\end{slide} +\end{document} + + + diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testurl.bbl b/Master/texmf-dist/doc/latex/hyperref/test/testurl.bbl new file mode 100644 index 00000000000..b9a3697a343 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testurl.bbl @@ -0,0 +1,8 @@ +\begin{thebibliography}{1} + +\bibitem{THE} +David~Loberg Code. +\newblock Aural comprehension guide (webpage). +\newblock \url{http://www.wmich.edu/mus-theo/etg/et_guide.html}. + +\end{thebibliography} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testurl.bib b/Master/texmf-dist/doc/latex/hyperref/test/testurl.bib new file mode 100644 index 00000000000..883c938fa1c --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testurl.bib @@ -0,0 +1,6 @@ +@MISC{THE, + key={the}, + author={David Loberg Code}, + title={Aural Comprehension Guide (Webpage)}, + note={\url{http://www.wmich.edu/mus-theo/etg/et_guide.html}} +} diff --git a/Master/texmf-dist/doc/latex/hyperref/test/testurl.tex b/Master/texmf-dist/doc/latex/hyperref/test/testurl.tex new file mode 100644 index 00000000000..d2a2a6f0b6d --- /dev/null +++ b/Master/texmf-dist/doc/latex/hyperref/test/testurl.tex @@ -0,0 +1,14 @@ +\documentclass[11pt]{article} +\usepackage[]{color} +\usepackage[letterpaper,colorlinks,breaklinks,backref]{hyperref} +%\usepackage{url} %use as alternative to hyperref for testing +\newcommand{\myurl}[1]{{\url{{#1}}}} + +\begin{document} +\url{http://www.wmich.edu/mus-theo/etg/et_guide.html} %ok now with hyperref, ok with url +\myurl{http://www.wmich.edu/mus-theo/etg/et_guide.html} %fails with hyperref, ok with url + +\cite{THE} +\bibliographystyle{unsrt} +\bibliography{testurl}%fails with hyperref, ok with url +\end{document} |
