Sync with EN

Sobak · Sobak · commit 756e3c51ff17 · 2025-02-17T04:31:51.000+01:00
diff --git a/language/basic-syntax.xml b/language/basic-syntax.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6b09bb638aa64d1fad5f4a630a8da9a2692ce733 Maintainer: cyb0org Status: ready -->
+<!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: cyb0org Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: adi, sobak -->
  <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook">
@@ -233,8 +233,8 @@ Ale teraz już z nową linią
    </para>
    <simpara>
     Komentarze w stylu 'C' kończą się na pierwszym napotkanym <literal>*/</literal>.
-    Upewnij się, że nie zagnieżdzasz komentarzy w stylu 'C'. Łatwo jest popełnić
-    pomyłkę jeśli próbujesz odkomentować duży blok kodu.
+    Upewnij się, że nie zagnieżdżasz komentarzy w stylu 'C'. Łatwo jest popełnić
+    pomyłkę, jeśli próbujesz odkomentować duży blok kodu.
    </simpara>
    <para>
     <informalexample>
diff --git a/language/control-structures/alternative-syntax.xml b/language/control-structures/alternative-syntax.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a41057cbdf053fd8c3a3bec6f1bbf113ffec8e42 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <sect1 xml:id="control-structures.alternative-syntax"  xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -69,7 +69,7 @@ endif;
 <![CDATA[
 <?php switch ($foo): ?>
     <?php case 1: ?>
-    ...
+    // ...
 <?php endswitch; ?>
 ]]>
    </programlisting>
diff --git a/language/control-structures/elseif.xml b/language/control-structures/elseif.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bbaf4fea6946bf6d0b67573d5f2f96c5a2c5d678 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <sect1 xml:id="control-structures.elseif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -75,8 +75,14 @@ if ($a > $b):
 else if ($a == $b): // Nie zostanie skompilowane.
     echo "Powyższa linia powoduje błąd parsera.";
 endif;
+]]>
+   </programlisting>
+  </informalexample>
 
