[PHP-doc 703] 実行時設定

[大西愼一]

初めまして。
趣味でPHPスクリプトを書いている大西といいます。（本業は製造業です）

PHPの日本語マニュアルには大変お世話になっているので、お手伝いできる事
があればと思い、メーリングリストに参加する事にしました。
英語は得意ではないので、部分的な所でのお手伝いですが。
どうぞよろしくお願い致します。

で、早速なんですが、気になったところをいくつか。

log_errors　の項の注記
現）エラー表示を行う変わりに
案）エラー表示を行う代わりに
ではないでしょうか？

log_errors_max_len　の項
現）log_errorsの最大長をキロバイト単位で
案）log_errorsの最大長をバイト単位で
その少し後方で、「integerを使用する際、その値はバイト単位で」とあるので
単位が異なるのはおかしい気がします。
実際の動作は分からないのですが。（英文はどちらも bytes ですね）

log_errors_max_len　の項
現）この長さはエラーログに記録され、エラー表示と $php_errormsg に適用
　　されます。
案）この長さはエラーログへの記録、エラー表示、$php_errormsg に適用さ
　　れます。
現状ではエラーログには適用されないみたいな感じですので。


大西愼一
_______________________________________________
PHP-doc mailing list
PHP-doc@...
http://ml.php.gr.jp/mailman/listinfo/php-doc

[TAKAGI Masahiro-4]

高木です。

2008/4/27 大西愼一 <vine-mls@...>:
>
>  PHPの日本語マニュアルには大変お世話になっているので、お手伝いできる事
>  があればと思い、メーリングリストに参加する事にしました。
>  英語は得意ではないので、部分的な所でのお手伝いですが。
>  どうぞよろしくお願い致します。
>
ありがとうございます。助かります。

>  で、早速なんですが、気になったところをいくつか。
>
>  log_errors　の項の注記
>  現）エラー表示を行う変わりに
>  案）エラー表示を行う代わりに
>  ではないでしょうか？
>
ですね。直しておきました。imap_sort()関数のマニュアルにも同じミスを見
つけたので、ついでに直してあります。

>  log_errors_max_len　の項
>  現）log_errorsの最大長をキロバイト単位で
>  案）log_errorsの最大長をバイト単位で
>  その少し後方で、「integerを使用する際、その値はバイト単位で」とあるので
>  単位が異なるのはおかしい気がします。
>  実際の動作は分からないのですが。（英文はどちらも bytes ですね）
>
英文マニュアルの翻訳という観点では「キロバイト」は明らかな誤訳ですので、
直しておきました。main/main.cのphp_error_cb()関数を見る限りは、バイト
単位で間違いないはずです。

>  log_errors_max_len　の項
>  現）この長さはエラーログに記録され、エラー表示と $php_errormsg に適用
>  されます。
>  案）この長さはエラーログへの記録、エラー表示、$php_errormsg に適用さ
>  れます。
>  現状ではエラーログには適用されないみたいな感じですので。
>
確かに意味合い的におかしいですね。文言を多少変更させていただいたうえで
反映させていただきました。

以上の修正については、すでにソースの更新を済ませています。
 - http://news.php.net/php.doc.ja/2321 ... ご指摘いただいたもの
 - http://news.php.net/php.doc.ja/2320 ... 同じミスの修正 :-(

私の手元の環境ではすでに反映されています。
 - http://phpdoc.m-takagi.org/errorfunc.configuration.html

php.net 本家のマニュアル
 - http://www.php.net/manual/ja/errorfunc.configuration.php
は、おそらく一週間後くらいには更新されるでしょう。

一方
 - http://docs.php.net/manual/ja/errorfunc.configuration.php
は、今日中にでも更新されるはずです。

--
TAKAGI Masahiro mailto:matakagi@...
_______________________________________________
PHP-doc mailing list
PHP-doc@...
http://ml.php.gr.jp/mailman/listinfo/php-doc

[大西愼一]

大西です。
早速のご対応、ありがとうございます。

> ありがとうございます。助かります。
訳者さんの仕事に文句を言っているだけのようで心苦しいですが...
お役に立てれば幸いです。


> 以上の修正については、すでにソースの更新を済ませています。
>  - http://news.php.net/php.doc.ja/2321 ... ご指摘いただいたもの
>  - http://news.php.net/php.doc.ja/2320 ... 同じミスの修正 :-(
見せていただきました。

日本語でもソースの段階で、一つのパラグラフ内で改行とインデントの為の
空白が挿入されているんですね。マニュアルの仕様なんでしょうか？

個人的には、マニュアルの所々にある不要な空白が気になって仕方ないです。
見苦しいというか、読み難いというか...
ＭＬのどこかで話題になっていたような気もしますが、当方の環境では
過去のメールの検索（Not Found になります）も、ダウンロード版も
（圧縮テキストの展開が出来ない）ので探せないでいます。

