[PHP-doc 22] PHPマニュアルのメンテナ募集

Rui Hirokawa php-doc@php.gr.jp
Sat, 24 Nov 2001 13:54:08 +0900 

This is a multi-part message in MIME format.

--Multipart_Sat__24_Nov_2001_13:54:08_+0900_086864d0
Content-Type: text/plain; charset=ISO-2022-JP
Content-Transfer-Encoding: 7bit


廣川＠ドキュメント部門とりまとめです。

PHPマニュアルは、PHP3日本語マニュアル作成プロジェクトとして
数名のメンバーにより翻訳されました。
その後、本家CVSツリーへのマージ、最新のPHPマニュアルへの
追従作業(メンテナンス)を個人的に行って来ました。
現在では2000近い関数が既述され、A4で800ページ以上のボリュームがあります。

しかし、小山さんにもご指摘を頂いたように、PHPがサポートする
機能が追加されるのに伴い、短期間で英語版のマニュアルの更新に追従
しきれていないというのが現状です。
特に最近は、私自身がPHP関連の原稿作成や国際化作業等を平行して行っている
ことも遅延の要因となっています。

PHPマニュアルは、以下のサイトで配布されていますが、この種のマニュアルとして
よく整理されており、PHPコミュニティの財産とも言えるものではないかと思います。

http://www.php.net/manual/ja/

そこで、PHPマニュアルの翻訳/更新を行うボランティアスタッフを
募集したいと思います。

なお、とりまとめ作業は引き続き私が行っていきたいと思います。
(もちろん、やっていただける方がいらっしゃりましたら歓迎します)

PHPマニュアルは、XML、pgsqlといったジャンル毎にDocBook/XML形式の
XMLファイルで構成されています。

メンテナンスを行う方(メンテナ)には、以下の作業をお願いしたいと
思います。

1.担当するファイルの更新情况の確認
2.担当するファイルに関して日本語マニュアルの更新

具体的な参加の方法ですが、メンテナンスを効率的に行うために
いくつかの基本的なツールを使用して頂く必要があります。

1.CVS
2.DocBook/XML処理環境(jade,スタイルシート等)

翻訳/更新の手順:

1.現行のファイル一覧(添付)から担当分野を選択し、このMLでメンテナ希望の宣言する
2.本家CVSからphpdocをチェックアウト
 http://www.php.net/docs.php の CVS Account に取得方法を記載しています。
 anonymousで取得可能です。
2.本家ドキュメント用ML(phpdoc@lists.php.net)で担当分野の内容更新を監視(英語)
3.日本語マニュアルの担当部分の更新を行う。
4.ドキュメントのXML構文エラーチェックを行う。
  autoconf
  ./configure --with-lang=ja
  make test
5.作業用ML(新規開設またはこのML)またはとりまとめ(現在は廣川)にメールで送信する。

また、できればメンテナの方には正式の翻訳者として、本家CVSアカウントを取得して
いただきたく思います。
http://www.php.net/docs.php の CVS Account/Getting a CVS accountを
参照下さい。
CVSアカウントをお持ちの場合は、CVSツリーを直接更新できますので、
上記の手順5は「CVSにコミットする」になります。

なお、上記手順は、できるだけ既存のインフラを使う想定で書いています。
日本語マニュアル用に新規インフラを作るのも手ですが、そのメンテナンスの
手間も増えるため、できる限り整備されている本家のCVSツリーなどの
インフラを使用したいというのが私の意見です。
(一案ですので代案がありましたら提案頂ければと思います。)

なお、参加にあたり英語について必ずしも堪能である必要はありません。
(私自身も別に英語が得意なわけではありませんし。)

参加を希望される方は、このMLか私宛のメールにて希望される
ファイルをおしらせ下さい。

このメンテナンスの作業は非常に長期間にわたるとても地味〜な作業です。
いったん参加していただいた方でも仕事の都合などにより継続できなくなることも
考えられます。
その際には、メンテナンスの遅延を防止するため、できるだけ明確かつ速やかに
メンテナからの離脱または休止(代理の募集)を宣言して下さい。
(離脱、休止の理由は不要です)

なお、メンテナンスのやり方、手順等についてのご意見についても
頂戴できればと思います。

-- 
-----------------------------------------------------
Rui Hirokawa <rui_hirokawa@ybb.ne.jp>
             <hirokawa@php.net>

--Multipart_Sat__24_Nov_2001_13:54:08_+0900_086864d0
Content-Type: application/octet-stream;
 name="Translators"
Content-Disposition: attachment;
 filename="Translators"
