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

Index: phpdoc-he/language/basic-syntax.xml
diff -u phpdoc-he/language/basic-syntax.xml:1.3 phpdoc-he/language/basic-syntax.xml:1.4
--- phpdoc-he/language/basic-syntax.xml:1.3	Sat May 17 15:40:08 2003
+++ phpdoc-he/language/basic-syntax.xml	Thu Jul 17 15:38:05 2003
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="WINDOWS-1255"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
+<!-- HE-Revision: 1.00 Maintainer: hadar_p Status: complete -->
  <chapter id="language.basic-syntax">
   <title>úçáéø áñéñé</title>
 
@@ -47,44 +48,46 @@
    -->
    
   <sect1 id="language.basic-syntax.phpmode">
-   <title>îòáø îîöá HTML ìîöá PHP</title>
+   <title>éöéàä îîöá HTML</title>
   
    <para>
-    ëàùø PHP îôøùú ÷åáõ, äéà ôåìèú àú äè÷ñè ùáå, òã ìøâò
-    ùáå úîöà úâéåú îéåçãåú ùîñîðåú ìä àú ñåó äè÷ñè åúçéìú
-    ä÷åã ùì PHP. äîôøù éáöò àú ëì ô÷åãåú ä PHP ùéîöà òã úâéú
-    äñâéøä äáàä, ùúñîï ìîôøù àú ñåó ä÷åã åúçéìú äè÷ñè åáøâò æä
-    ùåá úúáöò ùìéçä ùì äè÷ñè àì äôìè. îðâðåï æä îàôùø àú ùéìåá
-    ä÷åã áîñîê HTML: ëì îä ùîçåõ ìúâéåú ä PHP ðçùá ìôìè øâéì áòåã
-    ùëì îä ùðîöà áúåëï îòåáã ë÷åã.
+    ëàùø 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 ìîöá PHP</title>
+      <title>ãøëéí ìöàú îîöá HTML</title>
       <programlisting role="php">
 <![CDATA[
-1.  <? echo ("this is the simplest, an SGML processing instruction\n"); ?>
+<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"); ?>
     <?= 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");
@@ -92,46 +95,140 @@
 
 4.  <% echo ("You may optionally use ASP-style tags"); %>
     <%= $variable; # This is a shortcut for "<% echo . . ." %>
+</div>
 ]]>
       </programlisting>
      </example>
     </para>
 
    <para>
-    äãøê äøàùåðä úôòì ø÷ àí äúîéëä áúâéåú ÷öøåú äåôòìä. ëãé
-    àôùø ìäôòéì úîéëä æå(á PHP 3 ) òì-éãé ùéîåù áôåð÷öéä
-    <function>short_tags</function>, úåê äôòìú äàôùøåú <link
-    linkend="ini.short-open-tag">short_open_tag</link> á÷åáõ
-    ääâãøåú ùì PHP, àå òì-éãé äéãåø ùì PHP òí äàåôöéä
-    --enable-short-tags áäøöú ä <command>configure</command>.
+    äãøê äøàùåðä, &lt;?php. . .?&gt;, äéà äùéèä äîåòãôú, îùåí ùäéà
+    îàôùøú àú äùéîåù ùì PHP áúåê ÷åã XML-conformant ìîùì ëîå XHTML.
    </para>
 
    <para>
-    åùåá éù ìöééï ëé äãøê äùðééä îåòãôú îàçø åàéðä âåøîú
-    ìäúðâùåú òí îñîëéí îñåâ XML ëãåâîú XHTML.
+    äãøê äùðééä ìà úîéã æîéðä. úâéåú ÷öøåú æîéðåú ø÷ ëàùø äï
+    îåôòìåú. æä éëåì ìäòùåú ãøê ôåð÷öééú <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, äùéîåù áúâéåú ÷öøåú äåà ìà îåîìõ.
    </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) { 
     ?>
@@ -143,15 +240,18 @@
     <?php 
 }
 ?>
+</div>
 ]]>
      </programlisting>
     </example>
