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