fnmatch.xml Вернул ' и " для литералов, удалил лишние ?>…

…уточнил перевод

Author: mmalferov

reference/filesystem/functions/fnmatch.xml

@@ -17,8 +17,8 @@
   </methodsynopsis>
   <para>
    Функция <function>fnmatch</function> проверяет, совпадает ли название файла
-   или строка <parameter>filename</parameter> с шаблоном <parameter>pattern</parameter>,
-   который состоит из подстановочных знаков командной оболочки.
+   или другая строка в аргументе <parameter>filename</parameter> с шаблоном <parameter>pattern</parameter>,
+   который поддерживает подстановочные знаки командной оболочки.
   </para>
  </refsect1>
 
@@ -30,9 +30,9 @@
      <term><parameter>pattern</parameter></term>
      <listitem>
       <para>
-       Шаблон <parameter>pattern</parameter>, с которым нужно сопоставить. Часто аргумент
-       <parameter>pattern</parameter> будет содержать
-       подстановочные знаки вроде <literal>«?»</literal> и <literal>«*»</literal>.
+       Шаблон <parameter>pattern</parameter>, с которым требуется сопоставить строку.
+       В аргумент <parameter>pattern</parameter> часто включают
+       подстановочные знаки наподобие <literal>'?'</literal> и <literal>'*'</literal>.
        <table>
         <title>
          Подстановочные знаки параметра <parameter>pattern</parameter>
@@ -50,45 +50,45 @@
             <literal>?</literal>
            </entry>
            <entry>
-            Вопросительный знак будет соответствовать любому отдельному символу.
-            Например, шаблон <literal>«file?.txt»</literal> будет соответствовать названиям
-            файлов <literal>«file1.txt»</literal> и <literal>«fileA.txt»</literal>,
-            но не будет соответствовать названию файла <literal>«file10.txt»</literal>.
+            Вопросительный знак соответствует одному произвольному символу.
+            Шаблон <literal>"file?.txt"</literal> совпадёт с названиями
+            файлов <literal>"file1.txt"</literal> и <literal>"fileA.txt"</literal>,
+            но не совпадёт с названем <literal>"file10.txt"</literal>.
            </entry>
           </row>
           <row>
            <entry>
             <literal>*</literal>
            </entry>
            <entry>
-            Звёздочка будет соответствовать нулю или нескольким символам.
-            Например, шаблон <literal>«foo*.xml»</literal> будет соответствовать названиям файлов
-            <literal>«foo.xml»</literal> или <literal>«foobar.xml»</literal>.
+            Звёздочка соответствует нулю или большему количеству символов.
+            Шаблон <literal>"foo*.xml"</literal> совпадёт и с названием файла
+            <literal>"foo.xml"</literal>, и с названием <literal>"foobar.xml"</literal>.
            </entry>
           </row>
           <row>
            <entry>
             <literal>[ ]</literal>
            </entry>
            <entry>
-            Квадратные скобки создают диапазон кодовых точек кодировки ASCII или набор символов.
-            Например, шаблон <literal>«index.php[45]»</literal> будет соответствовать названиям файлов
-            <literal>«index.php4»</literal> и <literal>«index.php5»</literal>, но не будет
-            соответствовать названию файла <literal>«index.phpt»</literal>.
-            Диапазоны, которыми часто пользуются, — <literal>[0-9]</literal>, <literal>[a-z]</literal>
-            и <literal>[A-Z]</literal>. Разрешено указывать больше одного набора или диапазона одновременно,
-            например <literal>[0-9a-zABC]</literal>.
+            Квадратные скобки задают диапазоны или наборы отдельных символов в границах кодовых точек стандарта ASCII.
+            Шаблон <literal>"index.php[45]"</literal> совпадёт с названиями файлов
+            <literal>"index.php4"</literal> и <literal>"index.php5"</literal>,
+            но не совпадёт с названием <literal>"index.phpt"</literal>.
+            Популярные символьные группы: <literal>[0-9]</literal>, <literal>[a-z]</literal>
+            и <literal>[A-Z]</literal>. Квадратные скобки поддерживают комбинации диапазонов и наборов символов:
+            <literal>[0-9a-zABC]</literal>.
            </entry>
           </row>
           <row>
            <entry>
             <literal>!</literal>
            </entry>
            <entry>
-            Восклицательный знак указывают для совпадения с символами,
-            которых нет в квадратных скобках. Например, шаблон <literal>«[!A-Z]*.html»</literal>
-            будет соответствовать названию файла <literal>«demo.html»</literal>,
-            но не будет соответствовать названию <literal>«Demo.html»</literal>.
+            Восклицательный знак указывают для отрицания символов
+            внутри квадратных скобок. Шаблон <literal>"[!A-Z]*.html"</literal>
+            совпадёт с названием файла <literal>"demo.html"</literal>,
+            но не совпадёт с названием <literal>"Demo.html"</literal>.
            </entry>
           </row>
           <row>
