cvs: phpdoc-sk /appendices about.xml

http://cvs.php.net/diff.php/phpdoc-sk/appendices/about.xml?r1=1.18&r2=1.19&ty=u
Index: phpdoc-sk/appendices/about.xml
diff -u phpdoc-sk/appendices/about.xml:1.18 phpdoc-sk/appendices/about.xml:1.19
--- phpdoc-sk/appendices/about.xml:1.18	Fri Dec  3 15:10:58 2004
+++ phpdoc-sk/appendices/about.xml	Wed Sep  7 19:27:38 2005
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!--EN-Revision: 1.36 Maintainer: joseph Status: ready -->
+<!--EN-Revision: 1.42 Maintainer: joseph Status: ready -->
 
 <appendix id="about">
  <title>O manuále</title>
@@ -19,7 +19,7 @@
   <para>
    Manuál si mô¾ete preèíta» online na <ulink url="&url.php;">&url.php;</ulink>
    a na poèetných mirrorovaných stránkach. Pre najlep¹iu èinnos» by ste si mali
-   zvoli» mirrorovanú stránku najbli¾¹ie k vám. Manuál si mô¾ete prezera» buï
+   zvoli» najbli¾¹í mirror. HTML verzia manuálu je buï
    v jednoduchom (vhodnom pre tlaè) HTML formáte alebo v HTML formáte, ktorý
    integruje manuál do podoby samotnej webovskej stránky PHP.
   </para>
@@ -44,27 +44,22 @@
    Poskytujeme tieto verzie zbalené, budete pobrebova» nejaký druh rozbalovacej
    utility na získanie súborov obsiahnutých v archívoch.
   </para>
+  <!--
+   The PDF version of the PHP Manual is "currently" unavailable. Perhaps
+   one day it will exist.
   <para>
    Ïal¹ím obµúbeným multi-platformovým formátom, ktorý je najvhodnej¹í pre
-   tlaè, je PDF (tie¾ známy ako Adobe Acrobat). Ale ne¾ sa pustíte do
-   s»ahovania tohto formátu a jeho tlaèe, majte na pamäti, ¾e manuál má 
-   viac ne¾ 2000 strán a ¾e sa neustále upravuje.
+   tlaè, je PDF (tie¾ známy ako Adobe Acrobat). Ale majte na pamäti, 
+   ¾e manuál má viac ne¾ 2000 strán a ¾e sa neustále upravuje.
   </para>
   <note>
    <para>
-    Ak e¹te nemáte program schopný prezerania súborov formátu PDF, mo¾ete
-    si stiahnú» <ulink url="&url.adobe.acrobat;">Adobe
+    Existuje mnoho programov na prezeranie súborov <acronym>PDF</acronym>,
+    ako napr. <ulink url="&url.adobe.acrobat;">Adobe
     Acrobat Reader</ulink>.
    </para>
   </note>
-  <para>
-   Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty 
-   Palm dokument a <productname>iSilo</productname>.
-   Mô¾ete si svoj handheld nosi» denne so sebou
-   a pou¾íva» <ulink url="&url.palm.doc;">DOC</ulink> alebo 
-   <ulink url="&url.palm.isilo;">iSilo</ulink> reader, aby ste si
-   zdokonalili svoje PHP vedomosti, alebo ho len pou¾íva» ako príruèku.
-  </para>
+  -->
   <para>
    Pre platformy Windows, verzia manuálu <productname>Windows HTML Help</productname> umo¾òuje
    pou¾itie HTML formátu vo Windows HTML Help aplikáciach. Táto verzia
@@ -78,7 +73,7 @@
   
   <para>
    Je tie¾ dostupná <ulink url="&url.php.echm;">roz¹írená CHM verzia</ulink>,
-   ktorá sa obnovuje menej èasto, ale poskytuje vaè¹í poèet
+   ktorá sa obnovuje menej èasto, ale poskytuje mnoho ïal¹ích
    funkcií. Bude fungova» teda fungova» pod <productname>Microsoft Windows</productname>,
    kvôli technológiám pou¾ívaným na tvorenie stránok pomocníka.
   </para>
@@ -116,8 +111,8 @@
    <para>
     Ka¾dá funkcia v manuále je zdokumentovaná v informaènej príruèke. Znalos»,
     ako sa má text èíta» a rozumie», uèenie PHP znaène uµahèí.
