diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/hyperref/doc/manual.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/hyperref/doc/manual.tex | 44 |
1 files changed, 40 insertions, 4 deletions
diff --git a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex index cd572f4357f..577f8078fcd 100644 --- a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex +++ b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex @@ -11,9 +11,11 @@ % % Manual updates: % * Steve Peter and Karl Berry, 7/03. -% * Heiko Oberdiek, 2006-2009. +% * Heiko Oberdiek, 2006-2010. % +\def\mydate{January 2010} + \RequirePackage{ifpdf} \ifpdf % We are running pdfTeX in pdf mode \documentclass[pdftex]{article} @@ -24,6 +26,7 @@ \usepackage{etex}% for \eTeX \usepackage{pifont} +\usepackage{calc} \newcommand*{\cs}[1]{% \texttt{\textbackslash #1}% @@ -131,7 +134,7 @@ \title{Hypertext marks in \LaTeX: a manual for \textsf{hyperref}} \author{Sebastian Rahtz \and Heiko Oberdiek} -\date{December 2009} +\date{\mydate} \begin{document} @@ -493,7 +496,7 @@ next \TeX\ run if it is edited to contain the line \\ \end{verbatim} \subsection{PDF display and information options} -\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{6cm}} +\noindent\begin{longtable}{@{}>{\ttfamily}l>{\raggedright}p{\widthof{key value}}>{\itshape}lp{7cm}@{}} baseurl & URL & & Sets the base URL of the PDF document \\ pdfpagemode & text & empty & Determines how the file is opening in Acrobat; the possibilities are \texttt{UseNone}, \texttt{UseThumbs} (show thumbnails), \texttt{UseOutlines} @@ -506,6 +509,11 @@ pdfsubject & text & & Sets the document information Subject fie pdfcreator & text & & Sets the document information Creator field \\ pdfproducer & text & & Sets the document information Producer field \\ pdfkeywords & text & & Sets the document information Keywords field \\ +pdftrapped & text & empty & Sets the document information Trapped entry.\\ +&&& Possible values are \texttt{True}, \texttt{False} and \texttt{Unknown}.\\ +&&& An empty value means, the entry is not set.\\ +pdfinfo & key value list & empty & Alternative interface for setting the + document information.\\ pdfview & text & XYZ & Sets the default PDF `view' for each link \\ pdfstartpage & text & 1 & Determines on which page the PDF file is opened. \\ pdfstartview & text & Fit & Set the startup page view \\ @@ -596,12 +604,36 @@ 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{Option \texttt{pdfinfo}} + +The information entries can be set using \texttt{pdftitle}, +\texttt{pdfsubject}, \dots. Option \texttt{pdfinfo} provides an alternative +interface. It takes a key value list. The key names are the names that +appear in the PDF information dictionary directly. Known keys such as +\texttt{Title}, \texttt{Subject}, \texttt{Trapped} and other are mapped to +options \texttt{pdftitle}, \texttt{subject}, \texttt{trapped}, \dots +Unknown keys are added to the information dictionary. Their values are text +strings (see PDF specification). +Example: +\begin{quote} +\begin{verbatim} +\hypersetup{ + pdfinfo={ + Title={My Title}, + Subject={My Subject}, + NewKey={Foobar}, + % ... + } +} +\end{verbatim} +\end{quote} + \subsection{Big alphabetical list} The following is a complete listing of available options for \textsf{hyperref}, arranged alphabetically. -\noindent\begin{longtable}{>{\ttfamily}llp{6cm}} +\noindent\begin{longtable}{@{}>{\ttfamily}llp{7cm}@{}} anchorcolor & \textit{black} & set color of anchors \\ backref & \textit{false} & do bibliographical back references \\ baseurl & \textit{empty} & set base URL for document \\ @@ -662,6 +694,7 @@ pdfduplex & \textit{empty} & paper handling option for print dialog\\ pdffitwindow & \textit{false} & resize document window to fit document size \\ pdfhighlight & \textit{/I} & set highlighting of PDF links \\ +pdfinfo & \textit{empty} & alternative interface for setting document information\\ pdfkeywords & \textit{empty} & text for PDF Keywords field \\ pdflang & \textit{empty} & PDF language identifier (RFC 3066) \\ pdfmark & \textit{false} & an alias for \textsf{dvips} \\ @@ -690,6 +723,9 @@ 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 \\ +pdftrapped & \textit{empty} & Sets the document information Trapped entry. + Possible values are \texttt{True}, \texttt{False} and \texttt{Unknown}. + An empty value means, the entry is not set.\\ pdfview & \textit{XYZ} & PDF `view' when on link traversal \\ pdfviewarea & \textit{empty} & set /ViewArea of viewer preferences \\ pdfviewclip & \textit{empty} & set /ViewClip of viewer preferences \\ |