cvs: phpdoc-sk /appendices about.xml

joseph		Fri Dec 27 20:35:15 2002 EDT

  Modified files:              
    /phpdoc-sk/appendices	about.xml 
  Log:
  updated
  
Index: phpdoc-sk/appendices/about.xml
diff -u phpdoc-sk/appendices/about.xml:1.7 phpdoc-sk/appendices/about.xml:1.8
--- phpdoc-sk/appendices/about.xml:1.7	Sat Sep 21 13:33:59 2002
+++ phpdoc-sk/appendices/about.xml	Fri Dec 27 20:35:15 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!--EN-Revision: 1.16 Maintainer: joseph Status: ready -->
+<!--EN-Revision: 1.19 Maintainer: joseph Status: ready -->
 
 <!--
   TODO: add manual conventions section (eg. how to read
@@ -109,6 +109,159 @@
   </note>
  </sect1>
  
+ <sect1 id="about.prototypes">
+   <title>Ako èíta» definíciu funkicie (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
+    ulah¹í. Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», 
+    chcete rad¹ej vedie» ako èíta» definície funkcií (prototypy). Zaènime:
+   </para>
+   <note>
+    <title>
+     Nevyhnutná podmienka: Základná interpretácia <link linkend="language.types">typov</link>
+    </title>
+    <para>
+     I keï PHP je len poµahky typovým jazykom, je dôle¾ité ma» základné
+     vedomosti o <link linkend="language.types">typoch</link>, preto¾e
+     majú dôle¾itý význam.
+    </para>
+   </note>
+   <para>
+    Definície funkcií nám hovoria aký 
+    typ hodnoty je <link linkend="functions.returning-values">navrátený</link>, 
+    pou¾ijeme definíciu pre <function>strlen</function>, ako ná¹ prvý príklad:
+   </para>
+   <para>
+    <screen role="html">
+strlen
+
+(PHP 3, PHP 4 >= 4.0.0)
+strlen -- Urèí då¾ku reta¾ca
+
+Popis
+int strlen ( string str )
+
+Vráti då¾ku re»azca.
+    </screen>
+   </para>
+   <para>
+    <table>
+     <title>Vysvetlenie funkènej definície<title>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>Èas»</entry>
+         <entry>Popis</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry>
+          strlen
+         </entry>
+         <entry>
+          Názov funkcie.
+         </entry>
+        </row>
+        <row>
+         <entry>
+          (PHP 3, PHP 4 >= 4.0.0)
+         </entry>
+         <entry>
+          strlen() bol k dispozícii v ochoch PHP 3 a PHP 4
+         </entry>
+        </row>
+        <row>
+         <entry>
+          int
+         </entry>
+         <entry>
+          Typ hodnoty, ktorú táto funkcia vracia, èo je 
+          <link linkend="language.types.integer">integer</link>
+          (t.j. Då¾ka re»azca sa udáva v èíslach).
+         </entry>
+        </row>
+        <row>
+         <entry>
+          ( 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 
+          <link linkend="language.types.string">re»azec</link>.
+         </entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </table>
+    </para>
+    <para>
+     Definíciu horeuvedenej funkcie by sme mohli prepísa» do v¹eobecného tvaru:
+    </para>
+    <para>
+     <screen role="html">
+      vrátený typ    názov funkcie    ( typ parametra   názov parametra )
+     </screen>
+    </para>
+    <para>
+     Mnoho funkcií má viacero parametrov, ako má napr. <function>in_array</function>.
+     Jeho prototyp vyzerá následovne:
+    </para>
+    <para>
+     <screen role="html">    
+      bool in_array ( zmie¹aná ihla, array stoh_sena [, bool striktne])
+     </screen>
+    </para>
+    <para>
+     Èo to vlastne znamená?  in_array() vracia hodnotu
+     <link linkend="language.types.boolean">boolean</link>, &true; ak je
+     prevdivý (<parameter>ihla</parameter> bola nájdená v 
+     <parameter>stoh_sena</parameter>) alebo &false; pri chybe (
+     <parameter>ihla</parameter> sa nena¹la v
+     <parameter>stoh_sena</parameter>).  Prvý parameter je pomenovaný
+     <parameter>ihla</parameter> a mô¾e by» viacerých
+     <link linkend="language.types">typov</link>, tak¾e sme ho nazvali
+     "<emphasis>zmie¹aná</emphasis>".  Táto zmie¹aná <parameter>ihla</parameter> 
+     (ktorú hµadáme) mo¾e by» buï skalárna hodnota (string, integer, 
+     alebo <link linkend="language.types.float">float</link>) alebo
+     <link linkend="language.types.array">pole</link>.  
+     <parameter>stoh_sena</parameter> (pole, v ktorom hµadáme) je 
+     druhý parameter.  Tretí <emphasis>voliteµný</emphasis> parameter je 
+     pomenovaný <parameter>striktne</parameter>.  V¹etky voliteµné parametre sú uzavreté  
+     do <emphasis>[</emphasis> zátvoriek <emphasis>]</emphasis>.  Manuál 
+     ukladá, ¾e parameter  <parameter>striktne</parameter> je ¹tandardne
+     nastevený na boolean &false;.  Pozri manuálovú stránku pre ka¾dú 
+     funkciu a ako fungujú.
+    </para>
+ </sect1>
+ 
+ <sect1 id="about.phpversions">
+  <title>Verzie PHP zdokumentované v tomot 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,
+   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>
+  <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;">anonymná prístupná CVS stránka</ulink>.
+  </para>
+  <para>
+   Taktie¾ mô¾te narazi» na dokumentáciu pre PHP verziu, ktorá e¹te
+   nie je uvoµnená (nieèo ako PHP 4.3.0, preto¾e najnov¹ia samostatná
+   verzia je 4.2.3). Väè¹inou toto nepredstavuje chybu v dokumtácii.
+   Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v
+   aktuálnom PHP vydaní, ale budú dostupné v známej budúcej PHP verzií.
+  </para>
+ </sect1>
+
  <sect1 id="about.more">
   <title>Ako nájs» viac informácii o PHP</title>
   <para>
@@ -237,8 +390,8 @@
   </note>
   <para>
    Momentálne je manuál èiastoène dostupný v následujúcich jazykoch:
-   v brazílskej portugal¹tine, èe¹tine, holand¹tine, francúz¹tine, nemèine,
-   maïarèine, talianèine, japonèine, kórejèine, pol¹tine a ¹panielèine.
+   v brazílskej portugal¹tine, èín¹tine, èe¹tine, holand¹tine, francúz¹tine,
+   nemèine, maïarèine, talianèine, japonèine, kórejèine, pol¹tine a ¹panielèine.
   </para>
   <para>
    V¹etky sa dajú stiahnú» tu: <ulink url="&url.php.docs;">&url.php.docs;</ulink>.