From 6f77e65ba37d20d6f2a490e2d32b39e4ec40afa7 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Wed, 25 Feb 2026 10:29:02 +0100
Subject: [PATCH 1/3] Add Polish translation for fdatasync() and fsync()

---
 reference/filesystem/functions/fdatasync.xml | 101 +++++++++++++++++++
 reference/filesystem/functions/fsync.xml     |  98 ++++++++++++++++++
 2 files changed, 199 insertions(+)
 create mode 100644 reference/filesystem/functions/fdatasync.xml
 create mode 100644 reference/filesystem/functions/fsync.xml

diff --git a/reference/filesystem/functions/fdatasync.xml b/reference/filesystem/functions/fdatasync.xml
new file mode 100644
index 00000000..4ad0b78b
--- /dev/null
+++ b/reference/filesystem/functions/fdatasync.xml
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: lacatoire Status: ready -->
+<refentry xml:id="function.fdatasync" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>fdatasync</refname>
+  <refpurpose>Synchronizuje dane (ale nie metadane) do pliku</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>fdatasync</methodname>
+   <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Ta funkcja synchronizuje zawartość <parameter>stream</parameter>
+   z nośnikiem danych, tak jak robi to <function>fsync</function>,
+   ale nie synchronizuje metadanych pliku.
+   Należy zauważyć, że ta funkcja różni się skutecznie tylko w systemach
+   POSIX. W systemie Windows ta funkcja jest aliasem
+   <function>fsync</function>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>stream</parameter></term>
+     <listitem>
+      &fs.validfp.all;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Przykład użycia <function>fdatasync</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$file = 'test.txt';
+
+$stream = fopen($file, 'w');
+fwrite($stream, 'test data');
+fwrite($stream, "\r\n");
+fwrite($stream, 'additional data');
+
+fdatasync($stream);
+fclose($stream);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>fflush</function></member>
+    <member><function>fsync</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/filesystem/functions/fsync.xml b/reference/filesystem/functions/fsync.xml
new file mode 100644
index 00000000..3b7888dc
--- /dev/null
+++ b/reference/filesystem/functions/fsync.xml
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: lacatoire Status: ready -->
+<refentry xml:id="function.fsync" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>fsync</refname>
+  <refpurpose>Synchronizuje zmiany w pliku (w tym metadane)</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>fsync</methodname>
+   <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Ta funkcja synchronizuje zmiany w pliku, w tym jego metadane. Jest to
+   podobne do <function>fflush</function>, ale dodatkowo instruuje system
+   operacyjny, aby zapisał dane na nośniku danych.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>stream</parameter></term>
+     <listitem>
+      &fs.validfp.all;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Przykład użycia <function>fsync</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$file = 'test.txt';
+
+$stream = fopen($file, 'w');
+fwrite($stream, 'test data');
+fwrite($stream, "\r\n");
+fwrite($stream, 'additional data');
+
+fsync($stream);
+fclose($stream);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>fdatasync</function></member>
+    <member><function>fflush</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 04454f2307c9c51b95024dfb6b138ee5f16c5e3b Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Fri, 27 Feb 2026 09:07:09 +0100
Subject: [PATCH 2/3] Fix CI: add missing xml:id for scale parameter in bcadd

The xpointer reference function.bcadd..parameters.scale is used by
bcdiv, bcpow, bcpowmod and bcsqrt but was missing from the Polish
translation of bcadd.xml, causing XInclude resolution failure.
---
 reference/bc/functions/bcadd.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/bc/functions/bcadd.xml b/reference/bc/functions/bcadd.xml
index f5869fbf..3c734c31 100644
--- a/reference/bc/functions/bcadd.xml
+++ b/reference/bc/functions/bcadd.xml
@@ -42,7 +42,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry xmlns="http://docbook.org/ns/docbook"><term>
+    <varlistentry xml:id="function.bcadd..parameters.scale" xmlns="http://docbook.org/ns/docbook"><term>
      <parameter>scale</parameter></term>
      <listitem>
       <para>

From 73d31fe384c7fb8a8d07a6cd5039ff7d4fa9db9c Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Fri, 27 Feb 2026 09:09:54 +0100
Subject: [PATCH 3/3] Fix CI: align bcadd.xml and fgetcsv.xml with doc-en
 structure

- bcadd.xml: remove xmlns attribute, use simpara instead of para to
  match EN structure required for XInclude xpointer resolution
- fgetcsv.xml: replace outdated note with warning element and add
  xml:id for XInclude from splfileobject/fgetcsv.xml
---
 reference/bc/functions/bcadd.xml           |  8 ++++----
 reference/filesystem/functions/fgetcsv.xml | 23 ++++++++++++----------
 2 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/reference/bc/functions/bcadd.xml b/reference/bc/functions/bcadd.xml
index 3c734c31..84ed2932 100644
--- a/reference/bc/functions/bcadd.xml
+++ b/reference/bc/functions/bcadd.xml
@@ -42,15 +42,15 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry xml:id="function.bcadd..parameters.scale" xmlns="http://docbook.org/ns/docbook"><term>
-     <parameter>scale</parameter></term>
+    <varlistentry xml:id="function.bcadd..parameters.scale">
+     <term><parameter>scale</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        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>
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
diff --git a/reference/filesystem/functions/fgetcsv.xml b/reference/filesystem/functions/fgetcsv.xml
index 877a3fef..6de16e9b 100644
--- a/reference/filesystem/functions/fgetcsv.xml
+++ b/reference/filesystem/functions/fgetcsv.xml
@@ -89,18 +89,21 @@
        Musi być znakiem jednobajtowym lub pustym ciągiem znaków.
        Pusty ciąg znaków (<literal>""</literal>) wyłącza własnościowy mechanizm ucieczki.
       </para>
-      <note>
+      <warning xml:id="function.fgetcsv..warn.escape.parameter">
        <simpara>
-        Zazwyczaj znak <parameter>enclosure</parameter> jest unikany wewnątrz pola
-        poprzez jego podwojenie; jednak znak <parameter>escape</parameter>
-        może być użyty jako alternatywa. Tak więc dla domyślnych wartości
-        parametrów <literal>""</literal> i <literal>\"</literal> mają takie samo
-        znaczenie. Poza umożliwieniem ucieczki przed znakiem
-        <parameter>enclosure</parameter>, znak
-        <parameter>escape</parameter> nie specjalnego znaczenia; nie jest nawet
-        przeznaczony do ucieczki przed samym sobą.
+        W strumieniu wejściowym znak <parameter>enclosure</parameter>
+        zawsze może być unikany przez podwojenie wewnątrz cytowanego ciągu,
+        co daje pojedynczy znak <parameter>enclosure</parameter>
+        w przetworzonym wyniku.
+        Znak <parameter>escape</parameter> działa inaczej:
+        jeśli sekwencja znaków <parameter>escape</parameter> i
+        <parameter>enclosure</parameter> pojawia się na wejściu,
+        oba znaki będą obecne w przetworzonym wyniku.
+        Tak więc dla domyślnych parametrów, linia CSV taka jak
+        <literal>"a""b","c\"d"</literal> będzie miała pola przetworzone jako
+        <literal>a"b</literal> i <literal>c\"d</literal>.
        </simpara>
-      </note>
+      </warning>
       <warning>
        <simpara>
         Począwszy od PHP 8.4.0 poleganie na domyślnej wartości