diff options
Diffstat (limited to 'macros/latex-dev/required/graphics')
25 files changed, 151 insertions, 102 deletions
diff --git a/macros/latex-dev/required/graphics/README.md b/macros/latex-dev/required/graphics/README.md index df1e890c5a..0160491bb9 100644 --- a/macros/latex-dev/required/graphics/README.md +++ b/macros/latex-dev/required/graphics/README.md @@ -1,7 +1,7 @@ The LaTeX `graphics` bundle =========================== -Release 2024-06-01 pre-release 0 +Release 2025-06-01 pre-release 0 Overview -------- @@ -61,4 +61,4 @@ of the package. ----- -<p>Copyright (C) 1993-2023 The LaTeX Project <br /> +<p>Copyright (C) 1993-2024 The LaTeX Project <br /> diff --git a/macros/latex-dev/required/graphics/changes.txt b/macros/latex-dev/required/graphics/changes.txt index 55dde0358f..d437358079 100644 --- a/macros/latex-dev/required/graphics/changes.txt +++ b/macros/latex-dev/required/graphics/changes.txt @@ -9,6 +9,29 @@ All changes above are only part of the development branch for the next release. ================================================================================ ######################### +# 2024-11-01 Release +######################### + +2024-06-24 Frank Mittelbach <Frank.Mittelbach@latex-project.org> + + * color.dtx (section{Extra Groups}): + Support new @endpe mechanism + +######################### +# 2024-06-01 Release +######################### + +2024-05-23 Frank Mittelbach <Frank.Mittelbach@latex-project.org> + + * graphics.dtx: + Do not error with "suspicious date" when rolling back to + early years of LaTeX2e (gh/1336) + +2024-04-28 David Carlisle <David.Carlisle@latex-project.org> + + * grfguide.tex: add \resizebox* example for gh/1339 + +######################### # 2022-11-01 Release ######################### diff --git a/macros/latex-dev/required/graphics/color.dtx b/macros/latex-dev/required/graphics/color.dtx index bd37971470..b14c148f2f 100644 --- a/macros/latex-dev/required/graphics/color.dtx +++ b/macros/latex-dev/required/graphics/color.dtx @@ -2,7 +2,7 @@ % \iffalse % %% color.dtx Copyright (C) 1994--1999 David Carlisle -%% Copyright (C) 2005-2023 LaTeX Project +%% Copyright (C) 2005-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% @@ -21,7 +21,7 @@ %<driver> \ProvidesFile{color.drv} % \fi % \ProvidesFile{color.dtx} - [2022/01/06 v1.3d Standard LaTeX Color (DPC)] + [2024/06/23 v1.3e Standard LaTeX Color (DPC)] % % \iffalse %<*driver> @@ -168,7 +168,7 @@ % % \begin{option}{dvips} % \begin{option}{xdvi} -% Tom Rokicki's dvips driver, and the X Windows previewer, xdvi which uses +% Tom Rokicki's dvips driver, and the X Windows previewer, xdvi, which uses % (a subset of) the same |\specials|. % \begin{macrocode} \DeclareOption{dvips}{\def\Gin@driver{dvips.def}% @@ -248,7 +248,7 @@ % \changes{v0.3k}{1995/09/07} % {Merge dviwindo and dvipsone options} % The drivers of the Y\&Y \TeX\ system. -% (Which use the same |\specials|). +% (Which use the same |\specials|.) % \begin{macrocode} \DeclareOption{dvipsone}{\def\Gin@driver{dvipsone.def}} \DeclareOption{dviwindo}{\ExecuteOptions{dvipsone}} @@ -360,7 +360,7 @@ % The |dvipsnames| option predeclares all the names in the colour % prologue of dvips. The |dvips| option automatically implies % |dvipsnames| unless this choice is overruled with the |nodvipsnames| -% option. For other drivers, eg |textures| you may use this option to +% option. For other drivers, eg |textures|, you may use this option to % explicitly request that these names be declared. % \begin{macrocode} \DeclareOption{dvipsnames}{\def\c@lor@namefile{dvipsnam.def}} @@ -371,7 +371,7 @@ % % \begin{option}{usenames} % The |usenames| option modifies the behaviour of |\DefineNamedColor| -% So that it declares the same name as a ```user's colour'' for use in +% so that it declares the same name as a ``user's colour'' for use in % a |\color| command, as well as a name in the |named| colour model. % The normal behaviour is just to declare the name in the named colour % model. @@ -530,7 +530,7 @@ % |\color| or |\textcolor| commands to refer to a colour specified by % \emph{colour-spec} in the colour model \emph{model}. % -% |\definecolor| associates the \emph{name} the to a colour in +% |\definecolor| associates the \emph{name} to a colour in % \emph{model}. So |\color{|\emph{name}|}| would check \emph{name} % then issue a |\special| for the colour model \emph{model}. % @@ -579,12 +579,12 @@ % names. % % The `color1' drivers (dvips) currently ignore the specification of -% the colour, and once a name is defined, just put the colour name in -% the dvi file. For dvips, The header file \texttt{color.pro} is used to +% the colour and, once a name is defined, just put the colour name in +% the dvi file. For dvips, the header file \texttt{color.pro} is used to % give the cmyk equivalents of the names. % % The `color2' drivers (textures) use a special postscript operator -% that takes both the name and the cmyk equivalent. so if the names are +% that takes both the name and the cmyk equivalent, so if the names are % not being used, `fall back' definitions in the cmyk model are available. % These drivers also allow a numeric value to affect the `density' % of the colour to use. @@ -688,9 +688,9 @@ % % \begin{macro}{\normalcolor} % Early versions of this package redefined |\reset@font| to reset the -% color as well. Current versions do not do this (there are too many -% |\reset@font| commands hidden in strange places) and so defines a -% separate command, |\normalcolor| to reset the colour to the colour in +% color as well. Current versions do not do this (since there are too many +% |\reset@font| commands hidden in strange places) and so they define a +% separate command, |\normalcolor|, to reset the colour to the colour in % effect at the start of the document. % % |\normalcolor| is defined (to |\relax|) in the \LaTeX\ kernel, so it @@ -722,9 +722,9 @@ % the truth as the `macro layer' of \TeX\ does not know where the output % routine is going to re-insert floats. This is why drivers must % maintain their own stack of colours in order to fully support these -% commands. +% commands.) % -% For dvips, the |\current@color| it is something like `|Black|' or +% For dvips, the |\current@color| is something like `|Black|' or % `|rgb 0 1 0|', but other packages should not rely on any particular % format for this macro. % @@ -755,7 +755,7 @@ % definition of this command. A graphics package may want to define it % using a special to produce (for example) a PostScript line. Producing % the line in the |\special| has the advantage that on a preview that -% does not understand |\special|s, the line is automatically omited, +% does not understand |\special|s, the line is automatically omitted, % without needing to modify the source of the document (for instance by % adding the |monochrome| option). % @@ -877,10 +877,15 @@ % commands. The |\endgraf| in its definition is required in the case % of groups of text in vertical `par' mode, but doesn't do any harm in % horizontal `LR' contexts. +% The |\@endpefalse| is required for the newer \texttt{@endpe} +% handling, again it is harmless if an older kernel is used +% (because there it was a local assignment). % \changes{v0.2d}{1994/05/13} % {New definition, was previously just \cs{endgroup}} +% \changes{v1.3e}{2024/06/23} +% {Support new \texttt{@endpe} mechanism} % \begin{macrocode} -\def\color@endgroup{\endgraf\endgroup} +\def\color@endgroup{\endgraf\@endpefalse\endgroup} % \end{macrocode} % \end{macro} % @@ -894,7 +899,7 @@ % \end{macro} % % \begin{macro}{\color@vbox} -% To be used to open a `coloured hbox' +% To be used to open a `coloured vbox' % \changes{v0.3h}{1994/11/22} % {Macro added} % \begin{macrocode} diff --git a/macros/latex-dev/required/graphics/color.pdf b/macros/latex-dev/required/graphics/color.pdf Binary files differindex e1c35c486d..081cfb5463 100644 --- a/macros/latex-dev/required/graphics/color.pdf +++ b/macros/latex-dev/required/graphics/color.pdf diff --git a/macros/latex-dev/required/graphics/drivers.dtx b/macros/latex-dev/required/graphics/drivers.dtx index 19fa2013db..fb5132272b 100644 --- a/macros/latex-dev/required/graphics/drivers.dtx +++ b/macros/latex-dev/required/graphics/drivers.dtx @@ -3,7 +3,7 @@ % %% drivers.dtx Copyright (C) 1994 David Carlisle Sebastian Rahtz %% Copyright (C) 1995 1996 1997 1998 1999 David Carlisle -%% Copyright (C) 2000-2023 LaTeX Project +%% Copyright (C) 2000-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% diff --git a/macros/latex-dev/required/graphics/drivers.pdf b/macros/latex-dev/required/graphics/drivers.pdf Binary files differindex b32569dec4..03dc4fc6b4 100644 --- a/macros/latex-dev/required/graphics/drivers.pdf +++ b/macros/latex-dev/required/graphics/drivers.pdf diff --git a/macros/latex-dev/required/graphics/epsfig.dtx b/macros/latex-dev/required/graphics/epsfig.dtx index 8a9911c965..46dc36d0bf 100644 --- a/macros/latex-dev/required/graphics/epsfig.dtx +++ b/macros/latex-dev/required/graphics/epsfig.dtx @@ -2,7 +2,7 @@ % \iffalse % %% epsfig.dtx Copyright (C) 1994-1996 1999 Sebastian Rahtz -%% Copyright (C) 2000-2023 LaTeX Project +%% Copyright (C) 2000-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% @@ -19,7 +19,7 @@ %<driver> \ProvidesFile{epsfig.drv} % \fi % \ProvidesFile{epsfig.dtx} - [2017/06/25 v1.7b (e)psfig emulation (SPQR)] + [2024/01/14 v1.7b (e)psfig emulation (SPQR)] % % \iffalse %<*driver> @@ -51,7 +51,7 @@ \RequirePackage{graphicx} % \end{macrocode} % \subsection{Emulation of `psfig' syntax} -% Emulate "epsfig.sty", and most varieties of psfig +% Emulate \texttt{epsfig.sty}, and most varieties of psfig % \begin{macro}{\psfig,\epsfig} % \begin{macrocode} \def\psfig#1{% @@ -83,7 +83,7 @@ % \end{macrocode} % \end{macro} % \subsection{Emulation of `epsf' syntax} -% Emulate Rokicki's "epsf.tex" supplied with the ever-popular dvips. +% Emulate Rokicki's \texttt{epsf.tex}, supplied with the ever-popular dvips. % \begin{macro}{\epsfbox,\epsffile} % \begin{macrocode} \newdimen\epsfxsize diff --git a/macros/latex-dev/required/graphics/epsfig.pdf b/macros/latex-dev/required/graphics/epsfig.pdf Binary files differindex 7c863b7a22..16b8cc6bdc 100644 --- a/macros/latex-dev/required/graphics/epsfig.pdf +++ b/macros/latex-dev/required/graphics/epsfig.pdf diff --git a/macros/latex-dev/required/graphics/graphics-2017-06-25.sty b/macros/latex-dev/required/graphics/graphics-2017-06-25.sty index 154867d99a..24f6443124 100644 --- a/macros/latex-dev/required/graphics/graphics-2017-06-25.sty +++ b/macros/latex-dev/required/graphics/graphics-2017-06-25.sty @@ -1,4 +1,8 @@ %% +%% This is an old release of `graphics.sty' used during rollback operations. +%% Do not use this file directly. +%% ============================== +%% %% This is file `graphics.sty', %% generated with the docstrip utility. %% diff --git a/macros/latex-dev/required/graphics/graphics.dtx b/macros/latex-dev/required/graphics/graphics.dtx index d40c70a034..86556ea40a 100644 --- a/macros/latex-dev/required/graphics/graphics.dtx +++ b/macros/latex-dev/required/graphics/graphics.dtx @@ -2,7 +2,7 @@ % \iffalse % %% graphics.dtx Copyright (C) 1994 David Carlisle Sebastian Rahtz -%% Copyright (C) 1995-2023 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/08/06 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} @@ -1050,7 +1050,8 @@ % % \begin{macrocode} \edef\Gin@gzext{\detokenize{gz}} -% \edef{macrocode} +% \end{macrocode} +% \end{macro} % \end{macro} % % \begin{macro}{\Gin@set@curr@file} @@ -1454,8 +1455,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 +1702,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 +1921,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 +2158,7 @@ % \end{macrocode} % \end{macro} % -% Restore Catcodes +% Restore catcodes. % \begin{macrocode} \Gin@codes \let\Gin@codes\relax diff --git a/macros/latex-dev/required/graphics/graphics.pdf b/macros/latex-dev/required/graphics/graphics.pdf Binary files differindex 343be34fa6..24df86ee4e 100644 --- a/macros/latex-dev/required/graphics/graphics.pdf +++ b/macros/latex-dev/required/graphics/graphics.pdf diff --git a/macros/latex-dev/required/graphics/graphicx.dtx b/macros/latex-dev/required/graphics/graphicx.dtx index 3bce2bdcf0..92f1af1d39 100644 --- a/macros/latex-dev/required/graphics/graphicx.dtx +++ b/macros/latex-dev/required/graphics/graphicx.dtx @@ -2,7 +2,7 @@ % \iffalse % %% graphicx.dtx Copyright (C) 1994 David Carlisle Sebastian Rahtz -%% Copyright (C) 1995-2023 LaTeX Project +%% Copyright (C) 1995-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% diff --git a/macros/latex-dev/required/graphics/graphicx.pdf b/macros/latex-dev/required/graphics/graphicx.pdf Binary files differindex 06aa1ba087..bdd0c30cca 100644 --- a/macros/latex-dev/required/graphics/graphicx.pdf +++ b/macros/latex-dev/required/graphics/graphicx.pdf diff --git a/macros/latex-dev/required/graphics/grfguide.pdf b/macros/latex-dev/required/graphics/grfguide.pdf Binary files differindex 7aa2c8bc89..8a060397b6 100644 --- a/macros/latex-dev/required/graphics/grfguide.pdf +++ b/macros/latex-dev/required/graphics/grfguide.pdf diff --git a/macros/latex-dev/required/graphics/grfguide.tex b/macros/latex-dev/required/graphics/grfguide.tex index 585e87adc7..959486c05c 100644 --- a/macros/latex-dev/required/graphics/grfguide.tex +++ b/macros/latex-dev/required/graphics/grfguide.tex @@ -1,5 +1,5 @@ %% grfguide.tex Copyright (C) 1994-1999 David Carlisle -%% Copyright (C) 2005-2021 +%% Copyright (C) 2005-2024 %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% @@ -62,7 +62,8 @@ stroke \begin{document} \title{Packages in the `graphics' bundle} \author{D. P. Carlisle \and The \LaTeX\ Project} -\date{2021-03-05} + +\date{2024-05-22} \maketitle @@ -95,8 +96,10 @@ For special requirements you may edit a copy of these |cfg| files to set up a site default for these options. Suppose that you wish the \package{color} package to always default to use specials for the PostScript driver, |dvisvgm|. In that case, create a file |color.cfg| -containing the line:\\ -|\ExecuteOptions{dvisvgm}|\\ +containing the line: +\begin{quote} + |\ExecuteOptions{dvisvgm}| +\end{quote} Normally you will want an identical file |graphics.cfg| to set a similar default for the graphics packages. @@ -113,12 +116,12 @@ The following two options are also supported, they do not correspond to separate definition files, but are essentially aliases for the |dvips| option (and |monochrome| in the case of |xdvi|). \begin{quote}\raggedright - |xdvi|, |oztex| + |xdvi|, |oztex| \end{quote} The following set of options are supported by these packages with associated driver files extracted from the |drivers.dtx| -documented source in this bundle. These are now, mainly of historic +documented source in this bundle. These are now mainly of historic interest but the documented sources do contain some useful code and advice if you need to produce a new definition file for a new driver or \TeX\ system. |drivers.dtx| also contains documented @@ -206,11 +209,11 @@ your own colours use the |\definecolor| command. This defines \m{name} as a colour which can be used in later colour -commands. For example -\begin{verbatim} -\definecolor{light-blue}{rgb}{0.8,0.85,1} -\definecolor{mygrey}{gray}{0.75} -\end{verbatim} +commands. For example: +\begin{quote} + |\definecolor{light-blue}{rgb}{0.8,0.85,1}| \\ + |\definecolor{mygrey}{gray}{0.75}| +\end{quote} \definecolor{light-blue}{rgb}{0.8,0.85,1} \definecolor{mygrey}{gray}{0.75} @@ -227,7 +230,7 @@ The basic syntax is: |\color|\arg{name} \end{decl} -This is a \emph{declaration}, like |\bfseries| It changes the current +This is a \emph{declaration}, like |\bfseries|. It changes the current colour to \m{name} until the end of the current group or environment. @@ -259,7 +262,6 @@ See \texttt{mathcolor.pdf} for details on this command. \subsubsection{Using colour specifications directly} - \begin{decl} |\color|\oarg{model}\arg{specification}\\ |\textcolor|\oarg{model}\arg{specification}\arg{text}\\ @@ -271,18 +273,23 @@ the document preamble, but sometimes it is convenient to directly use a colour without naming it first. To achieve this |\color| (and all the other colour commands) take an optional argument specifying the model. If this is used then the mandatory argument takes a -\m{colour specification} instead of a \m{name}. For example:\\ -|\color[rgb]{1,0.2,0.3}|\\ +\m{colour specification} instead of a \m{name}. For example: +\begin{quote} + |\color[rgb]{1,0.2,0.3}| +\end{quote} would directly select that colour. -This is particularly useful for accessing the \textbf{named} model:\\ -|\color[named]{BrickRed}| selects the |dvips| colour BrickRed. +This is particularly useful for accessing the \textbf{named} model: +\begin{quote} + |\color[named]{BrickRed}| +\end{quote} +selects the |dvips| colour BrickRed. Rather than repeatedly use |[named]| you may use |\definecolor| to -provide convenient aliases:\\ -|\definecolor{myred}{named}{WildStrawberry}| - \ldots\ |\color{myred}|\ \ldots - +provide convenient aliases: +\begin{quote} + |\definecolor{myred}{named}{WildStrawberry}|\ldots |\color{myred}|\kern-10pt +\end{quote} Alternatively if you are happy to use the existing names from the \textbf{named} model, you may use the |usenames| package option, which effectively calls |\definecolor| on every colour in the \textbf{named} @@ -396,7 +403,7 @@ you should set up a site-default in a file, The graphics packages have some other options for controlling how many of the features to enable: \begin{description} -\item[draft] suppress all the `special' features. In particular +\item[draft] Suppress all the `special' features. In particular graphics files are not included (but they are still read for size info) just the filename is printed in a box of the correct size. \item[final] The opposite of |draft|. Useful to over-ride a global @@ -480,18 +487,23 @@ An abbreviation for |\scalebox{-1}[1]|\arg{text}. Scale \emph{text} so that the width is \emph{h-length}. If |!| is used as either length argument, the other argument is used to determine a scale factor that is used in both directions. - Normally \emph{v-length} refers to the height of the box, but in the - star form, it refers to the `height + depth'. + As normal for \LaTeXe\ box length arguments, |\height|, |\width|, |\totalheight|, |\depth| may be used to refer to the original size of the box. + Normally \emph{v-length} refers to the height of the box, but in the + star form, |\resizebox*|, it refers to the `height + depth'. + |\resizebox{1in}{\height}{Some text}|: \resizebox{1in}{\height}{Some text} |\resizebox{1in}{!}{Some text}|: \resizebox{1in}{!}{Some text} +|\resizebox{!}{20pt}{Q} \resizebox*{!}{20pt}{Q}|: +\resizebox{!}{20pt}{Q} \resizebox*{!}{20pt}{Q} + \subsection{Including Graphics Files} The functions for graphics inclusion try to give the same user syntax for including any kind of graphics file that can be understood by the @@ -568,7 +580,7 @@ otherwise it will not use one of the others, with a driver-defined order of preference. |MediaBox| is always present. -The |pagebox| key may be used to specify which bounding box specification to use, +The |pagebox| key may be used to specify which bounding box specification to use. The value should be one of |mediabox|, |cropbox|, |bleedbox|, |trimbox|, |artbox|. \item[viewport]\NEWfeature{1995/06/01} @@ -602,7 +614,7 @@ The value should be one of \item[scale] Scale factor. \item[clip] Either `true' or `false' (or no value, which is equivalent to `true'). Clip the graphic to the bounding box. -\item[draft] a boolean valued key, like `clip'. Locally switches to +\item[draft] A boolean valued key, like `clip'. Locally switches to draft mode. \item[type] Specify the graphics type. \item[ext] Specify the file extension. This should \emph{only} be @@ -614,12 +626,16 @@ The value should be one of \item[quiet]\NEWfeature{2017/06/01} Skip writing information to the log. \item[page]\NEWfeature{2017/06/01} -Page of a multi-page PDF file. (by default the first page will be used.) +Page of a multi-page PDF file. (By default the first page will be used.) \item[interpolate]\NEWfeature{2017/06/01} Enable/disable interpolation of bitmap images by the viewer. +\item[alt]\NEWfeature{2021/09/16} + Alternative text for accessibility uses. By default this key is not used + but users are encouraged to add descriptive text here that may be used in + tagged PDF or as the |alt| attribute in conversions to HTML. \end{description} -For the keys specifying the original size (i.e,, the bounding box, +For the keys specifying the original size (i.e., the bounding box, trim and viewport keys) the units can be omitted, in which case bp (i.e., PostScript points) are assumed. @@ -710,7 +726,7 @@ the \LaTeXe\ primitive |\input@path|. A list of directories, each in a as the directory separator, even on Windows.) 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. \begin{decl} @@ -748,7 +764,7 @@ must exist at the time \LaTeX\ is used. extension from the \emph{ext-list} specified with |\DeclareGraphicsExtensions|.) -\emph{ext} the file extension for which this rule applies. As a special +\emph{ext} is the file extension for which this rule applies. As a special case, \emph{ext} may be given as |*| to denote the default behaviour for all undeclared extensions (see the example below). @@ -838,7 +854,7 @@ argument would change (and generate errors) if the user were to load \section{Remaining packages in the graphics bundle} \subsection{Epsfig} -This is a small package essentially a `wrapper' around the +This is a small package, essentially a `wrapper' around the \package{graphicx} package, defining a command |\psfig| which has the syntax\\ |\psfig{file=xxx,...}| rather than |\includegraphics[...]{xxx}|.\\ @@ -860,7 +876,7 @@ As well as being used as a \LaTeX\ package, the macros may be extracted with the \package{docstrip} options \texttt{plain,package}. In this case the \LaTeX\ package declarations are omitted from the file, and the macros may be directly used as part of another macro file (they work -with any format based on plain \TeX.) +with any format based on plain \TeX). \subsection{Keyval} The \package{keyval} package is intended to be used by other diff --git a/macros/latex-dev/required/graphics/keyval.dtx b/macros/latex-dev/required/graphics/keyval.dtx index 6e710a78f9..02f9a15ec7 100644 --- a/macros/latex-dev/required/graphics/keyval.dtx +++ b/macros/latex-dev/required/graphics/keyval.dtx @@ -1,7 +1,7 @@ % % \iffalse %% keyval.dtx Copyright (C) 1993 1994 1995 1997 1998 1999 David Carlisle -%% Copyright (C) 2000-2023 David Carlisle, LaTeX Project +%% Copyright (C) 2000-2024 David Carlisle, LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% diff --git a/macros/latex-dev/required/graphics/keyval.pdf b/macros/latex-dev/required/graphics/keyval.pdf Binary files differindex 7b1c32da0e..ac7d5d5f67 100644 --- a/macros/latex-dev/required/graphics/keyval.pdf +++ b/macros/latex-dev/required/graphics/keyval.pdf diff --git a/macros/latex-dev/required/graphics/lscape.dtx b/macros/latex-dev/required/graphics/lscape.dtx index c30a9f8dbd..eca5aa432b 100644 --- a/macros/latex-dev/required/graphics/lscape.dtx +++ b/macros/latex-dev/required/graphics/lscape.dtx @@ -2,7 +2,7 @@ % \iffalse % %% lscape.dtx Copyright (C) 1994 1999-2000 David Carlisle -%% Copyright (C) 2000-2023 LaTeX Project +%% Copyright (C) 2000-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% diff --git a/macros/latex-dev/required/graphics/lscape.pdf b/macros/latex-dev/required/graphics/lscape.pdf Binary files differindex a225429e46..9a3b2f72d8 100644 --- a/macros/latex-dev/required/graphics/lscape.pdf +++ b/macros/latex-dev/required/graphics/lscape.pdf diff --git a/macros/latex-dev/required/graphics/mathcolor.pdf b/macros/latex-dev/required/graphics/mathcolor.pdf Binary files differindex f1bcf17585..6f843714d6 100644 --- a/macros/latex-dev/required/graphics/mathcolor.pdf +++ b/macros/latex-dev/required/graphics/mathcolor.pdf diff --git a/macros/latex-dev/required/graphics/rotating.dtx b/macros/latex-dev/required/graphics/rotating.dtx index 4aefc71156..bac5759956 100644 --- a/macros/latex-dev/required/graphics/rotating.dtx +++ b/macros/latex-dev/required/graphics/rotating.dtx @@ -5,7 +5,7 @@ % File: rotating.dtx %% Copyright (C) 1995-1999 Sebastian Rahtz and Leonor Barroca %% Copyright (C) 2001-2003,2007-2009 Robin Fairbairns -%% Copyright (C) 2016-2023 LaTeX Project +%% Copyright (C) 2016-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. % diff --git a/macros/latex-dev/required/graphics/rotating.pdf b/macros/latex-dev/required/graphics/rotating.pdf Binary files differindex 1fe5a8b8b9..9d45e0a40c 100644 --- a/macros/latex-dev/required/graphics/rotating.pdf +++ b/macros/latex-dev/required/graphics/rotating.pdf diff --git a/macros/latex-dev/required/graphics/rotex.pdf b/macros/latex-dev/required/graphics/rotex.pdf Binary files differindex 7c153bad33..b2b66d505e 100644 --- a/macros/latex-dev/required/graphics/rotex.pdf +++ b/macros/latex-dev/required/graphics/rotex.pdf diff --git a/macros/latex-dev/required/graphics/trig.dtx b/macros/latex-dev/required/graphics/trig.dtx index 7e80931d2a..d2fa91f91f 100644 --- a/macros/latex-dev/required/graphics/trig.dtx +++ b/macros/latex-dev/required/graphics/trig.dtx @@ -1,6 +1,6 @@ % \iffalse %% File: trig.dtx Copyright (C) 1993-1999 David Carlisle -%% Copyright (C) 2000-2023 LaTeX Project +%% Copyright (C) 2000-2024 LaTeX Project %% The LaTeX Project and any individual authors listed elsewhere %% in this file. %% @@ -19,7 +19,7 @@ %<driver> \ProvidesFile{trig.drv} % \fi % \ProvidesFile{trig.dtx} - [2021/08/11 v1.11 sin cos tan (DPC)] + [2023/12/02 v1.11 sin cos tan (DPC)] % % \iffalse %</!plain> @@ -214,7 +214,7 @@ % \end{macro} % % \begin{macro}{\TG@reduce} -% Repeatedly use one of the the relations +% Repeatedly use one of the relations % $\sin(x)=\sin(180-x)=\sin(-180-x)$ to get $x$ in the range $-90 \leq % x\leq 90$. Then call |\TG@series|. % \begin{macrocode} diff --git a/macros/latex-dev/required/graphics/trig.pdf b/macros/latex-dev/required/graphics/trig.pdf Binary files differindex 6daa5bc8a2..9edb838d90 100644 --- a/macros/latex-dev/required/graphics/trig.pdf +++ b/macros/latex-dev/required/graphics/trig.pdf |