documentation

latex3 · Feb 8, 2021 · a619624 · a619624
1 parent 433bcff
commit a619624
Show file tree

Hide file tree

Showing 2 changed files with 28 additions and 2 deletions.
diff --git 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
@@ -559,7 +559,7 @@ \subsection{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 \verb|\special| commands to
                                reflect the real height of the link (which could contain a graphic) \\
-breaklinks & boolean & both & This option is in hyperref only used in the dviwindo driver, in all other cases it doesn't do anything sensible---it neither allows nor prevents links to be broken. The ocgx2 package 
+breaklinks & boolean & both & This option is in hyperref only used in the dviwindo driver, in all other cases it doesn't do anything sensible---it neither allows nor prevents links to be broken. The ocgx2 package
 checks the state of the boolean.\\
 pageanchor & boolean & true  & Determines whether every page is given an implicit anchor at the top left corner. If this
                                is turned off, \verb|\printindex| will not contain
@@ -1016,7 +1016,7 @@ \subsection{Big alphabetical list}
 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 @@ \subsection{\textbackslash phantomsection}
 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}