Doc TODO (Re: developers-reference)

[Taketoshi Sano <kgh12351@xxxxxxxxxxx>]

佐野＠浜松です。

 woody のリリースもじわじわと近付いてきそうな今日この頃。
 debian-www@Org ML を見ると web の releases/woody/ 以下の
日本語訳を久保田さんが更新してくださっているようですが
 (ありがたいことです _o_) 他にも文書関連で更新の必要なものが
いろいろあるかと思い、ちょっとリストアップしてみることにします。

 (かなり以前からやろうやろうと思いつつ、なかなか時間が取れずに
  できずにいました)

Document		English		Japanese
developers-reference	1.70(cvs-rev)	1.37(cvs-en-rev)
maint-guide		1.0.2(version)	1.0.2(version)

maint-guide の日本語訳は八田(真)さんが追従してくださって
いるのかな ? (内容までは確認していません _o_)

その他、debian-doc の cvs tree にある文書を見ると

apt-howto		1.7.4(version)	none(ko,pl,pt_BR exist)
debian-faq		1.6(cvsrev)	none(pt_BR, ru exist)
project-history		1.13(cvsrev)	none(fr, ru exist)
securing-debian-howto	1.30(cvsrev)	none(es, pt, ru exist)

あたりが、「日本語訳があると良さそう」な文書でしょうか。

前原さんが project-history の以前のバージョンを訳されて
いたと思うのですが、あれはまだどこかにあるのかな。
けっこう追加されているみたいなので、新規に翻訳しなおす
のでもいいかもしれませんが。

 apt-howto は apt の使い方がいろいろと具体例を挙げながら
説明されているので、日本語訳があると利用者にはけっこう
便利そうです。

各文書のサイズは

104306 Oct 25 13:59 developers-reference/developers-reference.sgml
 64357 Jun 22 02:33 maint-guide/maint-guide.sgml

 48582 Nov 21 06:51 apt-howto-en.sgml

  9376 Oct 25 13:59 faq/basic_defs.sgml
 12259 Mar 27  2001 faq/compat.sgml
  3450 Oct 25 13:59 faq/contrib.sgml
 11755 Oct 25 13:59 faq/customizing.sgml
  1595 Oct 25 13:59 faq/debian-faq.sgml
  2428 Dec  7  2000 faq/faqinfo.sgml
 13101 Oct 25 13:59 faq/ftparchives.sgml
  6038 Oct 25 13:59 faq/getting.sgml
  6245 Aug  2 02:45 faq/kernel.sgml
  1906 Aug 31  2000 faq/nexttime.sgml
 19851 Aug 31  2000 faq/pkg_basics.sgml
 13862 Sep 29  2000 faq/pkgtools.sgml
  3052 Mar  8  2000 faq/redist.sgml
  7800 Oct 25 13:59 faq/software.sgml
 10358 Oct 25 13:59 faq/support.sgml
  8450 Oct 25 13:59 faq/uptodate.sgml

 26408 Nov 21 06:51 project-history/project-history.sgml

138379 Dec  4 06:07 securing-debian-howto.sgml

です。project-history とか apt-howto あたりがサイズも
手頃で始めやすいかな ?

なお debian-doc の cvs ツリーに関する情報は以下。

> aph (Adam Di Carlo) は仕事してくれる人には積極的に cvs のアカウントを
> 発行してくれる人ですし、彼の文書は debian-doc の cvs ツリーに入っていて
>  Debian の official member でなくても aph から cvs のアクセス権をもらえば
> 誰でも直接更新できる (webwml とは管理方針が違う) ので、「貢献したいけど
> 何をすればいいのかわからない」という人は、なるべくこっちの方面から始めて
> もらえるといいかなと思います。
> 
> たしか
> 
>   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc cvs login
>   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc checkout dd
> 
> で DDP の文書ファイルが取り出せたんじゃないかな。
> 
> わからないことがあればここや debian-doc ML でもいいですが aph に直接メールで
> いろいろ質問してもわりと親切に答えてくれると思います。

また、これとは別のインストーラの cvs tree
 (debian-boot/) にある文書や po ファイル (メッセージ)
それに debconf の template についても翻訳更新が必要に
なっています。

 base-config では

  6053 Mar 19  2001 apt-setup.templates
 11791 May 25  2001 apt-setup.templates.ja

は良いとして

  1432 Jul  4 09:13 base-config/tzsetup.templates

には日本語版が用意されていません。

 tasksel は ja.po の内容がすこし古いようです。
