summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAkira Kakuto <kakuto@fuk.kindai.ac.jp>2019-02-28 00:49:33 +0000
committerAkira Kakuto <kakuto@fuk.kindai.ac.jp>2019-02-28 00:49:33 +0000
commitb3b93295bcf40753ac524e40d897dad587360d46 (patch)
tree7a3a64e9f4c8412b534495a80490f061a6c3977d
parent5266b18aac88961d9d1e5a5ddf7d4397786c71b6 (diff)
update documents for [x]dvipdfmx
git-svn-id: svn://tug.org/texlive/trunk@50157 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/dvipdfmx/dvipdfmx.pdfbin259857 -> 261192 bytes
-rw-r--r--Master/texmf-dist/doc/dvipdfmx/dvipdfmx.tex37
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
Binary files differ
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}'',