-    Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», rad¹ej
-    budete chcie» vedie» ako èíta» definície funkcií (prototypy). Zaènime:
+    Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», ka¾dý by
+    mal vedie» ako èíta» definície funkcií (prototypy). Zaènime:
    </para>
    <note>
     <title>
@@ -135,7 +130,8 @@
     Pou¾ijeme definíciu pre <function>strlen</function>, ako ná¹ prvý príklad:
    </para>
    <para>
-    <screen>
+    <screen role="html">
+<![CDATA[
 strlen
 
 (PHP 3, PHP 4, PHP 5)
@@ -145,6 +141,7 @@
 int strlen ( string str )
 
 Vráti då¾ku re»azca.
+]]>
     </screen>
    </para>
    <para>
@@ -203,7 +200,9 @@
     </para>
     <para>
      <screen>
+<![CDATA[
       vrátený typ    názov funkcie    ( typ parametra   názov parametra )
+]]>
      </screen>
     </para>
     <para>
@@ -212,7 +211,9 @@
     </para>
     <para>
      <screen>    
+<![CDATA[
       bool in_array (mixed ihla, array stoh_sena [, bool strict])
+]]>
      </screen>
     </para>
     <para>
@@ -242,7 +243,9 @@
     </para>
     <para>
      <screen>    
+<![CDATA[
       (PHP 4 >= 4.3.0, PHP 5)
+]]>
      </screen>
     </para>
     <para>
@@ -260,20 +263,34 @@
    PHP sú zdokumentované v poznámkach a v medziriadkovom texte v manuále.
   </para>
   <para>
-   Mô¾te nájs» dokumentaèné kúsky pre CVS verziu PHP, ktorá v¾dy
-   predstavuje najnov¹ie vyvíjanú verziu dostupnú cez systém CVS. Ak
-   nie ste vývojárom PHP samotného a nie ste nad¹ený pou¾ívaním
-   najnov¹ie vyvíjanej verzie PHP, rubriky oznaèené "available in CVS"
-   (dostupné v CVS) nie sú pre vás dostupné. I keï tieto rubriky budú
-   prevdepodobne dostupné v dal¹ej samostatnej verzii PHP. Ak by ste
-   si chceli stiahnu» CVS verziu, pozri <ulink url="&url.php.anoncvs;">CVS stránka prístupná pre anonymných</ulink>.
+   Dokumentácia èiastoène existuje pre CVS verziu PHP, ktorá v¾dy
+   predstavuje najnov¹ie vyvíjanú verziu. Táto sa stále e¹te musí vyda»,
+   tak¾e je dostupná jedine cez riadiaci systém verzií alebo cez
+   <ulink url="&url.php.snapshots;">snapshot</ulink>. Tak¾e vedzte, ¾e
+   rubriky oznaèené "available in CVS" (dostupné v CVS) nie sú pre vás
+   typicky dostupné. I keï tieto rubriky budú prevdepodobne dostupné
+   v dal¹ej stabilnej verzii PHP. Pre stiahnutie CVS verzie, porzi
+   <ulink url="&url.php.anoncvs;">anonymná prístupová CVS stránka</ulink>.
   </para>
   <para>
