Sync some files with EN

Author: Sobak

appendices/reserved.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a63b9c754188b610fe1916404831aa9f1b41efbf Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 170b6cda37f29c39b9e08375344c5eb9523b2de3 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
  <appendix xml:id="reserved" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -519,40 +519,48 @@
      <tgroup cols="4">
       <tbody>
        <row>
+        <entry>
+         parent
+        </entry>
+        <entry>
+         self
+        </entry>
         <entry>
          int
         </entry>
         <entry>
          float
         </entry>
+       </row>
+       <row>
         <entry>
          bool
         </entry>
         <entry>
          string
         </entry>
-       </row>
-       <row>
         <entry>
          true
         </entry>
         <entry>
          false
         </entry>
+       </row>
+       <row>
         <entry>
          null
         </entry>
         <entry>
          void (od PHP 7.1)
         </entry>
-       </row>
-       <row>
         <entry>
          iterable (od PHP 7.1)
         </entry>
         <entry>
          object (od PHP 7.2)
         </entry>
+       </row>
+       <row>
         <entry>
          mixed (od PHP 8.0)
         </entry>

language-snippets.ent

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4639881688d3faaf0073ad71fe0a4b730aea15a0 Maintainer: sobak Status: wip -->
+<!-- EN-Revision: 69fe083419b7888f6d424595771d54fe2d850d9d Maintainer: sobak Status: wip -->
 <!-- $Revision$ -->
 <!-- CREDITS: leszek, adi, cyb0org, joeaccord -->
 <!-- TODO: Nieliczne sekcje opisane przez "TODO DOKOŃCZYĆ" nie są faktycznie przetłumaczone na j. polski. Pomoc mile widziana -->
@@ -343,6 +343,11 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
 <emphasis>PRZESTARZAŁA</emphasis> od PHP 8.0.0. Używanie tej funkcji
 jest niezalecane.</simpara></warning>'>
 
+<!ENTITY warn.deprecated.feature-8-1-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
+<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.1.0. Używanie tej opcji
+jest niezalecane.</simpara></warning>'>
+
 <!ENTITY warn.deprecated.function-8-1-0 '<warning
 xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
 <emphasis>PRZESTARZAŁA</emphasis> od PHP 8.1.0. Używanie tej funkcji
@@ -373,6 +378,16 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
 <emphasis>PRZESTARZAŁA</emphasis> od PHP 8.4.0. Używanie tej funkcji
 jest niezalecane.</simpara></warning>'>
 
+<!ENTITY warn.deprecated.feature-8-5-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>Ta opcja jest
+<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.5.0. Używanie tej opcji
+jest niezalecane.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.function-8-5-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>Ta funkcja jest
+<emphasis>PRZESTARZAŁA</emphasis> od PHP 8.5.0. Używanie tej funkcji
+jest niezalecane.</simpara></warning>'>
+
 <!ENTITY removed.php.future 'Ta przestarzała funkcja <emphasis xmlns="http://docbook.org/ns/docbook">zostanie</emphasis>
 na pewno w przyszłości <emphasis xmlns="http://docbook.org/ns/docbook">usunięta</emphasis>.'>
 
@@ -642,6 +657,10 @@ jest niezalecane.</simpara></warning>
 
 <!ENTITY example.outputs.84.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.4 wyświetli coś podobnego do:</para>'>
 
+<!ENTITY example.outputs.85 '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.5 wyświetli:</para>'>
+
+<!ENTITY example.outputs.85.similar '<para xmlns="http://docbook.org/ns/docbook">Powyższy przykład w PHP 8.5 wyświetli coś podobnego do:</para>'>
+
 <!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Wyświetla następujący przykład na systemach 32 bitowych:</para>'>
 
 <!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Wyświetla następujący przykład na systemach 64 bitowych:</para>'>
