[PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) #191

o0h · 2024-11-24T06:24:24Z

Issue

Refs

概ね、移行ガイドのdeprecate.xmlの内容を踏まえました。

doc-ja/appendices/migration84/deprecated.xml

Lines 148 to 152 in c378f9b

    
           <simpara> 
        
            <function>trigger_error</function> で 
        
            <parameter>error_level</parameter> として 
        
            <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。 
        
           </simpara>

オリジナル(en)では、

migration: Calling trigger_error with error_level being equal to E_USER_ERROR is now deprecated.
reference: Passing E_USER_ERROR as the error_level is now deprecated.

であり、やや表現が異なる箇所ですが、強調すべき内容的な差異は無いだろうという判断です。

ref: php/doc-en@72b70d7

o0h · 2024-11-24T15:37:19Z

reference/errorfunc/functions/trigger-error.xml

@@ -129,6 +155,7 @@ if ($divisor == 0) {
    <member><function>set_error_handler</function></member>
    <member><function>restore_error_handler</function></member>
    <member><link linkend="errorfunc.constants">エラーレベル定数</link></member>
+    <member><classname>Deprecated</classname> アトリビュート</member>


他の箇所でも「アトリビュート」「属性」の訳語が揺れていそうで、一旦「アトリビュート」にしています。
migrationの表記は以下

doc-ja/appendices/migration84/new-features.xml

Lines 130 to 136 in c378f9b

<simpara>

新しい <classname>Deprecated</classname> 属性を使用して、関数、メソッド、

およびクラス定数を非推奨としてマークできます。このアトリビュートで非推奨となった機能の動作は、

PHP 自身が提供する既存の非推奨メカニズムの動作と一致します。

唯一の例外は、発生するエラーコードが

<constant>E_DEPRECATED</constant> ではなく <constant>E_USER_DEPRECATED</constant> であることです。

</simpara>

👍

ありがとうございます！私も アトリビュート が良いと思います。

普通名詞の意味の「属性」ではなく、固有シンタックスを指していることが明確にわかりますね。
（8.4から離れてしまいますが、見つけた箇所はプルリク作成いただいて大丈夫です。私も見つけ次第修正していきます。）

o0h · 2024-11-24T15:38:27Z

reference/errorfunc/functions/trigger-error.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 210d382b5b139444fe2e16a5a3211076a65ff2ba Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 72b70d7c3c3b2b87423641906da2db407c32c3c3 Maintainer: hirokawa Status: ready -->


php/doc-en@72b70d7

o0h · 2024-11-24T15:39:32Z

reference/errorfunc/functions/trigger-error.xml

+    かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+    <function>exit</function> を呼び出してください。
+   </simpara>
+  </warning>


訳はLGTMです。位置なのですが、この <warning> セクションは:

原文: <para>The designated error type ...</para>
訳文: <para>このエラーに割り当てられた...</para>

この要素のすぐ下に追加されているようです。

o0h · 2024-11-24T15:40:06Z

reference/errorfunc/functions/trigger-error.xml

+       戻り値の型が、<type>bool</type> ではなく
+       <type>true</type> に変更されました。
+      </entry>
+     </row>


o0h · 2024-11-24T15:40:38Z

reference/errorfunc/functions/trigger-error.xml

 }
+$hash = password_hash($password, PASSWORD_DEFAULT);
 ?>
 ]]>
    </programlisting>


o0h · 2024-11-24T15:53:58Z

表示を確認するの面倒くさいかな？と思ってビルド結果から変更箇所のスクショを貼ってみましたが、
doc(xml)のレビューをする際には邪魔だったかも知れません。適宜、削除していただいて大丈夫です 👌

KentarouTakeda

ありがとうございます！役はLGTMです。
xmlの構造のみ確認をお願いします。

やや表現が異なる箇所ですが、強調すべき内容的な差異は無いだろうという判断です。

はい、問題ないと思います、むしろありがとうございます！
今回くらいの言い換えは、他の場所でも比較的日常的に行われてます。
（それをやらないと日本語として逆におかしい、というような箇所なども）

KentarouTakeda · 2024-11-25T04:15:54Z

reference/errorfunc/functions/trigger-error.xml

+    かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+    <function>exit</function> を呼び出してください。
+   </simpara>
+  </warning>


