Developer's Reference chap.9

[Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>]

遠藤です。

Debian デベロッパーズリファレンス第 9 章の翻訳です。
チェックお願いします。

|     <chapt id="archive-manip">
|       <heading>Moving, Removing, Renaming, Adopting, and Orphaning
|       Packages</heading>
|       <p>
| Some archive manipulation operation are not automated in the Debian
| upload process.  These procedures should be manually followed by
| maintainers.  This chapter gives guidelines in what to do in these
| cases.

    <chapt id="archive-manip">
      <heading>パッケージの移動、削除、改名、引き継ぎ、みなしご化</heading>
      <p>
Debian のアップロード手続きにおいて、
アーカイブ操作の作業のすべてが自動化されているわけではありません。
自動化されていない作業に関しては、開発者が手動で行なわなければなりません。
この章ではそのような作業の際に従うべきガイドラインを扱います。

|       <sect>Moving packages
| 	<p>
| Sometimes a package will change either its section.  For instance, a
| package from the `non-free' section might be GPL'd in a later version,
| in which case, the package should be moved to `main' or
| `contrib'.<footnote> See the <url id="&url-debian-policy;"
| name="Debian Policy Manual"> for guidelines on what section a package
| belongs in.
| 	  </footnote>

      <sect>パッケージの移動
	<p>
パッケージはそのセクションが変更されることもあります。
例えば `non-free' セクションのパッケージが後のバージョンで GPL
準拠となった場合、そのパッケージは
`main' あるいは `contrib' に移動されなければなりません
	  <footnote> 
あるパッケージをどのセクションに収めるべきかに関するガイドラインについては
<url id="&url-debian-policy;" name="Debian ポリシーマニュアル">
をご覧ください。
	  </footnote>。

| 	<p>
| If you need to change the section for one of your packages, change the
| package control information to place the package in the desired
| section, and re-upload the package (see the <url id="&url-pkg-manual;"
| name="Debian Packaging Manual"> for details).  Carefully examine the
| installation log sent to you when the package is installed into the
| archive.  If for some reason the old location of the package remains,
| file a bug against <tt>ftp.debian.org</tt> asking that the old
| location be removed.  Give details on what you did, since it might be
| a <prgn>dinstall</prgn> bug.


	<p>
ご自分のパッケージのセクションを変更しなければならない場合、
変更先のセクションにパッケージを設置するために、
パッケージの制御情報を変更し、
そのパッケージを再アップロードしてください。
(詳しくは <url id="&url-pkg-manual;" name="Debian パッケージングマニュアル">
をご覧ください。)
パッケージがアーカイブにインストールされる際に送られてくる
インストレーションログを十分に確認してください。
もし何らかの理由でパッケージが変更前の場所にも残っていた場合は、
<tt>ftp.debian.org</tt> に対してバグ報告を行ない、
変更前の場所にあるパッケージを削除するよう依頼してください。
もしかすると <prgn>dinstall</prgn> のバグかもしれないので、
その際にはご自分で行なったことの詳細を添えてください。

| 	<p>
| If, on the other hand, you need to change the <em>subsection</em> of
| one of your packages (e.g., ``devel'', ``admin''), the procedure is
| slightly different.  Correct the subsection as found in the control
| file of the package, and reupload that.  Also, you'll need to update
| the override file, as described in <ref id="override-file">.

	<p>
一方、パッケージの <em>subsection</em> (例えば ``devel'' や ``admin'' など)
を変更する必要がある場合、その手続きは若干異なります。
この場合は、そのパッケージの制御ファイルにある subsection を修正し、
再アップロードしてください。
また、<ref id="override-file"> で説明したように、
オーバライドファイルを更新する必要もあります。

|       <sect id="removing-pkgs">Removing packages
| 	<p>
| If for some reason you want to completely remove a package (say, if it
| is an old compatibility library which is not longer required), you
| need to file a bug against <tt>ftp.debian.org</tt> asking that the
| package be removed.  Make sure you indicate which distribution the
| package should be removed from.

      <sect id="removing-pkgs">パッケージの削除
	<p>
あるパッケージ (例えば、もはや不要になった古い互換ライブラリなどを) 
を何らかの理由のために完全に削除したい場合は、<tt>ftp.debian.org</tt> 
に対してバグ報告を行ない、
そのパッケージを削除するよう依頼しなければなりません。
その際、そのパッケージをどのディストリビューションから
削除するのかを必ず明記してください。

| 	<p>
| If in doubt concerning whether a package is disposable, email
| &email-debian-devel; asking for opinions.  Also of interest is the
| <prgn>apt-cache</prgn> program from the <package>apt</package>
| package.  When invoked as <tt>apt-cache showpkg
| <var>package</var></tt>, the program will show details for
| <var>package</var>, including reverse depends.

	<p>
なお、そのパッケージが不要なものかどうかはっきりしない場合は、
&email-debian-devel; に電子メールを送り意見を求めてください。
また、こちらに関しては <package>apt</package> パッケージの 
<prgn>apt-cache</prgn> プログラムを利用して確認してみてもよいでしょう。
<tt>apt-cache showpkg <var>package</var></tt> とすれば、reverse 
depends 情報を含む <var>package</var> 詳細が表示されます。

| 	<sect1>Removing packages from <tt>Incoming</tt>
| 	  <p>
| If you decide to remove a package from <tt>Incoming</tt>, it is nice
| but not required to send a notification of that to the appropriate
| announce list (either &email-debian-changes; or
| &email-debian-devel-changes;).

	<sect1><tt>Incoming</tt> からのパッケージ削除
	  <p>
