cvs: phpdoc-sk /appendices about.xml aliases.xml comparisons.xml

[email protected] ("Joseph Drake") Thu, 08 Jul 2004 00:08:40 -0000
Newsgroups php.doc.sk
Message-ID <cvsjoseph1089245320@cvsserver>
joseph		Wed Jul  7 20:08:40 2004 EDT

  Modified files:              
    /phpdoc-sk/appendices	about.xml aliases.xml comparisons.xml 
  Log:
  updated
joseph-20040707200840.txt (text/plain, 17.3 KB)
http://cvs.php.net/diff.php/phpdoc-sk/appendices/about.xml?r1=1.16&r2=1.17&ty=u
Index: phpdoc-sk/appendices/about.xml
diff -u phpdoc-sk/appendices/about.xml:1.16 phpdoc-sk/appendices/about.xml:1.17
--- phpdoc-sk/appendices/about.xml:1.16	Thu Apr 29 19:28:22 2004
+++ phpdoc-sk/appendices/about.xml	Wed Jul  7 20:08:40 2004
@@ -1,14 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!--EN-Revision: 1.31 Maintainer: joseph Status: ready -->
+<!--EN-Revision: 1.34 Maintainer: joseph Status: ready -->
 
-<!--
-  TODO: add manual conventions section (eg. how to read
-        function usage parts, what is fixed width, what is
-        bold, what is linked)
-        
-        add some tips about combining the versions (online-
-        offline), and using "http://anymirror.php.net/funcname"
--->
 <appendix id="about">
  <title>O manuále</title>
 
@@ -32,8 +24,10 @@
    integruje manuál do podoby samotnej webovskej stránky PHP.
   </para>
   <para>
-   Výhodou online manuálu oproti väè¹ine offline formátom je integrácia 
-   <link linkend="about.notes">príspevkov u¾ivateµov</link>. Zrejmou 
+   Dve za zmienku stojace výhody online manuálu oproti väè¹ine offline formátom
+   je integrácia <link linkend="about.notes">príspevkov u¾ivateµov</link> a
+   <ulink url="&url.php.urlhowto;">URL skratiek</ulink>, ktoré mô¾ete
+   pou¾i» na rýchle získanie po¾adovaných èastí manuálu. Zrejmou 
    nevýhodou je, ¾e musíte by» online, aby ste si mohli prezera» manuál 
    v online formátoch.
   </para>
@@ -44,17 +38,17 @@
    formátov, preèítajte si sekciu <link linkend="about.generate">'Ako generujeme formáty'</link> v tejto prílohe.
   </para>
   <para>
-   Najvhodnej¹ími multi-platformovými formátmi manuálu sú verzie HTML 
-   a prostý text. Formát HTML sa poskytuje ako jednoduchý HTML súbor ako aj 
-   balík individuálnych súborov pre ka¾dú sekciu (ktorá pozostáva zo zväzku 
-   niekoµko tisíc súborov). Formáty HTML a prostý text sa poskytujú ako tar
-   súbory komprimované programom bzip2.
+   Najvhodnej¹ími multi-platformovými formátmi manuálu je HTML verzia. 
+   Táto sa poskytuje ako jednoduchý HTML súbor a aj ako balík individuálnych
+   súborov pre ka¾dú sekciu (ktorá pozostáva zo zväzku niekoµko tisí súborov).
+   Poskytujeme tieto verzie zbalené, budete pobrebova» nejaký druh rozbalovacej
+   utility na získanie súborov obsiahnutých v archívoch.
   </para>
   <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á 
-   2000 strán a ¾e sa neustále upravuje.
+   viac ne¾ 2000 strán a ¾e sa neustále upravuje.
   </para>
   <note>
    <para>
@@ -65,29 +59,29 @@
   </note>
   <para>
    Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty 
-   Palm dokument a iSilo. Mô¾ete si svoj handheld nosi» denne so sebou
+   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 Windows HTML Help umo¾òuje
+   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
    poskytuje full-textové vyhµadávanie, plný index, a oznaènie zará¾ok 
    (bookmarking). Mnoho známych vývojových prostredí pre Windows tie¾
