From d648fe92697f929ea6d557cc0e6477ec18fd796e Mon Sep 17 00:00:00 2001
From: Maciej Sobaczewski <msobaczewski@gmail.com>
Date: Sat, 31 Aug 2024 09:35:05 +0200
Subject: [PATCH] Sync with EN

---
 reference/classobj/functions/get-class.xml    | 60 +++++++------
 .../classobj/functions/get-parent-class.xml   | 85 ++++++++++---------
 2 files changed, 76 insertions(+), 69 deletions(-)

diff --git a/reference/classobj/functions/get-class.xml b/reference/classobj/functions/get-class.xml
index ec09979e..a7f407e0 100644
--- a/reference/classobj/functions/get-class.xml
+++ b/reference/classobj/functions/get-class.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7edc8853119f799d46f8e1057c49c2921c1f34d2 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 4f36c26a72c40b16e955c3c1c88041910932d0bf Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: dombal -->
 <refentry xml:id="function.get-class" xmlns="http://docbook.org/ns/docbook">
@@ -11,10 +11,10 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>get_class</methodname>
-   <methodparam choice="opt"><type>object</type><parameter>obiekt</parameter></methodparam>
+   <methodparam choice="opt"><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Zwraca nazwę klasy reprezentującej <parameter>obiekt</parameter>.
+   Zwraca nazwę klasy reprezentującej <parameter>object</parameter>.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -22,20 +22,16 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>obiekt</parameter></term>
+     <term><parameter>object</parameter></term>
      <listitem>
       <para>
-       Sprawdzany obiekt. Ten parametr może być pominięty, gdy funkcja jest wywoływana wewnątrz klasy.
+       Sprawdzany obiekt.
       </para>
       <note>
        <simpara>
-        Jawne przekazanie &null; jako <parameter>obiekt</parameter> jest niedozwolone
-        od wersji PHP 7.2.0.
-       </simpara>
-       <simpara>
-        Ten parametr wciąż jest opcjonalny i wywołanie <function>get_class</function>
-        z wewnątrz klasy, bez podania parametru, wciąż będzie działać, jednak
-        przekazanie &null; wywoła teraz komunikat <constant>E_WARNING</constant>.
+        Jawne przekazanie &null; jako <parameter>object</parameter> jest niedozwolone
+        od wersji PHP 7.2.0 i powoduje wygenerowanie ostrzeżenia (<constant>E_WARNING</constant>).
+        Od PHP 8.0.0 w przypadku użycia &null; rzucany jest <classname>TypeError</classname>.
        </simpara>
       </note>
      </listitem>
@@ -46,13 +42,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Zwraca nazwę klasy, której instancją jest <parameter>obiekt</parameter> is an.
-   Zwraca &false; jeżeli <parameter>obiekt</parameter> nie jest 
-   obiektem.
-  </para>
-  <para>
-   Jeżeli <parameter>obiekt</parameter> nie został podany podczas wywołania wewnątrz klasy,
-   zwracana jest nazwa tej klasy.
+   Zwraca nazwę klasy, której instancją jest <parameter>obiekt</parameter>.
   </para>
   <para>
    Jeżeli <parameter>obiekt</parameter> jest instancją klasy, która istnieje w przestrzeni nazw,
@@ -63,7 +53,13 @@
   &reftitle.errors;
   <para>
    Jeżeli <function>get_class</function> jest wykonywana na czymkolwiek innym niż
-   obiekcie, to generowany jest błąd <constant>E_WARNING</constant>.
+   obiekcie, rzucany jest <classname>TypeError</classname>. Przed PHP 8.0.0
+   generowane było ostrzeżenie (<constant>E_WARNING</constant>).
+  </para>
+  <para>
+   Jeżeli <function>get_class</function> zostanie wywołane bez argumentów spoza klasy,
+   rzucony zostanie <classname>Error</classname>. Przed PHP 8.0.0
+   generowane było ostrzeżenie (<constant>E_WARNING</constant>).
   </para>
  </refsect1>
  <refsect1 role="changelog">
@@ -79,18 +75,27 @@
      </thead>
      <tbody>
       <row>
-       <entry>7.2.0</entry>
+       <entry>8.3.0</entry>
        <entry>
-        &null; nie jest już domyślną wartością parametru <parameter>obiekt</parameter>,
-        i nie może być do niej przekazane.
+        Wywołanie <function>get_class</function> bez argumentu powoduje teraz wygenerowanie błędu
+        <constant>E_DEPRECATED</constant>;
+        wcześniej wywołanie tej funkcji bez parametru z wewnątrz klasy zwracało nazwę tej klasy..
+       </entry>
+      </row>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Wywołanie tej funkcji spoza klasy bez żadnych argumentów spowoduje
+        teraz rzucenie wyjątku <classname>Error</classname>.
+        Wcześniej generowane było ostrzeżenie (<constant>E_WARNING</constant>)
+        a funkcja zwracała &false;.
        </entry>
       </row>
       <row>
