cvs: phpdoc-cs /appendices about.xml

http://cvs.php.net/viewcvs.cgi/phpdoc-cs/appendices/about.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-cs/appendices/about.xml
diff -u phpdoc-cs/appendices/about.xml:1.3 phpdoc-cs/appendices/about.xml:1.4
--- phpdoc-cs/appendices/about.xml:1.3	Sat Nov 13 20:46:23 2004
+++ phpdoc-cs/appendices/about.xml	Mon May 15 21:07:14 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.36 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.43 Maintainer: luk Status: ready -->
 
 <appendix id="about">
  <title>O tomto manuálu</title>
@@ -18,9 +18,9 @@
    </para>
   </note>
   <para>
-   Manuál mù¾ete èíst on-line na <ulink url="&url.php;"> &url.php;</ulink>
-   a mnoha zrcadlech. Pro zaji¹tìní nejrychlej¹ího pøístupu byste si mìli
-   vybrat zrcadlo umístìné nejblí¾e k vám. Mù¾ete si prohlí¾et manuál v
+   Manuál si lze pøeèíst on-line na <ulink url="&url.php;"> &url.php;</ulink>
+   a mnoha zrcadlech. Pro nejrychlej¹í pøístup byste si mìli
+   vybrat zrcadlo umístìné co nejblí¾e k vám. HTML verze manuálu existuje v
    "holém" HTML formátu (vhodném pro tisk) nebo v HTML formátu integrujícím
    manuál do vzhledu a chování samotných stránek PHP.   
   </para>
@@ -28,23 +28,26 @@
    Dvìma podstatnými výhodami on-line formátù manuálu oproti vìt¹inì off-line
    formátù je integrace <link linkend="about.notes">u¾ivatelských
    poznámek</link> a <ulink url="&url.php.urlhowto;">URL odkazù</ulink>, které
-   mù¾ete pou¾ít k rychlému získání po¾adovaní èástí manuálu. Oèividnou
-   nevýhodou je, ¾e k prohlí¾ení této verze manuálu musíte být on-line.   
+   lze pou¾ít k rychlému pøístupu k po¾adovaným èástem manuálu. Oèividnou
+   nevýhodou je, ¾e k prohlí¾ení této verze manuálu nutno být on-line.   
   </para>
   <para>
    Existuje více off-line formátù manuálu a formát pro vás nejvhodnìj¹í
-   závisí na tom, jaký operaèní systém pou¾íváte a na va¹em osobním stylu
+   závisí na pou¾itém operaèním systému a na osobním stylu
    ètení. Pro informaci o tom, jak je manuál generován v tolika formátech,
    si pøeètìte sekci <link linkend="about.generate">'Jak generujeme
-   formáty'</link> v dodatcích.
+   formáty'</link> v tomto dodatku.
   </para>
   <para>
    Pro nejvíce platforem se hodí manuál v HTML a jako prostý text. HTML
    formát je poskytován jak jako jediný HTML soubor, tak jako balíèek
    souborù podle jednotlivých sekcí (co¾ ve výsledku znamená kolekci
    tisícù souborù). Tyto verze poskytujeme komprimované, k získání souborù
-   z archivù budete potøebovat nìjaký dekompresní nástroj.
+   z archivù je potøeba nìjaký dekompresní nástroj.
   </para>
+  
+  <!--
+  PDF momentálnì není k dispozici. Ale jednoho dne snad bude.
   <para>
    Jiným populárním platformnì nezávislým formátem, a také formátem
    nejvhodnìj¹ím pro tisk, je PDF (známý také jako Adobe Acrobat). Ale
@@ -57,13 +60,8 @@
     stáhnout  <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>.
    </para>
   </note>
-  <para>
-   Pro vlastníky handheldù (Palm kompatibilních) jsou ideální formáty
-   Palm document a iSilo. Mù¾ete si pøinést svùj handheld do práce a pou¾ít
-   prohlí¾eè formátu <ulink url="&url.palm.doc;">DOC</ulink> nebo
-   <ulink url="&url.palm.isilo;">iSilo</ulink> k oprá¹ení znalostí PHP nebo
-   jako rychlou pøíruèku.
-  </para>
+  -->
+  
   <para>
    Pro platformu Windows je k dispozici verze
    <productname>Windows HTML Help</productname> pro pou¾ití s aplikací
