cvs: phpdoc-ru / language-snippets.ent

derick Mon Nov 25 11:22:12 2002 EDT Modified files: /phpdoc-ru language-snippets.ent Log: - Add entities

Index: phpdoc-ru/language-snippets.ent diff -u phpdoc-ru/language-snippets.ent:1.12 phpdoc-ru/language-snippets.ent:1.13 --- phpdoc-ru/language-snippets.ent:1.12 Mon Sep 16 15:50:11 2002 +++ phpdoc-ru/language-snippets.ent Mon Nov 25 11:22:11 2002 @@ -1,127 +1,134 @@ <!-- EN-Revision: 1.30 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.12 $ --> - -<!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 warn.no-win32-fopen-wrapper '<warning><para> - íàñòîÿùåå âðåìÿ âåðñèÿ <literal>PHP</literal> äëÿ Windows -íå ïîääåðæèâàåò âîçìîæíîñòü èñïîëüçîâàíèÿ óäàëåííûõ ôàéëîâ -ýòîé ôóíêöèåé äàæå â òîì ñëó÷àå, åñëè âêëþ÷åíà îïöèÿ -<link linkend="ini.allow-url-fopen">allow_url_fopen</link>.</para></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;, íàïðèìåð, <literal>0</literal> èëè -&quot;&quot;. Çà áîëåå ïîäðîáíîé èíôîðìàöèè îáðàòèòåñü ê ðàçäåëó <link -linkend="language.types.boolean">Ëîãè÷åñêèå òèïû</link>. Èñïîëüçóéòå <link -linkend="language.operators.comparison">îïåðàòîð ===</link> äëÿ ïðîâåðêè çíà÷åíèÿ, -âîçâðàùàåìîãî ýòîé ôóíêöèåé.</simpara></warning>'> - -<!-- 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">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">safe mode</link>.'> - -<!-- Common pieces in partintro-sections --> -<!ENTITY no.config '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå äèðåêòèâû êîíôèãóðàöèè â &php.ini;.</para>'> -<!ENTITY no.resource '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå òèïû ðåñóðñîâ.</para>'> -<!ENTITY no.constants '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå êîíñòàíòû.</para>'> -<!ENTITY no.requirement '<para>Ýòè ôóíêöèè âñåãäà äîñòóïíû.</para>'> -<!ENTITY no.install '<para>Äëÿ èñïîëüçîâàíèÿ ýòèõ ôóíêöèé íå òðåáóåòñÿ ïðîâåäåíèå óñòàíîâêè, -ïîñêîëüêó îíè ÿâëÿþòñÿ ÷àñòüþ ÿäðà PHP.</para>'> - +<!-- $Revision: 1.13 $ --> + +<!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 warn.no-win32-fopen-wrapper '<warning><para> + íàñòîÿùåå âðåìÿ âåðñèÿ <literal>PHP</literal> äëÿ Windows +íå ïîääåðæèâàåò âîçìîæíîñòü èñïîëüçîâàíèÿ óäàëåííûõ ôàéëîâ +ýòîé ôóíêöèåé äàæå â òîì ñëó÷àå, åñëè âêëþ÷åíà îïöèÿ +<link linkend="ini.allow-url-fopen">allow_url_fopen</link>.</para></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;, íàïðèìåð, <literal>0</literal> èëè +&quot;&quot;. Çà áîëåå ïîäðîáíîé èíôîðìàöèè îáðàòèòåñü ê ðàçäåëó <link +linkend="language.types.boolean">Ëîãè÷åñêèå òèïû</link>. Èñïîëüçóéòå <link +linkend="language.operators.comparison">îïåðàòîð ===</link> äëÿ ïðîâåðêè çíà÷åíèÿ, +âîçâðàùàåìîãî ýòîé ôóíêöèåé.</simpara></warning>'> + +<!-- Various notes --> +<!ENTITY note.not-bin-safe '<warning><simpara>Ýòà ôóíêöèÿ (ïîêà) +íå áåçîïàñíà äëÿ îáðàáîòêè äàííûõ â äâîè÷íîé ôîðìå!</simpara></warning>'> + +<!ENTITY note.bin-safe '<note><simpara>Ýòà ôóíêöèÿ áåçîïàñíà +äëÿ îáðàáîòêè äàííûõ â äâîè÷íîé ôîðìå.</simpara></note>'> + +<!ENTITY note.line-endings '<note><simpara>If you are having problems +with <literal>PHP</literal> not recognizing the line endings when +reading files either on or created by a Macintosh computer, you +might want to enable the <link linkend="ini.auto-detect-line-endings" +>auto_detect_line_endings</link> run-time configuration option.</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">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">safe mode</link>.'> + +<!-- Common pieces in partintro-sections --> +<!ENTITY no.config '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå äèðåêòèâû êîíôèãóðàöèè â &php.ini;.</para>'> +<!ENTITY no.resource '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå òèïû ðåñóðñîâ.</para>'> +<!ENTITY no.constants '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå êîíñòàíòû.</para>'> +<!ENTITY no.requirement '<para>Ýòè ôóíêöèè âñåãäà äîñòóïíû.</para>'> +<!ENTITY no.install '<para>Äëÿ èñïîëüçîâàíèÿ ýòèõ ôóíêöèé íå òðåáóåòñÿ ïðîâåäåíèå óñòàíîâêè, +ïîñêîëüêó îíè ÿâëÿþòñÿ ÷àñòüþ ÿäðà PHP.</para>'> + <!-- Used in reference/$extname/ini.xml --> <!ENTITY extension.runtime '<simpara> Ïîâåäåíèå ýòèõ ôóíêöèé íàõîäèòñÿ â çàâèñèìîñòè îò óñòàíîâîê â &php.ini;. </simpara>'> -<!-- Used in reference/$extname/constants.xml --> -<!ENTITY extension.constants '<simpara> -Ïåðå÷èñëåííûå íèæå êîíñòàíòû îïðåäåëåíû äàííûì ðàñøèðåíèåì è ìîãóò áûòü -äîñòóïíû òîëüêî â òîì ñëó÷àå, åñëè PHP áûë ñîáðàí ñ -ïîääåðæêîé ýòîãî ðàñøèðåíèÿ èëè æå â òîì ñëó÷àå, åñëè -äàííîå ðàñøèðåíèå ïîäãðóæàåòñÿ âî âðåìÿ âûïîëíåíèÿ. -</simpara>'> - -<!-- For STANDARD Constants used in reference/$extname/constants.xml --> -<!ENTITY extension.constants.core '<simpara> -Ïåðå÷èñëåííûå íèæó êîíñòàíòû âñåãäà äîñòóïíû êàê ÷àñòü ÿäðà PHP. -</simpara>'> - -<!-- Used in reference/$extname/classes.xml --> -<!ENTITY extension.classes '<simpara> -Ïåðå÷èñëåííûå íèæå êëàññû îïðåäåëÿþòñÿ äàííûì ðàñøèðåíèåì è -äîñòóïíû òîëüêî êîãäà PHP áûë ñîáðàí ñ ýòèì -ðàñøèðåíèåì èëè ýòî ðàñøèðåíèå áûëî äèíàìè÷åñêè -çàãðóæåíî âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. -</simpara>'> - -<!-- These are using in reference/$extname/reference.xml and other -supplemental files to mark section titles --> -<!ENTITY reftitle.intro '<title>Ââåäåíèå</title>'> -<!ENTITY reftitle.required '<title>Òðåáîâàíèÿ</title>'> -<!ENTITY reftitle.install '<title>Óñòàíîâêà</title>'> -<!ENTITY reftitle.runtime '<title>Íàñòðîéêà âî âðåìÿ âûïîëíåíèÿ</title>'> -<!ENTITY reftitle.resources '<title>Òèïû ðåñóðñîâ</title>'> -<!ENTITY reftitle.constants '<title>Ïðåäîïðåäåëåííûå êîíñòàíòû</title>'> -<!ENTITY reftitle.classes '<title>Ïðåäîïðåäåëåííûå êëàññû</title>'> -<!ENTITY reftitle.examples '<title>Ïðèìåðû</title>'> -<!ENTITY reftitle.seealso '<title>Ñìîòðèòå òàêæå</title>'> +<!-- Used in reference/$extname/constants.xml --> +<!ENTITY extension.constants '<simpara> +Ïåðå÷èñëåííûå íèæå êîíñòàíòû îïðåäåëåíû äàííûì ðàñøèðåíèåì è ìîãóò áûòü +äîñòóïíû òîëüêî â òîì ñëó÷àå, åñëè PHP áûë ñîáðàí ñ +ïîääåðæêîé ýòîãî ðàñøèðåíèÿ èëè æå â òîì ñëó÷àå, åñëè +äàííîå ðàñøèðåíèå ïîäãðóæàåòñÿ âî âðåìÿ âûïîëíåíèÿ. +</simpara>'> + +<!-- For STANDARD Constants used in reference/$extname/constants.xml --> +<!ENTITY extension.constants.core '<simpara> +Ïåðå÷èñëåííûå íèæó êîíñòàíòû âñåãäà äîñòóïíû êàê ÷àñòü ÿäðà PHP. +</simpara>'> + +<!-- Used in reference/$extname/classes.xml --> +<!ENTITY extension.classes '<simpara> +Ïåðå÷èñëåííûå íèæå êëàññû îïðåäåëÿþòñÿ äàííûì ðàñøèðåíèåì è +äîñòóïíû òîëüêî êîãäà PHP áûë ñîáðàí ñ ýòèì +ðàñøèðåíèåì èëè ýòî ðàñøèðåíèå áûëî äèíàìè÷åñêè +çàãðóæåíî âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. +</simpara>'> + +<!-- These are using in reference/$extname/reference.xml and other +supplemental files to mark section titles --> +<!ENTITY reftitle.intro '<title>Ââåäåíèå</title>'> +<!ENTITY reftitle.required '<title>Òðåáîâàíèÿ</title>'> +<!ENTITY reftitle.install '<title>Óñòàíîâêà</title>'> +<!ENTITY reftitle.runtime '<title>Íàñòðîéêà âî âðåìÿ âûïîëíåíèÿ</title>'> +<!ENTITY reftitle.resources '<title>Òèïû ðåñóðñîâ</title>'> +<!ENTITY reftitle.constants '<title>Ïðåäîïðåäåëåííûå êîíñòàíòû</title>'> +<!ENTITY reftitle.classes '<title>Ïðåäîïðåäåëåííûå êëàññû</title>'> +<!ENTITY reftitle.examples '<title>Ïðèìåðû</title>'> +<!ENTITY reftitle.seealso '<title>Ñìîòðèòå òàêæå</title>'>