summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/hyperref/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-09-14 23:56:54 +0000
committerKarl Berry <karl@freefriends.org>2010-09-14 23:56:54 +0000
commit6a202048032d41223115d64328753cae0efeca55 (patch)
tree37c51c814990236275ffd25da210a5e4e0781662 /Master/texmf-dist/source/latex/hyperref/doc
parent3d0cb91a86809c8becca994b9f708c9cc8eb7fdc (diff)
hyperref update (15sep10)
git-svn-id: svn://tug.org/texlive/trunk@19734 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/hyperref/doc')
-rw-r--r--Master/texmf-dist/source/latex/hyperref/doc/manual.tex37
-rw-r--r--Master/texmf-dist/source/latex/hyperref/doc/options.tex1
2 files changed, 36 insertions, 2 deletions
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\\