summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex')
-rw-r--r--Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex65
1 files changed, 37 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex b/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
index 98e0fc8e05b..e7a56202e9d 100644
--- a/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
+++ b/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
@@ -1,7 +1,7 @@
% interface=english modes=letter,screen output=pdftex
% vim: tw=79
-% $Id: pdftex-t.tex 715 2014-05-22 22:18:26Z karl $
+% $Id: pdftex-t.tex 722 2015-03-25 23:13:50Z karl $
% The number of lines on the titlepage depends on exactly
% what \PDF\ code is generated.
@@ -56,9 +56,9 @@
July\or August\or September\or October\or November\or December\else ERROR\fi}
}
-\svnscan $Id: pdftex-t.tex 715 2014-05-22 22:18:26Z karl $
+\svnscan $Id: pdftex-t.tex 722 2015-03-25 23:13:50Z karl $
-\def\currentpdftex{1.40.15}
+\def\currentpdftex{1.40.16}
%***********************************************************************
@@ -74,7 +74,6 @@
\abbreviation [ASCII] {ascii} {American Standard Code for Information Interchange}
\abbreviation [CONTEXT] {\ConTeXt} {general purpose macro package}
\abbreviation [CTAN] {ctan} {global \TEX\ archive server}
-%\abbreviation [DJGPP] {djgpp} {DJ Delorie's \GNU\ Programming Platform}
\abbreviation [DVI] {dvi} {native \TEX\ Device Independent file format}
\abbreviation [ENCTEX] {enc\TeX} {enc\TeX\ extension to \TEX}
\abbreviation [EPSTOPDF] {epstopdf} {\EPS\ to \PDF\ conversion tool}
@@ -88,6 +87,8 @@
\abbreviation [ISO] {iso} {International Organization for Standardization}
\abbreviation [JBIG] {jbig} {Joint Bi-level Image Experts Group}
\abbreviation [JBIGTWO] {jbig2} {Joint Bi-level Image Experts Group}
+\abbreviation [JFIF] {jfif} {JPEG File Interchange Format}
+\abbreviation [JPEG] {jpeg} {Joint Photographic Experts Group}
\abbreviation [JPEG] {jpeg} {Joint Photographic Experts Group}
\abbreviation [LATEX] {\LaTeX} {general purpose macro package}
\abbreviation [MAC] {Macintosh} {Macintosh hardware platform}
@@ -696,7 +697,7 @@ Please send questions or suggestions by email to \from[ptex_bugs].
\subsection{Legal Notice}
-Copyright \copyright\ 1996||2014 \THANH.
+Copyright \copyright\ 1996||2015 \THANH.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
@@ -1816,7 +1817,7 @@ new Didot (1\,nd~=~0.375\,mm) and the new Cicero (1\,nc~=~12\,nd)
%%S pdfTeX documentation file pdftex-t.tex by script syntaxform.awk.
%%S Used convention for syntax rules is borrowed from `TeXbook naruby'
%%S by Petr Olsak.
-%%S $Id: pdftex-t.tex 715 2014-05-22 22:18:26Z karl $
+%%S $Id: pdftex-t.tex 722 2015-03-25 23:13:50Z karl $
%%S NL
%%S integer registers:
@@ -2764,20 +2765,24 @@ is \DVI.
\bookmark{\tex{pdfminorversion}}
-This primitive sets the \PDF\ version of the generated file and the latest
-allowed \PDF\ version of included \PDF{}s. \Eg, \type{\pdfminorversion=3} tells
-\PDFTEX\ to set the \PDF\ version to 1.3 and allows only included \PDF\ files
-with versions numbers up to 1.3. The default for \type{\pdfminorversion} is 5,
-producing files with \PDF\ version 1.5. If specified, this primitive must
-appear before any data is to be written to the generated \PDF\ file, so you
-should put it at the very start of your files. The command has been introduced
-in \PDFTEX\ 1.30.0 as a shortened synonym of \type{\pdfoptionpdfminorversion}
-command, which is now obsolete.
-
-Distributions alter the default value here; for example, \TEXLIVE\ 2010
-sets \type{\pdfminorversion=5} when its formats are built, so object
+This primitive sets the \PDF\ version of the generated file and the
+highest \PDF\ version of included \PDF{}s allowed without warning, by
+default (see \type{\pdfinclusionerrorlevel}). The default compiled into
+the \PDFTEX\ program is \type{\pdfminorversion=4}, setting the \PDF\
+version to~1.4 and allowing included \PDF\ files with versions up
+to~1.4. If specified, this primitive must appear before any data is to
+be written to the generated \PDF\ file.
+
+Distributions typically alter the engine's compiled default of~4 when
+building formats; for example, as of 2010, \TEXLIVE\ sets
+\type{\pdfminorversion=5} when formats are built. This is so object
compression can be enabled (described below).
+This was originally a shortened synonym of the
+\type{\pdfoptionpdfminorversion} command, which is now obsolete.
+\introduced{1.30.0}
+
+
\pdftexprimitive {\Syntax {\Tex {\pdfcompresslevel} \Whatever{integer}}}
\bookmark{\tex{pdfcompresslevel}}
@@ -2789,7 +2794,7 @@ and re-compressed during the embedding process); all done by the
9~means best, $2..8$ means something in between. A value outside this
range will be adjusted to the nearest meaningful value. This parameter
is read each time \PDFTEX\ starts a stream. Setting
-\type{\pdfcompresslevel=0} is great for \PDF\ stream debugging.
+\type{\pdfcompresslevel=0} is useful for \PDF\ stream debugging.
\pdftexprimitive {\Syntax {\Tex {\pdfobjcompresslevel} \Whatever{integer}}}
@@ -2826,7 +2831,7 @@ is still not compressed. Finally, when set to~3, all non-stream objects
are compressed, including the \type{/Info} dictionary (this means that
the \type{/Info} can't be read as clear text any more). If object streams
are to be used, currently \type{\pdfobjcompresslevel=2} is recommended,
-and set so in some distributions.
+and is so specified in some distributions, including \TEXLIVE~2010 and later.
\description{Caveat:} \PDF\ files generated with object streams enabled
can't be read with (sufficiently old) \PDF\ viewers that don't
@@ -4136,11 +4141,14 @@ now considered obsolete --- a mixture of \type{\pdfpagebox} and
\bookmark{\tex{pdfinclusionerrorlevel}}
This controls the behaviour of \PDFTEX\ when a \PDF\ file is included
-that has a newer version than the one specified by this primitive: If it
-is set to~0, \PDFTEX\ gives only a warning; if it's~1, \PDFTEX\ raises
-an error. The command has been introduced in \PDFTEX\ 1.30.0 as
-a shortened synonym of \type{\pdfoptionpdfinclusionerrorlevel}, which is
-now obsolete.
+that has a newer version than the one specified by
+\type{\pdfminorversion}. If \type{\pdfinclusionerrorlevel} is set to~0
+(the default), \PDFTEX\ gives only a warning; if 1, \PDFTEX\ raises an
+error; if negative, no diagnostic at all is given.
+
+It was originally a shortened synonym of
+\type{\pdfoptionpdfinclusionerrorlevel}, which is now obsolete.
+\introduced{1.30.0}
\pdftexprimitive {\Syntax {\Tex {\pdfimagehicolor} \Whatever{integer}}}
@@ -4258,7 +4266,7 @@ problematic case; unfortunately, this is not easy (a patch would be
welcome). Nevertheless, often one observes that there is no actual
problem. Then seeing the warnings on every run is just noise, and can
be suppressed by setting this parameter to a positive number.
-\introduced{1.40.14}
+\introduced{1.40.15}
%***********************************************************************
@@ -5102,8 +5110,9 @@ fast copy mode is used for a \PNG\ image can be seen from the log file,
which then shows the string `(PNG copy)' after the \PNG\ file name.
The \JPEG\ format is normally used in lossy mode; then it's ideal for
-embedding photos; it's not recommended for crisp images from synthetic
-sources with a limited amount of colors.
+embedding photos. It's not recommended for crisp images from synthetic
+sources with a limited amount of colors. Both \JFIF\ and \EXIF\ are
+supported for additional information.
The \JBIGTWO\ format works only for bitonal (black and white) pixel
images like scanned line and text documents, but for these it has