単語を空白文字で区切らない言語と、連続する空白文字を１つと見なすHTML
の仕様（？）を利用したインデントとは、相容れない仲のように思うのです。
構造と内容を分離しているのに、不要なものをわざわざ追加してコンテナに
押し込んでいるようで...

コンパイル（？）をするのなら、paraタグ内のマルチバイト文字直前の
連続する空白文字（改行、スペース、タブ）は削除してくれればいいのに
って...チョッと暴走気味ですね。
ごみレスごめんなさい。

大西愼一
_______________________________________________
PHP-doc mailing list
PHP-doc@...
http://ml.php.gr.jp/mailman/listinfo/php-doc

[TAKAGI Masahiro-4]

高木です。

2008/4/28 大西愼一 <vine-mls@...>:
> 大西です。
>  早速のご対応、ありがとうございます。
>
>  > ありがとうございます。助かります。
>  訳者さんの仕事に文句を言っているだけのようで心苦しいですが...
>  お役に立てれば幸いです。
>
反応が一切ないというほうがよっぽどつらいので、むしろどんどん文句をつけて
くださったほうが個人的にはありがたいです :-)

>
>
>  > 以上の修正については、すでにソースの更新を済ませています。
>  >  - http://news.php.net/php.doc.ja/2321 ... ご指摘いただいたもの
>  >  - http://news.php.net/php.doc.ja/2320 ... 同じミスの修正 :-(
>  見せていただきました。
>
>  日本語でもソースの段階で、一つのパラグラフ内で改行とインデントの為の
>  空白が挿入されているんですね。マニュアルの仕様なんでしょうか？
>
>  個人的には、マニュアルの所々にある不要な空白が気になって仕方ないです。
>  見苦しいというか、読み難いというか...

HTMLに変換した際にパラグラフ内の改行部が空白になってしまうのは現在のビル
ドシステムの仕様ですね……。どうしても空白を避けようと思えばひとつのパラ
グラフ内では改行を使わず一行で書いてしまうという手もあるのですが、そうす
ると、たとえば http://news.php.net/php.doc.ja/2321 などのように更新内容
を差分で確認しようとしたときに、どこが変わったのかが把握しにくいという問
題が出てきます。

とりあえずの妥協策として、新たに翻訳するドキュメントでは
 - 句読点の直後
 - 文節の切れ目
 - 英数字と (いわゆる) 全角文字との間
などで改行をいれるようにして、できるだけ違和感がないようにしています。

ただ、昔から存在する翻訳についてはまだそこまで配慮が行き届いていないもの
も多くあります。今回ご指摘いただいたページのソースもそのひとつですね。

>  ＭＬのどこかで話題になっていたような気もしますが、当方の環境では
>  過去のメールの検索（Not Found になります）も、ダウンロード版も
>  （圧縮テキストの展開が出来ない）ので探せないでいます。
>
過去メールの検索については「Googleがあるし、もういらないんじゃない？」と
いった経緯があったような気がします。たぶん phpug-admin の数年前のアーカ
イブを探してみればそのときの議論を見ることができるはずです。

>  単語を空白文字で区切らない言語と、連続する空白文字を１つと見なすHTML
>  の仕様（？）を利用したインデントとは、相容れない仲のように思うのです。
>  構造と内容を分離しているのに、不要なものをわざわざ追加してコンテナに
>  押し込んでいるようで...
>
>  コンパイル（？）をするのなら、paraタグ内のマルチバイト文字直前の
>  連続する空白文字（改行、スペース、タブ）は削除してくれればいいのに
>  って...チョッと暴走気味ですね。
>  ごみレスごめんなさい。
>

あ、そうか。そういう手があったのか!
実はマニュアルをビルドする仕組みもすべてオープンソースで公開されているの
で、もしかしたらそのような仕組みをうまく組み込めるかもしれません。

 http://cvs.php.net/viewvc.cgi/phd/

連休中にでもちょっと見てみようかな……

--
TAKAGI Masahiro mailto:matakagi@...
_______________________________________________
PHP-doc mailing list
PHP-doc@...
http://ml.php.gr.jp/mailman/listinfo/php-doc

[大西愼一]

大西です。

> 反応が一切ないというほうがよっぽどつらいので、むしろどんどん文句をつけて
> くださったほうが個人的にはありがたいです :-)
はい。がんばります。後程、別なのを提出します。


> あ、そうか。そういう手があったのか!
> 実はマニュアルをビルドする仕組みもすべてオープンソースで公開されているの
> で、もしかしたらそのような仕組みをうまく組み込めるかもしれません。
>
>  http://cvs.php.net/viewvc.cgi/phd/
僕も覗いてみようと思ったのですけれど、これのどこを見ればいいのか...
うまくいくといいですね。
_______________________________________________
PHP-doc mailing list
PHP-doc@...
http://ml.php.gr.jp/mailman/listinfo/php-doc