Sync outdated files with EN (#12)

php · Aug 10, 2024 · 854f9c2 · 854f9c2
1 parent e0c05f0
commit 854f9c2
Show file tree

Hide file tree

Showing 26 changed files with 85 additions and 146 deletions.
diff --git a/reference/datetime/functions/mktime.xml b/reference/datetime/functions/mktime.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 57e27d2a7615da2ee6de57ed27eb40b473d487cb Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 349e3c6502e0bbeb15aef2b4a4a25f3f5e10fbfe Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-<!-- CREDITS: qrak -->
+<!-- CREDITS: qrak, grzesiek -->
 <refentry xml:id="function.mktime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mktime</refname>
@@ -213,10 +213,13 @@ echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 98));
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $lastday = mktime(0, 0, 0, 3, 0, 2000);
-echo strftime("Ostatni dzień w lutym 2000 to: %d", $lastday);
+echo 'Ostatni dzień lutego w 2000 roku to: ', date('d', $lastday);
+
 $lastday = mktime(0, 0, 0, 4, -31, 2000);
-echo strftime("Ostatni dzień w lutym 2000 to: %d", $lastday);
+echo 'Ostatni dzień lutego w 2000 roku to: ', date('d', $lastday);
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/datetime/functions/strftime.xml b/reference/datetime/functions/strftime.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: sobak Status: ready -->
+<!-- EN-Revision: b93836ce6f7350932d11e784b793065fd2598e50 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-<!-- CREDITS: qrak -->
+<!-- CREDITS: qrak, grzesiek -->
 <refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>strftime</refname>
@@ -515,11 +515,12 @@ echo strftime($format);
   </para>
   <para>
    <example>
-    <title>Wyświetl wszystkie znane i nieznane formaty.</title>
+    <title>Wyświetl wszystkie znane i nieznane formaty</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-// Opis formatów.
+
+// Opis formatów
 $strftimeFormats = array(
     'A' => 'A full textual representation of the day',
     'B' => 'Full month name, based on the locale',
@@ -576,28 +577,29 @@ $strftimeFormats = array(
     '%' => 'A literal percentage character ("%")',
 );
 
-// Results.
+// Results
 $strftimeValues = array();
 
-// Evaluate the formats whilst suppressing any errors.
-foreach($strftimeFormats as $format => $description){
-    if (False !== ($value = @strftime("%{$format}"))){
+// Evaluate the formats whilst suppressing any errors
+foreach ($strftimeFormats as $format => $description) {
+    if (False !== ($value = @strftime("%{$format}"))) {
         $strftimeValues[$format] = $value;
     }
 }
 
-// Find the longest value.
+// Find the longest value
 $maxValueLength = 2 + max(array_map('strlen', $strftimeValues));
 
-// Report known formats.
-foreach($strftimeValues as $format => $value){
+// Report known formats
+foreach ($strftimeValues as $format => $value) {
     echo "Known format   : '{$format}' = ", str_pad("'{$value}'", $maxValueLength), " ( {$strftimeFormats[$format]} )\n";
 }
 
-// Report unknown formats.
-foreach(array_diff_key($strftimeFormats, $strftimeValues) as $format => $description){
+// Report unknown formats
+foreach (array_diff_key($strftimeFormats, $strftimeValues) as $format => $description) {
     echo "Unknown format : '{$format}'   ", str_pad(' ', $maxValueLength), ($description ? " ( {$description} )" : ''), "\n";
 }
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/dir/book.xml b/reference/dir/book.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-
+ <!-- CREDITS: grzesiek -->
 <book xml:id="book.dir" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="core" ?>
  <title>Katalogi</title>
@@ -15,7 +15,6 @@
  </preface>
  }}} -->
 
- &reference.dir.setup;
  &reference.dir.constants;
  &reference.dir.directory;
  &reference.dir.reference;

diff --git a/reference/exif/book.xml b/reference/exif/book.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: joeaccord Status: ready -->
-
+<!-- EN-Revision: 762fd781b63e37a13eb616602f715898dd237955 Maintainer: grzesiek Status: ready -->
+<!-- CREDITS: joeaccord -->
 <book xml:id="book.exif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
  <title>Exchangeable image information</title>
@@ -10,10 +10,11 @@
  <preface xml:id="intro.exif">
   &reftitle.intro;
   <para>
-   Rozszerzenie Exif umożliwia pracę z metadanymi obrazów.  Można
-   przykładowo używać funkcji Exif do odczytywania informacji przechowywanych
-   w nagłówkach zdjęć <acronym>JPEG</acronym> i <acronym>TIFF</acronym>
-   pobranych z aparatu cyfrowego.
+   Dzięki rozszerzeniu exif możesz pracować z metadanymi obrazów. Na przykład 
+   możesz używać funkcji exif do odczytywania metadanych zdjęć zrobionych 
+   aparatami cyfrowymi, pracując z informacjami zapisanymi w nagłówkach. 
+   Są one powszechnie spotykane w obrazach <acronym>JPEG</acronym> i 
+   <acronym>TIFF</acronym>.
   </para>
  </preface>
  <!-- }}} -->

