Sync with EN

Author: Sobak

language/context/http.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: e7b81f2c31e6b824748eeb8106b8bd4dec386781 Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
 
 <refentry xml:id="context.http" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
@@ -50,6 +50,13 @@
        Dlatego nie zaleca się ustawiania nagłówka <literal>Host:</literal>,
        jeśli włączona jest opcja <parameter>follow_location</parameter>.
       </para>
+      <para>
+       Wartość tekstowa powinna być parami <literal>Klucz: wartość</literal> oddzielonymi przy
+       pomocy <literal>\r\n</literal>, np.
+       <literal>"Content-Type: application/json\r\nConnection: close"</literal>.
+       Wartość tablicowa powinna być listą par <literal>Klucz: wartość</literal>, np.
+       <literal>["Content-Type: application/json", "Connection: close"]</literal>.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="context.http.user-agent">

language/oop5/basic.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2f85d57a0b5a01b875cbca2b291f04389cf61ac2 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: sobak Status: ready -->
 
  <sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
   <title>Podstawy</title>
@@ -224,11 +224,16 @@ readonly class Foo
     <programlisting role="php">
 <![CDATA[
 <?php
+class ProstaKlasa {
+}
+
 $obiekt = new ProstaKlasa();
+var_dump($obiekt);
 
 // Można też użyć zmiennej:
 $nazwaKlasy = 'ProstaKlasa';
 $obiekt = new $nazwaKlasy(); // new ProstaKlasa()
+var_dump($obiekt);
 ?>
 ]]>
     </programlisting>
