Skip to content

Commit

Permalink
Sync filesystem functions with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
grzegorz-bankowski committed May 21, 2024
1 parent 673af20 commit 8b555a6
Show file tree
Hide file tree
Showing 31 changed files with 605 additions and 652 deletions.
21 changes: 11 additions & 10 deletions reference/filesystem/functions/basename.xml
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7e4167f3f2e202ba4463fbc3851e56067f085326 Maintainer: sobak Status: ready -->
<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: adi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.basename">
<!-- CREDITS: adi, sobak, grzesiek -->
<refentry xml:id="function.basename" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>basename</refname>
<refpurpose>Zwraca nazwę pliku, będącego składową ścieżki</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>basename</methodname>
<methodparam><type>string</type><parameter>ścieżka</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>przyrostek</parameter></methodparam>
<methodparam><type>string</type><parameter>path</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>suffix</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
Z podanego łańcucha zawierającego ścieżkę do pliku, funkcja
Expand All @@ -31,6 +31,8 @@
<function>basename</function> bierze pod uwagę obecnią lokalizację systemu, więc aby widzieć
prawidłowe basename ze ścieżek zawierających znaki spoza alfabetu łacińskiego, musi zostać
ustawiona odpowiednia lokalizacja przy pomocy funkcji <function>setlocale</function>.
Jeśli parametr <parameter>path</parameter> zawiera znaki, które są nieprawidłowe dla
bieżących ustawień regionalnych, zachowanie <function>basename</function> jest niezdefiniowane.
</para>
</note>
</refsect1>
Expand All @@ -40,7 +42,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>ścieżka</parameter></term>
<term><parameter>path</parameter></term>
<listitem>
<para>
Ścieżka
Expand All @@ -53,10 +55,10 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>przyrostek</parameter></term>
<term><parameter>suffix</parameter></term>
<listitem>
<para>
Jeśli plik kończy się <parameter>przyrostkiem</parameter> to także zostanie on
Jeśli plik kończy się przyrostkiem <parameter>suffix</parameter> to także zostanie on
obcięty.
</para>
</listitem>
Expand Down Expand Up @@ -115,7 +117,6 @@ echo "6) ".basename("/");
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
44 changes: 9 additions & 35 deletions reference/filesystem/functions/clearstatcache.xml
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d1d11ef7fa6e705dec67a2269204778c0e74887f Maintainer: adi Status: ready -->
<!-- EN-Revision: e82ff8a846af03b863c4a57fbedc0a93af0e68db Maintainer: adi Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.clearstatcache">
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.clearstatcache" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>clearstatcache</refname>
<refpurpose>Czyści bufor statusu pliku</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>clearstatcache</methodname>
<methodparam choice="opt"><type>bool</type><parameter>clear_realpath_cache</parameter><initializer>false</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>clear_realpath_cache</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>filename</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
Kiedy używasz <function>stat</function>, <function>lstat</function> lub
Expand All @@ -31,7 +31,7 @@
Jeśli wywołasz <function>file_exists</function> na pliku, który nie istnieje
zostanie zwrócone &false; dopóki nie stworzysz tego pliku. Jeśli go utworzysz
funkcja zwróci &true; nawet jeśli go później skasujesz.
Jednakże <function>unlink</function> czyści automatycznie bufor.
Jednakże <function>unlink</function> czyści automatycznie bufor.
</para>
<note>
<para>
Expand Down Expand Up @@ -71,12 +71,12 @@
<term><parameter>clear_realpath_cache</parameter></term>
<listitem>
<para>
Czy czyścić bufor o prawdziwej ścieżce, czy nie.
Czy czyścić <emphasis>również</emphasis> bufor ścieżki prawdziwej.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nazwa_pliku</parameter></term>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Czyści bufor o prawdziwej ścieżce tylko dla podanego pliku; tylko jeśli
Expand All @@ -95,31 +95,6 @@
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Dodano opcjonalne parametry <parameter>clear_realpath_cache</parameter>
i <parameter>filename</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down Expand Up @@ -162,7 +137,6 @@ UID @ Sun, 12 Oct 2008 20:48:28 +0100: ross
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
67 changes: 15 additions & 52 deletions reference/filesystem/functions/copy.xml
Original file line number Diff line number Diff line change
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 26646268168d57f4c916dc102b9fa473800d36f2 Maintainer: adi Status: ready -->
<!-- EN-Revision: ea62fb83196997032641b50fe44420305466195e Maintainer: adi Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.copy" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>copy</refname>
<refpurpose>Kopiuje plik</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>copy</methodname>
<methodparam><type>string</type><parameter>źródło</parameter></methodparam>
<methodparam><type>string</type><parameter>przeznaczenie</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>kontekst</parameter></methodparam>
<methodparam><type>string</type><parameter>from</parameter></methodparam>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type>
<parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Kopiuje plik z <parameter>źródło</parameter> do
<parameter>przeznaczenie</parameter>.
Kopiuje plik z parametru <parameter>from</parameter> do
parametru <parameter>to</parameter>.
</para>
<para>
Jeśli chcesz przenieść plik, użyj funkcji <function>rename</function>.
Expand All @@ -29,18 +31,18 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>źródło</parameter></term>
<term><parameter>from</parameter></term>
<listitem>
<para>
Ścieżka do pliku źródłowego.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>przeznaczenie</parameter></term>
<term><parameter>to</parameter></term>
<listitem>
<para>
Ścieżka docelowa. Jeśli <parameter>przeznaczenie</parameter> jest URLem,
Ścieżka docelowa. Jeśli parametr <parameter>to</parameter> jest URLem,
operacja kopiowania może się niepowieść, jeśli wrapper nie obsługuje nadpisywania
istniejących plików.
</para>
Expand Down Expand Up @@ -71,48 +73,9 @@
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.4</entry>
<entry>
Parametr <parameter>kontekst</parameter> faktycznie ma wpływ.
Wcześniej dowolny <parameter>kontekst</parameter> był ignorowany.
</entry>
</row>
<row>
<entry>5.3.0</entry>
<entry>
Dodano obsługę kontekstu.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>
Zarówno <parameter>źródło</parameter> i <parameter>przeznaczenie</parameter>
mogą być URLami jeśli "wrappery fopen" zostały włączone.
Zobacz <function>fopen</function> w celu poznania więcej szczegółów.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>