-    ëöôåé, ÷åã æä éôòì, ëé ëàùø PHP îåöàú àú úââéåú äñâéøä, äéà
-    ôùåè îúçéìä îúçéìä ìùìåç àú äè÷ñè ëôìè òã ùúîöà àú úâéú
-    äôúéçä äáàä. äãåâîä äðúåðä äéà ôùåèä, àê ëàùø îãåáø áùìéçú ÷èòé
-    è÷ñè âãåìéí ìôìè, úâéåú äôúéçä åñâéøä éòéìåú éåúø îàùø äãôñú
-    äôìè áòæøú  äôåð÷öéä <function>echo</function> àå äôåð÷öéä
-    <function>print</function> àå ôåð÷öéä ãåîä.
+
+    ÷åã æä éòáåã ëöôåé, îùåí ù- PHP ðú÷ìú áúâéåú äñâéøä ?&gt;,
+    äéà ôùåè îåöéàä ôìè ùì îä ùðîöà òã ùäéà ðú÷ìú áúâéú ôúéçä
+    ðåñôú. äãåâîà ùäåáàä ëàï äéà ôùåèä, ëîåáï, àáì áùáéì
+    äåöàú ôìè ùì áìå÷éí âãåìéí ùì è÷ñè, éöéàä îîöá ÷åã ä- PHP
+    äåà éåúø éòéì îàùø ùìéçä ùì ëì äè÷ñè áòæøú 
+    <function>echo</function> àå <function>print</function>
+    àå ôåð÷öéåú áñâðåï.
    </para>
   </sect1>
   
@@ -159,21 +259,23 @@
    <title>äôøãú äåøàåú</title>
    
    <simpara>
-    äôøãú äåøàåú á PHP îúáöòú áöåøä æää ìæå ù÷ééîú áùôú C àå ôøì -
-    ëì äåøàä îñúééîú áñîé÷åìåï ; .</simpara>
+    äðçéåú îåôøãåú áàåúä ùéèä ù÷ééîú á- C àå á- Perl - ñéåí ëì äðçééä
+    áòæøú ñéîï ð÷åãä-ôñé÷ (;).
+   </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>
@@ -181,14 +283,15 @@
   </sect1>
 
   <sect1 id="language.basic-syntax.comments">
-   <title>äòøåú á÷åã</title>
+   <title>Comments</title>
    
    <para>
-    PHP úåîëú áñéâðåï ääòøåú ùì ùôú C, C++ åîòèôú éåðé÷ñ. ìãåâîä:
+    PHP úåîëú áñðâåï ääòøåú ùì ùôú C, C++ åîòèôú Unix. ìãåâîä:
 
     <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
@@ -196,40 +299,56 @@
     echo "This is yet another test";
     echo "One Final Test"; # This is shell-style style comment
 ?>
+</div>
 ]]>
      </programlisting>
     </informalexample>
    </para>
 
    <simpara>
-    äòøú ä "one-line" úëìåì àú ëì äè÷ñè òã ñåó äùåøä àå òã
-    úâéú ñâéøä ùì PHP.
+    ñâðåðåú äòøåú "ùåøä-àçú" áòöí îåñéôä àú ääòøä ìñåó ùì äùåøä àå
+    ìáìå÷ äðåëçé ùì ÷åã PHP, îä ùáà ÷åãí.
    </simpara>
-   <informalexample>
-    <programlisting role="php">
+   <para>
+    <informalexample>
+     <programlisting role="php">
 <![CDATA[
-<h1>This is an <?php # echo "simple";?> example.>/h1>
+<div dir="ltr">
+<h1>This is an <?php # echo "simple";?> example.</h1>
 <p>The header above will say 'This is an example'.
+</div>
 ]]>
-    </programlisting>
-   </informalexample> 
+     </programlisting>
+    </informalexample> 
+   </para>
 
    <simpara>
-    äæäø ìà ì÷ðï äòøåú áñâðåï 'C' àùø éâøîå ìáòéä ëàùø
-    úøöä ìäôåê áìå÷ âãåì ùì ÷åã ìäòøä
+    àúä öøéê ìäéæäø áòú ùéîåù äòøåú áñâðåï 'C', îúé ùàúä öøéê
+    ìñîï äòøåú òì áìå÷éí âãåìéí ùì ÷åã.
    </simpara>
 
-   <informalexample>
-    <programlisting role="php">
+   <para>
+    <informalexample>
+     <programlisting role="php">
 <![CDATA[
+<div dir="ltr">
 <?php
  /* 
     echo "This is a test"; /* This comment will cause a problem */
  */
 ?>
+</div>
 ]]>
-    </programlisting>
-   </informalexample>
+     </programlisting>
+    </informalexample>
+   </para>
+   
+   <simpara>
+    ñâðåðåú äòøåú "ùåøä-àçú" áòöí îåñéôä àú ääòøä ìñåó ùì äùåøä àå
+    ìáìå÷ äðåëçé ùì ÷åã PHP, îä ùáà ÷åãí. æä àåîø ù÷åã ä- HTML àçøé ä-
+    <literal>// ?></literal> éåãôñ: ?> áãéìåâ îîöá ä- PHP åéçæåø àì îöá
+    ä- HTML, åìëï <literal>//</literal> ìà éëåì ìäùôéò òì æä.
+  </simpara>
   </sect1>
  </chapter>