From 6a202048032d41223115d64328753cae0efeca55 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 14 Sep 2010 23:56:54 +0000 Subject: hyperref update (15sep10) git-svn-id: svn://tug.org/texlive/trunk@19734 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/latex/hyperref/doc/manual.tex | 37 ++++++++++++++++++++-- .../source/latex/hyperref/doc/options.tex | 1 + 2 files changed, 36 insertions(+), 2 deletions(-) (limited to 'Master/texmf-dist/source/latex/hyperref/doc') diff --git a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex index 956606fcf4f..418d4f493e0 100644 --- a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex +++ b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex @@ -233,6 +233,24 @@ 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}. +\begin{description} +\item[driverfallback] + If a driver is not given and cannot be autodetected, then use + the driver option, given as value to this option \textsf{driverfallback}. + Example: + \begin{quote} + \texttt{driverfallback=dvipdfm} + \end{quote} + Autodetected drivers (\textsf{pdftex}, \textsf{xetex}, \textsf{vtex}, + \textsf{vtexpdfmark}) are recognized from within \TeX\ and + therefore cannot be given as value to option \textsf{driverfallback}. + However a DVI driver program is run after the \TeX\ run is finished. + Thus it cannot be detected at \TeX\ macro level. Then package hyperref + uses the driver, given by \textsf{driverfallback}. If the driver + is already specified or can be autodetected, then option + \textsf{driverfallback} is ignored. +\end{description} + \section{Implicit behavior} This package can be used with more or less any normal \LaTeX\ document @@ -361,10 +379,25 @@ However, at any case, the link area will be wrong and displaced. \subsection{Backend drivers} -If no driver is specified, the package defaults to loading the -\textsf{hypertex} driver. +If no driver is specified, the package tries to find a driver in +the following order: +\begin{enumerate} +\item Autodetection, some \TeX\ processors can be detected at \TeX\ macro + level (pdf\TeX, Xe\TeX, V\TeX). +\item Option \textsf{driverfallback}. If this option is set, its value + is taken as driver option. +\item Makro \cs{Hy@defaultdriver}. The makro takes a driver file + name (without file extension). +\item Package default is \textsf{hypertex}. +\end{enumerate} +Many distributions are using a driver file \texttt{hypertex.cfg} that +define \cs{Hy@defaultdriver} with \texttt{hdvips}. This is recommended +because driver \textsf{dvips} provides much more features than +\textsf{hypertex} for PDF generation. \noindent\begin{longtable}{>{\ttfamily}lp{.8\hsize}} +driverfallback & Its value is used as driver option\\ + & if the driver is not given or autodetected.\\ dvipdfm & Sets up \textsf{hyperref} for use with the \textsf{dvipdfm} driver.\\ dvipdfmx & Sets up \textsf{hyperref} for use with the \textsf{dvipdfmx} driver.\\ dvips & Sets up \textsf{hyperref} for use with the \textsf{dvips} driver. \\ diff --git a/Master/texmf-dist/source/latex/hyperref/doc/options.tex b/Master/texmf-dist/source/latex/hyperref/doc/options.tex index 7e8278cea26..d7e05c77d38 100644 --- a/Master/texmf-dist/source/latex/hyperref/doc/options.tex +++ b/Master/texmf-dist/source/latex/hyperref/doc/options.tex @@ -33,6 +33,7 @@ colorlinks &color links&false\\ debug &provide details of anchors defined&false\\ &same as verbose&\\ draft &do not do any hyper linking&false\\ +driverfallback &Use this driver option, if no driver is given and cannot be autodetected\\ dvipdfm &use dvipdfm backend\\ dvipdfmx &use dvipdfmx backend (dvipdfm)\\ dvips &use dvips backend\\ -- cgit v1.2.3