@@ -89,7 +87,7 @@
    U¾ivatelské poznámky hrají dùle¾itou roli ve vývoji tohoto manuálu.
    Umo¾nìním ètenáøùm manuálu pøidávat pøíklady a dal¹í vysvìtlení pøímo
    z jejich prohlí¾eèe jsme schopni zabudovat zpìtnou vazbu do hlavního
-   textu manuálu. A ne¾ jsou poznámky zpracovány, jsou vidìt v podobì,
+   textu manuálu. A ne¾ jsou poznámky zpracovány, mohou být vidìt v podobì,
    v jaké je u¾ivatelé poslali, v on-line (a nìkterých off-line) formátech.
   </para>
   <note>
@@ -115,7 +113,7 @@
    <para>
     Ka¾dá funkce v manuálu je pro rychlou referenci zdokumentována. Kdy¾ víte,
     jak èíst a chápat tyto texty, nauèíte se PHP mnohem snadnìji. Namísto
-    spoléhání na pøíklady nebo na vystøihování/vkládání, budete chtít vìdìt,
+    spoléhání na pøíklady nebo na vystøihování/vkládání, by mìl ka¾dý vìdìt,
     jak èíst definice (prototypy) funkcí. Nu¾e, zaènìme:
    </para>
    <note>
@@ -135,16 +133,18 @@
     <function>strlen</function>:
    </para>
    <para>
-    <screen>
+    <screen role="html">
+<![CDATA[
 strlen
 
 (PHP 3, PHP 4, PHP 5)
-strlen -- Zjistí délku øetìzce
+strlen -- Vrací délku øetìzce
 
 Popis
 int strlen ( string str )
 
 Vrací délku øetìzce.
+]]>
     </screen>
    </para>
    <para>
@@ -202,7 +202,9 @@
     </para>
     <para>
      <screen>
+<![CDATA[
       návratový typ    název funkce    ( typ parametru   název parametru )
+]]>
      </screen>
     </para>
     <para>
@@ -210,8 +212,10 @@
      Prototy pak vypadá následovnì:
     </para>
     <para>
-     <screen>    
+     <screen>
+<![CDATA[
       bool in_array ( mixed needle, array haystack [, bool strict])
+]]>
      </screen>
     </para>
     <para>
@@ -241,8 +245,10 @@
      jako pøíklad funkci <function>html_entity_decode</function>:
     </para>
     <para>
-     <screen>    
+     <screen>
+<![CDATA[
       (PHP 4 >= 4.3.0, PHP 5)
+]]>
      </screen>
     </para>
     <para>
@@ -261,11 +267,12 @@
   </para>
   <para>
    Mù¾ete najít kusy dokumentace pro CVS verzi PHP, co¾ v¾dycky znamená
-   nejpozdìj¹í vývojovou verzi dostupnou pøes systém správy verzí CVS.
+   nejpozdìj¹í vývojovou verzi dostupnou pøes systém správy verzí CVS
+   nebo jako <ulink url="&url.php.snapshots;">snapshot</ulink>
    Nejste-li vývojáø samotného PHP a netrpíte posedlostí pou¾ívat
    nejpozdìj¹í vývojovou verzi PHP, mo¾nosti oznaèené jako "dostupné v CVS"
    pro vás nejsou dostupné. Tyto mo¾nosti v¹ak budou pravdìpodobnì dostupné
-   v pøí¹tí stabilní verzi PHP. Chcete-li stáhnout CVS verzi, podívejte se
+   v pøí¹tí stabilní verzi PHP. Pro sta¾ení CVS verze se podívejte
    na stránku o <ulink url="&url.php.anoncvs;">anonymním CVS pøístupu</ulink>.
   </para>
   <para>
@@ -274,6 +281,12 @@
    Vìt¹inou to není chyba v dokumentaci. Èasto se pøidává vysvìtlení mo¾ností,
    které v aktuální vydané verzi nejsou dostupné, ale budou dostupné ve
    známe budoucí verzi PHP.