@@ -2215,6 +2234,14 @@ dla tego rozszerzenia <acronym xmlns="http://docbook.org/ns/docbook">PECL</acron
 <!ENTITY pecl.moved-ver 'To rozszerzenie zostało przeniesione do repozytorium &link.pecl;
 i nie jest rozprowadzane z PHP od PHP '>
 
+<!ENTITY pecl.moving.to.pie '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  Instalator rozszerzeń dla PHP (ang. <emphasis>PHP Installer for Extensions</emphasis>, <acronym>PIE</acronym>) to nowe narzędzie, które zastąpi PECL.
+  Zalecamy użycie PIE do instalacji rozszerzeń.
+  Dowiedz się więcej pod adresem <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/php/pie">https://github.com/php/pie</link>
+ </simpara>
+</note>'>
+
 <!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
  <simpara>To rozszerzenie <emphasis>nie jest już utrzymywane</emphasis>.</simpara>
 </warning>'>
@@ -3446,6 +3473,16 @@ local: {
     </listitem>
    </varlistentry>
 '>
+<!ENTITY mongodb.parameter.bulkwritecommand '
+   <varlistentry xmlns="http://docbook.org/ns/docbook">
+    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWriteCommand</classname>)</term>
+    <listitem>
+     <para>
+      Zapis(y) do wykonania.
+     </para>
+    </listitem>
+   </varlistentry>
+'>
 <!ENTITY mongodb.parameter.command '
    <varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
