cvs: phpdoc-he /language basic-syntax.xml

Index: phpdoc-he/language/basic-syntax.xml
diff -u phpdoc-he/language/basic-syntax.xml:1.4 phpdoc-he/language/basic-syntax.xml:1.5
--- phpdoc-he/language/basic-syntax.xml:1.4	Thu Jul 17 15:38:05 2003
+++ phpdoc-he/language/basic-syntax.xml	Fri Jul 18 08:03:55 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="WINDOWS-1255"?>
-<!-- $Revision: 1.4 $ -->
-<!-- HE-Revision: 1.00 Maintainer: hadar_p Status: complete -->
+<!-- $Revision: 1.5 $ -->
  <chapter id="language.basic-syntax">
   <title>úçáéø áñéñé</title>
 
@@ -48,46 +47,44 @@
    -->
    
   <sect1 id="language.basic-syntax.phpmode">
-   <title>éöéàä îîöá HTML</title>
+   <title>îòáø îîöá HTML ìîöá PHP</title>
   
    <para>
-    ëàùø PHP îôøùú ÷åáõ, äéà ôùåè òåáøú òì äè÷ñè ùì ä÷åáõ
-    òã ùäéà ðú÷ìú áàçã îäúâéåú äîéåçãåú àùø îñîðåú ìä
-    ìäúçéì ìôøù àú äè÷ñè ë÷åã PHP. àæ äîôøù îáöò àú ëì ô÷åãåú ä-
-    PHP ùäåà éëåì ìîöåà, òã ùäåà ðú÷ì áúâéú ñâéøä, àùø îñîðú
-    ìîôøù ìäúçéì ìòáåø òì äè÷ñè ôòí ðåñôú. æäå îðâðåï àùø îàôùø
-    ìê ìùìá ÷åã ùì PHP áúåê HTML: ëì îä ùîçåõ ìúâéåú ä- PHP
-    ðçùá ìôìè øâéì áòåã ùëì îä ùðîöà áúåëï îòåáã ë÷åã.
+    ëàùø PHP îôøùú ÷åáõ, äéà ôåìèú àú äè÷ñè ùáå, òã ìøâò
+    ùáå úîöà úâéåú îéåçãåú ùîñîðåú ìä àú ñåó äè÷ñè åúçéìú
+    ä÷åã ùì PHP. äîôøù éáöò àú ëì ô÷åãåú ä PHP ùéîöà òã úâéú
+    äñâéøä äáàä, ùúñîï ìîôøù àú ñåó ä÷åã åúçéìú äè÷ñè åáøâò æä
+    ùåá úúáöò ùìéçä ùì äè÷ñè àì äôìè. îðâðåï æä îàôùø àú ùéìåá
+    ä÷åã áîñîê HTML: ëì îä ùîçåõ ìúâéåú ä PHP ðçùá ìôìè øâéì áòåã
+    ùëì îä ùðîöà áúåëï îòåáã ë÷åã.
    </para>
 
    <para>
-
     éùðï àøáò ãøëéí ìñîï àú úâéåú äôúéçä åñâéøä ùì ÷åã PHP. îäï
     ø÷ ùúééí (&lt;?php. . .?&gt; å &lt;script
     language="php"&gt;. . .&lt;/script&gt;).
-    ôòéìåú úîéã. áàçøåú ðéúï ìäôòéì åìëáåú îúåê ÷åáõ
-    ääâãøåú <filename>php.ini</filename>. ìîøåú ùúâéåú ä- PHP
-    ä÷öøåú åäúâéåú áñâðåï ASP äï éåúø ðåçåú
-    ìùéîåù, äï ìà îúàéîåú ìùéîåù áçì÷ îäî÷øéí. ëîå-ëï, àí
-    áøöåðê ìùìá ÷åã PHP á- XML àå XHTML, àúä çééá ìäùúîù áúâéåú
+    ôòéìåú úîéã. áàçøåú àôùø ìäùúîù ìàçø ùéðåé äâãøåú á÷åáõ
+    ääâãøåú <filename>php.ini</filename>.
+    ìîøåú ùúâéåú ä PHP ä÷öøåú åäúâéåú áñâðåï ASP éåúø ðåçåú
+    ìùéîåù, äï ìà îúàéîåú ìùéîåù áçì÷ îäî÷øéí, ìãåâîä - àí
+    áøöåðê ìùìá ÷åã PHP á XML àå XHTML, àúä çééá ìäùúîù áúâéåú
     äàøåëåú &lt;?php. . .?&gt; ëãé ìà ìäúðâù òí úâéåú XML.
    </para>
 
    <para>
