review 3.0.0.preview2 → 3.0.0.preview3

data/vendor/gentombow/bounddvi-en.tex

@@ -0,0 +1,135 @@
+%# -*- ascii characters only -*-
+
+% Package v1.0--v6.0: Koichi INOUE
+% Package v7.0--    : Hironobu Yamashita
+%   The package documentation (this file) was
+%   written by Hironobu Yamashita.
+
+\documentclass[a4paper]{article}
+\usepackage{doc}
+\usepackage{bounddvi}
+\GetFileInfo{bounddvi.sty}
+\title{Package \textsf{bounddvi} \fileversion}
+\author{Koichi Inoue \& Hironobu Yamashita}
+\date{\filedate}
+\begin{document}
+
+\maketitle
+
+Package \textsf{bounddvi} sets papersize special into DVI file.
+This package can be used in both tate (vertical) and yoko (horizontal)
+writing directions of Japanese p\LaTeX/up\LaTeX, and both
+\texttt{dvipdfmx} and \texttt{dvips} drivers are supported.
+The \texttt{tombow} option defined in Japanese p\LaTeX\ kernel is
+also supported. Of course, this package can be used also with the
+original \LaTeX\ in DVI output mode.
+
+This package (since v7.0) is part of \textsf{gentombow} bundle:
+\begin{verbatim}
+  https://github.com/aminophen/gentombow
+\end{verbatim}
+Originally it was part of \textsf{platex-tools} bundle,
+but it has been moved since March 2018.
+
+\section*{Usage}
+
+Load this package in preamble.
+\begin{verbatim}
+  \documentclass[a5paper]{article}
+  \usepackage{bounddvi}
+  ...
+\end{verbatim}
+Process the \texttt{.tex} file using \texttt{latex} +
+\texttt{dvips} chain or \texttt{latex} + \texttt{dvipdfmx} chain.
+
+\section*{Known limitations}
+
+\begin{enumerate}
+\item The compatibility with \textsf{geometry} package may not be
+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}
+the specification by \textsf{geometry} wins.
+
+\section*{Note about \texttt{\char92mag} handling}
+
+Among the packages in CTAN, there are two types of implementation
+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}$) 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}$)\\
+  \texttt{\char92paperheight=297mm} ($= 594\,\mathrm{truemm}$)
+\end{quote}
+and others can set
+\begin{quote}
+  \texttt{\char92mag=2000}\\
+  \texttt{\char92paperwidth=105mm} ($= 210\,\mathrm{truemm}$)\\
+  \texttt{\char92paperheight=148.5mm} ($= 297\,\mathrm{truemm}$)
+\end{quote}
+The first way is adopted by \textsf{geometry} package etc, and it's
+(probably) based on the behavior of the \verb+papersize+ special of
+\texttt{dvips}. It does not handle true units properly, and accepts
+only non-true units and evaluates them as if they were true units.
+The second way is adopted by \textsf{jsclasses} document class etc,
+and is also suppoted by \verb+pdf:pagesize+ special of
+\texttt{dvipdfm(x)}. This can be more consistent with \LaTeX, since
+all other layout parameters (e.g. \verb+\textwidth+) are set
+according to the unit truemm.
+
+The \textsf{bounddvi} supports the latter, so some classes/packages
+which are based on the former may or may not work properly when
+using \textsf{bounddvi} package.
+
+\section*{References}
+
+\begin{itemize}
+\item Setting paper size using \texttt{dvips} \& \texttt{dvipdfm}
+  (description in Japanese)\\
+  \texttt{https://www.ma.ns.tcu.ac.jp/Pages/TeX/bounddvi.sty.html}
+\end{itemize}
+
+\section*{ChangeLog}
+
+\begin{itemize}
+  \item 2002/03/10 v1.0 (KI) First version
+  \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 \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 \textsf{graphics}/\textsf{color} packages
+  \item 2016/12/28 v7.2 (HY) Documentation for the new \texttt{dvips} behavior
+\end{itemize}
+
+\end{document}

data/vendor/gentombow/bounddvi.sty

@@ -0,0 +1,87 @@
+%
+% bounddvi.sty
+% 2016/12/28 v7.2-v7.0 h.y.acetaminophen@gmail.com
+% 2004/12/15 v6.0-v1.0 inoue@ma.ns.tcu.ac.jp
+%
+% This package, originally written by Koichi Inoue
+% and modified by Hironobu Yamashita, is distributed
+% as part of the gentombow bundle.
+% https://github.com/aminophen/gentombow
+%
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{bounddvi}[2016/12/28 v7.2 bounddvi]
+
+% catcode trick to hide \iftombow ... \else ... \fi
+% since \iftombow is defined only in pLaTeX.
+\ifx\pfmtname\@undefined
+  \catcode`\Q=14\relax
+\else
+  \catcode`\Q=9\relax
+\fi
+
+% Note: graphics/color drivers
+%  - dvips.def 2016/07/10 v3.1a or later
+%  - dvipdfmx.def 2016/07/10 v4.12 or later
+% emit papersize special _only_ when \Gin@setpagesizetrue
+% and \mag = 1000. When graphicx(s) or color is used with
+% setpagesize option (= default since 2016) and \mag equals
+% to 1000, we can exploit its routine.
+% (they are using \AtBeginDocument{\AtBeginDvi{...}})
+% However, these .def files do _not_ care about tombow by pLaTeX;
+% so, we set \stock{width,height} to invoke stock test in those
+% files (probably meant for memoir.cls).
+Q \iftombow
+Q   % if \stockwidth/\stockheight are not available,
+Q   % define them now
+Q   \ifx\stockwidth\@undefined \newdimen\stockwidth \fi
+Q   \ifx\stockheight\@undefined \newdimen\stockheight \fi
+Q   % if \stockwidth already has effective value, do nothing;
+Q   % otherwise assume pLaTeX-style tombow and set it to
+Q   % \paperwidth + 2in (similar for \stockheight)
+Q   \ifdim\stockwidth>\z@\else
+Q     \stockwidth\paperwidth \advance\stockwidth2in
+Q   \fi
+Q   \ifdim\stockheight>\z@\else
+Q     \stockheight\paperheight \advance\stockheight2in
+Q   \fi
+Q \fi
+
+% reset catcode trick
+\catcode`\Q=11\relax
+
+% following code is almost equivalent to
+%   \AtBeginDocument{\AtBeginDvi{...}}
+% however, we append the specification to the _beginning_ of
+% \@begindocumenthook; this ensures proper papersize when
+% dvips (TeX Live 2016 or earlier) is used.
+\begingroup
+\def\@prependto@begindocumenthook{\global\setbox\@begindvibox
+  \vbox{\csname yoko\endcsname\unvbox\@begindvibox
+    \begingroup
+      % if \stockwidth/\stockheight are defined & have effective
+      % values, copy them to \paperwidth/\paperheight
+      % for current group
+      \ifx\stockwidth\@undefined\else \ifdim\stockwidth>\z@
+        \paperwidth\stockwidth
+      \fi\fi
+      \ifx\stockheight\@undefined\else \ifdim\stockheight>\z@
+        \paperheight\stockheight
+      \fi\fi
+      % adjust for \mag and emit papersize special
+      \divide\paperwidth\@m\multiply\paperwidth\mag
+      \divide\paperheight\@m\multiply\paperheight\mag
+      \special{papersize=\the\paperwidth,\the\paperheight}%
+    \endgroup}}
+\toks@\expandafter\expandafter\expandafter
+  {\expandafter\@prependto@begindocumenthook\@begindocumenthook}
+\xdef\@begindocumenthook{\the\toks@}
+% append papersize special again to the _end_ of the
+% current \@begindocumenthook; this will be meaningful e.g. when
+% geometry is loaded before bounddvi.
+% (geometry adds \AtBeginDocument{\AtBeginDvi{...}} specification)
+\expandafter\g@addto@macro\expandafter\@begindocumenthook
+  \expandafter{\@prependto@begindocumenthook}
+\endgroup
+
+\endinput

data/vendor/gentombow/bounddvi.tex

@@ -0,0 +1,148 @@
+%# -*- coding: utf-8 -*-
+\ifx\epTeXinputencoding\undefined\else % defined in e-pTeX (> TL2016)
+  \epTeXinputencoding utf8    % ensure utf-8 encoding for platex
+\fi
+
+% パッケージ作者 (v1.0--v6.0)：東京都市大学（旧称・武蔵工業大学）井上浩一
+% 修正版 (v7.0--) および本ドキュメント：山下弘展 (Hironobu Yamashita)
+
+\documentclass[a4paper]{jsarticle}
+\usepackage{doc}
+\usepackage{bounddvi}
+\GetFileInfo{bounddvi.sty}
+\title{Package \textsf{bounddvi} \fileversion}
+\author{Koichi Inoue \& Hironobu Yamashita}
+\date{\filedate}
+\begin{document}
+
+\maketitle
+
+DVIファイルは用紙サイズ情報を含みませんが、PostScriptやPDFといった
+用紙サイズを規定するフォーマットへ変換するプログラム（\texttt{dvips}や
+\texttt{dvipdfmx}）は、\verb+\special+命令によってDVIファイルに埋め込ま
+れた用紙サイズ情報を解釈します。
+たとえば、幅100mm、高さ200mmの用紙に出力したい場合は
+\begin{verbatim}
+  \special{papersize=100mm,200mm}
+\end{verbatim}
+のように指定してやることができます。
+
+\textsf{bounddvi}パッケージは、クラスファイルなどが想定している用紙
+サイズ情報（\verb+\paperwidth+, \verb+\paperheight+）をDVIファイルに
+\verb+\special+命令として埋め込むことで、\texttt{dvips}や
+\texttt{dvipdfmx}の出力用紙サイズを指定する機能を提供します。
+\begin{verbatim}
+  \documentclass[a4j]{jarticle}
+  \usepackage{bounddvi}
+  \begin{document}
+  …本文…
+  \end{document}
+\end{verbatim}
+のように使います。p\LaTeX における横組と縦組の両方で使え、また
+版面拡大(\verb+\mag+)が使われた場合にも対応しています（詳細は付録
+を参照してください）。また、v7.0以降、p\LaTeX カーネルのトンボ
+オプションを使用した場合にも対応しており、p\LaTeX が仮定している
+「トンボのノビ(2in)を含めたサイズ」に設定します。
+
+本パッケージはv7.0以降、\textsf{gentombow}バンドルの一部として
+配布されています：
+\begin{verbatim}
+  https://github.com/aminophen/gentombow
+\end{verbatim}
+2017年までは\textsf{platex-tools}バンドルの一部でしたが、
+2018年以降は移転しました。
+
+\section*{他のパッケージとの互換性}
+
+用紙サイズ設定機能だけを提供する\textsf{bounddvi}パッケージのほかにも、
+パッケージの機能の一部として用紙サイズ設定を行うものがいくつかあります。
+\begin{itemize}
+\item 日本語環境でよく用いられる、p\LaTeX/up\LaTeX 用のクラスファイル
+      \textsf{jsclasses}（奥村さん作）の\texttt{papersize}オプション
+      との併用は問題ありません（ただし、このオプションを使用すれば用紙
+      サイズ設定には十分ですから、本\textsf{bounddvi}パッケージを併用
+      することにも特にメリットはありません）。
+\item 2016年以降の\textsf{graphics/graphicx}パッケージや
+      \textsf{color}パッケージには用紙サイズ設定機能
+      （\texttt{setpagesize}オプション：デフォルトで有効）が
+      ありますが、併用しても問題は起きないでしょう。
+\item \textsf{hyperref}パッケージも上と同様で、併用しても
+      問題は起きないでしょう。
+\item \textsf{geometry}パッケージと併用する場合は、
+      本\textsf{bounddvi}パッケージを\emph{後から}読み込むほうが
+      安全でしょう。特に、\texttt{dvipdfmx}を使用して変換する場合に
+      トンボを付けたいなら、\textsf{bounddvi}を後から読み込むことで
+      うまくいく可能性があります（付録を参照）。
+\end{itemize}
+
+\section*{付録：複数の用紙サイズ指定が発行された場合の挙動}
+
+一つのDVIファイルに複数の用紙サイズ指定\verb+\special+命令が
+埋め込まれる場合があります。このうち、\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{geometry}パッケージの
+指定が優先されます。このとき、用紙サイズの設定が正しいかどうかは
+\textsf{geometry}パッケージに依存します。
+
+\section*{付録：\texttt{\char92mag}の扱いについて}
+
+本\textsf{bounddvi}パッケージは、日本で広く使われている奥村さんの
+\textsf{jsclasses}クラス流の\verb+\mag+の用法をサポートしています。
+しかし、\verb+\mag+の使い方はCTANにある多様なパッケージの中で統一
+されておらず、大きく分けて二通りの使い方があるようです。
+
+たとえば、版面を2倍に拡大 (\verb+\mag=2000+) して物理的なA4サイズ
+($210\,\mathrm{mm}\times297\,\mathrm{mm}$)の出力を得たい場合
+\begin{quote}
+  \texttt{\char92mag=2000}\\
+  \texttt{\char92paperwidth=210mm} ($= 420\,\mathrm{truemm}$)\\
+  \texttt{\char92paperheight=297mm} ($= 594\,\mathrm{truemm}$)
+\end{quote}
+と設定するものと
+\begin{quote}
+  \texttt{\char92mag=2000}\\
+  \texttt{\char92paperwidth=105mm} ($= 210\,\mathrm{truemm}$)\\
+  \texttt{\char92paperheight=148.5mm} ($= 297\,\mathrm{truemm}$)
+\end{quote}
+と設定するものとが存在します。
+前者は\textsf{geometry}パッケージなどの方式で、おそらく\texttt{dvips}の
+\verb+papersize+ specialの挙動（truedimenを正しく解釈せず、trueの付か
+ない単位だけを受け付けてあたかもtrue付であるかのように評価）に則った
+ものでしょう。後者は\textsf{jsclasses}クラスの方式で、これは
+\texttt{dvipdfm(x)}の\verb+pdf:pagesize+ specialとも同じです。
+この方式のほうが、truedimenで設定された\LaTeX のほかのレイアウト変数
+（\verb+\textwidth+など）に対して一貫性があると思われます。
+本\textsf{bounddvi}パッケージがサポートしているのは後者の方式です。
+
+\section*{参考}
+
+\begin{itemize}
+\item dvipsやdvipdfmなどで用紙サイズを出力\\
+  \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}

data/vendor/gentombow/create_archive.sh

@@ -0,0 +1,24 @@
+#!/bin/sh
+
+PROJECT=gentombow
+TMP=/tmp
+PWDF=`pwd`
+LATESTRELEASEDATE=`git tag | sort -r | head -n 1`
+RELEASEDATE=`git tag --points-at HEAD | sort -r | head -n 1`
+
+if [ -z "$RELEASEDATE" ]; then
+    RELEASEDATE="**not tagged**; later than $LATESTRELEASEDATE?"
+fi
+
+echo " * Create $PROJECT.zip ($RELEASEDATE)"
+git archive --format=tar --prefix=$PROJECT/ HEAD | (cd $TMP && tar xf -)
+rm $TMP/$PROJECT/.gitignore
+rm $TMP/$PROJECT/create_archive.sh
+rm -rf $TMP/$PROJECT/tests
+perl -pi.bak -e "s/\\\$RELEASEDATE/$RELEASEDATE/g" $TMP/$PROJECT/README.md
+rm -f $TMP/$PROJECT/README.md.bak
+
+cd $TMP && zip -r $PWDF/$PROJECT.zip $PROJECT
+rm -rf $TMP/$PROJECT
+echo
+echo " * Done: $PROJECT.zip ($RELEASEDATE)"

data/vendor/gentombow/gentombow-ja.tex

@@ -0,0 +1,449 @@
+%# -*- coding: utf-8 -*-
+\ifx\epTeXinputencoding\undefined\else % defined in e-pTeX (> TL2016)
+  \epTeXinputencoding utf8    % ensure utf-8 encoding for platex
+\fi
+
+\documentclass[a4paper,dvipdfmx]{jsarticle}
+\usepackage{doc}
+\makeatletter
+%%% import from jltxdoc.cls
+\def\verb{\relax\ifmmode\hbox\else\leavevmode\vadjust{}\fi
+  \bgroup \let\do\do@noligs \verbatim@nolig@list
+    \ttfamily \verb@eol@error \let\do\@makeother \dospecials
+    \@ifstar{\@sverb}{\@vobeyspaces \frenchspacing \@sverb}}
+\xspcode"5C=3 %% \
+\xspcode"22=3 %% "
+%%% dangerous bend
+\font\man=manfnt at 10pt
+\def\dbend{\leavevmode\raise0pt\hbox{\man\char'177}}
+\newenvironment{dangerous}{%
+  \ifnum\@listdepth>\z@
+    \GenericError{}{Do not use `dangerous' environment inside any list}{}{}
+  \fi
+  \par\addvspace\medskipamount
+  \@tempdima=\dimexpr\textwidth-2zw\relax\small
+  \divide\@tempdima by\dimexpr1zw\relax\@tempcnta=\@tempdima
+  \leftskip=\dimexpr\textwidth-\@tempcnta zw\relax
+    \@totalleftmargin\dimexpr\leftskip+0zw
+    \linewidth=\dimexpr\@tempcnta zw-0zw
+  \parindent1zw\noindent\kern-\leftskip\hbox to\leftskip{\dbend\hss}%
+  \everypar{\everypar{}}\ignorespaces
+}{\par\addvspace\medskipamount}
+%%% logo
+\def\pTeX{p\kern-.15em\TeX}
+\def\epTeX{$\varepsilon$-\pTeX}
+%%% misc
+\newcommand{\Meta}[1]{$\langle$\mbox{}\textit{#1}\mbox{}$\rangle$}
+\newcommand{\jMeta}[1]{$\langle$\mbox{}\textsf{#1}\mbox{}$\rangle$}
+%%%
+\makeatother
+\usepackage{longtable}
+\usepackage[pdfbox]{gentombow}
+%\usepackage{bounddvi}
+\GetFileInfo{gentombow.sty}
+\title{Package \textsf{gentombow} \fileversion}
+\author{Hironobu Yamashita}
+\date{\filedate}
+\begin{document}
+
+\maketitle
+
+\begin{center}
+English version is available: see \textsf{gentombow.pdf}!
+\end{center}
+
+日本の出版では、たとえば仕上がり寸法がA4サイズの場合、一回り大きな
+B4サイズの用紙の中央にトンボ付きで印刷することがあるようです。
+このドキュメントは、実際にA4用紙をB4用紙の中央にトンボ付きで
+配置している事例です。
+
+\textsf{gentombow}パッケージは、クラスファイルなどが想定している用紙
+サイズ情報（\verb+\paperwidth+, \verb+\paperheight+）を検知し、
+それより一回り大きなサイズの用紙の中央にトンボ付きで出力するために
+必要な機能を提供します。使い方の例は
+\begin{verbatim}
+  \documentclass[a4j]{jarticle}
+  \usepackage{gentombow}
+  \usepackage{bounddvi}
+  \begin{document}
+  …本文…
+  \end{document}
+\end{verbatim}
+です。
+
+任意の\LaTeX フォーマットで利用可能です。具体的には
+\begin{itemize}
+\item p\LaTeX, up\LaTeX （縦組にも対応）
+\item Lua\LaTeX （Lua\TeX-ja使用の場合は縦組にも対応）
+\item pdf\LaTeX
+\item Xe\LaTeX
+\end{itemize}
+での動作を確認しています。また、\textsf{jsclasses}のような
+版面拡大(\verb+\mag+)が使われた場合にも対応しています。
+
+ただし、本パッケージは実際の出力サイズ指定を発行しませんので、
+以下のいずれかのパッケージと併用するとよいでしょう：
+\begin{itemize}
+\item \textsf{bounddvi}パッケージ（\textsf{gentombow}バンドル）
+\item \textsf{bxpapersize}パッケージ（ZRさん作）
+\item \textsf{graphicx}パッケージの2016年以降の版
+  （\texttt{setpagesize}機能つきのもの）
+\end{itemize}
+\textsf{bounddvi}パッケージは本パッケージと同じく
+\textsf{gentombow}バンドルに収録されていますが、
+名前のとおりDVIを経由する場合にしか利用できません。
+一方、\textsf{bxpapersize}パッケージは汎用で、Lua\TeX のような
+PDF直接出力の場合にも利用できます。また、\textsf{graphicx}パッケージ
+は画像挿入用のパッケージですが、2016年以降は自動的に出力サイズ指定も
+行うようです（$\verb+\mag+ \ne 1000$の場合には機能しません）。
+
+本パッケージは、\textsf{gentombow}バンドルの一部として
+配布されています：
+\begin{verbatim}
+  https://github.com/aminophen/gentombow
+\end{verbatim}
+2017年までは\textsf{platex-tools}バンドルの一部でしたが、
+2018年以降は独立させてあります。また、v0.9eまでは
+(u)p\LaTeX とLua\TeX-ja専用の\textsf{pxgentombow}パッケージを
+用意していましたが、v0.9f以降は\textsf{gentombow}に一本化しました。
+
+\section{簡単な使用法}
+
+はじめに、パッケージをオプション指定なしに使用する場合の機能を
+説明します。
+
+\subsection{用紙サイズの自動検知による出力サイズ決定}
+
+パッケージにはあらかじめA系列(\texttt{a0}--\texttt{a10})、
+B系列(\texttt{b0}--\texttt{b10})、C系列(\texttt{c0}--\texttt{c10})と
+\texttt{letter}, \texttt{legal}, \texttt{executive}の用紙サイズが
+定義されています。ここで、B系列はISOではなくJISです。
+また、変型版として\texttt{a4var}（\texttt{a4}の変型）と
+\texttt{b5var}（\texttt{b5}の変型）も定義されています。
+
+これらのうちいずれか（ただし\texttt{a0}, \texttt{b0}, \texttt{c0}を
+除く）の用紙サイズを検知すると、
+出力サイズが次の規則で自動的に決定されます\footnote{なお、
+C系列と\texttt{letter}, \texttt{legal}, \texttt{executive}については
+日本での慣習が不明の
+ため、現時点ではA系列のサイズで出力することにしています。}。
+\begin{itemize}
+\item 用紙サイズがA系列のとき：
+        出力サイズは一回り大きなB系列
+\item 用紙サイズがB, C系列または
+      \texttt{letter}, \texttt{legal}, \texttt{executive}のとき：
+        出力サイズは一回り大きなA系列
+\end{itemize}
+この場合、パッケージを読み込んだだけでトンボが付きます。
+なお、用紙サイズが横長の場合は自動的に出力も横長になり、
+縦長の場合は自動的に縦長になります。
+
+よく使われる用紙サイズの例を挙げます。
+\begin{longtable}[c]{cc}
+  \hline
+  用紙サイズ & 出力サイズ \\
+  \hline
+  a6 & b6 \\
+  b6 & a5 \\
+  a5 & b5 \\
+  b5 & a4 \\
+  a4 & b4 \\
+  b4 & a3 \\
+  a3 & b3 \\
+  b3 & a2 \\
+  \hline
+  c6 & a5 \\
+  c5 & a4 \\
+  c4 & a3 \\
+  c3 & a2 \\
+  \hline
+  letter    & a3 \\
+  legal     & a3 \\
+  executive & a4 \\
+  \hline
+\end{longtable}
+
+\subsection*{参考：用紙サイズの自動検知に失敗した場合の出力サイズ決定}
+
+仮に用紙サイズが定義済みのいずれとも異なる場合は、デフォルトでは
+用紙の天地左右に1インチずつのノビを付けたサイズで出力します。
+たとえば、幅$100\,\mathrm{mm}$、高さ$200\,\mathrm{mm}$の用紙の場合、
+出力サイズは幅$100\,\mathrm{mm}+2\,\mathrm{in}$、
+高さ$200\,\mathrm{mm}+2\,\mathrm{in}$になります。
+
+\subsection{トンボへのバナーの出力}
+
+デフォルトでは\makeatletter\texttt{\the\@bannertoken}\makeatother
+のような形式で、トンボにジョブ情報（処理ファイル名と日付）を示すバナーが
+出力されます。これは、\pLaTeX 向けの日本語クラスファイルの多くで
+利用可能な\verb+tombow+オプションと同様です。
+ただし、クラスオプションに\verb+tombo+（ジョブ情報を出力しない）または
+\verb+mentuke+（トンボの線を表示しない）が指定されている場合は、
+この設定が引き継がれます。
+
+\section{パッケージオプション}
+
+パッケージオプションによって、出力サイズやバナーのジョブ情報の有無を
+指定する方法を説明します。
+
+\subsection{出力サイズの明示指定}
+
+自動決定されるサイズと異なるサイズに出力したい場合、
+パッケージオプションで明示的に指定することができます。たとえば
+\begin{verbatim}
+  \documentclass[a4j]{jarticle}
+  \usepackage[tombow-a3]{gentombow}
+  \begin{document}
+  …本文…
+  \end{document}
+\end{verbatim}
+とすると、出力サイズは（自動決定のb4は無視されて）a3に変わります。
+指定可能なサイズは、定義済みの用紙サイズと同じものです。すなわち、
+A系列(\texttt{a0}--\texttt{a10})、
+B系列(\texttt{b0}--\texttt{b10})、
+C系列(\texttt{c0}--\texttt{c10})と
+\texttt{a4var}, \texttt{b5var},
+\texttt{letter}, \texttt{legal}, \texttt{executive}です。
+なお、ここでも用紙サイズが横長の場合は自動的に出力も横長になり、
+縦長の場合は自動的に縦長になります。
+
+オプションは\jMeta{トンボ形式}\texttt{-}\jMeta{出力サイズ}の書式で与えます。
+トンボ形式は、p\LaTeX の標準クラスと同じで
+\verb+tombow+, \verb+tombo+, \verb+mentuke+のいずれかを選びます
+（\verb+tombow+はジョブ情報を表示し、\verb+tombo+は表示しません。
+また、\verb+mentuke+はトンボの線を表示しません）。
+
+\subsection{トンボに表示するジョブ情報の有無}
+
+用紙サイズを明示的に指定する場合は、前節のようにトンボ形式と出力サイズを
+同時にオプションで与えることができます。
+逆に出力サイズを自動決定に任せつつ、ジョブ情報の有無だけを指定したい
+場合は、トンボへのバナー出力を抑制する\verb+notombowbanner+オプションを
+使用してください。
+
+\section{詳細なカスタマイズ}
+
+\textsf{gentombow}パッケージは、トンボの見た目やバナーの内容を
+カスタマイズする機能も提供します。
+
+\subsection{トンボに表示するバナーの内容}
+
+\verb+\settombowbanner+命令を用います。例えば\epTeX の
+\verb+\pdfcreationdate+プリミティブを使って
+\begin{verbatim}
+  \documentclass[a4j]{jarticle}
+  \usepackage{gentombow}
+  \settombowbanner{\jobname\space (\pdfcreationdate)}
+  \begin{document}
+  …本文…
+  \end{document}
+\end{verbatim}
+とすると、バナーの表示内容は
+{\settombowbanner{\jobname\space (\pdfcreationdate)}%
+ \makeatletter\texttt{\the\@bannertoken}\makeatother}になります。
+命令の引数には任意のトークン列を与えることができます。
+
+\subsection{バナーの文字のフォント}
+
+\verb+\settombowbannerfont+命令を用います。例えば
+\begin{verbatim}
+  \settombowbannerfont{cmss10 at 9pt}
+\end{verbatim}
+のような指定が可能です。内部的には\verb+\font+プリミティブを利用しており、
+使用している\TeX エンジンがサポートする任意のフォントを指定可能です
+\footnote{Lua\TeX やXe\TeX （\textsf{gentombow}パッケージの場合）では、
+OpenTypeフォントを直接利用することもできます。}。
+
+\subsection{トンボの線の太さ}
+
+デフォルトではトンボの線の太さは0.1~ptですが、
+\verb+\settombowwidth{1pt}+とすると1~ptになります。
+命令の引数には任意の寸法を与えることができますが、
+実用上は数pt以内が良いでしょう。
+
+\subsection{塗り足し（ドブ）の幅}
+
+デフォルトでは塗り足し（ドブ）の幅は3~mmですが、
+\verb+\settombowbleed{5mm}+とすると5~mmになります。
+命令の引数には任意の寸法を与えることができますが、実用上は数mmでしょう。
+
+\subsection{トンボの色}
+
+トンボの色を指定します。実際に色をつける場合は
+\textsf{xcolor}パッケージ（推奨）またはまたは\textsf{color}パッケージが必要です。
+\verb+\settombowcolor{\color[cmyk]{0,1,0,0}}+とするとマゼンタになります。
+CMYKの版ごとにトンボを作成する場合や、特色のトンボが必要な場合に便利です。
+
+\section{PDFのデジタルトンボ(page box)の設定}
+
+この機能はドライバに依存するため、オプション機能としています。
+\textsf{gentombow}パッケージ読み込み時に\verb+pdfbox+オプションを
+指定します。DVIを経由する場合は、さらにドライバオプションも必須です
+\footnote{例外として、\textsf{gentombow}が読み込まれた時点で
+\textsf{graphics}/\textsf{color}のいずれかが読み込まれていた
+場合は、そのドライバ設定を引き継ぐことができます。}。
+
+この機能を有効化すると、PDFに以下のバウンディングボックス情報
+（いわゆるデジタルトンボ）が書き込まれ、
+さらに用紙サイズ設定（\verb+/MediaBox+相当）も行われます。
+\begin{itemize}
+\item \verb+/TrimBox+: 仕上がり紙面サイズ。
+\item \verb+/BleedBox+: 裁ち落とし領域を含んだサイズ。
+\item \verb+/CropBox+, \verb+/ArtBox+: 明示しない。
+\end{itemize}
+
+\section{その他の注意点}
+
+特定のクラスファイルやパッケージと一緒に使用する場合、
+いくつかの注意点があります。
+
+\subsection{\textsf{jsclasses}で使用する場合の注意}
+
+奥村晴彦氏による\textsf{jsclasses}のクラス（2016年以降は日本語\TeX 開発
+コミュニティが管理）を使用していて、10pt以外のサイズオプションを
+指定する場合は、以下のいずれかの方法をとってください。
+\begin{itemize}
+\item クラスオプションに「トンボオプション」
+      （\verb+tombow+または\verb+tombo+）を追加する。
+\item クラスオプションに「\verb+\mag+を使わないオプション」
+      （\verb+nomag+または\verb+nomag*+）を追加する。
+\end{itemize}
+これは、\textsf{jsclasses}クラス内で行われる\verb+\oddsidemargin+と
+\verb+\topmargin+の計算の都合からくる制約です。たとえば
+\begin{verbatim}
+  \documentclass[a4j,14pt]{jsarticle}
+  \usepackage{gentombow}
+\end{verbatim}
+という使い方は\emph{誤り}です（このままでは誤った余白設定が
+適用されますので、安全のため\textsf{gentombow}パッケージ
+がエラーを出すようにしてあります）。代わりに
+\begin{verbatim}
+  \documentclass[a4j,14pt,tombow]{jsarticle}
+  \usepackage{gentombow}
+\end{verbatim}
+と書くようにしてください。
+
+また、塗り足しの幅などの寸法指定は\verb+true+付きの単位を
+使用してください。例えば
+\verb+\settombowbleed{3truemm}+と指定すれば、
+\verb+\mag+による版面拡大（縮小）後の塗り足し幅を3~mmにできます。
+
+同様に、ZR氏による\textsf{BXjscls}のクラスを使用していて、10pt以外の
+サイズオプションを指定する場合は
+\begin{itemize}
+\item クラスオプションに「\verb+\mag+を使わないオプション」
+      （\verb+nomag+または\verb+nomag*+）を追加する。
+\end{itemize}
+という対処が必要です（\textsf{BXjscls}クラスでは「トンボオプション」が
+機能しないダミーになっていることに注意）。
+
+\subsection{レイアウト設定の注意}
+
+余白などのレイアウト設定でありがちですが、
+\verb+\hoffset+や\verb+\voffset+の値を$0$以外に設定するのは
+避けてください。このような設定は\textsf{gentombow}パッケージの
+トンボ出力機能と衝突するため、正しい出力が得られません。
+レイアウト設定のために変更すべきなのはこれらの寸法ではなく、
+\verb+\oddsidemargin+や\verb+\topmargin+であることがほとんどです。
+したがって、それらを適切な値に設定するか、レイアウトの設定すべてを
+\textsf{geometry}パッケージに任せてしまうのも一つの方法です。
+
+\begin{dangerous}
+たとえば左右の余白を$25\,\mathrm{mm}$に、上下の余白を
+$30\,\mathrm{mm}$にしたいとき\footnote{ここでは「本文の領域以外」を
+余白と定義します。すなわち、ヘッダとフッタは余白の一部です。}、
+まず「\TeX の1インチ」を
+削除してから\verb+\oddsidemargin+や\verb+\topmargin+を変更すると、
+「見かけ上は」期待どおりの結果になることがあります。
+\begin{verbatim}
+  \setlength{\hoffset}{-1in}% <== NG
+  \setlength{\voffset}{-1in}% <== NG
+  \setlength{\oddsidemargin}{25mm}
+  \setlength{\topmargin}{30mm}
+  \setlength{\textwidth}{\paperwidth}
+  \addtolength{\textwidth}{-2\oddsidemargin}
+  \setlength{\textheight}{\paperheight}
+  \addtolength{\textheight}{-2\topmargin}
+  \addtolength{\topmargin}{-\headheight}
+  \addtolength{\topmargin}{-\headsep}
+\end{verbatim}
+しかし、この設定では\textsf{gentombow}パッケージがトンボを
+追加するとき、正しい余白を維持することができません。
+
+一方、\verb+\hoffset+や\verb+\voffset+は$0$のままで、以下のように
+\verb+\oddsidemargin+や\verb+\topmargin+を設定していれば問題ありません。
+\begin{verbatim}
+  \setlength{\oddsidemargin}{-0.4mm}% 25mm = 1inch - 0.4mm
+  \setlength{\topmargin}{4.6mm}%      30mm = 1inch + 4.6mm
+  \setlength{\textwidth}{\paperwidth}
+  \addtolength{\textwidth}{-50mm}
+  \addtolength{\topmargin}{-\headheight}
+  \addtolength{\topmargin}{-\headsep}
+  \setlength{\textheight}{\paperheight}
+  \addtolength{\textheight}{-60mm}
+\end{verbatim}
+これと同等のレイアウト設定は、以下のように\textsf{geometry}パッケージで
+行うのが簡単です。
+\begin{verbatim}
+  \usepackage[lmargin=25mm,rmargin=25mm,
+              tmargin=30mm,bmargin=30mm]{geometry}
+\end{verbatim}
+\end{dangerous}
+
+\section*{雑記}
+
+発端はこの話です。
+\begin{itemize}
+\item 齋藤修三郎 (@psi\_tau) on Twitter, 2017年2月9日\\
+  \texttt{https://twitter.com/psi\_tau/status/829873082911248386}
+\end{itemize}
+
+また、現在検討中の事項を挙げておきます。
+\begin{itemize}
+\item 現状では、用紙の横長・縦長がそのまま出力に反映されるので、
+  これを逆転させるオプションの実装。また、任意の出力サイズを
+  指定できるインタフェースの実現。
+\item 自動で決定できる出力サイズの拡張。現状では用紙サイズが
+  定義値に完全一致する場合のみ自動決定されるが、中間のサイズでも
+  その一回り大きなサイズに出力したい場合があるのではないか。
+\item 出版用途ではカラー印刷の場合に、CMYKの版ごとにトンボを作る
+  必要がある。\textsf{color}パッケージが利用可能な場合に、
+  オプション次第でCKなど必要な色を選べるようにするとよい
+  のではないか\footnote{ただし作者の本業は出版ではないので、
+  商用を含む実用には程遠いかもしれない。}。
+\item $\verb+\mag+ \ne 1000$の場合について、\textsf{jsclasses}以外での
+  動作は未確認。特に、\textsf{geometry}とは共存しない可能性が高い。
+\item \verb+\stockwidth+/\verb+\stockheight+が
+  \verb+\paperwidth+/\verb+\paperheight+より小さい場合の動作。
+  現在は警告を出すだけとしているが、さらに天地左右1inに
+  フォールバックしたほうが無難だろうか。
+\end{itemize}
+
+\section*{変更履歴}
+
+\begin{itemize}
+  \item 2017/02/10 v0.1 最初の公開版（\textsf{pxgentombow}として）
+  \item 2017/03/01 v0.4 トンボ形式の修正など
+  \item 2017/05/05 v0.5 \textsf{jsclasses}の$\verb+\mag+ \ne 1000$に対応、
+                        最初のCTANリリース版
+  \item 2017/05/06 v0.6 \textsf{jsclasses}との共存時のチェック強化、
+                        Lua\TeX-jaでの動作確認
+  \item 2017/07/23 v0.7 ドキュメント更新
+  \item 2017/12/17 v0.9 \textsf{gentombow}パッケージの新設
+  \item 2018/03/16 v0.9e クラスオプションの\verb+tombow+等の引き継ぎ、
+                        トンボ書式のカスタマイズ機能の追加
+                        （\verb+\settombowbanner+,
+                          \verb+\settombowbannerfont+,
+                          \verb+\settombowwidth+の各命令）
+  \item 2018/05/17 v0.9g \textsf{gentombow}に\textsf{pxgentombow}を統合、
+                         \verb+pdfbox+オプションの追加、
+                         \verb+\settombowbleed+, \verb+\settombowcolor+の追加
+  \item 2018/08/20 v0.9h 用紙サイズ検出に\texttt{hagaki}を追加、
+                         \textsf{pdfpages}対策の改良
+  \item 2018/08/30 v0.9j \textsf{jsclasses}の$\verb+\mag+ \ne 1000$でも
+                         \verb+pdfbox+オプションが正常動作するように改良、
+                         \verb+\settombowbleed+が\verb+/TrimBox+に反映されな
+                         かったバグの修正
+\end{itemize}
+
+\end{document}