diff --git a/reference/exif/setup.xml b/reference/exif/setup.xml
@@ -1,18 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: joeaccord Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
-
+<!-- CREDITS: joeaccord -->
 <chapter xml:id="exif.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
 
  <!-- {{{ Requirements -->
  <section xml:id="exif.requirements">
   &reftitle.required;
   <para>
-   PHP musi być skompilowany z opcją <literal>--enable-exif</literal>.
-   Do prawidłowego działania rozszerzenia Exif, PHP nie wymaga
-   dodatkowych bibliotek.  Użytkownicy Windows muszą mieć także
-   włączone rozszerzenie <link linkend="ref.mbstring"> mbstring</link>.
+   PHP musi być skompilowany z opcją <literal>--enable-exif</literal>. Aby włączyć
+   obsugę wielobajtową w tagach EXIF, rozszerzenie <link linkend="ref.mbstring">mbstring</link>
+   musi być włączone poprzez kompilację PHP z opcją <literal>--enable-mbstring</literal>.
+   PHP nie wymaga żadnej dodatkowej biblioteki dla modułu exif.
+  </para>
+  <para>
+   Tylko systemy Windows: Rozszerzenie <link linkend="ref.mbstring">mbstring</link> musi być
+   zawsze włączone. Zauważ, że rozszerzenie <link linkend="ref.mbstring">mbstring</link> musi być
+   załadowane przed EXIF w pliku <filename>php.ini</filename>.
   </para>
  </section>
  <!-- }}} -->
@@ -25,13 +30,6 @@
  &reference.exif.ini;
  <!-- }}} -->
 
- <!-- {{{ Resources -->
- <section xml:id="exif.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
- <!-- }}} -->
-
 </chapter>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/funchand/book.xml b/reference/funchand/book.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-
+<!-- CREDITS: grzesiek -->
 <book xml:id="book.funchand" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="core" ?>
  <title>Obsługa funkcji</title>
@@ -14,7 +14,6 @@
   </para>
  </preface>
 
- &reference.funchand.setup;
  &reference.funchand.reference;
 
 </book>

diff --git a/reference/iconv/setup.xml b/reference/iconv/setup.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-
+<!-- CREDITS: grzesiek -->
 <chapter xml:id="iconv.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
 
@@ -26,13 +26,6 @@
  &reference.iconv.ini;
  <!-- }}} -->
 
- <!-- {{{ Resources -->
- <section xml:id="iconv.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
- <!-- }}} -->
-
 </chapter>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/json/functions/json-decode.xml b/reference/json/functions/json-decode.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: ce1856e7b95807615565d2f1427582e107c450a9 Maintainer: joeaccord Status: ready -->
+<!-- EN-Revision: 9f2e30a00afda6d6b6a3e19b13956150c2eaf2c1 Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
-<!-- CREDITS: sobak -->
+<!-- CREDITS: sobak, joeaccord -->
 <refentry xml:id="function.json-decode" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>json_decode</refname>