-
+  <informalexample>
+   <programlisting role="php">
+    <![CDATA[
+<?php
 /* Poprawna metoda: */
 if ($a > $b):
     echo $a." jest większe niż ".$b;
diff --git a/language/control-structures/match.xml b/language/control-structures/match.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6507fc94c2d0a0e65ee9486a98e9135f34220ae7 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
 
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -89,8 +89,9 @@ string(8) "Teenager"
   </note>
   <note>
    <simpara>
-    Wyrażenie <literal>match</literal> <emphasis>musi</emphasis> być
-    zakończone średnikiem <literal>;</literal>.
+    Kiedy wrażenie <literal>match</literal> jest używane jako samodzielne
+    wyrażenie, to <emphasis>musi</emphasis> być zakończone
+    średnikiem <literal>;</literal>.
    </simpara>
   </note>
  </example>
@@ -139,8 +140,8 @@ string(8) "Teenager"
 <![CDATA[
 <?php
 $result = match ($x) {
-    foo() => ...,
-    $this->bar() => ..., // $this->bar() nie jest wywoływane, jeśli foo() === $x
+    foo() => 'wartość',
+    $this->bar() => 'wartość', // $this->bar() nie jest wywoływane, jeśli foo() === $x
     $this->baz => beep(), // beep() nie jest wywoływane, chyba że $x === $this->baz
     // etc.
 };
diff --git a/language/control-structures/require.xml b/language/control-structures/require.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 84b8fca68fc762fefe85acde180a38b2e77a28b9 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 30c0106d51ac2786b81b27709ca88f1daf07e716 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <sect1 xml:id="function.require" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -8,10 +8,10 @@
  
  <para>
   <literal>require</literal> działa identycznie jak <function>include</function>,
-  z tą różnicą, że w razie błędu generuje <constant>E_COMPILE_ERROR</constant>.
-  Innymi słowy, skrypt zostanie zatrzymany, podczas gdy
-  <function>include</function> wywoła jedynie ostrzeżenie
-  (<constant>E_WARNING</constant>), które pozwala na kontynuowanie skryptu.
+  z tą różnicą, że w razie błędu rzuca wyjątek <classname>Error</classname>
+  (błąd o poziomie <constant>E_COMPILE_ERROR</constant> przed
+  PHP 8.0.0) podczas gdy <function>include</function> wywoła jedynie ostrzeżenie
+  (<constant>E_WARNING</constant>).
  </para>
  <para>
   Zobacz dokumentację <function>include</function>, aby dowiedzieć się więcej.
diff --git a/language/exceptions.xml b/language/exceptions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: sobak Status: ready -->
+<!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook">
  <title>Wyjątki</title>
diff --git a/language/functions.xml b/language/functions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: ae8e5c871b1a71ea77f5b97f7929d76d4ca724ab Maintainer: sobak Status: ready -->
+<!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: sobak Status: ready -->
 <!-- CREDITS: cyb0org, pirate -->
  <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Funkcje</title>
diff --git a/language/oop5/autoload.xml b/language/oop5/autoload.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7befd9af043386158ef9080723eb18e03f0625c7 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: sobak Status: ready -->
  <sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook">
   <title>Autoloading klas</title>
   <para>
@@ -95,7 +95,7 @@ Fatal error: Interface 'ITest' not found in ...
 <?php
 require __DIR__ . '/vendor/autoload.php';
 
-$uuid = new Ramsey\Uuid\Uuid::uuid7();
+$uuid = Ramsey\Uuid\Uuid::uuid7();
 
 echo "Wygenerowano nowy UUID -> ", $uuid->toString(), "\n";
 ?>
diff --git a/language/types/array.xml b/language/types/array.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: cb3794f501ce55cedc40125fb995018bdc4ac1d1 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.types.array">
  <title>Tablice</title>
 
@@ -904,14 +904,20 @@ print "To jest $tablica[owoc]";      // To jest jabłko
 print "To jest {$tablica[owoc]}";    // To jest marchewka
 print "To jest {$tablica['owoc']}";  // To jest jabłko
 
+// Konkatenacja też jest możliwa
+print "To jest " . $tablica['owoc']; // To jest jabłko
+?>
+]]>
+    </programlisting>
+   </informalexample>
+   <informalexample>
+    <programlisting role="php">
+     <![CDATA[
 // Poniższe nie zadziała i będzie skutkowało błędem parsowania tego typu:
 // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING'
 // Odnosi się to oczywiście także do używania superglobalnych wewnątrz ciągów znaków
 print "To jest $tablica['owoc']";
 print "To jest $_GET['foo']";
-
-// Konkatenacja też jest możliwa
-print "To jest " . $tablica['owoc']; // To jest jabłko
 ?>
 ]]>
     </programlisting>
diff --git a/language/types/declarations.xml b/language/types/declarations.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 13273912b0f773c35f05297a47daa7f76dd52669 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: f908fff129bcd8ec1605658e06457cb04e5b2b51 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.types.declarations">
  <title>Deklaracje typów</title>
 
@@ -271,8 +271,8 @@ Stack trace:
    <title>Unia typów</title>
    <warning>
     <simpara>
-     Nie jest możliwe połączenie typów <type>false</type>
-     i <type>true</type> przez unię typów.
+     Nie jest możliwe połączenie dwóch typów singletonowych <type>false</type>
+     i <type>true</type> w unii typów.
      Zamiast tego skorzystaj z typu <type>bool</type>.
     </simpara>
    </warning>
diff --git a/reference/array/functions/array-unique.xml b/reference/array/functions/array-unique.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 3ba15fd3dfb8196a1762b1a21a14311e0279284b Maintainer: joeaccord Status: ready -->
+<!-- EN-Revision: 651fad6c6677036edd2871bb78199e17586a3acd Maintainer: joeaccord Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: leszek, sobak, grzesiek -->
 <refentry xml:id="function.array-unique" xmlns="http://docbook.org/ns/docbook">
@@ -21,13 +21,13 @@
   </para>
   <para>
    Zauważ, że klucze są zachowywane. Jeśli wiele elementów porównywanych jest
-   równych w ramach danego parmetru <parameter>flags</parameter>, wówczas klucz
+   równych w ramach danego parametru <parameter>flags</parameter>, wówczas klucz
    i wartość pierwszego równego elementu zostaną zachowane.
   </para>
   <note>
    <simpara>
     Dwa elementy tablicy są uważane za równe wtedy i tylko wtedy jeśli
-    <literal>(string) $elem1 === (string) $elem2</literal>, to znaczy gdy
+    <literal>(string) $elem1 === (string) $elem2</literal>, to znaczy, gdy
     reprezentacje jako ciąg znaków są takie same, to użyty będzie pierwszy element.
    </simpara>
   </note>
@@ -121,9 +121,11 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$input = array ("a" => "green", "red", "b" => "green", "blue", "red");
+
+$input = ["a" => "green", "red", "b" => "green", "blue", "red"];
 $result = array_unique ($input);
 print_r($result);
+
 ?>
 ]]>
     </programlisting>
