cvs: phpdoc-ro /appendices about.xml
| From: | Simion Onea | Date: | Mon, 14 Apr 2008 10:53:49 +0000 |
| Subject: | cvs: phpdoc-ro /appendices about.xml | ||
| Groups: | php.doc.ro | ||
| Request: | Send a blank email to doc-ro+get-399@lists.php.net to get a copy of this message | ||
simionea Mon Apr 14 10:53:49 2008 UTC
Modified files:
/phpdoc-ro/appendices about.xml
Log:
Updated the file.
http://cvs.php.net/viewvc.cgi/phpdoc-ro/appendices/about.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ro/appendices/about.xml diff -u phpdoc-ro/appendices/about.xml:1.5 phpdoc-ro/appendices/about.xml:1.6 --- phpdoc-ro/appendices/about.xml:1.5 Wed Mar 12 13:01:46 2008 +++ phpdoc-ro/appendices/about.xml Mon Apr 14 10:53:49 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.52 Maintainer: simionea Status: translated --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.53 Maintainer: simionea Status: translated --> <appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Despre manual</title> @@ -8,41 +8,47 @@ <sect1 xml:id="about.formats"> <title>Formate</title> <para> - Manualul PHP este disponibil în câteva formate. Aceste formate pot fi divizate - în douÄ grupuri: formate, ce pot fi citite online Åi pachete, ce pot fi descÄrcate. + Manualul PHP este disponibil în câteva formate. Aceste formate pot fi + divizate în douÄ grupuri: formate, ce pot fi citite online Åi pachete, ce + pot fi descÄrcate. </para> <note> <para> - Unii editori au pus la dispoziÅ£ie versiuni tipÄrite ale acestui manual. Nu putem - sÄ vÄ recomandÄm careva din acestea, deoarece ele tind sÄ se învecheascÄ foarte repede. + Unii editori au pus la dispoziÅ£ie versiuni tipÄrite ale acestui manual. Nu + putem sÄ vÄ recomandÄm careva din acestea, deoarece ele tind sÄ se + învecheascÄ foarte repede. </para> </note> <para> - Manualul poate fi citit online pe <link xlink:href="&url.php;">web site-ul PHP.net</link>, - Åi pe numeroasele oglinzi ale acestuia. Pentru performanÅ£a optimÄ, alegeÅ£i cea mai - apropiatÄ oglindÄ. Versiunea online a manualului PHP are în prezent douÄ foi de stil - <acronym>CSS</acronym>, o foaie de stil pentru acces web Åi una pentru tipar. - </para> - <para> - DouÄ avantaje remarcabile ale manualului online faÅ£Ä de majoritatea formatelor offline - este integrarea <link linkend="about.notes">adnotÄrilor contribuite de utilizatori</link> - Åi <link xlink:href="&url.php.urlhowto;">scurtÄturilor URL</link> , care pot fi utilizate - pentru a ajunge rapid la secÅ£iunea doritÄ a manualului. Un dezavantaj evident este - necesitatea de a fi conectat online pentru a vizualiza aceastÄ ediÅ£ie a manualului. - </para> - <para> - ExistÄ cîteva formate offline ale manualului, iar cel mai potrivit format depinde - de sistemul de operare Åi stilul personal al cititorului. Pentru informaÅ£ii despre - modul în care manualul este generat în aÅa multe formate, puteÅ£i citi secÅ£iunea - <link linkend="about.generate">'Cum generÄm formatele'</link> a acestei anexe. - </para> - <para> - Formatul manualului potrivit pentru cele mai multe platforme (sisteme de operare) - este versiunea HTML. Aceasta este oferitÄ Ã®n douÄ modalitÄÅ£i — sub forma unui - fiÅier HTML unic Åi sub forma unui pachet din mai multe fiÅiere individuale pentru - fiecare secÅ£iune (ceea ce rezultÄ Ã®ntr-o colecÅ£ie de câteva mii de fiÅiere). - Noi furnizÄm aceste versiuni în formÄ comprimatÄ, deci este necesarÄ o utilitÄ de - decompresie pentru a cÄpÄta fiÅierele conÅ£inute în arhive. + Manualul poate fi citit online pe <link xlink:href="&url.php;">web site-ul + PHP.net</link>, Åi pe numeroasele oglinzi ale acestuia. Pentru performanÅ£a + optimÄ, alegeÅ£i cea mai apropiatÄ oglindÄ. Versiunea online a manualului PHP + are în prezent douÄ foi de stil <acronym>CSS</acronym>, o foaie de stil + pentru acces web Åi una pentru tipar. + </para> + <para> + DouÄ avantaje remarcabile ale manualului online faÅ£Ä de majoritatea + formatelor offline este integrarea <link linkend="about.notes">adnotÄrilor + contribuite de utilizatori</link> Åi <link xlink:href="&url.php.urlhowto;"> + scurtÄturilor URL</link> , care pot fi utilizate pentru a ajunge rapid la + secÅ£iunea doritÄ a manualului. Un dezavantaj evident este necesitatea de a + fi conectat online pentru a vizualiza aceastÄ ediÅ£ie a manualului. + </para> + <para> + ExistÄ cîteva formate offline ale manualului, iar cel mai potrivit format + depinde de sistemul de operare Åi stilul personal al cititorului. Pentru + informaÅ£ii despre modul în care manualul este generat în aÅa multe formate, + puteÅ£i citi secÅ£iunea <link linkend="about.generate">'Cum generÄm formatele' + </link> a acestei anexe. + </para> + <para> + Formatul manualului potrivit pentru cele mai multe platforme (sisteme de + operare) este versiunea HTML. Aceasta este oferitÄ Ã®n douÄ modalitÄÅ£i + — sub forma unui fiÅier HTML unic Åi sub forma unui pachet din mai + multe fiÅiere individuale pentru fiecare secÅ£iune (ceea ce rezultÄ Ã®ntr-o + colecÅ£ie de câteva mii de fiÅiere). Noi furnizÄm aceste versiuni în formÄ + comprimatÄ, deci este necesarÄ o utilitÄ de decompresie pentru a cÄpÄta + fiÅierele conÅ£inute în arhive. </para> <!-- The PDF version of the PHP Manual is "currently" unavailable. Perhaps @@ -60,50 +66,53 @@ </note> --> <para> - Pentru platformele Windows, versiunea <productname>Windows HTML Help</productname> - a manualului îmbunÄtÄÅ£eÅte formatul HTML pentru a fi utilizat în cadrul aplicaÅ£iei - <productname>Windows HTML Help</productname>. AceastÄ versiune oferÄ cÄutare deplinÄ - în text, un indice complet Åi repere de carte. Multe medii de dezvoltare PHP în Windows - utilizate pe larg, de asemenea se integreazÄ cu aceastÄ versiune a documentaÅ£iei, - pentru a oferi un acces simplu. De asemenea sunt disponibile Åi programe de vizualizare - CHM pentru sistemele Linux. VerificaÅ£i + Pentru platformele Windows, versiunea + <productname>Windows HTML Help</productname> a manualului îmbunÄtÄÅ£eÅte + formatul HTML pentru a fi utilizat în cadrul aplicaÅ£iei <productname>Windows + HTML Help</productname>. AceastÄ versiune oferÄ cÄutare deplinÄ Ã®n text, un + indice complet Åi repere de carte. Multe medii de dezvoltare PHP în Windows + utilizate pe larg, de asemenea se integreazÄ cu aceastÄ versiune a + documentaÅ£iei, pentru a oferi un acces simplu. De asemenea sunt disponibile + Åi programe de vizualizare CHM pentru sistemele Linux. VerificaÅ£i <link xlink:href="&url.xchm;">xCHM</link> sau <link xlink:href="&url.gnochm;">GnoCHM</link>. </para> <para> - De asemenea este disponibilÄ si o <link xlink:href="&url.php.echm;">versiune CHM extinsÄ</link>, - care este reînnoitÄ mai rar, dar oferÄ multe facilitÄÅ£i suplimentare. Doar cÄ ea va - funcÅ£iona numai pe <productname>Microsoft Windows</productname>, din cauza tehnologiilor - folosite pentru a construi paginile de ajutor. + De asemenea este disponibilÄ si o <link xlink:href="&url.php.echm;">versiune + CHM extinsÄ</link>, care este reînnoitÄ mai rar, dar oferÄ multe facilitÄÅ£i + suplimentare. Doar cÄ ea va funcÅ£iona numai pe <productname>Microsoft + Windows</productname>, din cauza tehnologiilor folosite pentru a construi + paginile de ajutor. </para> </sect1> <sect1 xml:id="about.notes"> <title>Despre adnotÄrile utilizatorilor</title> <para> - AdnotÄrile scrise de utilizatori joacÄ un rol important în dezvoltarea acestui - manual. Oferind cititorilor manualului posibilitatea de a contribui cu exemple, - obiecÅ£ii Åi clarificÄri suplimentare direct din navigatorul lor, suntem în stare - sÄ le încorporÄm apoi în textul de bazÄ al manualului. Åi pânÄ când adnotÄrile - nu au fost încorporate, ele pot fi vizualizate în forma în care au fost înscrise - online Åi în unele formate offline. + AdnotÄrile scrise de utilizatori joacÄ un rol important în dezvoltarea + acestui manual. Oferind cititorilor manualului posibilitatea de a contribui + cu exemple, obiecÅ£ii Åi clarificÄri suplimentare direct din navigatorul lor, + suntem în stare sÄ le încorporÄm apoi în textul de bazÄ al manualului. Åi + pânÄ când adnotÄrile nu au fost încorporate, ele pot fi vizualizate în forma + în care au fost înscrise online Åi în unele formate offline. </para> <note> <para> - AdnotÄrile scrise de cÄtre utilizatori nu sunt verificate înainte ca sÄ aparÄ - online, deci calitatea scrierii sau exemplele de cod-sursÄ, Åi chiar veridicitatea - contribuÅ£iei nu pot fi garantate. (De fapt, nu existÄ nici o garanÅ£ie a calitÄÅ£ii - sau exactitÄÅ£ii textului manualului însuÅi.) + AdnotÄrile scrise de cÄtre utilizatori nu sunt verificate înainte ca sÄ + aparÄ online, deci calitatea scrierii sau exemplele de cod-sursÄ, Åi chiar + veridicitatea contribuÅ£iei nu pot fi garantate. (De fapt, nu existÄ nici o + garanÅ£ie a calitÄÅ£ii sau exactitÄÅ£ii textului manualului însuÅi.) </para> </note> <note> <para> - Ãn scopul licenÅ£ierii corecte a materialului, adnotÄrile scrise de utilizatori - sunt considerate ca parte integrantÄ a manualului PHP Åi deci sunt sub incidenÅ£a - aceleiaÅi licenÅ£e, care cuprinde aceastÄ documentaÅ£ie (Open Publication License — - LicenÅ£a PublicaÅ£iei Deschise pentru moment). Pentru mai multe detalii, accesaÅ£i - pagina de <link linkend="copyright">copyright a manualului</link>. + Ãn scopul licenÅ£ierii corecte a materialului, adnotÄrile scrise de + utilizatori sunt considerate ca parte integrantÄ a manualului PHP Åi deci + sunt sub incidenÅ£a aceleiaÅi licenÅ£e, care cuprinde aceastÄ documentaÅ£ie + (Open Publication License — LicenÅ£a PublicaÅ£iei Deschise pentru + moment). Pentru mai multe detalii, accesaÅ£i pagina de + <link linkend="copyright">copyright a manualului</link>. </para> </note> </sect1> @@ -111,19 +120,20 @@ <sect1 xml:id="about.prototypes"> <title>Cum se citeÅte definiÅ£ia unei funcÅ£ii (prototipul)</title> <para> - Fiecare funcÅ£ie din manual este documentatÄ pentru referinÅ£Ä rapidÄ. Åtiind cum se - citeÅte Åi se interpreteazÄ textul va face studierea PHP mult mai facilÄ. Ãn loc - sÄ se bazeze pe exemple sau pe 'tÄiere/inserare', oricine ar trebui sÄ Åtie cum sÄ - citeascÄ definiÅ£iile funcÅ£iilor (prototipurile). SÄ Ã®ncepem: + Fiecare funcÅ£ie din manual este documentatÄ pentru referinÅ£Ä rapidÄ. Åtiind + cum se citeÅte Åi se interpreteazÄ textul va face studierea PHP mult mai + facilÄ. Ãn loc sÄ se bazeze pe exemple sau pe 'tÄiere/inserare', oricine ar + trebui sÄ Åtie cum sÄ citeascÄ definiÅ£iile funcÅ£iilor (prototipurile). SÄ + începem: </para> <note> <title> CondiÅ£ie esenÅ£ialÄ: CunoÅtinÅ£e de bazÄ a <link linkend="language.types">tipurilor</link> </title> <para> - Cu toate cÄ PHP este un limbaj liber tipizat, este important de a avea cunoÅtinÅ£e - de bazÄ a <link linkend="language.types">tipurilor</link> deoarece ele au o - însemnÄtate importantÄ. + Cu toate cÄ PHP este un limbaj liber tipizat, este important de a avea + cunoÅtinÅ£e de bazÄ a <link linkend="language.types">tipurilor</link> + deoarece ele au o însemnÄtate importantÄ. </para> </note> <para> @@ -179,7 +189,8 @@ </entry> <entry> Tipul valorii, pe care aceastÄ funcÅ£ie o întoarce, care este - <type>integer</type> (adicÄ lungimea Åirului de caractere mÄsuratÄ Ã®n numere). + <type>integer</type> (adicÄ lungimea Åirului de caractere mÄsuratÄ Ã®n + numere). </entry> </row> <row> @@ -187,8 +198,9 @@ ( string $string ) </entry> <entry> - Primul (Åi în cazul dat unicul) parametru/argument pentru aceastÄ funcÅ£ie - este numit <parameter>string</parameter>, Åi este de tipul <type>string</type>. + Primul (Åi în cazul dat unicul) parametru/argument pentru aceastÄ + funcÅ£ie este numit <parameter>string</parameter>, Åi este de tipul + <type>string</type>. </entry> </row> </tbody> @@ -206,8 +218,8 @@ </screen> </para> <para> - Multe funcÅ£ii preiau parametri multipli, cum ar fi <function>in_array</function>. - Prototipul sÄu este dupÄ cum urmeazÄ: + Multe funcÅ£ii preiau parametri multipli, cum ar fi + <function>in_array</function>. Prototipul sÄu este dupÄ cum urmeazÄ: </para> <para> <screen> @@ -218,8 +230,8 @@ </para> <para> Ce înseamnÄ aceasta? in_array() întoarce o valoare - <link linkend="language.types.boolean">boolean</link>, &true; în cazul succesului - (dacÄ <parameter>needle</parameter> a fost gÄsit în + <link linkend="language.types.boolean">boolean</link>, &true; în cazul + succesului (dacÄ <parameter>needle</parameter> a fost gÄsit în <parameter>haystack</parameter>), sau &false; în cazul eÅecului (dacÄ <parameter>needle</parameter> nu a fost gÄsit în <parameter>haystack</parameter>). Primul parametru este numit @@ -229,13 +241,14 @@ (ceea ce cÄutÄm) poate fi o valoare scalarÄ (string, integer, sau <link linkend="language.types.float">float</link>), sau un <link linkend="language.types.array">array</link>. - <parameter>haystack</parameter> (masivul în care efectuÄm cÄutarea) este al - doilea parametru. Al treilea parametru <emphasis>opÅ£ional</emphasis> este numit - <parameter>strict</parameter>. ToÅ£i parametrii opÅ£ionali se gÄsesc între - <emphasis>[</emphasis> astfel de paranteze <emphasis>]</emphasis>. Mmanual afirmÄ - cÄ parametrul <parameter>strict</parameter> are valoarea implicitÄ boolean &false;. - VedeÅ£i pagina manualului referitoare la fiecare funcÅ£ie pentru detalii despre cum - ea funcÅ£ioneazÄ. + <parameter>haystack</parameter> (masivul în care efectuÄm cÄutarea) este + al doilea parametru. Al treilea parametru <emphasis>opÅ£ional</emphasis> + este numit <parameter>strict</parameter>. ToÅ£i parametrii opÅ£ionali se + gÄsesc între <emphasis>[</emphasis> astfel de paranteze + <emphasis>]</emphasis>. Mmanual afirmÄ cÄ parametrul + <parameter>strict</parameter> are valoarea implicitÄ boolean &false;. + VedeÅ£i pagina manualului referitoare la fiecare funcÅ£ie pentru detalii + despre cum ea funcÅ£ioneazÄ. </para> <para> ExistÄ funcÅ£ii cu informaÅ£ie mai complexÄ despre versiunea PHP. SÄ luÄm @@ -257,42 +270,43 @@ <sect1 xml:id="about.phpversions"> <title>Versiunile PHP documentate în acest manual</title> <para> - Acest manual conÅ£ine informaÅ£ii despre versiunile trecute, curente Åi viitoare ale - PHP. SchimbÄrile în comportament sunt documentate ca adnotÄri, jurnale ale - schimbÄrilor, texte incluse în paginile manualului. - Cea mai anterioarÄ versiune documentatÄ este PHP 4.1.0, în timp ce ultima este - PHP 6.x.x + Acest manual conÅ£ine informaÅ£ii despre versiunile trecute, curente Åi + viitoare ale PHP. SchimbÄrile în comportament sunt documentate ca adnotÄri, + jurnale ale schimbÄrilor, texte incluse în paginile manualului. + Cea mai anterioarÄ versiune documentatÄ este PHP 4.1.0, în timp ce ultima + este PHP 6.x.x </para> <para> - ExistÄ documentaÅ£ia parÅ£ialÄ a versiunii PHP din CVS, ceea ce întotdeauna înseamnÄ - ultima versiune în dezvoltare. Aceasta încÄ urmeazÄ sÄ fie lansatÄ, de aceea e - disponibilÄ numai în sistemul de gestiune a versiunilor CVS, sau prin intermediul - unei <link xlink:href="&url.php.snapshots;">imagini instantanee (snapshot)</link>. - Deci fiÅ£i conÅtient cÄ facilitÄÅ£ile marcate "disponibil în CVS" în mod normal nu - sunt disponibile. ÃnsÄ aceste facilitÄÅ£i, cel mai probabil, vor fi disponibile în - urmÄtoarea versiune stabilÄ a PHP. Pentru a descÄrca versiunea CVS, verificaÅ£i + ExistÄ documentaÅ£ia parÅ£ialÄ a versiunii PHP din CVS, ceea ce întotdeauna + înseamnÄ ultima versiune în dezvoltare. Aceasta încÄ urmeazÄ sÄ fie lansatÄ, + de aceea e disponibilÄ numai în sistemul de gestiune a versiunilor CVS, sau + prin intermediul unei <link xlink:href="&url.php.snapshots;">imagini + instantanee (snapshot)</link>. Deci fiÅ£i conÅtient cÄ facilitÄÅ£ile marcate + "disponibil în CVS" în mod normal nu sunt disponibile. ÃnsÄ aceste + facilitÄÅ£i, cel mai probabil, vor fi disponibile în urmÄtoarea versiune + stabilÄ a PHP. Pentru a descÄrca versiunea CVS, verificaÅ£i <link xlink:href="&url.php.anoncvs;">pagina de acces anonim la CVS</link>. </para> <para> - Deci poate exista documentaÅ£ie pentru versiuni PHP care încÄ nu sunt lansate. - (Ceva de tipul PHP 6.x.x în timp ce ultima versiune stabilÄ este 5.x.x). Ãn cele - mai multe cazuri, aceasta nu este o eroare în documentaÅ£ie. Deseori sunt incluse - explicaÅ£ii pentru facilitÄÅ£i care nu sunt disponibile în versiunea curentÄ PHP, - dar vor fi disponibile într-o versiune PHP viitoare, cunoscutÄ deja. De obicei - PHP capÄtÄ noi facilitÄÅ£i în lansÄrile majore, în caz contrar numai erorile - sunt corectate. Utilizând formatul A.B.C pentru versiuni, o lansare majorÄ - mÄreÅte numÄrul A sau B, în timp ce lansÄrile minore mÄresc numÄrul C. De - aceea nu este ceva ieÅit din comun ca, de exemplu, o facilitate sÄ fie - documentatÄ ca disponibilÄ Ã®n PHP x.1.x, atunci cînd ultima versiune este PHP - x.0.x. ObservaÅ£i, de asemenea, cÄ manualul este scris la timpul prezent, nu la - timpul viitor. + Deci poate exista documentaÅ£ie pentru versiuni PHP care încÄ nu sunt + lansate. (Ceva de tipul PHP 6.x.x în timp ce ultima versiune stabilÄ este + 5.x.x). Ãn cele mai multe cazuri, aceasta nu este o eroare în documentaÅ£ie. + Deseori sunt incluse explicaÅ£ii pentru facilitÄÅ£i care nu sunt disponibile + în versiunea curentÄ PHP, dar vor fi disponibile într-o versiune PHP + viitoare, cunoscutÄ deja. De obicei PHP capÄtÄ noi facilitÄÅ£i în lansÄrile + majore, în caz contrar numai erorile sunt corectate. Utilizând formatul + A.B.C pentru versiuni, o lansare majorÄ mÄreÅte numÄrul A sau B, în timp ce + lansÄrile minore mÄresc numÄrul C. De aceea nu este ceva ieÅit din comun ca, + de exemplu, o facilitate sÄ fie documentatÄ ca disponibilÄ Ã®n PHP x.1.x, + atunci cînd ultima versiune este PHP x.0.x. ObservaÅ£i, de asemenea, cÄ + manualul este scris la timpul prezent, nu la timpul viitor. </para> <para> Deseori manualul PHP oferÄ "Valori Implicite" pentru directivele PHP. Aceste valori se bazeazÄ pe <filename>php.ini-dist</filename> Åi nu pe - <filename>php.ini-recommended</filename>. Ele de asemenea se referÄ la ultima - versiune PHP. Vezi <link linkend="ini.list">anexa directivelor PHP</link> - pentru detalii despre aceste valori Åi schimbÄrile survenite. + <filename>php.ini-recommended</filename>. Ele de asemenea se referÄ la + ultima versiune PHP. Vezi <link linkend="ini.list">anexa directivelor PHP + </link> pentru detalii despre aceste valori Åi schimbÄrile survenite. </para> </sect1> @@ -327,9 +341,10 @@ DacÄ Ã®n acest manual este gÄsitÄ o eroare, în orice limbÄ, vÄ rugÄm sÄ o raportaÅ£i folosind sistemul de erori la adresa <link xlink:href="&url.php.bugs;">&url.php.bugs;</link>. - ClasificaÅ£i eroarea ca "Documentation Problem" — "ProblemÄ Ã®n documentaÅ£ie". - Toate problemele ce Å£in de documentaÅ£ie, inclusiv cele ce Å£in de formatele - manualului, trebuie sÄ fie înaintate în calitate de rapoarte de erori. + ClasificaÅ£i eroarea ca "Documentation Problem" — "ProblemÄ Ã®n + documentaÅ£ie". Toate problemele ce Å£in de documentaÅ£ie, inclusiv cele ce Å£in + de formatele manualului, trebuie sÄ fie înaintate în calitate de rapoarte de + erori. </para> <note> <para> @@ -339,17 +354,18 @@ </para> </note> <para> - Contribuind cu adnotÄri, utilizatorii pot furniza propriile exemple, obiecÅ£ii - Åi clarificÄri pentru alÅ£i cititori. Dar vÄ rugÄm sÄ nu trimiteÅ£i rapoarte de - erori folosind sistemul de adnotÄri. Pentru detalii, puteÅ£i citi secÅ£iunea - întitulatÄ <link linkend="about.notes">'Despre adnotÄrile utilizatorilor'</link>. + Contribuind cu adnotÄri, utilizatorii pot furniza propriile exemple, + obiecÅ£ii Åi clarificÄri pentru alÅ£i cititori. Dar vÄ rugÄm sÄ nu trimiteÅ£i + rapoarte de erori folosind sistemul de adnotÄri. Pentru detalii, puteÅ£i citi + secÅ£iunea întitulatÄ <link linkend="about.notes">'Despre adnotÄrile + utilizatorilor'</link>. </para> <para> - Manualul PHP este tradus în multe limbi. CunoaÅterea englezei Åi a unei limbi - strÄine oferÄ Ã®ncÄ o modalitate de a îmbunÄtÄÅ£i manualul PHP, lucrînd într-o - echipÄ de traducÄtori. Pentru informaÅ£ii despre începerea unei traduceri noi, - sau contribuirea la o versiune deja tradusÄ, vÄ rugÄm sÄ citiÅ£i - <link xlink:href="&url.php.dochowto;">&url.php.dochowto;</link>. + Manualul PHP este tradus în multe limbi. CunoaÅterea englezei Åi a unei + limbi strÄine oferÄ Ã®ncÄ o modalitate de a îmbunÄtÄÅ£i manualul PHP, lucrînd + într-o echipÄ de traducÄtori. Pentru informaÅ£ii despre începerea unei + traduceri noi, sau contribuirea la o versiune deja tradusÄ, vÄ rugÄm sÄ + citiÅ£i <link xlink:href="&url.php.dochowto;">&url.php.dochowto;</link>. </para> <para> Proiectul de Documentare PHP are de asemenea Åi un canal IRC, unde se adunÄ @@ -364,22 +380,16 @@ <para> Acest manual este scris în <acronym>XML</acronym> folosind <link xlink:href="&url.docbook.xml;">DocBook XML DTD</link>, folosind <link - xlink:href="&url.xslt;"><acronym>XSLT</acronym></link> (Extensible - Stylesheet Language Transformations — TransformÄrile Limbajului - Extensibil al Foilor de Stil) pentru întreÅ£inere Åi formatare. + xlink:href="&url.phd;"><acronym>PhD</acronym></link> (The [PH]P based + [D]ocBook renderer — interpretorul DocBook bazat pe PHP) + pentru întreÅ£inere Åi formatare. </para> <para> Utilizarea <acronym>XML</acronym> în calitate de format al sursei oferÄ posibilitatea de a genera multe formate de ieÅire din fiÅierele sursÄ, întreÅ£inerea efectuându-se pentru doar un document sursÄ pentru toate - formatele. Uneltele utilizate pentru formatarea manualului online sunt - <link xlink:href="&url.xsltproc;">xsltproc</link> Åi <link - xlink:href="&url.dbxsl;">DocBook XSL Stylesheets</link>. - Versiunile <acronym>HTML</acronym> Åi <acronym>TeX</acronym> utilizeazÄ - <link xlink:href="&url.jade;">Jade</link>, scrisÄ de cÄtre <link - xlink:href="&url.jclark;">James Clark</link>; Åi <link - xlink:href="&url.dbstyle;">The Modular DocBook Stylesheets</link>, - scrisÄ de cÄtre <link xlink:href="&url.nwalsh;">Norman Walsh</link>. + formatele. Unealta utilizatÄ pentru formatarea manualului online este + <link xlink:href="&url.phd;">PhD</link>. Noi utilizÄm <link xlink:href="&url.winhelp;">Microsoft HTML Help Workshop</link> pentru a genera formatul 'Windows HTML Help' al manualului, Åi desugur însuÅi PHP pentru a face careva transformÄri Åi formatÄri @@ -387,10 +397,10 @@ </para> <para> Manualul PHP este generat în diverse limbi Åi formate, vezi - <link xlink:href="&url.php.docs;">&url.php.docs;</link> pentru detalii suplimentare. - Codul sursÄ <acronym>XML</acronym> poate fi descÄrcat din CVS Åi vizualizat la - <link xlink:href="&url.php.cvs;">&url.php.cvs;</link>. DocumentaÅ£ia este stocatÄ Ã®n - modulul <literal>phpdoc</literal>. + <link xlink:href="&url.php.docs;">&url.php.docs;</link> pentru detalii + suplimentare. Codul sursÄ <acronym>XML</acronym> poate fi descÄrcat din CVS + Åi vizualizat la <link xlink:href="&url.php.cvs;">&url.php.cvs;</link>. + DocumentaÅ£ia este stocatÄ Ã®n modulul <literal>phpdoc</literal>. </para> </sect1> @@ -400,9 +410,9 @@ Manualul PHP este disponibil nu numai în diverse formate, dar Åi în diverse limbi. Textul manualului este scris mai întâi în englezÄ, apoi echipe de oameni din toatÄ lumea au grijÄ sÄ-l traducÄ Ã®n limba lor de origine. DacÄ - traducerea unei funcÅ£ii specifice sau a unui capitol nu a fost încÄ efectuatÄ, - sistemul de asamblare automatÄ a manualului revine la versiunea englezÄ a - documentului respectiv. + traducerea unei funcÅ£ii specifice sau a unui capitol nu a fost încÄ + efectuatÄ, sistemul de asamblare automatÄ a manualului revine la versiunea + englezÄ a documentului respectiv. </para> <para> Persoanele implicate în traducere încep de la sursa în <acronym>XML</acronym> @@ -427,21 +437,16 @@ </para> </note> <para> - La moment manualul este disponibil, parÅ£ial sau integral, în urmÄtoarele limbi: - PortughezÄ BrazilianÄ, ChinezÄ (SimplificatÄ), ChinezÄ (CantonezÄ din Hong Kong), - ChinezÄ (TradiÅ£ionalÄ), CehÄ, OlandezÄ, FinlandezÄ, FrancezÄ, GermanÄ, GreacÄ, - EbraicÄ, UngarÄ, ItalianÄ, JapanezÄ, KoreanÄ, PolonezÄ, RomânÄ, RusÄ, SlovacÄ, - SlovenÄ, SpaniolÄ, SuedezÄ Åi TurcÄ. + La moment manualul este disponibil, parÅ£ial sau integral, în peste 10 limbi. </para> <para> - Toate acestea pot fi descÄrcate aici: <link xlink:href="&url.php.docs;">&url.php.docs;</link>. + Toate acestea pot fi descÄrcate aici: + <link xlink:href="&url.php.docs;">&url.php.docs;</link>. </para> </sect1> </appendix> -<!-- Translated by Simion Onea --> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
http://cvs.php.net/viewvc.cgi/phpdoc-ro/appendices/about.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ro/appendices/about.xml diff -u phpdoc-ro/appendices/about.xml:1.5 phpdoc-ro/appendices/about.xml:1.6 --- phpdoc-ro/appendices/about.xml:1.5 Wed Mar 12 13:01:46 2008 +++ phpdoc-ro/appendices/about.xml Mon Apr 14 10:53:49 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.52 Maintainer: simionea Status: translated --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.53 Maintainer: simionea Status: translated --> <appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Despre manual</title> @@ -8,41 +8,47 @@ <sect1 xml:id="about.formats"> <title>Formate</title> <para> - Manualul PHP este disponibil în câteva formate. Aceste formate pot fi divizate - în douÄ grupuri: formate, ce pot fi citite online Åi pachete, ce pot fi descÄrcate. + Manualul PHP este disponibil în câteva formate. Aceste formate pot fi + divizate în douÄ grupuri: formate, ce pot fi citite online Åi pachete, ce + pot fi descÄrcate. </para> <note> <para> - Unii editori au pus la dispoziÅ£ie versiuni tipÄrite ale acestui manual. Nu putem - sÄ vÄ recomandÄm careva din acestea, deoarece ele tind sÄ se învecheascÄ foarte repede. + Unii editori au pus la dispoziÅ£ie versiuni tipÄrite ale acestui manual. Nu + putem sÄ vÄ recomandÄm careva din acestea, deoarece ele tind sÄ se + învecheascÄ foarte repede. </para> </note> <para> - Manualul poate fi citit online pe <link xlink:href="&url.php;">web site-ul PHP.net</link>, - Åi pe numeroasele oglinzi ale acestuia. Pentru performanÅ£a optimÄ, alegeÅ£i cea mai - apropiatÄ oglindÄ. Versiunea online a manualului PHP are în prezent douÄ foi de stil - <acronym>CSS</acronym>, o foaie de stil pentru acces web Åi una pentru tipar. - </para> - <para> - DouÄ avantaje remarcabile ale manualului online faÅ£Ä de majoritatea formatelor offline - este integrarea <link linkend="about.notes">adnotÄrilor contribuite de utilizatori</link> - Åi <link xlink:href="&url.php.urlhowto;">scurtÄturilor URL</link> , care pot fi utilizate - pentru a ajunge rapid la secÅ£iunea doritÄ a manualului. Un dezavantaj evident este - necesitatea de a fi conectat online pentru a vizualiza aceastÄ ediÅ£ie a manualului. - </para> - <para> - ExistÄ cîteva formate offline ale manualului, iar cel mai potrivit format depinde - de sistemul de operare Åi stilul personal al cititorului. Pentru informaÅ£ii despre - modul în care manualul este generat în aÅa multe formate, puteÅ£i citi secÅ£iunea - <link linkend="about.generate">'Cum generÄm formatele'</link> a acestei anexe. - </para> - <para> - Formatul manualului potrivit pentru cele mai multe platforme (sisteme de operare) - este versiunea HTML. Aceasta este oferitÄ Ã®n douÄ modalitÄÅ£i — sub forma unui - fiÅier HTML unic Åi sub forma unui pachet din mai multe fiÅiere individuale pentru - fiecare secÅ£iune (ceea ce rezultÄ Ã®ntr-o colecÅ£ie de câteva mii de fiÅiere). - Noi furnizÄm aceste versiuni în formÄ comprimatÄ, deci este necesarÄ o utilitÄ de - decompresie pentru a cÄpÄta fiÅierele conÅ£inute în arhive. + Manualul poate fi citit online pe <link xlink:href="&url.php;">web site-ul + PHP.net</link>, Åi pe numeroasele oglinzi ale acestuia. Pentru performanÅ£a + optimÄ, alegeÅ£i cea mai apropiatÄ oglindÄ. Versiunea online a manualului PHP + are în prezent douÄ foi de stil <acronym>CSS</acronym>, o foaie de stil + pentru acces web Åi una pentru tipar. + </para> + <para> + DouÄ avantaje remarcabile ale manualului online faÅ£Ä de majoritatea + formatelor offline este integrarea <link linkend="about.notes">adnotÄrilor + contribuite de utilizatori</link> Åi <link xlink:href="&url.php.urlhowto;"> + scurtÄturilor URL</link> , care pot fi utilizate pentru a ajunge rapid la + secÅ£iunea doritÄ a manualului. Un dezavantaj evident este necesitatea de a + fi conectat online pentru a vizualiza aceastÄ ediÅ£ie a manualului. + </para> + <para> + ExistÄ cîteva formate offline ale manualului, iar cel mai potrivit format + depinde de sistemul de operare Åi stilul personal al cititorului. Pentru + informaÅ£ii despre modul în care manualul este generat în aÅa multe formate, + puteÅ£i citi secÅ£iunea <link linkend="about.generate">'Cum generÄm formatele' + </link> a acestei anexe. + </para> + <para> + Formatul manualului potrivit pentru cele mai multe platforme (sisteme de + operare) este versiunea HTML. Aceasta este oferitÄ Ã®n douÄ modalitÄÅ£i + — sub forma unui fiÅier HTML unic Åi sub forma unui pachet din mai + multe fiÅiere individuale pentru fiecare secÅ£iune (ceea ce rezultÄ Ã®ntr-o + colecÅ£ie de câteva mii de fiÅiere). Noi furnizÄm aceste versiuni în formÄ + comprimatÄ, deci este necesarÄ o utilitÄ de decompresie pentru a cÄpÄta + fiÅierele conÅ£inute în arhive. </para> <!-- The PDF version of the PHP Manual is "currently" unavailable. Perhaps @@ -60,50 +66,53 @@ </note> --> <para> - Pentru platformele Windows, versiunea <productname>Windows HTML Help</productname> - a manualului îmbunÄtÄÅ£eÅte formatul HTML pentru a fi utilizat în cadrul aplicaÅ£iei - <productname>Windows HTML Help</productname>. AceastÄ versiune oferÄ cÄutare deplinÄ - în text, un indice complet Åi repere de carte. Multe medii de dezvoltare PHP în Windows - utilizate pe larg, de asemenea se integreazÄ cu aceastÄ versiune a documentaÅ£iei, - pentru a oferi un acces simplu. De asemenea sunt disponibile Åi programe de vizualizare - CHM pentru sistemele Linux. VerificaÅ£i + Pentru platformele Windows, versiunea + <productname>Windows HTML Help</productname> a manualului îmbunÄtÄÅ£eÅte + formatul HTML pentru a fi utilizat în cadrul aplicaÅ£iei <productname>Windows + HTML Help</productname>. AceastÄ versiune oferÄ cÄutare deplinÄ Ã®n text, un + indice complet Åi repere de carte. Multe medii de dezvoltare PHP în Windows + utilizate pe larg, de asemenea se integreazÄ cu aceastÄ versiune a + documentaÅ£iei, pentru a oferi un acces simplu. De asemenea sunt disponibile + Åi programe de vizualizare CHM pentru sistemele Linux. VerificaÅ£i <link xlink:href="&url.xchm;">xCHM</link> sau <link xlink:href="&url.gnochm;">GnoCHM</link>. </para> <para> - De asemenea este disponibilÄ si o <link xlink:href="&url.php.echm;">versiune CHM extinsÄ</link>, - care este reînnoitÄ mai rar, dar oferÄ multe facilitÄÅ£i suplimentare. Doar cÄ ea va - funcÅ£iona numai pe <productname>Microsoft Windows</productname>, din cauza tehnologiilor - folosite pentru a construi paginile de ajutor. + De asemenea este disponibilÄ si o <link xlink:href="&url.php.echm;">versiune + CHM extinsÄ</link>, care este reînnoitÄ mai rar, dar oferÄ multe facilitÄÅ£i + suplimentare. Doar cÄ ea va funcÅ£iona numai pe <productname>Microsoft + Windows</productname>, din cauza tehnologiilor folosite pentru a construi + paginile de ajutor. </para> </sect1> <sect1 xml:id="about.notes"> <title>Despre adnotÄrile utilizatorilor</title> <para> - AdnotÄrile scrise de utilizatori joacÄ un rol important în dezvoltarea acestui - manual. Oferind cititorilor manualului posibilitatea de a contribui cu exemple, - obiecÅ£ii Åi clarificÄri suplimentare direct din navigatorul lor, suntem în stare - sÄ le încorporÄm apoi în textul de bazÄ al manualului. Åi pânÄ când adnotÄrile - nu au fost încorporate, ele pot fi vizualizate în forma în care au fost înscrise - online Åi în unele formate offline. + AdnotÄrile scrise de utilizatori joacÄ un rol important în dezvoltarea + acestui manual. Oferind cititorilor manualului posibilitatea de a contribui + cu exemple, obiecÅ£ii Åi clarificÄri suplimentare direct din navigatorul lor, + suntem în stare sÄ le încorporÄm apoi în textul de bazÄ al manualului. Åi + pânÄ când adnotÄrile nu au fost încorporate, ele pot fi vizualizate în forma + în care au fost înscrise online Åi în unele formate offline. </para> <note> <para> - AdnotÄrile scrise de cÄtre utilizatori nu sunt verificate înainte ca sÄ aparÄ - online, deci calitatea scrierii sau exemplele de cod-sursÄ, Åi chiar veridicitatea - contribuÅ£iei nu pot fi garantate. (De fapt, nu existÄ nici o garanÅ£ie a calitÄÅ£ii - sau exactitÄÅ£ii textului manualului însuÅi.) + AdnotÄrile scrise de cÄtre utilizatori nu sunt verificate înainte ca sÄ + aparÄ online, deci calitatea scrierii sau exemplele de cod-sursÄ, Åi chiar + veridicitatea contribuÅ£iei nu pot fi garantate. (De fapt, nu existÄ nici o + garanÅ£ie a calitÄÅ£ii sau exactitÄÅ£ii textului manualului însuÅi.) </para> </note> <note> <para> - Ãn scopul licenÅ£ierii corecte a materialului, adnotÄrile scrise de utilizatori - sunt considerate ca parte integrantÄ a manualului PHP Åi deci sunt sub incidenÅ£a - aceleiaÅi licenÅ£e, care cuprinde aceastÄ documentaÅ£ie (Open Publication License — - LicenÅ£a PublicaÅ£iei Deschise pentru moment). Pentru mai multe detalii, accesaÅ£i - pagina de <link linkend="copyright">copyright a manualului</link>. + Ãn scopul licenÅ£ierii corecte a materialului, adnotÄrile scrise de + utilizatori sunt considerate ca parte integrantÄ a manualului PHP Åi deci + sunt sub incidenÅ£a aceleiaÅi licenÅ£e, care cuprinde aceastÄ documentaÅ£ie + (Open Publication License — LicenÅ£a PublicaÅ£iei Deschise pentru + moment). Pentru mai multe detalii, accesaÅ£i pagina de + <link linkend="copyright">copyright a manualului</link>. </para> </note> </sect1> @@ -111,19 +120,20 @@ <sect1 xml:id="about.prototypes"> <title>Cum se citeÅte definiÅ£ia unei funcÅ£ii (prototipul)</title> <para> - Fiecare funcÅ£ie din manual este documentatÄ pentru referinÅ£Ä rapidÄ. Åtiind cum se - citeÅte Åi se interpreteazÄ textul va face studierea PHP mult mai facilÄ. Ãn loc - sÄ se bazeze pe exemple sau pe 'tÄiere/inserare', oricine ar trebui sÄ Åtie cum sÄ - citeascÄ definiÅ£iile funcÅ£iilor (prototipurile). SÄ Ã®ncepem: + Fiecare funcÅ£ie din manual este documentatÄ pentru referinÅ£Ä rapidÄ. Åtiind + cum se citeÅte Åi se interpreteazÄ textul va face studierea PHP mult mai + facilÄ. Ãn loc sÄ se bazeze pe exemple sau pe 'tÄiere/inserare', oricine ar + trebui sÄ Åtie cum sÄ citeascÄ definiÅ£iile funcÅ£iilor (prototipurile). SÄ + începem: </para> <note> <title> CondiÅ£ie esenÅ£ialÄ: CunoÅtinÅ£e de bazÄ a <link linkend="language.types">tipurilor</link> </title> <para> - Cu toate cÄ PHP este un limbaj liber tipizat, este important de a avea cunoÅtinÅ£e - de bazÄ a <link linkend="language.types">tipurilor</link> deoarece ele au o - însemnÄtate importantÄ. + Cu toate cÄ PHP este un limbaj liber tipizat, este important de a avea + cunoÅtinÅ£e de bazÄ a <link linkend="language.types">tipurilor</link> + deoarece ele au o însemnÄtate importantÄ. </para> </note> <para> @@ -179,7 +189,8 @@ </entry> <entry> Tipul valorii, pe care aceastÄ funcÅ£ie o întoarce, care este - <type>integer</type> (adicÄ lungimea Åirului de caractere mÄsuratÄ Ã®n numere). + <type>integer</type> (adicÄ lungimea Åirului de caractere mÄsuratÄ Ã®n + numere). </entry> </row> <row> @@ -187,8 +198,9 @@ ( string $string ) </entry> <entry> - Primul (Åi în cazul dat unicul) parametru/argument pentru aceastÄ funcÅ£ie - este numit <parameter>string</parameter>, Åi este de tipul <type>string</type>. + Primul (Åi în cazul dat unicul) parametru/argument pentru aceastÄ + funcÅ£ie este numit <parameter>string</parameter>, Åi este de tipul + <type>string</type>. </entry> </row> </tbody> @@ -206,8 +218,8 @@ </screen> </para> <para> - Multe funcÅ£ii preiau parametri multipli, cum ar fi <function>in_array</function>. - Prototipul sÄu este dupÄ cum urmeazÄ: + Multe funcÅ£ii preiau parametri multipli, cum ar fi + <function>in_array</function>. Prototipul sÄu este dupÄ cum urmeazÄ: </para> <para> <screen> @@ -218,8 +230,8 @@ </para> <para> Ce înseamnÄ aceasta? in_array() întoarce o valoare - <link linkend="language.types.boolean">boolean</link>, &true; în cazul succesului - (dacÄ <parameter>needle</parameter> a fost gÄsit în + <link linkend="language.types.boolean">boolean</link>, &true; în cazul + succesului (dacÄ <parameter>needle</parameter> a fost gÄsit în <parameter>haystack</parameter>), sau &false; în cazul eÅecului (dacÄ <parameter>needle</parameter> nu a fost gÄsit în <parameter>haystack</parameter>). Primul parametru este numit @@ -229,13 +241,14 @@ (ceea ce cÄutÄm) poate fi o valoare scalarÄ (string, integer, sau <link linkend="language.types.float">float</link>), sau un <link linkend="language.types.array">array</link>. - <parameter>haystack</parameter> (masivul în care efectuÄm cÄutarea) este al - doilea parametru. Al treilea parametru <emphasis>opÅ£ional</emphasis> este numit - <parameter>strict</parameter>. ToÅ£i parametrii opÅ£ionali se gÄsesc între - <emphasis>[</emphasis> astfel de paranteze <emphasis>]</emphasis>. Mmanual afirmÄ - cÄ parametrul <parameter>strict</parameter> are valoarea implicitÄ boolean &false;. - VedeÅ£i pagina manualului referitoare la fiecare funcÅ£ie pentru detalii despre cum - ea funcÅ£ioneazÄ. + <parameter>haystack</parameter> (masivul în care efectuÄm cÄutarea) este + al doilea parametru. Al treilea parametru <emphasis>opÅ£ional</emphasis> + este numit <parameter>strict</parameter>. ToÅ£i parametrii opÅ£ionali se + gÄsesc între <emphasis>[</emphasis> astfel de paranteze + <emphasis>]</emphasis>. Mmanual afirmÄ cÄ parametrul + <parameter>strict</parameter> are valoarea implicitÄ boolean &false;. + VedeÅ£i pagina manualului referitoare la fiecare funcÅ£ie pentru detalii + despre cum ea funcÅ£ioneazÄ. </para> <para> ExistÄ funcÅ£ii cu informaÅ£ie mai complexÄ despre versiunea PHP. SÄ luÄm @@ -257,42 +270,43 @@ <sect1 xml:id="about.phpversions"> <title>Versiunile PHP documentate în acest manual</title> <para> - Acest manual conÅ£ine informaÅ£ii despre versiunile trecute, curente Åi viitoare ale - PHP. SchimbÄrile în comportament sunt documentate ca adnotÄri, jurnale ale - schimbÄrilor, texte incluse în paginile manualului. - Cea mai anterioarÄ versiune documentatÄ este PHP 4.1.0, în timp ce ultima este - PHP 6.x.x + Acest manual conÅ£ine informaÅ£ii despre versiunile trecute, curente Åi + viitoare ale PHP. SchimbÄrile în comportament sunt documentate ca adnotÄri, + jurnale ale schimbÄrilor, texte incluse în paginile manualului. + Cea mai anterioarÄ versiune documentatÄ este PHP 4.1.0, în timp ce ultima + este PHP 6.x.x </para> <para> - ExistÄ documentaÅ£ia parÅ£ialÄ a versiunii PHP din CVS, ceea ce întotdeauna înseamnÄ - ultima versiune în dezvoltare. Aceasta încÄ urmeazÄ sÄ fie lansatÄ, de aceea e - disponibilÄ numai în sistemul de gestiune a versiunilor CVS, sau prin intermediul - unei <link xlink:href="&url.php.snapshots;">imagini instantanee (snapshot)</link>. - Deci fiÅ£i conÅtient cÄ facilitÄÅ£ile marcate "disponibil în CVS" în mod normal nu - sunt disponibile. ÃnsÄ aceste facilitÄÅ£i, cel mai probabil, vor fi disponibile în - urmÄtoarea versiune stabilÄ a PHP. Pentru a descÄrca versiunea CVS, verificaÅ£i + ExistÄ documentaÅ£ia parÅ£ialÄ a versiunii PHP din CVS, ceea ce întotdeauna + înseamnÄ ultima versiune în dezvoltare. Aceasta încÄ urmeazÄ sÄ fie lansatÄ, + de aceea e disponibilÄ numai în sistemul de gestiune a versiunilor CVS, sau + prin intermediul unei <link xlink:href="&url.php.snapshots;">imagini + instantanee (snapshot)</link>. Deci fiÅ£i conÅtient cÄ facilitÄÅ£ile marcate + "disponibil în CVS" în mod normal nu sunt disponibile. ÃnsÄ aceste + facilitÄÅ£i, cel mai probabil, vor fi disponibile în urmÄtoarea versiune + stabilÄ a PHP. Pentru a descÄrca versiunea CVS, verificaÅ£i <link xlink:href="&url.php.anoncvs;">pagina de acces anonim la CVS</link>. </para> <para> - Deci poate exista documentaÅ£ie pentru versiuni PHP care încÄ nu sunt lansate. - (Ceva de tipul PHP 6.x.x în timp ce ultima versiune stabilÄ este 5.x.x). Ãn cele - mai multe cazuri, aceasta nu este o eroare în documentaÅ£ie. Deseori sunt incluse - explicaÅ£ii pentru facilitÄÅ£i care nu sunt disponibile în versiunea curentÄ PHP, - dar vor fi disponibile într-o versiune PHP viitoare, cunoscutÄ deja. De obicei - PHP capÄtÄ noi facilitÄÅ£i în lansÄrile majore, în caz contrar numai erorile - sunt corectate. Utilizând formatul A.B.C pentru versiuni, o lansare majorÄ - mÄreÅte numÄrul A sau B, în timp ce lansÄrile minore mÄresc numÄrul C. De - aceea nu este ceva ieÅit din comun ca, de exemplu, o facilitate sÄ fie - documentatÄ ca disponibilÄ Ã®n PHP x.1.x, atunci cînd ultima versiune este PHP - x.0.x. ObservaÅ£i, de asemenea, cÄ manualul este scris la timpul prezent, nu la - timpul viitor. + Deci poate exista documentaÅ£ie pentru versiuni PHP care încÄ nu sunt + lansate. (Ceva de tipul PHP 6.x.x în timp ce ultima versiune stabilÄ este + 5.x.x). Ãn cele mai multe cazuri, aceasta nu este o eroare în documentaÅ£ie. + Deseori sunt incluse explicaÅ£ii pentru facilitÄÅ£i care nu sunt disponibile + în versiunea curentÄ PHP, dar vor fi disponibile într-o versiune PHP + viitoare, cunoscutÄ deja. De obicei PHP capÄtÄ noi facilitÄÅ£i în lansÄrile + majore, în caz contrar numai erorile sunt corectate. Utilizând formatul + A.B.C pentru versiuni, o lansare majorÄ mÄreÅte numÄrul A sau B, în timp ce + lansÄrile minore mÄresc numÄrul C. De aceea nu este ceva ieÅit din comun ca, + de exemplu, o facilitate sÄ fie documentatÄ ca disponibilÄ Ã®n PHP x.1.x, + atunci cînd ultima versiune este PHP x.0.x. ObservaÅ£i, de asemenea, cÄ + manualul este scris la timpul prezent, nu la timpul viitor. </para> <para> Deseori manualul PHP oferÄ "Valori Implicite" pentru directivele PHP. Aceste valori se bazeazÄ pe <filename>php.ini-dist</filename> Åi nu pe - <filename>php.ini-recommended</filename>. Ele de asemenea se referÄ la ultima - versiune PHP. Vezi <link linkend="ini.list">anexa directivelor PHP</link> - pentru detalii despre aceste valori Åi schimbÄrile survenite. + <filename>php.ini-recommended</filename>. Ele de asemenea se referÄ la + ultima versiune PHP. Vezi <link linkend="ini.list">anexa directivelor PHP + </link> pentru detalii despre aceste valori Åi schimbÄrile survenite. </para> </sect1> @@ -327,9 +341,10 @@ DacÄ Ã®n acest manual este gÄsitÄ o eroare, în orice limbÄ, vÄ rugÄm sÄ o raportaÅ£i folosind sistemul de erori la adresa <link xlink:href="&url.php.bugs;">&url.php.bugs;</link>. - ClasificaÅ£i eroarea ca "Documentation Problem" — "ProblemÄ Ã®n documentaÅ£ie". - Toate problemele ce Å£in de documentaÅ£ie, inclusiv cele ce Å£in de formatele - manualului, trebuie sÄ fie înaintate în calitate de rapoarte de erori. + ClasificaÅ£i eroarea ca "Documentation Problem" — "ProblemÄ Ã®n + documentaÅ£ie". Toate problemele ce Å£in de documentaÅ£ie, inclusiv cele ce Å£in + de formatele manualului, trebuie sÄ fie înaintate în calitate de rapoarte de + erori. </para> <note> <para> @@ -339,17 +354,18 @@ </para> </note> <para> - Contribuind cu adnotÄri, utilizatorii pot furniza propriile exemple, obiecÅ£ii - Åi clarificÄri pentru alÅ£i cititori. Dar vÄ rugÄm sÄ nu trimiteÅ£i rapoarte de - erori folosind sistemul de adnotÄri. Pentru detalii, puteÅ£i citi secÅ£iunea - întitulatÄ <link linkend="about.notes">'Despre adnotÄrile utilizatorilor'</link>. + Contribuind cu adnotÄri, utilizatorii pot furniza propriile exemple, + obiecÅ£ii Åi clarificÄri pentru alÅ£i cititori. Dar vÄ rugÄm sÄ nu trimiteÅ£i + rapoarte de erori folosind sistemul de adnotÄri. Pentru detalii, puteÅ£i citi + secÅ£iunea întitulatÄ <link linkend="about.notes">'Despre adnotÄrile + utilizatorilor'</link>. </para> <para> - Manualul PHP este tradus în multe limbi. CunoaÅterea englezei Åi a unei limbi - strÄine oferÄ Ã®ncÄ o modalitate de a îmbunÄtÄÅ£i manualul PHP, lucrînd într-o - echipÄ de traducÄtori. Pentru informaÅ£ii despre începerea unei traduceri noi, - sau contribuirea la o versiune deja tradusÄ, vÄ rugÄm sÄ citiÅ£i - <link xlink:href="&url.php.dochowto;">&url.php.dochowto;</link>. + Manualul PHP este tradus în multe limbi. CunoaÅterea englezei Åi a unei + limbi strÄine oferÄ Ã®ncÄ o modalitate de a îmbunÄtÄÅ£i manualul PHP, lucrînd + într-o echipÄ de traducÄtori. Pentru informaÅ£ii despre începerea unei + traduceri noi, sau contribuirea la o versiune deja tradusÄ, vÄ rugÄm sÄ + citiÅ£i <link xlink:href="&url.php.dochowto;">&url.php.dochowto;</link>. </para> <para> Proiectul de Documentare PHP are de asemenea Åi un canal IRC, unde se adunÄ @@ -364,22 +380,16 @@ <para> Acest manual este scris în <acronym>XML</acronym> folosind <link xlink:href="&url.docbook.xml;">DocBook XML DTD</link>, folosind <link - xlink:href="&url.xslt;"><acronym>XSLT</acronym></link> (Extensible - Stylesheet Language Transformations — TransformÄrile Limbajului - Extensibil al Foilor de Stil) pentru întreÅ£inere Åi formatare. + xlink:href="&url.phd;"><acronym>PhD</acronym></link> (The [PH]P based + [D]ocBook renderer — interpretorul DocBook bazat pe PHP) + pentru întreÅ£inere Åi formatare. </para> <para> Utilizarea <acronym>XML</acronym> în calitate de format al sursei oferÄ posibilitatea de a genera multe formate de ieÅire din fiÅierele sursÄ, întreÅ£inerea efectuându-se pentru doar un document sursÄ pentru toate - formatele. Uneltele utilizate pentru formatarea manualului online sunt - <link xlink:href="&url.xsltproc;">xsltproc</link> Åi <link - xlink:href="&url.dbxsl;">DocBook XSL Stylesheets</link>. - Versiunile <acronym>HTML</acronym> Åi <acronym>TeX</acronym> utilizeazÄ - <link xlink:href="&url.jade;">Jade</link>, scrisÄ de cÄtre <link - xlink:href="&url.jclark;">James Clark</link>; Åi <link - xlink:href="&url.dbstyle;">The Modular DocBook Stylesheets</link>, - scrisÄ de cÄtre <link xlink:href="&url.nwalsh;">Norman Walsh</link>. + formatele. Unealta utilizatÄ pentru formatarea manualului online este + <link xlink:href="&url.phd;">PhD</link>. Noi utilizÄm <link xlink:href="&url.winhelp;">Microsoft HTML Help Workshop</link> pentru a genera formatul 'Windows HTML Help' al manualului, Åi desugur însuÅi PHP pentru a face careva transformÄri Åi formatÄri @@ -387,10 +397,10 @@ </para> <para> Manualul PHP este generat în diverse limbi Åi formate, vezi - <link xlink:href="&url.php.docs;">&url.php.docs;</link> pentru detalii suplimentare. - Codul sursÄ <acronym>XML</acronym> poate fi descÄrcat din CVS Åi vizualizat la - <link xlink:href="&url.php.cvs;">&url.php.cvs;</link>. DocumentaÅ£ia este stocatÄ Ã®n - modulul <literal>phpdoc</literal>. + <link xlink:href="&url.php.docs;">&url.php.docs;</link> pentru detalii + suplimentare. Codul sursÄ <acronym>XML</acronym> poate fi descÄrcat din CVS + Åi vizualizat la <link xlink:href="&url.php.cvs;">&url.php.cvs;</link>. + DocumentaÅ£ia este stocatÄ Ã®n modulul <literal>phpdoc</literal>. </para> </sect1> @@ -400,9 +410,9 @@ Manualul PHP este disponibil nu numai în diverse formate, dar Åi în diverse limbi. Textul manualului este scris mai întâi în englezÄ, apoi echipe de oameni din toatÄ lumea au grijÄ sÄ-l traducÄ Ã®n limba lor de origine. DacÄ - traducerea unei funcÅ£ii specifice sau a unui capitol nu a fost încÄ efectuatÄ, - sistemul de asamblare automatÄ a manualului revine la versiunea englezÄ a - documentului respectiv. + traducerea unei funcÅ£ii specifice sau a unui capitol nu a fost încÄ + efectuatÄ, sistemul de asamblare automatÄ a manualului revine la versiunea + englezÄ a documentului respectiv. </para> <para> Persoanele implicate în traducere încep de la sursa în <acronym>XML</acronym> @@ -427,21 +437,16 @@ </para> </note> <para> - La moment manualul este disponibil, parÅ£ial sau integral, în urmÄtoarele limbi: - PortughezÄ BrazilianÄ, ChinezÄ (SimplificatÄ), ChinezÄ (CantonezÄ din Hong Kong), - ChinezÄ (TradiÅ£ionalÄ), CehÄ, OlandezÄ, FinlandezÄ, FrancezÄ, GermanÄ, GreacÄ, - EbraicÄ, UngarÄ, ItalianÄ, JapanezÄ, KoreanÄ, PolonezÄ, RomânÄ, RusÄ, SlovacÄ, - SlovenÄ, SpaniolÄ, SuedezÄ Åi TurcÄ. + La moment manualul este disponibil, parÅ£ial sau integral, în peste 10 limbi. </para> <para> - Toate acestea pot fi descÄrcate aici: <link xlink:href="&url.php.docs;">&url.php.docs;</link>. + Toate acestea pot fi descÄrcate aici: + <link xlink:href="&url.php.docs;">&url.php.docs;</link>. </para> </sect1> </appendix> -<!-- Translated by Simion Onea --> - <!-- Keep this comment at the end of the file Local variables: mode: sgml