-    äúâéåú äðúîëåú á- PHP äï:
+    äúâéåú äðúîëåú á PHP äï:
    </para>
 
     <para>
      <example>
-      <title>ãøëéí ìöàú îîöá HTML</title>
+      <title>ãøëéí ìòáåø îîöá HTML ìîöá PHP</title>
       <programlisting role="php">
 <![CDATA[
-<div dir="ltr">
-1.  <?php echo("if you want to serve XHTML or XML documents, do like this\n"); ?>
-
-2.  <? echo ("this is the simplest, an SGML processing instruction\n"); ?>
+1.  <? echo ("this is the simplest, an SGML processing instruction\n"); ?>
     <?= expression ?> This is a shortcut for "<? echo expression ?>"
     
+2.  <?php echo("if you want to serve XHTML or XML documents, do like this\n"); ?>
+
 3.  <script language="php">
         echo ("some editors (like FrontPage) don't
               like processing instructions");
@@ -95,140 +92,46 @@
 
 4.  <% echo ("You may optionally use ASP-style tags"); %>
     <%= $variable; # This is a shortcut for "<% echo . . ." %>
-</div>
 ]]>
       </programlisting>
      </example>
     </para>
 
    <para>
-    äãøê äøàùåðä, &lt;?php. . .?&gt;, äéà äùéèä äîåòãôú, îùåí ùäéà
-    îàôùøú àú äùéîåù ùì PHP áúåê ÷åã XML-conformant ìîùì ëîå XHTML.
+    äãøê äøàùåðä úôòì ø÷ àí äúîéëä áúâéåú ÷öøåú äåôòìä. ëãé
+    àôùø ìäôòéì úîéëä æå(á PHP 3 ) òì-éãé ùéîåù áôåð÷öéä
+    <function>short_tags</function>, úåê äôòìú äàôùøåú <link
+    linkend="ini.short-open-tag">short_open_tag</link> á÷åáõ
+    ääâãøåú ùì PHP, àå òì-éãé äéãåø ùì PHP òí äàåôöéä
+    --enable-short-tags áäøöú ä <command>configure</command>.
    </para>
 
    <para>
-    äãøê äùðééä ìà úîéã æîéðä. úâéåú ÷öøåú æîéðåú ø÷ ëàùø äï
-    îåôòìåú. æä éëåì ìäòùåú ãøê ôåð÷öééú <function>short_tags</function>
-    (PHP 3 áìáã), ò"é äôòìú äâãøåú <link
-    linkend="ini.short-open-tag">short_open_tag</link> á÷åáõ
-    ääâãøåú ùì PHP, àå ò"é ÷îôåì PHP òí àôùøåú --enable-short-tag
-    áòæøú <command>configure</command>. àôéìå àí äâãøä æàú îåôòìú
-    ëáøéøú îçãì áúåê php.ini-dist, äùéîåù áúâéåú ÷öøåú äåà ìà îåîìõ.
+    åùåá éù ìöééï ëé äãøê äùðééä îåòãôú îàçø åàéðä âåøîú
+    ìäúðâùåú òí îñîëéí îñåâ XML ëãåâîú XHTML.
    </para>
 
    <para>
-    äãøê äøáéòéú úôòì ø÷ àí ñâðåï úâéåú ä- ASP îàåôùø òì-éãé
+    äãøê äøáéòéú úôòì ø÷ àí ñâðåï úâéåú ä ASP îàåôùø òì-éãé
     ääâãøä <link linkend="ini.asp-tags">asp_tags</link>
     á÷åáõ ääâãøåú.
 
     <note>
-     <para>úîéëä áúâéåú áñâðåï ASP àôùøéú ø÷ îâøñä 3.0.4 åîòìä.</para>
+     <para>úîéëä áúâéåú áñéâðåï ASP àôùøéú ø÷ îâøñä 3.0.4 åîòìä.</para>
     </note>
    </para>
 
    <para>
-    <note>
-     <para>
-	 ùéîåù áúâéåú ä÷öøåú öøéê ìäéîðò áôéúåç ééùåîéí àå ñôøéåú ùàîåøåú
-	 ìäéåú îåôöåú, àå ìäöáä áùøúé PHP àùø ìà úçú äùìéèä ùìê, îùåí ùééúëï
-	 åúâéåú ÷öøåú ìà ðúîëåú ò"é ùøú äîèøä. ì÷åã äîéåòã ìäôöä åìúàéîåú
-	 îìàä, ëãàé ùìà úùúîù áúâéåú ÷öøåú.
-<function>fopen</function>specify<xref linkend="wrappers"/>seedgenerator<function>srand</function> or 
-<function>mt_srand</function>ConstantsClassesbelowcase-sensitiveùîåú äùãåú äîåçæøéí ò"é ôåð÷öéä
-æàú äí <emphasis>øâéùéí ìâåãì äàåúéåú</emphasis></simpara></note>'>æîéðéí ø÷ ëàùø úåñôú æàú àå îå÷îôìú ìúåê PHP àå 
-èòåðä áàåôï ãéðîé áæîï äøöä.
-uidcheck<!ENTITY note.sm.uidcheck '<note><simpara>ëàùø îöá <link
-linkend="features.safe-mode">safe-mode</link> ôòéì, PHP úáãå÷ äàí
-ä÷áöéí\ñôøéåú ùàúä îúëååï ìáöò òìéäí ôòåìåú, äí áòìé äøùàú îùúîù (UID) äæää
-ìæå ùì äúåëðéú äîåøöú.</simpara></note>'>
-
-<!ENTITY note.sm.uidcheck.dir '<note><simpara>ëàùø îöá <link
-linkend="features.safe-mode">safe-mode</link> ôòéì, PHP úáãå÷ äàí
-äñôøééä ùáä àúä øåöä ìáöò ôòåìä, äéà áòìú äøùàú îùúîù (UID) äæää
-ìæå ùì äúåëðéú äîåøöú.</simpara></note>'>
-construct<!ENTITY sm.uidcheck '
-áåã÷ äàí ä÷áöéí\ñôøéåú ùàúä îúëååï ìáöò òìéäí ôòåìåú, äí áòìé äøùàú îùúîù (UID) äæää
-ìæå ùì äúåëðéú äîåøöú.'>
-
-<!ENTITY sm.uidcheck.dir '
-áåã÷ äàí äñôøééä ùáä àúä øåöä ìáöò ôòåìä, äéà áòìú äøùàú îùúîù (UID) äæää
-ìæå ùì äúåëðéú äîåøöú.'>
-
-<!ENTITY sm.disabled 'ôåð÷öéä æå àéðä ôòéìä áîöá <link
-linkend="features.safe-mode">safe-mode</link>'>
-<!-- HE-Revision: 1.00 Maintainer: shlomi Status: complete -->
-    ëàùø PHP îôøùú ÷åáõ, äéà ôåìèú àú äè÷ñè ùáå, òã ìøâò
-    ùáå úîöà úâéåú îéåçãåú ùîñîðåú ìä àú ñåó äè÷ñè åúçéìú
-    ä÷åã ùì PHP. äîôøù éáöò àú ëì ô÷åãåú ä PHP ùéîöà òã úâéú
-    äñâéøä äáàä, ùúñîï ìîôøù àú ñåó ä÷åã åúçéìú äè÷ñè åáøâò æä
-    ùåá úúáöò ùìéçä ùì äè÷ñè àì äôìè. îðâðåï æä îàôùø àú ùéìåá
-    ä÷åã áîñîê HTML: ëì îä ùîçåõ ìúâéåú ä PHP ðçùá ìôìè øâéì áòåã
-    ùëì îä ùðîöà áúåëï îòåáã ë÷åã.
-   </para>
-
-   <para>
-    éùðï àøáò ãøëéí ìñîï àú úâéåú äôúéçä åñâéøä ùì ÷åã PHP. îäï
-    ø÷ ùúééí (&lt;?php. . .?&gt; å &lt;script
-    language="php"&gt;. . .&lt;/script&gt;).
-    ôòéìåú úîéã. áàçøåú àôùø ìäùúîù ìàçø ùéðåé äâãøåú á÷åáõ
-    ääâãøåú <filename>php.ini</filename>.
-    ìîøåú ùúâéåú ä PHP ä÷öøåú åäúâéåú áñâðåï ASP éåúø ðåçåú
-    ìùéîåù, äï ìà îúàéîåú ìùéîåù áçì÷ îäî÷øéí, ìãåâîä - àí
-    áøöåðê ìùìá ÷åã PHP á XML àå XHTML, àúä çééá ìäùúîù áúâéåú
-    äàøåëåú &lt;?php. . .?&gt; ëãé ìà ìäúðâù òí úâéåú XML.
-    ëàùø PHP îôøùú ÷åáõ, äéà ôåìèú àú äè÷ñè ùáå, òã ìøâò
-    ùáå úîöà úâéåú îéåçãåú ùîñîðåú ìä àú ñåó äè÷ñè åúçéìú
-    ä÷åã ùì PHP. äîôøù éáöò àú ëì ô÷åãåú ä PHP ùéîöà òã úâéú
-    äñâéøä äáàä, ùúñîï ìîôøù àú ñåó ä÷åã åúçéìú äè÷ñè åáøâò æä
-    ùåá úúáöò ùìéçä ùì äè÷ñè àì äôìè. îðâðåï æä îàôùø àú ùéìåá
-    ä÷åã áîñîê HTML: ëì îä ùîçåõ ìúâéåú ä PHP ðçùá ìôìè øâéì áòåã
-    ùëì îä ùðîöà áúåëï îòåáã ë÷åã.
- ëì îä ùîçåõ ìúâéåú ä PHP ðçùá ìôìè øâéì áòåã
-    ùëì îä ùðîöà áúåëï îòåáã ë÷åã.    éùðï àøáò ãøëéí ìñîï àú úâéåú äôúéçä åñâéøä ùì ÷åã PHP. îäï
-    ø÷ ùúééí (&lt;?php. . .?&gt; å &lt;script
-    language="php"&gt;. . .&lt;/script&gt;).
-    ôòéìåú úîéã. áàçøåú àôùø ìäùúîù ìàçø ùéðåé äâãøåú á÷åáõ
-    ääâãøåú <filename>php.ini</filename>.
-    ìîøåú ùúâéåú ä PHP ä÷öøåú åäúâéåú áñâðåï ASP éåúø ðåçåú
-    ìùéîåù, äï ìà îúàéîåú ìùéîåù áçì÷ îäî÷øéí, ìãåâîä - àí
-    áøöåðê ìùìá ÷åã PHP á XML àå XHTML, àúä çééá ìäùúîù áúâéåú
-    äàøåëåú &lt;?php. . .?&gt; ëãé ìà ìäúðâù òí úâéåú XML.
-    äúâéåú äðúîëåú á PHP äï:1.  <?php echo("if you want to serve XHTML or XML documents, do like this\n"); ?>
-
-2.  <? echo ("this is the simplest, an SGML processing instruction\n"); ?>
-    <?= expression ?> This is a shortcut for "<? echo expression ?>"
-    
-3.  <script language="php">
-        echo ("some editors (like FrontPage) don't
-              like processing instructions");
-    </script>
-
-4.  <% echo ("You may optionally use ASP-style tags"); %>
-    <%= $variable; # This is a shortcut for "<% echo . . ." %>
-]]>
-XML-conformantúîéëä áúâéåú áñéâðåï ASP àôùøéú ø÷ îâøñä 3.0.4 åîòìä.<link linkend="ini.short-open-tag">short_open_tag</link>--enable-short-tag<command>configure</command>.php.ini-dist,discouraged    äãøê äøáéòéú úôòì ø÷ àí ñâðåï úâéåú ä ASP îàåôùø òì-éãé
-    ääâãøä <link linkend="ini.asp-tags">asp_tags</link>
-    á÷åáõ ääâãøåú.
-avoidedmeantdeployment    úâéåú äñâéøä ùì áìå÷ éëììå àú úå äùåøä äçãùä äòå÷á, àí
+    úâéåú äñâéøä ùì áìå÷ éëììå àú úå äùåøä äçãùä äòå÷á, àí
     ÷ééí ëæä. ëîå ëï, úâéåú ñâéøä îñîðåú àú ñåôä ùì áéèåé àå
     ô÷åãä á÷åã ä PHP åàéï äëøç ìäåñéó ; áùåøä äàçøåðä ùì ä÷åã.