訳はLGTMです。位置なのですが、この <warning> セクションは:

原文: <para>The designated error type ...</para>
訳文: <para>このエラーに割り当てられた...</para>

この要素のすぐ下に追加されているようです。

KentarouTakeda · 2024-11-25T04:16:06Z

reference/errorfunc/functions/trigger-error.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 210d382b5b139444fe2e16a5a3211076a65ff2ba Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 72b70d7c3c3b2b87423641906da2db407c32c3c3 Maintainer: hirokawa Status: ready -->


KentarouTakeda · 2024-11-25T04:20:51Z

reference/errorfunc/functions/trigger-error.xml

@@ -129,6 +155,7 @@ if ($divisor == 0) {
    <member><function>set_error_handler</function></member>
    <member><function>restore_error_handler</function></member>
    <member><link linkend="errorfunc.constants">エラーレベル定数</link></member>
+    <member><classname>Deprecated</classname> アトリビュート</member>


👍

ありがとうございます！私も アトリビュート が良いと思います。

普通名詞の意味の「属性」ではなく、固有シンタックスを指していることが明確にわかりますね。
（8.4から離れてしまいますが、見つけた箇所はプルリク作成いただいて大丈夫です。私も見つけ次第修正していきます。）

o0h · 2024-11-25T12:10:18Z

@KentarouTakeda
失礼しました・・！
修正して、表示位置がこんな感じになります (php.net に出ているenとの比較)

KentarouTakeda

ありがとうございます！お手数おかけしました！

[WIP] work on php/doc-en#4063

899361f

o0h force-pushed the trigger-error-8.4 branch from 63367eb to 899361f Compare November 24, 2024 06:28

o0h added 2 commits November 25, 2024 00:18

php#191 Insert original content

5d6470f

ref: php/doc-en@72b70d7

php#191 Translate

c09c0ce

o0h commented Nov 24, 2024

View reviewed changes

o0h changed the title ~~[WIP] [PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates)~~ [PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) Nov 24, 2024

o0h marked this pull request as ready for review November 24, 2024 15:44

KentarouTakeda requested changes Nov 25, 2024

View reviewed changes

KentarouTakeda mentioned this pull request Nov 25, 2024

PHP 8.4 マニュアル翻訳状況 #150

Open

php#194 Fix element position

dae9dfe

o0h requested a review from KentarouTakeda November 25, 2024 12:10

KentarouTakeda approved these changes Nov 25, 2024

View reviewed changes

KentarouTakeda merged commit 2d5c271 into php:master Nov 25, 2024
1 check passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) #191

[PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) #191

o0h commented Nov 24, 2024 •

edited

Loading

o0h Nov 24, 2024

o0h Nov 24, 2024

KentarouTakeda Nov 25, 2024

o0h Nov 24, 2024

KentarouTakeda Nov 25, 2024

o0h Nov 24, 2024

KentarouTakeda Nov 25, 2024

o0h Nov 24, 2024

o0h Nov 24, 2024

o0h commented Nov 24, 2024

KentarouTakeda left a comment

KentarouTakeda Nov 25, 2024

KentarouTakeda Nov 25, 2024

KentarouTakeda Nov 25, 2024

o0h commented Nov 25, 2024

KentarouTakeda left a comment

	<simpara>
	<function>trigger_error</function> で
	<parameter>error_level</parameter> として
	<constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
	</simpara>

	<simpara>
	新しい <classname>Deprecated</classname> 属性を使用して、関数、メソッド、
	およびクラス定数を非推奨としてマークできます。このアトリビュートで非推奨となった機能の動作は、
	PHP 自身が提供する既存の非推奨メカニズムの動作と一致します。
	唯一の例外は、発生するエラーコードが
	<constant>E_DEPRECATED</constant> ではなく <constant>E_USER_DEPRECATED</constant> であることです。
	</simpara>

[PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) #191

[PHP 8.4] fix php/doc-en#4063 (PHP 8.4: trigger_error() updates) #191

Conversation

o0h commented Nov 24, 2024 • edited Loading

Issue

Refs

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

o0h commented Nov 24, 2024

KentarouTakeda left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

o0h commented Nov 25, 2024

KentarouTakeda left a comment

Choose a reason for hiding this comment

o0h commented Nov 24, 2024 •

edited

Loading