<refsect1 role="examples">
<refsect1 role="examples">
&reftitle.examples;
<para>
<para>
<example>
<title><function>copy</function> przykład</title>
<programlisting role="php">
Expand All @@ -137,7 +100,7 @@ if (!copy($file, $newfile)) {
<simplelist>
<member><function>move_uploaded_file</function></member>
<member><function>rename</function></member>
<member>Rozdział podręcznika dotyczący<link
<member>Rozdział podręcznika dotyczący<link
linkend="features.file-upload">obsługi wgrywania plików</link></member>
</simplelist>
</para>
Expand Down
15 changes: 8 additions & 7 deletions reference/filesystem/functions/delete.xml
Original file line number Diff line number Diff line change
@@ -1,19 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 9514f50e8909210419382868c321703037375191 Maintainer: adi Status: ready -->
<!-- EN-Revision: ec6e871a47fa15228aa3299f46fed826422adbc0 Maintainer: adi Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.delete" xmlns="http://docbook.org/ns/docbook" annotations="verify_info:false">
<!-- CREDITS: sobak, grzesiek -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.delete" annotations="verify_info:false">
<refnamediv>
<refname>delete</refname>
<refpurpose>Zobacz <function>unlink</function> lub
<function>unset</function></refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<para>
To jest ślepy wpis aby zadowolić ludzi którzy szukają
<function>unlink</function> lub <function>unset</function>
w nie właściwym miejscu.
W języku PHP nie ma słowa kluczowego ani funkcji delete.
Jeśli trafiłeś na tę stronę w celu usunięcia pliku, wypróbuj funkcję <function>unlink</function>.
Aby usunąć zmienną z zakresu lokalnego, sprawdź funkcję <function>unset</function>.
</para>
</refsect1>

Expand All @@ -26,7 +27,7 @@
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
Loading

0 comments on commit 8b555a6

Please sign in to comment.