マニュアルページ

We use the docbook2man utility to convert DocBook REFENTRY pages to *roff output suitable for man pages. At the time of writing, the utility required patching to successfully run on the Postgres markup, and we added a small amount of new functionality to allow setting the man page section in the output file name.

DocBook REFENTRY ペー ジをマニュアルページに適した *roff 出力に変換するために、 docbook2man ユーティリティを使用していま す。この原稿を書いている段階では、 Postgres のマークアップの実行を行なうため にはこのユーティリティにパッチをあてる必要があり、また、マニュアルペ ージの節を出力ファイル名に埋め込むことができるように小さな新しい機能 を追加しました。

docbook2man is written in perl, and requires the CPAN package SGMLSpm to run. Also, it requires nsgmls to be available, which is included in the jade distribution. After installing these packages, then simply run

docbook2man は perl で記述され、その 実行には SGMLSpm CPAN パッケージが必要です。 また、jade 配布物に含まれる nsgmls が使用可能になっていなければい けません。これらのパッケージをインストールしてから、単に以下を実 行して下さい。

$ cd doc/src
$ make man
   
which will result in a tar file being generated in the doc/src directory. これによって、doc/src ディレクトリに tar ファイルが作成されます。

docbook2man インストール手順

  1. Install the docbook2man package, available at http://shell.ipoline.com/~elmert/comp/docbook2X/

    http://shell.ipoline.com/~elmert/comp/docbook2X/ から入手 できる docbook2man パッケージをインス トールして下さい。

  2. Install the SGMLSpm perl module, available from CPAN mirrors.

    CPAN のミラーサイトから入手できる、SGMLSpm perl モジュールをインス トールして下さい。

  3. Install nsgmls if not already available from your jade installation.

    jade のインストールの際に使用可能にし ていない場合は nsgmls をインストールし て下さい。