@@ -146,9 +148,11 @@ Array
     <programlisting role="php">
 <![CDATA[
 <?php
-$input = array(4, "4", "3", 4, 3, "3");
+
+$input = [4, "4", "3", 4, 3, "3"];
 $result = array_unique($input);
 var_dump($result);
+
 ?>
 ]]>
     </programlisting>
diff --git a/reference/array/functions/usort.xml b/reference/array/functions/usort.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2226ad08fd93e3979efbba47c5ae3545eec97d25 Maintainer: leszek Status: ready -->
+<!-- EN-Revision: 5d19b00f2f70fa61eee46fee4049b625a8a9bfd2 Maintainer: leszek Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -182,7 +182,7 @@ $fruits[2]: winogrona
 <![CDATA[
 <?php
 class TestObj {
-    private string $name;
+    public string $name;
 
     function __construct($name)
     {
diff --git a/reference/bc/book.xml b/reference/bc/book.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: qrak Status: ready -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: qrak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: joeaccord, sobak -->
 
@@ -50,6 +50,7 @@ echo bcsub($num1, $num2, 1); // => '0.0'
 
  &reference.bc.setup;
  &reference.bc.reference;
+ &reference.bc.bcmath.number;
 
 </book>
 
diff --git a/reference/bc/functions/bcadd.xml b/reference/bc/functions/bcadd.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: qrak -->
 <refentry xml:id="function.bcadd" xmlns="http://docbook.org/ns/docbook">
@@ -42,7 +42,17 @@
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <varlistentry xmlns="http://docbook.org/ns/docbook"><term>
+     <parameter>scale</parameter></term>
+     <listitem>
+      <para>
+       Ten parametr służy do ustawienia liczby cyfr po kropce w wyniku.
+       Jeśli zostanie ustawiony na &null;, to funkcja użyje domyślnej skali ustawionej funkcją <function>bcscale</function>
+       lub alternatywnie skorzysta z wartości
+       dyrektywy INI <link linkend="ini.bcmath.scale"><literal>bcmath.scale</literal></link>.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -117,6 +127,7 @@ echo bcadd($a, $b, 4);  // 6.2340
   <para>
    <simplelist>
     <member><function>bcsub</function></member>
+    <member><methodname>BcMath\Number::add</methodname></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/bc/functions/bccomp.xml b/reference/bc/functions/bccomp.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: qrak -->
 <refentry xml:id="function.bccomp" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -76,6 +76,13 @@ echo bccomp('1.00001', '1', 5); // 1
    </programlisting>
   </example>
  </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>BcMath\Number::compare</methodname></member>
+  </simplelist>
+ </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/bc/functions/bcdiv.xml b/reference/bc/functions/bcdiv.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-<!-- CREDITS: sobak -->
 <refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcdiv</refname>
@@ -41,7 +40,7 @@
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <xi:include xpointer="function.bcadd..parameters.scale" />
    </variablelist>
   </para>
  </refsect1>
@@ -116,6 +115,7 @@ echo bcdiv('105', '6.55957', 3);  // 16.007
     <member><function>bcdivmod</function></member>
     <member><function>bcmod</function></member>
     <member><function>bcmul</function></member>
+    <member><methodname>BcMath\Number::div</methodname></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/bc/functions/bcmod.xml b/reference/bc/functions/bcmod.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: qrak -->
 <refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -114,6 +114,7 @@ echo bcmod('5.7', '1.3'); // 0.5 od PHP 7.2.0; wcześniej 0
    <simplelist>
     <member><function>bcdiv</function></member>
     <member><function>bcdivmod</function></member>
+    <member><methodname>BcMath\Number::mod</methodname></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/bc/functions/bcmul.xml b/reference/bc/functions/bcmul.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: qrak Status: ready -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: qrak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.bcmul" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
@@ -104,6 +104,7 @@ echo bcmul('5', '2', 2);     // wyświetla "10", a nie "10.00"
   <para>
    <simplelist>
     <member><function>bcdiv</function></member>
+    <member><methodname>BcMath\Number::mul</methodname></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/bc/functions/bcpow.xml b/reference/bc/functions/bcpow.xml
diff --git a/reference/bc/functions/bcsqrt.xml b/reference/bc/functions/bcsqrt.xml
diff --git a/reference/bc/functions/bcsub.xml b/reference/bc/functions/bcsub.xml
diff --git a/reference/bc/ini.xml b/reference/bc/ini.xml