@@ -97,8 +97,8 @@
            </entry>
            <entry>
             Обратный слеш экранирует специальные символы.
-            Например, шаблон <literal>«Name\?»</literal> будет соответствовать строке
-            <literal>«Name?»</literal>, не будет соответствовать строке <literal>«Names»</literal>.
+            Шаблон <literal>"Name\?"</literal> совпадёт со строкой
+            <literal>"Name?"</literal>, не совпадёт со строкой <literal>"Names"</literal>.
            </entry>
           </row>
          </tbody>
@@ -111,17 +111,16 @@
      <term><parameter>filename</parameter></term>
      <listitem>
       <para>
-       Проверяемая строка. Функцией часто проверяют имена файлов,
+       Проверяемая строка. Функцией чаще проверяют названия файлов,
        но также проверяют строки.
       </para>
       <para>
-       Среднеподготовленные посетители сайтов пользуются шаблонами
-       командной оболочки или хотя бы несложными формами
-       подстановок вроде <literal>«?»</literal> и <literal>«*»</literal>.
-       Поэтому для сопоставления поискового выражения, которое
-       в пользовательской части сайта вводят незнакомые с программированием
-       пользователи, вместо функции <function>preg_match</function> лучше пользоваться
-       функцией <function>fnmatch</function>.
+       Среднестатистический пользователь сайта или приложения привык строить
+       шаблоны в стиле командной оболочки, по крайней мере
+       с простейшими подстановками наподобие <literal>'?'</literal> и <literal>'*'</literal>.
+       Поэтому незнакомым с программированием пользователям проще вводить поисковые запросы
+       с подстановочными символами, а не с регулярными выражениями, а программисту обрабатывать
+       функцией <function>fnmatch</function>, а не <function>preg_match</function>.
       </para>
      </listitem>
     </varlistentry>
@@ -131,11 +130,10 @@
       <para>
        Параметр <parameter>flags</parameter> принимает
        комбинации следующих флагов, которые объединяют
-       <link linkend="language.operators.bitwise">двоичным оператором
-       ИЛИ (|)</link>.
+       <link linkend="language.operators.bitwise">оператором | — побитового ИЛИ</link>.
        <table>
         <title>
-         Список возможных флагов для функции <function>fnmatch</function>
+         Список флагов, которые поддерживает функция <function>fnmatch</function>
         </title>
         <tgroup cols="2">
          <thead>
@@ -148,25 +146,25 @@
           <row>
            <entry><constant>FNM_NOESCAPE</constant></entry>
            <entry>
-            Отключить экранирование обратным слешем.
+            Отключить экранирование обратным слешем — интерпретировать как обыкновенный символ.
            </entry>
           </row>
           <row>
            <entry><constant>FNM_PATHNAME</constant></entry>
            <entry>
-            Слеш в строке совпадает только со слешем в шаблоне.
+            Исключить совпадение слеша в строке с подстановочными символами шаблона.
            </entry>
           </row>
           <row>
            <entry><constant>FNM_PERIOD</constant></entry>
            <entry>
-            Ведущая точка в строке должна точно совпадать с точкой в шаблоне.
+            Исключить совпадение точки в начале строки с подстановочными символами шаблона.
            </entry>
           </row>
           <row>
            <entry><constant>FNM_CASEFOLD</constant></entry>
            <entry>
-            Совпадение без учёта регистра. Часть расширения GNU.
+            Сопоставлять строки без учёта регистра. Флаг — часть расширения поведения функции в наборе инструментов GNU.
            </entry>
           </row>
          </tbody>
@@ -182,24 +180,22 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Функция возвращает &true; при совпадении, иначе &false;.
+   Функция возвращает &true;, если строка совпадает с шаблоном, иначе &false;.
   </para>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title>Проверка соответствия названия цвета шаблону подстановки командной оболочки</title>
+    <title>Проверка соответствия названия цвета шаблону с подстановочными символами командной оболочки</title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
 if (fnmatch("*gr[ae]y", $color)) {
     echo "Какая-то форма серого цвета...";
 }
-
-?>
 ]]>
     </programlisting>
    </example>
@@ -210,8 +206,8 @@ if (fnmatch("*gr[ae]y", $color)) {
   &reftitle.notes;
   <warning>
    <para>
-    Функция пока недоступна на POSIX-несовместимых системах,
-    кроме Windows.
+    Функция пока доступна только на POSIX-совместимых системах
+    и в ОС Windows.
    </para>
   </warning>
  </refsect1>