@@ -296,6 +301,12 @@ object(ClassD)#1 (0) {
     <programlisting role="php">
 <![CDATA[
 <?php
+ing role="php">
+<![CDATA[
+<?php
+class ProstaKlasa {
+    public string $var;
+}
 
 $instancja = new ProstaKlasa();
 
@@ -375,16 +386,17 @@ bool(true)
     <programlisting role="php">
 <![CDATA[
 <?php
-echo (new DateTime())->format('Y');
+echo (new DateTime())->format('Y'), PHP_EOL;
 // okalające nawiasy są opcjonalne od PHP 8.4.0
-echo new DateTime()->format('Y');
+echo new DateTime()->format('Y'), PHP_EOL;
 ?>
 ]]>
     </programlisting>
     &example.outputs.similar;
     <screen>
 <![CDATA[
-2016
+2025
+2025
 ]]>
     </screen>
    </example>
@@ -498,6 +510,14 @@ echo ($obj->bar)(), PHP_EOL;
     <programlisting role="php">
 <![CDATA[
 <?php
+class ProstaKlasa
+{
+    function wyswietlWlasciwosc()
+    {
+        echo "Klasa rodzica\n";
+    }
+}
+
 class RozszerzKlase extends ProstaKlasa
 {
     // Zdefiniuj metodę rodzica na nowo
@@ -757,9 +777,10 @@ Klasa\Nie\Istnieje
 namespace NS {
     class NazwaKlasy {
     }
+    
+    $c = new NazwaKlasy();
+    print $c::class;
 }
-$c = new NazwaKlasy();
-print $c::class;
 ?>
 ]]>
     </programlisting>
@@ -788,7 +809,7 @@ NS\NazwaKlasy
   <para>
    <example>
     <title>Operator nullsafe</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 

language/operators/assignment.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 43d07782b514d0c7a8487f2c74063739f302df8d	 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284	 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.operators.assignment">
  <title>Operatory przypisania</title>
  <titleabbrev>Przypisania</titleabbrev>
@@ -13,37 +13,38 @@
   Wartością wyrażenia przypisania jest przypisywana wartość. Oznacza to,
   że wartością wyrażenia "<literal>$a = 3</literal>" jest 3. Pozwala to na kilka sprytnych
   rzeczy:
-  <informalexample>
+  <example>
+   <title>Zagnieżdżone przypisania</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-
 $a = ($b = 4) + 5; // $a jest teraz równe 9, a $b zostało ustawione na 4.
-
+var_dump($a);
 ?>
 ]]>
    </programlisting>
-  </informalexample>
+  </example>
  </para>
  <para>
   Poza podstawowym operatorem przypisania istnieją też "operatory
   łączone" dla wszystkich operatorów <link linkend="language.operators">arytmetycznych</link>,
   unii tablic i operatorów ciągów znaków, które pozwalają użyć wartości w
   wyrażeniu i potem ustawić tę wartość jako wynik tego wyrażenia. Przykładowo:
-  <informalexample>
+  <example>
+   <title>Przypisania połączone</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-
 $a = 3;
 $a += 5; // ustawia $a na 8, jak gdybyśmy napisali: $a = $a + 5;
 $b = "Cześć ";
 $b .= "wszystkim!"; // ustawia $b na "Cześć wszystkim!", zupełnie jak $b = $b . "wszystkim!";
 
+var_dump($a, $b);
 ?>
 ]]>
    </programlisting>
-  </informalexample>
+  </example>
  </para>
  <para>
   Zauważ, że przypisanie kopiuje oryginalną zmienną do nowej
@@ -94,7 +95,8 @@ print "$b\n"; // także wyświetla 4, ponieważ $b jest referencją do $a, któr
    <link linkend="language.oop5.basic.new">new</link> przez referencję jest błędem.
   </para>
   <para>
-   <informalexample>
+   <example>
+    <title>Operator new przez referencję</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -107,10 +109,10 @@ $o = &new C;
     &example.outputs;
     <screen>
 <![CDATA[
-Parse error: syntax error, unexpected 'new' (T_NEW) in …
+Parse error: syntax error, unexpected token ";", expecting "("
 ]]>
     </screen>
-   </informalexample>
+   </example>
   </para>
   <para>
    Więcej informacji o referencjach i sytuacjach gdy mogą być przydatne

language/operators/bitwise.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934	 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284	 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.operators.bitwise">
  <title>Operatory bitowe</title>
  <titleabbrev>Bitowe</titleabbrev>
@@ -98,17 +98,15 @@
   Zarówno operand jak i wynik operatorów <literal>&lt;&lt;</literal> i
   <literal>&gt;&gt;</literal> są zawsze traktowane jak liczby.
  </para>
+ <para>
+  Ustawienie ini error_reporting języka PHP używa wartości bitowych,
+  co jest przykładem z życia dla wyłączania
+  bitów. Aby pokazać wszystkie błędy z wyjątkiem komunikatów (notice),
+  instrukcje w pliku php.ini mówią, aby użyć:
+  <userinput>E_ALL &amp; ~E_NOTICE</userinput>
+ </para>
  <para>
   <informalexample>
-   <para>
-    <literallayout>
-     Ustawienie ini error_reporting języka PHP używa wartości bitowych,
-     co jest przykładem z życia dla wyłączania
-     bitów. Aby pokazać wszystkie błędy z wyjątkiem komunikatów (notice),
-     instrukcje w pliku php.ini mówią, aby użyć:
-     <userinput>E_ALL &amp; ~E_NOTICE</userinput>
-    </literallayout>
-   </para>
    <para>
     <literallayout>
      Opiera się to o wzięcie wartości E_ALL:
@@ -122,24 +120,20 @@
      <computeroutput>00000000000000000111011111110111</computeroutput>
     </literallayout>
    </para>
-   <para>
-    <literallayout>
-     Innym sposobem aby to osiągnąć jest użycie XOR (<literal>^</literal>),
-     aby znaleźć bity które są tylko w jednej lub w drugiej wartości:
-     <userinput>E_ALL ^ E_NOTICE</userinput>
-    </literallayout>
-   </para>
   </informalexample>
  </para>
+ <para>
+  Innym sposobem, aby to osiągnąć, jest użycie XOR (<literal>^</literal>),
+  aby znaleźć bity, które są tylko w jednej lub w drugiej wartości:
+  <userinput>E_ALL ^ E_NOTICE</userinput>
+ </para>
+ <para>
+  error_reporting może być użyte też do zademonstrowania włączania bitów.
+  Aby pokazać błędy i odzyskiwalne błędy można użyć::
+  <userinput>E_ERROR | E_RECOVERABLE_ERROR</userinput>
+ </para>
  <para>
   <informalexample>
-   <para>
-    <literallayout>
-     error_reporting może być użyte też do zademonstrowania włączania bitów.
-     Aby pokazać błędy i odzyskiwalne błędy można użyć::
-     <userinput>E_ERROR | E_RECOVERABLE_ERROR</userinput>
-    </literallayout>
-   </para>
    <para>
     <literallayout>
      Ten proces łączy E_ERROR
@@ -237,19 +231,19 @@ foreach ($values as $value) {
    <programlisting role="php">
 <![CDATA[
 <?php
-echo 12 ^ 9; // Wyświetla '5'
+echo 12 ^ 9, PHP_EOL;  // Wyświetla '5'
 
-echo "12" ^ "9"; // Wyświetla znak Backspace (ascii 8)
-                 // ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8
+echo "12" ^ "9", PHP_EOL; // Wyświetla znak Backspace (ascii 8)
+                          // ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8
 
-echo "hallo" ^ "hello"; // Wyświetla wartości ascii #0 #4 #0 #0 #0
-                        // 'a' ^ 'e' = #4
+echo "hallo" ^ "hello", PHP_EOL; // Wyświetla wartości ascii #0 #4 #0 #0 #0
+                                 // 'a' ^ 'e' = #4
 
-echo 2 ^ "3"; // Wyświetla 1
-              // 2 ^ ((int) "3") == 1
+echo 2 ^ "3", PHP_EOL; // Wyświetla 1
+                       // 2 ^ ((int) "3") == 1
 
-echo "2" ^ 3; // Wyświetla 1
-              // ((int) "2") ^ 3 == 1
+echo "2" ^ 3, PHP_EOL; // Wyświetla 1
+                       // ((int) "2") ^ 3 == 1
 ?>
 ]]>
    </programlisting>
@@ -369,7 +363,7 @@ function p($res, $val, $op, $places, $note = '') {
         echo " UWAGI: $note\n";
     }
 
-    echo "\n";
+    echo "\n\n";
 }
 ?>
 ]]>

