tronic Fri Dec 21 15:58:57 2001 EDT
Modified files:
/phpdoc/ru language-snippets.ent preface.xml
Log:
Up-to-date changes applied.
Index: phpdoc/ru/language-snippets.ent
diff -u phpdoc/ru/language-snippets.ent:1.3 phpdoc/ru/language-snippets.ent:1.4
--- phpdoc/ru/language-snippets.ent:1.3 Wed Nov 21 19:02:03 2001
+++ phpdoc/ru/language-snippets.ent Fri Dec 21 15:58:57 2001
@@ -1,38 +1,77 @@
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
-<!ENTITY warn.experimental '<warning><simpara>Этот модуль является
<emphasis>ЭКСПЕРИМЕНТАЛЬНЫМ</emphasis>. Это означает, что поведение этих функций,
имена этих функций, а именно, ВСЁ, что документировано здесь, может быть изменено в
следующей версии PHP БЕЗ ПРЕДУПРЕЖДЕНИЯ. Будьте осторожны, используйте этот модуль на
свой страх и риск.</simpara></warning>'>
-<!ENTITY warn.experimental.func '<warning><simpara>Эта функция является
<emphasis>ЭКСПЕРИМЕНТАЛЬНОЙ</emphasis>. Это означает, что поведение этой функции, имя
этой функции, а именно, ВСЁ, что документировано здесь, может быть изменено в
следующей версии PHP БЕЗ ПРЕДУПРЕЖДЕНИЯ. Будьте осторожны, используйте эту функцию на
свой страх и риск.</simpara></warning>'>
+<!ENTITY warn.experimental '<warning><simpara>Это расширение является
+<emphasis>ЭКСПЕРИМЕНТАЛЬНЫМ</emphasis>. Поведение этого расширения,
+включая имена его функций и всю документацию, относящуюся к этому
+расширению, может измениться в последующих версиях PHP без предупреждения.
+Используйте это расширение на свой страх и риск.</simpara></warning>'>
+
+<!ENTITY warn.experimental.func '<warning><simpara>Эта функция
+является <emphasis>ЭКСПЕРИМЕНТАЛЬНОЙ</emphasis>. Поведение этой
+функции, имя этой функции и вся документация, относящаяся к этой
+функции, могут измениться в последующих версиях PHP без предупреждения.
+Используйте эту функцию на свой страх и риск.</simpara></warning>'>
+
+<!ENTITY warn.undocumented.func '<warning><simpara>В настоящее время
+эта функция не документирована, доступен только список ее
+аргументов.</simpara></warning>'>
+
+<!ENTITY tip.ob-capture '<tip><simpara>Как и со всеми средствами,
+выводящими результат выполнения непосредственно в браузер, вы
+можете использовать <link
+linkend="ref.outcontrol">функции контроля вывода</link> для перехвата
+вывода результатов этой функции и сохранения их, например, в
+<type>строке</type>.</simpara></tip>'>
+
+<!ENTITY tip.fopen-wrapper '<tip><simpara>В этой функции вы можете
+использовать URL в качестве имени файла, если была включена опция
+"fopen wrappers" См. <function>fopen</function> для более детальных
+сведений.</simpara></tip>'>
+
+<!ENTITY return.success 'Возвращает &true; в случае успешного
+завершения, &false; в обратном случае.'>
+
+<!ENTITY return.falseproblem '<warning><simpara>Эта функция может
+возвращать &false;, но также может вызвращать значение, вычисляемое
+как &false; в простом операторе if. Пожалуйста, используйте <link
+linkend="language.operators.comparison">оператор ===</link> с целью
+проверки значения, возвращаемого этой функцией.</simpara></warning>'>
-<!ENTITY tip.ob-capture '<tip><simpara>Как и со всеми функциями, которые выводят
результат непосредственно в броузер, вы можете использовать <link
linkend="ref.outcontrol">функции контроля за выводом</link> для перехвата вывода
результатов этой функции, и сохранять их, например, в <type>строковом
виде</type>.</simpara></tip>'>
+<!-- Various notes -->
+<!ENTITY note.not-bin-safe '<warning><simpara>Эта функция (пока)
+не является безопасной для обработки двоичных данных!</simpara></warning>'>
-<!ENTITY return.success 'Возвращает &true; в случае успешного завершения, иначе -
&false;.'>
+<!ENTITY note.bin-safe '<note><simpara>Эта функция является
+безопасной для обработки двоичных данных.</simpara></note>'>
-<!ENTITY return.falseproblem '<warning><simpara>Эта функция может возвращать &false;,
но также может возвращать значение, вычисляемое в &false; в простом операторе if.
Пожалуйста, используйте <link linkend="language.operators.comparison">оператор
===</link> для проверки значения, возвращаемого этой функцией.</simpara></warning>'>
+<!ENTITY note.no-windows '<note><simpara>Эта функция недоступна
+на платформе Windows.</simpara></note>'>
-<!-- Various notes -->
-<!ENTITY note.not-bin-safe '<warning><simpara>Эту функцию (пока) нельзя использовать
с двочиными данными!</simpara></warning>'>
-<!ENTITY note.bin-safe '<note><simpara>Эту функцию можно использовать с двоичными
данными</simpara></note>'>
-<!ENTITY note.no-windows '<note><simpara>Эта функция недоступна для
Windows-платформ</simpara></note>'>
+<!ENTITY note.func-callback '<note><simpara>Вместо имени функции
+может быть указан массив, содержащий указатель на объект и имя
+метода.</simpara></note>'>
<!-- Notes for safe-mode limited functions: -->
<!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'>
-<!ENTITY note.sm.uidcheck '<note><simpara>Когда <link
-linkend="features.safe-mode">безопасный режим</link> включен, PHP проверяет,
-имеют ли файл(ы)/каталоги, над которыми вы собираетесь произвести операцию,
-такой же UID, как и выполняемый скрипт.</simpara></note>'>
-<!ENTITY note.sm.uidcheck.dir '<note><simpara>Когда <link
-linkend="features.safe-mode">безопасный режим</link> включен, PHP проверяет,
-имеет ли каталог, над которым вы собираетесь произвести операцию,
+
+<!ENTITY note.sm.uidcheck '<note><simpara>Когда режим <link
+linkend="features.safe-mode">safe mode</link> включен, PHP проверяет,
+имеют ли файл(ы)/каталог(и), над которыми вы собираетесь произвести
+операцию, такой же UID, как и выполняемый скрипт.</simpara></note>'>
+
+<!ENTITY note.sm.uidcheck.dir '<note><simpara>Когда режим <link
+linkend="features.safe-mode">safe mode</link> включен, PHP проверяет,
+имеет ли каталог, в котором вы собираетесь произвести операцию,
такой же UID, как и выполняемый скрипт.</simpara></note>'>
<!-- Common pieces in features/safe-mode.xml
Jade doesn't allow in-line entities, so I put them here... Though they
should have been inline in safe-mode.xml -->
-<!ENTITY sm.uidcheck 'Проверяет, имеют ли файл(ы)/каталоги, над которыми
-вы собираетесь произвести операцию, такой же UID, как и выполняемый
-скрипт.'>
-<!ENTITY sm.uidcheck.dir 'Проверяет, имеет ли каталог, над которым
-вы собираетесь произвести операцию, такой же UID, как и выполняемый
-скрипт.'>
-<!ENTITY sm.disabled 'Эта функция недоступна в <link
-linkend="features.safe-mode">безопасном режиме</link>'>
+<!ENTITY sm.uidcheck 'Проверяет, имеют ли файл(ы)/каталог(и), над которыми
+вы собираетесь произвести операцию, такой же UID, как и выполняемый скрипт.'>
+
+<!ENTITY sm.uidcheck.dir 'Проверяет, имеет ли каталог, в котором вы
+собираетесь произвести операцию, такой же UID, как и выполняемый скрипт.'>
+
+<!ENTITY sm.disabled 'Эта функция недоступна в режиме <link
+linkend="features.safe-mode">safe mode</link>.'>
Index: phpdoc/ru/preface.xml
diff -u phpdoc/ru/preface.xml:1.4 phpdoc/ru/preface.xml:1.5
--- phpdoc/ru/preface.xml:1.4 Wed Dec 12 15:56:39 2001
+++ phpdoc/ru/preface.xml Fri Dec 21 15:58:57 2001
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<preface id="preface">
<title>Предисловие</title>
@@ -7,57 +7,30 @@
<abstract>
<simpara>
<acronym>PHP</acronym>, что означает "PHP: Hypertext
- Preprocessor (PHP: Препроцессор гипертекста)",
- является внедряемым в HTML языком создания скриптов с открытым кодом.
- Многое из его синтаксиса было позаимствовано из C, Java и Perl
- с добавлением некоторых уникальных отличительных особенностей.
- Главной целью языка является предоставление web-разработчикам
- возможности быстро создавать динамически генерируемые страницы.
- Однако, с помощью PHP вы можете делать и многое другое. Читайте дальше,
- и вы увидите сами.
+ Preprocessor", является внедряемым в HTML языком написания
+ скриптов с открытым исходным кодом. Многое из его синтаксиса
+ было позаимствовано из C, Java и Perl с добавлением некоторых
+ уникальных особенностей. Главной целью языка является
+ предоставлением web-разработчикам быстрого создания динамически
+ генерируемых страниц; но с помощью PHP вы сможете делать
+ и намного большее.
</simpara>
</abstract>
- <sect1 id="about">
- <title>Об этом справочнике</title>
- <para>
- Этот справочник написан на <acronym>XML</acronym> с использованием <ulink
- url="&url.docbook.xml;">DocBook XML DTD</ulink>, с использованием <ulink
- url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
- Style and Semantics Specification Language) для форматирования.
- Утилиты для форматирования <acronym>HTML</acronym> и
- <acronym>TeX</acronym> версий -
- <ulink url="&url.jade;">Jade</ulink>, автор - <ulink
- url="&url.jclark;">James Clark</ulink> и <ulink
- url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
- автор - <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
- Мы используем <ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink>
- для создания справочника в формате Windows HTML Help.
- </para>
- <para>
- Вы можете загрузить справочник на различных языках и в различных
- форматах, включая текстовый, <acronym>HTML</acronym>,
- <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo и
- Windows HTML Help, по адресу <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
- Справочники обновляются по мере внесения изменений в исходные XML-файлы.
- </para>
- <para>
- Вы можете найти дополнительную информацию о загрузке
- исходного кода этой документации в формате <acronym>XML</acronym>
- по адресу <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>.
- Документация хранится в модуле <literal>phpdoc</literal>.
- </para>
- <para>
- Если вы обнаружите ошибки в этом справочнике, пожалуйста,
- сообщите о них, используя систему сообщения об ошибках по адресу:
- <ulink url="&url.php.bugs;">&url.php.bugs;</ulink> и классифицируйте
- их как "Documentation Problem". Таким образом мы сможем отследить
- каждую ошибку и избавить от них документацию. Не сообщайте об
- ошибках или предложениях и дополнениях, используя систему
- аннотирования.
- </para>
- </sect1>
+ <para>
+ Главным образом, это руководство состоит из справочника по
+ функциям, но также содержит справочник по языку, объяснение
+ некоторых главных особенностей PHP и другую дополнительную
+ информацию.
+ </para>
+ <para>
+ Вы можете получить это руководство в нескольких форматах
+ по адресу <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
+ Руководство обновляется по мере внесения в него изменений.
+ Более подробные сведения о разработке этого руководства
+ могут быть найдены в приложении <link linkend="about">'О руководстве'</link>.
+ </para>
</preface>
<!-- Keep this comment at the end of the file
