[update] maint-guide.ja.sgml (4/5)

[Taketoshi Sano <kgh12351@xxxxxxxxxxx>]

佐野＠浜松です。Debian New Maintainers' Guide 日本語訳更新の
第 4 弾です。よろしくお願いします。

  ====== Japanese translation ======

  <chapt id="checkit">できたパッケージの誤りを調べる

  <p><manref name="lintian" section="1"> をあなたの .changes ファイルに
  かけてみましょう。このプログラムはパッケージ化におけるよくある間違いを
  チェックしてくれます。実行するコマンドは以下のとおりです。
  
  <p><example>
  lintian -i gentoo_0.9.12-1_i386.changes
  </example>
  
  <p>もちろん、ファイル名はあなたのパッケージのために生成された
  .changes ファイルの名前に置き換えてください。
  もしエラー (E: で始まる行) が表示されたなら、説明 (N: の行) を
  読んで誤りを訂正し、<ref id="completebuild"> に記述されているように
  パッケージを完全に再構築してください。
  もし W: で始まる行、つまり警告が表示されたら、パッケージを
  調整するか、あるいはその警告が間違いであることを確認してください。
  (そして Lintian の override ファイルに記載するための設定を
  作成してください。この詳細については文書を参照してください。)

  <p><prgn/dpkg-buildpackage/ によるパッケージの生成と、
  <prgn/lintian/ の実行をすべてひとつのコマンド
  <manref name="debuild" section="1"> で行なうこともできます。

  <p><manref name="mc" section="1"> などのファイルマネージャを
  使ってパッケージの中を見たり、<manref name="dpkg-deb" section="1">
  を使ってパッケージの中身を一時的な場所へ取り出したりしてみましょう。
  なにかがうまく行かず、妙なものが削除されないまま残されてしまった
  場合に備えて、バイナリおよびソースパッケージの両方について不要な
  ファイルが余分に含まれたりしていないかどうか、しっかり検査して
  ください。
  ヒント:「zgrep ^+++ ../gentoo_0.9.12-1.diff.gz」を実行すると、
  ソースファイルに対してあなたが行なった変更や追加のリストを
  得ることができます。
  また `dpkg-deb -c gentoo_0.9.12-1_i386.deb` を実行すると
  バイナリパッケージ中のファイルのリストを得ることができます。

  <p>自分でパッケージをインストールして試してみましょう。
  例えば、<manref name="debi" section="1"> コマンドを root で
  実行してみましょう。
  自分の環境以外のマシンでも試してみて、パッケージをインストール
  する際やプログラムを実行する際に警告やエラーが発生しないか
  注意深く観察してみてください。
   
  <chapt id="upload">パッケージをアップロードする

  <p>徹底的に新パッケージをテストしたら、これらのファイルを
  Debian アーカイブにアップロードする必要があります。
  これは手作業で行なってもかまいませんが、
  <manref name="dupload" section="1"> や
  <manref name="dput" section="1"> のような、あらかじめ
  用意されている自動化されたツールを利用したほうがずっと
  簡単です。
  ここでは <prgn/dupload/ を使う方法について説明します。

  <p>まず dupload の設定ファイルを調整しなければいけません。
  システム全体の設定ファイルである <file>/etc/dupload.conf</file>
  を編集するのでも、あるいはあなた専用の設定ファイルである
  <file>~/.dupload.conf</file> を使って変更したい項目だけ
  上書きさせるのでも、どちらでもかまいません。
  このファイルには以下のような項目を記載します。

  <p><example>
  package config;

  $default_host = "ftp-master";

  $cfg{"ftp-master"}{"login"} = "yourdebianusername";

  $cfg{"non-us"}{"login"} = "yourdebianusername";

  1;
  </example>

  <p>もちろん、私の個人的な設定の部分はあなたの設定に従って
  変更してください。またそれぞれのオプションが持つ意味を理解する
  ために <manref name="dupload.conf" section="5"> マニュアルページ
  を読んでください。

  <p>もっとも気をつけるべき項目は $default_host の選択です。
  この項目にはデフォルトとして利用するアップロードキューを指定します。
  「ftp-master」がメインのサーバーですが、場合によっては別の、もっと
  速い (ネットワーク的に近い) ホストを利用したいこともあるでしょう。
  アップロードキューについて、詳しくは開発者レファレンスの
  「Uploading a package (パッケージのアップロード)」の節、
  <file>/usr/share/doc/developers-reference/developers-reference.html/ch-upload.en.html#s-uploading</file>
  を参照してください。

  <p>さてそれでは、インターネットプロバイダに接続し、
     以下のコマンドを実行してください:
  
  <p><example>
  dupload gentoo_0.9.12-1_i386.changes
  </example>

  <p><prgn/dupload/ は各ファイルの MD5 チェックサムを計算し、
  .changes ファイルの中の情報と照合します。
  もし一致しない場合にはうまく upload できないため、
  <ref id="completebuild"> の説明に従って最初から再構築を
  やり直すよう、警告してきます。
  
  <p>「ftp-master」へアップロードするよう指定した場合、
  <prgn/dupload/ は Debian マシン上でのあなたのパスワードを
  確認し、そしてパッケージを upload します。

  ====== Original version ======

  <chapt id="checkit">Checking the package for errors

  <p>Run <manref name="lintian" section="1"> on your .changes file; this
  program will check for many common packaging errors. The command is:
  
  <p><example>
  lintian -i gentoo_0.9.12-1_i386.changes
  </example>
  
  <p>Of course, replace the filename with the name of the .changes file
  generated for your package. If it appears that there are some errors
  (lines beginning with E:), read the explanation (the N: lines), correct
  mistakes, and rebuild as described in <ref id="completebuild">. If there are
  lines that begin with W:, those are warnings, so tune the package or
  verify that the warnings are spurious (and make Lintian overrides; see
  the documentation for details).

  <p>Note that you can build the package with <prgn/dpkg-buildpackage/ and run
  <prgn/lintian/ all in one command with <manref name="debuild" section="1">.

  <p>Look inside the package using a file manager like <manref name="mc" section="1">,
  or unpack it in a temporary place using <manref name="dpkg-deb" section="1">.
  Be on the lookout for extra unneeded files, both in the binary and source
  package. Often cruft doesn't get cleaned up properly; adjust your rules
  file to compensate for that. Tips: `zgrep ^+++ ../gentoo_0.9.12-1.diff.gz` will give you a list of
  your changes/additions to the source files, and `dpkg-deb -c gentoo_0.9.12-1_i386.deb`
  will list the files in the binary package.

  <p>Install the package to test it yourself, e.g. using the
  <manref name="debi" section="1"> command as root. Try to install and run
  it on machines other than your own and watch closely for any warnings
  or errors both during the installation and while the program is being run.

  <chapt id="upload">Uploading the package

  <p>Now that you have tested your new package thoroughly, you will be ready
  to start the Debian new maintainer application process, as described at
  <url id="http://www.debian.org/devel/join/newmaint";>

  <p>Once you become an official developer, you'll need to upload the
  package to the Debian archive. You can do this manually, but it's easier
  to use the provided automated tools, like
  <manref name="dupload" section="1"> or <manref name="dput" section="1">.
  We'll describe how it's done with <prgn/dupload/.

  <p>First you have to set up dupload's config file. You can either edit the
  system-wide <file>/etc/dupload.conf</file> file, or have your own
  <file>~/.dupload.conf</file> file override the few things you want to
  change. Put something like this in the file:

  <p><example>
  package config;

  $default_host = "ftp-master";

  $cfg{"ftp-master"}{"login"} = "yourdebianusername";

  $cfg{"non-us"}{"login"} = "yourdebianusername";

  1;
  </example>

  <p>Of course, change my personal settings to yours, and read the
  <manref name="dupload.conf" section="5"> manual page to understand
  what each of these options means.

  <p>The $default_host option is the trickiest one -- it determines which of
  the upload queues will be used by default. "ftp-master" is the primary
  one, but it's possible that you will want to use another, faster one.
  For more information about the upload queues, read the Developers'
  Reference, section "Uploading a package", at
  <file>/usr/share/doc/developers-reference/developers-reference.html/ch-upload.en.html#s-uploading</file>

  <p>Then connect to your Internet provider, and issue this command:
  
  <p><example>
  dupload gentoo_0.9.12-1_i386.changes
  </example>

  <p><prgn/dupload/ checks that the MD5 checksums of the files match those from the
  .changes file, so it will warn you to rebuild it as described in
  <ref id="completebuild"> so it can properly upload.

  <p>If you upload to "ftp-master", <prgn/dupload/ will ask for your
  password on Debian machines, and then upload the packages.

  ====== End ======
--
   ＃ わたしのおうちは浜松市、アカウミガメもやってくる
    <kgh12351@xxxxxxxxxxx> : Taketoshi Sano (佐野　武俊)