From b15fd2a0169f34e4970575561ef4c03a3e2c687c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 30 Mar 2018 22:36:45 +0000 Subject: pdftex-1.40.19 manual update for 2018 git-svn-id: svn://tug.org/texlive/trunk@47199 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/pdftex/manual/ChangeLog | 19 +++++++ Master/texmf-dist/doc/pdftex/manual/Makefile | 4 +- Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf | Bin 818472 -> 819006 bytes Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex | 60 +++++++++++++++-------- 4 files changed, 61 insertions(+), 22 deletions(-) (limited to 'Master/texmf-dist/doc/pdftex') 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 + + * pdftex-t.tex (encodingfile): supported for Type 3 fonts. + +2017-12-14 Karl Berry + + * pdftex-t.tex (\pdfinfo): describe [+-]HH'mm' time zone + specification as well as Z. + +2017-11-28 Karl Berry + + * pdftex-t.tex (\pdfprimitive): clarify further. + +2017-11-14 Karl Berry + + * 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 * 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 Binary files a/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf and b/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf 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}}} -- cgit v1.2.3