あるパッケージを <tt>Incoming</tt> から削除したい場合は、
義務ではありませんが、適切なアナウンス用メーリングリスト
(&email-debian-changes; か &email-debian-devel-changes;)
にその旨を通知しておくとよいでしょう。

|       <sect>Replacing or renaming packages
| 	<p>
| Sometimes you made a mistake naming the package and you need to rename
| it.  In this case, you need to follow a two-step process.  First, set
| your <file>debian/control</file> file to replace and conflict with the
| obsolete name of the package (see the <url id="&url-pkg-manual;"
| name="Debian Packaging Manual"> for details).  Once you've uploaded
| that package, and the package has moved into the archive, file a bug
| against <tt>ftp.debian.org</tt> asking to remove the package with the
| obsolete name.

      <sect>パッケージの置き換えや改名
	<p>
パッケージの名前を間違えて付けてしまい、
それを改名しなければならないことがあるかもしれません。
この場合、次の二つの手順を踏む必要があります。
まず初めに、そのパッケージの古い名前に対して
replace および conflict となるよう
<file>debian/control</file> ファイルに設定を行ないます。
(詳細は <url id="&url-pkg-manual;" name="Debian パッケージングマニュアル"> 
をご覧ください。)
そして、このパッケージをアップロードし、それをアーカイブに移動したら、
<tt>ftp.debian.org</tt> に対するバグ報告を行ない、
古い名前のパッケージを削除するよう依頼してください。

|       <sect id="orphaning">Orphaning a package
| 	<p>
| If you can no longer maintain a package, then you should set the
| package maintainer to <tt>Debian QA Group
| &lt;debian-qa@lists.debian.org&gt;</tt> and email &email-wnpp;
| indicating that the package is now orphaned.  If the package is
| especially crucial to Debian, you should instead email
| &email-debian-devel; asking for a new maintainer.

      <sect id="orphaning">パッケージのみなしご化
	<p>
あるパッケージのメンテナンスができなくなった場合は、そのパッケージ開発者を 
<tt>Debian QA Group &lt;debian-qa@lists.debian.org&gt;</tt> に設定し直し、
&email-wnpp; 宛てにそのパッケージをみなしご化する旨を
電子メールで通知しなければなりません。
ただ、そのパッケージが Debian にとって極めて重要なものである場合は、
代わりに &email-debian-devel; 宛てに電子メールを送り、
新開発者を募集すべきでしょう。


|       <sect id="adopting">Adopting a package
| 	<p>
| Periodically, a listing of packages in need of new maintainers will be
| sent to &email-debian-devel list. This list is also available at in
| the Work-Needing and Prospective Packages document (WNPP), <url
| id="&url-wnpp;">.  If you wish to take over maintenance of any of the
| packages listed in the WNPP, or if you can no longer maintain a
| packages you have, or you simply want to know if any one is working on
| a new package, send a message to &email-wnpp;.

      <sect id="adopting">パッケージの引き継ぎ
	<p>
新開発者が必要なパッケージの一覧が、定期的に
&email-debian-devel メーリングリストに流されます。
この一覧は <url id="&url-wnpp;"> にある
Work-Needing and Prospective Packages document (WNPP)
からも入手できます。
WNPP の一覧にあるパッケージのメンテナンスを引き継ぎたい場合や、
ご自分のパッケージのメンテナンスを放棄する場合、
新規パッケージの作業を誰が行なっているかどうか単に確認した場合は、
&email-wnpp; に電子メールを送ってください。

| 	<p>
| It is not OK to simply take over a package that you feel is neglected
| -- that would be package hijacking.  You can, of course, contact the
| current maintainer and ask them if you may take over the package.
| However, without their assent, you may not take over the package.
| Even if they ignore you, that is still not grounds to take over a
| package.  If you really feel that a maintainer has gone AWOL (absent
| without leave), post a query to &email-debian-private;.

	<p>
このことをおろそかにして、あるパッケージを単に引き継ぐだけではいけません。
-- これではパッケージハイジャックです。
もちろん、現行の開発者に連絡を取り、
そのパッケージの引き継ぎを依頼することは可能です。
しかしながら、その際に同意を得られなければ、
そのパッケージを引き継ぐことはできません。
たとえあなたの申し出が無視されたとしても、
それはパッケージ引き継ぎの理由とはなりません。
現行開発者が音沙汰もなくその作業を放棄していると確信できる場合は、
その旨を &email-debian-private; にて尋ねてみてください。

| 	<p>
| If you take over an old package, you probably want to be listed as the
| package's official maintainer in the bug system. This will happen
| automatically once you upload a new version with an updated
| <tt>Maintainer:</tt> field, although it can take a couple of weeks. If
| you do not expect to upload a new version for a while, send an email
| to &email-override; so that bug reports will go to you right away.

	<p>
なお、古いパッケージを引き継いだ場合は、
ご自分をそのパッケージの公式開発者として
バグ追跡システムに登録なさりたいでしょう。
<tt>Maintainer:</tt> フィールドを更新した新バージョンをアップロードすれば、
二週間ほど時間がかかりますが、その処理は自動的に行なわれます。
ただ、しばらくの間、新バージョンをアップロードできない場合は、
バグ報告があなたの元へ正しく送付されるようにするために、
&email-override; に電子メールを送ってください。

-- 
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>