-     </para>
-    </note>
-   </para>
-
-   <para>
-    úâéåú äñâéøä ùì áìå÷ ä÷åã éëììå ñéîï ñéîï ñéåí ùåøä àí àçã
-    ÷ééí. ëîå-ëï, úâéú äñâéøä îçìéôä àåèåîèéú àú ñéîï ð÷åãä-ôñé÷(;)
-    åìëï àúä ìà öøéê ìäùúîù áñéîï ð÷åãä-ôñé÷ áùåøä àçøåðä ùì áìå÷
-    ÷åã ä- PHP.
    </para>
     
-   <para>
-    PHP îàôùøöú ìê ùéîåù áîáðä ëîå æä:
-    <example><title>éöéàä îú÷ãîú</title>
+    <para>
+    PHP îúéøä ùéîåù áîáðä ëîå æä:
+    <example><title>îòáø îöáéí îú÷ãí</title>
      <programlisting role="php">
 <![CDATA[
-<div dir="ltr">
 <?php
 if ($expression) { 
     ?>
@@ -240,18 +143,15 @@
     <?php 
 }
 ?>
-</div>
 ]]>
      </programlisting>
     </example>
-
-    ÷åã æä éòáåã ëöôåé, îùåí ù- PHP ðú÷ìú áúâéåú äñâéøä ?&gt;,
-    äéà ôùåè îåöéàä ôìè ùì îä ùðîöà òã ùäéà ðú÷ìú áúâéú ôúéçä
-    ðåñôú. äãåâîà ùäåáàä ëàï äéà ôùåèä, ëîåáï, àáì áùáéì
-    äåöàú ôìè ùì áìå÷éí âãåìéí ùì è÷ñè, éöéàä îîöá ÷åã ä- PHP
-    äåà éåúø éòéì îàùø ùìéçä ùì ëì äè÷ñè áòæøú 
-    <function>echo</function> àå <function>print</function>
-    àå ôåð÷öéåú áñâðåï.
+    ëöôåé, ÷åã æä éôòì, ëé ëàùø PHP îåöàú àú úââéåú äñâéøä, äéà
+    ôùåè îúçéìä îúçéìä ìùìåç àú äè÷ñè ëôìè òã ùúîöà àú úâéú
+    äôúéçä äáàä. äãåâîä äðúåðä äéà ôùåèä, àê ëàùø îãåáø áùìéçú ÷èòé
+    è÷ñè âãåìéí ìôìè, úâéåú äôúéçä åñâéøä éòéìåú éåúø îàùø äãôñú
+    äôìè áòæøú  äôåð÷öéä <function>echo</function> àå äôåð÷öéä
+    <function>print</function> àå ôåð÷öéä ãåîä.
    </para>
   </sect1>
   
