cvs: phpdoc /ru language-snippets.ent preface.xml
| From: | Ivan Kovalenko | Date: | Fri, 21 Dec 2001 20:58:57 +0000 |
| Subject: | cvs: phpdoc /ru language-snippets.ent preface.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969340230@lists.php.net to get a copy of this message | ||
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
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