summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/platex-tools
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-01-02 23:50:18 +0000
committerKarl Berry <karl@freefriends.org>2017-01-02 23:50:18 +0000
commita4a76e83143e53a7a889c2a18d2d4f82ae48f259 (patch)
tree7c8e9328daea3eda97f954310d1b2349026df02c /Master/texmf-dist/doc/latex/platex-tools
parentb11fa28addcddb2dbe955e36abe1c4a9ffedabae (diff)
platex-tools (28dec16)
git-svn-id: svn://tug.org/texlive/trunk@42842 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/platex-tools')
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/README.md7
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdfbin34295 -> 43162 bytes
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex48
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdfbin96915 -> 117117 bytes
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex45
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/pxeverysel.pdfbin46194 -> 47098 bytes
-rw-r--r--Master/texmf-dist/doc/latex/platex-tools/pxeverysel.tex2
7 files changed, 68 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/latex/platex-tools/README.md b/Master/texmf-dist/doc/latex/platex-tools/README.md
index c288ed09f53..8ef255ed19c 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/README.md
+++ b/Master/texmf-dist/doc/latex/platex-tools/README.md
@@ -57,7 +57,10 @@ All the document files (.tex) are encoded in UTF-8.
## Repository
The bundle is maintained on GitHub:
-https://github.com/aminophen/platex-tools
+ https://github.com/aminophen/platex-tools
+
+You can also obtain this bundle from CTAN:
+ https://www.ctan.org/pkg/platex-tools
## License
@@ -66,6 +69,6 @@ the 3-clause BSD license (see [LICENSE](./LICENSE)).
## Release Date
-2016-10-25
+2016-12-28
Hironobu Yamashita
diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf b/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf
index d4945baacee..395a6f30551 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf
+++ b/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex b/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex
index 4899a087808..2e40b3ad0c4 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex
+++ b/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex
@@ -44,22 +44,35 @@ Process the \texttt{.tex} file using \texttt{latex} +
\begin{enumerate}
\item The compatibility with \textsf{geometry} package may not be
-perfect. When \texttt{dvips} is used, the specification which
-appears \emph{first} in DVI takes effect. On the other hand,
-when \texttt{dvipdfmx} is used, the specification which appears
-\emph{at last} in DVI takes effect. For this reason,
+perfect, as both \textsf{geometry} and \textsf{bounddvi} embeds
+papersize special into a DVI file. The loading order of these
+two packages may affect the actual size of output.
+\item This package supports ``\textsf{jsclasses}-like employment''
+of \verb+\mag+, because it's more widely used in Japan. This may
+be incompatible with some classes or packages which employ
+\verb+\mag+ in other ways.
+\end{enumerate}
+The details are described in the sections below.
+
+\subsection*{The behavior of multiple papersize specials}
+
+Sometimes multiple papersize specials may be embedded into a DVI
+file. Among these specials, the specification which appears
+\emph{at last} in DVI takes effect when \texttt{dvipdfmx} or
+\texttt{dvips} (\TeX\ Live 2017 or later) is used\footnote{%
+When \texttt{dvips} in \TeX\ Live 2016 or earlier is used,
+the specification which appears \emph{first} in DVI took effect,
+but the default behavior was changed in \TeX\ Live r42420 to
+be compatible with \texttt{dvipdfmx}. The new option \texttt{-L0}
+can be used to recover the old behavior.}. For example, when the
+following source is processed with \texttt{dvipdfmx},
\begin{verbatim}
% latex + dvipdfmx
\documentclass{...}
\usepackage{bounddvi}
\usepackage[dvipdfm]{geometry}
\end{verbatim}
-can sometimes fail to set proper paper size.
-\item This package supports ``\textsf{jsclasses}-like employment''
-of \verb+\mag+, because it's more widely used in Japan. This may
-be incompatible with some classes or packages which employ
-\verb+\mag+ in other ways (see descriptions below).
-\end{enumerate}
+the specification by \textsf{geometry} wins.
\section*{Note about \texttt{\char92mag} handling}
@@ -68,8 +81,8 @@ in terms of \verb+\mag+ employment. It seems that there is no
(official or practical) ``standard'' in \verb+\mag+ treatment.
When the output is going to the physical size of A4
-($210\,\mathrm{mm} \times 297\,\mathrm{mm}$),
-there are two ways: some classes/packages can set
+($210\,\mathrm{mm} \times 297\,\mathrm{mm}$) with the setting of
+\verb+\mag=2000+, there are two ways: some classes/packages can set
\begin{quote}
\texttt{\char92mag=2000}\\
\texttt{\char92paperwidth=210mm} ($= 420\,\mathrm{truemm}$)\\
@@ -107,13 +120,14 @@ using \textsf{bounddvi} package.
\begin{itemize}
\item 2002/03/10 v1.0 (KI) First version
- \item 2002/10/30 v2.0 (KI) Add dvipdfm pdf:pagesize special
- \item 2003/03/22 v3.2 (KI) Compatibility with hyperref
+ \item 2002/10/30 v2.0 (KI) Add \texttt{dvipdfm} \texttt{pdf:pagesize} special
+ \item 2003/03/22 v3.2 (KI) Compatibility with \textsf{hyperref}
\item 2004/05/08 v4.0 (KI) Support for $\mathtt{\char92mag} \ne 1000$
- \item 2004/12/08 v5.2 (KI) Compatibility with geometry
- \item 2004/12/15 v6.0 (KI) Not to use dvipdfm(x) pdf:pagesize special
+ \item 2004/12/08 v5.2 (KI) Compatibility with \textsf{geometry}
+ \item 2004/12/15 v6.0 (KI) Not to use \texttt{dvipdfm(x)} \texttt{pdf:pagesize special}
\item 2016/10/25 v7.1 (HY) Support for p\LaTeXe\ tombow option,
- compatibility with graphics/color packages
+ compatibility with \textsf{graphics}/\textsf{color} packages
+ \item 2016/12/28 v7.2 (HY) Documentation for the new \texttt{dvips} behavior
\end{itemize}
\end{document}
diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf b/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf
index 5c7f574c519..9170bfdc12b 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf
+++ b/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex b/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex
index 63afed712d4..5b811e2b197 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex
+++ b/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex
@@ -21,11 +21,11 @@ DVIファイルは用紙サイズ情報を含みませんが、PostScriptやPDF
用紙サイズを規定するフォーマットへ変換するプログラム(\texttt{dvips}や
\texttt{dvipdfmx})は、\verb+\special+命令によってDVIファイルに埋め込ま
れた用紙サイズ情報を解釈します。
-% たとえば、幅100mm、高さ200mmの用紙に出力したい場合は
-%\begin{verbatim}
-% \special{papersize=100mm,200mm}
-%\end{verbatim}
-% のように指定してやることができます。
+たとえば、幅100mm、高さ200mmの用紙に出力したい場合は
+\begin{verbatim}
+ \special{papersize=100mm,200mm}
+\end{verbatim}
+のように指定してやることができます。
\textsf{bounddvi}パッケージは、クラスファイルなどが想定している用紙
サイズ情報(\verb+\paperwidth+, \verb+\paperheight+)をDVIファイルに
@@ -73,21 +73,24 @@ DVIファイルは用紙サイズ情報を含みませんが、PostScriptやPDF
うまくいく可能性があります(付録を参照)。
\end{itemize}
-\section*{付録:\texttt{dvips}と\texttt{dvipdfmx}の違い}
+\section*{付録:複数の用紙サイズ指定が発行された場合の挙動}
一つのDVIファイルに複数の用紙サイズ指定\verb+\special+命令が
-埋め込まれる場合があります。このうち、\texttt{dvips}ではDVIファイル
-の\emph{最初}に指定されたものが有効になります。
-逆に\texttt{dvipdfmx}では、DVIファイルの\emph{最後}に指定されたもの
-が有効になります。このため、たとえば\textsf{bounddvi}と
+埋め込まれる場合があります。このうち、\texttt{dvipdfmx}および
+\TeX\ Live 2017以降の\texttt{dvips}では、DVIファイルの\emph{最後}に
+指定されたものが有効になります\footnote{\TeX\ Live 2016以前の
+\texttt{dvips}では、DVIファイルの\emph{最初}に指定されたものが有効
+でしたが、\TeX\ Live r42420で挙動が変更されました。\texttt{-L0}オプ
+ションを指定すると従来の挙動に戻ります。}。たとえば\textsf{bounddvi}と
\textsf{geometry}を併用したソース
\begin{verbatim}
\documentclass{...}
\usepackage{bounddvi}
\usepackage[dvipdfm]{geometry}
\end{verbatim}
-を\textsf{dvipdfmx}でPDFに変換すると、用紙サイズの設定が正しくなさ
-れない可能性があります。
+を\textsf{dvipdfmx}でPDFに変換すると、\textsf{geometry}パッケージの
+指定が優先されます。このとき、用紙サイズの設定が正しいかどうかは
+\textsf{geometry}パッケージに依存します。
\section*{付録:\texttt{\char92mag}の扱いについて}
@@ -96,8 +99,8 @@ DVIファイルは用紙サイズ情報を含みませんが、PostScriptやPDF
しかし、\verb+\mag+の使い方はCTANにある多様なパッケージの中で統一
されておらず、大きく分けて二通りの使い方があるようです。
-たとえば、物理的なA4サイズ($210\,\mathrm{mm}\times297\,\mathrm{mm}$)
-の出力を得たい場合
+たとえば、版面を2倍に拡大 (\verb+\mag=2000+) して物理的なA4サイズ
+($210\,\mathrm{mm}\times297\,\mathrm{mm}$)の出力を得たい場合
\begin{quote}
\texttt{\char92mag=2000}\\
\texttt{\char92paperwidth=210mm} ($= 420\,\mathrm{truemm}$)\\
@@ -126,4 +129,18 @@ DVIファイルは用紙サイズ情報を含みませんが、PostScriptやPDF
\texttt{https://www.ma.ns.tcu.ac.jp/Pages/TeX/bounddvi.sty.html}
\end{itemize}
+\section*{変更履歴}
+
+\begin{itemize}
+ \item 2002/03/10 v1.0 (KI) 最初の公開版
+ \item 2002/10/30 v2.0 (KI) \texttt{dvipdfm}の\texttt{pdf:pagesize special}を使用
+ \item 2003/03/22 v3.2 (KI) \textsf{hyperref}との互換性を改良
+ \item 2004/05/08 v4.0 (KI) $\mathtt{\char92mag} \ne 1000$に対応
+ \item 2004/12/08 v5.2 (KI) \texttt{dvips}で\textsf{geometry}との互換性を改良
+ \item 2004/12/15 v6.0 (KI) \texttt{dvipdfm(x)}の\texttt{pdf:pagesize special}を不使用に
+ \item 2016/10/25 v7.1 (HY) p\LaTeXe{}のトンボサポート、
+ 2016年の新しい\textsf{graphics}/\textsf{color}に対応
+ \item 2016/12/28 v7.2 (HY) 新仕様の\texttt{dvips}をドキュメント化
+\end{itemize}
+
\end{document}
diff --git a/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.pdf b/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.pdf
index 5cfd02f0e5f..1497538baa6 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.pdf
+++ b/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.tex b/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.tex
index e2d766e09d7..a2f268a6bc5 100644
--- a/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.tex
+++ b/Master/texmf-dist/doc/latex/platex-tools/pxeverysel.tex
@@ -8,7 +8,7 @@
\usepackage{pxeverysel}
\GetFileInfo{pxeverysel.sty}
\title{Package \textsf{pxeverysel} \fileversion}
-\author{Takayuki Yato}
+\author{Takayuki Yato \& Hironobu Yamashita}
\date{\filedate}
\begin{document}