-   Taktie¾ mô¾ete narazi» na dokumentáciu pre PHP verziu, ktorá e¹te
-   nie je uvoµnená (nieèo ako PHP 5.0.0, zatialèo najnov¹ia stabilná
+   Taktie¾ mô¾u existova» dokumentácie pre PHP verzie, ktoré e¹te
+   nie sú uvoµnené (nieèo ako PHP 5.0.0, zatialèo najnov¹ia stabilná
    verzia je 4.3.x). Väè¹inou toto nepredstavuje chybu v dokumetácii.
    Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v
    aktuálnom PHP vydaní, ale ktoré budú dostupné v známej budúcej PHP verzií.
+   PHP typicky pridáva nové vlastnosti iba v hlavných vydaniach, inak sa
+   opravujú iba chyby. Pri pou¾ití formátu verzií A.B.C, hlavný vydanie 
+   inkrementuje A alebo B, nakoµko men¹ie vydania inkrementujú C. Tak¾e napr.
+   nie je nezvyklé, aby nejaká vlastno» bola zdokumentovaná a dostupná 
+   v PHP x.1.x, keï najnov¹ie vydanie je PHP x.0.x. Tie¾ si v¹imnite, ¾e
+   manuál je písaný v prítomnom èase, nie v budúcom.
+  </para>
+  <para>
+   Many times the PHP manual lists "Default Values" for PHP directives. These 
+   values are based on <filename>php.ini-dist</filename> and not 
+   <filename>php.ini-recommended</filename>. They also refer to the latest  
+   version of PHP. See the <link linkend="ini.list">PHP directive 
+   appendix</link> for details on these values and changes.
   </para>
  </sect1>
 
@@ -281,40 +298,39 @@
   <title>Ako nájs» viac informácii o PHP</title>
   <para>
    Tento manuál sa nesna¾í poskytova» in¹trukcie o v¹eobecných programovacích
-   praktikách. Ak ste len zaèínajúcim programátorom, mô¾e sa vám zda» zlo¾ité
-   nauèi» sa programova» v PHP len za pomoci tohto manuálu. Mô¾ete si 
-   vyhµada» texty, ktoré sú viac orientované pre zaèiatoèníkov. Zoznam
-   kníh súvisiacich s PHP mô¾ete nájs» na <ulink
+   praktikách. Zaèínajúcim programátorom sa mô¾e zda» zlo¾ité
+   nauèi» sa programova» v PHP výhradne za pomoci tohto manuálu. Miest toho 
+   si vyhµadajte texty, ktoré sú viac orientované pre zaèiatoèníkov. Alebo
+   nejakú knihu, tie¾ pozri zoznam kníh súvisiacich s PHP na <ulink
    url="&url.php.books;">&url.php.books;</ulink>.
   </para>
   <para>
    Existuje mno¾stvo aktívnych mailing listov urèených pre diskusie o v¹etkých
-   aspektoch programovania v PHP. Ak ste uviazli na probléme, na ktorý neviete
-   nájs» vlastné rie¹enie, mô¾ete získa» pomoc od niekoho na týchto mailing 
-   listoch. Zoznam mailing listov rovnako ako liniek na archívy mailing listov 
-   a iných podporných online zdrojov mô¾ete nájs» na <ulink
-   url="&url.php.support;">Stránke podpory PHP.net</ulink>. 
-   Okrem toho, na 
-   <ulink url="&url.php.links;">Stránke odkazov PHP.net</ulink> je zoznam webových
-   stránok urèených PHP èlánkom, diskusným fóram a galériám kódov.
+   aspektoch programovania v PHP. Ak ste uviazli pri probléme, zvá¾te
+   vyu¾itie týchto mailing listov. Pre mo¾nosti podpory, vrátane mailing
+   listov, pozri <ulink url="&url.php.support;">Stránku podpory PHP.net</ulink>. 
+   Okrem toho existuje zoznam web stránok venovaných PHP èlánkom, fóram 
+   a galériam kódov na <ulink url="&url.php.links;">Stránke odkazov PHP.net</ulink> .
   </para>
  </sect1>
 
  <sect1 id="about.howtohelp">
   <title>Ako pomôc» pri zlep¹ovaní dokumentácie</title>
   <para>
-   Sú tri spôsoby ako mô¾ete pomôc» zlep¹i» túto dokumentáciu.
+   Sú tri spôsoby ako ka¾dý mô¾e pomôc» zlep¹i» túto dokumentáciu.
   </para>
   <para>
-   Ak v tomto manuáli nájdete chyby, i v inom jazyku, prosím hláste ich 
+   Ak sa v tomto manuáli nájdu chyby, i v inom jazyku, prosím hláste ich 
    pomocou bug systému na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
-   Klasifikujte bug ako "Documentation Problem". Mô¾ete tam tie¾ hlási» 
-   problémy, ktoré súvisia so ¹pecifickým formátom manuálu.
+   Klasifikujte bug ako "Documentation Problem". V¹etky problémy vz»ahujúce sa 
+   k manuálu, vrátane tých súvisiacich s formátmi manuálu, by sa mali posiela»
+   ako správy o chybách (bug report).
   </para>
   <note>
    <para>
-    Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. Namiesto toho pou¾ívajte
-    skôr spomenuté mailing listy alebo stránky komunity.
+    Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc.
+    Namiesto toho, pou¾ite jednu z mnohých 
+    <ulink url="&url.php.support;">mo¾ností podpory</ulink>.
    </para>
   </note>
   <para>
@@ -324,16 +340,17 @@
    <link linkend="about.notes">'O príspevkoch u¾ívateµov'</link> tejto prílohy.
   </para>
   <para>
-   Ak viete anglicky a nejaký cudzí jazyk, mô¾ete taktie¾ vypomôc»
-   v prekladaní. Ak by ste chceli zaèa» nový preklad, alebo
-   pomôc» v projekte prekladu, prosím èítajte 
-   <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>.
+   PHP manuál je prelo¾ený do mnohých jazykov. Znalos» angliètiny a 
+   cudzieho jazyka dáva priestor pre ïal¹í spôsob ako pomôc» zlep¹i» PHP
+   manuál, a to prácou s prekladateµským tímov. Pre informácie ako zaèa»
+   nový preklad, alebo ako pomôc» momentálne prekladanej verzii, prosím
+   èitajte <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>.
   </para>
   <para>
-   PHP Dokoumentaèný Projekt má IRC kanál, kde mô¾ete prís»
-   a pokeca» si s autormi manuálu alebo nájs» nejaké aspekty
-   manuálu, s ktorými mo¾no potrebujete pomôc» Je to
-   <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>.
+   Dokumentaèný Projekt PHP má IRC kanál, kde sa zdr¾iavajú
+   autori. Nav¹tívte <literal>#phpdoc</literal> na
+   <literal>irc.freenode.net</literal> a diskutujte o spôsoboch zlep¹enia
+   PHP dokumentácie.
   </para>
  </sect1>
 
@@ -349,7 +366,7 @@
    pre úpravu a formátovanie.
   </para>
   <para>
-   Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu nám
+   Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu
    umo¾òuje generovanie mnohých výstupných formátov zo zdrojových
    súborov, prièom sa upravuje iba jeden zdrojový dokument pre v¹etky
    formáty. Nástroje pou¾ívané na formátovanie <acronym>HTML</acronym> 
@@ -364,17 +381,10 @@
    dodatoèné úpravy a formátovanie.
   </para>
   <para>
-   Tie¾ si manuál mô¾ete stiahnú» vo viacerých jazykoch
-   a formátch, vrátanie prostého textu, <acronym>HTML</acronym>,
-   <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a
-   Windows HTML Help, z
-   <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
-   Kvôli technickým dôvodom nemusia by» niektoré formáty dostupné.
-  </para>
-  <para>
-   Viac informácií o s»ahovaní zdrojového kódu 
-   <acronym>XML</acronym> tejto dokumentácie mô¾ete nájs»
-   na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>.
+   PHP manuál je generovaný vo viacerých jazykoch a formátoch, pozri
+   <ulink url="&url.php.docs;">&url.php.docs;</ulink> pre ïal¹ie detaily.
+   Zdrojový kód <acronym>XML</acronym> je mo¾né stiahnú» z CVS a
+   prezrie» na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>.
    Dokumentácia je ulo¾ená v module <literal>phpdoc</literal>.
   </para>
  </sect1>
@@ -393,20 +403,21 @@
    ¥udia, ktorí sa podieµajú na prekladoch zaèínajú zo zdrojového kódu 
    <acronym>XML</acronym> dostupného na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>
    a z neho ho prekladajú do svojho materinského jazyka.
-   <emphasis>Nepou¾ívajú</emphasis> <acronym>HTML</acronym>, prostý text, 
-   ani <acronym>PDF</acronym> verziu. Je to build systém, ktorý prekladá 
-   <acronym>XML</acronym> kód do µudskej reèi.
+   <emphasis>Nepou¾ívajú</emphasis> generované verzie (ako
+   <acronym>HTML</acronym> alebo prostý text) nakoµko je to build systém,
+   ktorý sa stará o preklad z <acronym>XML</acronym> do formátu zrozumiteµného
+   pre µudí.
   </para>
   <note>
    <para>
-    Ak by ste sa chceli podiela» na prekladaní dokumentácie do vá¹ho 
-    rodného jazyka, prosím, kontaktujte translation/documentation team
+    Ak chcete pomôc» s prekladom dokumentácie,
+    prosím, kontaktujte translation/documentation team
     prihlasením sa do mailing listu phpdoc: po¹lite prázdny mail na <ulink
     url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>.
     Adresa mailing listu je <literal>&email.php.doc;</literal>. V správe
-    uveï»e, ¾e máte záujem o prekladanie manuálu do svojho jazyka. Niekto sa
-    vám ozve, radiac vám ako zaèa» preklad do nového jazyka alebo ako sa 
-    pripoji» k u¾ aktívnemu dokumentaènému tímu pre vá¹ jazyk.
+    preuká¾te záujem o prekladanie manuálu a ozve sa vám niekto, kto
+    a poradí ako zaèa» s preklad do nového jazyka alebo ako skontaktova»
+    existujúci tím pre ¾iadaný jazyk.
    </para>
   </note>
   <para>