-       <entry>5.3.0</entry>
+       <entry>7.2.0</entry>
        <entry>
-        &null; został domyślną wartością dla parametru <parameter>obiekt</parameter>,
-        więc przekazanie &null; jako <parameter>obiekt</parameter> ma teraz taki sam
-        efekt jak nieprzekazanie żadnej wartości.
+        &null; nie jest już domyślną wartością parametru <parameter>obiekt</parameter>,
+        i nie może być do niej przekazane.
        </entry>
       </row>
      </tbody>
@@ -201,6 +206,7 @@ string(11) "Foo\Bar\Baz"
     <member><function>get_called_class</function></member>
     <member><function>get_parent_class</function></member>
     <member><function>gettype</function></member>
+    <member><function>get_debug_type</function></member>
     <member><function>is_subclass_of</function></member>
    </simplelist>
   </para>
diff --git a/reference/classobj/functions/get-parent-class.xml b/reference/classobj/functions/get-parent-class.xml
index ecb1b630..ba61aa48 100644
--- a/reference/classobj/functions/get-parent-class.xml
+++ b/reference/classobj/functions/get-parent-class.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 970d9b2e5401211c8d3fb79c9518bde3e14ec716 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 7cec82fec28b339913fe98e990e7b01f4bb97476 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: dombal -->
 <refentry xml:id="function.get-parent-class" xmlns="http://docbook.org/ns/docbook">
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>get_parent_class</methodname>
-   <methodparam choice="opt"><type>mixed</type><parameter>obiekt</parameter></methodparam>
+   <type class="union"><type>string</type><type>false</type></type><methodname>get_parent_class</methodname>
+   <methodparam choice="opt"><type class="union"><type>object</type><type>string</type></type><parameter>object_or_class</parameter></methodparam>
   </methodsynopsis>
   <para>
    Zwraca nazwę klasy rodzica dla obiektu lub klasy.
@@ -22,11 +22,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>obiekt</parameter></term>
+     <term><parameter>object_or_class</parameter></term>
      <listitem>
       <para>
-       Sprawdzany obiekt lub nazwa klasy. Parametr jest opcjonalny jeżeli
-       funkcję wywołano wewnątrz metody.
+       Sprawdzany obiekt lub nazwa klasy.
       </para>
      </listitem>
     </varlistentry>
@@ -37,40 +36,42 @@
   &reftitle.returnvalues;
   <para>
    Zwraca nazwę klasy nadrzędnej, której
-   <parameter>obiekt</parameter> jest instancją lub nazwą.
+   <parameter>object_or_class</parameter> jest instancją lub nazwą.
   </para>
-  <note>
-   <para>
-    Jeżeli klasa nie ma rodzica lub podana klasa nie istnieje, zostanie zwrócone &false;.
-   </para>
-  </note>
   <para>
-   Jeżeli funkcja została wywołana bez parametru poza obiektem, zostanie zwrócone &false;.
+   Jeżeli obiekt nie ma rodzica lub podana klasa nie istnieje,
+   zostanie zwrócone &false;
   </para>
  </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>5.1.0</entry>
-       <entry>
-        JEżeli została wywołana poza obiektem, bez określonego parametru, ta funkcja
-        zwracała &null; z ostrzeżeniem, ale teraz zwraca &false;.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.3.0</entry>
+      <entry>
+       Wywołanie <function>get_parent_class</function> bez argumentu powoduje teraz
+       wygenerowanie ostrzeżenia <constant>E_DEPRECATED</constant>;
+       wcześniej wywołanie tej funkcji wewnątrz klasy bez parametru zwracało nazwę tej klasy.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Parametr <parameter>object_or_class</parameter> akceptuje teraz tylko obiekty lub poprawne nazwy klas.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
@@ -81,22 +82,22 @@
 <![CDATA[
 <?php
 
-class dad {
-    function dad()
+class Dad {
+    function __construct()
     {
     // implementacja jakiejś logiki
     }
 }
 
-class child extends dad {
-    function child()
+class Child2 extends Dad {
+    function __construct()
     {
         echo "Jestem potomkiem klasy " , get_parent_class($this) , "\n";
     }
 }
 
-class child2 extends dad {
-    function child2()
+class Child2 extends Dad {
+    function __construct()
     {
         echo "Także jestem potomkiem klasy " , get_parent_class('child2') , "\n";
     }
@@ -111,8 +112,8 @@ $bar = new child2();
     &example.outputs;
     <screen>
 <![CDATA[
-Jestem potomkiem klasy dad
-Także jestem potomkiem klasy dad
+Jestem potomkiem klasy Dad
+Także jestem potomkiem klasy Dad
 ]]>
     </screen>
    </example>