CTAN sync 202406030302

1 files changed, 37 insertions, 37 deletions

diff --git a/macros/latex/required/graphics/graphics.dtx b/macros/latex/required/graphics/graphics.dtx
index 92b3c8f335..2392ac09d1 100644
--- a/macros/latex/required/graphics/graphics.dtx
+++ b/macros/latex/required/graphics/graphics.dtx
@@ -2,7 +2,7 @@
 % \iffalse
 %
 %% graphics.dtx Copyright (C) 1994      David Carlisle Sebastian Rahtz
-%%              Copyright (C) 1995-2022 LaTeX Project
+%%              Copyright (C) 1995-2024 LaTeX Project
 %% The LaTeX Project and any individual authors listed elsewhere
 %% in this file.
 %%
@@ -17,9 +17,9 @@
           \ProvidesFile{graphics.dtx}
 %</dtx>
 %<+package>\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-%<+package>\providecommand\DeclareRelease[3]{}
-%<+package>\providecommand\DeclareCurrentRelease[2]{}
 %<+package>
+% Try to fulfill rollback requests to early years by using the 2017 version:
+%<+package>\DeclareRelease{}{1994-06-01}{graphics-2017-06-25.sty}
 %<+package>\DeclareRelease{}{2017-06-25}{graphics-2017-06-25.sty}
 %<+package>\DeclareCurrentRelease{}{2019-10-01}
 %<+package>
@@ -27,7 +27,7 @@
 %<driver> \ProvidesFile{graphics.drv}
 % \fi
 %         \ProvidesFile{graphics.dtx}
-          [2022/03/10 v1.4e  Standard LaTeX Graphics (DPC,SPQR)]
+          [2024/05/23 v1.4g  Standard LaTeX Graphics (DPC,SPQR)]
 %
 % \iffalse
 %<*driver>
@@ -69,18 +69,18 @@
 % \section{Introduction}
 %
 % This package implements various `graphics' functions. The main
-% features are a) inclusion of `graphics' files. b) Rotation of sections
-% of the page, c) Scaling of sections of the page.
+% features are: a) inclusion of `graphics' files; b) rotation of sections
+% of the page; c) scaling of sections of the page.
 %
 % The design is split into three `levels'.
 % \begin{itemize}
 % \item The user interface. This is the collection of commands designed
-% to appear in a document text. Actually two separate user interface
+% to appear in a document text. Actually two separate user interfaces
 % have been implemented. The `standard' interface, described here, and a
 % more powerful, and more `user-friendly' interface provided by the
 % |graphicx| package.
 % \item The core functions. These functions, which are also implemented
-% in this file do all the `main work'. The `user-interface functions
+% in this file, do all the `main work'. The `user-interface functions'
 % just collect together the information from any optional-arguments or
 % star-forms, and then call one of these functions.
 % \item The driver files. It is not possible to achieve the
@@ -90,7 +90,7 @@
 % and the syntax required to pass instructions to the drivers is also
 % not standardised. So the `core functions' never access |\special|
 % directly, but rather call a series of commands that must be defined in
-% a special file customised for each driver. The accompanying file,
+% a special file customised for each driver. The accompanying file
 % |drivers.dtx| has suitable files for a range of popular drivers.
 % \end{itemize}
 %
@@ -99,9 +99,9 @@
 % driver that is to be used to print the document. You may wish to set
 % up a configuration file so that this option always takes effect, even
 % if not specified in the document. To do this, produce a file
-% |graphics.cfg| containing the line:\\
+% |graphics.cfg| containing the line\\
 % |\ExecuteOptions{dvips}|\\
-% (or whichever other driver you wish.)
+% (or whichever other driver you wish).
 %
 % Apart from the driver options there are a few other options to control
 % the behaviour of the package.
@@ -166,7 +166,7 @@
 %  |\graphicspath{{eps/}{tiff/}}|
 % would cause the system to look in the subdirectories |eps| and |tiff|
 % of the current directory. The default setting of this path is
-% |\input@path| that is: graphics files will be found wherever \TeX\
+% |\input@path|, so that graphics files will be found wherever \TeX\
 % files are found.
 %
 % \DescribeMacro
@@ -204,7 +204,7 @@
 % \emph{default rule}. For instance the |dvips| driver file declares all
 % files to be of type |eps| unless a more specific rule is declared.
 %
-% Since Version v0.6, extensions should be specified including the |.|
+% Since Version v0.6, extensions should be specified including the |.|,
 % that is, |.eps| not |eps|.
 %
 % \emph{type} is the `type' of file involved. All files of the same type