+   Do PHP se nové vlastnosti pøidávají typicky pouze ve "velkých" (major)
+   verzích, jinak se pouze opravují chyby. Ve formátu A.B.C znamená nová
+   major verze zvý¹ení èísla A nebo B, kde¾to minor verze zvy¹uje èíslo C.
+   Je napø. neobvyklé, aby byla vlastnost dokumenentována jako dostupná
+   od verze PHP x.1.x, kdy¾ poslední verze je x.0.x. Nezapomeòte také,
+   ¾e manuál je psán v pøítomném, nikoli budoucím èase.
   </para>
  </sect1>
  
@@ -281,19 +294,18 @@
   <title>Jak najít více informací o PHP</title>
   <para>
    Tento manuál se nepokou¹í poskytovat instrukce o obecných programovacích
-   technikách. Pokud jste úplnì èerstvý programátor nebo stále je¹tì
-   zaèáteèník, mù¾e vám pøijít obtí¾né nauèit se programovat v PHP pouze podle
-   tohoto manuálu. Mù¾ete chtít hledat texty více orientované na zaèáteèníky.
-   Zde je seznam knih týkajících se PHP:
+   technikách. Úplnì èerstvému programátorovi, nebo stále je¹tì
+   zaèáteèníkovi, se mù¾e zdát obtí¾né nauèit se programovat v PHP pouze podle
+   tohoto manuálu. Proto je lep¹í místo toho hledat text více orientovaný na zaèáteèníky.
+   Nebo knihu, viz také seznam knih týkajících se PHP:
    <ulink url="&url.php.books;">&url.php.books;</ulink>.
   </para>
   <para>
    Existuje mnoho aktivních e-mailových diskusních skupin pro diskusi
-   o v¹ech aspektech programování v PHP. Pokud máte problém, pro který
-   nmù¾ete najít øe¹ení, mohl by vám pomoci nìkdo z tìchto skupin. Seznam
-   diskusních skupin najdete na
-   <ulink url="&url.php.support;">&url.php.support;</ulink>, stejnì tak i
-   odkazy na archivy tìchto skupin a jiné on-line zdroje. Dále,
+   o v¹ech aspektech programování v PHP. Pøi problémech zva¾te pou¾ití
+   tìchto diskusních skupin. Mo¾nosti podpory, vèetnì diskusních skupin,
+   jsou k dispozici na
+   <ulink url="&url.php.support;">&url.php.support;</ulink>. Dále,
    na <ulink url="&url.php.links;">&url.php.links;</ulink> je seznam stránek
    zamìøených na èlánky, fóra a galerie kódu pro PHP.
   </para>
@@ -308,31 +320,35 @@
    Pokud v manuálu najdete chyby (v kterémkoli jazyce), oznamte je prosím
    pomocí bug systému na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
    Klasifikujte chybu jako "Documentation Problem". Mù¾ete také poslat
-   problémy spojené s konkrétními manuálovými formáty zde.
+   problémy spojené s konkrétními manuálovými formáty zde. V¹echny problémy
+   spojené s dokumentací, vèetnì tìch souvisejících s formáty manuálu,
+   by se mìly posílat jako chybová hlá¹ení.
   </para>
   <note>
    <para>
     Nezneu¾ívejte prosím bug systém odesíláním ¾ádostí o pomoc. Pou¾ijte
-    namísto toho diskusní fórum nebo komunitní stránky, jak ji¾ bylo zmínìno.    
+    namísto toho nìkterou z mnoha
+    <ulink url="&url.php.support;">mo¾ností podpory</ulink>.
    </para>
   </note>
   <para>
-   Pøi pøidávání poznámek mù¾ete poskytnout dodateèné pøíklady a vysvìtlení
+   Pøi pøidávání poznámek mohou u¾ivatelé poskytnout dodateèné pøíklady a vysvìtlení
    pro ostatní ètenáøe. Av¹ak neposílejte prosím pomocí tohoto anotaèního
    systému hlá¹ení o chybách. O anotacích se mù¾ete více dozvìdìt v èásti
