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>