@@ -259,23 +159,21 @@
    <title>äôøãú äåøàåú</title>
    
    <simpara>
-    äðçéåú îåôøãåú áàåúä ùéèä ù÷ééîú á- C àå á- Perl - ñéåí ëì äðçééä
-    áòæøú ñéîï ð÷åãä-ôñé÷ (;).
-   </simpara>
+    äôøãú äåøàåú á PHP îúáöòú áöåøä æää ìæå ù÷ééîú áùôú C àå ôøì -
+    ëì äåøàä îñúééîú áñîé÷åìåï ; .</simpara>
 
    <para>
-    úâéú äñâéøä îñîðú âí àú ñåó ääåøàä åîùåí ëê ùúé äãåâîàåú
-    äáàéí äï äæäåú.
+    úâéú äñâéøä îñîðú âí àú ñåó ääåøàä åëê áî÷ä äáà, ùúé
+    ääåøàåú æäåú åú÷éðåú:
+
     <informalexample>
      <programlisting role="php">
 <![CDATA[
-<div dir="ltr">
 <?php
     echo "This is a test";
 ?>
 
 <?php echo "This is a test" ?>
-</div>
 ]]>
      </programlisting>
     </informalexample>
@@ -283,15 +181,14 @@
   </sect1>
 
   <sect1 id="language.basic-syntax.comments">
