[PHP-doc 1077] Re: OPcacheのマニュアル修正提案

[Satoru Yoshida]

吉田です

＞# 念のためにと grep "向こう" してみたら別件でちょっとひどい誤訳を
＞# 見つけてしまったので、そちらもあわせて修正しておきました。

slightly beyond the scope of this section
の箇所を含め、該当の記事を訳したものです。
意訳すると、あとあと英語原文の修正が行われた際の
日本語訳の更新箇所を探すのが困難になることを心配していました。
あえて直訳にしておいたことを発言させていただきます。

あえて直訳で残す、という配慮は不要と理解しました。

----- TAKAGI Masahiro <matakagi ＠ gmail.com>さんが書いたメッセージ：
>高木です。
>
>2016-11-06 13:57 GMT+09:00 Yoshio Hanawa <y ＠ hnw.jp>:
>> はなわです。連日すみません。
>>
>> OPcacheのマニュアルをざっと見ていて気になった点を数点報告します。
>>
>> ●http://php.net/manual/ja/function.opcache-invalidate.php
>>
>>> スクリプトが変更された時間が opcode をキャッシュした時間より新しい場合にだけ無効にします。
>>
>> とありますが意図が取りにくいように感じました。
>>
>>> スクリプトの更新時刻がopcodeキャッシュ時の更新時刻より新しい場合にだけ無効にします。
>
>ずっとわかりやすくなりますね。そのままいただきました。
>
>>
>> くらいでしょうか。
>>
>> また、返り値の説明のところで「invalidate」と「disabled」が両方「無効にされる」と訳されていて混乱の元だと感じましたが、残念ながら良い訳は思いつきませんでした。どちらも単体で見れば自然だと思うのでなかなか難しいですね。
>
>"disable"のほうを少し補足して
>> opcode キャッシュ機能そのものが無効にされている場合は FALSE を返します。
>としておきました。
>他のopcache関数群の戻り値の説明とは若干違う記述になってしまいますが、
>まあしかたがないということで。
>
>>
>> ●http://php.net/manual/ja/function.opcache-reset.php
>>
>>> opcode キャッシュが向こうにされている場合は FALSE を返します。
>>
>> とありますが
>>
>>> opcode キャッシュが無効にされている場合は FALSE を返します。
>
>これはひどいですね。直しておきました。
>
># 念のためにと grep "向こう" してみたら別件でちょっとひどい誤訳を
># 見つけてしまったので、そちらもあわせて修正しておきました。
># http://news.php.net/php.doc.ja/4597
>
>
>>
>> ですね。
>>
>> ●http://php.net/manual/ja/opcache.configuration.php#ini.opcache.file-cache
>>
>>> 第二レベルのキャッシュディレクトリを有効にして設定します。 これは、SHM メモリがいっぱいになった場合やサーバーを再起動した場合、 そして SHM
>>> をリセットした場合のパフォーマンスを向上させます。 デフォルトは "" で、これはファイルベースのキャッシュを無効にします。
>>
>> これ、元の英文がひときわアレな感じでなかなか翻訳が難しいですね。
>>
>> 元の英文で「SHM memory」って書いてあるんですが、SHMはshared
>> memoryの意味しかないと思うので、無理して残しておく必要は無いんじゃないかと思います。
>>
>> また、「セカンドレベルキャッシュ」の方がコンピュータ用語としては受け入れられているように思います。
>>
>> そんなわけで、かなり派手に補って訳文を考えてみました。
>>
>>>
>>> ファイルベースのセカンドレベルopcodeキャッシュを有効にし、そのディレクトリを設定します。これは共有メモリ上のopcodeキャッシュがいっぱいの時やサーバ再起動時、もしくは共有メモリ上のopcodeキャッシュをリセットした場合のパフォーマンスを向上させます。デフォルトは
>>> "" で、これはファイルベースのキャッシュを無効にします。
>>
>> やりすぎかもしれませんが、あくまで提案ということで…
>
>こちらについてもそのままいただきました。
>
>というわけで、今回お知らせいただいた案については
> http://news.php.net/php.doc.ja/4596
>で対応いたしました。ありがとうございました。
>
>>
>> 以上です。よろしくお願いします。
>>
>> _______________________________________________
>> PHP-doc mailing list
>> PHP-doc ＠ php.gr.jp
>> http://ml.php.gr.jp/mailman/listinfo/php-doc
>>
>
>
>
>-- 
>TAKAGI Masahiro mailto:matakagi ＠ gmail.com
>_______________________________________________
>PHP-doc mailing list
>PHP-doc ＠ php.gr.jp
>http://ml.php.gr.jp/mailman/listinfo/php-doc