update documents for [x]dvipdfmx

git-svn-id: svn://tug.org/texlive/trunk@50157 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 26 insertions, 11 deletions

diff --git a/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.pdf b/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.pdf
index 0be076d9bdd..c3f78cec082 100644
--- a/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.pdf
+++ b/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.pdf
diff --git a/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.tex b/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.tex
index a8bd4a54c5a..b346ef1315b 100644
--- a/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.tex
+++ b/Master/texmf-dist/doc/dvipdfmx/dvipdfmx.tex
@@ -102,7 +102,7 @@
   \begin{raggedleft}
     {\Huge\bfseries The Dvipdfmx User's Manual}\\[\baselineskip]
     \Large The Dvipdfmx Project Team\\
-    August 30, 2018\par
+    December 23, 2018\par
   \end{raggedleft}
 \end{titlepage}
 
@@ -262,7 +262,7 @@ This section is intended to be a quick guide for each users.
 \XeTeX\ users
 normally do not invoke the \dvipdfmx\ command directly. To control the
 behavior of \dvipdfmx, please consider using the \code{dvipdfmx:config}
-special explained in the section of ``\hyperref[SEC:specials]{Specials}.''
+special explained in the section of ``\hyperref[SEC:specials]{Specials}''.
 Some part of this document is irrelevant for \XeTeX\ users.
 
 \subsection{p\TeX}
@@ -404,7 +404,7 @@ want to install them but they are not required.
 
 CJK fonts usually contain several thousands of glyphs. For using such fonts
 with (original) \TeX, which can only handle 8-bit encodings, it is necessary to
-split a font into several ``subfonts''. Subfont Definition File (SFD)
+split a font into several \keyword{subfonts}. The Subfont Definition File (SFD)
 specify the way how those fonts are split into subfonts. \dvipdfmx\ uses SFD
 files to convert a set of subfonts back to a single font.
 
@@ -967,7 +967,7 @@ where identifier and filename (specified as a PDF string object) are
 mandatory and a dictionary object, following the filename, which is to be added
 to the stream dictionary is optional.
 
-For example, to incorporate XMP Metadata stored from the file \code{test.xmp},
+For example, to incorporate XMP Metadata from a file \code{test.xmp},
 \begin{lstlisting}
 \special{pdf:fstream @xmp (test.xmp) <<
     /Type    /Metadata
@@ -1031,7 +1031,7 @@ pdf:mapline foo unicode bar
 pdf:mapfile foo.map
 \end{lstlisting}
 
-\subsubsection{Specifying The Output PDF Version}
+\subsubsection{Specifying Output PDF Version}
 
 \code{pdf:majorversion} and \code{pdf:minorversion} specials can be used to
 specify major and minor version of output PDF.
@@ -1039,6 +1039,21 @@ specify major and minor version of output PDF.
 pdf:minorversion 3
 \end{lstlisting}
 
+Please note that this command must appear on the first page,
+otherwise it will be ignored.
+
+\subsubsection{Custom File Identifiers}
+
+\newfeature{Addition in \TeX\ Live 2019}
+
+A custom file identifier (the \code{ID} entry in the trailer dictionary)
+can be specified via \code{pdf:trailerid} special as
+\begin{lstlisting}
+pdf:trailerid [(0123456789abcdef) (0123456789abcdef)]
+\end{lstlisting}
+An array of two 16-byte PDF string objects must be supplied as
+a file identifier. This special command must appear on the first page.
+
 \subsubsection{Encryption}
 
 To protect output PDF with encryption, use \code{pdf:encrypt} special
@@ -1130,7 +1145,7 @@ additional dictionary keys as an array object:
 
 If the name of conversion CMap contains one of the keywords RKSJ, \lnum{B5}, GBK, and KSC,
 PDF string objects are treated specially when they are parsed. A two byte sequence
-starting with the first byte's high bit set is treated ''as is'' so that
+starting with the first byte's high bit set is treated ``as is'' so that
 the \code{0x5c} byte appears in the second byte is not treated as an escape sequence.
 This behavior is not compliant to the PDF specification.
 
@@ -1139,7 +1154,7 @@ This behavior is not compliant to the PDF specification.
 This section shows several examples of special command usage.
 It is intended to be a hint for advanced users, so uninterested users can safely skip
 this section. In many cases, using \dvipdfmx\ PDF specials requires knowledge on PDF.
-Please refer to Adobe's ''PDF Reference''\cite{ADOBE}.
+Please refer to Adobe's ``PDF Reference''\cite{ADOBE}.
 
 \subsubsection{Annotations}
 
@@ -1714,7 +1729,7 @@ the encoding name for 8-bit encodings. For example, to specify the CMap ``UniJIS
 \end{lstlisting}
 
 For information on the Adobe Glyph List and PostScript CMap Resources, see,
-the section \ref{SEC:auxfiles}, ``Auxiliary Files.''
+the section \ref{SEC:auxfiles}, ``Auxiliary Files''.
 
 \subsection{Extended Syntax and Options}
 
@@ -1945,7 +1960,7 @@ In OpenType font format, information regarding how a font should be treated
 when creating a document can be recorded.%
 \footnote{See,
 ``\href{http://www.microsoft.com/typography/otspec/os2.htm}{OpenType Specification:
-OS/2 -- OS/2 and Windows Metrics Table}''.}
+OS/2 -- OS/2 and Windows Metrics Table}''}.
 \dvipdfmx\ uses this information to decide whether font embedding is permitted.
 
 This font licensing information is indicated by the flag called \code{fsType}
@@ -2174,7 +2189,7 @@ dropped. Simplified support for the OpenType Layout was introduced instead.
 %\renewcommand{\refname}{Further Reading}
 \renewcommand{\bibname}{Further Reading}
 \begin{thebibliography}{99}
-\bibitem{DVIPDFM}  ''\href{http://mirrors.ctan.org/dviware/dvipdfm/dvipdfm.pdf}%
+\bibitem{DVIPDFM} ``\href{http://mirrors.ctan.org/dviware/dvipdfm/dvipdfm.pdf}%
 {Dvipdfm User's Manual}'' written by Mark~A.~Wicks.
 \bibitem{ADOBE} Adobe's PDF References and a free copy of
 \lnum{ISO 32000-1:2008} standard are available from
@@ -2184,7 +2199,7 @@ on \href{http://www.adobe.com/devnet.html}{Adobe Developer Connection}.
 site:
 ``\href{http://www.microsoft.com/en-us/Typography/OpenTypeSpecification.aspx}%
 {OpenType Specification}''.
-\bibitem{PNGSPEC} ''\href{https://www.w3.org/TR/2003/REC-PNG-20031110/}%
+\bibitem{PNGSPEC} ``\href{https://www.w3.org/TR/2003/REC-PNG-20031110/}%
 {Portable Network Graphics (PNG) Specification (Second Edition)}''.
 \bibitem{CHOF} An article regarding DVI specials: Jin-Hwan Cho,
 ``\href{http://www.tug.org/TUGboat/tb30-1/tb94cho.pdf}{DVI specials for PDF generation}'',