[latex3-commits] [git/LaTeX3-latex3-hyperref] master: document thispdfpagelabel (578c604)

[Ulrike Fischer]

Repository : https://github.com/latex3/hyperref
On branch  : master
Link       : https://github.com/latex3/hyperref/commit/578c604bfd662b2561753bc40a5b54ee45729a74

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

commit 578c604bfd662b2561753bc40a5b54ee45729a74
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Fri Jan 8 12:22:04 2021 +0100

    document thispdfpagelabel


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

578c604bfd662b2561753bc40a5b54ee45729a74
 doc/manual.tex | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/manual.tex b/doc/manual.tex
index 9ba721f..2f44c86 100644
--- a/doc/manual.tex
+++ b/doc/manual.tex
@@ -1392,6 +1392,19 @@ command names):
 }
 \end{verbatim}
 
+\subsection{Pagelabels}
+\begin{cmdsyntax}
+\ci{thispdfpagelabel}\verb|{|\emph{page number format}\verb|}|
+\end{cmdsyntax}
+
+This allows to change format of the page number shown in the tool bar of 
+a PDF viewer for a specific page, for example 
+
+\verb+\thispdfpagelabel{Empty Page-\roman{page}}+ 
+
+The command affects the page on which it is executed, so asynchronous page breaking
+should be taken into account. It should be used in places where for example \verb+\thispagestyle+ can be use too.
+
 \subsection{Utility macros}
 
 \label{hypercalcbp}