cvs: phpdoc-he /appendices debugger.xml

Index: phpdoc-he/appendices/debugger.xml
+++ phpdoc-he/appendices/debugger.xml
<?xml version="1.0" encoding="WINDOWS-1255"?>
<!-- $Revision: 1.1 $ -->
<!-- HE-Revision: 1.00 Maintainer: hadar_p Status: complete -->
 <appendix id="debugger">
  <title>ðéôåé áàâéí á- PHP</title>

  <sect1 id="debugger-about">
   <title>àåãåú úåëðú ðéôåé äáàâéí</title>
   <simpara>
    PHP 3 ëåìì úîéëä ìúåëðú ðéôåé áàâéí îáåññú-øùú.
   </simpara>
   <simpara>
    PHP 4 àéðå áòì àîöòé ðéôåé áàâéí ôðéîé.
    àúä éëåì ìäùúîù áúåëðåú ðéôåé áàâéí çéöåðéåú, áëì àåôï.
    <ulink url="&url.zend.ide;">Zend IDE</ulink> ëåìì
    úåëðú ðéôåé áàâéí, åâí éùðï îñôø úåñôåú ðéôåé áàâéí äðéúðåú
    çéðí ëîå DBG á- <ulink url="&url.dbg;">&url.dbg;</ulink>, 
    <ulink url="&url.apd;">Advanced PHP Debugger</ulink> (APD) àå
    <ulink url="&url.xdebug;">Xdebug</ulink> àùø àôéìå ëåìì
    îîù÷ ðéôåé áàâéí äúåàí ìàôùøåéåú ðéôåé äáàâéí ùì PHP 3 äîôåøèåú
    áçì÷ æä.
   </simpara>
  </sect1>

  <sect1 id="debugger-using">
   <title>ùéîåù áúåëðú ðéôåé äáàâéí</title>

   <para>
    úåëðú ðéôåé äáàâéí äôðéîéú á- PHP 3 äéà îàåã ùéîåùéú ìàéúåø
    áàâéí çî÷î÷éí. úåëðú ðéôåé äáàâéí òåáãú ò"é çéáåø ìéöéàú
    ä- <acronym>TCP</acronym> áëì ôòí ù- PHP 3 îåôòì.
    ëì äåãòåú äùâéàä îá÷ùä æàú ééùìçå ìú÷ùøåú TCP äæàú.
    îéãò æä îéåòã ì"ùøú ðéôåé ùâéàåú" àùø éëåì ìôòåì áúåê
    <acronym>IDE</acronym> àå òåøê ñ÷øéôèéí (ëîå Emacs).
   </para>
   <para>
    ëéöã ìäú÷éï àú úåëðú ðéôåé äáàâéí:
    <orderedlist>
     <listitem>
      <simpara> 
	  äâãø éöéàú TCT ìúåëðú ðéôåé äáàâéí áúåê <link
       linkend="configuration.file">÷åáõ ääâãøåú</link> (<link
       linkend="ini.debugger.port">debugger.port</link>) åäôòì àåúå
       (<link linkend="ini.debugger.enabled">debugger.enabled</link>).
      </simpara>
     </listitem>
     <listitem>
      <simpara> 
	  äâãø îàæéï TCP òì éöéàä æàú áî÷åí ëìùäå (ìãåâîà
       <command>socket -l -s 1400</command> áñáéáú UNIX).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
	  á÷åã äñ÷øéôè ùìê, äøõ 
       "debugger_on(<replaceable>host</replaceable>)", áî÷åí
       <replaceable>host</replaceable> ëúåá àú ëúåáú ä- IP àå àú ùí
	  ùøú äîàøç ùîøéõ àú îàæéï ä- <acronym>TCP</acronym>.
      </simpara>
     </listitem>
    </orderedlist>
    òëùéå, ëì ääàæäøåú, äúøàåú åëãåîä éåôéòå áúåê äú÷ï äîàæéï, 
    <emphasis>àôéìå àí áéèìú àåúí áòæøú
    <function>error_reporting</function></emphasis>.  
   </para>
  </sect1>

  <sect1 id="debugger-protocol">
   <title>ôøåèå÷åì úåëðú ðéôåé äáàâéí</title>
   <para>
    ôøåèå÷åì úåëðú ðéôåé äáàâéí ùì PHP 3 äéà îáåññú-ùåøåú. ìëì ùåøä éù 
    <emphasis>ñåâ îùúðä</emphasis>, åîñôø ùåøåú îúçáøåú ìúåê 
    <emphasis>äåãòä</emphasis>. ëì äåãòä îúçéìä òí ñåâ ùåøä
    <literal>start</literal> åîñúééîú òí ñåâ ùåøä <literal>end</literal>.
    PHP 3 éëåì ìùìåç ùåøåú ìäåãòåú ùåðåú áå-æîðéú.
   </para>
   <para>
    ìùåøä éù àú äúáðéú äáàä:
    <informalexample>
     <literallayout>