language/operators/comparison.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58	 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284	 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.operators.comparison">
  <title>Operatory porównania</title>
  <titleabbrev>Porównania</titleabbrev>
@@ -147,58 +147,59 @@ a
  </warning>
 
  <para>
-  <informalexample>
+  <example>
+   <title>Operatory porównania</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 // Liczby całkowite
-echo 1 <=> 1; // 0
-echo 1 <=> 2; // -1
-echo 2 <=> 1; // 1
+echo 1 <=> 1, ' '; // 0
+echo 1 <=> 2, ' '; // -1
+echo 2 <=> 1, ' '; // 1
 
 // Liczy zmiennoprzecinkowe
-echo 1.5 <=> 1.5; // 0
-echo 1.5 <=> 2.5; // -1
-echo 2.5 <=> 1.5; // 1
+echo 1.5 <=> 1.5, ' '; // 0
+echo 1.5 <=> 2.5, ' '; // -1
+echo 2.5 <=> 1.5, ' '; // 1
 
 // Ciągi znaków
-echo "a" <=> "a"; // 0
-echo "a" <=> "b"; // -1
-echo "b" <=> "a"; // 1
+echo "a" <=> "a", ' '; // 0
+echo "a" <=> "b", ' '; // -1
+echo "b" <=> "a", ' '; // 1
 
-echo "a" <=> "aa"; // -1
-echo "zz" <=> "aa"; // 1
+echo "a" <=> "aa", ' ';  // -1
+echo "zz" <=> "aa", ' '; // 1
 
 // Tablice
-echo [] <=> []; // 0
-echo [1, 2, 3] <=> [1, 2, 3]; // 0
-echo [1, 2, 3] <=> []; // 1
-echo [1, 2, 3] <=> [1, 2, 1]; // 1
-echo [1, 2, 3] <=> [1, 2, 4]; // -1
+echo [] <=> [], ' ';               // 0
+echo [1, 2, 3] <=> [1, 2, 3], ' '; // 0
+echo [1, 2, 3] <=> [], ' ';        // 1
+echo [1, 2, 3] <=> [1, 2, 1], ' '; // 1
+echo [1, 2, 3] <=> [1, 2, 4], ' '; // -1
 
 // Obiekty
 $a = (object) ["a" => "b"];
 $b = (object) ["a" => "b"];
-echo $a <=> $b; // 0
+echo $a <=> $b, ' '; // 0
 
 $a = (object) ["a" => "b"];
 $b = (object) ["a" => "c"];
-echo $a <=> $b; // -1
+echo $a <=> $b, ' '; // -1
 
 $a = (object) ["a" => "c"];
 $b = (object) ["a" => "b"];
-echo $a <=> $b; // 1
+echo $a <=> $b, ' '; // 1
 
 // porównywane są nie tylko wartości, klucze też muszą się zgadzać
 $a = (object) ["a" => "b"];
 $b = (object) ["b" => "b"];
-echo $a <=> $b; // 1
+echo $a <=> $b, ' '; // 1
 
 ?>
 ]]>
 
    </programlisting>
-  </informalexample>
+  </example>
  </para>
 
  <para>
@@ -281,7 +282,7 @@ var_dump(min(-100, -10, NULL, 10, 100)); // NULL - (bool) NULL < (bool) -100 tj.
  <para>
   <example>
    <title>Transkrypcja standardowych reguł porównań tablic</title>
-   <programlisting role="php">
+   <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 // Tablice są porównywane w ten sposób dla standardowych operatorów porównań, a także dla operatora