[debian-devel:14674] Re: ITP is "Intent"

[Tomohiro KUBOTA <tkubota@xxxxxxxxxxx>]

どうも。久保田です。

At Fri, 9 Nov 2001 01:14:28 +0900,
KISE Hiroshi wrote:

> http://lists.debian.org/debian-policy/2001/debian-policy-200108/msg00009.html
> “Bug#108416: Format of short description should be mandated”

というわけで、訳してみました。かなり超訳が入っています。

パッケージの短い記述は、以下のことを守るべきです:
 * control ファイルが 80 文字の行に収まるようにする。(パッケージ名と
   短い説明とが合計で 80 文字に達しないように)。
 * 通常は、以下の文の ... 部分にあてはまるように書く。
   「<foo> is a package which provides (a/an) ...」
   (訳注: 要するに、名詞句を書けということですね)。
 * もし文字数が許し、説明に役立つなら、パッケージ名に使った
   略称のフルネームを書く。
 * そのパッケージをインストールしたいと思う人ならすでに知っていると
   思われることは書かない (たとえば、python や perl パッケージを
   何らかの形で扱おうと思っている人はふつう、それがスクリプト言語である
   ということを知っているはずです。その事実を繰り返す必要はありません)。

パッケージの短い説明は、以下のことをしないべきです。
 1 パッケージの名前を繰り返すこと。パッケージ名を示さずに説明だけが
   示されることはありえません。
 2 正式名称で他のパッケージ、プロトコル、標準、などの名前を書くこと。
   (訳注: ほんと? 逆ですよね?)
   たとえば、
   + "X Window System", "X11", "X" を使い、"X Windows", "X-Windows",
     "X Window" を使わない。とくに "X Window" は最悪です。
   + "GTK+" を使う。"GTK" や "gtk" はだめ。
   + "GNOME" と書く。"Gnome" はだめ。
   + "PostScript" と書く。"Postscript" や "postscript" はだめ。
 3 どうしても必要だということがない場所で不定冠詞の "a" や "an" を使うこと。
 4 大文字やピリオドを含むこと。ただし 2 で必要とされる場合を除く。
 5 これが Debian パッケージであるという情報を入れること
   (わかりきった情報です)。
 6 "&"、"misc."、"etc." などの略称を使うこと。

パッケージの短い説明は、以下のことをしてはいけません。
 * 他のパッケージの短い説明と同一になること。
 * 80 文字以上になること。

良い例:

Description: simple configuration tool for Japanese environment
	短くて、優しくて、余分な冠詞や記号がありません。
	(訳注: ^_^)

Description: Vi IMproved - enhanced vi editor
	パッケージ名の "vim" の説明になっていて、よく知られた
	実在するソフトウェアの名前を使って説明しています。

Description: reasonably versatile X-based image editing tool
	"X-Windows-based" と書かないほうがいいことがこれで分かります。

Description: Debian Packaging Manual

Description: Perl extensions for writing pRPC servers and clients
	「Perl」は「perl」と書くよりも正統でしょうか?

Description: an oscilloscope on acid
	(訳注: よくわかりません)
	exempted from the article rule because this description is
	clearly written with a touch of whimsy (as was the program, I
	think :) )

あまり良くない例:

Description: The Japanese version of chess.
	必要ないのに文の形になっています。"The" とピリオドを
	除くと良くなります。
	改良案: Japanese version of chess

Description: Emacs-lisp python-mode for the scripting language Python.
	Python の表記が不統一です。"lisp" は正統でしょうか。私は
	"LISP" が正しいと思っていました (ただし、これは Emacs Lisp
	という別の言語のときには問題にならないかもしれません)。
	ピリオドで終わっています。
	改良案: Emacs LISP major mode for the Python scripting language
	あるいは: Emacs major mode for Python

Description: The GNU wdiff utility. Compares two files word by word.
	不要な大文字、冠詞、ピリオドがあります。
	改良案: GNU "word-diff" utility for comparing files word by word

Description: A compression module for Python using zlib.
	改良案: zlib compression module for Python

Description: The telnet client.
	改良案: telnet client

Description: Frontends to DNS search.
	最初の大文字と、ピリオド。情報が十分ではありません。
	改良案: programs to perform lookups on DNS servers


---
久保田智広 Tomohiro KUBOTA <kubota@debian.org>
http://www.debian.or.jp/~kubota/
"Introduction to I18N"  http://www.debian.org/doc/manuals/intro-i18n/