@@ -241,7 +241,7 @@
 % used to denote the filename. Thus using the dvips driver, one may
 % use\\
 % |\DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{`zcat #1}|\\
-% the final argument causes dvips to use the |zcat| command to unzip the
+% The final argument causes dvips to use the |zcat| command to unzip the
 % file before inserting it into the PostScript output.
 %
 % \subsection{Rotation}
@@ -297,18 +297,18 @@
 % \DescribeMacro
 %   {\Gread@eps}\marg{file}\\
 % For each \emph{type} of graphics file supported, the driver file must
-% define |\Ginclude@|\emph{type} and, optionally |\Gread@|\emph{type}.
+% define |\Ginclude@|\emph{type} and, optionally, |\Gread@|\emph{type}.
 % The read command is responsible for obtaining size information from
-% the file specified in the |\DeclareGraphicsRule| command. However the
+% the file specified in the |\DeclareGraphicsRule| command. However, the
 % kernel defines a function, |\Gread@eps|,  which can read PostScript
 % files to find the
 % |%%BoundingBox| comment. This function will be used for any type for
 % which a specific function has not been declared. |\Gread@eps| accepts
 % a generalised version of the bounding box comment. \TeX\ units may be
 % used (but there must be no space before the unit). If the unit is
-% omitted |bp| is assumed. So\\
+% omitted, |bp| is assumed. So\\
 % |%%BoundingBox 0 0 2in 3in|\\
-% Would be accepted by this function, to produce a 2in wide, by 3in high
+% would be accepted by this function, to produce a 2in wide by 3in high
 % graphic.
 %
 % \subsection{Rotation}
@@ -334,7 +334,7 @@
 % \DescribeMacro
 % {\Gscale@box@dddd}
 %        \marg{dima}\marg{dimb}\marg{dimc}\marg{dimd}\marg{text}\\
-% Scale \emph{text} in horizontally by a factor \emph{dima}/\emph{dimb},
+% Scale \emph{text} horizontally by a factor \emph{dima}/\emph{dimb},
 % and vertically by a factor of  \emph{dimc}/\emph{dimd}.
 %
 % \DescribeMacro
@@ -353,7 +353,7 @@
 % |\Ginclude@|\emph{type}\\
 % The Graphics kernel function will call this driver-defined function
 % with the filename as argument, and certain additional information will
-% be provided as follows.:
+% be provided as follows:
 %
 % \noindent\begin{tabular}{p{.4\textwidth}p{.5\textwidth}}
 % |\Gin@llx|, |\Gin@lly|,\newline
@@ -362,7 +362,7 @@
 %               Registers storing the natural size.\\
 % |\Gin@req@width|\newline |\Gin@req@height| &
 %               Registers storing the required size, after scaling.\\
-% |\Gin@scalex|, |\Gin@scaley| & macros with the scale factors. A value
+% |\Gin@scalex|, |\Gin@scaley| & Macros with the scale factors. A value
 % of |!| means: Scale by the same amount as the other direction.\\
 % |\ifGin@clip| & |\newif| token, true if the graphic should be
 %                 `clipped' to  the bounding box.
@@ -371,11 +371,11 @@
 % Optionally the driver may define a command of the form:\\
 % |\Gread@|\emph{type}\\
 % This is responsible for reading an external file to find the bounding
-% box information. If such a command is not declared, but a read-file is
-% specified the command |\Gread@eps|, which is defined in the Graphics
-% Kernel will be used.
+% box information. If such a command is not declared but a read-file is
+% specified, the command |\Gread@eps|, which is defined in the Graphics
+% Kernel, will be used.
 %
-% \subsection{Literal Postscript}
+% \subsection{Literal PostScript}
 % Drivers that are producing PostScript output may want to define
 % the following macros. They each take one argument which should be
 % passed to an appropriate special. They are not used directly by this
@@ -384,7 +384,7 @@
 % |\Gin@PS@raw|, Literal PostScript special.\\
 % |\Gin@PS@restored|, Literal PostScript special, the driver will
 %                    surround this with a save-restore pair.\\
-% |\Gin@PS@literal@header|, Postscript to be inserted in the header
+% |\Gin@PS@literal@header|, PostScript to be inserted in the header
 %                           section of the PostScript file.\\
 % |\Gin@PS@file@header|, external file to be inserted in the header
 %                           section of the PostScript file.
@@ -550,7 +550,7 @@
 % \changes{v0.3g}{1994/03/15}
 %     {Use dvips def file not development version}
 % \begin{option}{xdvi}
-% Tomas Rockicki's  PostScript driver (unix, MSDOS, VMS\ldots).
+% Tomas Rokicki's  PostScript driver (unix, MSDOS, VMS\ldots).
 % The |X11| previewer |xdvi| supports basically the same set of
 % |\specials|.
 %    \begin{macrocode}
@@ -672,7 +672,7 @@
 % \begin{option}{pctex32}
 % \changes{v1.0b}{1996/10/29}
 %     {pctex32 option added}
-% PC\TeX\ (MSDOS/Windows) .
+% PC\TeX\ (MSDOS/Windows).
 %    \begin{macrocode}
 \DeclareOption{pctexps}{\def\Gin@driver{pctexps.def}}
 \DeclareOption{pctexwin}{\def\Gin@driver{pctexwin.def}}
@@ -913,7 +913,7 @@
 % \end{macro}
 %
 % \begin{macro}{\Gin@iii}
-% Set the coordinates of the {\bfseries l}lower {\bfseries l}eft corner,
+% Set the coordinates of the {\bfseries l}ower {\bfseries l}eft corner,
 % and the coordinates of the {\bfseries u}pper {\bfseries r}ight
 % corner. The coordinates may be any \TeX\ dimension, defaulting to |bp|.
 % \changes{v0.6c}{1994/12/15}
@@ -944,8 +944,8 @@
 % is invisibly small but files conforming to Adobe  DSC should have
 % \emph{integer} Bounding Box Coordinates, and conceivably some drivers
 % might demand integer values.
-% (Although most seem to accept real values (if they accept bounding box
-% coordinates at all) in the |\special|. This is the reason why the
+% Although most seem to accept real values (if they accept bounding box
+% coordinates at all) in the |\special|, this is the reason why the
 % mechanism uses |\def| and not \TeX\ lengths, as in earlier releases of
 % the package.
 %    \begin{macrocode}
@@ -1454,8 +1454,8 @@
 %     {New macro}
 % \begin{macro}{\Gread@generic@aux}
 % \begin{macro}{\Gread@eps}
-% Read an EPS file (|#1|) and search for a line
-% starting with |%%BoundingBox| and returns the result
+% Read an EPS file (|#1|), search for a line
+% starting with |%%BoundingBox|; then return the result
 % by setting four dimension registers
 % |\Gin@llx|, |\Gin@lly|, |\Gin@urx| and |\Gin@ury|.
 % \changes{v0.5e}{1994/11/02}
@@ -1701,7 +1701,7 @@
 % \begin{macro}{\Grot@left}
 % \begin{macro}{\Grot@right}
 % \begin{macro}{\Grot@depth}
-% Final Rotated box dimensions
+% Final rotated box dimensions
 %    \begin{macrocode}
 \let\Grot@height\@ovxx
 \let\Grot@left\@ovyy
@@ -1920,8 +1920,8 @@
 %    \end{macrocode}
 % Now we should translate back by $(O_x,O_y)$, but \TeX\ can not really
 % deal with boxes that do not have the reference point at the left edge.
-% (Everything with a $-$ve $x$-coordinate would over-print earlier
-% text). So we modify the horizontal translation so that the
+% (Everything with a negative $x$-coordinate would over-print earlier
+% text.) So we modify the horizontal translation so that the
 % reference point as understood by \TeX\ \emph{is} at the left edge.
 % This means that the `centre of rotation' is not fixed by |\rotatebox|,
 % but typically moves horizontally. We also need to find the image of
@@ -2157,7 +2157,7 @@
 %    \end{macrocode}
 %  \end{macro}
 %
-% Restore Catcodes
+% Restore catcodes.
 %    \begin{macrocode}
 \Gin@codes
 \let\Gin@codes\relax