[debian-devel:13205] Re: not /usr/share/doc, but /usr/doc in potato

[Taketoshi Sano <kgh12351@xxxxxxxxxxx>]

佐野＠浜松です。

In <87n1flg0bz.wl@xxxxxxxxxxxxxxx>,
  on "Tue, 31 Oct 2000 12:24:38 +0900',
   with "[debian-devel:13203] Re: not /usr/share/doc, but /usr/doc in potato",
 Fumitoshi UKAI <ukai@debian.or.jp> さん wrote:

> At Mon, 30 Oct 2000 23:46:21 +0900,
> Taketoshi Sano <kgh12351@xxxxxxxxxxx> wrote:
> 
> > ちょっと確認ですが、potato では copyright ファイルなどの
> > パッケージ附属の文書について /usr/doc/<Package>/ 以下に
> > 収録することになっていたはずです。(技術委員会裁定により)

> potato に含まれている debian-policy 3.1.1.1 によると
> 
> 6.4. Accessing the documentation
> --------------------------------

> ですから /usr/share/doc/<package> にいれて /usr/doc/<package> は
> symlink で /usr/share/doc/<package> を差せ だと思いますが?

時間が無くて正確な URI を調べられませんでしたが、たしか昨年の
 /usr/doc -> /usr/share/doc 移行に関する議論の際に、potato の
リリース目標として移行前の policy (2.5.1.0) 準拠なパッケージでも
 OK という合意 (というか技術委員会の裁定) があったはずだと思います。

また 3.0.1.0 - 3.0.1.1 は /usr/share/doc の記載だけで /usr/doc について
記載が無く、「技術委員会裁定」と policy との間で矛盾が生じていた時期が
あったと思います。3.1.0.0 から

  * Add instructions on /usr/doc -> /usr/share/doc symlinks (closes:
    #45561, #42447, #48570)
  * Move docs to /usr/share/doc with a compatibility symlink (closes:
    #41829)

が含まれるようになって policy に「裁定」が反映されました。これは

>      [1]  These symlinks will be removed in the future, but they have to be
>           there for compatibility reasons until all packages have moved and
>           the policy is changed accordingly.

という注にあるとおり、「すべてのパッケージが移行を完了するまで」、
つまり現状 (= potato) では FHS に移行していないパッケージが存在
していることを示しています。

実際、

 grep /usr/doc/ /var/lib/dpkg/info/*.list|grep copyright$|grep -v doc/copyright

するとけっこうな数のパッケージがリストされます。

> だから 
>  ドキュメントは /usr/share/doc/<package>/ 以下に収録され
>  それは symbolic link により /usr/doc/<pacakge>/ でもアクセスできる
> が正しいのではないのでしょうか?

おそらく woody についてはそうなるだろうと思いますが、potato については
releasenotes.sgml に

  <p>If you find that a familiar package is lacking some or all of its
  functionality, check the list below to see if you need to install more
  packages to restore the original functionality. Failing that, check the
  changelog for the package, which can be found in
  <file>/usr/doc/<var>package</var>/changelog.Debian.gz</file>.

また install manual の en/welcome.sgml に

    <p>
There are several other forms of copyright statements and software
licenses used on the programs in Debian. You can find the copyrights
and licenses for every package installed on your system by looking in
the file <!-- this is tt rather than file on purpose -->
<tt>/usr/doc/<var>package-name</var>/copyright</tt> once you've
installed a package on your system.

とあるように、/usr/doc/<package-name>/ が「一般ユーザーから見た
パッケージ附属のドキュメントを探す場所」とされていると思います。

個々のパッケージについては、dpkg -L で表示される場所として (実際に
ファイルを置かれている場所として) /usr/share/doc/<package-name>/ が
使われている (つまり FHS に移行している) ものもありますが、全体として
見た場合、potato なシステム上でパッケージ附属文書を探す場所は
 /usr/share/doc/<package-name>/ ではなく /usr/doc/<package-name>/ 
であるというのが実態だと思います。

-- 
     ＃ (わたしのおうちは浜松市、「夜のお菓子」で有名さ。)
    <kgh12351@xxxxxxxxxxx> : Taketoshi Sano (佐野　武俊)