Changeset 5189

Show
Ignore:
Timestamp:
01/21/08 22:36:25 (5 years ago)
Author:
m-takagi
Message:

docs/m-takagi/CodeGen_PECL: updated translation.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • docs/m-takagi/CodeGen_PECL/trunk/manual.xml

    r5163 r5189  
    18571857 
    18581858  <section> 
    1859    <title>Tests</title> 
    1860    <para> 
    1861     Global test cases can be created using the <literal>&lt;test&gt;</literal> tag. 
    1862     Test cases for functions are automaticly created.  
    1863    </para> 
    1864    <para> 
    1865     Currently you have to make sure your extension is loaded by php.ini 
    1866     and have to perform the following steps to run the test suite 
    1867     (changing pathes to point to the right files on your system): 
     1859   <title>�ƥ���/title> 
     1860   <para> 
     1861    ï¿½ï¿½ï¿½í¡¼ï¿½Ð¥ï¿½ï¿½Æ¥ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½<literal>&lt;test&gt;</literal> 
     1862    ������Ѥ��ޤ����ƴؿ�ƥ��ȥ������ϼ�ưŪ�˺��������� 
     1863   </para> 
     1864   <para> 
     1865    ����ϡ��������������ƥ󥷥���� php.ini ï¿½Ç¥í¡¼ï¿½É¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ë¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Â 
     1866    �ޤ����ƥ��ȥ������Ȥ�Ԥ��뤿���ϼ��μ��˽��������ʤ�����  (���Ȥ��Υ����ƥ����碌�ơ��ѥ��������������Ƥ������)�� 
    18681867   </para> 
    18691868   <programlisting> 
    … …  
    18731872   </programlisting> 
    18741873   <para> 
    1875     Starting with PHP 5.1 it should be possible to test PECL extensions 
    1876     by just typing <literal>make test</literal> in the extension source 
    1877     dir, the changes needed for this are being reviewed right now and 
    1878     should hopefully be ready in time to be included in the PHP 5.1.0 
    1879     release. 
     1874    PHP 5.1 �ʹߤǤϡ�PECL �������ƥ󥷥��Υƥ��Ȥϥ������ǥ��쥯�ȥ�ñ��    <literal>make test</literal> �Ȥ������Ǽ¹ԤǤ������ˤʤ����� 
     1875    ���ߤ��ε�ǽ�Τ���������ӥ塼��ǡ� 
     1876    ���ޤ�������PHP 5.1.0 �Υ������˴ޤޤ�ͽ��Ǥ� 
     1877    (��: PHP 5.1.0 ���Ф��˽ñ¤¤¤ï¿½Ê¸ï¿½ï¿½)�� 
    18801878   </para> 
    18811879 
    18821880   <section> 
    1883     <title>Global test cases</title> 
    1884     <para> 
    1885      Global test case scripts can be created using the <literal>&lt;test&gt;</literal> tag. 
    1886      The <literal>&lt;test&gt;</literal> has a single attribute <literal>name</literal>.  
    1887      As the test name is used as the test file basename <literal>name</literal> 
    1888      has to be unique and only characters, digits and <literal>'-'</literal> and 
    1889      <literal>'_'</literal> are allowed in test names. A more readable test 
    1890      title may be set using the <literal>&lt;title&gt;</literal> tag within  
    1891      <literal>&lt;test&gt;</literal>. 
    1892     </para> 
    1893     <para> 
    1894      The actual PHP code to run is specified using a <literal>&lt;code&gt;</literal> 
    1895      section. The expected output is specified using a <literal>&lt;result&gt;</literal> 
    1896      tag, it defaults to <literal>OK</literal>. The PHP test suite supports three 
    1897      different ways to compare test output with the expected result: plain string 
    1898      comparison, comparison using printf style placeholders like %d for numbers 
    1899      and regular expresions (for details see the <filename>README.TESTING*</filename> 
    1900      files in the PHP source). By default the <literal>plain</literal> mode is used, 
    1901      the other two modes can be selected by setting the <literal>mode</literal> 
    1902      attribute of <literal>&lt;result&gt;</literal> to <literal>format</literal> or 
    1903      <literal>regex</literal>. 
    1904     </para> 
    1905     <para> 
    1906      The <literal>--SKIPIF--</literal> section of the generated tests checks 
    1907      for the generated extension being loaded, the tests will automaticly be 
    1908      skiped if it is not available. Additional skip conditions can be added 
    1909      using the <literal>&lt;skipif&gt;</literal> tag. The content of the tag may either 
    1910      be a PHP expression that evaluates to <literal>true</literal> if the test 
    1911      should be skipped or a complete code snippet that prints <literal>skip</literal> 
    1912      if the test is supposed to be skipped. A string describing the reason for 
    1913      the test being skipped may be added after the <literal>skip</literal> in  
    1914      this case. 
    1915     </para> 
    1916     <para> 
    1917      Additional php.ini settings to be used for testing may be specified in 
    1918      a <literal>&lt;ini&gt;</literal> section. 
     1881    <title>ï¿½ï¿½ï¿½í¡¼ï¿½Ð¥ï¿½ï¿½ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½ï¿½</title> 
     1882    <para> 
     1883     ï¿½ï¿½ï¿½í¡¼ï¿½Ð¥ï¿½ï¿½Æ¥ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Î¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½È¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½     <literal>&lt;test&gt;</literal> ������Ѥ��ޤ��� 
     1884     <literal>&lt;test&gt;</literal> �ˤ�<literal>name</literal> 
     1885     Â°ï¿½ï¿½ï¿½Â¸ï¿½ß¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½ï¿½Æ¥ï¿½ï¿½È¤ï¿½ï¿½ï¿½ï¿½ï¿½Ë¤ï¿½ï¿½ï¿½ï¿½Õ¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ç¥Õ¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ç¡ï¿½Â 
     1886     <literal>name</literal> �ϰ��ʤ��Ǥ���������������ޤ��� 
     1887     ï¿½Ñ¿ï¿½ï¿½<literal>'-'</literal>��<literal>'_'</literal> 
     1888     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ñ¤ï¿½ï¿½ë¤³ï¿½È¤Ï¤Ç¤ï¿½ï¿½Þ¤ï¿½ï¿½ó¡£¤ï¿½ï¿½ï¤«ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Î¥Æ¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ê¤¹ï¿½ï¿½ï¿½Ï¡ï¿½Â 
     1889     <literal>&lt;test&gt;</literal> �����     <literal>&lt;title&gt;</literal> ������Ѥ��ޤ��� 
     1890    </para> 
     1891    <para> 
     1892     ï¿½ÂºÝ¤Ë¼Â¹Ô¤ï¿½ï¿½ï¿½ï¿½ï¿½HP �����ɤϡ�<literal>&lt;code&gt;</literal> 
     1893     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Çµï¿½ï¿½Ò¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½ï¿½Æ¥ï¿½ï¿½È·ï¿½ï¿½È¤ï¿½ï¿½Æ´ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½   <literal>&lt;result&gt;</literal> �����ǻ�ꤷ�ޤ����ǥե�����     <literal>OK</literal> �Ǥ���PHP �Υƥ��ȥ������Ȥϡ� 
     1894     ï¿½Æ¥ï¿½ï¿½È·ï¿½ï¿½Î½ï¿½Ï¤È´ï¿½È¤ï¿½ï¿½ï¿½ï¿½Ì¤ï¿½ï¿½Ë¡ï¿½Ç¹Ô¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½Â 
     1895     ï¿½ï¿½ï¿½ì¤¾ï¿½ì¡¢ï¿½ï¿½ï¿½Ê¸ï¿½ï¿½ï¿½ï¿½ï¿½Æ¤ï¿½ï¿½ï¿½ï¿½printf ����Υץ졼���ۥ� 
     1896     (%d �Ͽ�ʤ� ��Ѥ�����ӡ����������ɽ���������ӤǤ� 
     1897     (�ܺ٤ϡ�PHP ��������<filename>README.TESTING*</filename> 
     1898     ï¿½ò»²¾È¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½)���ǥե����Ǥ�<literal>plain</literal> �⡼�ɤ�Ѥ��ޤ��� 
     1899     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ñ¤ï¿½ï¿½ï¿½ï¿½Ï¡ï¿½<literal>&lt;result&gt;</literal> ��     <literal>mode</literal> °���iteral>format</literal> ���뤤��     <literal>regex</literal> ���ꤷ�ޤ��� 
     1900    </para> 
     1901    <para> 
     1902     ï¿½ï¿½ï¿½ï¿½ï¿½ì¤¿ï¿½Æ¥ï¿½ï¿½ï¿½ï¿½ <literal>--SKIPIF--</literal> 
     1903     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ï¡ï¿½ï¿½ï¿½ï¿½Î³ï¿½ï¿½ï¿½â¥¸ï¿½å¡¼ï¿½ë¤¬ï¿½í¡¼ï¿½É¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ë¤«ï¿½É¤ï¿½ï¿½ï¿½ï¿½ï¿½Ù¤Þ¤ï¿½ï¿½ï¿½Â 
     1904     ï¿½â¤·ï¿½í¡¼ï¿½É¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ê¤ï¿½ï¿½ï¿½ï¿½Ï¤ï¿½ï¿½Î¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Î¥Æ¥ï¿½ï¿½È¤ï¿½ï¿½Åªï¿½Ë¥ï¿½ï¿½ï¿½ï¿½Ã¥×¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½Â 
     1905     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ë¥ï¿½ï¿½ï¿½ï¿½Ã¥×¾ï¿½ï¿½Ã¤ï¿½ï¿½ï¿½ï¿½ï¿½     <literal>&lt;skipif&gt;</literal> ������Ѥ��ޤ��� 
     1906     ï¿½ï¿½ï¿½Î¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ï¡ï¿½PHP �μ����뤤�ϥ�����ҤȤʤ����� 
     1907     ï¿½ï¿½ï¿½Î¾ï¿½ï¿½Ï¡ï¿½É¾ï¿½ï¿½ï¿½ï¿½ï¿½ <literal>true</literal> 
     1908     ï¿½Î¾ï¿½ï¿½Ë¥Æ¥ï¿½ï¿½È¤ò¥¹¥ï¿½ï¿½Ã¥×¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ò¤Î¾ï¿½ï¿½Ï¡ï¿½Â 
     1909     ï¿½ï¿½ï¿½Î½ï¿½Ï¤ï¿½ <literal>skip</literal> 
     1910     ï¿½È¤Ê¤ï¿½ï¿½ï¿½ï¿½Æ¥ï¿½ï¿½È¤ò¥¹¥ï¿½ï¿½Ã¥×¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Î¾ï¿½ï¿½ï¿½<literal>skip</literal> 
     1911     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Æ¥Æ¥ï¿½ï¿½È¤ò¥¹¥ï¿½ï¿½Ã¥×¤ï¿½ï¿½ï¿½ï¿½Í³ï¿½ï¿½ï¿½ï¿½ï¿½ë¤³ï¿½È¤ï¿½ï¿½ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½Â 
     1912    </para> 
     1913    <para> 
     1914     ï¿½Æ¥ï¿½ï¿½È»ï¿½ï¿½Ë»ï¿½Ñ¤ï¿½ï¿½ï¿½ï¿½Ã¤ï¿½php.ini ���ˤĤ��Ƥ�     <literal>&lt;ini&gt;</literal> ���������ǻ�ꤷ�ޤ��� 
    19191915    </para> 
    19201916    <example> 
    1921      <title>Minimal test case</title> 
     1917     <title>�Ǿ��¤Υƥ��ȥ�����</title> 
    19221918     <programlisting> 
    19231919<![CDATA[ 
    … …  
    19291925    </example> 
    19301926    <example> 
    1931      <title>Full test case</title> 
     1927     <title>����ʥƥ��ȥ�����</title> 
    19321928     <programlisting> 
    19331929<![CDATA[ 
    19341930  <test name="full"> 
    1935    <title>A full test case using all tags</title> 
     1931   <title>���٤ƤΥ�����Ѥ��������Υƥ��ȥ�����</title> 
    19361932   <skipif>1==0</skipif> 
    19371933   <ini>max_execution_time=0</ini> 
    … …  
    19441940   </section> 
    19451941   <section> 
    1946     <title>Embedded function test cases</title> 
    1947     <para> 
    1948      For each function a default test case is created, 
    1949      the name and title for this test are automaticly set 
    1950      to the function name.  
     1942    <title>��߹��ߴؿ�ƥ��ȥ�����</title> 
     1943    <para> 
     1944     ï¿½Æ´Ø¿ï¿½Ä¤ï¿½ï¿½Æ¡ï¿½ï¿½Ç¥Õ¥ï¿½ï¿½ï¿½ï¿½Î¥Æ¥ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Â 
     1945     ï¿½ï¿½ï¿½Î¥Æ¥ï¿½ï¿½È¤ï¿½ï¿½ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½Ø¿ï¿½ï¿½È¤Ë¼ï¿½Æ°Åªï¿½Ë·ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Â 
    19511946    </para> 
    19521947    <para>       
    1953      Test code and the expected result 
    1954      can be set using a <literal>&lt;test&gt;</literal> 
    1955      section within <literal>&lt;function&gt;</literal>. 
    1956      <literal>&lt;code&gt;</literal>, 
    1957      <literal>&lt;result&gt;</literal>, 
    1958      <literal>&lt;skipif&gt;</literal> and 
    1959      <literal>&lt;ini&gt;</literal> 
    1960      may be used in there in the same way as in a global 
    1961      <literal>&lt;&gt;</literal> section. Use of the  
    1962      <literal>name</literal> attribute to  
    1963      <literal>&lt;test&gt;</literal> or the  
    1964      <literal>&lt;title&gt;</literal> tag are not  
    1965      supported within a function test. 
    1966     </para> 
     1948     ï¿½Æ¥ï¿½ï¿½È¥ï¿½ï¿½ï¿½ï¿½É¤È´ï¿½Ï¡ï¿½<literal>&lt;function&gt;</literal> 
     1949     ï¿½ï¿½ï¿½ <literal>&lt;test&gt;</literal> 
     1950     ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½Ç»ï¿½ê¤·ï¿½Þ¤ï¿½ï¿½ï¿½Â 
     1951     <literal>&lt;code&gt;</literal> ��    <literal>&lt;result&gt;</literal>�� 
     1952     <literal>&lt;skipif&gt;</literal>��������     <literal>&lt;ini&gt;</literal> �ˤĤ��Ƥ⡢ 
     1953     ï¿½ï¿½ï¿½í¡¼ï¿½Ð¥ë¥»ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½ï¿½è¤¦ï¿½Ë»ï¿½Ñ¤Ç¤ï¿½ï¿½Þ¤ï¿½ï¿½ï¿½Â 
     1954     ï¿½Ø¿ï¿½Æ¥ï¿½ï¿½È¤Ç¤Ï¡ï¿½Â 
     1955     <literal>&lt;test&gt;</literal> �������뤤��     <literal>&lt;title&gt;</literal> ������     <literal>name</literal> °��ϥ��ݡ��Ȥ��Ƥ��ޤ���    </para> 
    19671956    <example> 
    1968      <title>Minimal function test case</title> 
     1957     <title>�ؿ�Ǿ��¤Υƥ��ȥ�����</title> 
    19691958     <programlisting> 
    19701959<![CDATA[ 
    … …  
    19771966    </example> 
    19781967    <example> 
    1979      <title>Full function test case</title> 
     1968     <title>�ؿ����ʥƥ��ȥ�����</title> 
    19801969     <programlisting> 
    19811970<![CDATA[Â