summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-03-30 22:36:45 +0000
committerKarl Berry <karl@freefriends.org>2018-03-30 22:36:45 +0000
commitb15fd2a0169f34e4970575561ef4c03a3e2c687c (patch)
treeab0fe5950ebe3c1f382e71355e0d9dbe5b6d436e
parent455506ec711f0d6edd259c0b7c5e5a533d34ecee (diff)
pdftex-1.40.19 manual update for 2018
git-svn-id: svn://tug.org/texlive/trunk@47199 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/pdftex/manual/ChangeLog19
-rw-r--r--Master/texmf-dist/doc/pdftex/manual/Makefile4
-rw-r--r--Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdfbin818472 -> 819006 bytes
-rw-r--r--Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex60
4 files changed, 61 insertions, 22 deletions
diff --git a/Master/texmf-dist/doc/pdftex/manual/ChangeLog b/Master/texmf-dist/doc/pdftex/manual/ChangeLog
index 5ed479c2fd2..3c90f87a7da 100644
--- a/Master/texmf-dist/doc/pdftex/manual/ChangeLog
+++ b/Master/texmf-dist/doc/pdftex/manual/ChangeLog
@@ -1,3 +1,22 @@
+2018-01-01 Karl Berry <karl@freefriends.org>
+
+ * pdftex-t.tex (encodingfile): supported for Type 3 fonts.
+
+2017-12-14 Karl Berry <karl@freefriends.org>
+
+ * pdftex-t.tex (\pdfinfo): describe [+-]HH'mm' time zone
+ specification as well as Z.
+
+2017-11-28 Karl Berry <karl@freefriends.org>
+
+ * pdftex-t.tex (\pdfprimitive): clarify further.
+
+2017-11-14 Karl Berry <karl@freefriends.org>
+
+ * pdftex-t.tex (\pdftrailerid): absolute file name is no longer
+ used in the /ID seed, just the base name, for reproducibility.
+ (\pdfprimitive): clarify.
+
2017-04-20 Karl Berry <karl@freefriends.org>
* pdftex-t.tex (\currentpdftex): 1.40.18 (for TeX Live 2017).
diff --git a/Master/texmf-dist/doc/pdftex/manual/Makefile b/Master/texmf-dist/doc/pdftex/manual/Makefile
index 102d82ff576..d6589ac1c04 100644
--- a/Master/texmf-dist/doc/pdftex/manual/Makefile
+++ b/Master/texmf-dist/doc/pdftex/manual/Makefile
@@ -1,4 +1,4 @@
-# $Id: Makefile 751 2016-05-04 22:57:38Z karl $
+# $Id: Makefile 767 2017-02-18 23:49:54Z karl $
# Makefile for pdfTeX documentation. Public domain.
# Get version we're documenting from the \def in the manual.
@@ -16,7 +16,7 @@ all: pdftex-l.pdf pdftex-s.pdf booklet
common_deps = pdftex-t.tex pdftex-w.txt pdftex-help.txt pdftex-syntax.tex
pdftex-a.pdf a: $(common_deps)
- $(context) --result=$@ $<
+ $(context) --mode=a4 --result=$@ $<
pdftex-l.pdf l: $(common_deps)
$(context) --mode=letter --result=$@ $<
diff --git a/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf b/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf
index 3f8c4abe269..f29ac5d9a47 100644
--- a/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf
+++ b/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex b/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
index 248dc9ae4dc..da2703fe56b 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 777 2017-04-20 23:08:32Z karl $
+% $Id: pdftex-t.tex 790 2018-01-02 00:12:04Z karl $
% The number of lines on the title page depends on exactly
% what \PDF\ code is generated.
@@ -38,7 +38,7 @@
August\or September\or October\or November\or December\else ERROR\fi}
}
-\svnscan $Id: pdftex-t.tex 777 2017-04-20 23:08:32Z karl $
+\svnscan $Id: pdftex-t.tex 790 2018-01-02 00:12:04Z karl $
\def\currentpdftex{1.40.18}
@@ -1428,15 +1428,13 @@ Some nice samples of \PDFTEX\ output can be found at
\section{Setting up fonts}
-\PDFTEX\ can work with Type~1 and TrueType fonts (and to some extent also
-with OpenType fonts). Font files should be available and embedded for all
-fonts used in the document. It is possible to use \METAFONT||generated
-fonts in \PDFTEX\ --- but it is strongly recommended not to use these
-fonts if an equivalent is available in Type~1 or TrueType format, if
-only because bitmap Type~3 fonts render very poorly in (older versions
-of) Adobe Reader. Given the free availability of Type~1 versions of all
-the Computer Modern fonts, and the ability to use standard \POSTSCRIPT\
-fonts, there is rarely a need to use bitmap fonts in \PDFTEX.
+\PDFTEX\ can work with Type~1 and TrueType fonts (and to some extent
+also with OpenType fonts). Font files should be available and embedded
+for all fonts used in the generated PDF. It is possible to use
+\METAFONT||generated fonts in \PDFTEX\ --- but it is strongly
+recommended not to use these fonts if an equivalent is available in
+Type~1 or TrueType format, if only because bitmap Type~3 fonts render
+poorly under enlargement.
%***********************************************************************
@@ -1608,6 +1606,22 @@ may be omitted if you are sure that the font resource has the correct
built||in encoding. In general this option is highly recommended, and it
is {\em required} when subsetting a TrueType font.
+Starting with version 1.40.19, an encoding file can also be specified
+for bitmap \PK\ fonts. In this case, it assigns the glyph names from the
+given encoding vector, which can be used with the
+\type{\pdfglyphtounicode} primitive (q.v.). For example:
+
+\starttyping
+\pdfglyphtounicode{ffi}{0066 0066 0069} % normally: \input glyphtounicode
+\pdfgentounicode=1
+\pdfmapline{cmb10 <7t.enc}
+\font\cmb=cmb10 \cmb ffi
+\stoptyping
+
+The result is a \PDF\ file with a correctly-labeled \type{/ffi}
+character instead of the numeric character position in the
+\type{cmb10.tfm} (decimal 14).
+
\stopdescription
\startdescription {fontfile}
@@ -2300,8 +2314,13 @@ keys are:\crlf
\type{D:YYYYMMDDhhmmssTZ}, where \type{YYYY} is the year, \type{MM} is
the month, \type{DD} is the day, hh is the hour, \type{mm} is the
minutes, \type{ss} is the seconds, and \type{TZ} is an optional string
-denoting the time zone. For example, this is the Unix epoch, the
-beginning of 1970-01-01 UTC, in this format: \type{19700101000000Z}
+denoting the time zone, \type{Z} for universal time. For example, this
+is the Unix epoch, the beginning of 1970-01-01 UTC, in this format:
+\type{19700101000000Z}. If the time zone is not UTC, it is given as
+\type{+HH'mm'} or \type{-HH'mm'}, indicating an offset of the given
+hours and minutes from UTC, with the given either later (\type{+}) or
+earlier (\type{-}) than UTC. (This syntax is specified by the PDF
+definition.)
Multiple appearances of \type{\pdfinfo} are concatenated. Usually if a
key is given more than once, the first appearance will be used, but this
@@ -2433,7 +2452,7 @@ dictionary. Example: \type{\pdftrailer {/mytrlrkey /mytrlrval}}.
\bookmark{\tex{pdftrailerid}}
Use the \Something{general text} to seed the \type{/ID} value in the
-trailer, instead of the default combination of the absolute input file
+trailer, instead of the default combination of the input file
name and starting time. If the argument is empty, the \type{/ID} is
omitted entirely. Example: \type{\pdftrailerid{}}. This can be useful
in making reproducible \PDF{}s. \introduced{1.40.17}
@@ -2978,7 +2997,7 @@ entries are added to the table using the following command:
\Something{general text}}}
The first argument is the name of a glyph, the second is a string of Unicode
-numeric values denoting characters. For instance:
+numeric values denoting characters, separated by spaces. For instance:
\starttyping
\pdfgentounicode=1
@@ -4326,11 +4345,12 @@ Completely analogous to \type{\pdflastxpos}, returning the $y$ coordinate.
\bookmark{\tex{pdfprimitive}}
This command executes the primitive meaning of the following control
-sequence, if it has been redefined or made undefined. If the following
-control sequence is undefined and never was a primitive, nothing happens
-and no error is raised. If the control sequence was initially
-expandable, \type{\pdfprimitive} expands either. Otherwise
-\type{\pdfprimitive} doesn't expand. \introduced{1.40.0}
+sequence, regardless of whether the control sequence has been redefined
+or made undefined. If the primitive was expandable, \type{\pdfprimitive}
+expands also. On the other hand, if the following control sequence never
+was a primitive, nothing happens and no error is raised. (In some
+versions of \PDFTEX\ prior to 1.40.19, an error was wrongly given.)
+\introduced{1.40.0}
\pdftexprimitive{\Syntax{\Tex{\pdfretval} \Whatever{read||only integer}}}