Hypertext marks in LaTeX: a manual for hyperref - TUG

3 PACKAGE OPTIONS 6
\section{Introduction}
\label{intro}
Option destlabel checks for each \label, if there is a new destination name active and replaces
the destination name by the label name. Because the destination name is already in use because
of the anchor setting, the new name is recorded in the .aux file and used in the subsequent L ATEX
run. The renaming is done by a redefinition of \HyperDestNameFilter. That leaves the old
destination names intact (e.g., they are needed for \autoref). This redefinition is also available as
\HyperDestLabelReplace, thus that an own redefinition can use it. The following example also
adds a prefix for all destination names:
\renewcommand*{\HyperDestNameFilter}[1]{%
\jobname-\HyperDestLabelReplace{#1}%
}
The other case that only files prefixed that do not have a corresponding \label is more complicate,
because \HyperDestLabelReplace needs the unmodified destination name as argument. This
is solved by an expandable string test (\pdfstrcmp of pdfTEX or \strcmp of XƎTEX, package
pdftexcmds also supports LuaTEX):
\usepackage{pdftexcmds}
\makeatletter
\renewcommand*{\HyperDestNameFilter}[1]{%
\ifcase\pdf@strcmp{#1}{\HyperDestLabelReplace{#1}} %
\jobname-#1%
\else
\HyperDestLabelReplace{#1}%
\fi
}
\makeatother
With option destlabel destinations can also named manually, if the destination is not yet
renamed:
\HyperDestRename{〈destination〉}{〈newname〉}
Hint: Anchors can also be named and set by \hypertarget.
destlabel boolean false destinations are named by first \label
after anchor creation
hypertexnames boolean true use guessable names for links
naturalnames boolean false use L ATEX-computed names for links
plainpages boolean false Forces page anchors to be named by the Arabic form
of the page number, rather than the formatted form.
3.3 Configuration options
raiselinks boolean true In the hypertex driver, the height of links
is normally calculated by the driver as simply
the base line of contained text; this options
forces \special commands to reflect the
real height of the link (which could contain a
graphic)