まだ「タスク用メタパッケージ」が存在していた頃の内容に
なっています。
 (手元で更新してみたので、このメールの後に diff を添付します)

 boot-floppies について:

  debian-boot/boot-floppies/documentation/README-authors より抜粋:

* Getting the Newest SGML Source

If you can use CVS, either locally on cvs.debian.org, using 'pserver',
or using ssh or some such rsh replacement, then you should use that.
See ../README-CVS.

If you cannot, then you should be able to get it using the web interface:

  http://cvs.debian.org/boot-floppies/documentation/

  debian-boot/boot-floppies/README-CVS より抜粋

* Getting the boot-floppies source via CVS

This version of the sources is for Debian 2.2, aka Potato.

The following are POSIX bourne shell commands you can run to get the
CVS area; other shell users should be able to translate to their shell
language easily.  Commands with a `#' are comments; you don't have to
type those.

   # If you are logged into to cvs.debian.org (CNAME va.debian.org):
   export CVSROOT=/cvs/debian-boot

   # If you are using `ssh' to access the area, and you have an
   # account on cvs.debian.org -- this is the recommended method:
   export CVS_RSH=ssh
   export CVSROOT=:ext:<MY-USERNAME>@cvs.debian.org:/cvs/debian-boot

   # If you are using anonymous (readonly) access:
   export CVSROOT=:pserver:anonymous@cvs.debian.org:/cvs/debian-boot
   cvs login
   # You will be prompted for a password -- just hit `Enter'.

   # If you are using a pserver account (i.e., you need write access
   # but do not have a login account, and you have been given a
   # pserver username and password):
   export CVSROOT=:pserver:<USERNAME>@cvs.debian.org:/cvs/debian-boot
   cvs login
   # Enter the password you have been given.

After that, all techniques are the same.  Read on.

* Working on Woody

If you are working on the woody boot-floppies, use the trunk:

   cvs co boot-floppies

If you want to change an existing checked out which was on the woody
or potato branch to the latest version, in the checked out source
directory, do

   cvs up -A -d -P

