From f2eb098294c4f0ddec9a76d60f089c447dacb69e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 31 Jan 2019 18:24:45 +0000 Subject: mention pdf:trailer special git-svn-id: svn://tug.org/texlive/trunk@49883 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvipdfm-x/man/dvipdfmx.1 | 49 ++++++++++++++++++++---------- 1 file changed, 33 insertions(+), 16 deletions(-) (limited to 'Build') diff --git a/Build/source/texk/dvipdfm-x/man/dvipdfmx.1 b/Build/source/texk/dvipdfm-x/man/dvipdfmx.1 index ffacc60894b..ba836351eb8 100644 --- a/Build/source/texk/dvipdfm-x/man/dvipdfmx.1 +++ b/Build/source/texk/dvipdfm-x/man/dvipdfmx.1 @@ -10,7 +10,7 @@ .sp .fi .. -.TH "DVIPDFMX" "1" "7 March 2016" +.TH "DVIPDFMX" "1" "24 December 2018" .SH NAME dvipdfmx, xdvipdfmx, dvipdfm \- produce PDF files directly from DVI files .SH SYNOPSIS @@ -38,7 +38,7 @@ possible. 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 @@ to mimic the behavior of 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 bookmarks. +As of December 2018, one such special specific to +.B dvipdfmx +is +.IR pdf:trailerid , +which specifies the /ID in the PDF trailer. +It is used like this (from the TeX level): +.br +\especial{pdf:trailerid [ (0123456789abcdef) (01234567890abcdef) ]} +.br +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 or .B dvipdfmx driver option include -.I geometry, -.I hyperref, -.I bookmark, -.I graphicx, +.IR geometry , +.IR hyperref , +.IR bookmark , +.IR graphicx , and -.I xcolor. +.IR xcolor . For issues related to bounding boxes (and hence image sizes), see .BR extractbb (1). @@ -321,16 +337,17 @@ The location of this file may be found by typing .B kpsewhich texmf.cnf .fi .SH "SEE ALSO" -.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), +.br +tex(1), luatex(1), xetex(1), dvips(1), +.br +groff(1), grodvi(1), pic(1), +the Kpathsea library Info documentation (http://tug.org/kpathsea), +and the Dvipdfmx User's Manual (in the distribution). .SH AUTHOR Primarily Mark A. Wicks; dvipdfmx extensions primarily by Jin-Hwan Cho, Shunsaku Hirata, and Matthias Franz. For the version in TeX Live, all 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. -- cgit v1.2.3