summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/hyperref/doc/manual.tex')
-rw-r--r--Master/texmf-dist/source/latex/hyperref/doc/manual.tex26
1 files changed, 18 insertions, 8 deletions
diff --git a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
index 0e443c8a90f..574df948038 100644
--- a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
+++ b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
@@ -4,6 +4,7 @@
% Copyright (C) 2003 Steve Peter and Karl Berry
% Copyright (C) 2006-2012 Heiko Oberdiek.
% Copyright (C) 2017-2019 David Carlisle Ulrike Fischer
+% Copyright (C) 2019- The LaTeX3 Project
%
% Permission is granted to copy, distribute and/or modify this document
% under the terms of the GNU Free Documentation License, Version 1.1 or
@@ -192,6 +193,9 @@ the functionality of all the \hologo{LaTeX} cross-referencing commands
it also provides new commands to allow the user to write \emph{ad hoc}
hypertext links, including those to external documents and URLs.
+The package is currently maintained at \url{https://github.com/latex3/hyperref/} and issues should
+be reported there.
+
This manual provides a brief overview of the \xpackage{hyperref}
package. For more details, you should read the additional documentation
distributed with the package, as well as the complete documentation by
@@ -646,7 +650,7 @@ colorlinks & boolean & false & Colors the text of links and anchors. The c
Unlike colored boxes, the colored
text remains when printing.\\
linkcolor & color & red & Color for normal internal links. \\
-anchorcolor & color & black & Color for anchor text. \\
+anchorcolor & color & black & Color for anchor text. Ignored by most drivers. \\
citecolor & color & green & Color for bibliographical citations in text. \\
filecolor & color & cyan & Color for URLs which open local files. \\
menucolor & color & red & Color for Acrobat menu items. \\
@@ -859,7 +863,7 @@ The following is a complete listing of available options for
\textsf{hyperref}, arranged alphabetically.
\begin{longtable}{@{}>{\ttfamily}llp{7cm}@{}}
-anchorcolor & \textit{black} & set color of anchors \\
+anchorcolor & \textit{black} & set color of anchors, ignored by most drivers. \\
backref & \textit{false} & do bibliographical back references \\
baseurl & \textit{empty} & set base URL for document \\
bookmarks & \textit{true} & make bookmarks \\
@@ -963,7 +967,7 @@ runcolor & \textit{filecolor} & color of `run' links\\
setpagesize & \textit{true} & set page size by special driver commands \\
tex4ht & & use \textsf{\TeX4ht} backend \\
textures & & use \textsf{Textures} backend \\
-unicode & \textit{false} & Unicode encoded pdf strings \\
+unicode & \textit{false} & Unicode encoded pdf strings, by defaut true with \textsf{Xe\TeX} and \textsf{Lu\TeX} \\
urlbordercolor & \textit{0 1 1} & color of border around URL links \\
urlcolor & \textit{magenta} & color of URL links \\
verbose & \textit{false} & be chatty \\
@@ -1191,7 +1195,8 @@ the page reference. First \ci{pageautorefname} is checked before
\ci{pagename}.
For instances where you want a reference to use the correct counter, but
-not to create a link, there are starred forms:
+not to create a link, there are starred forms (these starred forms exist even if
+hyperref has been loaded with \verb|implicit=false|):
\begin{cmdsyntax}
\ci{ref*}\verb|{|\emph{label}\verb|}|
@@ -1399,7 +1404,7 @@ sequence error would arise.
\item[xetex]
\begin{itemize}
\item Settings must be done in the preamble or the first page and then have global effect.
- The key inserts the new (x)dvipdfmx special \verb|\special{dvipdfmx:config g #1}| (with the unit removed).
+ The key inserts the new (x)dvipdfmx special \verb|\special{dvipdfmx:config g #1}| (with the unit removed).
\end{itemize}
\item[Other drivers]
@@ -1583,7 +1588,7 @@ sequence error would arise.
an acute, but a hook. However standard LaTeX does not provide
such an accent.
- Now we can extend the defintion to support hyperref.
+ Now we can extend the definition to support hyperref.
The first and the last word are already supported automatically.
Characters with two or more accents are a difficult business in
LaTeX, because the NFSS2 macros of the LaTeX kernel do not support
@@ -1656,6 +1661,9 @@ sequence error would arise.
The idea are colored links, when viewed, but printed without colors.
This new experimental option `ocgcolorlinks' uses Optional Content
Groups, a feature introduced in PDF 1.5.
+
+ A better implementation which hasn't the disadvantage to prevent line breaks is
+ in the ocgx2 package. Check its documentation for details how to use it.
\begin{itemize}
\item The option must be given for package loading:
\verb|\usepackage[ocgcolorlinks]{hyperref}|
@@ -1669,8 +1677,7 @@ sequence error would arise.
inside the document.
\item Supported drivers: pdftex, dvipdfm
\item The PDF version should be at least 1.5. It is automatically
- set for pdfTeX. Users of dvipdfmx set the version on the command
- line: dvipdfmx -V 5
+ set for pdfTeX, LuaTeX and dvipdfmx.
\end{itemize}
\subsection{Option `pdfa'}
@@ -1901,6 +1908,9 @@ sequence error would arise.
outside the encoding and Unicode otherwise.
\end{itemize}
+ The luatex driver uses "unicode" by default. If another encoding should be forced,
+ it should be done in \verb|hypersetup|.
+
\subsection{Color options/package hycolor}
See documentation of package `hycolor'.