summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/graphics
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-01-22 23:37:33 +0000
committerKarl Berry <karl@freefriends.org>2017-01-22 23:37:33 +0000
commitb2ba0afced5c10391750914c16a2aa06cfaa6a96 (patch)
tree8a87b0b92f0038639e1078486bb4c2a56bcea2d3 /Master/texmf-dist/doc/latex/graphics
parentbc46c8f4627710df445115626d25161dcb2df985 (diff)
latex2e (22jan17)
git-svn-id: svn://tug.org/texlive/trunk@43024 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/graphics')
-rw-r--r--Master/texmf-dist/doc/latex/graphics/changes.txt19
-rw-r--r--Master/texmf-dist/doc/latex/graphics/color.pdfbin201376 -> 201364 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/drivers.pdfbin263549 -> 263536 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/epsfig.pdfbin153962 -> 153949 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/graphics.pdfbin280340 -> 280458 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/graphicx.pdfbin230370 -> 230357 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/grfguide.pdfbin301615 -> 308392 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/grfguide.tex112
-rw-r--r--Master/texmf-dist/doc/latex/graphics/keyval.pdfbin222533 -> 222523 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/lscape.pdfbin150122 -> 150109 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/rotating.pdfbin246167 -> 245813 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/rotex.pdfbin162265 -> 162252 bytes
-rw-r--r--Master/texmf-dist/doc/latex/graphics/trig.pdfbin191710 -> 191698 bytes
13 files changed, 72 insertions, 59 deletions
diff --git a/Master/texmf-dist/doc/latex/graphics/changes.txt b/Master/texmf-dist/doc/latex/graphics/changes.txt
index a82f79629d4..7de6eb9ae70 100644
--- a/Master/texmf-dist/doc/latex/graphics/changes.txt
+++ b/Master/texmf-dist/doc/latex/graphics/changes.txt
@@ -4,6 +4,25 @@ completeness or accuracy and it contains some references to files that
are not part of the distribution.
=======================================================================
+2016-12-23 David Carlisle <latex-bugs@latex-project.org>
+
+ * grfguide.tex: fix the a.ps example file to match the Bounding box
+ change from 2014 (Rolf Niepraschk)
+
+2016-11-18 David Carlisle <latex-bugs@latex-project.org>
+
+ * grfguide.tex: Updates to drivers section, and add a note about xcolor.
+
+2016-10-09 David Carlisle <latex-bugs@latex-project.org>
+
+ * graphics.dtx: Avoid arithmetic overflow on very small lengths
+ eg 5sp/2sp http://tex.stackexchange.com/q/328825
+
+2016-08-11 David Carlisle <latex-bugs@latex-project.org>
+
+ * rotating.dtx: Fix name of examples file reference in the
+ documentation (rotex.tex not examples.tex)
+
2016-07-10 David Carlisle <latex-bugs@latex-project.org>
* graphics-drivers.ins: stop generating dvips.def
diff --git a/Master/texmf-dist/doc/latex/graphics/color.pdf b/Master/texmf-dist/doc/latex/graphics/color.pdf
index d69d9d0413b..eab26a7bb83 100644
--- a/Master/texmf-dist/doc/latex/graphics/color.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/color.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/drivers.pdf b/Master/texmf-dist/doc/latex/graphics/drivers.pdf
index fc7dc41b526..75a40ae1e62 100644
--- a/Master/texmf-dist/doc/latex/graphics/drivers.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/drivers.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/epsfig.pdf b/Master/texmf-dist/doc/latex/graphics/epsfig.pdf
index caaa5f6344f..a629e488d01 100644
--- a/Master/texmf-dist/doc/latex/graphics/epsfig.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/epsfig.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/graphics.pdf b/Master/texmf-dist/doc/latex/graphics/graphics.pdf
index 649f8cc4e4c..f3c2f636df3 100644
--- a/Master/texmf-dist/doc/latex/graphics/graphics.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/graphics.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/graphicx.pdf b/Master/texmf-dist/doc/latex/graphics/graphicx.pdf
index b1007bd555c..109e5c2cf70 100644
--- a/Master/texmf-dist/doc/latex/graphics/graphicx.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/graphicx.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/grfguide.pdf b/Master/texmf-dist/doc/latex/graphics/grfguide.pdf
index 46849ce1f3d..c62b8253ac9 100644
--- a/Master/texmf-dist/doc/latex/graphics/grfguide.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/grfguide.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/grfguide.tex b/Master/texmf-dist/doc/latex/graphics/grfguide.tex
index fc35793960b..193282900b9 100644
--- a/Master/texmf-dist/doc/latex/graphics/grfguide.tex
+++ b/Master/texmf-dist/doc/latex/graphics/grfguide.tex
@@ -11,12 +11,12 @@
\begin{filecontents*}{a.ps}
%!
%%BoundingBox:0 0 72 72
-100 100 moveto
+0 0 moveto
72 72 rlineto
72 neg 0 rlineto
72 72 neg rlineto
stroke
-100 100 moveto
+0 0 moveto
/Times-Roman findfont
72 scalefont
setfont
@@ -168,8 +168,8 @@ startxref
%% Just as an example, and to make sure, in case some
%% driver option has not declared a default rule for
%% .ps files:
-\DeclareGraphicsRule{.ps}{eps}{.ps}{}
-\DeclareGraphicsExtensions{.pdf,.ps}
+%\DeclareGraphicsRule{.ps}{eps}{.ps}{}
+%\DeclareGraphicsExtensions{.pdf,.ps}
%% Which means:
%% .ps files are (to be treated as) EncapsulatedPostScript
%% files. The .ps file is to be read for the BoundingBox.
@@ -190,7 +190,7 @@ startxref
\begin{document}
\title{Packages in the `graphics' bundle}
\author{D. P. Carlisle \and The \LaTeX3 Project}
-\date{2016/05/22}
+\date{2016/12/23}
\maketitle
@@ -210,69 +210,66 @@ even the internal method of accessing these extensions varies between
drivers. Consequently all these packages take options such as
`|dvips|' to specify which driver is being used.
-You should to set up a site default for these
-options, for the driver that you normally use. Suppose that you wish for
+Normally you should \emph{not} specify the driver option explicitly
+in the document, but allow it to be defaulted automatically.
+This allows the document to be portable between different systems.
+
+Your \TeX\ distribution should have included |graphics.cfg| and
+|color.cfg| configuration files to specify these defaults.
+Standard versions of the configuration files are maintained by the
+\LaTeX\ Project and distributed in the CTAN |graphics-cfg| collection.
+
+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, |dvipsone|. In that case create a file |color.cfg|
+PostScript driver, |dvisvgm|. In that case, create a file |color.cfg|
containing the line:\\
-|\ExecuteOptions{dvipsone}|\\
+|\ExecuteOptions{dvisvgm}|\\
Normally you will want an identical file |graphics.cfg| to set a similar
default for the graphics packages.
The following driver options are declared in the packages.
+The matching definition files (\emph{driver}|.def|)
+are now also maintained by the \LaTeX\ project,
+but distributed separately, in the CTAN |graphics-def| collection.
\begin{quote}\raggedright
- |dvips|, |xdvi|, |dvipdf|, |dvipdfm|, |dvipdfmx|, |pdftex|,
- |dvipsone|, |dviwindo|, |emtex|, |dviwin|, |pctexps|, |pctexwin|,
- |pctexhp|, |pctex32|, |truetex|, |tcidvi|, |vtex|, |oztex|,
- |textures|, |xetex|
+ |dvipdfmx|, |dvips|, |dvisvgm|, |luatex|, |pdftex|, |xetex|
\end{quote}
-Note that the \LaTeX\ Team does not maintain these drivers; we merely
-provide a way for a particular driver to work with the graphics
-packages.
-If you use a driver that is not in the list above you may add an option
-for that driver by putting the appropriate |\DeclareOption| line into
-|graphics.cfg| and |color.cfg|, before making it the default option
-with |\ExecuteOptions|, as described above.
-For example to add the option `|dvi2ps|' for the original Unix dvi to
-ps driver, and to make that the default, you just need configuration
-files looking like:
-\begin{verbatim}
-\DeclareOption{dvi2ps}{\def\Gin@driver{dvi2ps.def}}
-\ExecuteOptions{dvi2ps}
-\end{verbatim}
+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|
+\end{quote}
-There is a suitable |dvi2ps.def| file in the standard distribution.
-It is not enabled by default as it is not well tested as the driver is
-no longer available to me. The following driver files are similarly
-distributed but not enabled by default.
+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
+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
+sources for older driver files that are no longer extracted.
\begin{quote}\raggedright
- |dvi2ps|, |dvialw|, |dvilaser|, |dvitops|, |psprint|, |pubps|, |ln|
+ |dvipdf|, |dvipdfm|, |dviwin|, |dvipsone|,
+ |emtex|, |pctexps|, |pctexwin|, |pctexhp|, |pctex32|,
+ |truetex|, |tcidvi|, |vtex|
\end{quote}
-Most of these driver files are generated from the source file
-|drivers.dtx|. That file has the sources for other versions (for
-example older versions of dvips and textures) which are not generated
-by default.
-
-Different \TeX\ systems support different drivers and the drivers are
-usually maintained by the developers of the \TeX\ variants or
-post-processors. Hence they are always linked to some program and
-since the \TeX\ distributors decide which programs they support, it is
-up to them to make sure the necessary drivers are included with their
-distribution. The graphics bundle contains the installation file
-|graphics-drivers.ins| which can be used to extract drivers from
-|drivers.dtx| but we cannot guarantee that these are up to date. Not
-all of the aforementioned drivers are available in |drivers.dtx| (some
-like |pdftex| and |dvipdfm| can be found on CTAN).
-
-If you use a driver that is not covered by any of these possibilities,
-you may try to write a |.def| file by analogy with one of the existing
-ones, and then specify a suitable option in |graphics.cfg| and
-|color.cfg|, as for the above example of |dvi2ps|.
-
-\section{Colour}
+The final driver option is an alias for |dvipsone|.
+\begin{quote}\raggedright
+ |dviwindo|
+\end{quote}
+
+
+\section[Colour]{Colour\footnote{%
+The basic \package{color} package functionality described here
+will be enough for many uses, however a much extended version
+is available in the contributed \package{xcolor} package, distributed
+and maintained separately. All the color commands described here are
+also available if you specify \package{xcolor} in your document.}%
+}
The colour support is built around the idea of a system of
\emph{Colour Models}. The Colour models supported by a driver vary,
but typically include
@@ -796,11 +793,8 @@ the \LaTeXe\ primitive |\input@path|. A list of directories, each in a
|{}| group (even if there is only one in the list). For example:\\
|\graphicspath{{eps/}{tiff/}}|\\
would cause the system to look in the subdirectories |eps| and |tiff|
- of the current directory. This is unix syntax, on a Mac it would be:\\
- |\graphicspath{{:eps:}{:tiff:}}|\\
- Note the differing conventions, an initial |:| is needed on Macintosh
- systems to denote the current folder, whereas on unix an initial |/|
- would denote the top level `root' directory.
+ of the current directory. (All modern \TeX{} systems use |/|
+ 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\
diff --git a/Master/texmf-dist/doc/latex/graphics/keyval.pdf b/Master/texmf-dist/doc/latex/graphics/keyval.pdf
index bd0ea56d6fd..799678bd358 100644
--- a/Master/texmf-dist/doc/latex/graphics/keyval.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/keyval.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/lscape.pdf b/Master/texmf-dist/doc/latex/graphics/lscape.pdf
index 7212c62b9b1..e4fe8680d25 100644
--- a/Master/texmf-dist/doc/latex/graphics/lscape.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/lscape.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/rotating.pdf b/Master/texmf-dist/doc/latex/graphics/rotating.pdf
index c2d7663074d..5b789e322ea 100644
--- a/Master/texmf-dist/doc/latex/graphics/rotating.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/rotating.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/rotex.pdf b/Master/texmf-dist/doc/latex/graphics/rotex.pdf
index b895b5478fc..6bfff318236 100644
--- a/Master/texmf-dist/doc/latex/graphics/rotex.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/rotex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/graphics/trig.pdf b/Master/texmf-dist/doc/latex/graphics/trig.pdf
index 1cc22c81138..31a9f1bb784 100644
--- a/Master/texmf-dist/doc/latex/graphics/trig.pdf
+++ b/Master/texmf-dist/doc/latex/graphics/trig.pdf
Binary files differ