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, thefollowing 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}; thismust be a full URL (relative to the base URL, if that is defined). Thespecial characters \# and \~{} do \emph{not} need to be escaped in anyway.\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 otherspecified 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, andgiven 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 ahypertext 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 anotional \# in front of each link, making it relative to the currenttestdocument; \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 acontextual label in front of the reference. This gives your users abigger target to click for hyperlinks (e.g.\ `section 2' instead ofmerely 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 (shownwith their default values). The macros can be redefined in documentsusing \verb|\renewcommand|; note that some of these macros are alreadydefined in the standard document classes. The mixture of lowercase anduppercase initial letters is deliberate and corresponds to the author'spractice.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, butnot 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 toform 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. (Currentlythis 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 unsafeunbalanced parentheses in the PDF string. For further details, see HeikoOberdiek's Euro\TeX\ paper distributed with \textsf{hyperref}.\subsection{Replacement macros}\textsf{hyperref} takes the text for bookmarks from the arguments ofcommands 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 itexpands the string. Therefore, you can use this hook to performadditional 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 thedefinition of \ci{pdfstringdefPreHook} (`@' can here be used as letter incommand 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 followingmacro 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).