蛇足事項、その他

PXbase vs pxbase 等

拙作の TeX 関連ソフトウェアにおいては、 「パッケージ¹」には BX～、PX～ 等の大文字から始まる名前を、 「パッケージ²」には bx～、px～ 等の小文字から始まる名前を慣習的に用いている。 アーカイブファイル名は pxbase.zip のように 「パッケージ¹名を小文字に直したもの」にしている。

Babel vs babel 等

拙作のパッケージ以外でも、 「パッケージ¹」と「パッケージ²」 で大文字と小文字の使用が異なるものがある。 例えば Babel パッケージ¹の中核のパッケージ²の名前は babel であり、また、 otf パッケージ²が含まれるパッケージ¹の通称は 「OTF パッケージ」である。

TeX vs tex 等

大文字交じりの「TeX」や「LaTeX」は「ソフトウェアの名称」であり、 小文字の「tex」や「latex」は「コマンド名」である （前者は所謂「ロゴ」で書かれることもある）。 例えば、LaTeX を起動するコマンドが latex であり、 pLaTeX を起動するコマンドが platex である。 この辺りは、基本的に「Perl と perl」、「Ruby と ruby」 の関係と同じである。

ただし、「tex」については少し注意が必要で、 正確には「TeX のコマンド名が tex」ではなく 「plain TeX のコマンド名が tex」というのが正しい。 同じように、「plain pTeX のコマンド名が ptex」であり、 また pdftex、xetex、luatex 等についても同様である。

なお、「Tex」や「TEX」等の他の組み合わせは、 （誤記でない限りは）TeX とは無関係なものを指す （参照：Wikipedia）。

ファイル抽出の「流儀」の数々

本節の例では、ファイル抽出に用いる TeX エンジンは 8 ビット欧文 TeX（tex／latex）としたが、 例えば、対象が「pLaTeX 用のパッケージ」であるなら、 pTeX（ptex／platex）を用いるのが正しいかも知れない （XeLaTeX 等の場合も同じ）。

流儀 1： dtx + drv + ins の 3 点セット

foo.dtx（DocStrip 本体）の他に、foo.drv（ドライバファイル） と foo.ins（インストーラファイル）がある場合は、 ほぼ間違いなくこの流儀に従っている。 DocStrip が用いられた最初期に用いられた方法。

• foo.sty を得るには「latex foo.ins」とする。
• foo.dvi を得るには「latex foo.drv」とする。

流儀 2： dtx + ins の 2 点セット

foo.dtx と foo.ins があるが、foo.drv はないという場合はこの流儀に従っていると思われる。 恐らく最も一般的に用いられている方法。

• foo.sty を得るには「latex foo.ins」とする。
• foo.dvi を得るには「latex foo.dtx」とする。

流儀 3： dtx のみで plain と LaTeX で処理分別

foo.dtx しかない、という場合の可能性の 1 つ。 ただし「説明されないと絶対に判らない方法」なので、 この方法を採る場合は必ずどこかに説明があるはずである。

• foo.sty を得るには「tex foo.ins」とする。 つまり、plain TeX で処理する。
• foo.dvi を得るには「latex foo.dtx」とする。 こちらは LaTeX で処理する。

恐らくファイルを 1 つだけにするために考え出された方法であるが、 欠点として、「説明されても判らない」危険性を伴うということがある。 例えば、「plain TeX で処理してね」などという説明だと 「plain TeX て何ですか？」ということになりかねないだろう。

流儀 4： dtx のみで一括処理

foo.dtx しかない、という場合のもう 1 つの可能性。 最近流行している方法である。

• 全ての処理を「latex foo.dtx」で行う。 つまり、まず foo.sty が生成され、 その後に foo.dvi の組版が行われる。

ファイルを 1 つにする方法として、 前の「流儀 3」よりもこちらの方が合理的である。 なぜなら、foo.sty の抽出と解説文書の組版の処理を分ける必然性は一見してないように思えるし、 またこの方法だと foo.dvi の組版に foo.sty 自身を利用することが可能になるからである。 しかしこの方法には次のような重大な欠点が存在する。

解説文書の LaTeX ソースで使われているパッケージ （勿論 foo.sty ではない） がインストールされていない等の理由でエラーが起こった場合の対処が非常に分かりにくい。

もし本当に解説文書を自力で組版したいのであれば、 その必要なパッケージを追加インストールしていくしかないのであるが、 実際にはその必要がない場合が多い。 CTAN ではパッケージ（アーカイブ） 中に解説文書を組版・変換した PDF 文書を含めることを要請している （Web 上での解説文書の閲覧を可能にするために必須）ので、 解説文書を自力で組版する環境を整える必要はないことが多いのである。

それでは、実際にエラーが起こったときの正しい対処方法であるが、 これは上の説明を理解していれば推測できる。 すなわち、次のようである。

エラープロンプトに対して「x」を入力する等の方法で、 LaTeX の処理を中止する。

つまり、解説文書の組版が行われるのは、本体ファイル抽出の後なので、 そこで処理を諦めて中止したとしても、 目的のファイル foo.sty の生成は正常に完了しているのである。 もし本当にファイルの生成が正常に完了したかを確かめたい場合は、 画面表示を調べて、 以下に示すような感じでファイル生成のメッセージがあることを確認すればよい。

This is pdfTeX, Version 3.1415926-1.40.11 (Web2C 2010)
 restricted \write18 enabled.
entering extended mode

……(中略)……

********************************************************
* No Configuration file found, using default settings. *
********************************************************

)

Generating file(s) ./foo.sty

Processing file foo.dtx (foo) -> foo.sty        + ← この表示がある
File xeCJK.dtx ended by \endinput.              +  ならば foo.sty
Lines  processed: 10112                         +  は正常に生成
Comments removed: 10086                         +  されている
Comments  passed: 0                             +
Codelines passed: 3                             +

(c:/usr/local/share/texmf/tex/latex/base/ltxdoc.cls
Document Class: ltxdoc 2007/11/11 v2.0u Standard LaTeX documentation class
*************************************
* Local config file ltxdoc.cfg used
*************************************

……(中略)……

! LaTeX Error: File `pxmika.sty' not found.     + ← パッケージ
                                                +  不足のため
Type X to quit or <RETURN> to proceed,          +  組版処理中に
or enter new name. (Default extension: sty)     +  エラー発生

Enter file name: x                              + ← x 入力で処理中止