[gentoojp-docs 789] Re: portage-2.0.50 の manの翻訳

[Mamoru KOMACHI <usata@xxxxxxxxxxxxxxxxxxxxxxx>]

小町です。

At Wed, 18 Feb 2004 09:51:17 +0900 (JST),
takeda hiroyuki wrote:

> この辺の細かい話は、新参者の私は知らないので、
> gentoo-jpドキュメントとして、manの翻訳の仕方もあった方が
> よい気がしますね。
> (他にも、例えば文字コードの話とか、文体の話とか。)

そうですね。新サーバで管理できる体制が整ったら、なんとかしましょうか。
galapagos へのドキュメント管理は CVS でいいですが、内部用ドキュメント
(査読前のものを一時的にアップロードしたり)は macaroni で Zope を立ち上
げて管理する、なんていかがでしょう。

> > genkernel の man があればみんな嬉しいと思うんですが、
> > なんでないんでしょうね。
> とりあえず使用するには、--helpで十分な情報が出るからじゃないでしょうか？

そういうのだと英語以外の情報を追加するのが面倒なんですよね……。

> でも、特に指定しなかったら、
> /usr/src/linux配下をコンパイルしようとするよ、とか
> /usr/share/genkernel/{arch}配下から.configもってくるよ、とか、
> 現状はUMLは対応してないよ(他にも対応していないARCHはあるかも)、とか、
> そういう話は、genkernelの中身を知らない人には
> わからない話なので、そういうものこそmanに乗せるべきですが。

たぶんこれは Gentoo Handbook のカーネルのインストールの章
https://www.gentoo.org/doc/en/handbook/handbook.html?part=1&chap=7#doc_chap4
に書こうと思っているんじゃないでしょうかね。いまは genkernel 1.4 対応
と、かなり情報が遅れていますが、これは genkernel の変わり方が速すぎた
せいな気もします。1.x 系と 3.x 系が違いすぎて、なにがなんだか。
(この Handbook の状態で 2004.0 をリリースするのは挑戦的な気がします)

Gentoo ってけっこう最初は「全部シェルスクリプトなんだから、分かんな
かったらソース見てよ」ってところがあって、genkernel も例に漏れずシェル
スクリプトなので、man がないってことは、中身を自分で読んで理解してくれ、
ということのような気がします。たぶんドキュメントがないのは --help が
詳細だからではなく、もっと簡単に仕様を変えてしまうことがありうるから、
あまり文書化したくない、というような印象を受けます。(気持ちは分からなく
もないですが、1.x と 3.x の違いですごく困惑した身からすると、やめてほ
しい)

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