diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex | 35 |
1 files changed, 24 insertions, 11 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex index e9019cc9884..05b8a02882e 100644 --- a/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex +++ b/Master/texmf-dist/doc/latex/hyperref/hyperref-doc.tex @@ -166,7 +166,7 @@ } \makeatother \title{Hypertext marks in \hologo{LaTeX}: a manual for \xpackage{hyperref}} -\date{2023-02-07 v7.00v} +\date{2023-04-20 v7.00w} \begin{document} @@ -265,28 +265,33 @@ of a URL (of the form \emph{URL\#name\_string}). Here 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; +configuration files for different drivers, selected by package options or for +most current engines autodetected; 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{\hologo{OzTeX}}, and \textsf{Textures}) -\item[dvips] produces \verb|\special| commands tailored for \textsf{dvips} +\item[dvips] produces \verb|\special| commands tailored for \textsf{dvips}. This is the default driver if dvi mode is +detected. \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, \hologo{HanTheThanh}'s \TeX{} variant that writes PDF directly -\item[luatex] lua\TeX, Unicode \TeX{} variant that writes PDF directly +\item[tex4ht] produces \verb|\special| commands for use with \textsf{\TeX4ht}, autodetected. +\item[pdftex] pdf\TeX, \hologo{HanTheThanh}'s \TeX{} variant that writes PDF directly, autodetected. +\item[luatex] lua\TeX, Unicode \TeX{} variant that writes PDF directly, autodetected. \item[dvipdfm] produces \verb|\special| commands for Mark Wicks' DVI to PDF driver \textsf{dvipdfm} \item[dvipdfmx] produces \verb|\special| commands for driver \textsf{dvipdfmx}, a successor of \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 + previewer, autodetected. \item[textures] produces \verb|\special| commands that \textsf{Textures} interprets as hypertext jumps within the previewer -\item[xetex] produces \verb|\special| commands for Xe\TeX{} +\item[xetex] produces \verb|\special| commands for Xe\TeX{}, autodetected. +\item[hitex] (new 2023) for the hint format produces by the Hi\TeX{} engine, autodetected. This a quite experimental +engine and the driver file is not part of the \xpackage{hyperref} bundle but is provided by +the \xpackage{hitex} package. Problems should be reported to \url{https://github.com/ruckertm/HINT}. \end{description} Output from \textsf{dvips} or \textsf{dvipsone} must be processed using @@ -307,8 +312,8 @@ such as \textsf{xdvi}. \begin{quote} \texttt{driverfallback=dvipdfm} \end{quote} - Autodetected drivers (\textsf{pdftex}, \textsf{xetex}, \textsf{vtex}, - \textsf{vtexpdfmark}) are recognized from within \TeX\ and + Autodetected drivers (\textsf{pdftex}, \textsf{luatex}, \textsf{xetex}, \textsf{vtex}, + \textsf{vtexpdfmark}, \textsf{hitex}) 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 @@ -557,7 +562,15 @@ Check the \xpackage{nameref} documentation about a way to suppress these patches \item[table of contents] hyperref redefines \cs{contentsline} to be able to add links to toc entries. It redefines \cs{addcontentsline} to create the bookmarks and pass the -destination names to the toc entries. This code can be suppressed by defining \cs{hyper@nopatch@toc}. +destination names to the toc entries. This code can be suppressed by defining \cs{hyper@nopatch@toc}. + +\item[captions] hyperref redefines \cs{caption} and \cs{@caption} to insert targets for links. +This code can be suppressed by defining \cs{hyper@nopatch@caption} (additional helper commands are +not suppressed). As various packages redefine captions too (e.g. the \xpackage{caption} package) +side-effects must be carefully tested! + +\item[longtable] hyperref redefines \cs{LT@start} and \cs{LT@array} to move the targets in a better place. +This code can be suppressed by defining \cs{hyper@nopatch@longtable} \end{description} \section{Package options} |