[latex3-commits] [git/LaTeX3-latex3-hyperref] cleanup-patches: preface about more documentation, whitespaces (0b28adb)

[Ulrike Fischer]

Repository : https://github.com/latex3/hyperref
On branch  : cleanup-patches
Link       : https://github.com/latex3/hyperref/commit/0b28adb0eb0cd9f76e0d5ab0a985570f591563e4

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

commit 0b28adb0eb0cd9f76e0d5ab0a985570f591563e4
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Tue Aug 3 17:22:27 2021 +0200

    preface about more documentation, whitespaces


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

0b28adb0eb0cd9f76e0d5ab0a985570f591563e4
 doc/hyperref-doc.tex | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/doc/hyperref-doc.tex b/doc/hyperref-doc.tex
index d80691b..de5979b 100644
--- a/doc/hyperref-doc.tex
+++ b/doc/hyperref-doc.tex
@@ -176,6 +176,28 @@
 \tableofcontents
 \setcounter{tocdepth}{2}% for bookmark levels
 
+\section{Preface---August 2021}
+As can be already seen in the following introduction, \xpackage{hyperref}
+has a long history and has seen many changes over time. The introduction 
+mentions workflows, drivers and problems which are no longer relevant, 
+or only in edge cases. The documentation reflect this varied history: changes
+and extensions and explanations were and are spread over various papers and sources and 
+only incorporated later and so are not always in a coherent order and in sync which each other.
+
+
+This history is continuing: If you are using the new \hologo{LaTeX} PDF management
+which is currently distributed as testphase package \xpackage{pdfmanagement-testphase}
+then \xpackage{hyperref} will for the PDF output use a new generic driver which 
+contains a number of changes and new features. The documentation of this driver 
+\texttt{hyperref-generic.pdf} 
+is currently a part of the \xpackage{pdfmanagement-testphase} documentation. 
+One important change of the new driver is
+that it removed the old \xpackage{hyperref} code for book marks and uses
+the \xpackage{bookmark} package instead. So to learn
+about options to extend the bookmarks you should consult the \xpackage{bookmark} documentation
+too. 
+
+
 \section{Introduction}
 
 The package derives from, and builds on, the work of the Hyper\hologo{TeX}
@@ -317,7 +339,7 @@ option used in this document.
 
 \section{Interfaces for class and package authors}
 
-hyperlink feature are nowadays a common requirement. \xpackage{hyperref}
+hyperlink features are nowadays a common requirement. \xpackage{hyperref}
 patches quite a number of commands from the  \LaTeX{} core and from packages
 to add such features. But this is rather fragile and it add dependencies
 on the loading order and can break if the external packages break.