@@ -337,6 +337,7 @@ object(stdClass)#1 (1) {
    <simplelist>
     <member><function>json_encode</function></member>
     <member><function>json_last_error</function></member>
+    <member><function>json_last_error_msg</function></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/json/functions/json-encode.xml b/reference/json/functions/json-encode.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19e8122137a1d42ed60f17fe2c0c2b69b0b2d16b Maintainer: joeaccord Status: ready -->
+<!-- EN-Revision: 9f2e30a00afda6d6b6a3e19b13956150c2eaf2c1 Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
-<!-- CREDITS: sobak -->
+<!-- CREDITS: sobak, joeaccord -->
 <refentry xml:id="function.json-encode" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>json_encode</refname>
@@ -393,6 +393,7 @@ string(2) "12"
     <member><interfacename>JsonSerializable</interfacename></member>
     <member><function>json_decode</function></member>
     <member><function>json_last_error</function></member>
+    <member><function>json_last_error_msg</function></member>
     <member><function>serialize</function></member>
    </simplelist>
   </para>

diff --git a/reference/json/setup.xml b/reference/json/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 765b2d6eec7dfbaeed900b32aa91a1360d73df42 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
 
 <chapter xml:id="json.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -20,11 +20,6 @@
   </para>
  </section>
 
- <section xml:id="json.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
-
 </chapter>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/mail/setup.xml b/reference/mail/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 57d1b0df36cc1da4fae0113979343405eff223fd Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <chapter xml:id="mail.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -27,13 +27,6 @@
  &reference.mail.ini;
  <!-- }}} -->
 
- <!-- {{{ Resources -->
- <section xml:id="mail.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
- <!-- }}} -->
-
 </chapter>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/math/book.xml b/reference/math/book.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 19e8122137a1d42ed60f17fe2c0c2b69b0b2d16b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <book xml:id="book.math" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -36,7 +36,6 @@
  </preface>
  <!-- }}} -->
 
- &reference.math.setup;
  &reference.math.constants;
  &reference.math.reference;
 

diff --git a/reference/math/functions/pow.xml b/reference/math/functions/pow.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fc174e8d6162091550edde46159917ee7e5a2e73 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: 7dbc44bd0d8923890acf1acedf79daba672af39c Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
-<!-- CREDITS: sobak -->
 <refentry xml:id="function.pow" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pow</refname>
@@ -55,6 +54,9 @@
    a wynik może być reprezentowany jako liczba całkowita, wynik zostanie zwrócony z typem
    <type>int</type>, w przeciwnym razie zostanie zwrócony jako typ <type>float</type>.
   </para>
+  <para>
+   Rozszerzenia PHP mogą nadpisywać zachowanie tej operacji i zwracać obiekt.
+  </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
@@ -66,11 +68,13 @@
 <?php
 
 var_dump(pow(2, 8)); // int(256)
-echo pow(-1, 20); // 1
-echo pow(0, 0); // 1
-echo pow(10, -1); // 0.1
+echo pow(-1, 20), PHP_EOL; // 1
+echo pow(0, 0), PHP_EOL; // 1
+echo pow(10, -1), PHP_EOL; // 0.1
+var_dump(pow(new GMP("3"), new GMP("2"))); // object(GMP)
 
 echo pow(-1, 5.5); // NAN
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/misc/setup.xml b/reference/misc/setup.xml
@@ -1,17 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 605553e228c78a9368736f4ff36d185cf7e6eb22 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <chapter xml:id="misc.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
 
  &reference.misc.ini;
 
- <section xml:id="misc.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
-
 </chapter>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/mysqli/setup.xml b/reference/mysqli/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ed851c6bbc75edca2706ea43f224278dd0538a6f Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: grzesiek -->
 <chapter xml:id="mysqli.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -44,13 +44,6 @@
  &reference.mysqli.ini;
  <!-- }}} -->
 
- <!-- {{{ Resources -->
- <section xml:id="mysqli.resources">
-  &reftitle.resources;
-  &no.resource;
- </section>
- <!-- }}} -->
-
 </chapter>
 
 <!-- Keep this comment at the end of the file