<![CDATA[
<div dir="ltr">
date time host(pid) type: message-data
</div>
]]>
     </literallayout>
    </informalexample>
   </para>
   <para>
    <variablelist>
     <varlistentry>
      <term><replaceable>date</replaceable></term>
      <listitem>
       <simpara>
        úàøéê áúáðéú ISO 8601
        (<replaceable>yyyy</replaceable>-<replaceable>mm</replaceable>-<replaceable>dd</replaceable>)
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><replaceable>time</replaceable></term>
      <listitem>
       <simpara>ùòä äëåììú îé÷øå-ùðéåú:
        <replaceable>hh</replaceable>:<replaceable>mm</replaceable>:<replaceable>uuuuuu</replaceable>
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><replaceable>host</replaceable></term>
      <listitem>
       <simpara>
	   ëúåáú DNS àå ëúåáú IP ùì ùøú äîàøç äéëï ùâéàú äñ÷øéôè ðåöøä.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><replaceable>pid</replaceable></term>
      <listitem>
       <simpara>
        PID (process id) ùì ä- <replaceable>host</replaceable>  äùééê
	   ìúäìéê ñ÷øéôè ä- PHP 3 àùø ééöø àú ùâéàä æàú.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><replaceable>type</replaceable></term>
      <listitem>
       <para>
	   äñåâ ùì äùåøä. àåîøú ìúåëðä äî÷áìú áàéæä ùéèä 
	   äîéãò äáà öøéê ìèåôì.
        <table>
         <title>ñåâé ùåøåú úåëðú ðéôåé äùâéàåú</title>
         <tgroup cols="2">
          <thead>
           <row>
            <entry>ùí</entry>
            <entry>îùîòåú</entry>
           </row>
          </thead>
          <tbody>
           <row>
            <entry><literal>start</literal></entry> 
            <entry>
		   àåîøú ìúåëðä äî÷áìú ùäåãòú ðéôåé äùâéàåú îúçéìä ëàï.
		   äúåëï ùì ä- <replaceable>data</replaceable> éäéä ñåâ äåãòú
		   äùâéàä, äøùåí ìäìï.
            </entry>
           </row>
           <row>
            <entry><literal>message</literal></entry>
            <entry>äåãòú äùâéàä ùì PHP 3.</entry>
           </row>
           <row>
            <entry><literal>location</literal></entry>
            <entry>
		   ùí ä÷åáú åîñôø äùåøä äéëï ùäùâéàä äúøçùä. ùåøú ä- <literal>location</literal>
		   äøàùåðä úîéã úëéì îé÷åí îìà ùì îòøëú ä÷áöéí.
             <replaceable>data</replaceable> éëéì
             <literal><replaceable>file</replaceable>:<replaceable>line</replaceable></literal>.
		   úîéã úäéä ùåøú <literal>location</literal>
             àçøé <literal>message</literal> åàçøé ëì
             <literal>function</literal>.
            </entry>
           </row>
           <row>
            <entry>
             <literal>frames</literal></entry> <entry> îñôø Frames
		   áæéëøåï äîçñðéú. àí éùðí àøáòä Frames, öôä ìîéãò ìâáé
		   àøáòú äùìáéí ùì äôåð÷öéåú ùùåîùå.
		   àí àó ùåøú "frames" ðúåðä, äòåî÷ äöôåé àîåø ìäéåú 0.
		   (äùâéàä äúøçùä áùìá äòìéåï).
            </entry>
           </row>
           <row>
            <entry>
             <literal>function</literal></entry> 
            <entry>
		   äùí ùì äôåð÷öéä äéëï ùäùâéàä äúøçùä. éçæåø ìëì
		   ùìá áîçñðéú äæéëøåï ùì äôåð÷öéä.
            </entry>
           </row>
           <row>
            <entry><literal>end</literal></entry> 
            <entry>
		   àåîøú ìúåëðä äî÷áìú ùäåãòä ðéôåé äùâéàåú äñúééîä ëàï.
            </entry>
           </row>
          </tbody>
         </tgroup>
        </table>
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><replaceable>data</replaceable></term>
      <listitem>
       <simpara>ùåøú îéãò.</simpara>
      </listitem>
     </varlistentry>
    </variablelist>

    <table>
     <title>ñåâé ùâéàåú ùì úåëðú ðéôåé áàâéí</title>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>úåëðú ðéôåé äùâéàåú</entry>
        <entry>äùâéàåú äôðéîéåú ùì PHP 3</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><errortype>warning</errortype></entry>
        <entry><errortype>E_WARNING</errortype></entry>
       </row>
       <row>
        <entry><errortype>error</errortype></entry>
        <entry><errortype>E_ERROR</errortype></entry>
       </row>
       <row>
        <entry><errortype>parse</errortype></entry>
        <entry><errortype>E_PARSE</errortype></entry>
       </row>
       <row>
        <entry><errortype>notice</errortype></entry>
        <entry><errortype>E_NOTICE</errortype></entry>
       </row>
       <row>
        <entry><errortype>core-error</errortype></entry>
        <entry><errortype>E_CORE_ERROR</errortype></entry>
       </row>
       <row>
        <entry><errortype>core-warning</errortype></entry>
        <entry><errortype>E_CORE_WARNING</errortype></entry>
       </row>
       <row>
        <entry><errortype>unknown</errortype></entry>
        <entry>(any other)</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
    
    <example>
     <title>ãåâîà ìäåãòú ùâéòä ùì úåëðú ðéôåé äáàâéí</title>
     <literallayout>
<![CDATA[
<div dir="ltr">
1998-04-05 23:27:400966 lucifer.guardian.no(20481) start: notice
1998-04-05 23:27:400966 lucifer.guardian.no(20481) message: Uninitialized variable
1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: (null):7
1998-04-05 23:27:400966 lucifer.guardian.no(20481) frames: 1
1998-04-05 23:27:400966 lucifer.guardian.no(20481) function: display
1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: /home/ssb/public_html/test.php3:10
1998-04-05 23:27:400966 lucifer.guardian.no(20481) end: notice
</div>
]]>
     </literallayout>
    </example>
   </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
-->