##
1 外部ツール

Python ドキュメントがサポートしている全ての出力形式を処理できるように するには、数多くのツールが必要です。この節では、処理に使われている 各ツールについて列挙し、各々がいつ必要になるのか説明しています。 これらのツールのいずれかが特定のバージョンを要求しているかどうかは、 Doc/README ファイルを調べてみてください。

dvips
  このプログラムはよく TeX インストールの一部になっています。 dvips は ``デバイス非依存 (device independent)'' の .dvi ファイルから PostScript を生成するために使われます。 PostScript への変換を行う際に必要です。

emacs
  Emacs はごちゃまぜ (kitchen sink) の、さらに言うとクソ素晴らしい ごちゃまぜのプログラマ向けエディタです。info 形式に変換したい場合に、 Texinfo ドキュメントの適切なメニュー階層の構築をサポートする上で必要な 処理に関係しています。FSF の emacs の代わりに xemacs を使うと、変換がうまくいかないことがありますが、これは誰も Emacs の Texinfo コードをメンテナンスして可搬性のあるものにしないからだと 思われます。

latex
  LaTeX は、Laslie Lamport による拡張可能な大規模マクロパッケージ で、Donald Knuth が作成した世界規模で使われているタイプセッタTeXに基づいています。PostScript 形式への変換に必要で、 HTML への変換にも 必要です (LaTeX2HTML はLaTeX が生成する中間ファイルの一つを 必要とするためです)。

latex2html
  これまでにメンテナンスされたことのある Perl スクリプトの中で おそらく最長のスクリプトでしょう。このツールは LaTeX ドキュメントを HTML ドキュメントに変換し、そこそこ立派な仕事をします。 HTML や GNU info 形式への変換に必要です。

lynx
  HTML から平文テキストへの変換機能を持つテキストモードの Web ブラウザです。 `howto` ドキュメントをテキスト形式に変換する際に使います。

make
  どのバージョンの make も標準ドキュメントの処理に使えるはず ですが、 実験段階にあるDoc/tools/sgmlconv/ の処理には、 少なくとも実験段階にある間は GNU make が必要です。 mkhowto スクリプトを走らせる場合には必要ありません。

makeindex
  LaTeX の索引データをフォーマット済みの索引に変換するための標準プログラムです; 全てのLaTeX インストール物に入っているはずです。PDF 形式と PostScript 形式への変換に必要です。

makeinfo
  Texinfo から GNU info ファイルへの変換には GNU makeinfo を使います。Texinfo は info への変換における中間形式の処理に使われる ので、info への変換にもこのプログラムが必要です。

pdflatex
  pdfTeX は比較的新しく登場した TeXの変種で、マニュアルの PDF 版を 生成するために使います。通常、ほとんどの大規模な TeX 配布物の一部 としてインストールされています。pdflatex は LaTeX 形式を 扱う pdfTeX です。

perl
  LaTeX2HTML やLaTeX2HTML 出力に対する仕上げ作業、HTMLからTexinfo への変換には Perl が必要です。 HTML 形式や GNU info 形式への変換に 必要です。

python
  Python は Doc/tools/ ディレクトリ内の多くのスクリプトで 使われています; 全ての形式への変換で必要です。 Python のドキュメントを書こうと思っているのなら、何も問題はないはず ですよね!