cvs: phpdoc-he /appendices about.xml

Index: phpdoc-he/appendices/about.xml
diff -u phpdoc-he/appendices/about.xml:1.4 phpdoc-he/appendices/about.xml:1.5
--- phpdoc-he/appendices/about.xml:1.4	Sat May 17 15:40:08 2003
+++ phpdoc-he/appendices/about.xml	Thu Jul 17 15:13:49 2003
@@ -1,209 +1,417 @@
-<?xml version="1.0" encoding="WINDOWS-1255"?>
-<!-- $Revision: 1.11 $ -->
-
-<!--
-  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>àåãåú äîãøéê</title>
-
- <sect1 id="about.formats">
-  <title>âøñàåú</title>
-  <para>
-   îãøéê PHP îâéò áîñôø âøñàåú. âøñàåú àìå éëåìåú ìäúçì÷ ìùúé ÷áåöåú:
-   âøñàåú ùðéúï ì÷øåà áàåôï î÷ååï åçáéìåú ðéúðåú-ìäåøãä.
-  </para>
-  <note>
-   <para>
-    îñôø îå"ìéí ôøñîå âøñàåú îåãôñåú ùì îãøéê æä. àðå
-	ìà éëåìéí ìäîìéõ òì âøñàåú ëàìå, ùëï äï ðåèåú ìäôåê
-	ììà-îòåãëðåú áîäéøåú øáä.
-   </para>
-  </note>
-  <para>
-   ðéúï ì÷øåà àú äîãøéê áàåôï î÷ååï á- <ulink url="&url.php;"> &url.php;</ulink>
-   åáîñôø àúøé øàé. ìáéöåòéí äèåáéí áéåúø, ëãàé ìáçåø àú àúø äøàé ä÷øåá áéåúø àìéê.
-   ðéúï ìäöéâ àú äîãøéê áôåøîè HTML ôùåè (éãéãåúé ìäãôñä) àå áôåøîè HTML äîùìá àú
-   äîãøéê òí äîøàä åääøâùä ùì àúø PHP òöîå.
-  </para>
-  <para>
-   éúøåï ùì äîãøéê äî÷ååï òì äâøñàåú äìà-î÷ååðåú äåà äùéìåá ùì
-   <link linkend="about.notes">äòøåú îùúîùéí</link>. çéñøåï áøåø
-   äåà ùéù ìäéåú îçåáø òì-îðú ì÷øåà àú äîãøéê áôåøîè î÷ååï.
-  </para>
-  <para>
-   éùðï îñôø âøñàåú ìà-î÷ååðåú ùì äîãøéê, åäâøñä äîúàéîä ìê áéåúø úìåéä áîòøëú
-   ääôòìä ùìê åáñâðåï ä÷øéàä äàéùé ùìê. ìîéãò òì ëéöã äîãøéê îçåìì áëì-ëê
-   äøáä âøñàåú, ðéúï ì÷øåà àú äçì÷ <link linkend="about.generate">'ëéöã àðå îçåììéí
-   àú äâøñàåú'</link> ùì ðñôç æä.
-  </para>
-  <para>
-   äâøñàåú äëé ìà-úìåéåú-ôìèôåøîä ùì äîãøéê äï âøñàåú ä- HTML åäè÷ñè.
-   âøñàú ä- HTML îñåô÷ú äï ëãó HTML áåãã åäï ëçáéìä ùì ÷áöéí ðôøãéí
-   òáåø ëì çì÷ (ãáø ùéåöø àåñó ùì îñôø àìôéí ùì ÷áöéí(. âøñàåú ä- HTML åäè÷ñè
-   îñåô÷åú ë÷áöé tar äîëååöéí ò"é bzip2.
-  </para>
-  <para>
-   âøñä ìà-úìåéú-ôìèôåøîä ôåôåìøéú ðåñôú, åäâøñä äîúàéîä áéåúø ìäãôñä,
-   äéà âøñú ä- PDF (éãåò âí ë- Adobe Acrobat). àê ìôðé ùúæãøæ ìäåøéã àú
-   äâøñä åììçåõ òì ëôúåø ääãôñä, ùéí ìá ùäîãøéê äåà áï ëîòè 2000 ãôéí,
-   åîùúðä áàåôï ÷áåò.
-  </para>
-  <note>
-   <para>
-    àí àéï ìê òãééï úåëðä ùîñåâìú ìäöéâ ÷áöé PDF, úöèøê ìäåøéã àú
-    <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>.
-   </para>
-  </note>
-  <para>
-   ìáòìé îçùáé ëó-éã úåàîé Palm, âøñàåú îñîê ä- Palm åä- iSilo äï
-   äàéãàìéåú ìôìèôåøîä æå. àúä éëåì ì÷çú àéúê àú äîëùéø áðñéòåú
-   äéåîéåú åìäùúîù á÷åøà<ulink url="&url.palm.doc;">DOC</ulink>
-   àå <ulink url="&url.palm.isilo;">iSilo</ulink> ëãé ìøòðï
-   àú éãò ä- PHP ùìê, àå ôùåè ëçåîø-òéåï îäéø.
-  </para>
-  <para>
-   ìîùúîùé çìåðåú, âøñú ä"òæøú HTML ìçìåðåú" ùì äîãøéê îúàéîä àú âøñú ä- HTML
-   ìúåëðú òæøú ä- HTML ùì çìåðåú. âøñä æå îàôùøú çéôåù è÷ñè-îìà, àéðã÷ñ îìà
-   åñéîðéåú. áðåñó äøáä ñáéáåú ôéúåç PHP ìçìåðåú îùåìáåú òí âøñä æå ùì äúéòåã
-   ëãé ìñô÷ âéùä îäéøä.
-  </para>
-  <note>
-   <para>
-    ôøåé÷è Visual Basic ììéðå÷ñ ðîöà áùìáé ôéúåç, îä ùéëìåì àú äôéúåç ùì
-	éåöø åîöéâ CHM ììéðå÷ñ. øàä
-    <ulink url="&url.vb4linux;">ãó äôøåé÷è á- SourceForge.net</ulink>
-	àí àúä îòåðééï áäú÷ãîåú.
-   </para>
-  </note>
- </sect1>
- 
- <sect1 id="about.notes">
-  <title>àåãåú äòøåú äîùúîùéí</title>
-  <para>
-   ìäòøåú äîùúîùéí úô÷éã çùåá îàåã áôéúåç ùì îãøéê æä. ò"é îúï àôùøåú
-   ì÷åøàé äîãøéê ìúøåí ãåâîàåú, àæäøåú åùàø äáäøåú äéùø îäãôãôï ùìäí,
-   àðå îñåâìéí ìäëìéì àú äîùåá äæä ìúåê äè÷ñè äøàùé ùì äîãøéê. åòã
-   ùääòøåú äåëììå, äï îåöâåú áöåøä äîåâùú ùìäï áàåôï î÷ååï åáîñôø âøñàåú
-   ìà î÷ååðåú.
-  </para>
-  <note>
-   <para>
-    äòøåú äîùúîùéí ìà îðåäìåú ìôðé ùäï îåôéòåú áàåôï î÷ååï, åìëï àéëåú äëúéáä
-	àå ãåâîàåú ä÷åã, àå àôéìå äàîéúåú ùì äúøåîä, ìà éëåìéí ìäéåú îåáèçéí.
-	(ìà ùéù ëì àçøéåú òì äàéëåú àå äãéå÷ ùì è÷ñè äîãøéê òöîå.)
-   </para>
-  </note>
- </sect1>
- 
- <sect1 id="about.more">
-  <title>ëéöã ì÷áì îéãò ðåñó àåãåú PHP</title>
-  <para>
-   îãøéê æä ìà îðñä ìñô÷ äñáøéí àåãåú úøâåìé úëðåú ëììééí.
-   àí àúä îúëðú áôòí äøàùåðä, àå àôéìå ø÷ îúëðú îúçéì, àåìé úîöà
-   ùììîåã úëðåú á- HP áàîöòåú îãøéê æä éäéä ÷ùä.
-   ëãàé ùúçôù è÷ñè ùîëååï éåúø ìîúçéìéí. àúä éëåì ìîöåà øùéîä ùì
-   ñôøéí ä÷ùåøéí ì- PHP á- <ulink url="&url.php.books;">&url.php.books;</ulink>.
-  </para>
-  <para>
-   éùðï îñôø øùéîåú ãéååø ôòéìåú ìãéåï ëì ääéáèéí ùì úëðåú òí PHP.
-   àí úú÷ò ôòí ááòéä ùàúä ìà îöìéç ìîöåà ìä ôúøåï, áàôùøåúê ì÷áì òæøä
-   îîéùäå áøùéîåú àìå. ðéúï ìîöåà øùéîä ùì øùéîåú äãéååø á- <ulink
-   url="&url.php.support;">&url.php.support;</ulink>, ëîå âí ÷éùåøéí
-   ìî÷åøåú úîéëä î÷ååðéí àçøéí. áðåñó, á- <ulink
-   url="&url.php.links;">&url.php.links;</ulink> éùðä øùéîä ùì àúøéí
-   äîå÷ãùéí ìîàîøéí, ôåøåîéí åâìøéåú ÷åã ùì PHP.
-  </para>
- </sect1>
-
- <sect1 id="about.howtohelp">
-  <title>ëéöã ðéúï ìòæåø ìùéôåø äúéòåã</title>
-  <para>
-   éùðï ùúé ãøëéí ìòæåø ìùéôåø úéòåã æä.
-  </para>
-  <para>
-   àí àúä îåöà ùâéàåú áîãøéê æä, áëì ùôä, àðà ãååç òìéäï áàîöòåú îòøëú äáàâéí
-   á  <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
-   ñååâ àú äáàâ ë"áòééú úéòåã" ("Documentation Problem"). àúä éëåì ìãååç âí òì
-   áòéåú ä÷ùåøåú ìâøñàåú îñåéîåú ùì äúéòåã ëàï.
-  </para>
-  <note>
-   <para>
-    àðà àì úùúîù ìøòä áîòøëú äáàâéí ò"é ùìéçú á÷ùåú ìòæøä. äùúîù áøùéîåú äãéååø
-	åáàúøé ä÷äéìä ùöåéðå ÷åãí áî÷åí.
-   </para>
-  </note>
-  <para>
-   òì-éãé äåñôú äòøåú, àúä éëåì ìñô÷ ãåâîàåú ðåñôåú, àæäøåú åäáäøåú ì÷åøàéí
-   äàçøéí. àê áá÷ùä àì úãååç òì áàâéí áàîöòåú îòøëú äôéøåùéí. ðéúï ì÷øåà òåã
-   òì äôéøåùéí áçì÷ <link linkend="about.notes">'àåãåú äòøåú äîùúîùéí'</link>
-   ùì ðñôç æä.
-  </para>
- </sect1>
- 
- <sect1 id="about.generate">
-  <title>ëéöã àðå îçåììéí àú äâøñàåú</title>
-  <para>
-   îãøéê æä øùåí á <acronym>XML</acronym> åîùúîù á <ulink
-   url="&url.docbook.xml;">DocBook XML DTD</ulink>, äîùúîù á <ulink
-   url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
-   Style and Semantics Specification Language) ìòéöåá, åáàåôï ðéñéåðé á
-   <ulink url="&url.xslt;"><acronym>XSLT</acronym>
-   </ulink> (Extensible Stylesheet Language Transformations)
-   ìðéäåì åòéöåá.
-  </para>
-  <para>
-   äùéîåù á <acronym>XML</acronym> ëôåøîè î÷åø îàôùø ìðå
-   ìçåìì ôìè áâøñàåú øáåú î÷áöé äî÷åø, úåê ðéäåì îñîê î÷åø
-   àçã òáåø ëì äâøñàåú.
-   äëìéí ìòéöåá âøñàåú ä-<acronym>HTML</acronym> åä-<acronym>TeX</acronym>
-   äí  <ulink url="&url.jade;">Jade</ulink>, ùðëúá ò"é <ulink
-   url="&url.jclark;">â'ééîñ ÷ìàø÷</ulink> å <ulink
-   url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
-   ùðëúáå ò"é <ulink url="&url.nwalsh;">ðåøîï ååìù</ulink>.
-   àðå îùúîùéí á<ulink url="&url.winhelp;">ñãðú òæøú HTML ùì
-   îé÷øåñåôè</ulink> ëãé ìçåìì àú âøñàåú òæøú ä-HTML ìçìåðåú
-   ùì äîãøéê, åëîåáï PHP òöîå áùáéì îñôø äîøåú åòéöåáéí àçøéí.
-  </para>
-  <para>
-   ðéúï ìäåøéã àú äîãøéê áùôåú åâøñàåú ùåðåú, áéï äùàø áè÷ñè ôùåè,
-   <acronym>HTML</acronym> ôùåè, <acronym>PDF</acronym>, PalmPilot DOC,
-   PalmPilot iSilo åòæøú HTML ìçìåðåú, î
-   <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
-   äîãøéëéí îòåãëðéí áàåôï àåèåîèé ëùäè÷ñè îúòãëï.
-  </para>
-  <para>
-   ðéúï ìîöåà îéãò ðåñó àåãåú äåøãú ÷åã äî÷åø á
-   <acronym>XML</acronym> ùì úéòåã æä á
-   <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. äúéòåã
-   îàåçñï áîåãåì <literal>phpdoc</literal>.
-  </para>
- </sect1>
-
-</appendix>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+<?xml version="1.0" encoding="WINDOWS-1255"?>
+<!-- $Revision: 1.26 $ -->
+<!-- HE-Revision: 1.00 Maintainer: hadar_p Status: complete -->
+
+<!--
+  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>àåãåú îãøéê æä</title>
+
+ <sect1 id="about.formats">
+  <title>úáðéåú</title>
+  <para>
+   îãøéê ä- PHP ÷ééí áîñôø úáðéåú. úáðéåú àìä éëåìåú ìäúçì÷
+   ìùúé ÷áåöåú: úáðéåú äð÷øàåú àåï-ìééï, åçáéìåú ìäåøãä.
+  </para>
+  <note>
+   <para>
+    çì÷ îäåöàåú ìãôåñ âøñàåú îåãôñåú ùì îãøéê æä. àðçðå ìà
+    éëåìéí ìäîìéõ òì àó àçã îàìå, ùëï äï ðåèåú ìäôåê ìîéåùðåú
+    áîäéøåú øáä.
+   </para>
+  </note>
+  <para>
+   ðéúï ì÷øåà àú äîãøéê àåï-ìééï á- <ulink url="&url.php;">&url.php;</ulink>
+   åáîñôø àúøé øàé àçãéí. ìáéöåòéí îéèáééí, ëãàé ìê ìáçåø àú àúø äøàé
+   äëé ÷øåá àìéê. áàôùøåúê ìøàåú àú îãøéê æä àå áúáðéú HTML ôùåèä
+   (éãéãåúéú-ìäãôñä) àå áúáðéú HTML àùø îùìáú àú äîãøéê ìúåê äîøàä
+   åääøâùä ùì àúø äàéðèøðè ùì PHP òöîå.
+  </para>
+  <para>
+    éúøåï ùì äîãøéê äàåï-ìééï òì ôðé äúáðéåú äðéúðåú ìäåøãä äåà
+    äùéìåá ùì <link linkend="about.notes">äòøåú îùúîùéí</link>.
+    çñøåï áøåø îàìéå ùéù öåøê ìäéåú îçåáø òì îðú ìöôåú áúáðéåú
+    äàåï-ìééï ùì äîãøéê.
+  </para>
+  <para>
+    éùðï îñôø úáðéåú äðéúðåú ìäåøãä ùì äîãøéê, åäúáðéú äëé îúàéîä 
+    áùáéìê úìåéä áîòøëú ääôòìä ùìê åáäòãôåú ä÷øéàä ùìê. ìîéãò òì
+    àéê äîãøéê äæä ðåöø áëì ëê äøáä úáðéåú, ÷øà àú äçì÷ 
+    <link linkend="about.generate">àéê àðçðå îééöøéí àú äúáðéåú</link> ùì 
+    ðñôç æä.
+  </para>
+  <para>
+   äúáðéåú äëé áìúé úìåéåú áôìôåøîä ùì äîãøéê äí âøñàåú ä- HTML åè÷ñè ôùåè.
+   úáðéú ä- HTML îñåô÷ú âí ë÷åáõ HTML éçéã åâí ëçáéìä ùì ÷áöéí ðôøãéí ìëì çì÷
+   (ãáø àùø éåöø àåñó ùì îñôø îàåú ÷áöéí). úáðéåú ä- HTML åè÷ñè ôùåè îñåô÷éí
+   ëë÷áöé Tar ãçåñéí áòæøú úåëðú äãéçåñ Bzip2.
+  </para>
+  <para>
+   úáðéú ôåôìøéú ðåñôú àùø ìà úìåéä áôìèôåøîä, åàùø äëé îúàéîä ìäãôñä,
+   äéà ä- PDF (âí éãåòä ë- Adobe Acrobat). àáì ìôðé äçéôæåï ùìê ìäåøéã
+   àú úáðéú æàú åììçåõ òì ëôúåø ääãôñä, ùéí ìá ùäîãøéê äåà ëîòè
+   áàåøê ùì 2000 òîåãéí, åîòåãëï áàåôï úãéø.
+  </para>
+  <note>
+   <para>
+    àí àéï ìê òãééï úåëðä äîñåâìú ìöôåú ÷áöé úáðéú PDF, ééúëï åúöèøê
+    ìäåøéã àú <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader
+    </ulink>.
+   </para>
+  </note>
+  <para>
+   ìáòìé îëùéøé ëó-éã úåàîé-ôàìí, úáðéåú äôàìí åä- iSilo äï àéãéàìéåú
+   áùáéì äôìèôåøîä äæàú. éù áàôùøåúê ì÷çú àú îçùá ëó-äéã ùìê áðñéòåú
+   äéåîéåú ùìê åìäùúîù á÷åøàé <ulink url="&url.palm.doc;">DOC</ulink>
+   àå <ulink url="&url.palm.isilo;">iSilo</ulink> òì îðú ìöçöç àú
+   éãò ä- PHP ùìê, àå ìäùúîù áå ëçåîø òéåï îäéø.
+  </para>
+  <para>
+   ìôìèôåøîåú Windows, âøñú ä- Windows HTML Help ùì äîãøéê îùìáú àú
+   úáðéú ä- HTML ìùéîåù áúåëðú Windows HTML Help. âøñä æàú îòðé÷ä çéôåù,
+   àéðã÷ñ îìà, åøùéîú îåòãôéí.  îñôø øá ùì ñáéáåú ôéúåç ùì PHP âí îùìáåú
+   àú âøñä æàú ùì äãå÷åîðèöéä ìñô÷ âéùä ÷ìä.
+  </para>
+<!--
+  mmmm, this project seems to be dead. Any news?
+  <note>
+   <para>
+    A Visual Basic for Linux project is in the planning stage, which will
+    include the development of a CHM Creator and Viewer for Linux. See their
+    <ulink url="&url.vb4linux;">SourceForge.net page</ulink> if you are
+    interested in the progress.
+   </para>
+  </note>
+  -->
+ </sect1>
+ 
+ <sect1 id="about.notes">
+  <title>àåãåú äòøåú îùîùéí</title>
+  <para>
+   äòøåú äîùúîùéí îùç÷åú úô÷éã çùåá áôéúåç ùì îãøéê æä. ò"é îúï àôùøåú
+   ì÷åøàé äîãøéê ìúøåí ãåâîàåú, àæäøåú åäáäøåú äééùø îäãôãôï ùìäí, àðçðå
+   éëåìéí ìëìåì àú îùåá æä ìúåê äè÷ñè äøàùé ùì äîãøéê. åòã ùäòøåú ìà
+   ðëììåú áîãøéê, äï ðéúðåú ìöôééä áöåøä äî÷ååðú ùìäï åáçì÷ îäúáðéåú
+   äðéúðåú ìäåøãä.
+  </para>
+  <note>
+   <para>
+    äòøåú äîùúùéí ìà îöåðæøåú ìôðé ùäï îåôéòåú áàåôï î÷ååï, àæ äàéëåú
+    ùì äëúéáä àå ãåâîàåú ä÷åã,, àå àôéìå äîäéîðåú ùì äúøåîä, ìà éëåìä
+    ìäéåú áàçøéåú. (ìà ùéù àéùæäå àçøéåú ìàéëåú àå ãéå÷ ùì è÷ñè äîãøéê
+    òöîå.)
+   </para>
+  </note>
+  <note>
+   <para>
+    ìîèøåú ëéñåé äøéùåé äòøåú äîùúîùéí ðçùáåú çì÷ îîãøéê ä- PHP, åìëï
+    äí îëåñåú ò"é àåúå øùéåï ùîëñä àú äãå÷åîèöéä äæàú (GPL áøâò æä).
+    ìòåã ôøèéí øàä àú òîåã <link linkend="copyright">æëåéåú éåöøéí ùì äîãøéê</link>.
+   </para>
+  </note>
+ </sect1>
+
+ <sect1 id="about.prototypes">
+   <title>ëéöã ì÷øåà äâãøä ùì ôåð÷öéä (àá-èéôåñ)</title>
+   <para>
+    ëì ôåð÷öéä îúåòãú ìòéåï îäéø, ìãòú ëéöã ì÷øåà åìäáéï àú
+    äîãøéê äæä éâøåí ìùéîåù á- PHP ìäéåú äøáä éåúø ÷ì.
+    áî÷åí ìñîåê òì ãåâîàåú àå äòú÷/äãá÷, òãéó ùúãò ëéöã
+    ì÷øåà àú äâãøåú äôåð÷öéä (àáé-èéôåñ). äáä ðúçéì:
+   </para>
+   <note>
+    <title>
+     úðàé îå÷ãí: äáðä áñéñéú ùì <link linkend="language.types">ñåâé îùúðéí</link>
+    </title>
+    <para>
+     àó òì ôé ù- PHP äéà ùôä äîåãôñú áàåôï çåôùé ìîãé, æä çùåá ùéäéä
+	äáðä áñéñéú ùì <link linkend="language.types">ñåâé îùúðéí</link>
+	ëéååï ùéù ìäí îùîòåú çùåáä.
+    </para>
+   </note>
+   <para>
+    äâãøåú ôåð÷öéåú îâìéí ìðå àéæä ñåâ ùì òøê
+    <link linkend="functions.returning-values">îåçæø</link>,
+    äáä ðùúîù áäâãøä ùì <function>strlen</function> ëãåâîà øàùåðä ùìðå:
+   </para>
+   <para>
+    <screen>
+strlen
+
+(PHP 3, PHP 4 >= 4.0.0)
+strlen -- ÷áìú àåøê îçøåæú
+
+úéàåø
+îñôø ùìí strlen ( îçøåæú str )
+
+îçæé÷ä àú äàåøê ùì îçøåæú.
+    </screen>
+   </para>
+   <para>
+    <table>
+     <title>äñáø ùì äâãøú äôåð÷öéä</title>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>çì÷</entry>
+         <entry>úéàåø</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry>
+          strlen
+         </entry>
+         <entry>
+          ùí äôåð÷öéä.
+         </entry>
+        </row>
+        <row>
+         <entry>
+          (PHP 3, PHP 4 >= 4.0.0)
+         </entry>
+         <entry>
+          strlen() äééúä ÷ééîú áëì âøñàåú PHP 3 å- PHP 4
+         </entry>
+        </row>
+        <row>
+         <entry>
+          îñôø ùìí
+         </entry>
+         <entry>
+	     ñåâ äòøê ùäôåð÷öéä äæàú îçæéøä, ùäåà <type>îñôø ùìí</type>
+		(ìãåâîà, äàåøê ùì îçøåæú ðîãã áîñôøéí).
+         </entry>
+        </row>
+        <row>
+         <entry>
+          ( îçøåæú str )
+         </entry>
+         <entry>
+	     äôøîèø/àøâåîðè äøàùåï (åáî÷øä äæä äéçéã) ìôåð÷öéä strlen()
+		ð÷øà <parameter>str</parameter>, åäåà îñåâ <type>îçøåæú</type>.
+         </entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </table>
+    </para>
+    <para>
+     àðçðå éëåìéí ìùëúá àú äâãøú äôåð÷öéä äð"ì áãøê ëììéú éåúø:
+    </para>
+    <para>
+     <screen role="html">
+      ñåâ îùúðä îåçæø    ùí äôåð÷öéä    ( ñåâ äôøîèø   ùí äôøîèø )
+     </screen>
+    </para>
+    <para>
+     ôåð÷öéåú øáåú îùúîùåú áôøîèøéí îøåáéí, ëîå <function>in_array</function>.
+	äãâí äøàùåðé ùìä ëãì÷îï:
+    </para>
+    <para>
+     <screen role="html">    
+      bool in_array ( îòåøá îçè, îòøê òøéîú_ùçú [, áåìéàðé strict])
+     </screen>
+    </para>
+    <para>
+     îä æä àåîø? in_array() îçæéøä òøê
+	<link linkend="language.types.boolean">áåìéàðé</link> , &true; áî÷øä
+	ùì äöìçä (äôøîèø <parameter>îçè</parameter> ðîöà áúåê 
+	<parameter>òøéîú_ùçú</parameter>) àå &false; áî÷øä ùì ëéùìåï
+	(äôøîèø <parameter>îçè</parameter> ìà ðîöà áúåê 
+	<parameter>òøéîú_ùçú</parameter>). äôøîèø äøàùåï îëåðä áùí
+	<parameter>îçè</parameter> åäåà éëåì ìäéåú äøáä 
+	<link linkend="language.types">ñåâé îùúðéí</link>,
+	àæ ìëï àðçðå îëðéí àåúå "<emphasis>îòåøá</emphasis>".
+	<parameter>îçè</parameter> äîòåøá äæä (îä ùàðçðå îçôùéí
+	àçøéå) éëåì ìäéåú òøê áåãã (îçøåæú, îñôø ùìí, àå ùáø), àå
+     <link linkend="language.types.array">îòøê</link>.  
+	<parameter>òøéîú_ùçú</parameter> (äîòøê ùáå àðçðå îçôùéí áå) äåà
+	äôøîèø äùðé. äôøîèø äùìéùé <emphasis>äàåôöéåðìé</emphasis> äåà
+	îëåðä áùí <parameter>strict</parameter>. ëì äôøîèøéí äàåôöéåðìéí
+	ðëúáéí á- <emphasis>[</emphasis> ñåâøééí <emphasis>]</emphasis>.
+	äîãøéê ÷åáò ëé áøéøú äîçãì ùì äôøîèø äáåìéàðé <parameter>strict</parameter>
+	äåà &false;. øàä àú òîåã äîãøéê ìëì ôåð÷öéä ìôøèéí ëéöã àéê äï òåáãåú.
+    </para>
+ </sect1>
+ 
+ <sect1 id="about.phpversions">
+  <title>âøñàåú PHP îúåòãåú áîãøéê æä</title>
+  <para>
+   äúéòåã îëéì îéãò àåãåú PHP 4, òí ëîä äòøåú îòáø åúàéîåú áðåâò
+   ì- PHP 3. äúðäâåú, ôøîèø, òøê îåçæø åùéðåééí àçøéí áéï âøñàåú ùåðåú
+   ùì PHP îúåòãåú áäòøåú åáúåê äè÷ñè ùì äîãøéê. 
+  </para>
+  <para>
+   àúä àåìé âí úîöà çúéëåú úéòåã ìâøñàú ä- CVS ùì PHP, ùäéà
+   úîéã îöééðú àú âøñàú äôéúåç äëé çãéùä áéåúø äæîéðä ãøê îòøëú
+   äèéôåì ùì CVS. àí àúä ìà îôúç ùì PHP òöîå, åàúä ìà ðìäá îìäùúîù
+   áâøñú äôéúåç äëé çãéùä ùì PHP, úëåðåú äîñåîðåú áðéñåç "æîéï
+   á- CVS" ìà éäéå ðâéùåú ìê. áëì æàú úëåðåú àìå éäéå ëðøàä æîéðåú
+   áâøñä äéöéáä äáàä ùì PHP. àí àúä øåöä ìäåøéã àú âøñàú ä- CVS, øàä
+   <ulink url="&url.php.anoncvs;">òîåã ëðéñä àðåðîé ì- CVS</ulink>.
+  </para>
+  <para>
+   ééúëï åúú÷ì áúéòåã ìâøñàú PHP àùø ìà ùåçøøä òãééï (îùäå ëîå 
+   PHP 5.0.0, ëàùø äâøñä äéöéáä äàçøåðä äéà 4.3.0). áøåá äæîï, æä ìà
+   ùâéàä áúéòåã. äñáøéí áã"ë ðåñôéí ìúëåðåú ùòãééï ìà æîéðåú
+   áâøñàú PHP äðåëçéú, àáì éäéå æîéðåú áâøñä òúéãéú ùì PHP. 
+  </para>
+ </sect1>
+   
+ <sect1 id="about.more">
+  <title>ëéöã ì÷áì îéãò ðåñó àåãåú PHP</title>
+  <para>
+   îãøéê æä ìà îðñä ìñô÷ äãøëä ìâáé úøâåìé úëðåú ëììéí. àí àúä
+   îúëðú áôòí äøàùåðä, àå àôéìå ø÷ îúëðú îúçéì, àúä àåìé úîöà 
+   ùæä ÷ùä ììîåã ìúëðú á- PHP ø÷ îîãøéê æä. àúä àåìé úøöä ìçôù è÷ñè
+   ùéåúø îëååï ì÷øàú îúçéìéí. àúä éëåì ìîöåà ñôøéí ä÷ùåøéí ì- PHP àöì
+   <ulink url="&url.php.books;">&url.php.books;</ulink>.
+  </para>
+  <para>
+   éùðï îñôø øùéîåú ãéååø ôòéìåú ìãéåï ëì ääéáèéí ùì úëðåú òí PHP.
+   àí úú÷ò ôòí ááòéä ùàúä ìà îöìéç ìîöåà ìä ôúøåï, áàôùøåúê ì÷áì òæøä
+   îîéùäå áøùéîåú àìå. ðéúï ìîöåà øùéîä ùì øùéîåú äãéååø á- <ulink
+   url="&url.php.support;">&url.php.support;</ulink>, ëîå âí ÷éùåøéí
+   ìî÷åøåú úîéëä î÷ååðéí àçøéí. áðåñó, á- <ulink
+   url="&url.php.links;">&url.php.links;</ulink> éùðä øùéîä ùì àúøéí
+   äîå÷ãùéí ìîàîøéí, ôåøåîéí åâìøéåú ÷åã ùì PHP.
+  </para>
+ </sect1>
+
+ <sect1 id="about.howtohelp">
+  <title>ëéöã ìòæåø ìùôø àú äúéòåã</title>
+  <para>
+   éùðí ùìåù ùéèåú ùáäï úåëì ìòæåø ìùôø àú úéòåã æä.
+  </para>
+  <para>
+   àí àúä îåöà ùâéàåú áîãøéê æä, áëì ùôä, àðà ãååç òìéäï áàîöòåú îòøëú äáàâéí
+   àöì <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
+   ñååâ àú äáàâ ë"áòééú úéòåã" ("Documentation Problem"). àúä éëåì ìãååç âí òì
+   áòéåú ä÷ùåøåú ìâøñàåú îñåéîåú ùì äúéòåã ëàï.
+  </para>
+  <note>
+   <para>
+    àðà àì úùúîù ìøòä áîòøëú äáàâéí ò"é ùìéçú á÷ùåú ìòæøä. äùúîù áøùéîåú äãéååø
+    åáàúøé ä÷äéìä ùöåéðå ÷åãí áî÷åí.
+   </para>
+  </note>
+  <para>
+   ò"é äåñôú äòøåú, àúä éëåì ìñô÷ ãåâîàåú ðåñôåú, àæäøåú åäáäøåú ì÷åøàéí
+   äàçøéí. àê áá÷ùä àì úãååç òì áàâéí áàîöòåú îòøëú äôéøåùéí. ðéúï ì÷øåà òåã
+   òì äôéøåùéí áçì÷ <link linkend="about.notes">'àåãåú äòøåú äîùúîùéí'</link>
+   ùì ðñôç æä.
+  </para>
+  <para>
+   àí àúä éåãò àðâìéú åùôåú æøåú ðåñôåú, àúä éëåì ìòæåø
+   áúøâåîéí. àí àúä øåöä ìäúçéì úøâåí çãù, àå ìòæåø áôøåéé÷è
+   úøâåí ÷ééí, àðà ÷øà àú <ulink url="&url.php.dochowto;">&url.php.dochowto;
+   </ulink>.
+  </para>
+ </sect1>
+ 
+ <sect1 id="about.generate">
+  <title>ëéöã àðçðå îééöøéí àú äúáðéåú</title>
+  <para>
+   äîãøéê äæä ëúåá á- <acronym>XML</acronym> áùéîåù á- <ulink
+   url="&url.docbook.xml;">DocBook XML DTD</ulink>, äîùúîù á- <ulink
+   url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> Document
+   Style and Semantics Specification Language) ìòéöåá, åáàåôï
+   ðéñéåðé á- <ulink url="&url.xslt;"><acronym>XSLT</acronym></ulink> 
+   (Extensible Stylesheet Language Transformations) ìàçæ÷ä åìòéöåá.
+  </para>
+  <para>
+   äùéîåù á- <acronym>XML</acronym> ëúáðéú î÷åø îàôùøú ìðå
+   àú äéëåìú ìçåìì ôìè áúáðéåú øáåú î÷áöé äî÷åø, úåê ðéäåì
+   îñîê î÷åø àçã òáåø ëì äúáðéåú.
+   äëìéí ìòéöåá úáðéåú ä- <acronym>HTML</acronym> åä- <acronym>TeX</acronym>
+   äí <ulink url="&url.jade;">Jade</ulink>, ùðëúá ò"é <ulink
+   url="&url.jclark;">â'ééîñ ÷ìàø÷</ulink> å- <ulink
+   url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
+   ùðëúáå ò"é <ulink url="&url.nwalsh;">ðåøîï ååìù</ulink>.
+   àðå îùúîùéí á<ulink url="&url.winhelp;">ñãðú òæøú HTML ùì
+   îé÷øåñåôè</ulink> ëãé ìçåìì àú úáðéú Windows HTML Help
+   ùì äîãøéê, åëîåáï PHP òöîå áùáéì îñôø äîøåú åòéöåáéí àçøéí.
+  </para>
+  <para>
+   ðéúï ìäåøéã àú äîãøéê áùôåú åáúáðéåú ùåðåú, áéï äùàø áè÷ñè ôùåè,
+   <acronym>HTML</acronym> ôùåè, <acronym>PDF</acronym>, PalmPilot DOC,
+   PalmPilot iSilo å- Windows HTML Help îúåê
+   <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
+   äîãøéëéí îòåãëðéí áàåôï àåèåîèé ëùäè÷ñè îúòãëï.
+  </para>
+  <para>
+   àúä éëåì ìîöåà òåã îéãò áðåâò äåøãú ÷åã äî÷åø áöåøú
+   <acronym>XML</acronym> ùì úéòåã æä àöì <ulink
+   url="&url.php.cvs;">&url.php.cvs;</ulink>. äúéòåã ðùîø áúåê
+   îåãåì <literal>phpdoc</literal>
+  </para>
+ </sect1>
+
+ <sect1 id="about.translations">
+  <title>úøâåîéí</title>
+  <para>
+   îãøéê ä- PHP ìà ø÷ æîéï áúáðéåú ùåðåú, àìà âí áùôåú ùåðåú.
+   è÷ñè äîãøéê ðëúá ìøàùåðä áàðâìéú, åàæ öååúéí ùì àðùéí áøçáé
+   äòåìí ãåàâéí ìúøâí æàú ìùôä äèáòéú ùìäí.
+   àí úøâåí ùì ôåð÷öéä ñôöéôéú àå ôø÷ òãééï ìà ðòùä, îòøëú
+   äáðééä ùì äîãøéê ðñåâä ìâøñú äàðâìéú ùìå.
+  </para>
+  <para>
+   àðùéí äîòåøáéí áúøâåîéí îúçéìéí î÷åã äî÷åø áöåøú <acronym>XML</acronym>
+   äæîéï àöì <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> åîùí äí
+   îúøâîéí àåúå ìùôú äàí ùìäí. äí <emphasis>ìà òåùéí ùéîåù</emphasis> 
+   á- <acronym>HTML</acronym>, áè÷ñè äôùåè, àå áâøñú ä- <acronym>PDF</acronym>.
+   æåäé îòøëú äáðééä àùø ãåàâú ìäîøåú î- <acronym>XML</acronym> ìúáðéåú
+   äðéúðåú ì÷øéàä ò"é áðé-àãí.
+  </para>
+  <note>
+   <para>
+    àí àúä øåöä ìòæåø áúøâåí äúéòåã ìùôä äèáòéú ùìê, àðà öåø ÷ùø òí
+    öååú äúéòåã/úøâåí. äøùîä ìøùéîåú äãéååø ùì Phpdoc: ùìç äåãòä øé÷ä àì <ulink
+    url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>.
+    ëúåáú øùéîú äãéååø äéà <literal>&email.php.doc;</literal>. öééï áäåãòä ëé
+    àúä îòåðééï ìúøâí àú äîãøéê ìùôä åîéùäå ëáø éçæåø àìéê, ìòæåø ìê ìäúçéì
+    áúøâåí äùôä äçãùä àå ìäâéò ìöååú äúéòåã ùëáø òåáã òì äùôä ùìê.
+   </para>    
+  </note>
+  <para>
+   áøâò æä äîãøéê æîéï, çì÷éú àå ìè, áùôåú äáàåú: ôåøèåâæéú áøæéìàéú, ñéðéú (îåôùèú),
+   ñéðéú (îñåøúéú), ö'éëéú, äåìðãéú, ôéðéö, öøôúéú, âøîðéú, òáøéú, äåðâøéú,
+   àéèì÷éú, éôðéú, ÷åøéàðéö, øåîàðéú, øåñéú, ñìåá÷éú, ñìåáðéú, ñôøãéú, 
+   ùååãéú åèåø÷éú.
+  </para>
+  <para>
+   ëåìí ðéúðåú ìäåøãä ëàï: <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
+  </para>
+ </sect1>
+
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+