-   zahàòa túto verziu dokumentácie pre jednoduchý prístup.
+   zahàòa túto verziu dokumentácie pre jednoduchý prístup. CHM prehliadaèe pre
+   Linuxové desktopy sú tie¾ k dispozícii. Skúste
+   <ulink url="&url.xchm;">xCHM</ulink> alebo
+   <ulink url="&url.gnochm;">GnoCHM</ulink>.
+  </para>
+  
+  <para>
+   Je tie¾ dostupná <ulink url="&url.php.echm;">roz¹írená CHM verzia</ulink>,
+   ktorá sa obnovuje menej èasto, ale poskytuje vaè¹í poèet
+   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>
-<!--
-  mmmm, this project seems to be dead. Any news?
-  <note>
-   <para>
-    Projekt Visual Basic pre Linux je plánovaná fáza, ktorá bude zahàòa»
-    vývoj CHM Creator and Wiewer pre Linux. Pozrite si ich na 
-    <ulink url="&url.vb4linux;">stránke SourceForge.net</ulink>, ak sa 
-    zaujímate o priebeh.
-   </para>
-  </note>
-  -->
  </sect1>
  
  <sect1 id="about.notes">
@@ -120,8 +114,8 @@
  <sect1 id="about.prototypes">
    <title>Ako èíta» definíciu funkcie (prototyp)</title>
    <para>
-    Ka¾dá funkcia je zdokumentovaná v informaènej príruèke. Znalos»,
-    ako sa má manuál èíta» a rozumie», pou¾ívanie PHP znaène uµahèí.
+    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:
    </para>
@@ -144,7 +138,7 @@
     <screen>
 strlen
 
-(PHP 3, PHP 4 >= 4.0.0)
+(PHP 3, PHP 4, PHP 5)
 strlen -- Urèí då¾ku reta¾ca
 
 Popis
@@ -174,10 +168,10 @@
         </row>
         <row>
          <entry>
-          (PHP 3, PHP 4 >= 4.0.0)
+          (PHP 3, PHP 4, PHP 5)
          </entry>
          <entry>
-          strlen() bol k dispozícii v ochoch PHP 3 a PHP 4
+          strlen() je k dispozícii vo v¹etkých verziách PHP 3, PHP 4 a PHP 5
          </entry>
         </row>
         <row>
@@ -187,7 +181,7 @@
          <entry>
           Typ hodnoty, ktorú táto funkcia vracia, èo je 
           <type>integer</type>
-          (t.j. Då¾ka re»azca sa udáva v èíslach).
+          (t.j. då¾ka re»azca sa udáva v èíslach).
          </entry>
         </row>
         <row>
@@ -195,9 +189,9 @@
           ( string str )
          </entry>
          <entry>
-          Prvý (a v tomto prípade jediný) parameter/argument pre 
-          funkciu strlen() sa nazýva <parameter>str</parameter> a je to 
-          <type>re»azec</type>.
+          Prvý (a v tomto prípade jediný) parameter/argument pre túto
+          funkciu sa nazýva <parameter>str</parameter> a je to 
+          <type>string</type>.
          </entry>
         </row>
        </tbody>
@@ -208,7 +202,7 @@
      Definíciu horeuvedenej funkcie by sme mohli prepísa» do v¹eobecného tvaru:
     </para>
     <para>
-     <screen role="html">
+     <screen>
       vrátený typ    názov funkcie    ( typ parametra   názov parametra )
      </screen>
     </para>
@@ -217,7 +211,7 @@
      Jeho prototyp vyzerá následovne:
     </para>
     <para>
-     <screen role="html">    
+     <screen>    
       bool in_array (mixed ihla, array stoh_sena [, bool strict])
      </screen>
     </para>
@@ -242,13 +236,26 @@
      nastevený na boolean &false;.  Pozri manuálovú stránku pre ka¾dú 
      funkciu a ako fungujú.
     </para>
+    <para>
+     Existujú tie¾ funkcie s komplexnej¹ími informácia mi o PHP verii. Berte
+     <function>html_entity_decode</function> za príklad:
+    </para>
+    <para>
+     <screen>    
+      (PHP 4 >= 4.3.0, PHP 5)
+     </screen>
+    </para>
+    <para>
+     Toto znamená, ¾e táto funkcia nebola dostupná v PHP 3 a je dostupná
+     len vo vydanej verzii od PHP 4.3.0.
+    </para>
  </sect1>
  
  <sect1 id="about.phpversions">
   <title>Verzie PHP zdokumentované v tomto manuále</title>
   <para>
