pdftex[924] branches/stable/doc/manual: mention named destinations

[commits+karl at tug.org]

Revision: 924
          https://tug.org/svn/pdftex?view=revision&revision=924
Author:   karl
Date:     2024-02-23 03:20:18 +0100 (Fri, 23 Feb 2024)
Log Message:
-----------
mention named destinations for pdf images

Modified Paths:
--------------
    branches/stable/doc/manual/ChangeLog
    branches/stable/doc/manual/pdftex.tex
    branches/stable/doc/manual/pdftexmanual.cls

Modified: branches/stable/doc/manual/ChangeLog
===================================================================
--- branches/stable/doc/manual/ChangeLog	2024-02-20 18:48:39 UTC (rev 923)
+++ branches/stable/doc/manual/ChangeLog	2024-02-23 02:20:18 UTC (rev 924)
@@ -1,3 +1,14 @@
+2024-02-22  Max Chernoff  <karl at freefriends.org>
+
+	* pdftex.tex (\pdfximage): mentioned named destination
+	(General definitions and syntax rules) <page spec>: add
+	named {general text} as another alternative.
+
+2024-02-22  Karl Berry  <karl at freefriends.org>
+
+	* pdftexmanual.cls (\Something): force \rm for argument text.
+	* pdftex.tex: eliminate \rm in calls.
+
 2024-02-20  Karl Berry  <karl at freefriends.org>
 
 	* Makefile (install): update and execute for 2024.

Modified: branches/stable/doc/manual/pdftex.tex
===================================================================
--- branches/stable/doc/manual/pdftex.tex	2024-02-20 18:48:39 UTC (rev 923)
+++ branches/stable/doc/manual/pdftex.tex	2024-02-23 02:20:18 UTC (rev 924)
@@ -2254,6 +2254,10 @@
 While working with \PDF\ or \JBIG2\ images, \Something{page spec} allows
 to specify which page of the document is to be included; the
 \Something{page spec} is irrelevant for the other two image formats.
+Commonly, \Something{page spec} will be {\tt page \Something{page
+number}}, but for \PDF\ images, you may also reference a so-called
+``named destination'' with {\tt named \{\Something{destination name}\}}.
+(Such named destinations are created by \type{hyperref}, for example.)
 
 Starting with \PDFTEX\ 1.11, in the \PDF\ image case, you may also
 choose which page box of the image is to be treated as a final bounding
@@ -2581,11 +2585,11 @@
 \tt fitb   & fit the \type{BoundingBox} of the page            \cr
 \tt fitbh  & fit the width of \type{BoundingBox} of the page   \cr
 \tt fitbv  & fit the height of \type{BoundingBox} of the page  \cr
-\tt fitr \Something{\rm rule spec}
-   & fit according to \Something{\rm rule spec}  \cr
-\tt xyz \Optional{zoom \Something{\rm number}} 
+\tt fitr \Something{rule spec}
+   & fit according to \Something{rule spec}  \cr
+\tt xyz \Optional{zoom \Something{number}} 
    & goto the current position (see below)       \cr
-\tt struct \Optional{\Something{\rm number}}
+\tt struct \Optional{\Something{number}}
    & create structure destination (see below)    \cr
 \end{tabular}
 \end{smalltable}
@@ -4296,7 +4300,8 @@
 
 \Syntax{
 \Something{page spec} \Means
-  \Literal{page} \Something{number}
+  \Literal{page} \Something{number} \Or%
+  \Literal{named} \Something{general text}
 }
 
 \Syntax{

Modified: branches/stable/doc/manual/pdftexmanual.cls
===================================================================
--- branches/stable/doc/manual/pdftexmanual.cls	2024-02-20 18:48:39 UTC (rev 923)
+++ branches/stable/doc/manual/pdftexmanual.cls	2024-02-23 02:20:18 UTC (rev 924)
@@ -125,7 +125,7 @@
 \def\Modelist #1{\Sugar{\;\ensuremath{(\hbox{#1})}}}
 \def\Optional #1{\Sugar{\ensuremath{\,[\,\hbox{#1}\,]\,}}}
 \def\Or         {\Sugar{\,\ensuremath{\vert}\,\nobreak\ }}
-\def\Something#1{\Sugar{\ensuremath{\langle}{#1}\ensuremath{\rangle}}}
+\def\Something#1{\Sugar{\ensuremath{\langle}{\rm #1}\ensuremath{\rangle}}}
 \def\Rbrace     {\Sugar{\texttt{\textbraceright}}}
 %\def\Tex      #1{\Sugar{\type{#1}}}
 \def\Whatever #1{\Sugar{\kern.75em\ensuremath{(\hbox{#1})}}} % parens