texlive[49883] Build/source/texk/dvipdfm-x/man/dvipdfmx.1: mention

commits+karl at tug.org commits+karl at tug.org
Thu Jan 31 19:24:45 CET 2019

Revision: 49883
Author:   karl
Date:     2019-01-31 19:24:45 +0100 (Thu, 31 Jan 2019)
Log Message:
mention pdf:trailer special

Modified Paths:

Modified: trunk/Build/source/texk/dvipdfm-x/man/dvipdfmx.1
--- trunk/Build/source/texk/dvipdfm-x/man/dvipdfmx.1	2019-01-31 18:21:25 UTC (rev 49882)
+++ trunk/Build/source/texk/dvipdfm-x/man/dvipdfmx.1	2019-01-31 18:24:45 UTC (rev 49883)
@@ -10,7 +10,7 @@
-.TH "DVIPDFMX" "1" "7 March 2016"
+.TH "DVIPDFMX" "1" "24 December 2018"
 dvipdfmx, xdvipdfmx, dvipdfm \- produce PDF files directly from DVI files
@@ -38,7 +38,7 @@
 In addition,
 .B xdvipdfmx
-is yet another incarnation.  It is used as the back end for
+is another incarnation.  It is used as the back end for
 .BR xetex (1)
 and is not intended to be invoked directly.
@@ -56,25 +56,41 @@
 where possible, so that many macro packages produced for use with
 .B dvips
 will also work with 
-.B dvipdfmx.
+.BR dvipdfmx .
 In addition,
-.B Dvipdfmx 
+.B dvipdfmx 
 understands its own specific
 .B \especial
 commands to allow access to PDF features such as annotations and
+As of December 2018, one such special specific to
+.B dvipdfmx
+.IR pdf:trailerid ,
+which specifies the /ID in the PDF trailer.
+It is used like this (from the TeX level):
+\especial{pdf:trailerid [ (0123456789abcdef) (01234567890abcdef) ]}
+That is, the special takes an array (the square brackets) of two 16-byte
+PDF strings (the parentheses). This is the same syntax as LuaTeX's
+.IR "\epdfvariable trailerid" ,
+while different from pdfTeX's
+.IR \epdftrailerid .
+It must appear on the first output page, otherwise it is ignored.
 Unrecognized specials will generate warning messages. Packages that may need a 
 .B dvipdfm 
 .B dvipdfmx 
 driver option include 
-.I geometry,
-.I hyperref,
-.I bookmark,
-.I graphicx,
+.IR geometry ,
+.IR hyperref ,
+.IR bookmark ,
+.IR graphicx ,
-.I xcolor.
+.IR xcolor .
 For issues related to bounding boxes (and hence image sizes), see
 .BR extractbb (1).
@@ -321,12 +337,13 @@
 .B kpsewhich texmf.cnf
-.BR dvipdft "(1), "
-.BR extractbb "(1), "
-.BR tex "(1), " dvips "(1), " groff "(1), " grodvi "(1), " pic "(1), "
-and the
-.I "Kpathsea library"
-Info documentation (http://tug.org/kpathsea).
+dvipdft(1), extractbb(1),
+tex(1), luatex(1), xetex(1), dvips(1),
+groff(1), grodvi(1), pic(1),
+the Kpathsea library Info documentation (http://tug.org/kpathsea),
+and the Dvipdfmx User's Manual (in the distribution).
 Primarily Mark A. Wicks; dvipdfmx extensions primarily by Jin-Hwan Cho,
 Shunsaku Hirata, and Matthias Franz.  For the version in TeX Live, all
@@ -333,4 +350,4 @@
 bugs and other reports should go to the
 .B dvipdfmx
 maintainers at tex-k (at) tug.org.  This man page edited for TeX Live
-by Bob Tennent and others.
+by Bob Tennent and others.  This man page is public domain.

More information about the tex-live-commits mailing list