svn: /phpdoc/ru/trunk/ language/expressions.xml language/namespaces.xml language/references.xml language/wrappers/ftp.xml reference/curl/functions/curl-setopt.xml reference/filesystem/functions/glob.xml
[email protected] (Sergey Panteleev) Wed, 11 Nov 2020 09:11:44 +0000
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Wed, 11 Nov 2020 09:11:44 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=351358
Log:
docs(ru): Updated to English revision
Changed paths:
U phpdoc/ru/trunk/language/expressions.xml
U phpdoc/ru/trunk/language/namespaces.xml
U phpdoc/ru/trunk/language/references.xml
U phpdoc/ru/trunk/language/wrappers/ftp.xml
U phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml
U phpdoc/ru/trunk/reference/filesystem/functions/glob.xml
svn-diffs-351358.txt
(text/x-diff, 31.8 KB)
Modified: phpdoc/ru/trunk/language/expressions.xml
===================================================================
--- phpdoc/ru/trunk/language/expressions.xml 2020-11-11 06:46:11 UTC (rev 351357)
+++ phpdoc/ru/trunk/language/expressions.xml 2020-11-11 09:11:44 UTC (rev 351358)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 342074 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351133 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<chapter xml:id="language.expressions" xmlns="http://docbook.org/ns/docbook">
@@ -54,8 +54,8 @@
<simpara>
Разумеется, значения в PHP не обязаны быть целочисленными, и очень
часто ими не являются. PHP поддерживает четыре типа скалярных значений:
- целочисленные (<type>integer</type>), с плавающей точкой (<type>float</type>),
- строковые значения (<type>string</type>) и булевы (<type>boolean</type>)
+ целочисленные (<type>int</type>), с плавающей точкой (<type>float</type>),
+ строковые значения (<type>string</type>) и булевы (<type>bool</type>)
значения (скалярными являются значения, которые вы не можете 'разбить' на
меньшие части, в отличие, например, от массивов). PHP поддерживает также два
комбинированных (не скалярных) типа: массивы и объекты. Любое значение такого
Modified: phpdoc/ru/trunk/language/namespaces.xml
===================================================================
--- phpdoc/ru/trunk/language/namespaces.xml 2020-11-11 06:46:11 UTC (rev 351357)
+++ phpdoc/ru/trunk/language/namespaces.xml 2020-11-11 09:11:44 UTC (rev 351358)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351112 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 351340 Maintainer: mch Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
@@ -619,6 +619,7 @@
</example>
</para>
</sect1>
+
<sect1 xml:id="language.namespaces.importing">
<title>Использование пространств имен: импорт/создание псевдонима имени</title>
<?phpdoc print-version-for="namespaces"?>
@@ -628,13 +629,10 @@
файловых систем unix создавать символические ссылки на файл или директорию.
</para>
<para>
- Все версии PHP, поддерживающие пространства имен, поддерживают три вида создания
- псевдонима имени или импорта: создание псевдонима для имени класса, создание
- псевдонима для имени интерфейса и для имени пространства имен.
- PHP 5.6+ также поддерживает импорт функций и имен констант.
+ PHP может создавать псевдонимы имени/импортировать константы, функции, классы, интерфейсы и пространства имен.
</para>
<para>
- В PHP создание псевдонима имени выполняется с помощью оператора <literal>use</literal>.
+ Создание псевдонима имени выполняется с помощью оператора <literal>use</literal>.
Вот пример, показывающий 5 типов импорта:
<example>
<title>импорт/создание псевдонима имени с помощью оператора use</title>
@@ -650,13 +648,13 @@
// импортирование глобального класса
use ArrayObject;
-// импортирование функции (PHP 5.6+)
+// импортирование функции
use function My\Full\functionName;
-// псевдоним функции (PHP 5.6+)
+// псевдоним функции
use function My\Full\functionName as func;
-// импортирование константы (PHP 5.6+)
+// импортирование константы
use const My\Full\CONSTANT;
$obj = new namespace\Another; // создает экземпляр класса foo\Another
Modified: phpdoc/ru/trunk/language/references.xml
===================================================================
--- phpdoc/ru/trunk/language/references.xml 2020-11-11 06:46:11 UTC (rev 351357)
+++ phpdoc/ru/trunk/language/references.xml 2020-11-11 09:11:44 UTC (rev 351358)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 346847 Maintainer: irker Status: ready -->
+<!-- EN-Revision: 351340 Maintainer: irker Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<chapter xml:id="language.references" xmlns="http://docbook.org/ns/docbook">
@@ -78,9 +78,9 @@
var_dump(property_exists($c, 'd')); // bool(true)
?>
]]>
- </programlisting>
- </example>
- </para>
+ </programlisting>
+ </example>
+ </para>
</note>
<para>
Такой же синтаксис может использоваться в функциях, возвращающими ссылки,
@@ -92,19 +92,12 @@
$foo =& find_var($bar);
?>
]]>
- </programlisting>
- </informalexample>
- Начиная с PHP 5, <link linkend="language.oop5.basic.new">new</link>
- автоматически возвращает объекты по ссылке, поэтому использовать
- <literal>=&</literal> в этом случае не рекомендуется и вызывает
- сообщение <constant>E_DEPRECATED</constant> в PHP 5.3 и последующих версиях,
- а также сообщение <constant>E_STRICT</constant> в более ранних версиях.
- Начиная с PHP 7.0, это синтаксически некорректно.
- (Технически разница в том, что в PHP 5 переменные объекта, подобно ресурсам,
- являются просто указателем на фактические данные объекта, поэтому ссылки на объекты
- не те же самые "ссылки", о которых говорилось ранее (псевдонимы).
- Подробнее в <link linkend="language.oop5.references">Объекты
- и ссылки</link>.)
+ </programlisting>
+ </informalexample>
+ <link linkend="language.oop5.basic.new">new</link>
+ автоматически возвращает ссылку, поэтому она синтаксически некорректна.
+ Подробнее в <link linkend="language.oop5.references">Объекты
+ и ссылки</link>.)
</para>
<warning>
<para>
@@ -135,13 +128,13 @@
echo "значение var2: '$var2'\n"; // значение var2: 'Пример переменной'
?>
]]>
- </programlisting>
- </example>
- Думайте о <literal>global $var;</literal> как о сокращении от
- <literal>$var =& $GLOBALS['var'];</literal>. Таким образом,
- присвоение <literal>$var</literal> другой ссылки влияет лишь на локальную
- переменную.
- </para>
+ </programlisting>
+ </example>
+ Думайте о <literal>global $var;</literal> как о сокращении от
+ <literal>$var =& $GLOBALS['var'];</literal>. Таким образом,
+ присвоение <literal>$var</literal> другой ссылки влияет лишь на локальную
+ переменную.
+ </para>
</warning>
<note>
<para>
@@ -160,9 +153,9 @@
echo $ref; // 3 - последнее значение, используемое в цикле
?>
]]>
- </programlisting>
- </example>
- </para>
+ </programlisting>
+ </example>
+ </para>
</note>
<para>
Хотя в выражениях, создаваемых с помощью конструкции
@@ -180,8 +173,8 @@
/* $a == 2, $b == array(3, 4); */
?>
]]>
- </programlisting>
- </informalexample>
+ </programlisting>
+ </informalexample>
</para>
<para>
Однако следует отметить, что ссылки в массивах являются потенциально опасными.
@@ -207,10 +200,10 @@
/* Содержимое $arr изменилось, хотя было присвоено не по ссылке! */
?>
]]>
- </programlisting>
- </informalexample>
- Иными словами, поведение отдельных элементов массива
- не зависит от типа присвоения этого массива.
+ </programlisting>
+ </informalexample>
+ Иными словами, поведение отдельных элементов массива
+ не зависит от типа присвоения этого массива.
</para>
</sect2>
<sect2 xml:id="language.references.whatdo.pass">
@@ -231,14 +224,14 @@
foo($a);
?>
]]>
- </programlisting>
- </informalexample>
- Этот код присвоит <varname>$a</varname> значение 6. Это происходит, потому
- что в функции <varname>foo</varname> переменная <varname>$var</varname>
- ссылается на то же содержимое, что и переменная <varname>$a</varname>. См.
- также детальное объяснение
- <link linkend="language.references.pass">передачи по ссылке</link>.
- </para>
+ </programlisting>
+ </informalexample>
+ Этот код присвоит <varname>$a</varname> значение 6. Это происходит, потому
+ что в функции <varname>foo</varname> переменная <varname>$var</varname>
+ ссылается на то же содержимое, что и переменная <varname>$a</varname>. См.
+ также детальное объяснение
+ <link linkend="language.references.pass">передачи по ссылке</link>.
+ </para>
</sect2>
<sect2 xml:id="language.references.whatdo.return">
<title>Возврат по ссылке</title>
@@ -264,21 +257,21 @@
foo($bar);
?>
]]>
- </programlisting>
- </informalexample>
- </para>
- <simpara>
- Переменная <varname>$var</varname> в функции <varname>foo</varname> будет
- связана с <varname>$bar</varname> в вызывающем коде, но затем она будет
- перепривязана к <varname>$GLOBALS["baz"]</varname>. Нет способа связать
- <varname>$bar</varname> в области видимости вызывающем коде с чем-либо ещё
- путём использования механизма ссылок, поскольку <varname>$bar</varname> не
- доступна в функции <varname>foo</varname> (доступно лишь её значение через
- <varname>$var</varname>, но <varname>$var</varname> имеет только значение
- переменной и не имеет связи имя-значение в таблице имен переменных).
- Вы можете воспользоваться <link linkend="language.references.return">возвратом
- ссылок</link> из функции для привязки внешней перменной к другому значению.
- </simpara>
+ </programlisting>
+ </informalexample>
+ </para>
+ <simpara>
+ Переменная <varname>$var</varname> в функции <varname>foo</varname> будет
+ связана с <varname>$bar</varname> в вызывающем коде, но затем она будет
+ перепривязана к <varname>$GLOBALS["baz"]</varname>. Нет способа связать
+ <varname>$bar</varname> в области видимости вызывающем коде с чем-либо ещё
+ путём использования механизма ссылок, поскольку <varname>$bar</varname> не
+ доступна в функции <varname>foo</varname> (доступно лишь её значение через
+ <varname>$var</varname>, но <varname>$var</varname> имеет только значение
+ переменной и не имеет связи имя-значение в таблице имен переменных).
+ Вы можете воспользоваться <link linkend="language.references.return">возвратом
+ ссылок</link> из функции для привязки внешней перменной к другому значению.
+ </simpara>
</sect1>
<sect1 xml:id="language.references.pass">
@@ -299,33 +292,29 @@
// $a здесь равно 6
?>
]]>
- </programlisting>
- </informalexample>
- <note>
+ </programlisting>
+ </informalexample>
+ <note>
+ <simpara>
+ В вызове функции отсутствует знак ссылки - он есть только в
+ определении функции. Этого достаточно для корректной передачи аргументов по
+ ссылке.
+ </simpara>
+ </note>
+ </para>
+ <para>
+ По ссылке можно передавать:
+ <itemizedlist>
+ <listitem>
<simpara>
- В вызове функции отсутствует знак ссылки - он есть только в
- определении функции. Этого достаточно для корректной передачи аргументов по
- ссылке. Начиная с PHP 5.3.0, вы можете получить предупреждение о том,
- что передача переменной по ссылке устарела, если используете &
- в <literal>foo(&$a);</literal>.
- Начиная с PHP 5.4.0 передача переменной по ссылке стала невозможна, поэтому
- использование этого приема приведет к фатальной ошибке.
+ Переменные, например <literal>foo($a)</literal>
</simpara>
- </note>
- </para>
- <para>
- По ссылке можно передавать:
- <itemizedlist>
- <listitem>
- <simpara>
- Переменные, например <literal>foo($a)</literal>
- </simpara>
- </listitem>
- <listitem>
- <para>
- Ссылки, возвращаемые функцией, например:
- <informalexample>
- <programlisting role="php">
+ </listitem>
+ <listitem>
+ <para>
+ Ссылки, возвращаемые функцией, например:
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
<?php
function foo(&$var) {
@@ -345,12 +334,12 @@
</para>
</listitem>
</itemizedlist>
- </para>
- <para>
- Любое другое выражение не должно передаваться по ссылке, так как результат
- не определён. Например, следующая передача по ссылке является неправильной:
- <informalexample>
- <programlisting role="php">
+ </para>
+ <para>
+ Любое другое выражение не должно передаваться по ссылке, так как результат
+ не определён. Например, следующая передача по ссылке является неправильной:
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
<?php
function foo(&$var) {
@@ -360,8 +349,7 @@
$a = 5;
return $a;
}
-foo(bar()); // Вызывает неисправимую ошибку начиная с PHP 5.0.5
- // Стандартное строгое предупреждение с PHP 5.1.1 и предупреждение с PHP 7.0.0
+foo(bar()); // Вызывает предупреждение
foo($a = 5); // Выражение, а не переменная
foo(5); // Константа, а не переменная
@@ -376,7 +364,7 @@
]]>
</programlisting>
</informalexample>
- </para>
+ </para>
</sect1>
<sect1 xml:id="language.references.return">
@@ -406,36 +394,34 @@
echo $myValue; // отобразит новое значение $obj->value, то есть 2.
?>
]]>
- </programlisting>
- </informalexample>
- В этом примере устанавливается свойство объекта, возвращённого функцией
- <varname>getValue</varname>, а не его копии, как было бы без использования
- ссылок.
- </para>
- <note>
- <simpara>
- В отличие от передачи параметров по ссылке, <literal>&</literal>
- здесь нужно использовать в обоих местах - для указания на то, что вы
- возвращаете ссылку, а не копию, как обычно, и для указания того, что
- происходит связывание по ссылке, а не обычное присвоение
- для <varname>$myValue</varname>.
- </simpara>
- </note>
- <note>
- <simpara>
- Если вы возвращаете ссылку из функции, используя следующий синтаксис:
- <literal>return ($this->value);</literal>, это <emphasis>не</emphasis>
- будет работать, так как вы возвращаете по ссылке результат
- <emphasis>выражения</emphasis>, а не переменную. По ссылке можно
- возвращать только переменные и ничего больше. Начиная с PHP 5.1.0,
- если код пытается вернуть по ссылке динамическое выражение или результат оператора
- <literal>new</literal>, будет вызвано предупреждение <constant>E_NOTICE</constant>.
- </simpara>
- </note>
- <para>
- Для использования возвращаемой ссылки вы должны применять присвоение по ссылке:
- <informalexample>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ В этом примере устанавливается свойство объекта, возвращённого функцией
+ <varname>getValue</varname>, а не его копии, как было бы без использования
+ ссылок.
+ </para>
+ <note>
+ <simpara>
+ В отличие от передачи параметров по ссылке, <literal>&</literal>
+ здесь нужно использовать в обоих местах - для указания на то, что вы
+ возвращаете ссылку, а не копию, как обычно, и для указания того, что
+ происходит связывание по ссылке, а не обычное присвоение
+ для <varname>$myValue</varname>.
+ </simpara>
+ </note>
+ <note>
+ <simpara>
+ Если вы возвращаете ссылку из функции, используя следующий синтаксис:
+ <literal>return ($this->value);</literal>, это <emphasis>не</emphasis>
+ будет работать, так как вы возвращаете по ссылке результат
+ <emphasis>выражения</emphasis>, а не переменную. По ссылке можно
+ возвращать только переменные и ничего больше.
+ </simpara>
+ </note>
+ <para>
+ Для использования возвращаемой ссылки вы должны применять присвоение по ссылке:
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
<?php
function &collector() {
@@ -463,13 +449,13 @@
]]>
</programlisting>
</informalexample>
- </para>
- <note>
- <simpara>
- Заметим, что <literal>array_push(&collector(), 'foo');</literal>
- <emphasis>не</emphasis> сработает, а приведет к неисправимой ошибке.
- </simpara>
- </note>
+ </para>
+ <note>
+ <simpara>
+ Заметим, что <literal>array_push(&collector(), 'foo');</literal>
+ <emphasis>не</emphasis> сработает, а приведет к неисправимой ошибке.
+ </simpara>
+ </note>
</sect1>
<sect1 xml:id="language.references.unset">
@@ -487,14 +473,14 @@
unset($a);
?>
]]>
- </programlisting>
- </informalexample>
- Этот код не сбросит <varname>$b</varname>, а только <varname>$a</varname>.
- </para>
- <simpara>
- Опять же, можно провести аналогию с вызовом
- <command>unlink</command> (в Unix).
- </simpara>
+ </programlisting>
+ </informalexample>
+ Этот код не сбросит <varname>$b</varname>, а только <varname>$a</varname>.
+ </para>
+ <simpara>
+ Опять же, можно провести аналогию с вызовом
+ <command>unlink</command> (в Unix).
+ </simpara>
</sect1>
<sect1 xml:id="language.references.spot">
@@ -519,22 +505,22 @@
$var =& $GLOBALS["var"];
?>
]]>
- </programlisting>
- </informalexample>
- </para>
- <simpara>
- Это значит, например, что сброс (unset) <varname>$var</varname> не
- приведёт к сбросу глобальной переменной.
- </simpara>
- </sect2>
-
- <sect2 xml:id="references.this">
- <title><literal>$this</literal></title>
- <simpara>
- В методах объекта, <varname>$this</varname> всегда является ссылкой на
- вызываемый объект.
- </simpara>
- </sect2>
+ </programlisting>
+ </informalexample>
+ </para>
+ <simpara>
+ Это значит, например, что сброс (unset) <varname>$var</varname> не
+ приведёт к сбросу глобальной переменной.
+ </simpara>
+ </sect2>
+
+ <sect2 xml:id="references.this">
+ <title><literal>$this</literal></title>
+ <simpara>
+ В методах объекта, <varname>$this</varname> всегда является ссылкой на
+ вызываемый объект.
+ </simpara>
+ </sect2>
</sect1>
</chapter>
Modified: phpdoc/ru/trunk/language/wrappers/ftp.xml
===================================================================
--- phpdoc/ru/trunk/language/wrappers/ftp.xml 2020-11-11 06:46:11 UTC (rev 351357)
+++ phpdoc/ru/trunk/language/wrappers/ftp.xml 2020-11-11 09:11:44 UTC (rev 351358)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347043 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 351340 Maintainer: mch Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
@@ -80,10 +80,9 @@
<row>
<entry>Поддержка <function>stat</function></entry>
<entry>
- <function>filesize</function>,
+ <function>filesize</function>, <function>filemtime</function>,
<function>filetype</function>, <function>file_exists</function>,
<function>is_file</function> и <function>is_dir</function>.
- Начиная с PHP 5.1.0: <function>filemtime</function>.
</entry>
</row>
<row>
Modified: phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml
===================================================================
--- phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml 2020-11-11 06:46:11 UTC (rev 351357)
+++ phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml 2020-11-11 09:11:44 UTC (rev 351358)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351133 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351291 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
@@ -462,20 +462,6 @@
</entry>
</row>
<row>
- <entry valign="top"><constant>CURLOPT_SAFE_UPLOAD</constant></entry>
- <entry valign="top">
- &true; для отключения поддержки префикса <literal>@</literal> для
- загружаемых файлов в <constant>CURLOPT_POSTFIELDS</constant>, который
- означает, что значения, переданные с <literal>@</literal> могут безопасно
- передаваться в виде полей. Вместо префикса можно использовать опцию <classname>CURLFile</classname>.
- </entry>
- <entry valign="top">
- Добавлена в PHP 5.5.0 со значением по умолчанию &false;. В PHP 5.6.0
- стала по умолчанию равна &true;. В PHP 7 эта опция удалена.
- Для загрузки файлов необходимо использовать интерфейс CURLFile.
- </entry>
- </row>
- <row>
<entry valign="top"><constant>CURLOPT_SASL_IR</constant></entry>
<entry valign="top">
&true; для разрешения отправки инициирующего ответа в первом пакете.
@@ -1546,10 +1532,7 @@
<entry valign="top">
<simpara>
Все данные, передаваемые в HTTP POST-запросе.
- Для передачи файла, укажите перед именем файла <literal>@</literal>, а
- также используйте полный путь к файлу. Тип файла также может
- быть указан с помощью формата '<literal>;type=mimetype</literal>',
- следующим за именем файла. Этот параметр может быть передан
+ Этот параметр может быть передан
как в качестве url-закодированной строки, наподобие
'<literal>para1=val1&para2=val2&...</literal>', так и
в виде массива, ключами которого будут имена полей, а значениями
@@ -1559,17 +1542,9 @@
значение <literal>multipart/form-data</literal>.
</simpara>
<simpara>
- Начиная с PHP 5.2.0, при передаче файлов с префиксом
- <literal>@</literal>, <parameter>value</parameter> должен быть
- массивом.
+ Файлы можно отправлять с использованием <classname>CURLFile</classname>,
+ в этом случае <parameter>value</parameter> должен быть массивом.
</simpara>
- <simpara>
- С PHP 5.5.0 префикс <literal>@</literal> устарел и
- файлы можно отправлять с помощью <classname>CURLFile</classname>.
- Префикс <literal>@</literal> можно отключить, чтобы можно
- было передавать значения, начинающиеся с <literal>@</literal>,
- задав опцию <constant>CURLOPT_SAFE_UPLOAD</constant> в значение &true;.
- </simpara>
</entry>
<entry valign="top">
</entry>
@@ -2402,55 +2377,6 @@
</programlisting>
</example>
</para>
- <para>
- <example>
- <title>Закачка файла (устарело с PHP 5.5.0)</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-
-/* http://localhost/upload.php:
-print_r($_POST);
-print_r($_FILES);
-*/
-
-$ch = curl_init();
-
-$data = array('name' => 'Foo', 'file' => '@/home/user/test.png');
-
-curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');
-curl_setopt($ch, CURLOPT_POST, 1);
-curl_setopt($ch, CURLOPT_SAFE_UPLOAD, false); // требуется с PHP 5.6.0
-curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
-
-curl_exec($ch);
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-Array
-(
- [name] => Foo
-)
-Array
-(
- [file] => Array
- (
- [name] => test.png
- [type] => image/png
- [tmp_name] => /tmp/phpcpjNeQ
- [error] => 0
- [size] => 279
- )
-
-)
-
-]]>
- </screen>
- </example>
- </para>
</refsect1>
<refsect1 role="notes">
Modified: phpdoc/ru/trunk/reference/filesystem/functions/glob.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/glob.xml 2020-11-11 06:46:11 UTC (rev 351357)
+++ phpdoc/ru/trunk/reference/filesystem/functions/glob.xml 2020-11-11 09:11:44 UTC (rev 351358)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350653 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351342 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.glob">
@@ -7,7 +7,7 @@
<refname>glob</refname>
<refpurpose>Находит файловые пути, совпадающие с шаблоном</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -22,7 +22,7 @@
правила, используемые большинством распространённых оболочек.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -113,6 +113,12 @@
</simpara>
</listitem>
</itemizedlist>
+ <note>
+ <simpara>
+ Флаг <constant>GLOB_BRACE</constant> недоступен на некоторых
+ не GNU-системах, например, Solaris.
+ </simpara>
+ </note>
</para>
</listitem>
</varlistentry>
@@ -119,7 +125,7 @@
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -134,7 +140,7 @@
</para>
</note>
</refsect1>
-
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -163,23 +169,17 @@
</example>
</para>
</refsect1>
-
+
<refsect1 role="notes">
&reftitle.notes;
¬e.no-remote;
<note>
<simpara>
- Эта функция недоступна на некоторых системах (например, старой Sun OS).
+ Функция недоступна на некоторых системах (например, старой Sun OS).
</simpara>
</note>
- <note>
- <simpara>
- Флаг <constant>GLOB_BRACE</constant> недоступен на некоторых
- не GNU-системах, например, Solaris.
- </simpara>
- </note>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -191,7 +191,7 @@
</simplelist>
</para>
</refsect1>
-
+
</refentry>
<!-- Keep this comment at the end of the file