From there, you can use `cvs update -d -P' (the '-d -P' is to get new
directories, and prune empty directories), `cvs commit', `cvs diff',
and `cvs status' -- see the info pages.

 boot-floppies/documentation/CVS/Entries より

Name			English(cvsrev,date)	Japanese(cvsrev,date)
release-notes.sgml	1.69(2001.11/29)	1.20(2001.03/27)
index.$lang.html.m4	1.15(2001.12/02)	1. 4(2001.08/30)
dselect-beginner.sgml	1.19(2001.07/21)	1. 4(2000.07.03)

(以下インストールマニュアルのソース)
install.sgml		1.90(2001.11/28)	1.13(2001.10/15)
welcome.sgml		1.30(2001.11/26)	1.10(2000.05/27)
hardware.sgml		1.45(2001.12/03)	1. 9(2000.07/06)
preparing.sgml		1.34(2001.11/03)	1.15(2001.10/15)
inst-methods.sgml	1.83(2001.12/05)	1.25(2001.10/15)
rescue-boot.sgml	1.71(2001.12/05)	1.14(2001.10/15)
partitioning.sgml	1.41(2001.12/03)	1.16(2001.11/30)
kernel.sgml		1. 5(2001.11/20)	1. 1(2001.10/08)
boot-new.sgml		1.10(2001.11/28)	1. 1(2001.10/08)
post-install.sgml	1.17(2001.10/25)	1.11(2001.02/18)
tech-info.sgml		1.16(2001.11/20)	1. 9(2001.06/21)
appendix.sgml		1.14(2001.11/03)	1. 3(2001.10/15)
administrivia.sgml	1.11(2001.08/30)	1. 8(2001.07/06)

英文のファイルサイズは

  55360 Nov 29 20:25 release-notes.sgml
   7339 Dec  2 19:38 index.en.html.m4
  27746 Jun 22 02:10 dselect-beginner.sgml

   6182 Nov 28 20:29 install.sgml
  17846 Nov 26 23:31 welcome.sgml
  40848 Dec  4 06:03 hardware.sgml
  47422 Nov  4 05:53 preparing.sgml
  43679 Dec  5 22:20 inst-methods.sgml
  46239 Dec  5 22:20 rescue-boot.sgml
  32372 Dec  4 06:03 partitioning.sgml
  12833 Nov 21 06:49 kernel.sgml
  28078 Nov 28 20:30 boot-new.sgml
  14668 Oct 25 13:56 post-install.sgml
   3498 Nov 21 06:49 tech-info.sgml
  13263 Nov  4 05:53 appendix.sgml
   4294 Aug 30 22:48 administrivia.sgml

です。

一方 boot-floppies/scripts/rescue/messages/ では
 C/CVS/Entries と ja/CVS/Entries を比較すると

C: /install.sh.txt/1.1/Mon Oct 12 13:53:34 1998//
ja: /install.sh.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /readme.txt.alpha/1.1/Tue Aug 14 00:25:00 2001//
ja: (none)
C: /readme.txt.sparc/1.2/Tue Jan  4 23:11:53 2000//
ja: /readme.txt.sparc/1.1/Mon Oct 11 15:40:09 1999//
C: /readme.txt/1.6/Mon Dec  3 21:03:14 2001//
ja: /readme.txt/1.2/Mon Apr 17 08:37:53 2000//

C: /debian.txt.sparc/1.4/Mon Jun  4 09:46:58 2001//
ja: /debian.txt.sparc/1.1/Mon Oct 11 15:40:09 1999//
C: /debian.txt.vme/1.3/Mon Jul 23 13:19:40 2001//
ja: /debian.txt.vme/1.1/Mon Oct 11 15:40:09 1999//
C: /debian.txt/1.9/Mon Jun  4 09:46:58 2001//
ja: /debian.txt/1.4/Fri May  5 13:19:13 2000//

C: /f1.txt/1.7/Wed Apr 26 12:16:09 2000//
ja: /f1.txt/1.3/Wed Feb  2 13:12:26 2000//
C: /f2.txt/1.10/Fri Apr 28 08:39:54 2000//
ja: /f2.txt/1.2/Fri Dec 31 00:44:07 1999//
C: /f3.txt/1.10/Tue May 23 04:04:49 2000//
ja: /f3.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f4.txt/1.10/Tue May 23 04:04:49 2000//
ja: /f4.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f5.txt/1.17/Mon Jul 23 13:19:40 2001//
ja: /f5.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f6.txt/1.12/Thu Nov 30 13:29:49 2000//
ja: /f6.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f7.txt/1.15/Tue May 23 04:04:49 2000//
ja: /f7.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f8.txt/1.7/Wed Apr 26 12:16:09 2000//
ja: /f8.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f9.txt/1.10/Tue May 23 04:04:50 2000//
ja: /f9.txt/1.1/Mon Oct 11 15:40:09 1999//
C: /f10.txt/1.13/Mon Dec  3 21:03:14 2001//
ja: /f10.txt/1.3/Mon Sep  3 12:12:41 2001//

こんな感じ。

 scripts/rootdisk/messages/{C,ja}/release_notes
もちょっと変更されてますが、段落の順番を入れ換えただけ
みたいなのでこれは後まわしでもいいかな。

問題は utilities/dbootstrap/po で、make check-ja すると

  ja.po: 603 個の翻訳されたメッセージ、 116 個の曖昧な翻訳、 
         54 個の未翻訳のメッセージ.

と表示されます。つまり更新が必要と考えられる箇所が 116、
翻訳の必要な箇所が約 50 (/etc/fstab 中のコメントなど
訳さないほうが良いと思われる箇所もいくつかあるため、
「未翻訳」の箇所すべてを翻訳しなければいけないわけではない)
ということです。

更新の必要な箇所には、例えば

#: bootconfig.c:715
#, fuzzy
msgid "Root filesystem must be Ext2"
msgstr "ルートファイルシステムがマウントされていません"

#: bootconfig.c:862
#, fuzzy
msgid "Root and /boot partitions must be on the same disk"
msgstr "ハードディスク: ハードディスクのパーティション"

#: bootconfig.c:2360
#, fuzzy
msgid "Install LILO in the root partition's boot sector."
msgstr "%s ブートセクタへの LILO のインストール"

のように、明らかにそのままでは意味が通じないと思われるものも
あります。(逆にそのままで良いと思われる箇所もありますが)

以上、文書関係で翻訳更新の必要な TODO リストでした。

もし「自分はこれを担当します」という名乗りを挙げてくださる方が
いらっしゃったら、作業の重複を避けるために「やるよ!」という
メッセージをこの ML にも投げておいてもらえるとありがたいです。


以下、tasksel の po 翻訳更新パッチ。

 --- result of "diff -u ja.po.old ja.po"; gzipped and uuencoded ---
begin 664 diff.tasksel.ja.po.gz
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
G@#-!_^O;3Y0.!_\SOPYE\!D_:C2V;PN-84%>!1?_!QXFY(VL%```
`
end

-- 
 ＃ (わたしのおうちは浜松市、アカウミガメのふるさとの街)
   <kgh12351@xxxxxxxxxxx> : Taketoshi Sano (佐野　武俊)