Content-Transfer-Encoding: base64

RmlsZXMJCQkJCVRyYW5zbGF0b3JzCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09CmJvb2tpbmZvLnhtbAkJ
CQlSdWkgSGlyb2thd2EKcHJlZmFjZS54bWwJCQkJUnVpIEhpcm9rYXdhCi0tLS0tLS0gYXBwZW5k
aWNlcyAtLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLQphcHBlbmRpY2VzL2NvbW1hbmRsaW5lLnhtbAkJUnVpIEhpcm9rYXdhCmFwcGVuZGlj
ZXMvZGVidWdnZXIueG1sCQkJTWljaGloaWRlIEhvdHRhCmFwcGVuZGljZXMvZXNjYXBpbmcueG1s
CQkJUnVpIEhpcm9rYXdhCmFwcGVuZGljZXMvaGlzdG9yeS54bWwJCQlSdWkgSGlyb2thd2EKYXBw
ZW5kaWNlcy9odHRwLXN0dWZmLnhtbAkJUnVpIEhpcm9rYXdhCmFwcGVuZGljZXMvbWlncmF0aW9u
LnhtbAkJTWljaGloaWRlIEhvdHRhCmFwcGVuZGljZXMvbWlncmF0aW9uNC54bWwJCVJ1aSBIaXJv
a2F3YQphcHBlbmRpY2VzL3BocGRldmVsLnhtbAkJCVJ1aSBIaXJva2F3YQphcHBlbmRpY2VzL3Jl
Z2V4cC54bWwJCQlSdWkgSGlyb2thd2EKYXBwZW5kaWNlcy9yZXNlcnZlZC54bWwJCQlSdWkgSGly
b2thd2EKLS0tLS0tLSBjaGFwdGVycyAtLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KY2hhcHRlcnMvY29uZmlnLnhtbAkJCVJ1aSBIaXJv
a2F3YQpjaGFwdGVycy9jb3B5cmlnaHQueG1sCQkJUnVpIEhpcm9rYXdhCmNoYXB0ZXJzL2luc3Rh
bGwueG1sCQkJUnVpIEhpcm9rYXdhCmNoYXB0ZXJzL2ludHJvLnhtbAkJCVJ1aSBIaXJva2F3YQpj
aGFwdGVycy9zZWN1cml0eS54bWwJCQlSdWkgSGlyb2thd2EKLS0tLS0tLSBmYXEgLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCmZhcS9i
dWlsZC54bWwJCQkJUnVpIEhpcm9rYXdhCmZhcS9kYXRhYmFzZXMueG1sCQkJTWFzYWtpIEZ1amlt
b3RvCmZhcS9nZW5lcmFsLnhtbAkJCQlNYXNha2kgRnVqaW1vdG8KZmFxL2luc3RhbGxhdGlvbi54
bWwJCQlNYXNha2kgRnVqaW1vdG8KZmFxL2xhbmd1YWdlcy54bWwJCQlNYXNha2kgRnVqaW1vdG8K
ZmFxL21haWxpbmdsaXN0LnhtbAkJCU1hc2FraSBGdWppbW90bwpmYXEvbWlncmF0aW9uLnhtbAkJ
CU1hc2FraSBGdWppbW90bwpmYXEvbWlncmF0aW9uNC54bWwJCQlNYXNha2kgRnVqaW1vdG8KZmFx
L21pc2MueG1sCQkJCU1hc2FraSBGdWppbW90bwpmYXEvb2J0YWluaW5nLnhtbAkJCU1hc2FraSBG
dWppbW90bwpmYXEvdXNpbmcueG1sCQkJCU1hc2FraSBGdWppbW90bwotLS0tLS0tIGZlYXR1cmVz
IC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLQpmZWF0dXJlcy9jb25uZWN0aW9uLWhhbmRsaW5nLnhtbAlSdWkgSGlyb2thd2EKZmVhdHVy
ZXMvY29va2llcy54bWwJCQlSdWkgSGlyb2thd2EKZmVhdHVyZXMvZXJyb3ItaGFuZGxpbmcueG1s
CQlSdWkgSGlyb2thd2EKZmVhdHVyZXMvZmlsZS11cGxvYWQueG1sCQlSdWkgSGlyb2thd2EKZmVh
dHVyZXMvaHR0cC1hdXRoLnhtbAkJCVJ1aSBIaXJva2F3YQpmZWF0dXJlcy9pbWFnZXMueG1sCQkJ
UnVpIEhpcm9rYXdhCmZlYXR1cmVzL3BlcnNpc3RlbnQtY29ubmVjdGlvbnMueG1sCVJ1aSBIaXJv
a2F3YQpmZWF0dXJlcy9yZW1vdGUtZmlsZXMueG1sCQlSdWkgSGlyb2thd2EKZmVhdHVyZXMvc2Fm
ZS1tb2RlLnhtbAkJCVJ1aSBIaXJva2F3YQotLS0tLS0tIGZ1bmN0aW9ucyAtLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQpmdW5jdGlvbnMv
YWRhYmFzLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvYXBhY2hlLnhtbAkJCVJ1aSBIaXJv
a2F3YQpmdW5jdGlvbnMvYXJyYXkueG1sCQkJTWljaGloaWRlIEhvdHRhCmZ1bmN0aW9ucy9hc3Bl
bGwueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9iYy54bWwJCQlSdWkgSGlyb2thd2EKZnVu
Y3Rpb25zL2J6aXAyLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvY2FsZW5kYXIueG1sCQkJ
TWFjaGlubyBTYXRvc2hpCmZ1bmN0aW9ucy9jY3ZzLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlv
bnMvY2xhc3NvYmoueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9jcGRmLnhtbAkJCVJ1aSBI
aXJva2F3YQpmdW5jdGlvbnMvY3R5cGUueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9jdXJs
LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvY3liZXJjYXNoLnhtbAkJCVJ1aSBIaXJva2F3
YQpmdW5jdGlvbnMvZGF0ZXRpbWUueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9kYmEueG1s
CQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9kYmFzZS54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rp
b25zL2RibS54bWwJCQlNaWNoaWhpZGUgSG90dGEKZnVuY3Rpb25zL2RieC54bWwJCQlSdWkgSGly
b2thd2EKZnVuY3Rpb25zL2Rpci54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2RsLnhtbAkJ
CUNoaWhpcm8gSGlndWNoaQpmdW5jdGlvbnMvZG9teG1sLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5j
dGlvbnMvZXJyb3JmdW5jLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvZXhlYy54bWwJCQlS
dWkgSGlyb2thd2EKZnVuY3Rpb25zL2Zic3FsLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMv
ZmRmLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvZmlsZXByby54bWwJCQlSdWkgSGlyb2th
d2EKZnVuY3Rpb25zL2ZpbGVzeXN0ZW0ueG1sCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2Z0cC54
bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2Z1bmNoYW5kLnhtbAkJCVJ1aSBIaXJva2F3YQpm
dW5jdGlvbnMvZ2V0dGV4dC54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2dtcC54bWwJCQlS
dWkgSGlyb2thd2EKZnVuY3Rpb25zL2h0dHAueG1sCQkJTWljaGloaWRlIEhvdHRhCmZ1bmN0aW9u
cy9ody54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2liYXNlLnhtbAkJCVJ1aSBIaXJva2F3
YQpmdW5jdGlvbnMvaWNhcC54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2ljb252LnhtbAkJ
CVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvaWZ4LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMv
aW1hZ2UueG1sCQkJQ2hpaGlybyBIaWd1Y2hpCmZ1bmN0aW9ucy9pbWFwLnhtbAkJCU1pY2hpaGlk
ZSBIb3R0YQpmdW5jdGlvbnMvaW5mby54bWwJCQlNaWNoaWhpZGUgSG90dGEKZnVuY3Rpb25zL2lu
Z3Jlc19paS54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL2phdmEueG1sCQkJUnVpIEhpcm9r
YXdhCmZ1bmN0aW9ucy9tYWlsLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvbWF0aC54bWwJ
CQlNYWNoaW5vIFNhdG9zaGkKZnVuY3Rpb25zL21ic3RyaW5nLnhtbAkJCVJ1aSBIaXJva2F3YQpm
dW5jdGlvbnMvbWNhbC54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL21jcnlwdC54bWwJCQlS
dWkgSGlyb2thd2EKZnVuY3Rpb25zL21oYXNoLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMv
bWluZy54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL21pc2MueG1sCQkJTWljaGloaWRlIEhv
dHRhCmZ1bmN0aW9ucy9tbm9nb3NlYXJjaC54bWwJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvbXNz
cWwueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9teXNxbC54bWwJCQlLYXp1aGlybyBPZ3Vy
YQpmdW5jdGlvbnMvbmV0d29yay54bWwJCQlDaGloaXJvIEhpZ3VjaGkKZnVuY3Rpb25zL25pcy54
bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL29jaTgueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0
aW9ucy9vcGVuc3NsLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvb3JhY2xlLnhtbAkJCVJ1
aSBIaXJva2F3YQpmdW5jdGlvbnMvb3ZyaW1vcy54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25z
L292ZXJsb2FkLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvb3V0Y29udHJvbC54bWwJCVJ1
aSBIaXJva2F3YQpmdW5jdGlvbnMvcGNyZS54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3Bj
bnRsLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvcGRmLnhtbAkJCVJ1aSBIaXJva2F3YQpm
dW5jdGlvbnMvcGZwcm8ueG1sCQkJUnVpIEhpcm9rYXdhCmZ1bmN0aW9ucy9wZ3NxbC54bWwJCQlS
dWkgSGlyb2thd2EKZnVuY3Rpb25zL3Bvc2l4LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMv
cHJpbnRlci54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3BzcGVsbC54bWwJCQlSdWkgSGly
b2thd2EKZnVuY3Rpb25zL3JlY29kZS54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3JlZ2V4
LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvc2F0ZWxsaXRlLnhtbAkJCVJ1aSBIaXJva2F3
YQpmdW5jdGlvbnMvc2VtLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvc2Vzc2lvbi54bWwJ
CQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3NobW9wLnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlv
bnMvc25tcC54bWwJCQlDaGloaXJvIEhpZ3VjaGkKZnVuY3Rpb25zL3NvbGlkLnhtbAkJCVJ1aSBI
aXJva2F3YQpmdW5jdGlvbnMvc29ja2V0LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvc3Ry
aW5ncy54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3N3Zi54bWwJCQlSdWkgSGlyb2thd2EK
ZnVuY3Rpb25zL3N5YmFzZS54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3VvZGJjLnhtbAkJ
CVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMvdXJsLnhtbAkJCUNoaWhpcm8gSGlndWNoaQpmdW5jdGlv
bnMvdmFyLnhtbAkJCU1pY2hpaGlkZSBIb3R0YQpmdW5jdGlvbnMvdm1haWxtZ3IueG1sCQkJUnVp
IEhpcm9rYXdhCmZ1bmN0aW9ucy93ZGR4LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMveG1s
LnhtbAkJCVJ1aSBIaXJva2F3YQpmdW5jdGlvbnMveHNsdC54bWwJCQlSdWkgSGlyb2thd2EKZnVu
Y3Rpb25zL3lhei54bWwJCQlSdWkgSGlyb2thd2EKZnVuY3Rpb25zL3psaWIueG1sCQkJUnVpIEhp
cm9rYXdhCi0tLS0tLS0tIGxhbmd1YWdlIC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KbGFuZ3VhZ2UvYmFzaWMtc3ludGF4LnhtbAkJUnVp
IEhpcm9rYXdhCmxhbmd1YWdlL2NvbnN0YW50cy54bWwJCQlSdWkgSGlyb2thd2EKbGFuZ3VhZ2Uv
Y29udHJvbC1zdHJ1Y3R1cmVzLnhtbAkJUnVpIEhpcm9rYXdhCmxhbmd1YWdlL2V4cHJlc3Npb25z
LnhtbAkJUnVpIEhpcm9rYXdhCmxhbmd1YWdlL2Z1bmN0aW9ucy54bWwJCQlSdWkgSGlyb2thd2EK
bGFuZ3VhZ2Uvb29wLnhtbAkJCVJ1aSBIaXJva2F3YQpsYW5ndWFnZS9vcGVyYXRvcnMueG1sCQkJ
UnVpIEhpcm9rYXdhCmxhbmd1YWdlL3JlZmVyZW5jZXMueG1sCQkJUnVpIEhpcm9rYXdhCmxhbmd1
YWdlL3R5cGVzLnhtbAkJCVJ1aSBIaXJva2F3YQpsYW5ndWFnZS92YXJpYWJsZXMueG1sCQkJUnVp
IEhpcm9rYXdhCi0tLS0tLS0tIHBlYXIgLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KcGVhci9hYm91dC54bWwJCQkJUnVpIEhpcm9r
YXdhCnBlYXIvYmVuY2htYXJrX3RpbWVyLnhtbAkJUnVpIEhpcm9rYXdhCnBlYXIvcGVhci54bWwJ
CQkJUnVpIEhpcm9rYXdhCnBlYXIvc3RhbmRhcmRzLnhtbAkJCVJ1aSBIaXJva2F3YQotLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tCgoKCgoKCgoKCg==

--Multipart_Sat__24_Nov_2001_13:54:08_+0900_086864d0--