[gentoojp-docs 508] Re: Gentoo Linux 開 発者Tips

[Mamoru KOMACHI <usata@xxxxxxxxxxxxxxxxxxxxxxx>]

小町です。

At Fri, 17 Oct 2003 10:49:20 +0900,
WATANABE Atzm wrote:

> IRC の方で話していた開発者 Tips ですが，何とか形くらいには
> なったのでダメ出しをお願いします．

というわけでツッコミを ;-)

> eclass 関連に関してはまだまだたくさん書くことがあるのでどん
> どん増えていくと思いますが，この調子でガシガシ増えていくと
> なると，ものすごい文章量になってしまって１つのページに収ま
> らなくなるのではないかと思っています(汗

そんな感じですね。リファレンスを目指すとすると……。

> あと，ものすごく初歩的なことなんですが，変数 S って省略して
> 良いんでしたっけ？ 省略はできるけど設定することを推奨すると
> か，そんな記述をどっかで見た気がするんですが…．

そうですね。省略可です。最新の Ebuild HOWTO を見てみると OPT(optional?) 
になってますが、"variables that you should set" ということなので、設定
することが推奨されています。

前半部分、src_unpack や src_compile も eclass でオーバーライドできます
し、S も eclass でオーバーライドできるので(elisp.eclass とか)、eclass
との連携を考えるとちょっと配慮したほうがいいかもしれません。また、リファ
レンス部分と Tips 部分は分けて、Tips のほうでは網羅的には書かず、たと
えば flag-o-matic でもよく利用される関数のみを解説(filter-flags とか
strip-flags とか)したり、どういう場面で使われたりするのかに絞って書い
たほうがいいと思います。あと cvs.eclass の例は個人的には実例(ninix-aya
か kazehakase)を使ったほうが分かりやすい(ドキュメントが古くなってもそっ
ちの ebuild を参照すればアップデートされている可能性が高い)んじゃない
かと思います ;-)

flag-o-matic eclass 以降の eclass の部分はリファレンスとしてかなりいい
と思いますので、リファレンスはリファレンス、Tips は Tips と分け、Tips
からリファレンスに適宜リンクを張る、というのはいかがでしょう。

-- 
Mamoru KOMACHI <usata@xxxxxxxxxxxxxxxxxxxxxxx>
http://www.sodan.ecc.u-tokyo.ac.jp/~usata/