-   <link linkend="about.notes">'O u¾ivatelských poznámkách'</link> tohoto
-   dodatku.
+   <link linkend="about.notes">'O u¾ivatelských poznámkách'</link>.
   </para>
   <para>
-   Umíte-li angliètinu a nìjaký cizí jazyk, mù¾ete také pomoci s pøeklady.
+   PHP manuál se pøekládá do mnoha jazykù. 
+   Umíte-li angliètinu a nìjaký cizí jazyk, mù¾ete také pomoci zlep¹it
+   manuál prací v pøekladatelském týmu.
    Chcete-li zaèí nový pøeklad nebo pomoci s pøekladovým projektem, ètìte
    prosím <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>.
   </para>
   <para>
-   Dokumentaèní projekt PHP má IRC kanál, kam mù¾ete pøijít a mluvit
-   s autory manuálu, nebo najít nìjaké aspekty manuálu, se kterými mù¾ete
-   pomoci. Je to
-   <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>.
+   Dokumentaèní projekt PHP má IRC kanál, kde se zdr¾uje mnoho autorù
+   manuálu. Nav¹tivte
+   <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>
+   a diskutujte o cestách, jak zlep¹it dokumentaci PHP.
   </para>
  </sect1>
  
@@ -348,7 +364,7 @@
    pro údr¾bu a formátování.
   </para>
   <para>
-   Pou¾ití <acronym>XML</acronym> jako zdrojového formátu nám dává mo¾nost
+   Pou¾ití <acronym>XML</acronym> jako zdrojového formátu dává mo¾nost
    generovat mnoho výstupních formátù ze zdrojových souborù a udr¾ovat pouze
    jediný zdrojový dokument pro v¹echny formáty. Nástroji pou¾itými pro
    formátování <acronym>HTML</acronym> a
@@ -362,18 +378,11 @@
    PHP samotné pro dodateèné konverze a formátování.   
   </para>
   <para>
-   Manuál si mù¾ete stáhnout v rùzných jazycích a formátech, vèetnì prostého
-   textu, prostého <acronym>HTML</acronym>,
-   <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a
-   Windows HTML Help, z
+   Manuál se generuje v rùzných jazycích a formátech, viz
    <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
-   Manuály jsou automaticky aktualizovány, pokud se jejich text zmìní.   
-  </para>
-  <para>
-   Více informací o stahování zdrojového kódu dokumentace v   
-   <acronym>XML</acronym> najdete na
+   Zdrojové kódy v <acronym>XML</acronym> lze stáhnout z CVS a prohlí¾et na
    <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Dokumentace je ulo¾ena
-   v modulu <literal>phpdoc</literal>.
+   v modulu <literal>phpdoc</literal> (èeská v <literal>phpdoc-cs</literal>).
   </para>
  </sect1>
  
@@ -390,8 +399,8 @@
    Lidé, kteøí dokumentaci pøekládají, vycházejí z <acronym>XML</acronym>
    zdrojového kódu dostupného na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>
    a pøekládají ho do svého mateøského jazyka. 
-   <emphasis>Nepou¾ívají</emphasis> <acronym>HTML</acronym>, holý text nebo
-   ani <acronym>PDF</acronym> verzi. Je to sestavovací systém, který zajistí 
+   <emphasis>Nepou¾ívají</emphasis> generované verze (jako <acronym>HTML</acronym>
+   nebo holý text). Je to sestavovací systém, který zajistí 
    konverzi z <acronym>XML</acronym> do lidsky èitelných formátù.
   </para>
   <note>
@@ -402,8 +411,8 @@
     <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>.
     Adresa konference je <literal>&email.php.doc;</literal>. Po¹lete zprávu,
     ve které uvedete, ¾e se zajímáte o pøekládání manuálu do nìjakého jazyka
-    a nìkdo vám odpoví. pomù¾e vám se zaèátkem nového pøekladu nebo kontaktovat
-    ji¾ aktivní dokumentaèní tým pro vá¹ jazyk.
+    a nìkdo vám odpoví. Pomù¾e vám se zaèátkem nového pøekladu nebo kontaktovat
+    ji¾ aktivní dokumentaèní tým pro zvolený jazyk.
    </para>
   </note>
   <para>