-   <title>Comments</title>
+   <title>äòøåú á÷åã</title>
    
    <para>
-    PHP úåîëú áñðâåï ääòøåú ùì ùôú C, C++ åîòèôú Unix. ìãåâîä:
+    PHP úåîëú áñéâðåï ääòøåú ùì ùôú C, C++ åîòèôú éåðé÷ñ. ìãåâîä:
 
     <informalexample>
      <programlisting role="php">
 <![CDATA[
-<div dir="ltr">
 <?php
     echo "This is a test"; // This is a one-line c++ style comment
     /* This is a multi line comment
@@ -299,56 +196,40 @@
     echo "This is yet another test";
     echo "One Final Test"; # This is shell-style style comment
 ?>
-</div>
 ]]>
      </programlisting>
     </informalexample>
    </para>
 
    <simpara>
-    ñâðåðåú äòøåú "ùåøä-àçú" áòöí îåñéôä àú ääòøä ìñåó ùì äùåøä àå
-    ìáìå÷ äðåëçé ùì ÷åã PHP, îä ùáà ÷åãí.
+    äòøú ä "one-line" úëìåì àú ëì äè÷ñè òã ñåó äùåøä àå òã
+    úâéú ñâéøä ùì PHP.
    </simpara>
-   <para>
-    <informalexample>
-     <programlisting role="php">
+   <informalexample>
+    <programlisting role="php">
 <![CDATA[
-<div dir="ltr">
-<h1>This is an <?php # echo "simple";?> example.</h1>
+<h1>This is an <?php # echo "simple";?> example.>/h1>
 <p>The header above will say 'This is an example'.
-</div>
 ]]>
-     </programlisting>
-    </informalexample> 
-   </para>
+    </programlisting>
+   </informalexample> 
 
    <simpara>
-    àúä öøéê ìäéæäø áòú ùéîåù äòøåú áñâðåï 'C', îúé ùàúä öøéê
-    ìñîï äòøåú òì áìå÷éí âãåìéí ùì ÷åã.
+    äæäø ìà ì÷ðï äòøåú áñâðåï 'C' àùø éâøîå ìáòéä ëàùø
+    úøöä ìäôåê áìå÷ âãåì ùì ÷åã ìäòøä
    </simpara>
 
-   <para>
-    <informalexample>
-     <programlisting role="php">
+   <informalexample>
+    <programlisting role="php">
 <![CDATA[
-<div dir="ltr">
 <?php
  /* 
     echo "This is a test"; /* This comment will cause a problem */
  */
 ?>
-</div>
 ]]>
-     </programlisting>
-    </informalexample>
-   </para>
-   
-   <simpara>
-    ñâðåðåú äòøåú "ùåøä-àçú" áòöí îåñéôä àú ääòøä ìñåó ùì äùåøä àå
-    ìáìå÷ äðåëçé ùì ÷åã PHP, îä ùáà ÷åãí. æä àåîø ù÷åã ä- HTML àçøé ä-
-    <literal>// ?></literal> éåãôñ: ?> áãéìåâ îîöá ä- PHP åéçæåø àì îöá
-    ä- HTML, åìëï <literal>//</literal> ìà éëåì ìäùôéò òì æä.
-  </simpara>
+    </programlisting>
+   </informalexample>
   </sect1>
  </chapter>