-   Táto dokumentácia obsahuje informácie o PHP 4, s niektorými pridanými
-   migráciami a poznámkami ku kompatibilite s PHP 3. Správanie,
+   Táto dokumentácia obsahuje informácie o oboch PHP 4 a PHP 5, s niektorými
+   pridanými migráciami a poznámkami ku kompatibilite s PHP 3. Správanie,
    parameter, navrátenie hodnoty a iné zmeny medzi rôznymi verziami
    PHP sú zdokumentované v poznámkach a v medziriadkovom texte v manuále.
   </para>
@@ -263,7 +270,7 @@
   </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, nakoµko najnov¹ia stabilná
+   nie je 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í.
@@ -286,9 +293,9 @@
    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;">&url.php.support;</ulink>. 
+   url="&url.php.support;">Stránke podpory PHP.net</ulink>. 
    Okrem toho, na 
-   <ulink url="&url.php.links;">&url.php.links;</ulink> je zoznam webových
+   <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.
   </para>
  </sect1>
@@ -301,7 +308,7 @@
   <para>
    Ak v tomto manuáli nájdete 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 tu tie¾ hlási» 
+   Klasifikujte bug ako "Documentation Problem". Mô¾ete tam tie¾ hlási» 
    problémy, ktoré súvisia so ¹pecifickým formátom manuálu.
   </para>
   <note>
@@ -342,7 +349,7 @@
    formáty. Nástroje pou¾ívané na formátovanie <acronym>HTML</acronym> 
    a <acronym>TeX</acronym> verzií sú
    <ulink url="&url.jade;">Jade</ulink>, ktorý napísal <ulink
-   url="&url.jclark;">James Clark</ulink> a <ulink
+   url="&url.jclark;">James Clark</ulink>; a <ulink
    url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>,
    ktorý napísal <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
    Pou¾ívame <ulink url="&url.winhelp;">Microsoft HTML Help
@@ -356,7 +363,7 @@
    <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a
    Windows HTML Help, z
    <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
-   Manuály sa aktualizujú periodicky súèasne s textom.
+   Kvôli technickým dôvodom nemusia by» niektoré formáty dostupné.
   </para>
   <para>
    Viac informácií o s»ahovaní zdrojového kódu 
@@ -400,7 +407,7 @@
    Momentálne je manuál èiastoène dostupný v následujúcich jazykoch:
    v brazílskej portugalèine, èín¹tine (zjednodu¹enej), èín¹tine (Hong
    Kong Cantonese), èín¹tine (tradiènej), èe¹tine, holand¹tine, fín¹tine,
-   francúz¹tine, nemèine, greéètine, hebrejèine, maïarèine, talianèine,
+   francúz¹tine, nemèine, gréètine, hebrejèine, maïarèine, talianèine,
    japonèine, kórejèine, pol¹tine, rumunèine, ru¹tine, slovenèine, slovinèine,
    ¹panielèine, ¹védèine a tureètine.
   </para>
http://cvs.php.net/diff.php/phpdoc-sk/appendices/aliases.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc-sk/appendices/aliases.xml
diff -u phpdoc-sk/appendices/aliases.xml:1.6 phpdoc-sk/appendices/aliases.xml:1.7
--- phpdoc-sk/appendices/aliases.xml:1.6	Thu Apr 29 19:31:00 2004
+++ phpdoc-sk/appendices/aliases.xml	Wed Jul  7 20:08:40 2004
@@ -1,20 +1,21 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.28 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.29 Maintainer: joseph Status: ready -->
 <appendix id="aliases">
  <title>Zoznam aliasov funkcií</title>
  <para>
-  Tu je zoznam aliasov. Sú tu v¹etky. Zvyèajne nie je dobrý nápad
-  pou¾íva» aliasy, preto¾e mô¾u by» zastaralé alebo sa mô¾u 
-  premenova», èo vedie k nefunkènému skriptu. Tento zoznam sa poskytuje
-  ako pomoc pre tých, ktorí chcú aktualizova» svoje staré skripty
+  V PHP existuje zopár funkcií, ktoré mô¾ete vola» s viac ne¾ jedným
+  názvom. V niektorých prípadoch nie je ¾iaden preferovaný názov medzi
+  viacerými, <function>is_int</function> a
+  <function>is_integer</function> sú rovnako doboré, napríklad.
+  Av¹ak, existujú funkcie, ktoré si zmenili názov kvôli API
+  poriadku alebo z iného dôvodu a staré názvy sa udr¾iavajú iba ako
+  aliasy pre spätnú kompatibilitu. Zvyèajne nie je dobrý nápad pou¾íva»
+  tieto druhy aliasov, preto¾e mô¾u zastara» alebo zmeni» svoj 
+  názov, èo bude vies» k neportovatelnému skriptu. Tento zoznam sa poskytuje
+  ako pomoc pre tých, ktorí si chcú aktualizova» svoje staré skripty
   na nový syntax.
  </para>
  <para>
