cvs: peardoc /ja/chapters standards.xml
| From: | Haruki Setoyama | Date: | Sat, 29 Apr 2006 23:38:53 +0000 |
| Subject: | cvs: peardoc /ja/chapters standards.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-7842@lists.php.net to get a copy of this message | ||
haruki Sat Apr 29 23:38:53 2006 UTC
Modified files:
/peardoc/ja/chapters standards.xml
Log:
sync with en. and some improvements.
http://cvs.php.net/viewcvs.cgi/peardoc/ja/chapters/standards.xml?r1=1.5&r2=1.6&diff_format=u Index: peardoc/ja/chapters/standards.xml diff -u peardoc/ja/chapters/standards.xml:1.5 peardoc/ja/chapters/standards.xml:1.6 --- peardoc/ja/chapters/standards.xml:1.5 Thu Jun 30 12:12:05 2005 +++ peardoc/ja/chapters/standards.xml Sat Apr 29 23:38:53 2006 @@ -1,6 +1,6 @@ <?xml encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.35 Maintainer: haruki Status: working --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.41 Maintainer: haruki Status: working --> <!-- CREDITS: hirokawa --> <chapter id="standards"> <title>æ¨æºã³ã¼ãã£ã³ã°è¦ç´</title> @@ -16,8 +16,8 @@ <para> ç©ºç½ 4 ã¤ã®ã¤ã³ãã³ãã使ç¨ãã¾ããã¿ãã¯ä½¿ãã¾ããã PEAR ã³ã¼ãã®ç·¨éã« Emacs ã使ç¨ããå ´åãindent-tabs-mode ã - nil ã«è¨å®ããå¿ è¦ãããã¾ãã以ä¸ã«ããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã - Emacs ãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã示ãã¾ãï¼PHP ãã¡ã¤ã«ãç·¨éããéã« + nil ã«è¨å®ããå¿ è¦ãããã¾ãããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã + Emacs ãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã次ã«ç¤ºãã¾ãï¼PHP ãã¡ã¤ã«ãç·¨éããéã« ãããã³ã¼ã«ãããããã«ããå¿ è¦ãããã¾ãï¼ã <programlisting role="elisp"> <![CDATA[ @@ -33,7 +33,7 @@ </programlisting> </para> <para> - 以ä¸ã«ãåæ§ãªãã¨ãè¡ã vim ã«ã¼ã«ã示ãã¾ãã + 次ã«ãåæ§ãªãã¨ãè¡ã vim ã«ã¼ã«ã示ãã¾ãã <programlisting role="vim"> <![CDATA[ set expandtab @@ -55,7 +55,7 @@ <title>å¶å¾¡æ§é </title> <para> å¶å¾¡æ§é ã«ã¯ãif, for, while, switch çãããã¾ãã - 以ä¸ã«ãæãè¤éãªå¶å¾¡æ§é ã§ãã if æã®ä¾ã示ãã¾ãã + æãè¤éãªå¶å¾¡æ§é ã§ãã if æã®ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ if ((condition1) || (condition2)) { @@ -106,7 +106,7 @@ 颿°ã¯ã颿°åã»éãã«ãã³ããã³æåã®ãã©ã¡ã¼ã¿ããããã®éã«ã¯ç©ºç½ãç½®ããã ã«ã³ãã¨ãã©ã¡ã¼ã¿éã«ã¯ç©ºç½ãç½®ããæå¾ã®ãã©ã¡ã¼ã¿ã¨éã«ãã³ ããã³ã»ãã³ãã³ã®éã«ã¯ç©ºç½ãç½®ããã«ã³ã¼ã«ãã¾ãã - 以ä¸ã«ä¾ã示ãã¾ãã + ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ $var = foo($bar, $baz, $quux); @@ -129,7 +129,7 @@ <sect1 id="standards.funcdef"> <title>颿°å®ç¾©</title> <para> - 颿°å®£è¨ã¯ã以ä¸ã®ãã㪠<quote>one true brace</quote> ã¨å¼ã°ãã表è¨ã«å¾ãã¾ãã + 颿°å®£è¨ã¯ã以ä¸ã®ãã㪠<quote>one true brace</quote> ã¨å¼ã°ãã表è¨ã«ããããã¾ãã <programlisting role="php"> <![CDATA[ function fooFunction($arg1, $arg2 = '') @@ -145,7 +145,7 @@ <para> ããã©ã«ãå¤ãæãã弿°ã¯ã弿°ãªã¹ãã®çµããã«ç½®ãã¾ãã é©åã§ãªãå ´åãé¤ãã颿°ã¯ãæå³ã®ããå¤ãè¿ãããã«ãã¾ãã - 以ä¸ã«ãããé·ãä¾ã示ãã¾ãã + ããé·ãä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ function connect(&$dsn, $persistent = false) @@ -176,7 +176,7 @@ <link linkend="standards.header">ãããã³ã¡ã³ããããã¯</link> ã®ã»ã¯ã·ã§ã³ãåç §ãã¦ãã ããã è©³ç´°ãªæ å ±ã¯ã - <ulink url="&url.phpdocumentor;">&url.phpdocumentor;</ulink>ã«ããã¾ãã + <ulink url="&url.phpdocumentor;">&url.phpdocumentor;</ulink> ã«ããã¾ãã </para> <para> ã¤ã³ã©ã¤ã³ããã¥ã¡ã³ã以å¤ã®ã³ã¡ã³ããæ¸ããã¨ãæ¨å¥¨ãã¾ããä¸è¬çãªç®å®ã¨ãã¦ã @@ -193,11 +193,11 @@ <title>ã³ã¼ãã®èªã¿è¾¼ã¿</title> <para> ã¯ã©ã¹ãã¡ã¤ã«ãç¡æ¡ä»¶ã§èªã¿è¾¼ãå ´åã¯ã - <function>require_once</function> ã使ç¨ãã¾ããã¯ã©ã¹ãã¡ã¤ã«ã - æ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´åï¼ä¾ãã°ãfactory ã¡ã½ããï¼ã¯ã + <function>require_once</function> ã使ç¨ãã¾ãã + ã¯ã©ã¹ãã¡ã¤ã«ãæ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´åï¼ãã¨ãã°ãfactory ã¡ã½ããï¼ã¯ã <function>include_once</function> ã使ç¨ãã¾ãã ãããããã¨ã§ãã¯ã©ã¹ãã¡ã¤ã«ã 確å®ã« 1 度ã ãèªã¿è¾¼ã¾ãã¾ãã - ãããã¯ãåããã¡ã¤ã«ãªã¹ããå ±æãã¦ããã + ãããã¯ããã¡ã¤ã«ãªã¹ããå ±æãã¦ããã æ··ç¨ã«ã¤ãã¦å¿é ããå¿ è¦ã¯ããã¾ããã <function>require_once</function> ã§èªã¿è¾¼ã¾ãããã¡ã¤ã«ã¯ã <function>include_once</function> ã«ããå度èªã¿è¾¼ã¾ãããã¨ã¯ããã¾ããã @@ -227,7 +227,7 @@ PEAR ãªãã¸ããªã«å«ã¾ãããã¹ã¦ã®ã½ã¼ã¹ã³ã¼ãã«ã¯ã åãã¡ã¤ã«ã®å é ã« <quote>ãã¼ã¸ã¬ãã«</quote> ã®ã³ã¡ã³ããããã¯ãã åã¯ã©ã¹ã®ç´åã« <quote>ã¯ã©ã¹ã¬ãã«</quote> ã®ã³ã¡ã³ããããã¯ãè¨è¿°ãã¾ãã - 以ä¸ã«ãããã®ä¾ã示ãã¾ãã + ãããã®ä¾ã示ãã¾ãã </para> <para> @@ -314,7 +314,7 @@ <listitem> <para> PHP ã®ãã¼ã¸ã§ã³ã«ã¤ãã¦ã¯ããã¼ã¸ã¬ãã«ã®ã³ã¡ã³ããããã¯ã« - 以ä¸ã®ãã¥ãããè¨ãã¾ã + 次ã®ãã¥ãããè¨ãã¾ã </para> <informalexample> <programlisting role="docblock">. @@ -331,7 +331,7 @@ <listitem> <para> PEAR ã§å©ç¨ã§ããã©ã¤ã»ã³ã¹ã«ã¯ä½ç¨®é¡ãããã¾ãã - 以ä¸ã®ãã¥ããã鏿ãããã¼ã¸ã¬ãã«ãããã¯ã¯ã©ã¹ã¬ãã«ã®ã³ã¡ã³ããããã¯ã« + 次ã®ãã¥ããã鏿ãããã¼ã¸ã¬ãã«ãããã¯ã¯ã©ã¹ã¬ãã«ã®ã³ã¡ã³ããããã¯ã« è¨è¿°ãã¾ãã </para> <informalexample> @@ -340,6 +340,7 @@ * @license http://www.freebsd.org/copyright/freebsd-license.html BSD License (2 Clause) * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause) * @license http://www.freebsd.org/copyright/license.html BSD License (4 Clause) + * @license http://www.opensource.org/licenses/mit-license.html MIT License * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @license http://www.php.net/license/3_0.txt PHP License 3.0 </programlisting> @@ -376,12 +377,12 @@ ã½ã¼ã¹ãã¡ã¤ã«ã®ä½è ãªã¹ãã«ãã³ã¼ãæä¾è ã®ååã追å ããã¹ããã©ãã ãå®ç¾©ããæç¢ºãªè¦åã¯ããã¾ãããä¸è¬çã«ã¯ã <quote>ç¸å½ãª</quote> é¨åï¼10%ãã20%ã®ã³ã¼ã夿´ãæå³ãã¾ãï¼ã®å¤æ´ã - è¡ã£ãå ´åã«ãä½è ã¨ããããã§ãã + è¡ã£ãå ´åã«ãä½è ã«å ããããã§ãã 颿°ã®ãªã©ã¤ããæ°ããªãã¸ãã¯ã®æä¾ã®å ´åã«ã¯ãä¾å¤ããããã¾ãã </para> <para> - ç°¡åãªã³ã¼ãã®æ´çããã°ä¿®æ£ã¯ãä½è ãªã¹ãã«æ°ãã«äººã追å ãã - ã¾ã§ã®çç±ã«ã¯ãªãã¾ããã + ç°¡åãªã³ã¼ãã®æ´çããã°ä¿®æ£ã¯ãä½è ãªã¹ãã« + æ°ãã«äººã追å ããã¾ã§ã®çç±ã«ã¯ãªãã¾ããã </para> </listitem> </varlistentry> @@ -464,7 +465,7 @@ <title>æåééã»ã</title> <para> PEAR ã®ã½ã¼ã¹ã³ã¼ããèªã¿ãããããããã - ããã¹ããã¿ã°ã®é åºãæåééã¯ãä¸ã«ç¤ºããä¾ã«ããããå¿ è¦ãããã¾ãã + ããã¹ããã¿ã°ã®é åºãæåééã¯ãåã®ä¾ã«ããããå¿ è¦ãããã¾ãã ããã¯ãJavaDoc æ¨æºãæ¡ç¨ãããã®ã«ãªã£ã¦ãã¾ãã </para> </sect2> @@ -606,7 +607,7 @@ <term>MAINT_<replaceable>n_n</replaceable></term> <listitem> <simpara> - ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ï¼ä¾ãã°1.2ã®å¾ã«1.2.1ã¨ãã£ãï¼ + ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ï¼ãã¨ãã° 1.2 ã®å¾ã« 1.2.1 ã¨ãã£ãï¼ <quote>ãã¤ã¯ããªãªã¼ã¹</quote> ãè¡ãéã«ã ã¡ã¤ã³ã®éçºãã©ã³ã¯ãéå¸¸ã«æ´»çºã§ããã¤ã¯ããªãªã¼ã¹ã§ å ããªå¤æ´ã®ã¿ãè¡ãããå ´åã«ããã©ã³ãã使ç¨ãããã¨ãã§ãã¾ãã @@ -692,7 +693,7 @@ 颿°ã«ã¯ãããã±ã¼ã¸éã®ååã®è¡çªãé¿ããããã«ããã±ã¼ã¸åãæ¥é è¾ã¨ã㦠å ããã¹ãã§ããï¼æ¥é è¾ã®å¾ã®ï¼ååã®æåã®æåã¯å°æåã§ã æ°ããåèªãå§ããéã®åå é æåã¯å¤§æåã¨ãã¾ãã - ããã¤ãã®ä¾ã以ä¸ã«ç¤ºãã¾ãã + ããã¤ãã®ä¾ã示ãã¾ãã <informaltable> <tgroup cols="4"> <tbody> @@ -710,7 +711,7 @@ ãã©ã¤ãã¼ããªã¯ã©ã¹ã¡ã³ã ï¼ããã宣è¨ãããã¯ã©ã¹ã®å é¨ããã ãã®ä½¿ç¨ãæå³ããã¯ã©ã¹ã¡ã³ãã PHP ã¯ããã©ã¤ãã¼ãåå空éãã¾ã ãµãã¼ããã¦ãã¾ãããï¼ã¯ã - ã¢ã³ãã¼ã¹ã³ã¢ 1 ã¤ãåã«ä»ãã¾ããä¾ã以ä¸ã«ç¤ºãã¾ãã + ã¢ã³ãã¼ã¹ã³ã¢ 1 ã¤ãåã«ä»ãã¾ããä¾ã示ãã¾ãã <informaltable> <tgroup cols="3"> <tbody> @@ -723,14 +724,32 @@ </tgroup> </informaltable> </para> + <para> + <note> + <simpara>次ã®å 容㯠PHP5 ã«é©ç¨ããã¾ãã</simpara> + </note> + ãããã¯ããããªã¯ã©ã¹ã¡ã³ãï¼ããªãã¡ãããã宣è¨ãããã¯ã©ã¹å ã + ããã³ãã®ãµãã¯ã©ã¹å ã§ã ã使ç¨ã§ããã¯ã©ã¹ã¡ã³ãï¼ã«ã¯ã + åã«ã¢ã³ãã¼ã¹ã³ã¢ãä»ãã¾ãããä¾ã示ãã¾ãã + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry><simpara>protected $somevar</simpara></entry> + <entry><simpara>protected function initTree()</simpara></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> </sect2> <sect2> <title>宿°</title> <para> - 宿°ã¯ã常ã«ãã¹ã¦å¤§æåã§è¨è¿°ããåèªã®åºåãã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã + 宿°ã¯ããã¹ã¦å¤§æåã§è¨è¿°ããåèªã®åºåãã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã 使ç¨ããã¹ãã§ãã使ç¨ãããã¯ã©ã¹ï¼ããã±ã¼ã¸ã大æåã§è¡¨ããååã 宿°ã®æ¥é è¾ã¨ãã¦ä»å ãã¦ãã ããã - ä¾ãã°ã<literal>DB::</literal> ããã±ã¼ã¸ã§ä½¿ç¨ãã宿°ã¯ã + ãã¨ãã°ã<literal>DB::</literal> ããã±ã¼ã¸ã§ä½¿ç¨ãã宿°ã¯ã ãã¹ã¦ <literal>DB_</literal> ã§å§ãã¾ãã <note> <simpara> @@ -745,7 +764,7 @@ <para> ããã±ã¼ã¸ã§ã°ãã¼ãã«å¤æ°ãå®ç¾©ããå¿ è¦ãããå ´åããã®ååã¯ã ã¢ã³ãã¼ã¹ã³ã¢ãåå¾ã«ä»ããããã±ã¼ã¸åã§å§ããã¹ãã§ãã - ä¾ãã°ãPEAR ããã±ã¼ã¸ã¯ã + ãã¨ãã°ãPEAR ããã±ã¼ã¸ã¯ã <literal>$_PEAR_destructor_object_list</literal> ã¨ããååã®ã°ãã¼ãã«å¤æ°ã使ç¨ãã¾ãã </para> @@ -802,16 +821,16 @@ <title>ãµã³ãã«ãã¡ã¤ã« (æ¨æºã® Docblock ã³ã¡ã³ããå«ã)</title> <para> æ°å¤ãã®äººã PEAR ããã±ã¼ã¸ã®ã½ã¼ã¹ã³ã¼ããèªã¿ã¾ãã - ã¾ããä»ã®äººãå°æ¥ãããã±ã¼ã¸ã®éçºè ã¨ãã¦å ããããããã¾ããã + ã¾ããå°æ¥ãä»ã®äººãããã±ã¼ã¸ã®éçºè ã¨ãã¦å ããããããã¾ããã ã§ããããçã®äººçãæ¥½ã«ããã«ã¯ãã³ã¼ãã docblocks ãè¦ç´ã«ãããã£ã¦æ´ãã¦ãããã¨ãéè¦ã¨ãªãã¾ãã - äºæããå ´æã«ããã°ã欲ããæ å ±ããã°ããè¦ã¤ãåºããã¨ãã§ããããã§ãã + 欲ããæ å ±ãäºæããå ´æã«ããã°ããã°ããè¦ã¤ãåºããã¨ãã§ããããã§ãã ååããããããé¡ããã¾ãã </para> <para> ä¾ã«ç¤ºãå docblock ã«ã¯ãDocblock ã³ã¡ã³ãã®è¨è¿°æ¹æ³ã«ã¤ã㦠詳ããè¿°ã¹ããã¦ãã¾ãã - ãããã®æç¤ºã«å¾ããã¨ã¯ã2ã¤ã®æå³ã§éè¦ã§ãã + ãããã®æç¤ºã«ãããããã¨ã¯ã2 ã¤ã®æå³ã§éè¦ã§ãã ã²ã¨ã¤ã¯ãdocblock ãèªã¿ããããªãã°ãã¦ã¼ã¶ãéçºè ã ã³ã¼ãã®å 容ã«ã¤ãã¦ãã°ããçè§£ã§ããããã«ãªãã¨ãããã¨ã ãµãã¤ãã¯ãPEAR ã®ãµã¤ãã§ã¯ãphpDocumentor ã«ããèªåçæããã @@ -1011,14 +1030,19 @@ * 'void' if nothing is returned. * * Here's an example of how to format examples: - * <sample> + * <code> * require_once 'Net/Sample.php'; * * $s = new Net_Sample(); * if (PEAR::isError($s)) { * echo $s->getMessage() . "\n"; * } - * </sample> + * </code> + * + * Here is an example for non-php example or sample: + * <samp> + * pear install net_sample + * </samp> * * @param string $arg1 the string to quote * @param int $arg2 an integer of how many problems happened.
http://cvs.php.net/viewcvs.cgi/peardoc/ja/chapters/standards.xml?r1=1.5&r2=1.6&diff_format=u Index: peardoc/ja/chapters/standards.xml diff -u peardoc/ja/chapters/standards.xml:1.5 peardoc/ja/chapters/standards.xml:1.6 --- peardoc/ja/chapters/standards.xml:1.5 Thu Jun 30 12:12:05 2005 +++ peardoc/ja/chapters/standards.xml Sat Apr 29 23:38:53 2006 @@ -1,6 +1,6 @@ <?xml encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.35 Maintainer: haruki Status: working --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.41 Maintainer: haruki Status: working --> <!-- CREDITS: hirokawa --> <chapter id="standards"> <title>æ¨æºã³ã¼ãã£ã³ã°è¦ç´</title> @@ -16,8 +16,8 @@ <para> ç©ºç½ 4 ã¤ã®ã¤ã³ãã³ãã使ç¨ãã¾ããã¿ãã¯ä½¿ãã¾ããã PEAR ã³ã¼ãã®ç·¨éã« Emacs ã使ç¨ããå ´åãindent-tabs-mode ã - nil ã«è¨å®ããå¿ è¦ãããã¾ãã以ä¸ã«ããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã - Emacs ãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã示ãã¾ãï¼PHP ãã¡ã¤ã«ãç·¨éããéã« + nil ã«è¨å®ããå¿ è¦ãããã¾ãããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã + Emacs ãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã次ã«ç¤ºãã¾ãï¼PHP ãã¡ã¤ã«ãç·¨éããéã« ãããã³ã¼ã«ãããããã«ããå¿ è¦ãããã¾ãï¼ã <programlisting role="elisp"> <![CDATA[ @@ -33,7 +33,7 @@ </programlisting> </para> <para> - 以ä¸ã«ãåæ§ãªãã¨ãè¡ã vim ã«ã¼ã«ã示ãã¾ãã + 次ã«ãåæ§ãªãã¨ãè¡ã vim ã«ã¼ã«ã示ãã¾ãã <programlisting role="vim"> <![CDATA[ set expandtab @@ -55,7 +55,7 @@ <title>å¶å¾¡æ§é </title> <para> å¶å¾¡æ§é ã«ã¯ãif, for, while, switch çãããã¾ãã - 以ä¸ã«ãæãè¤éãªå¶å¾¡æ§é ã§ãã if æã®ä¾ã示ãã¾ãã + æãè¤éãªå¶å¾¡æ§é ã§ãã if æã®ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ if ((condition1) || (condition2)) { @@ -106,7 +106,7 @@ 颿°ã¯ã颿°åã»éãã«ãã³ããã³æåã®ãã©ã¡ã¼ã¿ããããã®éã«ã¯ç©ºç½ãç½®ããã ã«ã³ãã¨ãã©ã¡ã¼ã¿éã«ã¯ç©ºç½ãç½®ããæå¾ã®ãã©ã¡ã¼ã¿ã¨éã«ãã³ ããã³ã»ãã³ãã³ã®éã«ã¯ç©ºç½ãç½®ããã«ã³ã¼ã«ãã¾ãã - 以ä¸ã«ä¾ã示ãã¾ãã + ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ $var = foo($bar, $baz, $quux); @@ -129,7 +129,7 @@ <sect1 id="standards.funcdef"> <title>颿°å®ç¾©</title> <para> - 颿°å®£è¨ã¯ã以ä¸ã®ãã㪠<quote>one true brace</quote> ã¨å¼ã°ãã表è¨ã«å¾ãã¾ãã + 颿°å®£è¨ã¯ã以ä¸ã®ãã㪠<quote>one true brace</quote> ã¨å¼ã°ãã表è¨ã«ããããã¾ãã <programlisting role="php"> <![CDATA[ function fooFunction($arg1, $arg2 = '') @@ -145,7 +145,7 @@ <para> ããã©ã«ãå¤ãæãã弿°ã¯ã弿°ãªã¹ãã®çµããã«ç½®ãã¾ãã é©åã§ãªãå ´åãé¤ãã颿°ã¯ãæå³ã®ããå¤ãè¿ãããã«ãã¾ãã - 以ä¸ã«ãããé·ãä¾ã示ãã¾ãã + ããé·ãä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ function connect(&$dsn, $persistent = false) @@ -176,7 +176,7 @@ <link linkend="standards.header">ãããã³ã¡ã³ããããã¯</link> ã®ã»ã¯ã·ã§ã³ãåç §ãã¦ãã ããã è©³ç´°ãªæ å ±ã¯ã - <ulink url="&url.phpdocumentor;">&url.phpdocumentor;</ulink>ã«ããã¾ãã + <ulink url="&url.phpdocumentor;">&url.phpdocumentor;</ulink> ã«ããã¾ãã </para> <para> ã¤ã³ã©ã¤ã³ããã¥ã¡ã³ã以å¤ã®ã³ã¡ã³ããæ¸ããã¨ãæ¨å¥¨ãã¾ããä¸è¬çãªç®å®ã¨ãã¦ã @@ -193,11 +193,11 @@ <title>ã³ã¼ãã®èªã¿è¾¼ã¿</title> <para> ã¯ã©ã¹ãã¡ã¤ã«ãç¡æ¡ä»¶ã§èªã¿è¾¼ãå ´åã¯ã - <function>require_once</function> ã使ç¨ãã¾ããã¯ã©ã¹ãã¡ã¤ã«ã - æ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´åï¼ä¾ãã°ãfactory ã¡ã½ããï¼ã¯ã + <function>require_once</function> ã使ç¨ãã¾ãã + ã¯ã©ã¹ãã¡ã¤ã«ãæ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´åï¼ãã¨ãã°ãfactory ã¡ã½ããï¼ã¯ã <function>include_once</function> ã使ç¨ãã¾ãã ãããããã¨ã§ãã¯ã©ã¹ãã¡ã¤ã«ã 確å®ã« 1 度ã ãèªã¿è¾¼ã¾ãã¾ãã - ãããã¯ãåããã¡ã¤ã«ãªã¹ããå ±æãã¦ããã + ãããã¯ããã¡ã¤ã«ãªã¹ããå ±æãã¦ããã æ··ç¨ã«ã¤ãã¦å¿é ããå¿ è¦ã¯ããã¾ããã <function>require_once</function> ã§èªã¿è¾¼ã¾ãããã¡ã¤ã«ã¯ã <function>include_once</function> ã«ããå度èªã¿è¾¼ã¾ãããã¨ã¯ããã¾ããã @@ -227,7 +227,7 @@ PEAR ãªãã¸ããªã«å«ã¾ãããã¹ã¦ã®ã½ã¼ã¹ã³ã¼ãã«ã¯ã åãã¡ã¤ã«ã®å é ã« <quote>ãã¼ã¸ã¬ãã«</quote> ã®ã³ã¡ã³ããããã¯ãã åã¯ã©ã¹ã®ç´åã« <quote>ã¯ã©ã¹ã¬ãã«</quote> ã®ã³ã¡ã³ããããã¯ãè¨è¿°ãã¾ãã - 以ä¸ã«ãããã®ä¾ã示ãã¾ãã + ãããã®ä¾ã示ãã¾ãã </para> <para> @@ -314,7 +314,7 @@ <listitem> <para> PHP ã®ãã¼ã¸ã§ã³ã«ã¤ãã¦ã¯ããã¼ã¸ã¬ãã«ã®ã³ã¡ã³ããããã¯ã« - 以ä¸ã®ãã¥ãããè¨ãã¾ã + 次ã®ãã¥ãããè¨ãã¾ã </para> <informalexample> <programlisting role="docblock">. @@ -331,7 +331,7 @@ <listitem> <para> PEAR ã§å©ç¨ã§ããã©ã¤ã»ã³ã¹ã«ã¯ä½ç¨®é¡ãããã¾ãã - 以ä¸ã®ãã¥ããã鏿ãããã¼ã¸ã¬ãã«ãããã¯ã¯ã©ã¹ã¬ãã«ã®ã³ã¡ã³ããããã¯ã« + 次ã®ãã¥ããã鏿ãããã¼ã¸ã¬ãã«ãããã¯ã¯ã©ã¹ã¬ãã«ã®ã³ã¡ã³ããããã¯ã« è¨è¿°ãã¾ãã </para> <informalexample> @@ -340,6 +340,7 @@ * @license http://www.freebsd.org/copyright/freebsd-license.html BSD License (2 Clause) * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause) * @license http://www.freebsd.org/copyright/license.html BSD License (4 Clause) + * @license http://www.opensource.org/licenses/mit-license.html MIT License * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @license http://www.php.net/license/3_0.txt PHP License 3.0 </programlisting> @@ -376,12 +377,12 @@ ã½ã¼ã¹ãã¡ã¤ã«ã®ä½è ãªã¹ãã«ãã³ã¼ãæä¾è ã®ååã追å ããã¹ããã©ãã ãå®ç¾©ããæç¢ºãªè¦åã¯ããã¾ãããä¸è¬çã«ã¯ã <quote>ç¸å½ãª</quote> é¨åï¼10%ãã20%ã®ã³ã¼ã夿´ãæå³ãã¾ãï¼ã®å¤æ´ã - è¡ã£ãå ´åã«ãä½è ã¨ããããã§ãã + è¡ã£ãå ´åã«ãä½è ã«å ããããã§ãã 颿°ã®ãªã©ã¤ããæ°ããªãã¸ãã¯ã®æä¾ã®å ´åã«ã¯ãä¾å¤ããããã¾ãã </para> <para> - ç°¡åãªã³ã¼ãã®æ´çããã°ä¿®æ£ã¯ãä½è ãªã¹ãã«æ°ãã«äººã追å ãã - ã¾ã§ã®çç±ã«ã¯ãªãã¾ããã + ç°¡åãªã³ã¼ãã®æ´çããã°ä¿®æ£ã¯ãä½è ãªã¹ãã« + æ°ãã«äººã追å ããã¾ã§ã®çç±ã«ã¯ãªãã¾ããã </para> </listitem> </varlistentry> @@ -464,7 +465,7 @@ <title>æåééã»ã</title> <para> PEAR ã®ã½ã¼ã¹ã³ã¼ããèªã¿ãããããããã - ããã¹ããã¿ã°ã®é åºãæåééã¯ãä¸ã«ç¤ºããä¾ã«ããããå¿ è¦ãããã¾ãã + ããã¹ããã¿ã°ã®é åºãæåééã¯ãåã®ä¾ã«ããããå¿ è¦ãããã¾ãã ããã¯ãJavaDoc æ¨æºãæ¡ç¨ãããã®ã«ãªã£ã¦ãã¾ãã </para> </sect2> @@ -606,7 +607,7 @@ <term>MAINT_<replaceable>n_n</replaceable></term> <listitem> <simpara> - ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ï¼ä¾ãã°1.2ã®å¾ã«1.2.1ã¨ãã£ãï¼ + ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ï¼ãã¨ãã° 1.2 ã®å¾ã« 1.2.1 ã¨ãã£ãï¼ <quote>ãã¤ã¯ããªãªã¼ã¹</quote> ãè¡ãéã«ã ã¡ã¤ã³ã®éçºãã©ã³ã¯ãéå¸¸ã«æ´»çºã§ããã¤ã¯ããªãªã¼ã¹ã§ å ããªå¤æ´ã®ã¿ãè¡ãããå ´åã«ããã©ã³ãã使ç¨ãããã¨ãã§ãã¾ãã @@ -692,7 +693,7 @@ 颿°ã«ã¯ãããã±ã¼ã¸éã®ååã®è¡çªãé¿ããããã«ããã±ã¼ã¸åãæ¥é è¾ã¨ã㦠å ããã¹ãã§ããï¼æ¥é è¾ã®å¾ã®ï¼ååã®æåã®æåã¯å°æåã§ã æ°ããåèªãå§ããéã®åå é æåã¯å¤§æåã¨ãã¾ãã - ããã¤ãã®ä¾ã以ä¸ã«ç¤ºãã¾ãã + ããã¤ãã®ä¾ã示ãã¾ãã <informaltable> <tgroup cols="4"> <tbody> @@ -710,7 +711,7 @@ ãã©ã¤ãã¼ããªã¯ã©ã¹ã¡ã³ã ï¼ããã宣è¨ãããã¯ã©ã¹ã®å é¨ããã ãã®ä½¿ç¨ãæå³ããã¯ã©ã¹ã¡ã³ãã PHP ã¯ããã©ã¤ãã¼ãåå空éãã¾ã ãµãã¼ããã¦ãã¾ãããï¼ã¯ã - ã¢ã³ãã¼ã¹ã³ã¢ 1 ã¤ãåã«ä»ãã¾ããä¾ã以ä¸ã«ç¤ºãã¾ãã + ã¢ã³ãã¼ã¹ã³ã¢ 1 ã¤ãåã«ä»ãã¾ããä¾ã示ãã¾ãã <informaltable> <tgroup cols="3"> <tbody> @@ -723,14 +724,32 @@ </tgroup> </informaltable> </para> + <para> + <note> + <simpara>次ã®å 容㯠PHP5 ã«é©ç¨ããã¾ãã</simpara> + </note> + ãããã¯ããããªã¯ã©ã¹ã¡ã³ãï¼ããªãã¡ãããã宣è¨ãããã¯ã©ã¹å ã + ããã³ãã®ãµãã¯ã©ã¹å ã§ã ã使ç¨ã§ããã¯ã©ã¹ã¡ã³ãï¼ã«ã¯ã + åã«ã¢ã³ãã¼ã¹ã³ã¢ãä»ãã¾ãããä¾ã示ãã¾ãã + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry><simpara>protected $somevar</simpara></entry> + <entry><simpara>protected function initTree()</simpara></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> </sect2> <sect2> <title>宿°</title> <para> - 宿°ã¯ã常ã«ãã¹ã¦å¤§æåã§è¨è¿°ããåèªã®åºåãã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã + 宿°ã¯ããã¹ã¦å¤§æåã§è¨è¿°ããåèªã®åºåãã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã 使ç¨ããã¹ãã§ãã使ç¨ãããã¯ã©ã¹ï¼ããã±ã¼ã¸ã大æåã§è¡¨ããååã 宿°ã®æ¥é è¾ã¨ãã¦ä»å ãã¦ãã ããã - ä¾ãã°ã<literal>DB::</literal> ããã±ã¼ã¸ã§ä½¿ç¨ãã宿°ã¯ã + ãã¨ãã°ã<literal>DB::</literal> ããã±ã¼ã¸ã§ä½¿ç¨ãã宿°ã¯ã ãã¹ã¦ <literal>DB_</literal> ã§å§ãã¾ãã <note> <simpara> @@ -745,7 +764,7 @@ <para> ããã±ã¼ã¸ã§ã°ãã¼ãã«å¤æ°ãå®ç¾©ããå¿ è¦ãããå ´åããã®ååã¯ã ã¢ã³ãã¼ã¹ã³ã¢ãåå¾ã«ä»ããããã±ã¼ã¸åã§å§ããã¹ãã§ãã - ä¾ãã°ãPEAR ããã±ã¼ã¸ã¯ã + ãã¨ãã°ãPEAR ããã±ã¼ã¸ã¯ã <literal>$_PEAR_destructor_object_list</literal> ã¨ããååã®ã°ãã¼ãã«å¤æ°ã使ç¨ãã¾ãã </para> @@ -802,16 +821,16 @@ <title>ãµã³ãã«ãã¡ã¤ã« (æ¨æºã® Docblock ã³ã¡ã³ããå«ã)</title> <para> æ°å¤ãã®äººã PEAR ããã±ã¼ã¸ã®ã½ã¼ã¹ã³ã¼ããèªã¿ã¾ãã - ã¾ããä»ã®äººãå°æ¥ãããã±ã¼ã¸ã®éçºè ã¨ãã¦å ããããããã¾ããã + ã¾ããå°æ¥ãä»ã®äººãããã±ã¼ã¸ã®éçºè ã¨ãã¦å ããããããã¾ããã ã§ããããçã®äººçãæ¥½ã«ããã«ã¯ãã³ã¼ãã docblocks ãè¦ç´ã«ãããã£ã¦æ´ãã¦ãããã¨ãéè¦ã¨ãªãã¾ãã - äºæããå ´æã«ããã°ã欲ããæ å ±ããã°ããè¦ã¤ãåºããã¨ãã§ããããã§ãã + 欲ããæ å ±ãäºæããå ´æã«ããã°ããã°ããè¦ã¤ãåºããã¨ãã§ããããã§ãã ååããããããé¡ããã¾ãã </para> <para> ä¾ã«ç¤ºãå docblock ã«ã¯ãDocblock ã³ã¡ã³ãã®è¨è¿°æ¹æ³ã«ã¤ã㦠詳ããè¿°ã¹ããã¦ãã¾ãã - ãããã®æç¤ºã«å¾ããã¨ã¯ã2ã¤ã®æå³ã§éè¦ã§ãã + ãããã®æç¤ºã«ãããããã¨ã¯ã2 ã¤ã®æå³ã§éè¦ã§ãã ã²ã¨ã¤ã¯ãdocblock ãèªã¿ããããªãã°ãã¦ã¼ã¶ãéçºè ã ã³ã¼ãã®å 容ã«ã¤ãã¦ãã°ããçè§£ã§ããããã«ãªãã¨ãããã¨ã ãµãã¤ãã¯ãPEAR ã®ãµã¤ãã§ã¯ãphpDocumentor ã«ããèªåçæããã @@ -1011,14 +1030,19 @@ * 'void' if nothing is returned. * * Here's an example of how to format examples: - * <sample> + * <code> * require_once 'Net/Sample.php'; * * $s = new Net_Sample(); * if (PEAR::isError($s)) { * echo $s->getMessage() . "\n"; * } - * </sample> + * </code> + * + * Here is an example for non-php example or sample: + * <samp> + * pear install net_sample + * </samp> * * @param string $arg1 the string to quote * @param int $arg2 an integer of how many problems happened.