Skip to content

Commit 5ce3413

Browse files
lacatoirelacatoire
authored
Add translation for fdatasync() and fsync() (#26)
* Add Polish translation for fdatasync() and fsync() * 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. * 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
1 parent 9b3470e commit 5ce3413

4 files changed

Lines changed: 216 additions & 14 deletions

File tree

‎reference/bc/functions/bcadd.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,15 +42,15 @@
4242
</para>
4343
</listitem>
4444
</varlistentry>
45-
<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
46-
<parameter>scale</parameter></term>
45+
<varlistentry xml:id="function.bcadd..parameters.scale">
46+
<term><parameter>scale</parameter></term>
4747
<listitem>
48-
<para>
48+
<simpara>
4949
Ten parametr służy do ustawienia liczby cyfr po kropce w wyniku.
5050
Jeśli zostanie ustawiony na &null;, to funkcja użyje domyślnej skali ustawionej funkcją <function>bcscale</function>
5151
lub alternatywnie skorzysta z wartości
5252
dyrektywy INI <link linkend="ini.bcmath.scale"><literal>bcmath.scale</literal></link>.
53-
</para>
53+
</simpara>
5454
</listitem>
5555
</varlistentry>
5656
</variablelist>

‎reference/filesystem/functions/fdatasync.xml‎

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: lacatoire Status: ready -->
3+
<refentry xml:id="function.fdatasync" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>fdatasync</refname>
6+
<refpurpose>Synchronizuje dane (ale nie metadane) do pliku</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>bool</type><methodname>fdatasync</methodname>
13+
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
14+
</methodsynopsis>
15+
<para>
16+
Ta funkcja synchronizuje zawartość <parameter>stream</parameter>
17+
z nośnikiem danych, tak jak robi to <function>fsync</function>,
18+
ale nie synchronizuje metadanych pliku.
19+
Należy zauważyć, że ta funkcja różni się skutecznie tylko w systemach
20+
POSIX. W systemie Windows ta funkcja jest aliasem
21+
<function>fsync</function>.
22+
</para>
23+
</refsect1>
24+
25+
<refsect1 role="parameters">
26+
&reftitle.parameters;
27+
<para>
28+
<variablelist>
29+
<varlistentry>
30+
<term><parameter>stream</parameter></term>
31+
<listitem>
32+
&fs.validfp.all;
33+
</listitem>
34+
</varlistentry>
35+
</variablelist>
36+
</para>
37+
</refsect1>
38+
39+
<refsect1 role="returnvalues">
40+
&reftitle.returnvalues;
41+
<para>
42+
&return.success;
43+
</para>
44+
</refsect1>
45+
46+
<refsect1 role="examples">
47+
&reftitle.examples;
48+
<para>
49+
<example>
50+
<title>Przykład użycia <function>fdatasync</function></title>
51+
<programlisting role="php">
52+
<![CDATA[
53+
<?php
54+
55+
$file = 'test.txt';
56+
57+
$stream = fopen($file, 'w');
58+
fwrite($stream, 'test data');
59+
fwrite($stream, "\r\n");
60+
fwrite($stream, 'additional data');
61+
62+
fdatasync($stream);
63+
fclose($stream);
64+
?>
65+
]]>
66+
</programlisting>
67+
</example>
68+
</para>
69+
</refsect1>
70+
71+
<refsect1 role="seealso">
72+
&reftitle.seealso;
73+
<para>
74+
<simplelist>
75+
<member><function>fflush</function></member>
76+
<member><function>fsync</function></member>
77+
</simplelist>
78+
</para>
79+
</refsect1>
80+
81+
</refentry>
82+
<!-- Keep this comment at the end of the file
83+
Local variables:
84+
mode: sgml
85+
sgml-omittag:t
86+
sgml-shorttag:t
87+
sgml-minimize-attributes:nil
88+
sgml-always-quote-attributes:t
89+
sgml-indent-step:1
90+
sgml-indent-data:t
91+
indent-tabs-mode:nil
92+
sgml-parent-document:nil
93+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
94+
sgml-exposed-tags:nil
95+
sgml-local-catalogs:nil
96+
sgml-local-ecat-files:nil
97+
End:
98+
vim600: syn=xml fen fdm=syntax fdl=2 si
99+
vim: et tw=78 syn=sgml
100+
vi: ts=1 sw=1
101+
-->

‎reference/filesystem/functions/fgetcsv.xml‎

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -89,18 +89,21 @@
8989
Musi być znakiem jednobajtowym lub pustym ciągiem znaków.
9090
Pusty ciąg znaków (<literal>""</literal>) wyłącza własnościowy mechanizm ucieczki.
9191
</para>
92-
<note>
92+
<warning xml:id="function.fgetcsv..warn.escape.parameter">
9393
<simpara>
94-
Zazwyczaj znak <parameter>enclosure</parameter> jest unikany wewnątrz pola
95-
poprzez jego podwojenie; jednak znak <parameter>escape</parameter>
96-
może być użyty jako alternatywa. Tak więc dla domyślnych wartości
97-
parametrów <literal>""</literal> i <literal>\"</literal> mają takie samo
98-
znaczenie. Poza umożliwieniem ucieczki przed znakiem
99-
<parameter>enclosure</parameter>, znak
100-
<parameter>escape</parameter> nie specjalnego znaczenia; nie jest nawet
101-
przeznaczony do ucieczki przed samym sobą.
94+
W strumieniu wejściowym znak <parameter>enclosure</parameter>
95+
zawsze może być unikany przez podwojenie wewnątrz cytowanego ciągu,
96+
co daje pojedynczy znak <parameter>enclosure</parameter>
97+
w przetworzonym wyniku.
98+
Znak <parameter>escape</parameter> działa inaczej:
99+
jeśli sekwencja znaków <parameter>escape</parameter> i
100+
<parameter>enclosure</parameter> pojawia się na wejściu,
101+
oba znaki będą obecne w przetworzonym wyniku.
102+
Tak więc dla domyślnych parametrów, linia CSV taka jak
103+
<literal>"a""b","c\"d"</literal> będzie miała pola przetworzone jako
104+
<literal>a"b</literal> i <literal>c\"d</literal>.
102105
</simpara>
103-
</note>
106+
</warning>
104107
<warning>
105108
<simpara>
106109
Począwszy od PHP 8.4.0 poleganie na domyślnej wartości

‎reference/filesystem/functions/fsync.xml‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: lacatoire Status: ready -->
3+
<refentry xml:id="function.fsync" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>fsync</refname>
6+
<refpurpose>Synchronizuje zmiany w pliku (w tym metadane)</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>bool</type><methodname>fsync</methodname>
13+
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
14+
</methodsynopsis>
15+
<para>
16+
Ta funkcja synchronizuje zmiany w pliku, w tym jego metadane. Jest to
17+
podobne do <function>fflush</function>, ale dodatkowo instruuje system
18+
operacyjny, aby zapisał dane na nośniku danych.
19+
</para>
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<para>
25+
<variablelist>
26+
<varlistentry>
27+
<term><parameter>stream</parameter></term>
28+
<listitem>
29+
&fs.validfp.all;
30+
</listitem>
31+
</varlistentry>
32+
</variablelist>
33+
</para>
34+
</refsect1>
35+
36+
<refsect1 role="returnvalues">
37+
&reftitle.returnvalues;
38+
<para>
39+
&return.success;
40+
</para>
41+
</refsect1>
42+
43+
<refsect1 role="examples">
44+
&reftitle.examples;
45+
<para>
46+
<example>
47+
<title>Przykład użycia <function>fsync</function></title>
48+
<programlisting role="php">
49+
<![CDATA[
50+
<?php
51+
52+
$file = 'test.txt';
53+
54+
$stream = fopen($file, 'w');
55+
fwrite($stream, 'test data');
56+
fwrite($stream, "\r\n");
57+
fwrite($stream, 'additional data');
58+
59+
fsync($stream);
60+
fclose($stream);
61+
?>
62+
]]>
63+
</programlisting>
64+
</example>
65+
</para>
66+
</refsect1>
67+
68+
<refsect1 role="seealso">
69+
&reftitle.seealso;
70+
<para>
71+
<simplelist>
72+
<member><function>fdatasync</function></member>
73+
<member><function>fflush</function></member>
74+
</simplelist>
75+
</para>
76+
</refsect1>
77+
78+
</refentry>
79+
<!-- Keep this comment at the end of the file
80+
Local variables:
81+
mode: sgml
82+
sgml-omittag:t
83+
sgml-shorttag:t
84+
sgml-minimize-attributes:nil
85+
sgml-always-quote-attributes:t
86+
sgml-indent-step:1
87+
sgml-indent-data:t
88+
indent-tabs-mode:nil
89+
sgml-parent-document:nil
90+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
91+
sgml-exposed-tags:nil
92+
sgml-local-catalogs:nil
93+
sgml-local-ecat-files:nil
94+
End:
95+
vim600: syn=xml fen fdm=syntax fdl=2 si
96+
vim: et tw=78 syn=sgml
97+
vi: ts=1 sw=1
98+
-->

0 commit comments

Comments
 (0)