-  Niektoré funkcie majú jednoducho dva názvy, av¹ak neexistuje
-  ¾iadna preferencia (Napríklad, <function>is_int</function> a
-  <function>is_integer</function> sú zhodné)
- </para>
- <para>
   Tento zoznam je jednotný s PHP 4.0.6. Zoznam aliasov, ktorý sa aktualizuje
   denne, si mô¾te pozrie» na <ulink url="&url.zend.aliaslist;">&url.zend.aliaslist;</ulink>.
  </para>
@@ -103,7 +104,7 @@
 <row>
  <entry>chop</entry>
  <entry><function>rtrim</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>close</entry>
@@ -298,7 +299,7 @@
 <row>
  <entry>fputs</entry>
  <entry><function>fwrite</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>get_attribute</entry>
@@ -468,37 +469,37 @@
 <row>
  <entry>ini_alter</entry>
  <entry><function>ini_set</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>is_double</entry>
  <entry><function>is_float</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>is_integer</entry>
  <entry><function>is_int</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>is_long</entry>
  <entry><function>is_int</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>is_real</entry>
  <entry><function>is_float</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>is_writeable</entry>
  <entry><function>is_writable</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>join</entry>
  <entry><function>implode</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>labelframe</entry>
@@ -528,7 +529,7 @@
 <row>
  <entry>magic_quotes_runtime</entry>
  <entry><function>set_magic_quotes_runtime</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>mbstrcut</entry>
@@ -1118,7 +1119,7 @@
 <row>
  <entry>pos</entry>
  <entry><function>current</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>recode</entry>
@@ -1138,7 +1139,7 @@
 <row>
  <entry>rewind</entry>
  <entry><function>rewinddir</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>root</entry>
@@ -1358,12 +1359,12 @@
 <row>
  <entry>show_source</entry>
  <entry><function>highlight_file </function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>sizeof</entry>
  <entry><function>count</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>skewx</entry>
@@ -1403,7 +1404,7 @@
 <row>
  <entry>strchr</entry>
  <entry><function>strstr</function></entry>
- <entry>Base syntax</entry>
+ <entry>Základný syntax</entry>
 </row>
 <row>
  <entry>streammp3</entry>
http://cvs.php.net/diff.php/phpdoc-sk/appendices/comparisons.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc-sk/appendices/comparisons.xml
diff -u phpdoc-sk/appendices/comparisons.xml:1.1 phpdoc-sk/appendices/comparisons.xml:1.2
--- phpdoc-sk/appendices/comparisons.xml:1.1	Sun Jul 20 20:27:14 2003
+++ phpdoc-sk/appendices/comparisons.xml	Wed Jul  7 20:08:40 2004
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.5 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.9 Maintainer: joseph Status: ready -->
 <appendix id="types.comparisons">
  <title>Tabuµky porovnávania typov PHP</title>
  <para>
-  Následujúce tabuµky demon¹trujú správania pre PHP
+  Následujúce tabuµky demon¹trujú správania PHP
   <link linkend="language.types">typy</link> a 
   <link linkend="language.operators.comparison">porovnávacie
   operátory</link>, pre voµné i striktné porovnávania. Táto 
@@ -21,7 +21,7 @@
  </para>
  <note>
   <para>
-   HTML Formulára neprijímajú integer, float alebo boolean, prijímajú re»azce.
+   HTML Formulára neprijímajú integer, float alebo boolean; prijímajú re»azce.
    Na zistenie, èi je re»azec numerický, mô¾ete pou¾i»
    <function>is_numeric</function>.
   </para>
@@ -347,7 +347,7 @@
       <entry>&false;</entry>
       <entry>&false;</entry>
       <entry>&false;</entry>
-      <entry>&false;</entry>
+      <entry>&true;</entry>
       <entry>&true;</entry>
       <entry>&false;</entry>
      </row>