texlive[70085] Master/texmf-dist/doc/pdftex/manual: mention named

[commits+karl at tug.org]

Revision: 70085
          https://tug.org/svn/texlive?view=revision&revision=70085
Author:   karl
Date:     2024-02-23 03:21:12 +0100 (Fri, 23 Feb 2024)
Log Message:
-----------
mention named destinations in pdf images, pdftex r924

Revision Links:
--------------
    https://tug.org/svn/texlive?view=revision&revision=924

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/pdftex/manual/ChangeLog
    trunk/Master/texmf-dist/doc/pdftex/manual/Makefile
    trunk/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf
    trunk/Master/texmf-dist/doc/pdftex/manual/pdftex.tex
    trunk/Master/texmf-dist/doc/pdftex/manual/pdftexmanual.cls

Modified: trunk/Master/texmf-dist/doc/pdftex/manual/ChangeLog
===================================================================
--- trunk/Master/texmf-dist/doc/pdftex/manual/ChangeLog	2024-02-23 00:44:44 UTC (rev 70084)
+++ trunk/Master/texmf-dist/doc/pdftex/manual/ChangeLog	2024-02-23 02:21:12 UTC (rev 70085)
@@ -1,3 +1,18 @@
+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.
+
 2024-02-01  Karl Berry  <karl at freefriends.org>
 
 	* pdftex.tex (\pdfglyphtounicode): mention that a dot and anything

Modified: trunk/Master/texmf-dist/doc/pdftex/manual/Makefile
===================================================================
--- trunk/Master/texmf-dist/doc/pdftex/manual/Makefile	2024-02-23 00:44:44 UTC (rev 70084)
+++ trunk/Master/texmf-dist/doc/pdftex/manual/Makefile	2024-02-23 02:21:12 UTC (rev 70085)
@@ -1,4 +1,4 @@
-# $Id: Makefile 917 2024-01-08 23:22:17Z karl $
+# $Id: Makefile 923 2024-02-20 18:48:39Z karl $
 # GNU makefile for pdfTeX documentation.  Public domain.
 
 texfot = texfot
@@ -83,8 +83,7 @@
 
 install:
 	$(INSTALL_DATA) ChangeLog Makefile README $(dest)
-	$(INSTALL_DATA) pdftex-a.pdf $(dest)
-	$(INSTALL_DATA) pdftex.tex pdftexmanual.cls $(dest)
+	$(INSTALL_DATA) pdftex-a.pdf pdftex.tex pdftexmanual.cls $(dest)
 	$(INSTALL_DATA) incl/*.txt incl/*.tex incl/pdfmin-crop.pdf $(dest)/incl
 	$(INSTALL_DATA) syntaxform.pl $(dest)
 

Modified: trunk/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/pdftex/manual/pdftex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/pdftex/manual/pdftex.tex	2024-02-23 00:44:44 UTC (rev 70084)
+++ trunk/Master/texmf-dist/doc/pdftex/manual/pdftex.tex	2024-02-23 02:21:12 UTC (rev 70085)
@@ -10,7 +10,7 @@
 %
 %\DocumentMetadata{testphase={phase-III,table}}
 \documentclass{pdftexmanual}
-\svnscan $Id: pdftex.tex 921 2024-02-02 02:14:32Z karl $
+\svnscan $Id: pdftex.tex 924 2024-02-23 02:20:18Z karl $
 
 % 

 \title{The pdf\TeX\ user manual}
@@ -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: trunk/Master/texmf-dist/doc/pdftex/manual/pdftexmanual.cls
===================================================================
--- trunk/Master/texmf-dist/doc/pdftex/manual/pdftexmanual.cls	2024-02-23 00:44:44 UTC (rev 70084)
+++ trunk/Master/texmf-dist/doc/pdftex/manual/pdftexmanual.cls	2024-02-23 02:21:12 UTC (rev 70085)
@@ -1,4 +1,4 @@
-% $Id: pdftexmanual.cls 914 2024-01-07 21:48:39Z karl $
+% $Id: pdftexmanual.cls 924 2024-02-23 02:20:18Z karl $
 % LaTeX class file for the pdfTeX manual.
 % Originally written by Karl Berry, 2023. Public domain.
 
@@ -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