@@ -3672,10 +3709,12 @@ local: {
 '>
 <!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Zwraca <classname>MongoDB\Driver\Cursor</classname> przy powodzeniu.</para>'>
 <!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Zwraca <classname>MongoDB\Driver\WriteResult</classname> przy powodzeniu.</para>'>
+<!ENTITY mongodb.returns.bulkwritecommandresult '<para xmlns="http://docbook.org/ns/docbook">Zwraca <classname>MongoDB\Driver\BulkWriteCommandResult</classname> przy powodzeniu.</para>'>
 <!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
 <!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> jeśli opcja <literal>"session"</literal> jest używana w powiązanej transakcji w połączeniu z opcją <literal>"readConcern"</literal> lub <literal>"writeConcern"</literal>.</member>'>
 <!-- //// TODO DOKOŃCZYĆ //// -->
 <!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> jeśli opcja <literal>"session"</literal> option is used in combination with an unacknowledged write concern.</member>'>
+<!ENTITY mongodb.throws.bulkwritecommandexception '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\BulkWriteCommandException</classname> on any write failure (e.g. command failure, write or write concern error)</member>'>
 <!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\BulkWriteException</classname> w przypadku niepowodzenia zapisu (e.g. write error, failure to apply a write concern)</member>'>
 <!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> przy błędach parsowania argumentów.</member>'>
 <!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Rzuca wyjątek <classname>MongoDB\Driver\Exception\AuthenticationException</classname> jeśli wymagana autoryzacja nie powiedzie się.</member>'>

language/context/http.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e7b81f2c31e6b824748eeb8106b8bd4dec386781 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 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">
@@ -209,19 +209,19 @@
 <?php
 
 $postdata = http_build_query(
-    array(
+    [
         'var1' => 'some content',
         'var2' => 'doh'
-    )
+    ]
 );
 
-$opts = array('http' =>
-    array(
+$opts = [
+    'http' => [
         'method'  => 'POST',
         'header'  => 'Content-type: application/x-www-form-urlencoded',
-        'content' => $postdata
-    )
-);
+        'content' => $postdata,
+    ]
+];
 
 $context = stream_context_create($opts);
 
@@ -241,13 +241,13 @@ $result = file_get_contents('http://example.com/submit.php', false, $context);
 
 $url = "http://www.example.org/header.php";
 
-$opts = array('http' =>
-    array(
-        'method' => 'GET',
+$opts = [
+    'http' => [
+        'method'        => 'GET',
         'max_redirects' => '0',
-        'ignore_errors' => '1'
-    )
-);
+        'ignore_errors' => '1',
+    ]
+];
 
 $context = stream_context_create($opts);
 $stream = fopen($url, 'r', false, $context);

language/control-structures/match.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: 17502ebe0691a84e7d0738c13e8c1061dde98de7 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">
@@ -291,8 +291,8 @@ string(11) "young adult"
 $text = 'Bienvenue chez nous';
 
 $result = match (true) {
-    str_contains($text, 'Welcome') || str_contains($text, 'Hello') => 'en',
-    str_contains($text, 'Bienvenue') || str_contains($text, 'Bonjour') => 'fr',
+    str_contains($text, 'Welcome'), str_contains($text, 'Hello') => 'en',
+    str_contains($text, 'Bienvenue'), str_contains($text, 'Bonjour') => 'fr',
     // ...
 };
 

language/oop5/basic.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: fc068b4857342eb409efeafe6723058f39ab1045 Maintainer: sobak Status: ready -->
 
  <sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
   <title>Podstawy</title>
@@ -537,7 +537,7 @@ $extended->wyswietlWlasciwosc();
     <screen>
 <![CDATA[
 Klasa rozszerzająca
-domyślna wartość
+Klasa rodzica
 ]]>
     </screen>
    </example>

language/oop5/decon.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 82fc6a1c8670b96f1bd2b40932b6eb19929f4f6f Maintainer: sobak Status: ready -->
  <sect1 xml:id="language.oop5.decon" xmlns="http://docbook.org/ns/docbook">
   <title>Konstruktory i destruktory</title>
 
@@ -263,7 +263,7 @@ class Produkt {
     public static function fromXml(string $xml): static {
         $data = simplexml_load_string($xml);
         $new = new static();
-        $new->id = $data->id;
+        $new->id = (int) $data->id;
         $new->nazwa = $data->nazwa;
         return $new;
     }

language/oop5/interfaces.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0c2a0d736df56dd0f3a1b88bd6ce7c975c38285a Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 565bd8b6cf2cae44ae2bc54ef6dbe6ee70ddfefd Maintainer: sobak Status: ready -->
  <sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Interfejsy obiektów</title>
   <para>

language/predefined/variables/httpresponseheader.xml

@@ -1,11 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3f1cd5121f7c9f8347ca69c8f657fdb24c0f9729 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: fcf847c112e36140d1fdf30cc6fc83cb1c4eb297 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry role="variable" xml:id="reserved.variables.httpresponseheader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>$http_response_header</refname>
   <refpurpose>Nagłówki odpowiedzi HTTP</refpurpose>
  </refnamediv>
+
+ <refsynopsisdiv>
+  &warn.deprecated.feature-8-5-0;
+  <simpara>
+   Zamiast tego użyj funkcji <function>http_get_last_response_headers</function>.
+  </simpara>
+ </refsynopsisdiv>
 
  <refsect1 role="description">
   &reftitle.description;

language/types/boolean.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: f90b26b377a61c76c0f64028e47553e550411d08 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.types.boolean">
  <title>Wartości logiczne</title>
 
@@ -35,6 +35,9 @@ $foo = True; // przypisz wartość TRUE do $foo
    <programlisting role="php">
 <![CDATA[
 <?php
+$action = "pokaz_wersje";
+$show_separators = true;
+
 // == to operator, który sprawdza
 // równość i zwraca wartość logiczną
 if ($action == "pokaz_wersje") {

language/types/declarations.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 0ece873cecfc4dacd14e8bebbec12c6e00de56a0 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.types.declarations">
  <title>Deklaracje typów</title>
 
@@ -359,7 +359,7 @@ NULL
      </listitem>
      <listitem>
       <simpara>
-       Użycie <type>mixed</type> skutkuje błędem.
+       Użycie <type>mixed</type> lub <type>never</type> skutkuje błędem.
       </simpara>
      </listitem>
      <listitem>