[latex3-commits] [git/LaTeX3-latex3-hyperref] main: documentation (a619624)

[Ulrike Fischer]

Repository : https://github.com/latex3/hyperref
On branch  : main
Link       : https://github.com/latex3/hyperref/commit/a61962470a0f4329e1f10946520cd61499efa1c6

>---------------------------------------------------------------

commit a61962470a0f4329e1f10946520cd61499efa1c6
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Mon Feb 8 17:03:45 2021 +0100

    documentation


>---------------------------------------------------------------

a61962470a0f4329e1f10946520cd61499efa1c6
 ChangeLog.txt        |  8 ++++++++
 doc/hyperref-doc.tex | 20 +++++++++++++++++++-
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/ChangeLog.txt b/ChangeLog.txt
index b784bc1..1301505 100644
--- a/ChangeLog.txt
+++ b/ChangeLog.txt
@@ -1,3 +1,11 @@
+2021-02-08 Ulrike Fischer/David Carlisle
+    * moved definitions for \G accent to an extra file
+      puenc-extra.def, which can be loaded manually
+    * moved the loading of puenc.def so that it can be suppressed
+    with pdflatex
+    * correct the hspace command in pdfstringdef, so that it
+    accepts some calc syntax.
+
 2021-02-07 Ulrike Fischer/David Carlisle
     * renamed the manual to hyperref-doc
     * moved the license of the documentation into the file
diff --git a/doc/hyperref-doc.tex b/doc/hyperref-doc.tex
index f1e1895..7a75a95 100644
--- a/doc/hyperref-doc.tex
+++ b/doc/hyperref-doc.tex
@@ -1016,7 +1016,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{true}          & Unicode encoded pdf strings, starting with version  2021-02-07 v7.00h set by default to true for all engines. \\
+unicode            & \textit{true}          & Unicode encoded pdf strings, starting with version v7.00g set by default to true for all engines. It will load a number of definitions in puenc.def. It can be set to false for pdflatex, but this is not recommended.\\
 urlbordercolor     & \textit{0 1 1}         & color of border around URL links \\
 urlcolor           & \textit{magenta}       & color of URL links \\
 verbose            & \textit{false}         & be chatty \\
@@ -2219,6 +2219,24 @@ Now the entry in the table of contents (and bookmarks) for the
 index points to the start of the index page, not to a location
 before this page.
 
+\subsection{puenc encoding and puenc-extra.def}
+
+The \texttt{unicode} option loads for the bookmarks \texttt{puenc.def} which contains 
+quite a lot definitions of commands for the bookmarks. 
+As \texttt{unicode} is now true for all engines, this file is now also loaded 
+with pdflatex. Some of the definitions in \texttt{puenc.def} clash with other uses.
+To reduce the impact \xpackage{hyperref} uses two strategies.
+
+\begin{itemize}
+\item A number of command are only defined conditionally:
+The commands for the cyrillic block  if \cs{CYRDZE} is defined,
+greek if \cs{textBeta} is defined, and hebrew if \cs{hebdalet} is defined.
+
+\item Other commands are moved to an extra file \texttt{puenc-extra.def}
+which is not loaded automatically, but can be loaded in the preamble if needed.
+Currently this file contains all definitions for the accent \cs{G}.
+\end{itemize}
+
 
 
 \section{Acrobat-specific behavior}