第14章 問題を報告する

目次

14.1. ソフトウェアのバグを報告する
14.2. 文書の問題を報告する

14.1. ソフトウェアのバグを報告する

効率的なバグの報告は PostGIS の開発を助ける本質的な方法です。最も効率的なバグ報告は、PostGIS 開発者がそれを再現できるようにすることで、それの引き金となったスクリプトと検出された環境に沿った全ての情報を含んでいるのが理想です。SELECT postgis_full_version() [PostGIS]とSELECT version() [PostgreSQL]とを実行することで十分に良い情報を得ることができます。

最新版を使っていない場合は release changelog をまず見て、既にバグフィクスされていないかを探すのは価値のあることです。

PostGIS bug tracker を使うと、レポートが捨てられず、それの対応プロセスが通知されることを保証します。新しいバグを報告する前にデータベースに問い合わせて、既知のバグかどうかを見て下さい。既知のものでしたら、それに関して持っているあらゆる新しい情報を追加して下さい。

新しいレポートを記入する前にSimon TathamさんのHow to Report Bugs Effectivelyに関するページを読むと良いでしょう。

14.2. 文書の問題を報告する

文書は、ソフトウェアの機能と振る舞いを正確に反映するべきものです。正確でない場合は、ソフトウェアのバグがあるか、または文書に誤り若しくは不十分な箇所があることが考えられます。

文書の問題も PostGIS bug trackerに報告することができます。

訂正が小さいものなら、バグトラッカの新しい問題の中に、文書内の位置を特定して記述して下さい。

変更が大きい場合は、Subversion パッチが確実に好まれます。Unix上で次の4ステップの処理を行います (既に Subversionをインストールしていると仮定します)。

  1. PostGISのSubversionトランクをチェックアウトします。Unix上で次のように入力します。

    svn checkout http://svn.osgeo.org/postgis/trunk/

    これで./trunkディレクトリに格納されます。

  2. お使いのテキストエディタで文書に変更を加えます。Unixでは、たとえば次のようにします。

    vim trunk/doc/postgis.xml

    文書はHTMLでなくDocBook XMLで書かれていますので、慣れていないなら、残りの文書の例にならって下さい。

  3. 文書のマスタコピーからパッチファイルを作成します。Unixで次のように入力します。

    svn diff trunk/doc/postgis.xml > doc.patch

  4. バグトラッカ内の新しい問題にパッチが取り付けられます。