cvs: peardoc /ja/chapters contributing.xml installation.xml standards.xml support.xml
| From: | Haruki Setoyama | Date: | Mon, 24 May 2004 13:36:18 +0000 |
| Subject: | cvs: peardoc /ja/chapters contributing.xml installation.xml standards.xml support.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-4084@lists.php.net to get a copy of this message | ||
haruki Mon May 24 09:36:18 2004 EDT
Modified files:
/peardoc/ja/chapters contributing.xml installation.xml
standards.xml support.xml
Log:
sync with en and change some expr.
http://cvs.php.net/diff.php/peardoc/ja/chapters/contributing.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/ja/chapters/contributing.xml diff -u peardoc/ja/chapters/contributing.xml:1.3 peardoc/ja/chapters/contributing.xml:1.4 --- peardoc/ja/chapters/contributing.xml:1.3 Thu May 20 06:00:34 2004 +++ peardoc/ja/chapters/contributing.xml Mon May 24 09:36:18 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <chapter id="contributing"> -<!-- EN-Revision: 1.13 Maintainer: danielc Status: added english for doc/translate section --> +<!-- EN-Revision: 1.14 Maintainer: Status: ready --> <chapterinfo> <author> <firstname>Tal</firstname> @@ -25,11 +25,11 @@ <sect1 id="contributing.introduction"> <title>ã¯ããã«</title> <simpara> - PEARã¯ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã§ãããã©ããªäººã§ãPEARãæ¹è¯ã«å - å ãããã¨ãã§ãã¾ããæ¹è¯ã¨ã¯ãã³ã¼ããæ¸ããã¨ã ããæå³ãããã - ã§ã¯ããã¾ãããæ¹è¯ã¯ããã°ãå ±åãããããã£ã¼ãããã¯ãæä¾ã - ãããæ©è½ã®ãªã¯ã¨ã¹ããããããããã¨ãæå³ããééçãªãµãã¼ãã - è¡ããã¨ãããå«ã¾ãã¾ãã + PEAR ã¯ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã§ãããã©ããªäººã§ã PEAR ã®æ¹è¯ã«å + å ãããã¨ãã§ãã¾ããæ¹è¯ã¨ã¯ãã³ã¼ããæ¸ããã¨ã ããæå³ããããã§ã¯ + ããã¾ãããæ¹è¯ã¯ããã°ãå ±åãããããã£ã¼ãããã¯ãæä¾ãããã + æ©è½ã®ãªã¯ã¨ã¹ããããããããã¨ãæå³ãã + ééçãªãµãã¼ããè¡ããã¨ãããå«ã¾ãã¾ãã </simpara> </sect1> @@ -44,68 +44,63 @@ <sect1 id="contributing.patches"> <title>ãããã®æ稿</title> <para> - If you have modified a package to expand its functionality or to fix a - bug, you should contribute your changes back to the community (some - licenses force you to do so, and it is generally considered immoral not to). + æ©è½ãæ¡å¼µãããããã°ã®ä¿®æ£ãããããã«ããã±ã¼ã¸ãå¤æ´ããå ´åã¯ã + ãã®å¤æ´ãã³ãã¥ããã£ã¼ã«å¯è´ããã¹ãã§ã + ï¼ãããããã¨ãå¼·å¶ããã©ã¤ã»ã³ã¹ãããã¾ããã¾ããä¸è¬çã«ã + ããããªããã¨ã¯ã¢ã©ã«ã«æããã®ã¨ã¿ãªããã¾ãï¼ã </para> <para> - Before creating the patch, you must first obtain the latest sources of the - package you wish to patch from CVS by running the commands (the package - in this example is Foo_Bar): + ããããä½æããåã«ãCVS ããããããå½ã¦ãã¹ãææ°ã®ã½ã¼ã¹ã以ä¸ã®ããã«ã㦠+ åå¾ãã¦ãã ããï¼ãã®ä¾ã§ã¯ãããã±ã¼ã¸å㯠Foo_Bar ã¨ãã¾ãï¼ã <screen> <command>cvs -d:pserver:cvsread@cvs.php.net:/repository login</command> -password is "phpfi" +ãã¹ã¯ã¼ã㯠"phpfi" ã§ã <command> cvs -z3 -d:pserver:cvsread@cvs.php.net:/repository co Foo_Bar </command> </screen> - Now that you have the latest sources, you can edit the relevant file(s). - Make sure that your patch is fully compatible with the &link.coding-standards;. + ææ°ã®ã½ã¼ã¹ãåå¾ã§ããã®ã§ã対å¿ãããã¡ã¤ã«ãç·¨éãã¾ãã + &link.coding-standards; ã«åè´ããããã«ãã¦ãã ããã </para> <para> - After you have finished adding/changing the code, TEST it: We will not - accept code that hasn't been carefully tested. - When you are absolutely sure the new code doesn't introduce bugs, create a - unified diff by running: + ã³ã¼ãã«è¿½å ã»å¤æ´ãè¡ã£ããããã¹ããã¦ãã ããã注ææ·±ããã¹ããè¡ããã¦ããªã + ã³ã¼ãã¯åãå ¥ãããã¾ãããæ°ããã³ã¼ãã«ãã°ãç¡ããã¨ã確信ãããã + 以ä¸ã®ã³ãã³ã㧠unified å½¢å¼ã® diff ãä½æãã¾ãã <screen> <command>cd pear/Foo_Bar</command> <command>cvs diff -u >Foo_Bar.diff</command> </screen> - The resulting .diff file contains your patch. This diff makes it easy - for us to see what has been changed. + ã§ãã .diff ãã¡ã¤ã«ã¯ãããªãã®ããããå«ãã§ãã¾ãããã® diff ã«ããã + å¤æ´ç¹ã確èªãããã¨ãã§ããããã«ãªãã¾ãã </para> <para> - Next step is to submit the patch. Send a mail to &email.pear.dev; and - Cc the maintainer(s) of the package. The subject of the mail should be - prefixed with '[Patch]' to make it clear you are submitting a patch. Also - include a verbose explanation of what the patch does. - Don't forget to attach the .diff file to the mail. The maintainers of - the package are usually listed in the header of each source file. Apart - from that their email adresses are available on the package information - page on &url.pear;. + 次ã®ã¹ãããã¯ããããã®éä»ã§ããããã±ã¼ã¸ã®ã¡ã³ããã« CC ãã¤ãã¦ã + &email.pear.dev; ã«ã¡ã¼ã«ãæ¸ãã¦ãã ãããã¡ã¼ã«ã®ä»¶åã¯ã + '[Patch]' ããã¯ããã¦ããããã®æ稿ã§ãããã¨ãå¤ããããããã¨è¯ãã§ãããã + ã¾ãããããã®å 容ã®è©³ãã説æãæ¸ãã¦ãã ããã + .diff ãã¡ã¤ã«ãã¡ã¼ã«ã«æ·»ä»ããã®ãå¿ããªãããã«ã + ããã±ã¼ã¸ã®ã¡ã³ããåã¯ãé常ãã½ã¼ã¹ãã¡ã¤ã«ã®ãããã«è¨è¼ããã¦ãã¾ãã + ã¡ã¼ã«ã¢ãã¬ã¹ä»¥å¤ã®æ å ±ã¯ã&url.pear; ã®ããã±ã¼ã¸æ å ±ã®ãã¼ã¸ã§è¦ããã¾ãã </para> <note> <para> - If you are using Outlook or Outlook Express, please change the file - extension of the diff file to .txt, because Outlook's MIME-Type - detection depends on the file extension and attachments with a - MIME-Type not equal to <literal>text/plain</literal> will be rejected - by our mailinglist software. + Outlook ã Outlook Express ã使ã£ã¦ããå ´åã¯ãdiff ãã¡ã¤ã«ã®æ¡å¼µåã + .txt ã¸å¤æ´ãã¦ãã ãããOutlook ã® MIME å½¢å¼ã®æ¤åºã¯ããã¡ã¤ã«ã®æ¡å¼µåã + è¦ã¦ãããMIME å½¢å¼ã <literal>text/plain</literal> ã§ãªãæ·»ä»ãã¡ã¤ã«ã¯ + ããããã®ä½¿ç¨ããã¡ã¼ãªã³ã°ãªã¹ãã®ã½ãããæå¦ããããã§ãã </para> </note> <note> <para> - If your patch does break backwards compatibility, the chances are fairly - good that the maintainers won't be happy about it. Thus you should always - try to fix a bug in a way that does not seriously change the public API. - But if there is absolutely no way to keep backwards compatibility and/or - if your patch contains a groundbraking improvement, even API changes are - fine. + ãããã«å¾æ¹äºææ§ãç¡ããã°ãå¤æ´ããã°ããããã®ã§ãã£ã¦ããã¡ã³ãã㯠+ å°ã£ã¦ãã¾ãã§ãããããããªãã¯ãª API ãå¤§å¹ ã«å¤æ´ãããã¨ã®ç¡ãããã«ã + ãã°ä¿®æ£ãè¡ã£ã¦ã¿ãã¹ãã§ããå¾æ¹äºææ§ã®ä¿ã¤ãã¨ã¯ã¾ã£ããä¸å¯è½ã§ãã¾ãã + ãããã大å¤ãªæ©è½åä¸ãããããå ´åã¯ãAPI ãå¤æ´ãã¦ãè¯ãã§ãããã </para> </note> </sect1> @@ -113,62 +108,61 @@ <sect1 id="contributing.bugs"> <title>ãã°ã®å ±å</title> <para> - If you think that you have found a bug in a PEAR package, please - take care that you are using the latest version of the package and - that your system does meet the packages' requirements. + PEAR ããã±ã¼ã¸ã«ãã°ãããã¨æã£ãããã¾ããããã±ã¼ã¸ã®ææ°çã使ç¨ãã¦ãããã + ããã³ãã·ã¹ãã ãããã±ã¼ã¸ã®è¦æ±äºé ã«åã£ã¦ããã確èªãã¦ãã ããã </para> <para> - If the bug still persists with the latest version of the package, - don't hesitate to fill out a bug report on - <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. - Please choose "PEAR related" as the category for the report. The developers - on the PEAR development list will be noticed about your report. + ãã°ãããã±ã¼ã¸ã®ææ°çã«ãåå¨ããå ´åã¯ã<ulink url="&url.php.bugs;"> + &url.php.bugs;</ulink> ã®ãã°å ±åãè¨è¿°ãã¦ãã ããã + å ±åã®ã«ãã´ãªã«ã¯ "PEAR related" ãé¸æãã¦ãã ããã + PEAR development ã¡ã¼ãªã³ã°ãªã¹ãã«ããã¦ãéçºè ãå ±åã«ç®ãéãã¾ãã </para> <para> - More information and tips on how to report bugs in a proper way - can be found at <ulink url="&url.php.bugs.howto;">&url.php.bugs.howto;</ulink>. + ãã°ãæ£ããå ±åããããã®æ¹æ³ã«ã¤ãã¦ã®ãã詳ããæ å ±ã«ã¤ãã¦ã¯ + <ulink url="&url.php.bugs.howto;">&url.php.bugs.howto;</ulink> + ãåç §ãã¦ãã ããã </para> <para> - If you have already fixed a bug that you have found in a package, please - read <link linkend="contributing.bugs">this</link>. + ããè¦ã¤ãããã°ãä¿®æ£ããå ´åã¯ã<link linkend="contributing.bugs">ãã¡ã + </link>ãåç §ãã¦ãã ããã </para> </sect1> <sect1 id="contributing.documentation"> - <title>Writing & Translating Documentation</title> + <title>ããã¥ã¡ã³ãã®è¨è¿°ã¨ç¿»è¨³</title> <para> - Good documentation is essential for users to fully understand any - software. Several PEAR packages lack documentation or have docs which - need improvement. <link - linkend="developers.documentation">Writing documentation</link> - provides more information about helping out on this front. + ããã½ããã¦ã¨ã¢ãã¦ã¼ã¶ãç解ããããã«ã¯ãè¯ãããã¥ã¡ã³ããå¿ é ã§ãã + ããã¥ã¡ã³ããæ¬ ãã¦ããããæ¹è¯ãå¿ è¦ãª PEAR ããã±ã¼ã¸ãããã¾ãã + <link + linkend="developers.documentation">ããã¥ã¡ã³ãã®ä½æ</link>ã®ç« ã«ã + ããã«å½¹ã«ãã¤æ å ±ãè¨è¼ããã¦ãã¾ãã </para> <para> - Translating documentation is another important task. - Not only does new documentation need to be translated - into the existing languages, additional languages are - welcome. Also, existing translations need to be brought - up to date because the English versions have been changed. - Help on how to perform the translation process is in the <link - linkend="faq.translators-revision-tracking">Revision Tracking</link> - section of the manual. + ããã¥ã¡ã³ãã®ç¿»è¨³ãéè¦ãªä»äºã§ãã + ããã¾ã§ã«ã翻訳ãè¡ããã¦ããè¨èªã«ãæ°ããããã¥ã¡ã³ãã翻訳ãããã¨ãéè¦ + ã§ããã翻訳ãè¡ããã¦ããªãè¨èªã¸ã®è¨³åºãæè¿ããã¾ãã + ã¾ããè±èªã®ããã¥ã¡ã³ãã¯å¤æ´ãå ãããã¦ããã®ã§ã翻訳ãã¿ã®ãã®ã + æ´æ°ãã¦ãããã¨ãå¿ è¦ã¨ãªãã¾ãã + 翻訳ããã»ã¹ã®å®è¡æ¹æ³ã«ã¤ãã¦ã¯ãæ¬ããã¥ã¢ã«ã®<link + linkend="faq.translators-revision-tracking">ãªãã¸ã§ã³è¿½è·¡</link>ã®ç« ã + åç §ãã¦ãã ããã </para> </sect1> <sect1 id="contributing.wishlist"> - <title>欲ãããã®ãªã¹ã(ã¦ã¤ãã·ã¥ãªã¹ã)</title> + <title>ã¦ã¤ãã·ã¥ãªã¹ã</title> <para> - Some of the PEAR developers have wishlists at Amazon or a similar - service. If you appreciate the work of a certain developer, feel - free to buy something for her from her wishlist. To find out if - a developer has one of those wishlists, go to the - <ulink url="&url.pear.account;">account browser</ulink>, - look for the details of the developer and there you'll see if she - has a wishlist. Buying something from people's wishlists may even - speed up the time in which annoying bugs are fixed ;-). + PEAR éçºè ã®ä¸ã«ã¯ãAmazon çã§ã¦ã¤ãã·ã¥ãªã¹ããå ¬éãã¦ãã人ããã¾ãã + ããéçºè ã®ä»äºã«å¯¾ãã¦æè¬ã®æã表ãããå ´åãã¦ã¤ãã·ã¥ãªã¹ããã + é æ ®ãªãä½ããè²·ã£ã¦è´ã£ã¦ããã¦ãã ããã + éçºè ãã¦ã¤ãã·ã¥ãªã¹ããå ¬éãã¦ãããã©ãã調ã¹ãã«ã¯ã + <ulink url="&url.pear.account;">ã¢ã«ã¦ã³ããã©ã¦ã¶</ulink>ã§éçºè ã®è©³ç´°æ å ±ã + åç §ãã¾ãã + ã¦ã¤ãã·ã¥ãªã¹ãããä½ãè´ãã¨ãæ©ã¾ãããã°ãä¿®æ£ãããæéãçããªããã + ããã¾ããã (^-^)ã </para> </sect1> </chapter> http://cvs.php.net/diff.php/peardoc/ja/chapters/installation.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/ja/chapters/installation.xml diff -u peardoc/ja/chapters/installation.xml:1.4 peardoc/ja/chapters/installation.xml:1.5 --- peardoc/ja/chapters/installation.xml:1.4 Thu May 20 06:00:34 2004 +++ peardoc/ja/chapters/installation.xml Mon May 24 09:36:18 2004 @@ -1,7 +1,6 @@ -<?xml version="1.0" encoding="utf-8" ?> -<!-- sync: 1.8 --> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.8 Maintainer: Status: ready --> +<?xml version="1.0" encoding="UTF-8" ?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.18 Maintainer: Status: ready --> <!-- CREDITS: --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING @@ -17,128 +16,135 @@ </chapterinfo> <title>ã¤ã³ã¹ãã¼ã«</title> <simpara> - æ¬ç« ã¯ãPEARããããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦èª¬æãã¾ãã + æ¬ç« ã¯ãPEAR ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦èª¬æãã¾ãã </simpara> <sect1 id="installation.introduction"> <title>å°å ¥</title> <para> - æ¬ç« ã¯ãPEARã®<link linkend="about.pear">æ§æ</link>ã«é¢ããç¥èã + æ¬ç« ã¯ãPEAR ã®<link linkend="about.pear">åºæ¬çæ§æ</link>ã«é¢ããç¥èã æãããã¨ãåå ¤ã¨ãã¾ãã </para> <para> - åºæ¬é¨åã®ã¤ã³ã¹ãã¼ã«ã¯ãPFCã®é¨åã¨ãã¦PHPãã£ã¹ããªãã¥ã¼ã·ã§ã³ã¨ - å ±ã«è¡ããã¾ããããã«ã¯ãPEARã¤ã³ã¹ãã¼ã«ãã¼ã«çã®å®è¡ã«è¦ããã - ã®ãå ¨ã¦å«ã¾ãã¦ãã¾ããPHP 4ã®æè¿ã®ãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ã㦠- ããå ´åã«ã¯ããç°¡åã§ã<filename>./configure</filename>ã«ãã©ã°'-- - without-pear'ãæå®ãã¦ããªãéãPEARã®åºæ¬é¨åã¯ã·ã¹ãã ã«ã¤ã³ã¹ - ãã¼ã«æ¸ã¿ã§ãã - </para> - <para> - PFC以å¤ã®ããã±ã¼ã¸ã¯ãPEARããã±ã¼ã¸ããã¼ã¸ã£ã«ããã¤ã³ã¹ãã¼ã« - å¯è½ã§ãããã®ããã¼ã¸ã£ã¯ãDebianã®<quote>apt-get</quote>ã¨äºææ§ - ãããã¾ããã¾ããæè¿ã®ãã¼ã¸ã§ã³(> 4.3.0) ã®PHPãå®è¡ã㦠- ããå ´åã次ç¯ãèªã¿é£ã°ããã¨ãã§ãã¾ããPHP 4.2.*ããã³ãã以å - ã®ãã¼ã¸ã§ã³ã使ç¨ãã¦ããå ´åããã®ããã¼ã¸ã£ãå¥éã¤ã³ã¹ãã¼ã«ã - ãå¿ è¦ãããã¾ãã - </para> - <para> - ããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ä»¥å¤ã«ãPEARããã±ã¼ã¸ããã¼ã¸ã£ã¯ãä»ã®ã - ãã¤ãã®å¦çãè¡ãã¾ãã使ç¨ãããã·ã³ã«æ°è¦ããã±ã¼ã¸ãä½æãã㤠- ã³ã¹ãã¼ã«æ¸ã¿ã®ããã±ã¼ã¸ã®ã¬ã¸ã¹ããªã管çããä¾åæ§ã確èªããã - ã¨ãå¯è½ã§ããããã¦ãä»ã®å¦çãè¡ãããã«pear.php.netä¸ã®XML-RPC - ãµã¼ãã¹ã«ããéä¿¡ãããã¨ãå¯è½ã§ãã + PEAR ã®åºæ¬é¨å + <link linkend="about-pfc">The PHP Foundation Classes (PFC)</link> + ã¯ãPHP ãã£ã¹ããªãã¥ã¼ã·ã§ã³ã¨å ±ã«é å¸ããã¦ããã + PEAR ã¤ã³ã¹ãã¼ã«ãã¼ã«ã®å®è¡ã«è¦ãããã®ããã¹ã¦å«ãã§ãã¾ãã + PHP 4 ã®æè¿ã®ãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ããå ´åã«ã¯ã + <filename>./configure</filename> ã«ãã©ã° + <literal>--without-pear</literal> ãæå®ãã¦ããªãéãã + PEAR ã®åºæ¬é¨åã¯ã·ã¹ãã ã«ã¤ã³ã¹ãã¼ã«ãããããã«ãªã£ã¦ãã¾ãã + </para> + <para> + <link linkend="about-pfc">PFC</link> 以å¤ã®ããã±ã¼ã¸ã¯ã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã«ããã¤ã³ã¹ãã¼ã«ãå¯è½ã§ãã + ãã®ããã¼ã¸ã£ã¯ãDebian ã® <quote>apt-get</quote> ã¨ä¼¼ã¦ãã¾ãã + æè¿ã®ãã¼ã¸ã§ã³ (> 4.3.0) ã® PHP ã使ç¨ãã¦ããå ´åã¯ã + 次ç¯ãèªã¿é£ã°ããã¨ãã§ãã¾ããPHP 4.2.* ããã³ãã以åã®ãã¼ã¸ã§ã³ã + 使ç¨ãã¦ããå ´åã¯ãããã±ã¼ã¸ããã¼ã¸ã£ãå¥éã¤ã³ã¹ãã¼ã«ãã + å¿ è¦ãããã¾ãã + </para> + <para> + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã¯ãããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ä»¥å¤ã®ä»äºãè¡ãã¾ãã + æ°è¦ããã±ã¼ã¸ã®ä½æã»ã¤ã³ã¹ãã¼ã«æ¸ã¿ããã±ã¼ã¸ã®ã¬ã¸ã¹ããªç®¡çã» + ä¾åæ§ã®ãã§ãã¯ãªã©ã§ãã + ããã¦ããããã®å¦çãè¡ãããã« pear.php.ne ä¸ã® XML-RPC ãµã¼ãã¹ã¨ + éä¿¡ãããã¨ãå¯è½ã§ãã </para> </sect1> <sect1 id="installation.getting"> - <title>PEARããã±ã¼ã¸ããã¼ã¸ã£ã®åå¾</title> - <simpara> - Linux: PHP 4.3.0以éã./configure ã§--without-pearãæå®ããã¦ã㪠- ãéããPEAR Package Managerã¯ã¤ã³ã¹ãã¼ã«ããã¦ãã¾ãã - </simpara> - <note> - <para> - ããã¤ãã®Linuxãã£ã¹ããªãã¥ã¼ã·ã§ã³(ä¾: Redhat) ã¯ã - ã³ãã³ãã©ã¤ã³ãã©ã¦ã¶ã®ååã¨ãã¦<filename>lynx</filename>ã§ã¯ãª - ãã<filename>links</filename>ã使ç¨ãã¦ããããã§ãã - ãã®å ´åã以ä¸ã®è¡ãåæ§ã«å¤æ´ããå¿ è¦ãããã¾ãã - </para> - </note> - <simpara> - Windows: PHP 4.3.2以éãgo-pearã¹ã¯ãªããããã³ãã«ããã¦ãã¾ãã - (ã¦ã¤ã³ãã¦ãºã¨ã¯ã¹ããã¼ã©ã®ããã«ã¯ãªãã¯ã¨åæ§ã«å®è¡ãã¦ã¿ã¦ä¸ããã - </simpara> - <para> - <screen> - <userinput> -drive:path\to\php\go-pear.bat - </userinput> - </screen> - </para> - <simpara> - ãã®å¾ã®è³ªåã«å ¨ã¦å¿ãã¦ä¸ããã - ããã«ãããPEARããã±ã¼ã¸ããã¼ã¸ã£ãæå®ãããã¹ã«ã¤ã³ã¹ãã¼ã«ã - ãã¾ãããã®ãã¹ãã·ã¹ãã ã®PATHç°å¢å¤æ° - (ã¹ã¿ã¼ã > ã³ã³ããã¼ã«ããã« > ã·ã¹ãã > ç°å¢å¤æ°) - ã«è¿½å ããã³ãã³ãããã³ããã§pearã¨ã¿ã¤ããã¦ã¿ã¦ä¸ããã - è¦äºã«åä½ããã¯ãã§ãã - </simpara> - <simpara> - ææ°çã®PHP(> 4.3.0)ã使ã£ã¦ããªãã¦ã¼ã¶ã - ããã±ã¼ã¸ããã¼ã¸ã£ãåã¤ã³ã¹ãã¼ã«ãããå ´åã¯ã - å¥ã®æ¹æ³ãç¨æããã¦ãã¾ãã - 以ä¸ã®ã³ãã³ããLinuxä¸ã§å®è¡ãããã¨ãã§ãã¾ãã - </simpara> - <para> - <screen> - <userinput> -$ lynx -source http://go-pear.org | php - </userinput> - </screen> - </para> - <simpara> - Windowsã§ã¯ãgo-pear.orgããã¹ã¯ãªããããã¦ã³ãã¼ããä¿åãã - 以ä¸ã®ã³ãã³ãã§å®è¡ãã¦ä¸ããã - </simpara> - <para> - <screen> - <userinput> -php go-pear (ã¾ãã¯ä¿åãããã¡ã¤ã«å) - </userinput> - </screen> - </para> - <simpara> - (ãµã¼ãã«sshã¢ã¯ã»ã¹ã§ããç°å¢ã§ãªãéã)pearã³ãã³ãã使ç¨ã§ã㪠- ãã®ã§ãWebãã¹ãã«pearãã¤ã³ã¹ãã¼ã«ã§ãããæ¸å¿µãããããããã¾ - ãããããããå ¨ãä¸å¯è½ãªããã§ã¯ããã¾ããã - PEARããã±ã¼ã¸ããã¼ã¸ã£ã¯ãããã±ã¼ã¸ã¤ã³ã¹ãã¼ã«ã®æé ãç°¡åã«ã - ã¦ãããã ãã®ãã®ã§ããï¼ã¤ã®æ段ã¨ãã¦ã¯ããã¹ã¯ãããPCã«pear - ã³ãã³ãã§ã¤ã³ã¹ãã¼ã«ãã¦ããããµã¼ãã¼ã«ãã¡ã¤ã«ãã³ãã¼ããã¨ã - ããã®ãããã¾ããPEARãã¡ã¤ã«ãéã¨ã§å©ç¨ã§ããããã« - set_include_path()ã使ç¨ãããã¨ãå¿ããªãããã«ãã¦ä¸ããã - </simpara> - </sect1> + <title>ããã±ã¼ã¸ããã¼ã¸ã£ã®åå¾</title> + <sect2> + <title>Unix/Linux/BSD</title> + <para> + PHP 4.3.0以éã <filename>./configure</filename> 㧠+ <literal>--without-pear</literal> ãªãã·ã§ã³ãæå®ããªãéãã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã¯ï¼PHP ã¨å ±ã«ï¼ã¤ã³ã¹ãã¼ã«ããã¦ãã¾ãã + </para> + <para> + ãã¼ã¸ã§ã³ 4.3.0 以åã®å ´åãã + ããã±ã¼ã¸ããã¼ã¸ã£ãåã¤ã³ã¹ãã¼ã«ãããå ´åã¯ã + 以ä¸ã®æ¹æ³ãæ«å®çã«ç¨æããã¦ãã¾ãã + <screen> + <userinput> +$ lynx -source http://go-pear.org/ | php + </userinput> + </screen> + </para> + <note> + <para> + ããã¤ãã® Linux ãã£ã¹ããªãã¥ã¼ã·ã§ã³ï¼Redhatãªã©ï¼ã§ã¯ã + ã³ãã³ãã©ã¤ã³ãã©ã¦ã¶ã®ååã¨ã㦠<filename>lynx</filename> ã§ã¯ãª + ãã<filename>links</filename> ã使ç¨ãã¦ããããã§ãã + ãã®å ´åãä¸è¨ã®è¡ããã®ããã«å¤æ´ããå¿ è¦ãããã¾ãã + </para> + </note> + </sect2> + + <sect2> + <title>Windows</title> + + <para> + PHP ããã¦ã³ãã¼ããã¤ã³ã¹ãã¼ã«ããå¾ãããããã¡ã¤ã«ãå®è¡ãã¾ãã + ãã¡ã¤ã«ã¯ãï¼ã¤ã³ã¹ãã¼ã«ããå ´æã«ããã¾ããï¼ + <filename>c:\php\go-pear.bat</filename> ã®ãããªæã«ããã¾ãã + ã»ããã¢ããä¸ãããã¤ãã®è³ªåãè¡ãããæå®ãããã¹ã« PEAR + ããã±ã¼ã¸ããã¼ã¸ã£ãã¤ã³ã¹ãã¼ã«ããã¾ãã + ãã®å¾ãPATH ç°å¢å¤æ°ã«ã¤ã³ã¹ãã¼ã«ãããã©ã«ãã¸ã®ãã¹ã追å ãã¦ãã ãã + ï¼ã¹ã¿ã¼ã > ã³ã³ããã¼ã«ããã« > ã·ã¹ãã > ç°å¢å¤æ°ï¼ã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ãå®è¡ããã«ã¯ã + Windows ã®ã³ãã³ãããã³ããã§ã <literal>pear</literal> + ã³ãã³ãã使ç¨ãã¾ãã + </para> + <para> + PEAR ã¤ã³ã¹ãã¼ã«ã®ã¢ãããã¼ãã go-pear.org ãç¨ãã¦è¡ããã¨ãã§ãã¾ãã + http://go-pear.org/ ããã©ã¦ã¶ã§è¡¨ç¤ºãã<filename>go-pear.php</filename> + ã«ä¿åãã¦ã以ä¸ã®ã³ãã³ããå®è¡ãã¦ãã ããã + <screen> + <userinput> +php go-pear.php + </userinput> + </screen> + Windows ã®ã³ãã³ãããã³ããã§ãã¢ãããã¼ãã®ããã»ã¹ãã¹ã¿ã¼ããã¾ãã + </para> + </sect2> + <sect2> + <title>ãã¹ãã£ã³ã°ç°å¢ã§ã® PEAR</title> + + <para> + Web ãã¹ãã£ã³ã°ãããã¤ãã使ç¨ãã¦ãããï¼ãã¼ã«ã«ãã°ã¤ã³ã + Telnet ã SSH ã«ããï¼ãµã¼ãã¸ã®ç´æ¥ã¢ã¯ã»ã¹ãã§ããªãå ´åã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã使ç¨ãããã¨ã¯ã§ãã¾ããã + æ°ã®ãããWeb ãã¹ãã£ã³ã°ä¼ç¤¾ã§ããã°ããã使ç¨ããã PEAR ããã±ã¼ã¸ã¯ + ã¤ã³ã¹ãã¼ã«æ¸ã¿ã§ããå¯è½æ§ãããã¾ãã + ããããPEAR ãã¤ã³ã¹ãã¼ã«æ¸ã¿ã§ãªãã£ããã追å ã®ããã±ã¼ã¸ãå¿ è¦ãªå ´åã¯ã + ãããã¤ãã«é£çµ¡ãã¨ããããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ãä¸éã«é ¼ãã§ã¿ãã®ã + è¯ãã§ããããã¤ã³ã¹ãã¼ã«ãã¦ããããªãå ´åã¯ãä»ã®ãã¹ãã£ã³ã°ä¼ç¤¾ã + æ¢ã以å¤ã«ã<link linkend="installation.manually">æåã§ã¤ã³ã¹ãã¼ã« + </link>ãããã¨ãå¯è½ã§ãã + </para> + </sect2> + </sect1> <sect1 id="installation.cli"> - <title>ã³ãã³ãã©ã¤ã³ã¤ã³ã¹ãã¼ã©</title> - <titleabbrev>CLIã¤ã³ã¹ãã¼ã©</titleabbrev> + <title>ã³ãã³ãã©ã¤ã³ ã¤ã³ã¹ãã¼ã©</title> + <titleabbrev>CLI ã¤ã³ã¹ãã¼ã©</titleabbrev> <para> <warning id="installation.web.prerequesite"> - <title>ã¯ããã«</title> + <title>åæäºé </title> <para> 以ä¸ã®èª¬æã¯ãææ°çã® - <link linkend="installation.getting">PEARããã±ã¼ã¸ããã¼ã¸ã£ - </link>ãã¤ã³ã¹ãã¼ã«ããã¦ãããã¨ãåæã¨ãã¾ãã + <link linkend="installation.getting">ããã±ã¼ã¸ããã¼ã¸ã£</link> + ãã¤ã³ã¹ãã¼ã«ããã¦ãããã¨ãåæã¨ãã¾ãã </para> </warning> </para> <para> - ã³ãã³ãã©ã¤ã³ã¤ã³ã¹ãã¼ã©ã¯ãPEARããã±ã¼ã¸ãã·ã¹ãã ã«ã¤ã³ã¹ãã¼ - ã«ããæãç°¡åãªæ¹æ³ã§ãããã®ã¤ã³ã¹ãã¼ã©ã¯ãç°¡åãªHTTPæ¥ç¶ã«ãã - PEARããã±ã¼ã¸ãµã¼ãã«æ¥ç¶ããã·ã¹ãã ã«ããã±ã¼ã¸ããã¦ã³ãã¼ããã - 好ããªå ´æã«ã¤ã³ã¹ãã¼ã«ãã¾ãã + ã³ãã³ãã©ã¤ã³ ã¤ã³ã¹ãã¼ã©ã¯ãPEAR ããã±ã¼ã¸ãã·ã¹ãã ã«ã¤ã³ã¹ãã¼ã«ãã + æãç°¡åãªæ¹æ³ã§ãããã®ã¤ã³ã¹ãã¼ã©ã¯ãåç´ãª HTTP æ¥ç¶ã«ãã + PEAR ããã±ã¼ã¸ãµã¼ãã«æ¥ç¶ããã·ã¹ãã ã«ããã±ã¼ã¸ããã¦ã³ãã¼ããã + ä»»æã®å ´æã«ã¤ã³ã¹ãã¼ã«ãã¾ãã </para> - <sect2> <title>å®å ¨èªåã¤ã³ã¹ãã¼ã«</title> <para> @@ -153,30 +159,31 @@ </screen> </para> <para> - <package> ã¯ã(HTTP_Uploadã®ãããª)ã¤ã³ã¹ãã¼ã«ããããã±ã¼ - ã¸ã®ååã§ç½®ãæãã¦ä¸ãããå©ç¨å¯è½ãªããã±ã¼ã¸ã®ä¸è¦§ãè¦ãã«ã¯ã - <ulink url="http://pear.php.net/packages.php">PEARããã±ã¼ã¸ãã© - ã¦ã¶</ulink>ã¾ãã¯ä»¥ä¸ãå®è¡ãã¾ãã - </para> + <package> ã¯ãï¼HTTP_Uploadã®ããã«ï¼ã¤ã³ã¹ãã¼ã«ããããã±ã¼ã¸ã® + ååã§ç½®ãæãã¦ä¸ãããå©ç¨å¯è½ãªããã±ã¼ã¸ã®ä¸è¦§ãè¦ãã«ã¯ã + <ulink url="http://pear.php.net/packages.php">PEAR + ããã±ã¼ã¸ãã©ã¦ã¶</ulink>ãåç §ãããã以ä¸ã®ã³ãã³ããå®è¡ãã¾ãã + </para> <para> <screen> <userinput> -$ pear list-remote-packages +$ pear remote-list </userinput> </screen> </para> <para> - ãã®ã³ãã³ãã¯ãPEARã§å©ç¨å¯è½ãªå ¨ã¦ã®ããã±ã¼ã¸ãè¿ãã¾ãã + ãã®ã³ãã³ãã¯ããã®æç¹ã§ PEAR ã§å©ç¨å¯è½ãªãã¹ã¦ã®ããã±ã¼ã¸ã® + ãªã¹ããè¿ãã¾ãã </para> </sect2> <sect2> <title>åèªåã¤ã³ã¹ãã¼ã«</title> <para> - <ulink url="http://pear.php.net/">pear.php.net</ulink>ãããã¦ã³ - ãã¼ããããªãªã¼ã¹ããã±ã¼ã¸ãgzipå§ç¸®ãããtarã¢ã¼ã«ã¤ãã¨ãã¦æ - æãã¦ããå ´åããã¼ã«ã«ãªç°å¢ã§ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«å¯è½ã§ãã - ãããè¡ãã«ã¯ãã·ã§ã«ã§ä»¥ä¸ã®ãããªï¼è¡ãå®è¡ãã¦ä¸ããã + <ulink url="http://pear.php.net/">pear.php.net</ulink>ãã + ãªãªã¼ã¹ããã±ã¼ã¸ã gzip å§ç¸®ããã tar ã¢ã¼ã«ã¤ãã®å½¢å¼ã§ + ï¼æåã§ï¼ãã¦ã³ãã¼ããããã¼ã«ã«ãªç°å¢ã«ã¤ã³ã¹ãã¼ã«ã§ãã¾ãã + ã·ã§ã«ã§ä»¥ä¸ã®1è¡ãå®è¡ãã¦ä¸ããã </para> <para> <screen> @@ -186,20 +193,315 @@ </screen> </para> <para> - ãã®ã³ãã³ãã¯ãèªåçã«ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ãããªã³ã©ã¤ã³æ¥ - ç¶ãå¿ è¦ã¨ãã¾ããã<filename><file>.tgz</filename>ã¯ãã㦠- ã³ãã¼ãããããã¡ã¤ã«ã®ååã«ç½®ãæããå¿ è¦ãããã¾ãã + ãã®ã³ãã³ãã¯ãèªåçã«ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ãã¾ããã + ãã®éãªã³ã©ã¤ã³æ¥ç¶ãå¿ è¦ã¨ãã¾ããã + <filename><file>.tgz</filename>ã¯ããã¦ã³ãã¼ããããã¡ã¤ã«ã® + ååã«ç½®ãæãã¦ãã ããã </para> </sect2> + </sect1> + + <sect1 id="installation.shared"> + <title>å ±æãã¹ãã«ããã PEAR ã®ãã¼ã«ã«ã³ãã¼ã®ã¤ã³ã¹ãã¼ã«</title> + + <para> + ã·ã¹ãã å ±æã® PEAR ã¤ã³ã¹ãã¼ã«ã«ã¢ã¯ã»ã¹ã§ãããããªãããã¤ãã使ã£ã¦ãã + ã¦ã¼ã¶ã®æ¹ãããã£ãããã§ãããã + ããããã¤ã³ã¹ãã¼ã«ããã¦ããªãããã±ã¼ã¸ã使ãããå ´åãªã©ãã¯ããã + å¤ãã®å ´é¢ã§ãPEAR ã®ãã¼ã«ã«ã³ãã¼ãä½æããã¨ä¾¿å©ã§ãã + telnet/ssh ã«ããã·ã§ã«ã¢ã¯ã»ã¹ãéããæ¹æ³ã¨ãftp ã¢ã¯ã»ã¹ã ãã«ããæ¹æ³ + ã¨ã«ã¤ãã¦èª¬æãã¾ãã + </para> + <sect2 id="installation.shared.shell"> + <title>SSH ã使ç¨ããã¤ã³ã¹ãã¼ã«</title> + <para> + SSH ãéã㦠PEAR ã®ãã¼ã«ã«ã³ãã¼ãã¤ã³ã¹ãã¼ã«ããã«ã¯ã + 以ä¸ã®ã³ãã³ãã使ç¨ãã¾ãã + </para> + <para> + <screen> + <userinput> +$ pear -s -c ~/.pearrc -d doc_dir=~/pear/docs -d ext_dir=~/pear/ext \ + -d php_dir=~/pear/lib -d data_dir=~/pear/data -d test_dir=~/pear/tests \ + -d cache_dir=~/pear/cache -d bin_dir=~/pear/bin + </userinput> + </screen> + </para> + <para> + ãã¼ã«ã«ã®è¨å®ãã¡ã¤ã«ããã¼ã ãã£ã¬ã¯ããªã« <filename>.pearrc</filename> + ã¨ããååã§ä½æããã¾ãã + å ãã¦ãã¤ã³ã¹ãã¼ã«ããããã±ã¼ã¸ãä¿åããããã®ãã£ã¬ã¯ããªæ§é ã¯ã + ãã¼ã ãã£ã¬ã¯ããªã® <filename>pear</filename> ãã£ã¬ã¯ããªä¸ã« + ä½æãããããã«è¨å®ããã¾ãã + </para> + <para> + 次ã«ã.bashrcï¼ãããã¯ä»ã®ã¹ã¿ã¼ãã¢ãããã¡ã¤ã«ï¼ã«ã¦ã + ~/pear/bin ããã¹ã«è¿½å ãã以ä¸ã®ã³ãã³ããå®è¡ãã¾ãã + </para> + <para> + <screen> + <userinput> +$ pear -c ~/.pearrc install Archive_Tar PEAR Console_Getopt XML_RPC + </userinput> + </screen> + </para> + <para> + ã·ã¹ãã çã¨ã¯å¥ã«ãPEAR ã®ãã¼ã«ã«çãã¤ã³ã¹ãã¼ã«ããã¾ãã + ã¤ã³ã¹ãã¼ã«ããããã¡ã¤ã«ã使ç¨ããã«ã¯ãPEAR ããã±ã¼ã¸ã使ãã³ã¼ãã«ããã¦ã + PHP ã® include_path ã以ä¸ã®ããã«ãã¦ã»ãããã¦ãã ããã + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); +?> +]]> + </programlisting> + </para> + <para> + ãããã¯ãapache ã® <filename>.htaccess</filename> ãã¡ã¤ã«ã§ + php_value ã使ãæ¹æ³ãããã¾ãã + </para> + </sect2> + + <sect2 id="installation.shared.ftp"> + <title>ftp ã使ç¨ããã¤ã³ã¹ãã¼ã«</title> + <para> + ftp ã使ç¨ã㦠PEAR ã®ãã¼ã«ã«ã³ãã¼ãã¤ã³ã¹ãã¼ã«ããã«ã¯ã + ã¢ãããã¼ãæã«ãã¡ã¤ã«ã®ãã¼ããã·ã§ã³ãè¨å®ã§ãã ftp ã¯ã©ã¤ã¢ã³ãã + å¿ è¦ã§ãã + ã¾ãããµã¼ãã®ãã¦ã§ãã«å ¬éããã¦ããªãå ´æã«ãã£ã¬ã¯ããªãã²ã¨ã¤ä½æãã + 好ããªååãã¤ãã¾ããããã¦ãå ¨ã¦ã¼ã¶ããèªã¿æ¸ãå¯è½ (0777) ã¨ãã¾ãã + http://go-pear.org ããã¦ã³ãã¼ããã<filename>go-pear.php</filename> + ã¨ããååã§ä¿åãã¾ãã<filename>go-pear.php</filename> ãã + ã¦ã§ãããã¢ã¯ã»ã¹å¯è½ãªãã£ã¬ã¯ããªã«ã¢ãããã¼ããã¾ãã + ï¼ã»ãã¥ãªãã£ã¼ã®ããï¼ + <filename>.htaccess</filename> ã使ã£ã¦ <filename>go-pear.php</filename> + ãå«ããã£ã¬ã¯ããªã«ãã¹ã¯ã¼ãå¶éããããã®ãè¯ãã§ãããã + </para> + <para> + 次ã«ã<filename>go-pear.php</filename> ãã¡ã¤ã«ããã©ã¦ãºãã¾ãã + ã¦ã§ãã¢ãã¬ã¹ã http://www.example.comã§ã<filename>go-pear.php</filename> ã + <filename>public_html/install/go-pear.php</filename> ã«ç½®ããå ´åã + http://www.example.com/install/go-pear.php ã«ã¢ã¯ã»ã¹ãã¦ãã ããã + 表示ãããã¤ã³ã¹ãã¼ã«ã®ç»é¢ã«å¾ãã¾ãã + ã©ãã« PEAR ãã¤ã³ã¹ãã¼ã«ãããè¨ãããããããã»ã©ä½æãã + å ¨ã¦ã¼ã¶ããèªã¿æ¸ãå¯è½ã«ãããã£ã¬ã¯ããªãæå®ãã¾ãã + ã¾ããCLI ãã¼ã¸ã§ã³ã® PHP ã®ããããç¥ãããå¿ è¦ãããã¾ãã + PHP ã®ãããã¯ã以ä¸ã®ã¹ã¯ãªããã®åºåãåç §ãã¦ãã ããã + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +echo `which php`; +// if this does not work, also try echo PHP_BIN; +?> +]]> + </programlisting> + </para> + <para> + PEAR ãã¤ã³ã¹ãã¼ã«ãããããä»ã® PEAR ã¤ã³ã¹ãã¼ã«ã®æ¹æ³ã¨åæ§ã«ã + web çã®ã¤ã³ã¹ãã¼ã©ã使ã£ã¦ãããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ãã¢ããã°ã¬ã¼ãã + ã§ãã¾ãã + ã¤ã³ã¹ãã¼ã«ããã PEAR ã®ãã¡ã¤ã«ã使ãã«ã¯ãã¦ã§ããµã¤ãã®ã¹ã¯ãªããä¸ã§ + include path ãã»ããããå¿ è¦ãããã¾ãã + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); +?> +]]> + </programlisting> + </para> + </sect2> + </sect1> + + <sect1 id="installation.manually"> + <title>æåã¤ã³ã¹ãã¼ã«</title> + + <para> + ããã±ã¼ã¸ã®æåã¤ã³ã¹ãã¼ã«ã¯æ¨å¥¨ããã¾ããããããã + ãµã¤ããã·ã§ã«ã¢ã¯ã»ã¹ã®ç¡ããã¹ãã£ã³ã°ç°å¢ã®å ´åãèªåã®æ¹æ³ã§ã¯ + åé¡ãçããæ¹ãããã§ãããã + </para> + <para> + 以ä¸ã§ã¯ããµã¤ãã«ããã±ã¼ã¸ãæåã§ã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦ç¤ºãã¾ãã + ãã®ã¨ãããµã¤ãã®ããã¥ã¡ã³ãã®ã«ã¼ãã¯ã + <filename>/var/www/www.example.com/htdocs/</filename> ã¨ãã¾ãã + <filename>htdocs</filename> ã¨åãã¬ãã«ã«ã + <filename>includes</filename> ã¨ãããã£ã¬ã¯ããªãããã + ãã®ãã£ã¬ã¯ããªã¯ã<acronym>FTP</acronym> ã WebDAV ãã㯠+ ã¢ã¯ã»ã¹å¯è½ã§ããã<acronym>HTTP</acronym> ãã㯠+ ã¢ã¯ã»ã¹ä¸è½ã ã¨ãã¾ãã + </para> + <para> + ã¤ã³ã¹ãã¼ã«ã¯ãç°¡åãªããã¤ãã®ã¹ããããããªãã¾ãã + <orderedlist> + <listitem> + <simpara> + ããã±ã¼ã¸ããã¦ã³ãã¼ãããã + </simpara> + <para> + web ãã©ã¦ã¶ã使ã£ã¦ <ulink url="&url.pear;">PEAR ãã¼ã ãã¼ã¸</ulink> + ããããã±ã¼ã¸ããã¦ã³ãã¼ããã¾ãã + ãã¦ã³ãã¼ããããããã±ã¼ã¸æ å ±ã«ã¤ãã¦ã® <acronym>URL</acronym> + ãããããªãå ´åã¯ã<ulink url="&url.pear.package.browse;"> + ããã±ã¼ã¸ãã©ã¦ã¶</ulink>ã使ã£ã¦ç¾å¨å©ç¨å¯è½ãªããã±ã¼ã¸ã + 表示ããããã¨ãã§ãã¾ãã + </para> + </listitem> + <listitem> + <simpara> + ããã±ã¼ã¸ã®ã½ã¼ã¹ã³ã¼ããã¢ãããã¼ãããã + </simpara> + <para> + .tgz ãã¡ã¤ã«ããã¦ã³ãã¼ããããããã¼ã«ã«ãã·ã³ã®ãã³ãã©ãª ãã£ã¬ã¯ããªã« + 解åãã¾ããã½ã¼ã¹ã³ã¼ãã <acronym>FTP</acronym> ã WebDAV ç㧠+ <filename>/var/www/www.example.com/includes/</filename> ãã£ã¬ã¯ããªã« + ã¢ãããã¼ããã¾ããããã¨ã㯠Mail_Mime ã®ã³ã¼ãã¯ã + <filename>/var/www/www.example.com/includes/Mail/</filename> ã« + ç½®ãããã«ãã¾ãã + </para> + </listitem> + <listitem> + <simpara> + include_path ãã£ã¬ã¯ãã£ããè¨å®ããã + </simpara> + <para> + æå¾ã«ãã¢ãããã¼ãããã½ã¼ã¹ã³ã¼ãã®ããå ´æãå«ãããã«ã + PHP ã® include_path ãã£ã¬ã¯ãã£ããè¨å®ãã¾ãã + <filename>php.ini</filename> è¨å®ãã¡ã¤ã«ã«è§¦ããã¨ãã§ããå ´åã¯ã + <filename>/var/www/www.example.com/includes/</filename> ãã + ããã® include_path ãã£ã¬ã¯ãã£ãã«è¿½å ãã¾ãã + 触ããªãå ´åã¯ãPEAR ããã±ã¼ã¸ã使ãåã¹ã¯ãªããä¸ã§ + include_path ãã»ãããã¾ãã + </para> + <para> + <programlisting role="php"> +ini_set("include_path", '/var/www/www.example.com/includes/' . PATH_SEPARATOR . ini_get("include_path")); + </programlisting> + </para> + </listitem> + <listitem> + <simpara> + ã¤ã³ã¹ãã¼ã«ãæ¸ãã°ã以ä¸ã®ããã«ãã¦ãPEAR ããã±ã¼ã¸ã + 使ç¨ã§ããããã«ãªãã¾ãã + </simpara> + <para> + <programlisting role="php"> +require_once "Mail/Mime.php"; + +$mime = ... + </programlisting> + </para> + </listitem> + </orderedlist> + </para> + <para> + æåã¤ã³ã¹ãã¼ã«ã«ã¤ãã¦è³ªåãããå ´åã¯ã + <ulink url="&email.pear.general;">General ã¡ã¼ãªã³ã°ãªã¹ã</ulink>㧠+ 質åãã¦ãã ããã + </para> </sect1> <sect1 id="installation.cvs"> - <title>CVSã¤ã³ã¹ãã¼ã©</title> + <title>CVS ã¤ã³ã¹ãã¼ã©</title> <para> - CVSããPEARããã±ã¼ã¸ã®ææ°ã®éçºãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ããæ¹æ³ - ã説æãã¾ãã + ããã§ã¯ãCVS ããææ°ã®éçºçãã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦è¨è¿°ãã¾ãã + </para> + <para> + å®ç¨¼åç°å¢ã§ã¯ãCVS ããå¾ãããã±ã¼ã¸ãå®è¡ãããã¨ã¯æ§ããã¹ãã§ãã + CVS ãã¼ã¸ã§ã³ã¯é常ã®ãªãªã¼ã¹ã¨ç°ãªãã¾ããã¤ã¾ãã + <itemizedlist> + <listitem> + <simpara> + ã¡ã³ããä»ããã®æ´å©ãå¾ãããªãã + </simpara> + </listitem> + <listitem> + <simpara> + CVS ãã¼ã¸ã§ã³ã¯ãPEAR ã¤ã³ã¹ãã¼ã©ã®ã¢ããã°ã¬ã¼ãæ©è½ã + ç ´å£ãããã¨ãããã + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + CVS ããå¾ãããã±ã¼ã¸ã¯ã以ä¸ã®å ´åã«ã®ã¿ä½¿ç¨ããã¹ãã§ãã + <itemizedlist> + <listitem> + <simpara>ã¡ã³ãããå§ããå ´å</simpara> + </listitem> + <listitem> + <simpara>ããã±ã¼ã¸ã®éçºãæ´å©ãããå ´å</simpara> + </listitem> + <listitem> + <simpara>ãªãªã¼ã¹ããã¦ããªãæ©è½ãããããæ¬å½ã«å¿ è¦ã¨ãã¦ããå ´å</simpara> + </listitem> + </itemizedlist> + </para> + <para> + CVS ããããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ããå ´åãããã±ã¼ã¸ã®ã¡ã³ããã + æ°ãããªãªã¼ã¹ãä½æããã®ã¨åãã¹ããããåãå¿ è¦ãããã¾ãã + 以ä¸ã®ããããã®ã¹ãããã§åé¡ãããå ´åã¯ãæ¬ããã¥ã¢ã«ã® + <link linkend="guide-developers">ãããããã¼ãºã¬ã¤ã</link>ã + åç §ãã¦ãã ããã + </para> + <orderedlist> + <listitem> + <para> + ããã±ã¼ã¸ã <ulink url="http://www.php.net/anoncvs.php"> + http://www.php.net/anoncvs.php</ulink> ã«è¨è¿°ã®éãã« CVS ãã + ãã§ãã¯ã¢ã¦ãããã + </para> + <para> + ãã§ãã¯ã¢ã¦ããã¹ãã¢ã¸ã¥ã¼ã«ã¯ã<filename>pear/<packagename></filename> + ã¨ãªãã¾ãããã¨ãã°ã + <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>ã + </para> + </listitem> + <listitem> + <para> + <filename>package.xml</filename> ããã§ãã¯ããfileset è¦ç´ ã + å®éã®ãã¡ã¤ã«ã»ãã£ã¬ã¯ããªæ§é ã«ãã£ã¦ãããã©ãã調ã¹ãã + ããç°ãªããªããã¡ã³ããã«é£çµ¡ãã¨ãã<filename>package.xml</filename> ã + ã¢ãããã¼ãããããã«é ¼ãã§ã¿ã¦ãã ããã + </para> + </listitem> + <listitem> + <para> + æå¹ãªããã±ã¼ã¸ã®ã¢ã¼ã«ã¤ãã PEAR ã¤ã³ã¹ãã¼ã©ã使ã£ã¦ä½æããã + <command>pear package <path to package.xml></command> + </para> + </listitem> + <listitem> + <para> + 対象ã®ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«æ¸ã¿ã®æã¯ããã¼ã¸ã§ã³ã«é¢é£ããåé¡ã + é¿ããããã«åé¤ããã + <command>pear uninstall <package></command> + </para> + </listitem> + <listitem> + <para> + ããã±ã¼ã¸ã®ã¢ã¼ã«ã¤ããã¤ã³ã¹ãã¼ã«ããã + <command>pear install <package-file></command> + </para> + <para> + 以ä¸ã§ CVS ãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ããã¾ããã + </para> + </listitem> + </orderedlist> + <para> + ï¼CVS ãã¼ã¸ã§ã³ã¯ï¼ + ããã±ã¼ã¸ã®æ£å¼ãªãªã¼ã¹ã«ã§ããã ãæ©ãã¢ããã°ã¬ã¼ãããã¹ãã§ãã + æ£å¼ãªãªã¼ã¹ãã¤ã³ã¹ãã¼ã«ããåã«ã¯ããã¼ã¸ã§ã³ã«é¢é£ããåé¡ãé¿ããããã«ã + CVS ãã¼ã¸ã§ã³ãåé¤ãã¦ãã ããã </para> </sect1> http://cvs.php.net/diff.php/peardoc/ja/chapters/standards.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/ja/chapters/standards.xml diff -u peardoc/ja/chapters/standards.xml:1.1 peardoc/ja/chapters/standards.xml:1.2 --- peardoc/ja/chapters/standards.xml:1.1 Fri Apr 4 23:25:54 2003 +++ peardoc/ja/chapters/standards.xml Mon May 24 09:36:18 2004 @@ -1,37 +1,39 @@ <?xml encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.22 Maintainer: Status: ready --> +<!-- CREDITS: --> <chapter id="standards"> <title>æ¨æºã³ã¼ãã£ã³ã°è¦ç´</title> <note> <simpara> - PEARæ¨æºã³ã¼ãã£ã³ã°è¦ç´ã¯ãPEARã®å ¬å¼ãã£ã¹ããªãã¥ã¼ã·ã§ã³(PHP㨠- å ±ã«é å¸ããããPHP PEARã¬ãã¸ããªããã®ãã¦ã³ãã¼ãã«ããåå¾å¯è½) - ã«å«ã¾ããã³ã¼ãã«é©ç¨ããã¾ãã + PEAR æ¨æºã³ã¼ãã£ã³ã°è¦ç´ã¯ãPEAR ã®å ¬å¼ãã£ã¹ããªãã¥ã¼ã·ã§ã³ + ï¼PHP ã¨å ±ã«é å¸ãããããPHP PEAR ã¬ãã¸ããªãããã¦ã³ãã¼ãã«ãã + åå¾å¯è½ãªãã®ï¼ã«å«ã¾ããã³ã¼ãã«é©ç¨ããã¾ãã </simpara> </note> <sect1 id="standards.indenting"> <title>ã¤ã³ãã³ã</title> <para> - ã¿ãã§ã¯ãªãã空ç½4ã¤ã®ã¤ã³ãã³ãã使ç¨ãã¦ä¸ããã - PEARã³ã¼ããç·¨éããããã«Emacsã使ç¨ããå ´åãindent-tabs-modeã - nilã«è¨å®ããå¿ è¦ãããã¾ãã以ä¸ã«ããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã - Emacsãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã示ãã¾ãã(PHPãã¡ã¤ã«ãç·¨éãã - éã«ãããã³ã¼ã«ãããããã«ããå¿ è¦ãããã¾ã) + ã¿ãã§ã¯ãªããç©ºç½ 4 ã¤ã®ã¤ã³ãã³ãã使ç¨ãã¦ãã ããã + PEAR ã³ã¼ããç·¨éããããã« Emacs ã使ç¨ããå ´åãindent-tabs-mode ã + nil ã«è¨å®ããå¿ è¦ãããã¾ãã以ä¸ã«ããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã + Emacs ãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã示ãã¾ãï¼PHP ãã¡ã¤ã«ãç·¨éããéã« + ãããã³ã¼ã«ãããããã«ããå¿ è¦ãããã¾ãï¼ã <programlisting role="elisp"> <![CDATA[ (defun php-mode-hook () (setq tab-width 4 c-basic-offset 4 c-hanging-comment-ender-p nil - indent-tabs-mode - (not - (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name)) - (string-match "\.php$" (buffer-file-name)))))) + indent-tabs-mode + (not + (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name)) + (string-match "\.php$" (buffer-file-name)))))) ]]> </programlisting> </para> <para> - 以ä¸ã«åæ§ãªãã¨ãè¡ãvimã«ã¼ã«ã示ãã¾ãã + 以ä¸ã«ãåæ§ãªãã¨ãè¡ã vim ã«ã¼ã«ã示ãã¾ãã <programlisting role="vim"> <![CDATA[ set expandtab @@ -41,13 +43,19 @@ ]]> </programlisting> </para> + <para> + ãããåè§ 75-85 æåãã¨ã«æ¹è¡ãããã¨ãæ¨å¥¨ãã¾ãã + æ¹è¡ããæåã®æ¹æ³ã«ã¤ãã¦ã®æ¨æºã«ã¼ã«ã¯åå¨ãã¾ããã®ã§ãèªèº«ã®å¤æã§è¡ã£ã¦ + ãã ãããçåãããã°ã<ulink url="mailto:&email.pear.qa;"> + PEAR å質ä¿è¨¼ã¡ã¼ãªã³ã°ãªã¹ã</ulink>ã§è³ªåãã¦ãã ããã + </para> </sect1> <sect1 id="standards.control"> <title>å¶å¾¡æ§é </title> <para> - å¶å¾¡æ§é ã«ã¯ãif, for, while, switchçãå«ã¾ãã¾ãã以ä¸ã«ãæãè¤ - éãªå¶å¾¡æ§é ã§ããifæã®ä¾ã示ãã¾ãã + å¶å¾¡æ§é ã«ã¯ãif, for, while, switch çãããã¾ãã以ä¸ã«ã + æãè¤éãªå¶å¾¡æ§é ã§ãã if æã®ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ if ((condition1) || (condition2)) { @@ -65,9 +73,9 @@ éã«ç©ºç½ã1ã¤ç½®ãã¹ãã§ãã </simpara> <simpara> - æ§æçã«ä»»æã®å ´åã«ã常ã«æ³¢æ¬å¼§ã使ç¨ãããã¨ãå¼·ãæ¨å¥¨ããã¾ãã - æ³¢æ¬å¼§ãä»ãããã¨ã«ããå¯èªæ§ãåä¸ããæ°ããè¡ã追å ãããéã«è« - ççãªã¨ã©ã¼ãç´ãããå¯è½æ§ãæ¸å°ãã¾ãã + æ§æçã«ä»»æã®å ´åã«ãã常ã«æ³¢æ¬å¼§ã使ç¨ãããã¨ãå¼·ãæ¨å¥¨ããã¾ãã + æ³¢æ¬å¼§ãä»ãããã¨ã«ããå¯èªæ§ãåä¸ããæ°ããè¡ã追å ãããéã« + è«ççãªã¨ã©ã¼ãç´ãããå¯è½æ§ãæ¸å°ãã¾ãã </simpara> <para> switchæã®å ´åã¯æ¬¡ã®ããã«ãã¾ãã @@ -96,9 +104,9 @@ <title>é¢æ°ã³ã¼ã«</title> <para> é¢æ°ã¯ãé¢æ°åã¨éãæ¬å¼§ããã³æåã®ãã©ã¡ã¼ã¿ã®éã«ç©ºç½ãç½®ããã - ã«ã³ãã¨åãã©ã¡ã¼ã¿ã®éã«ç©ºç½ãç½®ããæå¾ã®ãã©ã¡ã¼ã¿ã¨éæ¬å¼§ãã - ã³ã»ãã³ãã³ã®éã«ç©ºç½ãç½®ããã«ã³ã¼ã«ãã¹ãã§ãã以ä¸ã«ä¾ã示ãã¾ - ãã + ã«ã³ãã¨åãã©ã¡ã¼ã¿ã®éã«ã¯ç©ºç½ãç½®ããæå¾ã®ãã©ã¡ã¼ã¿ã¨éæ¬å¼§ + ããã³ã»ãã³ãã³ã®éã«ã¯ç©ºç½ãç½®ããã«ã³ã¼ã«ãã¹ãã§ãã + 以ä¸ã«ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ $var = foo($bar, $baz, $quux); @@ -106,9 +114,9 @@ </programlisting> </para> <para> - ä¸è¨ã®ããã«ãé¢æ°ã®è¿ãå¤ãå¤æ°ã«ä»£å ¥ããéã«ä½¿ç¨ãããçå·ã®å·¦å³ - ã«ã¯ã空ç½ãï¼ã¤ç½®ãã¹ãã§ããç¸é¢ããä¸é£ã®ä»£å ¥æã®å ´åã«ã¯ãå¯èª - æ§ãåä¸ãããããã«ç©ºç½ãããå¤ãç½®ãã¦ãè¯ãã§ãããã + ä¸è¨ã®ããã«ãé¢æ°ã®è¿ãå¤ãå¤æ°ã«ä»£å ¥ããéã«ä½¿ç¨ãããçå·ã®å·¦å³ã«ã¯ã + 空ç½ãï¼ã¤ç½®ãã¹ãã§ããç¸é¢ããä¸é£ã®ä»£å ¥æã®å ´åã«ã¯ã + å¯èªæ§ãåä¸ãããããã«ç©ºç½ãããå¤ãç½®ãã¦ãè¯ãã§ãããã <programlisting role="php"> <![CDATA[ $short = foo($bar); @@ -121,7 +129,7 @@ <sect1 id="standards.funcdef"> <title>é¢æ°å®ç¾©</title> <para> - é¢æ°å®£è¨ã¯ã以ä¸ã®ãããª"one true brace"表è¨ã«åºã¥ãã¾ãã + é¢æ°å®£è¨ã¯ã以ä¸ã®ãã㪠<quote>one true brace</quote> 表è¨ã«åºã¥ãã¾ãã <programlisting role="php"> <![CDATA[ function fooFunction($arg1, $arg2 = '') @@ -136,8 +144,8 @@ </para> <para> ããã©ã«ãå¤ãæããå¼æ°ã¯å¼æ°ãªã¹ãã®çµããã«ç½®ãã¾ãã - ãã®é¢æ°ã¯å¦çãé©å½ã§ããå ´åã常ã«é¢æ°ããæå³ã®ããå¤ãè¿ããã - ã«ãã¦ä¸ããã以ä¸ã«ããé·ãä¾ã示ãã¾ãã + é¢æ°ã¯å¦çãé©å½ã§ããå ´åã常ã«é¢æ°ããæå³ã®ããå¤ãè¿ããã + ã«ãã¦ãã ããã以ä¸ã«ããé·ãä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ function connect(&$dsn, $persistent = false) @@ -162,18 +170,18 @@ <sect1 id="standards.comments"> <title>ã³ã¡ã³ã</title> <para> - ã¯ã©ã¹ã®ã¤ã³ã©ã¤ã³ããã¥ã¡ã³ãã¯ãJavadocã«ä¼¼ãPHPDocã®è¡¨è¨ã«åºã¥ - ãå¿ è¦ãããã¾ããPHPDocã«é¢ãããã詳細ãªæ å ±ã¯ã + ã¯ã©ã¹ã®ã¤ã³ã©ã¤ã³ããã¥ã¡ã³ãã¯ãJavadoc ã«ä¼¼ã PHPDoc ã®è¡¨è¨ã«åºã¥ã + å¿ è¦ãããã¾ããPHPDoc ã«é¢ãããã詳細ãªæ å ±ã¯ã <ulink url="&url.phpdoc;">&url.phpdoc;</ulink>ã«ããã¾ãã </para> <para> - ããã¥ã¡ã³ã以å¤ã®ã³ã¡ã³ãã¯ãå¼·ãæ¨å¥¨ããã¾ããä¸è¬çãªç®å®ã¨ãã¦ã + ããã¥ã¡ã³ã以å¤ã®ã³ã¡ã³ãããå¼·ãæ¨å¥¨ããã¾ããä¸è¬çãªç®å®ã¨ãã¦ã ã³ã¼ãã®ããã»ã¯ã·ã§ã³ãè¦ãæã«ãããã説æããããªããªãã¨æã㨠ããããå¦çå 容ãå¿ããåã«ã³ã¡ã³ãã追å ããå¿ è¦ãããã¾ãã </para> <para> - Cè¨èªå½¢å¼ã®(/* */)ã¨æ¨æºC++ã³ã¡ã³ã(//)ã®ã©ã¡ãã使ç¨å¯è½ã§ãã - Perl/shellå½¢å¼ã®ã³ã¡ã³ã(#)ã®ä½¿ç¨ã¯æ¨å¥¨ããã¾ããã + C è¨èªå½¢å¼ (/* */) ã¨æ¨æº C++ ã³ã¡ã³ã (//) ã®ã©ã¡ãã使ç¨å¯è½ã§ãã + Perl/shell å½¢å¼ã®ã³ã¡ã³ã (#) ã¯ä½¿ç¨ããã¹ãã§ã¯ããã¾ããã </para> </sect1> @@ -181,19 +189,19 @@ <title>ã³ã¼ãã®èªã¿è¾¼ã¿</title> <para> ããã¯ã©ã¹ãã¡ã¤ã«ãç¡æ¡ä»¶ã§èªã¿è¾¼ãå ´åã¯ã - <function>require_once</function>ã使ç¨ãã¦ä¸ãããããã¯ã©ã¹ãã¡ - ã¤ã«ãæ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´å(ä¾ãã°ãfactoryã¡ã½ãã)ã¯ã - <function>include_once</function>ã使ç¨ãã¦ä¸ããã - ãããã¯ã©ã¡ããã¯ã©ã¹ãã¡ã¤ã«ã1度ã ãèªã¿è¾¼ã¾ãããã¨ãä¿è¨¼ãã¾ - ãããããã¯ãåããã¡ã¤ã«ãªã¹ããå ±æãã¦ãããæ··ç¨ãããã¨ã«ã¤ã - ã¦å¿é ããå¿ è¦ã¯ããã¾ããã<function>require_once</function>ã§èª - ã¿è¾¼ã¾ãããã¡ã¤ã«ã¯ã<function>include_once</function>ã«ããå度 + <function>require_once</function> ã使ç¨ãã¦ãã ãããããã¯ã©ã¹ãã¡ã¤ã«ã + æ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´åï¼ä¾ãã°ãfactory ã¡ã½ããï¼ã¯ã + <function>include_once</function> ã使ç¨ãã¦ãã ããã + ã©ã¡ããã¯ã©ã¹ãã¡ã¤ã«ã1度ã ãèªã¿è¾¼ã¾ãããã¨ãä¿è¨¼ãã¾ãã + ãããã¯ãåããã¡ã¤ã«ãªã¹ããå ±æãã¦ãããæ··ç¨ãããã¨ã«ã¤ãã¦å¿é ãã + å¿ è¦ã¯ããã¾ããã<function>require_once</function> ã§èªã¿è¾¼ã¾ãã + ãã¡ã¤ã«ã¯ã<function>include_once</function> ã«ããå度 èªã¿è¾¼ã¾ãããã¨ã¯ããã¾ããã <note> <simpara> - <function>include_once</function>ããã³ - <function>require_once</function>ã¯å½ä»¤ã§ãããé¢æ°ã§ã¯ããã¾ã - ããèªã¿è¾¼ããã¡ã¤ã«åã®åå¾ã«æ¬å¼§ã¯ä¸è¦ã§ãã + <function>include_once</function> ããã³ + <function>require_once</function> ã¯å½ä»¤ã§ãããé¢æ°ã§ã¯ããã¾ããã + èªã¿è¾¼ããã¡ã¤ã«åã®åå¾ã«æ¬å¼§ã¯ä¸è¦ã§ãã </simpara> </note> </para> @@ -202,70 +210,67 @@ <sect1 id="standards.tags"> <title>PHPã³ã¼ãã¿ã°</title> <para> - PHPã³ã¼ããåºåããããã«<emphasis>ãç縮åã® - <literal><? ?></literal>ã§ã¯ãªãã常㫠- </emphasis><literal><?php ?></literal>ã使ç¨ãã¦ä¸ããã - PEAR対å¿ã®ããã«å¿ è¦ã§ããªãã¬ã¼ãã£ã³ã°ã·ã¹ãã ãè¨å®ãç°ãªãæ åµ - ã§PHPã³ã¼ããå°å ¥ããããã®æãäºææ§ã®é«ãæ¹æ³ã§ãããã¾ãã + PHPã³ã¼ããåºåããããã«ã¯ãç縮åã®<literal><? ?></literal>ã§ã¯ãªãã + <emphasis>常ã«</emphasis> <literal><?php ?></literal> ã使ç¨ãã¦ãã ããã + PEAR 対å¿ã®ããã«å¿ è¦ã§ããªãã¬ã¼ãã£ã³ã°ã·ã¹ãã ãè¨å®ãç°ãªãæ åµã§ + PHP ã³ã¼ããèªã¿è¾¼ãéã®æãäºææ§ã®é«ãæ¹æ³ã§ãããã¾ãã </para> </sect1> <sect1 id="standards.header"> <title>ãããã®ã³ã¡ã³ããããã¯</title> <para> - ã³ã¢PEARé å¸ãã¡ã¤ã«ã«ããå ¨ã¦ã®ã½ã¼ã¹ã³ã¼ããã¡ã¤ã«ã«ã¯ã以ä¸ã®ã³ - ã¡ã³ããããã¯ããããã¨ãã¦å«ã¾ãã¦ããå¿ è¦ãããã¾ãã + ã³ã¢ PEAR é å¸ãã¡ã¤ã«ã«ãããã¹ã¦ã®ã½ã¼ã¹ã³ã¼ããã¡ã¤ã«ã«ã¯ã + 以ä¸ã®ã³ã¡ã³ããããã¯ããããã¨ãã¦è¨è¼ããã¦ããå¿ è¦ãããã¾ãã <programlisting role="php"> -<![CDATA[ -/* vim: set expandtab tabstop=4 shiftwidth=4: */ +/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */ // +----------------------------------------------------------------------+ -// | PHP version 4.0 | +// | PHP version 4 | // +----------------------------------------------------------------------+ -// | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group | +// | Copyright (c) 1997-2004 The PHP Group | // +----------------------------------------------------------------------+ -// | This source file is subject to version 2.0 of the PHP license, | +// | This source file is subject to version 3.0 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | -// | available at through the world-wide-web at | -// | http://www.php.net/license/2_02.txt. | +// | available through the world-wide-web at the following url: | +// | http://www.php.net/license/3_0.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | license@php.net so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ -// | Authors: Original Author <author@example.com> | -// | Your Name <you@example.com> | +// | Authors: Original Author <author@example.com> | +// | Your Name <you@example.com> | // +----------------------------------------------------------------------+ // -// $Id: standards.xml,v 1.1 2003/04/05 04:25:54 hirokawa Exp $ -]]> +// $Id:$ </programlisting> </para> <para> - ããã½ã¼ã¹ãã¡ã¤ã«ã®ä½è ã®ãªã¹ãã«æ°ããªã³ã¼ãæä¾è ã®ååã追å ã - ãã¹ããã©ãããå®ç¾©ããæ確ãªè¦åã¯ããã¾ãããä¸è¬çã«ãä½è ã«å± - ããå¤æ´ç¹ã¯ã"æ¬è³ªçãª"åé¡ã«å±ãã(10%ãã20%ã®ã³ã¼ãå¤æ´ãæå³ - ãã¾ã)å¿ è¦ãããã¾ããé¢æ°ã®æ¸æããæ°ããªãã¸ãã¯ãæä¾ããå ´å - ã«ã¯ãä¾å¤ãããå ´åãããã¾ãã + ã½ã¼ã¹ãã¡ã¤ã«ã®ä½è ãªã¹ãã«æ°ããªã³ã¼ãæä¾è ã®ååã追å ããã¹ããã©ãã + ãå®ç¾©ããæ確ãªè¦åã¯ããã¾ãããä¸è¬çã«ã¯ã + <quote>ç¸å½ãª</quote>é¨åï¼10%ãã20%ã®ã³ã¼ãå¤æ´ãæå³ãã¾ãï¼ã®å¤æ´ã + è¡ã£ãå ´åã«ãä½è ã¨ããããã§ãã + é¢æ°ã®ãªã©ã¤ããæ°ããªãã¸ãã¯ã®æä¾ã®å ´åã«ã¯ãä¾å¤ããããã¾ãã </para> <para> ç°¡åãªã³ã¼ãã®æ´çããã°ä¿®æ£ã¯ãä½è ã®ãªã¹ãã«æ°ãã«å人ã追å ãã ã¾ã§ã®çç±ã«ã¯ãªãã¾ããã </para> <para> - ã³ã¢PEARãªãã¸ããªã«ãªããã¡ã¤ã«ã«ã¯ãä¼¼ããããªèä½æ¨©ãã©ã¤ã»ã³ã¹ã - ä½è ãè¨è¿°ãããããã¯ãå«ãå¿ è¦ãããã¾ããå ¨ã¦ã®ãã¡ã¤ã«ã«ã¯ãçµ± - ä¸ããmodelineã³ã¡ã³ããå«ãã¹ãã§ã + ã³ã¢ PEAR ãªãã¸ããªã«ãªããã¡ã¤ã«ã«ã¤ãã¦ããèä½æ¨©ã»ã©ã¤ã»ã³ã¹ã» + ä½è ãè¨è¿°ããåæ§ã®ãããã¯ãå«ãå¿ è¦ãããã¾ãããã¹ã¦ã®ãã¡ã¤ã«ã«ã¯ã + çµ±ä¸ããmodelineã³ã¡ã³ããå«ãã¹ãã§ã </para> </sect1> <sect1 id="standards.cvs"> <title>CVSã®ä½¿ç¨</title> <simpara> - æ¬ç¯ã¯ãcvs.php.netã«ããCVSã使ç¨ããããã±ã¼ã¸ã«ã®ã¿é©ç¨ããã¾ãã + æ¬ç¯ã¯ãcvs.php.net ã® CVS ã使ç¨ããããã±ã¼ã¸ã«ã®ã¿é©ç¨ããã¾ãã </simpara> <para> - åãã¡ã¤ã«ã«ãCVSã®ãã¼ã¯ã¼ã $Id$ ãå«ãã¦ä¸ããã - åãã¡ã¤ã«ãç·¨éããéãã¾ã ãªãå ´åã«ã¯ãã®ã¿ã°ã追å ãã¦ä¸ããã - (ã¾ãã¯ã"Last Modified:"ã®ãããªæ¢åã®å½¢å¼ãç½®æãã¦ä¸ãã) + åãã¡ã¤ã«ã«ãCVS ã®ãã¼ã¯ã¼ã $Id$ ãå«ãã¦ãã ããã + åãã¡ã¤ã«ãç·¨éããéãã¾ã ãªãå ´åã«ã¯ãã®ã¿ã°ã追å ãã¦ãã ãã + ï¼ã¾ãã¯ã<quote>Last Modified:</quote>ã®ãããªæ¢åã®å½¢å¼ãç½®æãã¦ãã ããï¼ã <!-- <note> <simpara> @@ -278,22 +283,22 @@ --> </para> <para> - æ¬ç¯ã®æ®ãã®é¨åã¯ãèªè ãCVSã¿ã°ããã³ãã©ã³ãã«é¢ããåºæ¬çãªç¥ - èãæãã¦ãããã¨ãåå ¤ã¨ãã¾ãã + æ¬ç¯ã®æ®ãã®é¨åã¯ãèªè ã CVS ã¿ã°ããã³ãã©ã³ãã«é¢ããåºæ¬ç㪠+ ç¥èãæãã¦ãããã¨ãåå ¤ã¨ãã¾ãã </para> <para> - CVSã¿ã°ã¯ãæå®ãããªãªã¼ã¹ã«å±ããããã±ã¼ã¸ã®ãã¡ã¤ã«ã®ãªãã¸ã§ - ã³ã示ãã©ãã«ã¨ãã¦ä½¿ç¨ããã¾ãã以ä¸ã«å¿ é åã³æ¨å¥¨ãããCVSã¿ã° - ã®ãªã¹ãã示ãã¾ãã + CVS ã¿ã°ã¯ãæå®ãããªãªã¼ã¹ã«å±ããããã±ã¼ã¸ã®ãã¡ã¤ã«ã®ãªãã¸ã§ã³ã + 示ãã©ãã«ã¨ãã¦ä½¿ç¨ããã¾ãã以ä¸ã«å¿ é åã³æ¨å¥¨ããã CVS + ã¿ã° ã®ãªã¹ãã示ãã¾ãã <variablelist> <varlistentry> <term>RELEASE_<replaceable>n_n</replaceable></term> <listitem> <simpara> - (å¿ é ) ãªãªã¼ã¹ç¨ã¿ã°ã¨ãã¦ä½¿ç¨ããã¾ããããã使ç¨ããªãå ´åã - ãªãªã¼ã¹æç¹ã®ç¶æ ã§CVSãµã¼ãããããã±ã¼ã¸ãåå¾ããæ段ã㪠- ããªãã¾ãã + ï¼å¿ é ï¼ãªãªã¼ã¹ç¨ã¿ã°ã¨ãã¦ä½¿ç¨ããã¾ããããã使ç¨ããªãå ´åã + ãªãªã¼ã¹æç¹ã®ç¶æ 㧠CVS ãµã¼ãããããã±ã¼ã¸ãåå¾ããæ段ã + ãªããªãã¾ãã </simpara> </listitem> </varlistentry> @@ -301,11 +306,10 @@ <term>QA_<replaceable>n_n</replaceable></term> <listitem> <simpara> - (ãã©ã³ã, ãªãã·ã§ã³) ãªãªã¼ã¹åã«ãªãªã¼ã¹ä¾¯è£çãå ¬éããå¿ - è¦ãããã¨èããå ´åã«ã¯ããªãªã¼ã¹çãåå²ããå®éã®ãªãªã¼ã¹å - ã«éè¦ãªä¿®æ£ã®ã¿ãé©ç¨ãããããã«ããã¨ããã®ã¯è¯ãèãã§ãã - ãã®éã«ãé常ã®éçºã¯ã¡ã¤ã³ãã©ã³ã¯ã«ããã¦ç¶ç¶ãããã¨ãå¯è½ - ã§ãã + ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ãªãªã¼ã¹åã«ãªãªã¼ã¹ä¾¯è£çãå ¬éããå¿ è¦ã + ããã¨èããå ´åã«ã¯ããªãªã¼ã¹çãåå²ããå®éã®ãªãªã¼ã¹åã«éè¦ãª + ä¿®æ£ã®ã¿ãé©ç¨ãããããã«ããã¨ããã®ã¯è¯ãèãã§ãã + ãã®éã«ããé常ã®éçºã¯ã¡ã¤ã³ãã©ã³ã¯ã«ããã¦ç¶ç¶ãããã¨ãå¯è½ã§ãã </simpara> </listitem> </varlistentry> @@ -313,33 +317,33 @@ <term>MAINT_<replaceable>n_n</replaceable></term> <listitem> <simpara> - (ãã©ã³ã, ãªãã·ã§ã³) (ä¾ãã°1.2ã®å¾ã«1.2.1ã¨ãã£ã)"ãã¤ã¯ã - ãªãªã¼ã¹"ãè¡ãéã«ãã¡ã¤ã³ã®éçºãã©ã³ã¯ãé常ã«æ´»æºã§ãã㤠- ã¯ããªãªã¼ã¹éã§å ããªå¤æ´ã®ã¿ãè¡ãããå ´åã«ããã©ã³ããä½¿ç¨ - ãããã¨ãã§ãã¾ãã + ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ï¼ä¾ãã°1.2ã®å¾ã«1.2.1ã¨ãã£ãï¼ + <quote>ãã¤ã¯ããªãªã¼ã¹</quote>ãè¡ãéã«ã + ã¡ã¤ã³ã®éçºãã©ã³ã¯ãé常ã«æ´»æºã§ããã¤ã¯ããªãªã¼ã¹é㧠+ å ããªå¤æ´ã®ã¿ãè¡ãããå ´åã«ããã©ã³ãã使ç¨ãããã¨ãã§ãã¾ãã </simpara> </listitem> </varlistentry> </variablelist> - RELEASEã¿ã°ã®ã¿ãå¿ é ã§ãæ®ãã¯æç¨ãªãã®ãæ¨å¥¨ãã¦ããã ãã§ãã + RELEASE ã¿ã°ã®ã¿ãå¿ é ã§ãæ®ãã¯æç¨ãªãã®ãæ¨å¥¨ãã¦ããã ãã§ãã </para> <para> - 以ä¸ã¯ã"Money_Fast"ããã±ã¼ã¸ã«1.2ãªãªã¼ã¹ã¿ã°ãä»ããæ¹æ³ã示ã - ãã®ã§ãã + 以ä¸ã¯ã<classname>Money_Fast</classname>ããã±ã¼ã¸ã« + 1.2 ãªãªã¼ã¹ã¿ã°ãä»ããæ¹æ³ã示ããã®ã§ãã <informalexample> <screen><prompt>$ </prompt><command>cd pear/Money_Fast</command> <prompt>$ </prompt><command>cvs tag RELEASE_1_2</command> <computeroutput>T Fast.php T README T package.xml - </computeroutput> - </screen> +</computeroutput> +</screen> </informalexample> - ããã«ãããPEAR Webãµã¤ãã§ãªãªã¼ã¹æé ã®æ®ããè¡ããã¨ãã§ããã - ãã«ãªãã¾ãã + ããã«ãããPEAR Web ãµã¤ãã§ãªãªã¼ã¹æé ã®æ®ããè¡ããã¨ã + ã§ããããã«ãªãã¾ãã </para> <para> - 以ä¸ã¯ãQAãã©ã³ããä½æããæ¹æ³ã示ãä¾ã§ãã + 以ä¸ã¯ãQA ãã©ã³ããä½æããæ¹æ³ã®ä¾ã§ãã <informalexample> <screen><prompt>$ </prompt><command>cvs tag QA_2_0_BP</command> ... @@ -350,17 +354,20 @@ <prompt>$ </prompt><command>cvs tag RELEASE_2_0</command> </screen> </informalexample> - "QA_2_0_BP"ã¿ã°ã¯"åå²ç¹"ã¿ã°ã§ãã¿ã°ã®éå§ç¹ã§ãããã®ãããªåå² - ç¹ããCVSãã©ã³ããéå§ããã®ã¯å¸¸ã«è¯ãèãã§ãã - MAINTãã©ã³ãã¯ãã®åå²ç¹ã¨åæ§ã«RELEASEã¿ã°ã使ç¨ãããã¨ãå¯è½ã§ - ãã + <literal>QA_2_0_0_BP</literal>ã¿ã°ã¯ã<quote>åå²ç¹ (branch point)</quote> + ã¿ã°ã§ãã¿ã°ã®éå§ç¹ã§ãããã®ãããªåå²ç¹ãã CVS ãã©ã³ããéå§ããã®ã¯ + 常ã«è¯ãèãã§ããMAINT ãã©ã³ãã¯ããã®åå²ç¹ã¨åæ§ã« RELEASE + ã¿ã°ã使ç¨ãããã¨ãå¯è½ã§ãã </para> </sect1> <sect1 id="standards.exampleurls"> - <title>URLã®ä¾</title> + <title> URL ã®ä¾</title> <para> - å ¨ã¦ã®URLã®ä¾ã«ã¤ãã¦RFC 2606ã«åºã¥ãURLã使ç¨ãã¦ä¸ããã + URL ã®ä¾ã«ã¯ã<literal>example.com</literal> ããã³ + <literal>example.org</literal>, <literal>example.net</literal> + ã使ç¨ãã¦ãã ãããé»åã¡ã¼ã«ã¢ãã¬ã¹ã¯ã + <ulink url="&url.rfc;2606">RFC 2606</ulink> ãåç §ãã¦ãã ããã </para> </sect1> @@ -369,19 +376,18 @@ <sect2> <title>ã¯ã©ã¹</title> <para> - ã¯ã©ã¹ã¯ãå 容ãåããååãæå®ããå¿ è¦ãããã¾ããå¯è½ãªãã°ç - ç¥ããååã使ç¨ãããã¨ã¯é¿ãã¦ä¸ãããã¯ã©ã¹åã¯ã常ã«å¤§æå㧠- å§ã¾ãå¿ è¦ãããã¾ããPEARã¯ã©ã¹é層ã¯ãã¯ã©ã¹åã«ãåæ ãããå - é層ã¬ãã«ã¯ãã¢ã³ãã¼ã¹ã³ã¢1ã¤ã§åºåããã¾ãã - è¯ãã¯ã©ã¹åã®ä¾ã以ä¸ã«ç¤ºãã¾ãã + ã¯ã©ã¹ã¯ãå 容ãåããååãæå®ããå¿ è¦ãããã¾ããå¯è½ãªãã°ç¥èªã® + 使ç¨ã¯é¿ãã¦ãã ãããã¯ã©ã¹åã¯ã常ã«å¤§æåã§å§ã¾ãå¿ è¦ãããã¾ãã + PEAR ã¯ã©ã¹é層ã¯ãã¯ã©ã¹åã«ãåæ ãããåé層ã¬ãã«ã¯ã + ã¢ã³ãã¼ã¹ã³ã¢1ã¤ã§åºåããã¾ããè¯ãã¯ã©ã¹åã®ä¾ã以ä¸ã«ç¤ºãã¾ãã <informaltable> <tgroup cols="3"> <tbody> - <row> - <entry><simpara>Log</simpara></entry> - <entry><simpara>Net_Finger</simpara></entry> - <entry><simpara>HTML_Upload_Error</simpara></entry> - </row> + <row> + <entry><simpara>Log</simpara></entry> + <entry><simpara>Net_Finger</simpara></entry> + <entry><simpara>HTML_Upload_Error</simpara></entry> + </row> </tbody> </tgroup> </informaltable> @@ -390,38 +396,39 @@ <sect2> <title>é¢æ°ã¨ã¡ã½ãã</title> <para> - é¢æ°ã¨ã¡ã½ããã¯ã"studly caps"å½¢å¼("bumpy case"ã¾ãã¯"camel - caps"ã¨ãå¼ã°ãã¾ã)ã使ç¨ãã¦ååãä»ããå¿ è¦ãããã¾ãã - é¢æ°ã¯ãããã±ã¼ã¸éã®ååã®è¡çªãé¿ããããã«ããã±ã¼ã¸åãæ¥é - è¾ã¨ãã¦å ããå¿ è¦ãããã¾ãã(æ¥é è¾ã®å¾ã®)ååã®æåã®æåã¯ã - å°æåã§ãæ°ããåèªãå§ããéã®åå é æåã¯å¤§æåã¨ãã¾ããä¾ã - ããã¤ã以ä¸ã«ç¤ºãã¾ãã + é¢æ°ã¨ã¡ã½ããã¯ã<quote>studly caps</quote>å½¢å¼ + ï¼<quote>bumpy case</quote> ã¾ã㯠<quote>camel caps</quote> ã¨ãå¼ã°ãã¾ãï¼ + ã使ç¨ãã¦ååãä»ããå¿ è¦ãããã¾ãã + é¢æ°ã¯ãããã±ã¼ã¸éã®ååã®è¡çªãé¿ããããã«ããã±ã¼ã¸åãæ¥é è¾ã¨ã㦠+ å ããå¿ è¦ãããã¾ããï¼æ¥é è¾ã®å¾ã®ï¼ååã®æåã®æåã¯å°æåã§ã + æ°ããåèªãå§ããéã®åå é æåã¯å¤§æåã¨ãã¾ãã + ä¾ãããã¤ã以ä¸ã«ç¤ºãã¾ãã <informaltable> <tgroup cols="4"> <tbody> - <row> - <entry><simpara>connect()</simpara></entry> - <entry><simpara>getData()</simpara></entry> - <entry><simpara>buildSomeWidget()</simpara></entry> - <entry><simpara>XML_RPC_serializeData()</simpara></entry> - </row> + <row> + <entry><simpara>connect()</simpara></entry> + <entry><simpara>getData()</simpara></entry> + <entry><simpara>buildSomeWidget()</simpara></entry> + <entry><simpara>XML_RPC_serializeData()</simpara></entry> + </row> </tbody> </tgroup> </informaltable> </para> <para> - ãã©ã¤ãã¼ãã¯ã©ã¹ã¡ã³ã(ãã®ã¯ã©ã¹ã¡ã³ãã¯å®£è¨ãããåãã¯ã©ã¹ã® - å é¨ããã®ã¿ä½¿ç¨ããããã¨ãæå³ãã¦ãã¾ããPHPã¯ãã©ã¤ãã¼ãåå - 空éãã¾ã ãµãã¼ããã¦ãã¾ãã)ã¯ãã¢ã³ãã¼ã¹ã³ã¢1ã¤ãåã«ä»ãã¾ - ããä¾ã以ä¸ã«ç¤ºãã¾ãã + ãã©ã¤ãã¼ããªã¯ã©ã¹ã¡ã³ãï¼å®£è¨ãããåãã¯ã©ã¹ã®å é¨ããã ãã®ä½¿ç¨ã + æå³ããã¯ã©ã¹ã¡ã³ãã + PHP ã¯ããã©ã¤ãã¼ãåå空éãã¾ã ãµãã¼ããã¦ãã¾ãããï¼ã¯ã + ã¢ã³ãã¼ã¹ã³ã¢ 1 ã¤ãåã«ä»ãã¾ããä¾ã以ä¸ã«ç¤ºãã¾ãã <informaltable> <tgroup cols="3"> <tbody> - <row> - <entry><simpara>_sort()</simpara></entry> - <entry><simpara>_initTree()</simpara></entry> - <entry><simpara>$this->_status</simpara></entry> - </row> + <row> + <entry><simpara>_sort()</simpara></entry> + <entry><simpara>_initTree()</simpara></entry> + <entry><simpara>$this->_status</simpara></entry> + </row> </tbody> </tgroup> </informaltable> @@ -430,10 +437,10 @@ <sect2> <title>å®æ°</title> <para> - å®æ°ã¯å¸¸ã«å ¨ã¦å¤§æåã§è¨è¿°ããåèªãåºåãéã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã - 使ç¨ãã¾ãã使ç¨ãããã¯ã©ã¹/ããã±ã¼ã¸ã大æåã§è¡¨ããååãåç½® - å®æ°åã¨ãã¦ä½¿ç¨ãã¾ããä¾ãã°ã<literal>DB::</literal>ããã±ã¼ã¸ - ã§ä½¿ç¨ãããå®æ°ã¯å ¨ã¦"<literal>DB_</literal>"ã§å§ã¾ãã¾ãã + å®æ°ã¯ã常ã«ãã¹ã¦å¤§æåã§è¨è¿°ããåèªãåºåãéã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã + 使ç¨ãã¾ãã使ç¨ãããã¯ã©ã¹ï¼ããã±ã¼ã¸ã大æåã§è¡¨ããååã + å®æ°ã®æ¥é è¾ã¨ãã¦ä½¿ç¨ãã¾ããä¾ãã°ã<literal>DB::</literal> ããã±ã¼ã¸ + ã§ä½¿ç¨ãããå®æ°ã¯ãã¹ã¦<literal>DB_</literal>ã§å§ã¾ãã¾ãã </para> </sect2> <sect2> @@ -441,11 +448,235 @@ <para> ããã±ã¼ã¸ã§ã°ãã¼ãã«å¤æ°ãå®ç¾©ããå¿ è¦ãããå ´åããã®ååã¯ã ã¢ã³ãã¼ã¹ã³ã¢ã§å§ã¾ãããã®å¾ã«ããã±ã¼ã¸åã¨å¥ã®ã¢ã³ãã¼ã¹ã³ã¢ - ãç¶ãããã«ããå¿ è¦ãããã¾ããä¾ãã°ãPEARããã±ã¼ã¸ã¯ã - $_PEAR_destructor_object_listã¨ããååã®ã°ãã¼ãã«å¤æ°ã使ç¨ãã¾ - ãã + ãç¶ãããã«ããå¿ è¦ãããã¾ããä¾ãã°ãPEAR ããã±ã¼ã¸ã¯ã + $_PEAR_destructor_object_list ã¨ããååã®ã°ãã¼ãã«å¤æ°ã使ç¨ãã¾ãã </para> </sect2> + </sect1> + + <sect1 id="standards.sample"> + <title>ãµã³ãã«ãã¡ã¤ã«</title> + <para> + ãµã³ãã«ä¸ã® <command>Id</command> ã¨ãã CVS ãã¼ã¯ã¼ãã¯ãä»èªãã§ãã + ããã¥ã¡ã³ãã®ä½æã«ä½¿ããããã¡ã¤ã«ã«é¢ãããã¼ã¿ãä¿æãã¦ãã¾ãã + èªèº«ã® PEAR ã¹ã¯ãªãããä½æããå ´åã¯ã空ã®ãã¼ã¯ã¼ã + <literal>$Id:$</literal> ã«ç½®ãæãã¦ãã ããã + </para> + <para> + ä¸ä¸å·¦å³æ¹åã®ã¹ãã¼ã¹ã«ã注æãã¦ãã ããããããããè¦ç´ã®ä¸é¨ã§ãã + </para> + <para> + <quote>æãç³ã¿ãã¼ã« (fold markers)</quote> + ï¼<literal>// {{{</literal> ããã³ <literal>// }}}</literal>ï¼ + ã¯ããªãã·ã§ã³ã§ããæãç³ã¿ãã¼ã«ã使ããªãå ´åã¯ã + <literal>foldmethod=marker</literal> ã vim ã®ãããããåé¤ãã¦ãã ããã + </para> + <para> + ãµã³ãã«ã«ã¯ãDocblock ã³ã¡ã³ãã®æ¸ãæ¹ã®å¤ãã®è©³ç´°ãè¨è¼ããã¦ãã¾ãã + ãããã®æ示ã«å¾ããã¨ã¯ã2 ã¤ã®æå³ã§éè¦ã§ãã第1ã¯ãdocblocks 㯠+ èªã¿ããããã³ã¼ããä½ã®åä½ãããããã¦ã¼ã¶ãéçºè ããã°ããç解ã§ãã¾ãã + 第2ã«ãPEAR ã® WEB ãµã¤ãã§ã¯ãããã±ã¼ã¸ã®åãªãªã¼ã¹ã«å¯¾ã㦠+ phpDocumentor ã«ããçæãããããã¥ã¡ã³ããæ²è¼ãã¦ãã¾ãã + WEB ãµã¤ãä¸ã® API ããã¥ã¡ã³ããå½¹ç«ã¤ãã®ã«ããã«ã¯ã + ãã¡ãã¨ã³ã¡ã³ããè¨è¿°ããå¿ è¦ãããã¾ãã + </para> + <para> + <programlisting role="php"> + <![CDATA[ +<?php +/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4 foldmethod=marker: */ +// +----------------------------------------------------------------------+ +// | PHP version 4 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 1997-2004 The PHP Group | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 3.0 of the PHP license, | +// | that is bundled with this package in the file LICENSE, and is | +// | available through the world-wide-web at the following url: | +// | http://www.php.net/license/3_0.txt. | +// | If you did not receive a copy of the PHP license and are unable to | +// | obtain it through the world-wide-web, please send a note to | +// | license@php.net so we can mail you a copy immediately. | +// +----------------------------------------------------------------------+ +// | Authors: Original Author <author@example.com> | +// | Your Name <you@example.com> | +// +----------------------------------------------------------------------+ +// +// $Id: standards.xml,v 1.2 2004/05/24 13:36:18 haruki Exp $ + +require_once 'PEAR.php'; + +// {{{ constants + +/** + * This is a "Docblock Comment," also known as a "docblock." The class' + * docblock, below, contains a complete description of how to write these. + */ +define('NET_SAMPLE_OK', 1); + +// }}} +// {{{ Net_Sample + +/** + * An example of how to write code to PEAR's standards + * + * Docblock comments start with "/**" at the top. Notice how the "/" + * lines up with the normal indenting and the asterisks on subsequent rows + * are in line with the first asterisk. The last line of comment text + * should be immediately followed on the next line by the closing asterisk + * and slash and then the item you are commenting on should be on the next + * line below that. Don't add extra lines. Please put a blank line + * between paragraphs as well as between the end of the description and + * the start of the @tags. Wrap comments before 80 columns in order to + * ease readability for a wide variety of users. + * + * Docblocks can only be used for programming constructs which allow them + * (classes, properties, methods, defines, includes, globals). See the + * phpDocumentor documentation for more information. + * http://phpdoc.org/docs/HTMLSmartyConverter/default/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html + * + * The Javadoc Style Guide is an excellent resource for figuring out + * how to say what needs to be said in docblock comments. Much of what is + * written here is a summary of what is found there, though there are some + * cases where what's said here overrides what is said there. + * http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#styleguide + * + * The first line of any docblock is the summary. Make them one short + * sentence, without a period at the end. Summaries for classes, properties + * and constants should omit the subject and simply state the object, + * because they are describing things rather than actions or behaviors. + * + * Below are the tags commonly used for classes. @category through @access + * are required. The remainder should only be used when necessary. + * Please use them in the order they appear here. phpDocumentor has + * several other tags available, feel free to use them. + * + * @category categoryname + * @package packagename + * @author Original Author <author@example.com> + * @version $Id: standards.xml,v 1.2 2004/05/24 13:36:18 haruki Exp $ + * @access public + * @see NetOther, Net_Sample::Net_Sample() + * @since Class available since Release 1.2.0 + * @deprecated Class deprecated in Release 2.0.0 + */ +class Net_Sample +{ + // {{{ properties + + /** + * The status of foo's universe + * + * Potential values are 'good', 'fair', 'poor' and 'unknown'. + * + * @var string + */ + var $foo = 'unknown'; + + // }}} + // {{{ setFoo() + + /** + * Registers the status of foo's universe + * + * Summaries for methods should use 3rd person declarative rather + * than 2nd person imperative, begining with a verb phrase. + * + * Summaries should add description beyond the method's name. The + * best method names are "self-documenting", meaning they tell you + * basically what the method does. If the summary merely repeats + * the method name in sentence form, it is not providing more + * information. + * + * Summary Examples: + * + Sets the label (preferred) + * + Set the label (avoid) + * + This method sets the label (avoid) + * + * Below are the tags commonly used for methods. A @param tag is + * required for each parameter the method has. The @return and + * @access tags are mandatory. The @throws tag is required if the + * method uses exceptions. @static is required if the method can + * be called statically. The remainder should only be used when + * necessary. Please use them in the order they appear here. + * phpDocumentor has several other tags available, feel free to use + * them. + * + * The @param tag contains the data type, then the parameter's + * name, followed by a description. By convention, the first noun in + * the description is the data type of the parameter. Articles like + * "a", "an", and "the" can precede the noun. The descriptions + * should start with a phrase. If further description is necessary, + * follow with sentences. Having two spaces between the name and the + * description aids readability. + * + * When writing a phrase, do not capitalize and do not end with a + * period: + * + the string to be tested + * + * When writing a phrase followed by a sentence, do not capitalize the + * phrase, but end it with a period to distinguish it from the start + * of the next sentence: + * + the string to be tested. Must use UTF-8 encoding. + * + * Return tags should contain the data type then a description of + * the data returned. The data type can be any of PHP's data types + * (int, float, bool, string, array, object, resource, mixed) + * and should contain the type primarily returned. For example, if + * a method returns an object when things work correctly but false + * when an error happens, say 'object' rather than 'mixed.' Use + * 'void' if nothing is returned. + * + * @param string $arg1 the string to quote + * @param int $arg2 an integer of how many problems happened. + * Indent to the description's starting point + * for long ones. + * + * @return int the integer of the set mode used. FALSE if foo + * foo could not be set. + * @throws exceptionclass [description] + * + * @access public + * @static + * @see Net_Sample::$foo, Net_Other::someMethod() + * @since Method available since Release 1.2.0 + * @deprecated Method deprecated in Release 2.0.0 + */ + function setFoo($arg1, $arg2 = 0) + { + /* + * This is a "Block Comment." The format is the same as + * Docblock Comments except there is only one asterisk at the + * top. phpDocumentor doesn't parse these. + */ + if ($arg1 == 'good' || $arg1 == 'fair') { + $this->foo = $arg1; + return 1; + } elseif ($arg1 == 'poor' && $arg2 > 1) { + $this->foo = 'poor'; + return 2; + } else { + return false; + } + } + + // }}} +} + +// }}} + +/* + * Local variables: + * tab-width: 4 + * c-basic-offset: 4 + * c-hanging-comment-ender-p: nil + * End: + */ + +?> + ]]> + </programlisting> + </para> </sect1> </chapter> http://cvs.php.net/diff.php/peardoc/ja/chapters/support.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/ja/chapters/support.xml diff -u peardoc/ja/chapters/support.xml:1.4 peardoc/ja/chapters/support.xml:1.5 --- peardoc/ja/chapters/support.xml:1.4 Thu Aug 14 02:49:45 2003 +++ peardoc/ja/chapters/support.xml Mon May 24 09:36:18 2004 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.4 $ --> -<!-- sync: 1.7 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.8 Maintainer: Status: ready --> +<!-- CREDITS: --> <chapter id="support"> <title>ãµãã¼ã</title> <simpara> - æ¬ç« ã¯ãPEARã«é¢ãã質åãããå ´åã«ãµãã¼ããåããæ¹æ³ã説æãã - ãã®ã§ãã + æ¬ç« ã¯ãPEAR ã«é¢ãã質åãããå ´åã«ãµãã¼ããåããæ¹æ³ã説æãããã®ã§ãã </simpara> <sect1 id="support.lists"> @@ -14,167 +14,211 @@ <sect2> <title>æ¦è¦</title> <para> - å¤ãã®ä»ã®ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã¨åæ§ã«ããµãã¼ãã¯ã¡ã¼ãªã³ - ã°ãªã¹ããéãã¦è¡ããã¾ããç¾å¨ã以ä¸ã«ç¤ºã4ã¤ã®PEARé¢é£ã®ã¡ã¼ãª - ã³ã°ãªã¹ããããã¾ãã + ä»ã®å¤ãã®ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã¨åæ§ã«ããµãã¼ã㯠+ ã¡ã¼ãªã³ã°ãªã¹ããéãã¦è¡ããã¾ãã + ç¾å¨ãPEAR é¢é£ãã¦ã¯ã以ä¸ã«ç¤ºãã¡ã¼ãªã³ã°ãªã¹ããããã¾ãï¼ããããè±èªï¼ã <itemizedlist> <listitem> <para> - <link linkend="support.lists.general">Generalãªã¹ã</link> + <link linkend="support.lists.general">ç·åã¡ã¼ãªã³ã°ãªã¹ã + (general list)</link> </para> </listitem> <listitem> <para> - <link linkend="support.lists.dev">Developersãªã¹ã</link> + <link linkend="support.lists.dev">éçºè ã¡ã¼ãªã³ã°ãªã¹ã + (developers list)</link> </para> </listitem> <listitem> <para> - <link linkend="support.lists.documentation">Documentationãªã¹ã</link> + <link linkend="support.lists.documentation">ææ¸é¢é£ã¡ã¼ãªã³ã°ãªã¹ã + (documentation list)</link> </para> </listitem> <listitem> <para> - <link linkend="support.lists.webmaster">Webmasterãªã¹ã</link> + <link linkend="support.lists.webmaster">WEB é¢é£ã¡ã¼ãªã³ã°ãªã¹ã + (webmaster list)</link> </para> </listitem> <listitem> <para> - CVS commitãªã¹ã + CVS ã¡ã¼ãªã³ã°ãªã¹ã (CVS list) + </para> + </listitem> + <listitem> + <para> + <link linkend="support.lists.core">ã³ã¢éçºã¡ã¼ãªã³ã°ãªã¹ã + (Core development list)</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="support.lists.qa">å質ä¿è¨¼ã¡ã¼ãªã³ã°ãªã¹ã + (QA list)</link> </para> </listitem> </itemizedlist> </para> <para> - æåã®3ã¤ã®ãªã¹ãã¯ã質åãããå ´åã«å©ãã¨ãªãããã®ãã®ã§ãã以 - ä¸ãèªãã§ãã©ã®ãªã¹ããèªåã®ãã¼ãºã«åè´ããããç¥ã£ã¦ä¸ããã - CVS commit ãªã¹ãã¯ãPEARã«è²¢ç®ãã人ç¨ã§ãããªãã¸ã§ã³ç®¡çã·ã¹ã - ã (CVS)ã¸ã®å ¨ã¦ã®ã³ãããã¯ãã®ãªã¹ãã«éããã¾ãã + æåã®4ã¤ã®ãªã¹ãã¯ã質åãããå ´åã«å©ãã¨ãªãããã®ãã®ã§ãã + 以ä¸ãèªãã¨ãã©ã®ãªã¹ããèªåã®ãã¼ãºã«åè´ãããããããã§ãããã + CVS ãªã¹ãã¯ãPEARã«ã³ã¼ããå¯ä¸ãã人åãã§ãã + ãªãã¸ã§ã³ç®¡çã·ã¹ãã (CVS) ã¸ã®ãã¹ã¦ã®ã³ãããã¯ã + ãã®ãªã¹ãã«å 容ãéä¿¡ããã¾ãã + ã³ã¢éçºããã³å質ä¿è¨¼ãªã¹ãã¯ãPEAR ã®éçºã«åå ãããæ¹ã ã®ããã®ãã®ã§ãã </para> <para> - PEARã¡ã¼ãªã³ã°ãªã¹ãã«ã¯ã - <ulink url="&url.pear.support;">ãã®Webãµã¤ã</ulink>ã§ç»é²ã§ãã¾ - ãã + PEAR ã®åã¡ã¼ãªã³ã°ãªã¹ãã«ã¯ã + <ulink url="&url.pear.support;">ãã¡ãã® WEB ãµã¤ã</ulink>㧠+ ç»é²ã§ãã¾ãã </para> </sect2> <sect2 id="support.lists.general"> - <title>Generalã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>ç·åã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - The <ulink url="mailto:&email.pear.general">PEAR general - mailing list</ulink> is the mailing list, where you ask, if you - have a question about installing PEAR, using a certain PEAR - package etc. + PEAR <ulink url="mailto:&email.pear.general">ç·åã¡ã¼ãªã³ã°ãªã¹ã</ulink>ã¯ã + PEAR ã®ã¤ã³ã¹ãã¼ã«ã PEAR ããã±ã¼ã¸ã®ä½¿ç¨ã«é¢ãã質åãããå ´åã«ä½¿ããã + ã¡ã¼ãªã³ã°ãªã¹ãã§ãã </para> <para> - The list is no support forum for question concerning the usage - of PHP. Please use <ulink url="mailto:php-general@lists.php.net"> - php-general@lists.php.net</ulink> instead. + PHP èªä½ã®ä½¿ç¨ã«ã¤ãã¦ã®è³ªåã«å¯¾ãããµãã¼ããã©ã¼ã©ã ã§ã¯ããã¾ããã + ããã«ã¯ <ulink url="mailto:php-general@lists.php.net"> + php-general@lists.php.net</ulink> ãå©ç¨ãã ããã </para> - </sect2> + </sect2> <sect2 id="support.lists.dev"> - <title>Developersã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>éçºè ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - As the name already tells you, this list is the place where the - developers of PEAR come together to make decisions, to discuss - about code and to handle things that are related to this. + ååããå¤ãã¨ããããã®ãªã¹ã㯠PEAR ã®éçºè ãéã¾ãã + 決å®ãä¸ããããã³ã¼ãã«ã¤ãã¦ã®è°è«ãè¡ã£ããã + é¢é£ããäºé ãæ±ã£ããããããã®ãã®ã§ãã </para> <para> - If you are no developer of PEAR itself, this list is of no real - interest for you, unless + ããªãã PEAR ã®éçºè ã§ã¯ãªãå ´åã§ãã以ä¸ã®å ´åã«ã¯ + å½¹ã«ãã¤ããç¥ãã¾ããã <itemizedlist> <listitem> <simpara> - you want to get to know what's going on behind PEAR + PEAR ã®èå°è£ã§èµ·ãã£ã¦ãããã¨ãç¥ãããæ </simpara> </listitem> <listitem> <simpara> - you want to contribute code to PEAR + PEAR ã«ã³ã¼ããå¯ä¸ãããæ </simpara> </listitem> <listitem> <simpara> - you have found a bug in a PEAR package and want to supply a - patch for that. + ãã PEAR ããã±ã¼ã¸ã«ãã°ãè¦ã¤ããããããæ稿ãããæ </simpara> </listitem> </itemizedlist> </para> <para> - The adress for this list is <ulink url="mailto:&email.pear.dev"> - &email.pear.dev</ulink>. + ãã®ãªã¹ãã®ã¢ãã¬ã¹ã¯ã<ulink url="mailto:&email.pear.dev"> + &email.pear.dev</ulink> ã§ãã </para> </sect2> <sect2 id="support.lists.documentation"> - <title>ããã¥ã¡ã³ãä½æç¨ã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>ææ¸é¢é£ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - <ulink url="mailto:&email.pear.doc">This list</ulink> is the - place, where all the things concerning the PEAR documentation, - the manual etc. are discussed. + <ulink url="mailto:&email.pear.doc">ãã®ãªã¹ã</ulink>ã¯ã + PEAR ã®ããã¥ã¡ã³ããããã¥ã¢ã«ã«é¢ãããã¹ã¦ã®äºé ãè°è«ããå ´æã§ãã </para> <para> - If you want to help out documenting PEAR packages, don't hesitate - to drop a mail there. + PEAR ããã±ã¼ã¸ã®ããã¥ã¡ã³ãã«é¢ãã¦ä½ãæ´å©ããããå ´åã + 御æ°æ¥½ã«ã¡ã¼ã«ãæ稿ãã¦ãã ããã </para> </sect2> <sect2 id="support.lists.qa"> - <title>The QA mailing list</title> + <title>å質ä¿è¨¼ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - People being interested in improving the overall quality of PEAR - come together on the <ulink url="mailto:&email.pear.qa;">QA list</ulink>. + PEAR ã®å ¨ä½çãªå質ã®åä¸ã«èå³ã®ããè ã + <ulink url="mailto:&email.pear.qa;">å質ä¿è¨¼ãªã¹ã</ulink>ã«åå ãã¦ãã¾ãã </para> <para> - The Quality Insurance team is always seeking people that want to - help. If you are interested, just - <ulink url="&url.pear.support;">sign up</ulink> and announce - yourself on the mailing list. + å質ä¿è¨¼ãã¼ã ã¯ã常æãæ´å©ãã¦ãããæ¹ãæ¢ãã¦ãã¾ãã + èå³ã®ããæ¹ã¯ã<ulink url="&url.pear.support;">ãµã¤ã³ã¢ãã</ulink>ãã¦ã + æ¬ã¡ã¼ãªã³ã°ãªã¹ãã«ã¢ãã¦ã³ã¹ãã¦ãã ããã </para> </sect2> <sect2 id="support.lists.webmaster"> - <title>Webmasterã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>WEB é¢é£ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - If you have found a problem on our website or have a question - concerning the site, you can email the guys on + PEAR ã® WEB ãµã¤ãã«åé¡ãè¦ã¤ãããããµã¤ãã«é¢ãã質åãããå ´åã¯ã <ulink url="mailto:&email.pear.webmaster;">&email.pear.webmaster; - </ulink>. + </ulink> ã«ã¡ã¼ã«ãã¦ãã ããã + </para> + </sect2> + + <sect2 id="support.lists.core"> + <title>ã³ã¢éçºã¡ã¼ãªã³ã°ãªã¹ã</title> + <para> + <ulink url="mailto:&email.pear.core;">ãã®ãªã¹ã</ulink>ã¯ã + PEAR ã®å種ã¤ã³ãã©ã«ã¤ãã¦è°è«ããå ´ã§ããPECL ã PHP + å質ä¿è¨¼ãªã© PHP ã®ä»ã®ããã¸ã§ã¯ãã®é¢ã ãã¡ã³ãã¼ã¨ãã¦åå ãã¦ãã¾ãã + ã¨ããã®ãã + ï¼PEAR ã¤ã³ã¹ãã¼ã©ã PEAR WEB ãµã¤ããªã©ã®ï¼PEAR ã®ã¤ã³ãã©ã¯ã + ä»ã®ããã¸ã§ã¯ãã«ãé¢é£ãã¦ããããã§ãã + </para> + <para> + ç¹ã«ä»¥ä¸ã®ãããã¯ãæ±ãã¾ãã + <itemizedlist> + <listitem> + <simpara> + PEAR WEB ãµã¤ãã®æ°æ©è½ã«ã¤ã㦠+ </simpara> + </listitem> + <listitem> + <simpara> + PEAR ã¤ã³ã¹ãã¼ã©ã®éçºã«ã¤ã㦠+ </simpara> + </listitem> + <listitem> + <simpara> + å種㮠PEAR æ¨æºã®å®ç¾©ã«ã¤ã㦠+ </simpara> + </listitem> + </itemizedlist> </para> </sect2> </sect1> <sect1> - <title>Webãªã½ã¼ã¹</title> - + <title>WEB ãªã½ã¼ã¹</title> + <para> - There are a number of web sites that deal with PEAR. We have - compiled a list of them - <ulink url="&url.pear.support;">here</ulink>. If a - site is missing, you can email - <ulink url="mailto:&email.pear.webmaster;">the webmaster</ulink>. + PEAR ã«ã¤ãã¦æ±ã£ã¦ãã WEB ãµã¤ãã¯æ°å¤ãåå¨ãã¾ãã + ãããã®ãªã¹ããã<ulink url="&url.pear.support;">ãã¡ã</ulink>㧠+ ä½æãã¦ãã¾ãã + ããããµã¤ããæ¶ãã¦ããå ´åã¯ã<ulink url="mailto:&email.pear.webmaster;"> + webmaster</ulink> ã¸ã¡ã¼ã«ãã¦ãã ããã </para> </sect1> <sect1 id="support.irc"> - <title>IRCã®#PEAR</title> + <title>IRC ã® #PEAR</title> <para> - PEARããã¸ã§ã¯ãã«ã¯å°ç¨ã®IRCãã£ã³ãã«#PEARãããã<ulink - url="&url.efnet;">EFnet</ulink>ã§å©ç¨å¯è½ã§ãã - åå ãã¦ãã°ã«ã¼ãã¡ã«åã£ã¦ä¸ãããå½¼ãã®ã¤ã³ã¿ã¼ãããæ¥ - ç¶ã®æéãè² æ ããå¿ è¦ã¯ãªããä¸æ¥ä¸IRCã«æ¥ç¶ããã¾ã¾ã¨ãããã¨ã - ã§ãã¾ãã + PEAR ããã¸ã§ã¯ãã«ã¯å°ç¨ã® IRC ãã£ã³ãã« #PEAR ãããã<ulink + url="&url.efnet;">EFnet</ulink> ã§å©ç¨å¯è½ã§ãã + åå ãã¦ãã°ã«ã¼ãã¡ã«é¢ã£ã¦ä¸ãããå½¼ãã®ã¤ã³ã¿ã¼ãããæ¥ç¶ã®æéã + è² æ ããå¿ è¦ã¯ãªããä¸æ¥ä¸ IRC ã«æ¥ç¶ããã¾ã¾ã¨ãããã¨ãã§ãã¾ãã </para> </sect1>
http://cvs.php.net/diff.php/peardoc/ja/chapters/contributing.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/ja/chapters/contributing.xml diff -u peardoc/ja/chapters/contributing.xml:1.3 peardoc/ja/chapters/contributing.xml:1.4 --- peardoc/ja/chapters/contributing.xml:1.3 Thu May 20 06:00:34 2004 +++ peardoc/ja/chapters/contributing.xml Mon May 24 09:36:18 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <chapter id="contributing"> -<!-- EN-Revision: 1.13 Maintainer: danielc Status: added english for doc/translate section --> +<!-- EN-Revision: 1.14 Maintainer: Status: ready --> <chapterinfo> <author> <firstname>Tal</firstname> @@ -25,11 +25,11 @@ <sect1 id="contributing.introduction"> <title>ã¯ããã«</title> <simpara> - PEARã¯ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã§ãããã©ããªäººã§ãPEARãæ¹è¯ã«å - å ãããã¨ãã§ãã¾ããæ¹è¯ã¨ã¯ãã³ã¼ããæ¸ããã¨ã ããæå³ãããã - ã§ã¯ããã¾ãããæ¹è¯ã¯ããã°ãå ±åãããããã£ã¼ãããã¯ãæä¾ã - ãããæ©è½ã®ãªã¯ã¨ã¹ããããããããã¨ãæå³ããééçãªãµãã¼ãã - è¡ããã¨ãããå«ã¾ãã¾ãã + PEAR ã¯ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã§ãããã©ããªäººã§ã PEAR ã®æ¹è¯ã«å + å ãããã¨ãã§ãã¾ããæ¹è¯ã¨ã¯ãã³ã¼ããæ¸ããã¨ã ããæå³ããããã§ã¯ + ããã¾ãããæ¹è¯ã¯ããã°ãå ±åãããããã£ã¼ãããã¯ãæä¾ãããã + æ©è½ã®ãªã¯ã¨ã¹ããããããããã¨ãæå³ãã + ééçãªãµãã¼ããè¡ããã¨ãããå«ã¾ãã¾ãã </simpara> </sect1> @@ -44,68 +44,63 @@ <sect1 id="contributing.patches"> <title>ãããã®æ稿</title> <para> - If you have modified a package to expand its functionality or to fix a - bug, you should contribute your changes back to the community (some - licenses force you to do so, and it is generally considered immoral not to). + æ©è½ãæ¡å¼µãããããã°ã®ä¿®æ£ãããããã«ããã±ã¼ã¸ãå¤æ´ããå ´åã¯ã + ãã®å¤æ´ãã³ãã¥ããã£ã¼ã«å¯è´ããã¹ãã§ã + ï¼ãããããã¨ãå¼·å¶ããã©ã¤ã»ã³ã¹ãããã¾ããã¾ããä¸è¬çã«ã + ããããªããã¨ã¯ã¢ã©ã«ã«æããã®ã¨ã¿ãªããã¾ãï¼ã </para> <para> - Before creating the patch, you must first obtain the latest sources of the - package you wish to patch from CVS by running the commands (the package - in this example is Foo_Bar): + ããããä½æããåã«ãCVS ããããããå½ã¦ãã¹ãææ°ã®ã½ã¼ã¹ã以ä¸ã®ããã«ã㦠+ åå¾ãã¦ãã ããï¼ãã®ä¾ã§ã¯ãããã±ã¼ã¸å㯠Foo_Bar ã¨ãã¾ãï¼ã <screen> <command>cvs -d:pserver:cvsread@cvs.php.net:/repository login</command> -password is "phpfi" +ãã¹ã¯ã¼ã㯠"phpfi" ã§ã <command> cvs -z3 -d:pserver:cvsread@cvs.php.net:/repository co Foo_Bar </command> </screen> - Now that you have the latest sources, you can edit the relevant file(s). - Make sure that your patch is fully compatible with the &link.coding-standards;. + ææ°ã®ã½ã¼ã¹ãåå¾ã§ããã®ã§ã対å¿ãããã¡ã¤ã«ãç·¨éãã¾ãã + &link.coding-standards; ã«åè´ããããã«ãã¦ãã ããã </para> <para> - After you have finished adding/changing the code, TEST it: We will not - accept code that hasn't been carefully tested. - When you are absolutely sure the new code doesn't introduce bugs, create a - unified diff by running: + ã³ã¼ãã«è¿½å ã»å¤æ´ãè¡ã£ããããã¹ããã¦ãã ããã注ææ·±ããã¹ããè¡ããã¦ããªã + ã³ã¼ãã¯åãå ¥ãããã¾ãããæ°ããã³ã¼ãã«ãã°ãç¡ããã¨ã確信ãããã + 以ä¸ã®ã³ãã³ã㧠unified å½¢å¼ã® diff ãä½æãã¾ãã <screen> <command>cd pear/Foo_Bar</command> <command>cvs diff -u >Foo_Bar.diff</command> </screen> - The resulting .diff file contains your patch. This diff makes it easy - for us to see what has been changed. + ã§ãã .diff ãã¡ã¤ã«ã¯ãããªãã®ããããå«ãã§ãã¾ãããã® diff ã«ããã + å¤æ´ç¹ã確èªãããã¨ãã§ããããã«ãªãã¾ãã </para> <para> - Next step is to submit the patch. Send a mail to &email.pear.dev; and - Cc the maintainer(s) of the package. The subject of the mail should be - prefixed with '[Patch]' to make it clear you are submitting a patch. Also - include a verbose explanation of what the patch does. - Don't forget to attach the .diff file to the mail. The maintainers of - the package are usually listed in the header of each source file. Apart - from that their email adresses are available on the package information - page on &url.pear;. + 次ã®ã¹ãããã¯ããããã®éä»ã§ããããã±ã¼ã¸ã®ã¡ã³ããã« CC ãã¤ãã¦ã + &email.pear.dev; ã«ã¡ã¼ã«ãæ¸ãã¦ãã ãããã¡ã¼ã«ã®ä»¶åã¯ã + '[Patch]' ããã¯ããã¦ããããã®æ稿ã§ãããã¨ãå¤ããããããã¨è¯ãã§ãããã + ã¾ãããããã®å 容ã®è©³ãã説æãæ¸ãã¦ãã ããã + .diff ãã¡ã¤ã«ãã¡ã¼ã«ã«æ·»ä»ããã®ãå¿ããªãããã«ã + ããã±ã¼ã¸ã®ã¡ã³ããåã¯ãé常ãã½ã¼ã¹ãã¡ã¤ã«ã®ãããã«è¨è¼ããã¦ãã¾ãã + ã¡ã¼ã«ã¢ãã¬ã¹ä»¥å¤ã®æ å ±ã¯ã&url.pear; ã®ããã±ã¼ã¸æ å ±ã®ãã¼ã¸ã§è¦ããã¾ãã </para> <note> <para> - If you are using Outlook or Outlook Express, please change the file - extension of the diff file to .txt, because Outlook's MIME-Type - detection depends on the file extension and attachments with a - MIME-Type not equal to <literal>text/plain</literal> will be rejected - by our mailinglist software. + Outlook ã Outlook Express ã使ã£ã¦ããå ´åã¯ãdiff ãã¡ã¤ã«ã®æ¡å¼µåã + .txt ã¸å¤æ´ãã¦ãã ãããOutlook ã® MIME å½¢å¼ã®æ¤åºã¯ããã¡ã¤ã«ã®æ¡å¼µåã + è¦ã¦ãããMIME å½¢å¼ã <literal>text/plain</literal> ã§ãªãæ·»ä»ãã¡ã¤ã«ã¯ + ããããã®ä½¿ç¨ããã¡ã¼ãªã³ã°ãªã¹ãã®ã½ãããæå¦ããããã§ãã </para> </note> <note> <para> - If your patch does break backwards compatibility, the chances are fairly - good that the maintainers won't be happy about it. Thus you should always - try to fix a bug in a way that does not seriously change the public API. - But if there is absolutely no way to keep backwards compatibility and/or - if your patch contains a groundbraking improvement, even API changes are - fine. + ãããã«å¾æ¹äºææ§ãç¡ããã°ãå¤æ´ããã°ããããã®ã§ãã£ã¦ããã¡ã³ãã㯠+ å°ã£ã¦ãã¾ãã§ãããããããªãã¯ãª API ãå¤§å¹ ã«å¤æ´ãããã¨ã®ç¡ãããã«ã + ãã°ä¿®æ£ãè¡ã£ã¦ã¿ãã¹ãã§ããå¾æ¹äºææ§ã®ä¿ã¤ãã¨ã¯ã¾ã£ããä¸å¯è½ã§ãã¾ãã + ãããã大å¤ãªæ©è½åä¸ãããããå ´åã¯ãAPI ãå¤æ´ãã¦ãè¯ãã§ãããã </para> </note> </sect1> @@ -113,62 +108,61 @@ <sect1 id="contributing.bugs"> <title>ãã°ã®å ±å</title> <para> - If you think that you have found a bug in a PEAR package, please - take care that you are using the latest version of the package and - that your system does meet the packages' requirements. + PEAR ããã±ã¼ã¸ã«ãã°ãããã¨æã£ãããã¾ããããã±ã¼ã¸ã®ææ°çã使ç¨ãã¦ãããã + ããã³ãã·ã¹ãã ãããã±ã¼ã¸ã®è¦æ±äºé ã«åã£ã¦ããã確èªãã¦ãã ããã </para> <para> - If the bug still persists with the latest version of the package, - don't hesitate to fill out a bug report on - <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. - Please choose "PEAR related" as the category for the report. The developers - on the PEAR development list will be noticed about your report. + ãã°ãããã±ã¼ã¸ã®ææ°çã«ãåå¨ããå ´åã¯ã<ulink url="&url.php.bugs;"> + &url.php.bugs;</ulink> ã®ãã°å ±åãè¨è¿°ãã¦ãã ããã + å ±åã®ã«ãã´ãªã«ã¯ "PEAR related" ãé¸æãã¦ãã ããã + PEAR development ã¡ã¼ãªã³ã°ãªã¹ãã«ããã¦ãéçºè ãå ±åã«ç®ãéãã¾ãã </para> <para> - More information and tips on how to report bugs in a proper way - can be found at <ulink url="&url.php.bugs.howto;">&url.php.bugs.howto;</ulink>. + ãã°ãæ£ããå ±åããããã®æ¹æ³ã«ã¤ãã¦ã®ãã詳ããæ å ±ã«ã¤ãã¦ã¯ + <ulink url="&url.php.bugs.howto;">&url.php.bugs.howto;</ulink> + ãåç §ãã¦ãã ããã </para> <para> - If you have already fixed a bug that you have found in a package, please - read <link linkend="contributing.bugs">this</link>. + ããè¦ã¤ãããã°ãä¿®æ£ããå ´åã¯ã<link linkend="contributing.bugs">ãã¡ã + </link>ãåç §ãã¦ãã ããã </para> </sect1> <sect1 id="contributing.documentation"> - <title>Writing & Translating Documentation</title> + <title>ããã¥ã¡ã³ãã®è¨è¿°ã¨ç¿»è¨³</title> <para> - Good documentation is essential for users to fully understand any - software. Several PEAR packages lack documentation or have docs which - need improvement. <link - linkend="developers.documentation">Writing documentation</link> - provides more information about helping out on this front. + ããã½ããã¦ã¨ã¢ãã¦ã¼ã¶ãç解ããããã«ã¯ãè¯ãããã¥ã¡ã³ããå¿ é ã§ãã + ããã¥ã¡ã³ããæ¬ ãã¦ããããæ¹è¯ãå¿ è¦ãª PEAR ããã±ã¼ã¸ãããã¾ãã + <link + linkend="developers.documentation">ããã¥ã¡ã³ãã®ä½æ</link>ã®ç« ã«ã + ããã«å½¹ã«ãã¤æ å ±ãè¨è¼ããã¦ãã¾ãã </para> <para> - Translating documentation is another important task. - Not only does new documentation need to be translated - into the existing languages, additional languages are - welcome. Also, existing translations need to be brought - up to date because the English versions have been changed. - Help on how to perform the translation process is in the <link - linkend="faq.translators-revision-tracking">Revision Tracking</link> - section of the manual. + ããã¥ã¡ã³ãã®ç¿»è¨³ãéè¦ãªä»äºã§ãã + ããã¾ã§ã«ã翻訳ãè¡ããã¦ããè¨èªã«ãæ°ããããã¥ã¡ã³ãã翻訳ãããã¨ãéè¦ + ã§ããã翻訳ãè¡ããã¦ããªãè¨èªã¸ã®è¨³åºãæè¿ããã¾ãã + ã¾ããè±èªã®ããã¥ã¡ã³ãã¯å¤æ´ãå ãããã¦ããã®ã§ã翻訳ãã¿ã®ãã®ã + æ´æ°ãã¦ãããã¨ãå¿ è¦ã¨ãªãã¾ãã + 翻訳ããã»ã¹ã®å®è¡æ¹æ³ã«ã¤ãã¦ã¯ãæ¬ããã¥ã¢ã«ã®<link + linkend="faq.translators-revision-tracking">ãªãã¸ã§ã³è¿½è·¡</link>ã®ç« ã + åç §ãã¦ãã ããã </para> </sect1> <sect1 id="contributing.wishlist"> - <title>欲ãããã®ãªã¹ã(ã¦ã¤ãã·ã¥ãªã¹ã)</title> + <title>ã¦ã¤ãã·ã¥ãªã¹ã</title> <para> - Some of the PEAR developers have wishlists at Amazon or a similar - service. If you appreciate the work of a certain developer, feel - free to buy something for her from her wishlist. To find out if - a developer has one of those wishlists, go to the - <ulink url="&url.pear.account;">account browser</ulink>, - look for the details of the developer and there you'll see if she - has a wishlist. Buying something from people's wishlists may even - speed up the time in which annoying bugs are fixed ;-). + PEAR éçºè ã®ä¸ã«ã¯ãAmazon çã§ã¦ã¤ãã·ã¥ãªã¹ããå ¬éãã¦ãã人ããã¾ãã + ããéçºè ã®ä»äºã«å¯¾ãã¦æè¬ã®æã表ãããå ´åãã¦ã¤ãã·ã¥ãªã¹ããã + é æ ®ãªãä½ããè²·ã£ã¦è´ã£ã¦ããã¦ãã ããã + éçºè ãã¦ã¤ãã·ã¥ãªã¹ããå ¬éãã¦ãããã©ãã調ã¹ãã«ã¯ã + <ulink url="&url.pear.account;">ã¢ã«ã¦ã³ããã©ã¦ã¶</ulink>ã§éçºè ã®è©³ç´°æ å ±ã + åç §ãã¾ãã + ã¦ã¤ãã·ã¥ãªã¹ãããä½ãè´ãã¨ãæ©ã¾ãããã°ãä¿®æ£ãããæéãçããªããã + ããã¾ããã (^-^)ã </para> </sect1> </chapter> http://cvs.php.net/diff.php/peardoc/ja/chapters/installation.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/ja/chapters/installation.xml diff -u peardoc/ja/chapters/installation.xml:1.4 peardoc/ja/chapters/installation.xml:1.5 --- peardoc/ja/chapters/installation.xml:1.4 Thu May 20 06:00:34 2004 +++ peardoc/ja/chapters/installation.xml Mon May 24 09:36:18 2004 @@ -1,7 +1,6 @@ -<?xml version="1.0" encoding="utf-8" ?> -<!-- sync: 1.8 --> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.8 Maintainer: Status: ready --> +<?xml version="1.0" encoding="UTF-8" ?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.18 Maintainer: Status: ready --> <!-- CREDITS: --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING @@ -17,128 +16,135 @@ </chapterinfo> <title>ã¤ã³ã¹ãã¼ã«</title> <simpara> - æ¬ç« ã¯ãPEARããããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦èª¬æãã¾ãã + æ¬ç« ã¯ãPEAR ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦èª¬æãã¾ãã </simpara> <sect1 id="installation.introduction"> <title>å°å ¥</title> <para> - æ¬ç« ã¯ãPEARã®<link linkend="about.pear">æ§æ</link>ã«é¢ããç¥èã + æ¬ç« ã¯ãPEAR ã®<link linkend="about.pear">åºæ¬çæ§æ</link>ã«é¢ããç¥èã æãããã¨ãåå ¤ã¨ãã¾ãã </para> <para> - åºæ¬é¨åã®ã¤ã³ã¹ãã¼ã«ã¯ãPFCã®é¨åã¨ãã¦PHPãã£ã¹ããªãã¥ã¼ã·ã§ã³ã¨ - å ±ã«è¡ããã¾ããããã«ã¯ãPEARã¤ã³ã¹ãã¼ã«ãã¼ã«çã®å®è¡ã«è¦ããã - ã®ãå ¨ã¦å«ã¾ãã¦ãã¾ããPHP 4ã®æè¿ã®ãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ã㦠- ããå ´åã«ã¯ããç°¡åã§ã<filename>./configure</filename>ã«ãã©ã°'-- - without-pear'ãæå®ãã¦ããªãéãPEARã®åºæ¬é¨åã¯ã·ã¹ãã ã«ã¤ã³ã¹ - ãã¼ã«æ¸ã¿ã§ãã - </para> - <para> - PFC以å¤ã®ããã±ã¼ã¸ã¯ãPEARããã±ã¼ã¸ããã¼ã¸ã£ã«ããã¤ã³ã¹ãã¼ã« - å¯è½ã§ãããã®ããã¼ã¸ã£ã¯ãDebianã®<quote>apt-get</quote>ã¨äºææ§ - ãããã¾ããã¾ããæè¿ã®ãã¼ã¸ã§ã³(> 4.3.0) ã®PHPãå®è¡ã㦠- ããå ´åã次ç¯ãèªã¿é£ã°ããã¨ãã§ãã¾ããPHP 4.2.*ããã³ãã以å - ã®ãã¼ã¸ã§ã³ã使ç¨ãã¦ããå ´åããã®ããã¼ã¸ã£ãå¥éã¤ã³ã¹ãã¼ã«ã - ãå¿ è¦ãããã¾ãã - </para> - <para> - ããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ä»¥å¤ã«ãPEARããã±ã¼ã¸ããã¼ã¸ã£ã¯ãä»ã®ã - ãã¤ãã®å¦çãè¡ãã¾ãã使ç¨ãããã·ã³ã«æ°è¦ããã±ã¼ã¸ãä½æãã㤠- ã³ã¹ãã¼ã«æ¸ã¿ã®ããã±ã¼ã¸ã®ã¬ã¸ã¹ããªã管çããä¾åæ§ã確èªããã - ã¨ãå¯è½ã§ããããã¦ãä»ã®å¦çãè¡ãããã«pear.php.netä¸ã®XML-RPC - ãµã¼ãã¹ã«ããéä¿¡ãããã¨ãå¯è½ã§ãã + PEAR ã®åºæ¬é¨å + <link linkend="about-pfc">The PHP Foundation Classes (PFC)</link> + ã¯ãPHP ãã£ã¹ããªãã¥ã¼ã·ã§ã³ã¨å ±ã«é å¸ããã¦ããã + PEAR ã¤ã³ã¹ãã¼ã«ãã¼ã«ã®å®è¡ã«è¦ãããã®ããã¹ã¦å«ãã§ãã¾ãã + PHP 4 ã®æè¿ã®ãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ããå ´åã«ã¯ã + <filename>./configure</filename> ã«ãã©ã° + <literal>--without-pear</literal> ãæå®ãã¦ããªãéãã + PEAR ã®åºæ¬é¨åã¯ã·ã¹ãã ã«ã¤ã³ã¹ãã¼ã«ãããããã«ãªã£ã¦ãã¾ãã + </para> + <para> + <link linkend="about-pfc">PFC</link> 以å¤ã®ããã±ã¼ã¸ã¯ã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã«ããã¤ã³ã¹ãã¼ã«ãå¯è½ã§ãã + ãã®ããã¼ã¸ã£ã¯ãDebian ã® <quote>apt-get</quote> ã¨ä¼¼ã¦ãã¾ãã + æè¿ã®ãã¼ã¸ã§ã³ (> 4.3.0) ã® PHP ã使ç¨ãã¦ããå ´åã¯ã + 次ç¯ãèªã¿é£ã°ããã¨ãã§ãã¾ããPHP 4.2.* ããã³ãã以åã®ãã¼ã¸ã§ã³ã + 使ç¨ãã¦ããå ´åã¯ãããã±ã¼ã¸ããã¼ã¸ã£ãå¥éã¤ã³ã¹ãã¼ã«ãã + å¿ è¦ãããã¾ãã + </para> + <para> + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã¯ãããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ä»¥å¤ã®ä»äºãè¡ãã¾ãã + æ°è¦ããã±ã¼ã¸ã®ä½æã»ã¤ã³ã¹ãã¼ã«æ¸ã¿ããã±ã¼ã¸ã®ã¬ã¸ã¹ããªç®¡çã» + ä¾åæ§ã®ãã§ãã¯ãªã©ã§ãã + ããã¦ããããã®å¦çãè¡ãããã« pear.php.ne ä¸ã® XML-RPC ãµã¼ãã¹ã¨ + éä¿¡ãããã¨ãå¯è½ã§ãã </para> </sect1> <sect1 id="installation.getting"> - <title>PEARããã±ã¼ã¸ããã¼ã¸ã£ã®åå¾</title> - <simpara> - Linux: PHP 4.3.0以éã./configure ã§--without-pearãæå®ããã¦ã㪠- ãéããPEAR Package Managerã¯ã¤ã³ã¹ãã¼ã«ããã¦ãã¾ãã - </simpara> - <note> - <para> - ããã¤ãã®Linuxãã£ã¹ããªãã¥ã¼ã·ã§ã³(ä¾: Redhat) ã¯ã - ã³ãã³ãã©ã¤ã³ãã©ã¦ã¶ã®ååã¨ãã¦<filename>lynx</filename>ã§ã¯ãª - ãã<filename>links</filename>ã使ç¨ãã¦ããããã§ãã - ãã®å ´åã以ä¸ã®è¡ãåæ§ã«å¤æ´ããå¿ è¦ãããã¾ãã - </para> - </note> - <simpara> - Windows: PHP 4.3.2以éãgo-pearã¹ã¯ãªããããã³ãã«ããã¦ãã¾ãã - (ã¦ã¤ã³ãã¦ãºã¨ã¯ã¹ããã¼ã©ã®ããã«ã¯ãªãã¯ã¨åæ§ã«å®è¡ãã¦ã¿ã¦ä¸ããã - </simpara> - <para> - <screen> - <userinput> -drive:path\to\php\go-pear.bat - </userinput> - </screen> - </para> - <simpara> - ãã®å¾ã®è³ªåã«å ¨ã¦å¿ãã¦ä¸ããã - ããã«ãããPEARããã±ã¼ã¸ããã¼ã¸ã£ãæå®ãããã¹ã«ã¤ã³ã¹ãã¼ã«ã - ãã¾ãããã®ãã¹ãã·ã¹ãã ã®PATHç°å¢å¤æ° - (ã¹ã¿ã¼ã > ã³ã³ããã¼ã«ããã« > ã·ã¹ãã > ç°å¢å¤æ°) - ã«è¿½å ããã³ãã³ãããã³ããã§pearã¨ã¿ã¤ããã¦ã¿ã¦ä¸ããã - è¦äºã«åä½ããã¯ãã§ãã - </simpara> - <simpara> - ææ°çã®PHP(> 4.3.0)ã使ã£ã¦ããªãã¦ã¼ã¶ã - ããã±ã¼ã¸ããã¼ã¸ã£ãåã¤ã³ã¹ãã¼ã«ãããå ´åã¯ã - å¥ã®æ¹æ³ãç¨æããã¦ãã¾ãã - 以ä¸ã®ã³ãã³ããLinuxä¸ã§å®è¡ãããã¨ãã§ãã¾ãã - </simpara> - <para> - <screen> - <userinput> -$ lynx -source http://go-pear.org | php - </userinput> - </screen> - </para> - <simpara> - Windowsã§ã¯ãgo-pear.orgããã¹ã¯ãªããããã¦ã³ãã¼ããä¿åãã - 以ä¸ã®ã³ãã³ãã§å®è¡ãã¦ä¸ããã - </simpara> - <para> - <screen> - <userinput> -php go-pear (ã¾ãã¯ä¿åãããã¡ã¤ã«å) - </userinput> - </screen> - </para> - <simpara> - (ãµã¼ãã«sshã¢ã¯ã»ã¹ã§ããç°å¢ã§ãªãéã)pearã³ãã³ãã使ç¨ã§ã㪠- ãã®ã§ãWebãã¹ãã«pearãã¤ã³ã¹ãã¼ã«ã§ãããæ¸å¿µãããããããã¾ - ãããããããå ¨ãä¸å¯è½ãªããã§ã¯ããã¾ããã - PEARããã±ã¼ã¸ããã¼ã¸ã£ã¯ãããã±ã¼ã¸ã¤ã³ã¹ãã¼ã«ã®æé ãç°¡åã«ã - ã¦ãããã ãã®ãã®ã§ããï¼ã¤ã®æ段ã¨ãã¦ã¯ããã¹ã¯ãããPCã«pear - ã³ãã³ãã§ã¤ã³ã¹ãã¼ã«ãã¦ããããµã¼ãã¼ã«ãã¡ã¤ã«ãã³ãã¼ããã¨ã - ããã®ãããã¾ããPEARãã¡ã¤ã«ãéã¨ã§å©ç¨ã§ããããã« - set_include_path()ã使ç¨ãããã¨ãå¿ããªãããã«ãã¦ä¸ããã - </simpara> - </sect1> + <title>ããã±ã¼ã¸ããã¼ã¸ã£ã®åå¾</title> + <sect2> + <title>Unix/Linux/BSD</title> + <para> + PHP 4.3.0以éã <filename>./configure</filename> 㧠+ <literal>--without-pear</literal> ãªãã·ã§ã³ãæå®ããªãéãã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã¯ï¼PHP ã¨å ±ã«ï¼ã¤ã³ã¹ãã¼ã«ããã¦ãã¾ãã + </para> + <para> + ãã¼ã¸ã§ã³ 4.3.0 以åã®å ´åãã + ããã±ã¼ã¸ããã¼ã¸ã£ãåã¤ã³ã¹ãã¼ã«ãããå ´åã¯ã + 以ä¸ã®æ¹æ³ãæ«å®çã«ç¨æããã¦ãã¾ãã + <screen> + <userinput> +$ lynx -source http://go-pear.org/ | php + </userinput> + </screen> + </para> + <note> + <para> + ããã¤ãã® Linux ãã£ã¹ããªãã¥ã¼ã·ã§ã³ï¼Redhatãªã©ï¼ã§ã¯ã + ã³ãã³ãã©ã¤ã³ãã©ã¦ã¶ã®ååã¨ã㦠<filename>lynx</filename> ã§ã¯ãª + ãã<filename>links</filename> ã使ç¨ãã¦ããããã§ãã + ãã®å ´åãä¸è¨ã®è¡ããã®ããã«å¤æ´ããå¿ è¦ãããã¾ãã + </para> + </note> + </sect2> + + <sect2> + <title>Windows</title> + + <para> + PHP ããã¦ã³ãã¼ããã¤ã³ã¹ãã¼ã«ããå¾ãããããã¡ã¤ã«ãå®è¡ãã¾ãã + ãã¡ã¤ã«ã¯ãï¼ã¤ã³ã¹ãã¼ã«ããå ´æã«ããã¾ããï¼ + <filename>c:\php\go-pear.bat</filename> ã®ãããªæã«ããã¾ãã + ã»ããã¢ããä¸ãããã¤ãã®è³ªåãè¡ãããæå®ãããã¹ã« PEAR + ããã±ã¼ã¸ããã¼ã¸ã£ãã¤ã³ã¹ãã¼ã«ããã¾ãã + ãã®å¾ãPATH ç°å¢å¤æ°ã«ã¤ã³ã¹ãã¼ã«ãããã©ã«ãã¸ã®ãã¹ã追å ãã¦ãã ãã + ï¼ã¹ã¿ã¼ã > ã³ã³ããã¼ã«ããã« > ã·ã¹ãã > ç°å¢å¤æ°ï¼ã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ãå®è¡ããã«ã¯ã + Windows ã®ã³ãã³ãããã³ããã§ã <literal>pear</literal> + ã³ãã³ãã使ç¨ãã¾ãã + </para> + <para> + PEAR ã¤ã³ã¹ãã¼ã«ã®ã¢ãããã¼ãã go-pear.org ãç¨ãã¦è¡ããã¨ãã§ãã¾ãã + http://go-pear.org/ ããã©ã¦ã¶ã§è¡¨ç¤ºãã<filename>go-pear.php</filename> + ã«ä¿åãã¦ã以ä¸ã®ã³ãã³ããå®è¡ãã¦ãã ããã + <screen> + <userinput> +php go-pear.php + </userinput> + </screen> + Windows ã®ã³ãã³ãããã³ããã§ãã¢ãããã¼ãã®ããã»ã¹ãã¹ã¿ã¼ããã¾ãã + </para> + </sect2> + <sect2> + <title>ãã¹ãã£ã³ã°ç°å¢ã§ã® PEAR</title> + + <para> + Web ãã¹ãã£ã³ã°ãããã¤ãã使ç¨ãã¦ãããï¼ãã¼ã«ã«ãã°ã¤ã³ã + Telnet ã SSH ã«ããï¼ãµã¼ãã¸ã®ç´æ¥ã¢ã¯ã»ã¹ãã§ããªãå ´åã + PEAR ããã±ã¼ã¸ããã¼ã¸ã£ã使ç¨ãããã¨ã¯ã§ãã¾ããã + æ°ã®ãããWeb ãã¹ãã£ã³ã°ä¼ç¤¾ã§ããã°ããã使ç¨ããã PEAR ããã±ã¼ã¸ã¯ + ã¤ã³ã¹ãã¼ã«æ¸ã¿ã§ããå¯è½æ§ãããã¾ãã + ããããPEAR ãã¤ã³ã¹ãã¼ã«æ¸ã¿ã§ãªãã£ããã追å ã®ããã±ã¼ã¸ãå¿ è¦ãªå ´åã¯ã + ãããã¤ãã«é£çµ¡ãã¨ããããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ãä¸éã«é ¼ãã§ã¿ãã®ã + è¯ãã§ããããã¤ã³ã¹ãã¼ã«ãã¦ããããªãå ´åã¯ãä»ã®ãã¹ãã£ã³ã°ä¼ç¤¾ã + æ¢ã以å¤ã«ã<link linkend="installation.manually">æåã§ã¤ã³ã¹ãã¼ã« + </link>ãããã¨ãå¯è½ã§ãã + </para> + </sect2> + </sect1> <sect1 id="installation.cli"> - <title>ã³ãã³ãã©ã¤ã³ã¤ã³ã¹ãã¼ã©</title> - <titleabbrev>CLIã¤ã³ã¹ãã¼ã©</titleabbrev> + <title>ã³ãã³ãã©ã¤ã³ ã¤ã³ã¹ãã¼ã©</title> + <titleabbrev>CLI ã¤ã³ã¹ãã¼ã©</titleabbrev> <para> <warning id="installation.web.prerequesite"> - <title>ã¯ããã«</title> + <title>åæäºé </title> <para> 以ä¸ã®èª¬æã¯ãææ°çã® - <link linkend="installation.getting">PEARããã±ã¼ã¸ããã¼ã¸ã£ - </link>ãã¤ã³ã¹ãã¼ã«ããã¦ãããã¨ãåæã¨ãã¾ãã + <link linkend="installation.getting">ããã±ã¼ã¸ããã¼ã¸ã£</link> + ãã¤ã³ã¹ãã¼ã«ããã¦ãããã¨ãåæã¨ãã¾ãã </para> </warning> </para> <para> - ã³ãã³ãã©ã¤ã³ã¤ã³ã¹ãã¼ã©ã¯ãPEARããã±ã¼ã¸ãã·ã¹ãã ã«ã¤ã³ã¹ãã¼ - ã«ããæãç°¡åãªæ¹æ³ã§ãããã®ã¤ã³ã¹ãã¼ã©ã¯ãç°¡åãªHTTPæ¥ç¶ã«ãã - PEARããã±ã¼ã¸ãµã¼ãã«æ¥ç¶ããã·ã¹ãã ã«ããã±ã¼ã¸ããã¦ã³ãã¼ããã - 好ããªå ´æã«ã¤ã³ã¹ãã¼ã«ãã¾ãã + ã³ãã³ãã©ã¤ã³ ã¤ã³ã¹ãã¼ã©ã¯ãPEAR ããã±ã¼ã¸ãã·ã¹ãã ã«ã¤ã³ã¹ãã¼ã«ãã + æãç°¡åãªæ¹æ³ã§ãããã®ã¤ã³ã¹ãã¼ã©ã¯ãåç´ãª HTTP æ¥ç¶ã«ãã + PEAR ããã±ã¼ã¸ãµã¼ãã«æ¥ç¶ããã·ã¹ãã ã«ããã±ã¼ã¸ããã¦ã³ãã¼ããã + ä»»æã®å ´æã«ã¤ã³ã¹ãã¼ã«ãã¾ãã </para> - <sect2> <title>å®å ¨èªåã¤ã³ã¹ãã¼ã«</title> <para> @@ -153,30 +159,31 @@ </screen> </para> <para> - <package> ã¯ã(HTTP_Uploadã®ãããª)ã¤ã³ã¹ãã¼ã«ããããã±ã¼ - ã¸ã®ååã§ç½®ãæãã¦ä¸ãããå©ç¨å¯è½ãªããã±ã¼ã¸ã®ä¸è¦§ãè¦ãã«ã¯ã - <ulink url="http://pear.php.net/packages.php">PEARããã±ã¼ã¸ãã© - ã¦ã¶</ulink>ã¾ãã¯ä»¥ä¸ãå®è¡ãã¾ãã - </para> + <package> ã¯ãï¼HTTP_Uploadã®ããã«ï¼ã¤ã³ã¹ãã¼ã«ããããã±ã¼ã¸ã® + ååã§ç½®ãæãã¦ä¸ãããå©ç¨å¯è½ãªããã±ã¼ã¸ã®ä¸è¦§ãè¦ãã«ã¯ã + <ulink url="http://pear.php.net/packages.php">PEAR + ããã±ã¼ã¸ãã©ã¦ã¶</ulink>ãåç §ãããã以ä¸ã®ã³ãã³ããå®è¡ãã¾ãã + </para> <para> <screen> <userinput> -$ pear list-remote-packages +$ pear remote-list </userinput> </screen> </para> <para> - ãã®ã³ãã³ãã¯ãPEARã§å©ç¨å¯è½ãªå ¨ã¦ã®ããã±ã¼ã¸ãè¿ãã¾ãã + ãã®ã³ãã³ãã¯ããã®æç¹ã§ PEAR ã§å©ç¨å¯è½ãªãã¹ã¦ã®ããã±ã¼ã¸ã® + ãªã¹ããè¿ãã¾ãã </para> </sect2> <sect2> <title>åèªåã¤ã³ã¹ãã¼ã«</title> <para> - <ulink url="http://pear.php.net/">pear.php.net</ulink>ãããã¦ã³ - ãã¼ããããªãªã¼ã¹ããã±ã¼ã¸ãgzipå§ç¸®ãããtarã¢ã¼ã«ã¤ãã¨ãã¦æ - æãã¦ããå ´åããã¼ã«ã«ãªç°å¢ã§ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«å¯è½ã§ãã - ãããè¡ãã«ã¯ãã·ã§ã«ã§ä»¥ä¸ã®ãããªï¼è¡ãå®è¡ãã¦ä¸ããã + <ulink url="http://pear.php.net/">pear.php.net</ulink>ãã + ãªãªã¼ã¹ããã±ã¼ã¸ã gzip å§ç¸®ããã tar ã¢ã¼ã«ã¤ãã®å½¢å¼ã§ + ï¼æåã§ï¼ãã¦ã³ãã¼ããããã¼ã«ã«ãªç°å¢ã«ã¤ã³ã¹ãã¼ã«ã§ãã¾ãã + ã·ã§ã«ã§ä»¥ä¸ã®1è¡ãå®è¡ãã¦ä¸ããã </para> <para> <screen> @@ -186,20 +193,315 @@ </screen> </para> <para> - ãã®ã³ãã³ãã¯ãèªåçã«ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ãããªã³ã©ã¤ã³æ¥ - ç¶ãå¿ è¦ã¨ãã¾ããã<filename><file>.tgz</filename>ã¯ãã㦠- ã³ãã¼ãããããã¡ã¤ã«ã®ååã«ç½®ãæããå¿ è¦ãããã¾ãã + ãã®ã³ãã³ãã¯ãèªåçã«ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ãã¾ããã + ãã®éãªã³ã©ã¤ã³æ¥ç¶ãå¿ è¦ã¨ãã¾ããã + <filename><file>.tgz</filename>ã¯ããã¦ã³ãã¼ããããã¡ã¤ã«ã® + ååã«ç½®ãæãã¦ãã ããã </para> </sect2> + </sect1> + + <sect1 id="installation.shared"> + <title>å ±æãã¹ãã«ããã PEAR ã®ãã¼ã«ã«ã³ãã¼ã®ã¤ã³ã¹ãã¼ã«</title> + + <para> + ã·ã¹ãã å ±æã® PEAR ã¤ã³ã¹ãã¼ã«ã«ã¢ã¯ã»ã¹ã§ãããããªãããã¤ãã使ã£ã¦ãã + ã¦ã¼ã¶ã®æ¹ãããã£ãããã§ãããã + ããããã¤ã³ã¹ãã¼ã«ããã¦ããªãããã±ã¼ã¸ã使ãããå ´åãªã©ãã¯ããã + å¤ãã®å ´é¢ã§ãPEAR ã®ãã¼ã«ã«ã³ãã¼ãä½æããã¨ä¾¿å©ã§ãã + telnet/ssh ã«ããã·ã§ã«ã¢ã¯ã»ã¹ãéããæ¹æ³ã¨ãftp ã¢ã¯ã»ã¹ã ãã«ããæ¹æ³ + ã¨ã«ã¤ãã¦èª¬æãã¾ãã + </para> + <sect2 id="installation.shared.shell"> + <title>SSH ã使ç¨ããã¤ã³ã¹ãã¼ã«</title> + <para> + SSH ãéã㦠PEAR ã®ãã¼ã«ã«ã³ãã¼ãã¤ã³ã¹ãã¼ã«ããã«ã¯ã + 以ä¸ã®ã³ãã³ãã使ç¨ãã¾ãã + </para> + <para> + <screen> + <userinput> +$ pear -s -c ~/.pearrc -d doc_dir=~/pear/docs -d ext_dir=~/pear/ext \ + -d php_dir=~/pear/lib -d data_dir=~/pear/data -d test_dir=~/pear/tests \ + -d cache_dir=~/pear/cache -d bin_dir=~/pear/bin + </userinput> + </screen> + </para> + <para> + ãã¼ã«ã«ã®è¨å®ãã¡ã¤ã«ããã¼ã ãã£ã¬ã¯ããªã« <filename>.pearrc</filename> + ã¨ããååã§ä½æããã¾ãã + å ãã¦ãã¤ã³ã¹ãã¼ã«ããããã±ã¼ã¸ãä¿åããããã®ãã£ã¬ã¯ããªæ§é ã¯ã + ãã¼ã ãã£ã¬ã¯ããªã® <filename>pear</filename> ãã£ã¬ã¯ããªä¸ã« + ä½æãããããã«è¨å®ããã¾ãã + </para> + <para> + 次ã«ã.bashrcï¼ãããã¯ä»ã®ã¹ã¿ã¼ãã¢ãããã¡ã¤ã«ï¼ã«ã¦ã + ~/pear/bin ããã¹ã«è¿½å ãã以ä¸ã®ã³ãã³ããå®è¡ãã¾ãã + </para> + <para> + <screen> + <userinput> +$ pear -c ~/.pearrc install Archive_Tar PEAR Console_Getopt XML_RPC + </userinput> + </screen> + </para> + <para> + ã·ã¹ãã çã¨ã¯å¥ã«ãPEAR ã®ãã¼ã«ã«çãã¤ã³ã¹ãã¼ã«ããã¾ãã + ã¤ã³ã¹ãã¼ã«ããããã¡ã¤ã«ã使ç¨ããã«ã¯ãPEAR ããã±ã¼ã¸ã使ãã³ã¼ãã«ããã¦ã + PHP ã® include_path ã以ä¸ã®ããã«ãã¦ã»ãããã¦ãã ããã + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); +?> +]]> + </programlisting> + </para> + <para> + ãããã¯ãapache ã® <filename>.htaccess</filename> ãã¡ã¤ã«ã§ + php_value ã使ãæ¹æ³ãããã¾ãã + </para> + </sect2> + + <sect2 id="installation.shared.ftp"> + <title>ftp ã使ç¨ããã¤ã³ã¹ãã¼ã«</title> + <para> + ftp ã使ç¨ã㦠PEAR ã®ãã¼ã«ã«ã³ãã¼ãã¤ã³ã¹ãã¼ã«ããã«ã¯ã + ã¢ãããã¼ãæã«ãã¡ã¤ã«ã®ãã¼ããã·ã§ã³ãè¨å®ã§ãã ftp ã¯ã©ã¤ã¢ã³ãã + å¿ è¦ã§ãã + ã¾ãããµã¼ãã®ãã¦ã§ãã«å ¬éããã¦ããªãå ´æã«ãã£ã¬ã¯ããªãã²ã¨ã¤ä½æãã + 好ããªååãã¤ãã¾ããããã¦ãå ¨ã¦ã¼ã¶ããèªã¿æ¸ãå¯è½ (0777) ã¨ãã¾ãã + http://go-pear.org ããã¦ã³ãã¼ããã<filename>go-pear.php</filename> + ã¨ããååã§ä¿åãã¾ãã<filename>go-pear.php</filename> ãã + ã¦ã§ãããã¢ã¯ã»ã¹å¯è½ãªãã£ã¬ã¯ããªã«ã¢ãããã¼ããã¾ãã + ï¼ã»ãã¥ãªãã£ã¼ã®ããï¼ + <filename>.htaccess</filename> ã使ã£ã¦ <filename>go-pear.php</filename> + ãå«ããã£ã¬ã¯ããªã«ãã¹ã¯ã¼ãå¶éããããã®ãè¯ãã§ãããã + </para> + <para> + 次ã«ã<filename>go-pear.php</filename> ãã¡ã¤ã«ããã©ã¦ãºãã¾ãã + ã¦ã§ãã¢ãã¬ã¹ã http://www.example.comã§ã<filename>go-pear.php</filename> ã + <filename>public_html/install/go-pear.php</filename> ã«ç½®ããå ´åã + http://www.example.com/install/go-pear.php ã«ã¢ã¯ã»ã¹ãã¦ãã ããã + 表示ãããã¤ã³ã¹ãã¼ã«ã®ç»é¢ã«å¾ãã¾ãã + ã©ãã« PEAR ãã¤ã³ã¹ãã¼ã«ãããè¨ãããããããã»ã©ä½æãã + å ¨ã¦ã¼ã¶ããèªã¿æ¸ãå¯è½ã«ãããã£ã¬ã¯ããªãæå®ãã¾ãã + ã¾ããCLI ãã¼ã¸ã§ã³ã® PHP ã®ããããç¥ãããå¿ è¦ãããã¾ãã + PHP ã®ãããã¯ã以ä¸ã®ã¹ã¯ãªããã®åºåãåç §ãã¦ãã ããã + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +echo `which php`; +// if this does not work, also try echo PHP_BIN; +?> +]]> + </programlisting> + </para> + <para> + PEAR ãã¤ã³ã¹ãã¼ã«ãããããä»ã® PEAR ã¤ã³ã¹ãã¼ã«ã®æ¹æ³ã¨åæ§ã«ã + web çã®ã¤ã³ã¹ãã¼ã©ã使ã£ã¦ãããã±ã¼ã¸ã®ã¤ã³ã¹ãã¼ã«ãã¢ããã°ã¬ã¼ãã + ã§ãã¾ãã + ã¤ã³ã¹ãã¼ã«ããã PEAR ã®ãã¡ã¤ã«ã使ãã«ã¯ãã¦ã§ããµã¤ãã®ã¹ã¯ãªããä¸ã§ + include path ãã»ããããå¿ è¦ãããã¾ãã + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); +?> +]]> + </programlisting> + </para> + </sect2> + </sect1> + + <sect1 id="installation.manually"> + <title>æåã¤ã³ã¹ãã¼ã«</title> + + <para> + ããã±ã¼ã¸ã®æåã¤ã³ã¹ãã¼ã«ã¯æ¨å¥¨ããã¾ããããããã + ãµã¤ããã·ã§ã«ã¢ã¯ã»ã¹ã®ç¡ããã¹ãã£ã³ã°ç°å¢ã®å ´åãèªåã®æ¹æ³ã§ã¯ + åé¡ãçããæ¹ãããã§ãããã + </para> + <para> + 以ä¸ã§ã¯ããµã¤ãã«ããã±ã¼ã¸ãæåã§ã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦ç¤ºãã¾ãã + ãã®ã¨ãããµã¤ãã®ããã¥ã¡ã³ãã®ã«ã¼ãã¯ã + <filename>/var/www/www.example.com/htdocs/</filename> ã¨ãã¾ãã + <filename>htdocs</filename> ã¨åãã¬ãã«ã«ã + <filename>includes</filename> ã¨ãããã£ã¬ã¯ããªãããã + ãã®ãã£ã¬ã¯ããªã¯ã<acronym>FTP</acronym> ã WebDAV ãã㯠+ ã¢ã¯ã»ã¹å¯è½ã§ããã<acronym>HTTP</acronym> ãã㯠+ ã¢ã¯ã»ã¹ä¸è½ã ã¨ãã¾ãã + </para> + <para> + ã¤ã³ã¹ãã¼ã«ã¯ãç°¡åãªããã¤ãã®ã¹ããããããªãã¾ãã + <orderedlist> + <listitem> + <simpara> + ããã±ã¼ã¸ããã¦ã³ãã¼ãããã + </simpara> + <para> + web ãã©ã¦ã¶ã使ã£ã¦ <ulink url="&url.pear;">PEAR ãã¼ã ãã¼ã¸</ulink> + ããããã±ã¼ã¸ããã¦ã³ãã¼ããã¾ãã + ãã¦ã³ãã¼ããããããã±ã¼ã¸æ å ±ã«ã¤ãã¦ã® <acronym>URL</acronym> + ãããããªãå ´åã¯ã<ulink url="&url.pear.package.browse;"> + ããã±ã¼ã¸ãã©ã¦ã¶</ulink>ã使ã£ã¦ç¾å¨å©ç¨å¯è½ãªããã±ã¼ã¸ã + 表示ããããã¨ãã§ãã¾ãã + </para> + </listitem> + <listitem> + <simpara> + ããã±ã¼ã¸ã®ã½ã¼ã¹ã³ã¼ããã¢ãããã¼ãããã + </simpara> + <para> + .tgz ãã¡ã¤ã«ããã¦ã³ãã¼ããããããã¼ã«ã«ãã·ã³ã®ãã³ãã©ãª ãã£ã¬ã¯ããªã« + 解åãã¾ããã½ã¼ã¹ã³ã¼ãã <acronym>FTP</acronym> ã WebDAV ç㧠+ <filename>/var/www/www.example.com/includes/</filename> ãã£ã¬ã¯ããªã« + ã¢ãããã¼ããã¾ããããã¨ã㯠Mail_Mime ã®ã³ã¼ãã¯ã + <filename>/var/www/www.example.com/includes/Mail/</filename> ã« + ç½®ãããã«ãã¾ãã + </para> + </listitem> + <listitem> + <simpara> + include_path ãã£ã¬ã¯ãã£ããè¨å®ããã + </simpara> + <para> + æå¾ã«ãã¢ãããã¼ãããã½ã¼ã¹ã³ã¼ãã®ããå ´æãå«ãããã«ã + PHP ã® include_path ãã£ã¬ã¯ãã£ããè¨å®ãã¾ãã + <filename>php.ini</filename> è¨å®ãã¡ã¤ã«ã«è§¦ããã¨ãã§ããå ´åã¯ã + <filename>/var/www/www.example.com/includes/</filename> ãã + ããã® include_path ãã£ã¬ã¯ãã£ãã«è¿½å ãã¾ãã + 触ããªãå ´åã¯ãPEAR ããã±ã¼ã¸ã使ãåã¹ã¯ãªããä¸ã§ + include_path ãã»ãããã¾ãã + </para> + <para> + <programlisting role="php"> +ini_set("include_path", '/var/www/www.example.com/includes/' . PATH_SEPARATOR . ini_get("include_path")); + </programlisting> + </para> + </listitem> + <listitem> + <simpara> + ã¤ã³ã¹ãã¼ã«ãæ¸ãã°ã以ä¸ã®ããã«ãã¦ãPEAR ããã±ã¼ã¸ã + 使ç¨ã§ããããã«ãªãã¾ãã + </simpara> + <para> + <programlisting role="php"> +require_once "Mail/Mime.php"; + +$mime = ... + </programlisting> + </para> + </listitem> + </orderedlist> + </para> + <para> + æåã¤ã³ã¹ãã¼ã«ã«ã¤ãã¦è³ªåãããå ´åã¯ã + <ulink url="&email.pear.general;">General ã¡ã¼ãªã³ã°ãªã¹ã</ulink>㧠+ 質åãã¦ãã ããã + </para> </sect1> <sect1 id="installation.cvs"> - <title>CVSã¤ã³ã¹ãã¼ã©</title> + <title>CVS ã¤ã³ã¹ãã¼ã©</title> <para> - CVSããPEARããã±ã¼ã¸ã®ææ°ã®éçºãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ããæ¹æ³ - ã説æãã¾ãã + ããã§ã¯ãCVS ããææ°ã®éçºçãã¤ã³ã¹ãã¼ã«ããæ¹æ³ã«ã¤ãã¦è¨è¿°ãã¾ãã + </para> + <para> + å®ç¨¼åç°å¢ã§ã¯ãCVS ããå¾ãããã±ã¼ã¸ãå®è¡ãããã¨ã¯æ§ããã¹ãã§ãã + CVS ãã¼ã¸ã§ã³ã¯é常ã®ãªãªã¼ã¹ã¨ç°ãªãã¾ããã¤ã¾ãã + <itemizedlist> + <listitem> + <simpara> + ã¡ã³ããä»ããã®æ´å©ãå¾ãããªãã + </simpara> + </listitem> + <listitem> + <simpara> + CVS ãã¼ã¸ã§ã³ã¯ãPEAR ã¤ã³ã¹ãã¼ã©ã®ã¢ããã°ã¬ã¼ãæ©è½ã + ç ´å£ãããã¨ãããã + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + CVS ããå¾ãããã±ã¼ã¸ã¯ã以ä¸ã®å ´åã«ã®ã¿ä½¿ç¨ããã¹ãã§ãã + <itemizedlist> + <listitem> + <simpara>ã¡ã³ãããå§ããå ´å</simpara> + </listitem> + <listitem> + <simpara>ããã±ã¼ã¸ã®éçºãæ´å©ãããå ´å</simpara> + </listitem> + <listitem> + <simpara>ãªãªã¼ã¹ããã¦ããªãæ©è½ãããããæ¬å½ã«å¿ è¦ã¨ãã¦ããå ´å</simpara> + </listitem> + </itemizedlist> + </para> + <para> + CVS ããããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«ããå ´åãããã±ã¼ã¸ã®ã¡ã³ããã + æ°ãããªãªã¼ã¹ãä½æããã®ã¨åãã¹ããããåãå¿ è¦ãããã¾ãã + 以ä¸ã®ããããã®ã¹ãããã§åé¡ãããå ´åã¯ãæ¬ããã¥ã¢ã«ã® + <link linkend="guide-developers">ãããããã¼ãºã¬ã¤ã</link>ã + åç §ãã¦ãã ããã + </para> + <orderedlist> + <listitem> + <para> + ããã±ã¼ã¸ã <ulink url="http://www.php.net/anoncvs.php"> + http://www.php.net/anoncvs.php</ulink> ã«è¨è¿°ã®éãã« CVS ãã + ãã§ãã¯ã¢ã¦ãããã + </para> + <para> + ãã§ãã¯ã¢ã¦ããã¹ãã¢ã¸ã¥ã¼ã«ã¯ã<filename>pear/<packagename></filename> + ã¨ãªãã¾ãããã¨ãã°ã + <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>ã + </para> + </listitem> + <listitem> + <para> + <filename>package.xml</filename> ããã§ãã¯ããfileset è¦ç´ ã + å®éã®ãã¡ã¤ã«ã»ãã£ã¬ã¯ããªæ§é ã«ãã£ã¦ãããã©ãã調ã¹ãã + ããç°ãªããªããã¡ã³ããã«é£çµ¡ãã¨ãã<filename>package.xml</filename> ã + ã¢ãããã¼ãããããã«é ¼ãã§ã¿ã¦ãã ããã + </para> + </listitem> + <listitem> + <para> + æå¹ãªããã±ã¼ã¸ã®ã¢ã¼ã«ã¤ãã PEAR ã¤ã³ã¹ãã¼ã©ã使ã£ã¦ä½æããã + <command>pear package <path to package.xml></command> + </para> + </listitem> + <listitem> + <para> + 対象ã®ããã±ã¼ã¸ãã¤ã³ã¹ãã¼ã«æ¸ã¿ã®æã¯ããã¼ã¸ã§ã³ã«é¢é£ããåé¡ã + é¿ããããã«åé¤ããã + <command>pear uninstall <package></command> + </para> + </listitem> + <listitem> + <para> + ããã±ã¼ã¸ã®ã¢ã¼ã«ã¤ããã¤ã³ã¹ãã¼ã«ããã + <command>pear install <package-file></command> + </para> + <para> + 以ä¸ã§ CVS ãã¼ã¸ã§ã³ãã¤ã³ã¹ãã¼ã«ããã¾ããã + </para> + </listitem> + </orderedlist> + <para> + ï¼CVS ãã¼ã¸ã§ã³ã¯ï¼ + ããã±ã¼ã¸ã®æ£å¼ãªãªã¼ã¹ã«ã§ããã ãæ©ãã¢ããã°ã¬ã¼ãããã¹ãã§ãã + æ£å¼ãªãªã¼ã¹ãã¤ã³ã¹ãã¼ã«ããåã«ã¯ããã¼ã¸ã§ã³ã«é¢é£ããåé¡ãé¿ããããã«ã + CVS ãã¼ã¸ã§ã³ãåé¤ãã¦ãã ããã </para> </sect1> http://cvs.php.net/diff.php/peardoc/ja/chapters/standards.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/ja/chapters/standards.xml diff -u peardoc/ja/chapters/standards.xml:1.1 peardoc/ja/chapters/standards.xml:1.2 --- peardoc/ja/chapters/standards.xml:1.1 Fri Apr 4 23:25:54 2003 +++ peardoc/ja/chapters/standards.xml Mon May 24 09:36:18 2004 @@ -1,37 +1,39 @@ <?xml encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.22 Maintainer: Status: ready --> +<!-- CREDITS: --> <chapter id="standards"> <title>æ¨æºã³ã¼ãã£ã³ã°è¦ç´</title> <note> <simpara> - PEARæ¨æºã³ã¼ãã£ã³ã°è¦ç´ã¯ãPEARã®å ¬å¼ãã£ã¹ããªãã¥ã¼ã·ã§ã³(PHP㨠- å ±ã«é å¸ããããPHP PEARã¬ãã¸ããªããã®ãã¦ã³ãã¼ãã«ããåå¾å¯è½) - ã«å«ã¾ããã³ã¼ãã«é©ç¨ããã¾ãã + PEAR æ¨æºã³ã¼ãã£ã³ã°è¦ç´ã¯ãPEAR ã®å ¬å¼ãã£ã¹ããªãã¥ã¼ã·ã§ã³ + ï¼PHP ã¨å ±ã«é å¸ãããããPHP PEAR ã¬ãã¸ããªãããã¦ã³ãã¼ãã«ãã + åå¾å¯è½ãªãã®ï¼ã«å«ã¾ããã³ã¼ãã«é©ç¨ããã¾ãã </simpara> </note> <sect1 id="standards.indenting"> <title>ã¤ã³ãã³ã</title> <para> - ã¿ãã§ã¯ãªãã空ç½4ã¤ã®ã¤ã³ãã³ãã使ç¨ãã¦ä¸ããã - PEARã³ã¼ããç·¨éããããã«Emacsã使ç¨ããå ´åãindent-tabs-modeã - nilã«è¨å®ããå¿ è¦ãããã¾ãã以ä¸ã«ããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã - Emacsãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã示ãã¾ãã(PHPãã¡ã¤ã«ãç·¨éãã - éã«ãããã³ã¼ã«ãããããã«ããå¿ è¦ãããã¾ã) + ã¿ãã§ã¯ãªããç©ºç½ 4 ã¤ã®ã¤ã³ãã³ãã使ç¨ãã¦ãã ããã + PEAR ã³ã¼ããç·¨éããããã« Emacs ã使ç¨ããå ´åãindent-tabs-mode ã + nil ã«è¨å®ããå¿ è¦ãããã¾ãã以ä¸ã«ããããã®ã¬ã¤ãã©ã¤ã³ã«åºã¥ã + Emacs ãè¨å®ããã¢ã¼ãããã¯ã®ä¾ã示ãã¾ãï¼PHP ãã¡ã¤ã«ãç·¨éããéã« + ãããã³ã¼ã«ãããããã«ããå¿ è¦ãããã¾ãï¼ã <programlisting role="elisp"> <![CDATA[ (defun php-mode-hook () (setq tab-width 4 c-basic-offset 4 c-hanging-comment-ender-p nil - indent-tabs-mode - (not - (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name)) - (string-match "\.php$" (buffer-file-name)))))) + indent-tabs-mode + (not + (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name)) + (string-match "\.php$" (buffer-file-name)))))) ]]> </programlisting> </para> <para> - 以ä¸ã«åæ§ãªãã¨ãè¡ãvimã«ã¼ã«ã示ãã¾ãã + 以ä¸ã«ãåæ§ãªãã¨ãè¡ã vim ã«ã¼ã«ã示ãã¾ãã <programlisting role="vim"> <![CDATA[ set expandtab @@ -41,13 +43,19 @@ ]]> </programlisting> </para> + <para> + ãããåè§ 75-85 æåãã¨ã«æ¹è¡ãããã¨ãæ¨å¥¨ãã¾ãã + æ¹è¡ããæåã®æ¹æ³ã«ã¤ãã¦ã®æ¨æºã«ã¼ã«ã¯åå¨ãã¾ããã®ã§ãèªèº«ã®å¤æã§è¡ã£ã¦ + ãã ãããçåãããã°ã<ulink url="mailto:&email.pear.qa;"> + PEAR å質ä¿è¨¼ã¡ã¼ãªã³ã°ãªã¹ã</ulink>ã§è³ªåãã¦ãã ããã + </para> </sect1> <sect1 id="standards.control"> <title>å¶å¾¡æ§é </title> <para> - å¶å¾¡æ§é ã«ã¯ãif, for, while, switchçãå«ã¾ãã¾ãã以ä¸ã«ãæãè¤ - éãªå¶å¾¡æ§é ã§ããifæã®ä¾ã示ãã¾ãã + å¶å¾¡æ§é ã«ã¯ãif, for, while, switch çãããã¾ãã以ä¸ã«ã + æãè¤éãªå¶å¾¡æ§é ã§ãã if æã®ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ if ((condition1) || (condition2)) { @@ -65,9 +73,9 @@ éã«ç©ºç½ã1ã¤ç½®ãã¹ãã§ãã </simpara> <simpara> - æ§æçã«ä»»æã®å ´åã«ã常ã«æ³¢æ¬å¼§ã使ç¨ãããã¨ãå¼·ãæ¨å¥¨ããã¾ãã - æ³¢æ¬å¼§ãä»ãããã¨ã«ããå¯èªæ§ãåä¸ããæ°ããè¡ã追å ãããéã«è« - ççãªã¨ã©ã¼ãç´ãããå¯è½æ§ãæ¸å°ãã¾ãã + æ§æçã«ä»»æã®å ´åã«ãã常ã«æ³¢æ¬å¼§ã使ç¨ãããã¨ãå¼·ãæ¨å¥¨ããã¾ãã + æ³¢æ¬å¼§ãä»ãããã¨ã«ããå¯èªæ§ãåä¸ããæ°ããè¡ã追å ãããéã« + è«ççãªã¨ã©ã¼ãç´ãããå¯è½æ§ãæ¸å°ãã¾ãã </simpara> <para> switchæã®å ´åã¯æ¬¡ã®ããã«ãã¾ãã @@ -96,9 +104,9 @@ <title>é¢æ°ã³ã¼ã«</title> <para> é¢æ°ã¯ãé¢æ°åã¨éãæ¬å¼§ããã³æåã®ãã©ã¡ã¼ã¿ã®éã«ç©ºç½ãç½®ããã - ã«ã³ãã¨åãã©ã¡ã¼ã¿ã®éã«ç©ºç½ãç½®ããæå¾ã®ãã©ã¡ã¼ã¿ã¨éæ¬å¼§ãã - ã³ã»ãã³ãã³ã®éã«ç©ºç½ãç½®ããã«ã³ã¼ã«ãã¹ãã§ãã以ä¸ã«ä¾ã示ãã¾ - ãã + ã«ã³ãã¨åãã©ã¡ã¼ã¿ã®éã«ã¯ç©ºç½ãç½®ããæå¾ã®ãã©ã¡ã¼ã¿ã¨éæ¬å¼§ + ããã³ã»ãã³ãã³ã®éã«ã¯ç©ºç½ãç½®ããã«ã³ã¼ã«ãã¹ãã§ãã + 以ä¸ã«ä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ $var = foo($bar, $baz, $quux); @@ -106,9 +114,9 @@ </programlisting> </para> <para> - ä¸è¨ã®ããã«ãé¢æ°ã®è¿ãå¤ãå¤æ°ã«ä»£å ¥ããéã«ä½¿ç¨ãããçå·ã®å·¦å³ - ã«ã¯ã空ç½ãï¼ã¤ç½®ãã¹ãã§ããç¸é¢ããä¸é£ã®ä»£å ¥æã®å ´åã«ã¯ãå¯èª - æ§ãåä¸ãããããã«ç©ºç½ãããå¤ãç½®ãã¦ãè¯ãã§ãããã + ä¸è¨ã®ããã«ãé¢æ°ã®è¿ãå¤ãå¤æ°ã«ä»£å ¥ããéã«ä½¿ç¨ãããçå·ã®å·¦å³ã«ã¯ã + 空ç½ãï¼ã¤ç½®ãã¹ãã§ããç¸é¢ããä¸é£ã®ä»£å ¥æã®å ´åã«ã¯ã + å¯èªæ§ãåä¸ãããããã«ç©ºç½ãããå¤ãç½®ãã¦ãè¯ãã§ãããã <programlisting role="php"> <![CDATA[ $short = foo($bar); @@ -121,7 +129,7 @@ <sect1 id="standards.funcdef"> <title>é¢æ°å®ç¾©</title> <para> - é¢æ°å®£è¨ã¯ã以ä¸ã®ãããª"one true brace"表è¨ã«åºã¥ãã¾ãã + é¢æ°å®£è¨ã¯ã以ä¸ã®ãã㪠<quote>one true brace</quote> 表è¨ã«åºã¥ãã¾ãã <programlisting role="php"> <![CDATA[ function fooFunction($arg1, $arg2 = '') @@ -136,8 +144,8 @@ </para> <para> ããã©ã«ãå¤ãæããå¼æ°ã¯å¼æ°ãªã¹ãã®çµããã«ç½®ãã¾ãã - ãã®é¢æ°ã¯å¦çãé©å½ã§ããå ´åã常ã«é¢æ°ããæå³ã®ããå¤ãè¿ããã - ã«ãã¦ä¸ããã以ä¸ã«ããé·ãä¾ã示ãã¾ãã + é¢æ°ã¯å¦çãé©å½ã§ããå ´åã常ã«é¢æ°ããæå³ã®ããå¤ãè¿ããã + ã«ãã¦ãã ããã以ä¸ã«ããé·ãä¾ã示ãã¾ãã <programlisting role="php"> <![CDATA[ function connect(&$dsn, $persistent = false) @@ -162,18 +170,18 @@ <sect1 id="standards.comments"> <title>ã³ã¡ã³ã</title> <para> - ã¯ã©ã¹ã®ã¤ã³ã©ã¤ã³ããã¥ã¡ã³ãã¯ãJavadocã«ä¼¼ãPHPDocã®è¡¨è¨ã«åºã¥ - ãå¿ è¦ãããã¾ããPHPDocã«é¢ãããã詳細ãªæ å ±ã¯ã + ã¯ã©ã¹ã®ã¤ã³ã©ã¤ã³ããã¥ã¡ã³ãã¯ãJavadoc ã«ä¼¼ã PHPDoc ã®è¡¨è¨ã«åºã¥ã + å¿ è¦ãããã¾ããPHPDoc ã«é¢ãããã詳細ãªæ å ±ã¯ã <ulink url="&url.phpdoc;">&url.phpdoc;</ulink>ã«ããã¾ãã </para> <para> - ããã¥ã¡ã³ã以å¤ã®ã³ã¡ã³ãã¯ãå¼·ãæ¨å¥¨ããã¾ããä¸è¬çãªç®å®ã¨ãã¦ã + ããã¥ã¡ã³ã以å¤ã®ã³ã¡ã³ãããå¼·ãæ¨å¥¨ããã¾ããä¸è¬çãªç®å®ã¨ãã¦ã ã³ã¼ãã®ããã»ã¯ã·ã§ã³ãè¦ãæã«ãããã説æããããªããªãã¨æã㨠ããããå¦çå 容ãå¿ããåã«ã³ã¡ã³ãã追å ããå¿ è¦ãããã¾ãã </para> <para> - Cè¨èªå½¢å¼ã®(/* */)ã¨æ¨æºC++ã³ã¡ã³ã(//)ã®ã©ã¡ãã使ç¨å¯è½ã§ãã - Perl/shellå½¢å¼ã®ã³ã¡ã³ã(#)ã®ä½¿ç¨ã¯æ¨å¥¨ããã¾ããã + C è¨èªå½¢å¼ (/* */) ã¨æ¨æº C++ ã³ã¡ã³ã (//) ã®ã©ã¡ãã使ç¨å¯è½ã§ãã + Perl/shell å½¢å¼ã®ã³ã¡ã³ã (#) ã¯ä½¿ç¨ããã¹ãã§ã¯ããã¾ããã </para> </sect1> @@ -181,19 +189,19 @@ <title>ã³ã¼ãã®èªã¿è¾¼ã¿</title> <para> ããã¯ã©ã¹ãã¡ã¤ã«ãç¡æ¡ä»¶ã§èªã¿è¾¼ãå ´åã¯ã - <function>require_once</function>ã使ç¨ãã¦ä¸ãããããã¯ã©ã¹ãã¡ - ã¤ã«ãæ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´å(ä¾ãã°ãfactoryã¡ã½ãã)ã¯ã - <function>include_once</function>ã使ç¨ãã¦ä¸ããã - ãããã¯ã©ã¡ããã¯ã©ã¹ãã¡ã¤ã«ã1度ã ãèªã¿è¾¼ã¾ãããã¨ãä¿è¨¼ãã¾ - ãããããã¯ãåããã¡ã¤ã«ãªã¹ããå ±æãã¦ãããæ··ç¨ãããã¨ã«ã¤ã - ã¦å¿é ããå¿ è¦ã¯ããã¾ããã<function>require_once</function>ã§èª - ã¿è¾¼ã¾ãããã¡ã¤ã«ã¯ã<function>include_once</function>ã«ããå度 + <function>require_once</function> ã使ç¨ãã¦ãã ãããããã¯ã©ã¹ãã¡ã¤ã«ã + æ¡ä»¶ä»ãã§èªã¿è¾¼ãå ´åï¼ä¾ãã°ãfactory ã¡ã½ããï¼ã¯ã + <function>include_once</function> ã使ç¨ãã¦ãã ããã + ã©ã¡ããã¯ã©ã¹ãã¡ã¤ã«ã1度ã ãèªã¿è¾¼ã¾ãããã¨ãä¿è¨¼ãã¾ãã + ãããã¯ãåããã¡ã¤ã«ãªã¹ããå ±æãã¦ãããæ··ç¨ãããã¨ã«ã¤ãã¦å¿é ãã + å¿ è¦ã¯ããã¾ããã<function>require_once</function> ã§èªã¿è¾¼ã¾ãã + ãã¡ã¤ã«ã¯ã<function>include_once</function> ã«ããå度 èªã¿è¾¼ã¾ãããã¨ã¯ããã¾ããã <note> <simpara> - <function>include_once</function>ããã³ - <function>require_once</function>ã¯å½ä»¤ã§ãããé¢æ°ã§ã¯ããã¾ã - ããèªã¿è¾¼ããã¡ã¤ã«åã®åå¾ã«æ¬å¼§ã¯ä¸è¦ã§ãã + <function>include_once</function> ããã³ + <function>require_once</function> ã¯å½ä»¤ã§ãããé¢æ°ã§ã¯ããã¾ããã + èªã¿è¾¼ããã¡ã¤ã«åã®åå¾ã«æ¬å¼§ã¯ä¸è¦ã§ãã </simpara> </note> </para> @@ -202,70 +210,67 @@ <sect1 id="standards.tags"> <title>PHPã³ã¼ãã¿ã°</title> <para> - PHPã³ã¼ããåºåããããã«<emphasis>ãç縮åã® - <literal><? ?></literal>ã§ã¯ãªãã常㫠- </emphasis><literal><?php ?></literal>ã使ç¨ãã¦ä¸ããã - PEAR対å¿ã®ããã«å¿ è¦ã§ããªãã¬ã¼ãã£ã³ã°ã·ã¹ãã ãè¨å®ãç°ãªãæ åµ - ã§PHPã³ã¼ããå°å ¥ããããã®æãäºææ§ã®é«ãæ¹æ³ã§ãããã¾ãã + PHPã³ã¼ããåºåããããã«ã¯ãç縮åã®<literal><? ?></literal>ã§ã¯ãªãã + <emphasis>常ã«</emphasis> <literal><?php ?></literal> ã使ç¨ãã¦ãã ããã + PEAR 対å¿ã®ããã«å¿ è¦ã§ããªãã¬ã¼ãã£ã³ã°ã·ã¹ãã ãè¨å®ãç°ãªãæ åµã§ + PHP ã³ã¼ããèªã¿è¾¼ãéã®æãäºææ§ã®é«ãæ¹æ³ã§ãããã¾ãã </para> </sect1> <sect1 id="standards.header"> <title>ãããã®ã³ã¡ã³ããããã¯</title> <para> - ã³ã¢PEARé å¸ãã¡ã¤ã«ã«ããå ¨ã¦ã®ã½ã¼ã¹ã³ã¼ããã¡ã¤ã«ã«ã¯ã以ä¸ã®ã³ - ã¡ã³ããããã¯ããããã¨ãã¦å«ã¾ãã¦ããå¿ è¦ãããã¾ãã + ã³ã¢ PEAR é å¸ãã¡ã¤ã«ã«ãããã¹ã¦ã®ã½ã¼ã¹ã³ã¼ããã¡ã¤ã«ã«ã¯ã + 以ä¸ã®ã³ã¡ã³ããããã¯ããããã¨ãã¦è¨è¼ããã¦ããå¿ è¦ãããã¾ãã <programlisting role="php"> -<![CDATA[ -/* vim: set expandtab tabstop=4 shiftwidth=4: */ +/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */ // +----------------------------------------------------------------------+ -// | PHP version 4.0 | +// | PHP version 4 | // +----------------------------------------------------------------------+ -// | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group | +// | Copyright (c) 1997-2004 The PHP Group | // +----------------------------------------------------------------------+ -// | This source file is subject to version 2.0 of the PHP license, | +// | This source file is subject to version 3.0 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | -// | available at through the world-wide-web at | -// | http://www.php.net/license/2_02.txt. | +// | available through the world-wide-web at the following url: | +// | http://www.php.net/license/3_0.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | license@php.net so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ -// | Authors: Original Author <author@example.com> | -// | Your Name <you@example.com> | +// | Authors: Original Author <author@example.com> | +// | Your Name <you@example.com> | // +----------------------------------------------------------------------+ // -// $Id: standards.xml,v 1.1 2003/04/05 04:25:54 hirokawa Exp $ -]]> +// $Id:$ </programlisting> </para> <para> - ããã½ã¼ã¹ãã¡ã¤ã«ã®ä½è ã®ãªã¹ãã«æ°ããªã³ã¼ãæä¾è ã®ååã追å ã - ãã¹ããã©ãããå®ç¾©ããæ確ãªè¦åã¯ããã¾ãããä¸è¬çã«ãä½è ã«å± - ããå¤æ´ç¹ã¯ã"æ¬è³ªçãª"åé¡ã«å±ãã(10%ãã20%ã®ã³ã¼ãå¤æ´ãæå³ - ãã¾ã)å¿ è¦ãããã¾ããé¢æ°ã®æ¸æããæ°ããªãã¸ãã¯ãæä¾ããå ´å - ã«ã¯ãä¾å¤ãããå ´åãããã¾ãã + ã½ã¼ã¹ãã¡ã¤ã«ã®ä½è ãªã¹ãã«æ°ããªã³ã¼ãæä¾è ã®ååã追å ããã¹ããã©ãã + ãå®ç¾©ããæ確ãªè¦åã¯ããã¾ãããä¸è¬çã«ã¯ã + <quote>ç¸å½ãª</quote>é¨åï¼10%ãã20%ã®ã³ã¼ãå¤æ´ãæå³ãã¾ãï¼ã®å¤æ´ã + è¡ã£ãå ´åã«ãä½è ã¨ããããã§ãã + é¢æ°ã®ãªã©ã¤ããæ°ããªãã¸ãã¯ã®æä¾ã®å ´åã«ã¯ãä¾å¤ããããã¾ãã </para> <para> ç°¡åãªã³ã¼ãã®æ´çããã°ä¿®æ£ã¯ãä½è ã®ãªã¹ãã«æ°ãã«å人ã追å ãã ã¾ã§ã®çç±ã«ã¯ãªãã¾ããã </para> <para> - ã³ã¢PEARãªãã¸ããªã«ãªããã¡ã¤ã«ã«ã¯ãä¼¼ããããªèä½æ¨©ãã©ã¤ã»ã³ã¹ã - ä½è ãè¨è¿°ãããããã¯ãå«ãå¿ è¦ãããã¾ããå ¨ã¦ã®ãã¡ã¤ã«ã«ã¯ãçµ± - ä¸ããmodelineã³ã¡ã³ããå«ãã¹ãã§ã + ã³ã¢ PEAR ãªãã¸ããªã«ãªããã¡ã¤ã«ã«ã¤ãã¦ããèä½æ¨©ã»ã©ã¤ã»ã³ã¹ã» + ä½è ãè¨è¿°ããåæ§ã®ãããã¯ãå«ãå¿ è¦ãããã¾ãããã¹ã¦ã®ãã¡ã¤ã«ã«ã¯ã + çµ±ä¸ããmodelineã³ã¡ã³ããå«ãã¹ãã§ã </para> </sect1> <sect1 id="standards.cvs"> <title>CVSã®ä½¿ç¨</title> <simpara> - æ¬ç¯ã¯ãcvs.php.netã«ããCVSã使ç¨ããããã±ã¼ã¸ã«ã®ã¿é©ç¨ããã¾ãã + æ¬ç¯ã¯ãcvs.php.net ã® CVS ã使ç¨ããããã±ã¼ã¸ã«ã®ã¿é©ç¨ããã¾ãã </simpara> <para> - åãã¡ã¤ã«ã«ãCVSã®ãã¼ã¯ã¼ã $Id$ ãå«ãã¦ä¸ããã - åãã¡ã¤ã«ãç·¨éããéãã¾ã ãªãå ´åã«ã¯ãã®ã¿ã°ã追å ãã¦ä¸ããã - (ã¾ãã¯ã"Last Modified:"ã®ãããªæ¢åã®å½¢å¼ãç½®æãã¦ä¸ãã) + åãã¡ã¤ã«ã«ãCVS ã®ãã¼ã¯ã¼ã $Id$ ãå«ãã¦ãã ããã + åãã¡ã¤ã«ãç·¨éããéãã¾ã ãªãå ´åã«ã¯ãã®ã¿ã°ã追å ãã¦ãã ãã + ï¼ã¾ãã¯ã<quote>Last Modified:</quote>ã®ãããªæ¢åã®å½¢å¼ãç½®æãã¦ãã ããï¼ã <!-- <note> <simpara> @@ -278,22 +283,22 @@ --> </para> <para> - æ¬ç¯ã®æ®ãã®é¨åã¯ãèªè ãCVSã¿ã°ããã³ãã©ã³ãã«é¢ããåºæ¬çãªç¥ - èãæãã¦ãããã¨ãåå ¤ã¨ãã¾ãã + æ¬ç¯ã®æ®ãã®é¨åã¯ãèªè ã CVS ã¿ã°ããã³ãã©ã³ãã«é¢ããåºæ¬ç㪠+ ç¥èãæãã¦ãããã¨ãåå ¤ã¨ãã¾ãã </para> <para> - CVSã¿ã°ã¯ãæå®ãããªãªã¼ã¹ã«å±ããããã±ã¼ã¸ã®ãã¡ã¤ã«ã®ãªãã¸ã§ - ã³ã示ãã©ãã«ã¨ãã¦ä½¿ç¨ããã¾ãã以ä¸ã«å¿ é åã³æ¨å¥¨ãããCVSã¿ã° - ã®ãªã¹ãã示ãã¾ãã + CVS ã¿ã°ã¯ãæå®ãããªãªã¼ã¹ã«å±ããããã±ã¼ã¸ã®ãã¡ã¤ã«ã®ãªãã¸ã§ã³ã + 示ãã©ãã«ã¨ãã¦ä½¿ç¨ããã¾ãã以ä¸ã«å¿ é åã³æ¨å¥¨ããã CVS + ã¿ã° ã®ãªã¹ãã示ãã¾ãã <variablelist> <varlistentry> <term>RELEASE_<replaceable>n_n</replaceable></term> <listitem> <simpara> - (å¿ é ) ãªãªã¼ã¹ç¨ã¿ã°ã¨ãã¦ä½¿ç¨ããã¾ããããã使ç¨ããªãå ´åã - ãªãªã¼ã¹æç¹ã®ç¶æ ã§CVSãµã¼ãããããã±ã¼ã¸ãåå¾ããæ段ã㪠- ããªãã¾ãã + ï¼å¿ é ï¼ãªãªã¼ã¹ç¨ã¿ã°ã¨ãã¦ä½¿ç¨ããã¾ããããã使ç¨ããªãå ´åã + ãªãªã¼ã¹æç¹ã®ç¶æ 㧠CVS ãµã¼ãããããã±ã¼ã¸ãåå¾ããæ段ã + ãªããªãã¾ãã </simpara> </listitem> </varlistentry> @@ -301,11 +306,10 @@ <term>QA_<replaceable>n_n</replaceable></term> <listitem> <simpara> - (ãã©ã³ã, ãªãã·ã§ã³) ãªãªã¼ã¹åã«ãªãªã¼ã¹ä¾¯è£çãå ¬éããå¿ - è¦ãããã¨èããå ´åã«ã¯ããªãªã¼ã¹çãåå²ããå®éã®ãªãªã¼ã¹å - ã«éè¦ãªä¿®æ£ã®ã¿ãé©ç¨ãããããã«ããã¨ããã®ã¯è¯ãèãã§ãã - ãã®éã«ãé常ã®éçºã¯ã¡ã¤ã³ãã©ã³ã¯ã«ããã¦ç¶ç¶ãããã¨ãå¯è½ - ã§ãã + ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ãªãªã¼ã¹åã«ãªãªã¼ã¹ä¾¯è£çãå ¬éããå¿ è¦ã + ããã¨èããå ´åã«ã¯ããªãªã¼ã¹çãåå²ããå®éã®ãªãªã¼ã¹åã«éè¦ãª + ä¿®æ£ã®ã¿ãé©ç¨ãããããã«ããã¨ããã®ã¯è¯ãèãã§ãã + ãã®éã«ããé常ã®éçºã¯ã¡ã¤ã³ãã©ã³ã¯ã«ããã¦ç¶ç¶ãããã¨ãå¯è½ã§ãã </simpara> </listitem> </varlistentry> @@ -313,33 +317,33 @@ <term>MAINT_<replaceable>n_n</replaceable></term> <listitem> <simpara> - (ãã©ã³ã, ãªãã·ã§ã³) (ä¾ãã°1.2ã®å¾ã«1.2.1ã¨ãã£ã)"ãã¤ã¯ã - ãªãªã¼ã¹"ãè¡ãéã«ãã¡ã¤ã³ã®éçºãã©ã³ã¯ãé常ã«æ´»æºã§ãã㤠- ã¯ããªãªã¼ã¹éã§å ããªå¤æ´ã®ã¿ãè¡ãããå ´åã«ããã©ã³ããä½¿ç¨ - ãããã¨ãã§ãã¾ãã + ï¼ãã©ã³ã, ãªãã·ã§ã³ï¼ï¼ä¾ãã°1.2ã®å¾ã«1.2.1ã¨ãã£ãï¼ + <quote>ãã¤ã¯ããªãªã¼ã¹</quote>ãè¡ãéã«ã + ã¡ã¤ã³ã®éçºãã©ã³ã¯ãé常ã«æ´»æºã§ããã¤ã¯ããªãªã¼ã¹é㧠+ å ããªå¤æ´ã®ã¿ãè¡ãããå ´åã«ããã©ã³ãã使ç¨ãããã¨ãã§ãã¾ãã </simpara> </listitem> </varlistentry> </variablelist> - RELEASEã¿ã°ã®ã¿ãå¿ é ã§ãæ®ãã¯æç¨ãªãã®ãæ¨å¥¨ãã¦ããã ãã§ãã + RELEASE ã¿ã°ã®ã¿ãå¿ é ã§ãæ®ãã¯æç¨ãªãã®ãæ¨å¥¨ãã¦ããã ãã§ãã </para> <para> - 以ä¸ã¯ã"Money_Fast"ããã±ã¼ã¸ã«1.2ãªãªã¼ã¹ã¿ã°ãä»ããæ¹æ³ã示ã - ãã®ã§ãã + 以ä¸ã¯ã<classname>Money_Fast</classname>ããã±ã¼ã¸ã« + 1.2 ãªãªã¼ã¹ã¿ã°ãä»ããæ¹æ³ã示ããã®ã§ãã <informalexample> <screen><prompt>$ </prompt><command>cd pear/Money_Fast</command> <prompt>$ </prompt><command>cvs tag RELEASE_1_2</command> <computeroutput>T Fast.php T README T package.xml - </computeroutput> - </screen> +</computeroutput> +</screen> </informalexample> - ããã«ãããPEAR Webãµã¤ãã§ãªãªã¼ã¹æé ã®æ®ããè¡ããã¨ãã§ããã - ãã«ãªãã¾ãã + ããã«ãããPEAR Web ãµã¤ãã§ãªãªã¼ã¹æé ã®æ®ããè¡ããã¨ã + ã§ããããã«ãªãã¾ãã </para> <para> - 以ä¸ã¯ãQAãã©ã³ããä½æããæ¹æ³ã示ãä¾ã§ãã + 以ä¸ã¯ãQA ãã©ã³ããä½æããæ¹æ³ã®ä¾ã§ãã <informalexample> <screen><prompt>$ </prompt><command>cvs tag QA_2_0_BP</command> ... @@ -350,17 +354,20 @@ <prompt>$ </prompt><command>cvs tag RELEASE_2_0</command> </screen> </informalexample> - "QA_2_0_BP"ã¿ã°ã¯"åå²ç¹"ã¿ã°ã§ãã¿ã°ã®éå§ç¹ã§ãããã®ãããªåå² - ç¹ããCVSãã©ã³ããéå§ããã®ã¯å¸¸ã«è¯ãèãã§ãã - MAINTãã©ã³ãã¯ãã®åå²ç¹ã¨åæ§ã«RELEASEã¿ã°ã使ç¨ãããã¨ãå¯è½ã§ - ãã + <literal>QA_2_0_0_BP</literal>ã¿ã°ã¯ã<quote>åå²ç¹ (branch point)</quote> + ã¿ã°ã§ãã¿ã°ã®éå§ç¹ã§ãããã®ãããªåå²ç¹ãã CVS ãã©ã³ããéå§ããã®ã¯ + 常ã«è¯ãèãã§ããMAINT ãã©ã³ãã¯ããã®åå²ç¹ã¨åæ§ã« RELEASE + ã¿ã°ã使ç¨ãããã¨ãå¯è½ã§ãã </para> </sect1> <sect1 id="standards.exampleurls"> - <title>URLã®ä¾</title> + <title> URL ã®ä¾</title> <para> - å ¨ã¦ã®URLã®ä¾ã«ã¤ãã¦RFC 2606ã«åºã¥ãURLã使ç¨ãã¦ä¸ããã + URL ã®ä¾ã«ã¯ã<literal>example.com</literal> ããã³ + <literal>example.org</literal>, <literal>example.net</literal> + ã使ç¨ãã¦ãã ãããé»åã¡ã¼ã«ã¢ãã¬ã¹ã¯ã + <ulink url="&url.rfc;2606">RFC 2606</ulink> ãåç §ãã¦ãã ããã </para> </sect1> @@ -369,19 +376,18 @@ <sect2> <title>ã¯ã©ã¹</title> <para> - ã¯ã©ã¹ã¯ãå 容ãåããååãæå®ããå¿ è¦ãããã¾ããå¯è½ãªãã°ç - ç¥ããååã使ç¨ãããã¨ã¯é¿ãã¦ä¸ãããã¯ã©ã¹åã¯ã常ã«å¤§æå㧠- å§ã¾ãå¿ è¦ãããã¾ããPEARã¯ã©ã¹é層ã¯ãã¯ã©ã¹åã«ãåæ ãããå - é層ã¬ãã«ã¯ãã¢ã³ãã¼ã¹ã³ã¢1ã¤ã§åºåããã¾ãã - è¯ãã¯ã©ã¹åã®ä¾ã以ä¸ã«ç¤ºãã¾ãã + ã¯ã©ã¹ã¯ãå 容ãåããååãæå®ããå¿ è¦ãããã¾ããå¯è½ãªãã°ç¥èªã® + 使ç¨ã¯é¿ãã¦ãã ãããã¯ã©ã¹åã¯ã常ã«å¤§æåã§å§ã¾ãå¿ è¦ãããã¾ãã + PEAR ã¯ã©ã¹é層ã¯ãã¯ã©ã¹åã«ãåæ ãããåé層ã¬ãã«ã¯ã + ã¢ã³ãã¼ã¹ã³ã¢1ã¤ã§åºåããã¾ããè¯ãã¯ã©ã¹åã®ä¾ã以ä¸ã«ç¤ºãã¾ãã <informaltable> <tgroup cols="3"> <tbody> - <row> - <entry><simpara>Log</simpara></entry> - <entry><simpara>Net_Finger</simpara></entry> - <entry><simpara>HTML_Upload_Error</simpara></entry> - </row> + <row> + <entry><simpara>Log</simpara></entry> + <entry><simpara>Net_Finger</simpara></entry> + <entry><simpara>HTML_Upload_Error</simpara></entry> + </row> </tbody> </tgroup> </informaltable> @@ -390,38 +396,39 @@ <sect2> <title>é¢æ°ã¨ã¡ã½ãã</title> <para> - é¢æ°ã¨ã¡ã½ããã¯ã"studly caps"å½¢å¼("bumpy case"ã¾ãã¯"camel - caps"ã¨ãå¼ã°ãã¾ã)ã使ç¨ãã¦ååãä»ããå¿ è¦ãããã¾ãã - é¢æ°ã¯ãããã±ã¼ã¸éã®ååã®è¡çªãé¿ããããã«ããã±ã¼ã¸åãæ¥é - è¾ã¨ãã¦å ããå¿ è¦ãããã¾ãã(æ¥é è¾ã®å¾ã®)ååã®æåã®æåã¯ã - å°æåã§ãæ°ããåèªãå§ããéã®åå é æåã¯å¤§æåã¨ãã¾ããä¾ã - ããã¤ã以ä¸ã«ç¤ºãã¾ãã + é¢æ°ã¨ã¡ã½ããã¯ã<quote>studly caps</quote>å½¢å¼ + ï¼<quote>bumpy case</quote> ã¾ã㯠<quote>camel caps</quote> ã¨ãå¼ã°ãã¾ãï¼ + ã使ç¨ãã¦ååãä»ããå¿ è¦ãããã¾ãã + é¢æ°ã¯ãããã±ã¼ã¸éã®ååã®è¡çªãé¿ããããã«ããã±ã¼ã¸åãæ¥é è¾ã¨ã㦠+ å ããå¿ è¦ãããã¾ããï¼æ¥é è¾ã®å¾ã®ï¼ååã®æåã®æåã¯å°æåã§ã + æ°ããåèªãå§ããéã®åå é æåã¯å¤§æåã¨ãã¾ãã + ä¾ãããã¤ã以ä¸ã«ç¤ºãã¾ãã <informaltable> <tgroup cols="4"> <tbody> - <row> - <entry><simpara>connect()</simpara></entry> - <entry><simpara>getData()</simpara></entry> - <entry><simpara>buildSomeWidget()</simpara></entry> - <entry><simpara>XML_RPC_serializeData()</simpara></entry> - </row> + <row> + <entry><simpara>connect()</simpara></entry> + <entry><simpara>getData()</simpara></entry> + <entry><simpara>buildSomeWidget()</simpara></entry> + <entry><simpara>XML_RPC_serializeData()</simpara></entry> + </row> </tbody> </tgroup> </informaltable> </para> <para> - ãã©ã¤ãã¼ãã¯ã©ã¹ã¡ã³ã(ãã®ã¯ã©ã¹ã¡ã³ãã¯å®£è¨ãããåãã¯ã©ã¹ã® - å é¨ããã®ã¿ä½¿ç¨ããããã¨ãæå³ãã¦ãã¾ããPHPã¯ãã©ã¤ãã¼ãåå - 空éãã¾ã ãµãã¼ããã¦ãã¾ãã)ã¯ãã¢ã³ãã¼ã¹ã³ã¢1ã¤ãåã«ä»ãã¾ - ããä¾ã以ä¸ã«ç¤ºãã¾ãã + ãã©ã¤ãã¼ããªã¯ã©ã¹ã¡ã³ãï¼å®£è¨ãããåãã¯ã©ã¹ã®å é¨ããã ãã®ä½¿ç¨ã + æå³ããã¯ã©ã¹ã¡ã³ãã + PHP ã¯ããã©ã¤ãã¼ãåå空éãã¾ã ãµãã¼ããã¦ãã¾ãããï¼ã¯ã + ã¢ã³ãã¼ã¹ã³ã¢ 1 ã¤ãåã«ä»ãã¾ããä¾ã以ä¸ã«ç¤ºãã¾ãã <informaltable> <tgroup cols="3"> <tbody> - <row> - <entry><simpara>_sort()</simpara></entry> - <entry><simpara>_initTree()</simpara></entry> - <entry><simpara>$this->_status</simpara></entry> - </row> + <row> + <entry><simpara>_sort()</simpara></entry> + <entry><simpara>_initTree()</simpara></entry> + <entry><simpara>$this->_status</simpara></entry> + </row> </tbody> </tgroup> </informaltable> @@ -430,10 +437,10 @@ <sect2> <title>å®æ°</title> <para> - å®æ°ã¯å¸¸ã«å ¨ã¦å¤§æåã§è¨è¿°ããåèªãåºåãéã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã - 使ç¨ãã¾ãã使ç¨ãããã¯ã©ã¹/ããã±ã¼ã¸ã大æåã§è¡¨ããååãåç½® - å®æ°åã¨ãã¦ä½¿ç¨ãã¾ããä¾ãã°ã<literal>DB::</literal>ããã±ã¼ã¸ - ã§ä½¿ç¨ãããå®æ°ã¯å ¨ã¦"<literal>DB_</literal>"ã§å§ã¾ãã¾ãã + å®æ°ã¯ã常ã«ãã¹ã¦å¤§æåã§è¨è¿°ããåèªãåºåãéã«ã¯ã¢ã³ãã¼ã¹ã³ã¢ã + 使ç¨ãã¾ãã使ç¨ãããã¯ã©ã¹ï¼ããã±ã¼ã¸ã大æåã§è¡¨ããååã + å®æ°ã®æ¥é è¾ã¨ãã¦ä½¿ç¨ãã¾ããä¾ãã°ã<literal>DB::</literal> ããã±ã¼ã¸ + ã§ä½¿ç¨ãããå®æ°ã¯ãã¹ã¦<literal>DB_</literal>ã§å§ã¾ãã¾ãã </para> </sect2> <sect2> @@ -441,11 +448,235 @@ <para> ããã±ã¼ã¸ã§ã°ãã¼ãã«å¤æ°ãå®ç¾©ããå¿ è¦ãããå ´åããã®ååã¯ã ã¢ã³ãã¼ã¹ã³ã¢ã§å§ã¾ãããã®å¾ã«ããã±ã¼ã¸åã¨å¥ã®ã¢ã³ãã¼ã¹ã³ã¢ - ãç¶ãããã«ããå¿ è¦ãããã¾ããä¾ãã°ãPEARããã±ã¼ã¸ã¯ã - $_PEAR_destructor_object_listã¨ããååã®ã°ãã¼ãã«å¤æ°ã使ç¨ãã¾ - ãã + ãç¶ãããã«ããå¿ è¦ãããã¾ããä¾ãã°ãPEAR ããã±ã¼ã¸ã¯ã + $_PEAR_destructor_object_list ã¨ããååã®ã°ãã¼ãã«å¤æ°ã使ç¨ãã¾ãã </para> </sect2> + </sect1> + + <sect1 id="standards.sample"> + <title>ãµã³ãã«ãã¡ã¤ã«</title> + <para> + ãµã³ãã«ä¸ã® <command>Id</command> ã¨ãã CVS ãã¼ã¯ã¼ãã¯ãä»èªãã§ãã + ããã¥ã¡ã³ãã®ä½æã«ä½¿ããããã¡ã¤ã«ã«é¢ãããã¼ã¿ãä¿æãã¦ãã¾ãã + èªèº«ã® PEAR ã¹ã¯ãªãããä½æããå ´åã¯ã空ã®ãã¼ã¯ã¼ã + <literal>$Id:$</literal> ã«ç½®ãæãã¦ãã ããã + </para> + <para> + ä¸ä¸å·¦å³æ¹åã®ã¹ãã¼ã¹ã«ã注æãã¦ãã ããããããããè¦ç´ã®ä¸é¨ã§ãã + </para> + <para> + <quote>æãç³ã¿ãã¼ã« (fold markers)</quote> + ï¼<literal>// {{{</literal> ããã³ <literal>// }}}</literal>ï¼ + ã¯ããªãã·ã§ã³ã§ããæãç³ã¿ãã¼ã«ã使ããªãå ´åã¯ã + <literal>foldmethod=marker</literal> ã vim ã®ãããããåé¤ãã¦ãã ããã + </para> + <para> + ãµã³ãã«ã«ã¯ãDocblock ã³ã¡ã³ãã®æ¸ãæ¹ã®å¤ãã®è©³ç´°ãè¨è¼ããã¦ãã¾ãã + ãããã®æ示ã«å¾ããã¨ã¯ã2 ã¤ã®æå³ã§éè¦ã§ãã第1ã¯ãdocblocks 㯠+ èªã¿ããããã³ã¼ããä½ã®åä½ãããããã¦ã¼ã¶ãéçºè ããã°ããç解ã§ãã¾ãã + 第2ã«ãPEAR ã® WEB ãµã¤ãã§ã¯ãããã±ã¼ã¸ã®åãªãªã¼ã¹ã«å¯¾ã㦠+ phpDocumentor ã«ããçæãããããã¥ã¡ã³ããæ²è¼ãã¦ãã¾ãã + WEB ãµã¤ãä¸ã® API ããã¥ã¡ã³ããå½¹ç«ã¤ãã®ã«ããã«ã¯ã + ãã¡ãã¨ã³ã¡ã³ããè¨è¿°ããå¿ è¦ãããã¾ãã + </para> + <para> + <programlisting role="php"> + <![CDATA[ +<?php +/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4 foldmethod=marker: */ +// +----------------------------------------------------------------------+ +// | PHP version 4 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 1997-2004 The PHP Group | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 3.0 of the PHP license, | +// | that is bundled with this package in the file LICENSE, and is | +// | available through the world-wide-web at the following url: | +// | http://www.php.net/license/3_0.txt. | +// | If you did not receive a copy of the PHP license and are unable to | +// | obtain it through the world-wide-web, please send a note to | +// | license@php.net so we can mail you a copy immediately. | +// +----------------------------------------------------------------------+ +// | Authors: Original Author <author@example.com> | +// | Your Name <you@example.com> | +// +----------------------------------------------------------------------+ +// +// $Id: standards.xml,v 1.2 2004/05/24 13:36:18 haruki Exp $ + +require_once 'PEAR.php'; + +// {{{ constants + +/** + * This is a "Docblock Comment," also known as a "docblock." The class' + * docblock, below, contains a complete description of how to write these. + */ +define('NET_SAMPLE_OK', 1); + +// }}} +// {{{ Net_Sample + +/** + * An example of how to write code to PEAR's standards + * + * Docblock comments start with "/**" at the top. Notice how the "/" + * lines up with the normal indenting and the asterisks on subsequent rows + * are in line with the first asterisk. The last line of comment text + * should be immediately followed on the next line by the closing asterisk + * and slash and then the item you are commenting on should be on the next + * line below that. Don't add extra lines. Please put a blank line + * between paragraphs as well as between the end of the description and + * the start of the @tags. Wrap comments before 80 columns in order to + * ease readability for a wide variety of users. + * + * Docblocks can only be used for programming constructs which allow them + * (classes, properties, methods, defines, includes, globals). See the + * phpDocumentor documentation for more information. + * http://phpdoc.org/docs/HTMLSmartyConverter/default/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html + * + * The Javadoc Style Guide is an excellent resource for figuring out + * how to say what needs to be said in docblock comments. Much of what is + * written here is a summary of what is found there, though there are some + * cases where what's said here overrides what is said there. + * http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#styleguide + * + * The first line of any docblock is the summary. Make them one short + * sentence, without a period at the end. Summaries for classes, properties + * and constants should omit the subject and simply state the object, + * because they are describing things rather than actions or behaviors. + * + * Below are the tags commonly used for classes. @category through @access + * are required. The remainder should only be used when necessary. + * Please use them in the order they appear here. phpDocumentor has + * several other tags available, feel free to use them. + * + * @category categoryname + * @package packagename + * @author Original Author <author@example.com> + * @version $Id: standards.xml,v 1.2 2004/05/24 13:36:18 haruki Exp $ + * @access public + * @see NetOther, Net_Sample::Net_Sample() + * @since Class available since Release 1.2.0 + * @deprecated Class deprecated in Release 2.0.0 + */ +class Net_Sample +{ + // {{{ properties + + /** + * The status of foo's universe + * + * Potential values are 'good', 'fair', 'poor' and 'unknown'. + * + * @var string + */ + var $foo = 'unknown'; + + // }}} + // {{{ setFoo() + + /** + * Registers the status of foo's universe + * + * Summaries for methods should use 3rd person declarative rather + * than 2nd person imperative, begining with a verb phrase. + * + * Summaries should add description beyond the method's name. The + * best method names are "self-documenting", meaning they tell you + * basically what the method does. If the summary merely repeats + * the method name in sentence form, it is not providing more + * information. + * + * Summary Examples: + * + Sets the label (preferred) + * + Set the label (avoid) + * + This method sets the label (avoid) + * + * Below are the tags commonly used for methods. A @param tag is + * required for each parameter the method has. The @return and + * @access tags are mandatory. The @throws tag is required if the + * method uses exceptions. @static is required if the method can + * be called statically. The remainder should only be used when + * necessary. Please use them in the order they appear here. + * phpDocumentor has several other tags available, feel free to use + * them. + * + * The @param tag contains the data type, then the parameter's + * name, followed by a description. By convention, the first noun in + * the description is the data type of the parameter. Articles like + * "a", "an", and "the" can precede the noun. The descriptions + * should start with a phrase. If further description is necessary, + * follow with sentences. Having two spaces between the name and the + * description aids readability. + * + * When writing a phrase, do not capitalize and do not end with a + * period: + * + the string to be tested + * + * When writing a phrase followed by a sentence, do not capitalize the + * phrase, but end it with a period to distinguish it from the start + * of the next sentence: + * + the string to be tested. Must use UTF-8 encoding. + * + * Return tags should contain the data type then a description of + * the data returned. The data type can be any of PHP's data types + * (int, float, bool, string, array, object, resource, mixed) + * and should contain the type primarily returned. For example, if + * a method returns an object when things work correctly but false + * when an error happens, say 'object' rather than 'mixed.' Use + * 'void' if nothing is returned. + * + * @param string $arg1 the string to quote + * @param int $arg2 an integer of how many problems happened. + * Indent to the description's starting point + * for long ones. + * + * @return int the integer of the set mode used. FALSE if foo + * foo could not be set. + * @throws exceptionclass [description] + * + * @access public + * @static + * @see Net_Sample::$foo, Net_Other::someMethod() + * @since Method available since Release 1.2.0 + * @deprecated Method deprecated in Release 2.0.0 + */ + function setFoo($arg1, $arg2 = 0) + { + /* + * This is a "Block Comment." The format is the same as + * Docblock Comments except there is only one asterisk at the + * top. phpDocumentor doesn't parse these. + */ + if ($arg1 == 'good' || $arg1 == 'fair') { + $this->foo = $arg1; + return 1; + } elseif ($arg1 == 'poor' && $arg2 > 1) { + $this->foo = 'poor'; + return 2; + } else { + return false; + } + } + + // }}} +} + +// }}} + +/* + * Local variables: + * tab-width: 4 + * c-basic-offset: 4 + * c-hanging-comment-ender-p: nil + * End: + */ + +?> + ]]> + </programlisting> + </para> </sect1> </chapter> http://cvs.php.net/diff.php/peardoc/ja/chapters/support.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/ja/chapters/support.xml diff -u peardoc/ja/chapters/support.xml:1.4 peardoc/ja/chapters/support.xml:1.5 --- peardoc/ja/chapters/support.xml:1.4 Thu Aug 14 02:49:45 2003 +++ peardoc/ja/chapters/support.xml Mon May 24 09:36:18 2004 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.4 $ --> -<!-- sync: 1.7 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.8 Maintainer: Status: ready --> +<!-- CREDITS: --> <chapter id="support"> <title>ãµãã¼ã</title> <simpara> - æ¬ç« ã¯ãPEARã«é¢ãã質åãããå ´åã«ãµãã¼ããåããæ¹æ³ã説æãã - ãã®ã§ãã + æ¬ç« ã¯ãPEAR ã«é¢ãã質åãããå ´åã«ãµãã¼ããåããæ¹æ³ã説æãããã®ã§ãã </simpara> <sect1 id="support.lists"> @@ -14,167 +14,211 @@ <sect2> <title>æ¦è¦</title> <para> - å¤ãã®ä»ã®ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã¨åæ§ã«ããµãã¼ãã¯ã¡ã¼ãªã³ - ã°ãªã¹ããéãã¦è¡ããã¾ããç¾å¨ã以ä¸ã«ç¤ºã4ã¤ã®PEARé¢é£ã®ã¡ã¼ãª - ã³ã°ãªã¹ããããã¾ãã + ä»ã®å¤ãã®ãªã¼ãã³ã½ã¼ã¹ããã¸ã§ã¯ãã¨åæ§ã«ããµãã¼ã㯠+ ã¡ã¼ãªã³ã°ãªã¹ããéãã¦è¡ããã¾ãã + ç¾å¨ãPEAR é¢é£ãã¦ã¯ã以ä¸ã«ç¤ºãã¡ã¼ãªã³ã°ãªã¹ããããã¾ãï¼ããããè±èªï¼ã <itemizedlist> <listitem> <para> - <link linkend="support.lists.general">Generalãªã¹ã</link> + <link linkend="support.lists.general">ç·åã¡ã¼ãªã³ã°ãªã¹ã + (general list)</link> </para> </listitem> <listitem> <para> - <link linkend="support.lists.dev">Developersãªã¹ã</link> + <link linkend="support.lists.dev">éçºè ã¡ã¼ãªã³ã°ãªã¹ã + (developers list)</link> </para> </listitem> <listitem> <para> - <link linkend="support.lists.documentation">Documentationãªã¹ã</link> + <link linkend="support.lists.documentation">ææ¸é¢é£ã¡ã¼ãªã³ã°ãªã¹ã + (documentation list)</link> </para> </listitem> <listitem> <para> - <link linkend="support.lists.webmaster">Webmasterãªã¹ã</link> + <link linkend="support.lists.webmaster">WEB é¢é£ã¡ã¼ãªã³ã°ãªã¹ã + (webmaster list)</link> </para> </listitem> <listitem> <para> - CVS commitãªã¹ã + CVS ã¡ã¼ãªã³ã°ãªã¹ã (CVS list) + </para> + </listitem> + <listitem> + <para> + <link linkend="support.lists.core">ã³ã¢éçºã¡ã¼ãªã³ã°ãªã¹ã + (Core development list)</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="support.lists.qa">å質ä¿è¨¼ã¡ã¼ãªã³ã°ãªã¹ã + (QA list)</link> </para> </listitem> </itemizedlist> </para> <para> - æåã®3ã¤ã®ãªã¹ãã¯ã質åãããå ´åã«å©ãã¨ãªãããã®ãã®ã§ãã以 - ä¸ãèªãã§ãã©ã®ãªã¹ããèªåã®ãã¼ãºã«åè´ããããç¥ã£ã¦ä¸ããã - CVS commit ãªã¹ãã¯ãPEARã«è²¢ç®ãã人ç¨ã§ãããªãã¸ã§ã³ç®¡çã·ã¹ã - ã (CVS)ã¸ã®å ¨ã¦ã®ã³ãããã¯ãã®ãªã¹ãã«éããã¾ãã + æåã®4ã¤ã®ãªã¹ãã¯ã質åãããå ´åã«å©ãã¨ãªãããã®ãã®ã§ãã + 以ä¸ãèªãã¨ãã©ã®ãªã¹ããèªåã®ãã¼ãºã«åè´ãããããããã§ãããã + CVS ãªã¹ãã¯ãPEARã«ã³ã¼ããå¯ä¸ãã人åãã§ãã + ãªãã¸ã§ã³ç®¡çã·ã¹ãã (CVS) ã¸ã®ãã¹ã¦ã®ã³ãããã¯ã + ãã®ãªã¹ãã«å 容ãéä¿¡ããã¾ãã + ã³ã¢éçºããã³å質ä¿è¨¼ãªã¹ãã¯ãPEAR ã®éçºã«åå ãããæ¹ã ã®ããã®ãã®ã§ãã </para> <para> - PEARã¡ã¼ãªã³ã°ãªã¹ãã«ã¯ã - <ulink url="&url.pear.support;">ãã®Webãµã¤ã</ulink>ã§ç»é²ã§ãã¾ - ãã + PEAR ã®åã¡ã¼ãªã³ã°ãªã¹ãã«ã¯ã + <ulink url="&url.pear.support;">ãã¡ãã® WEB ãµã¤ã</ulink>㧠+ ç»é²ã§ãã¾ãã </para> </sect2> <sect2 id="support.lists.general"> - <title>Generalã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>ç·åã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - The <ulink url="mailto:&email.pear.general">PEAR general - mailing list</ulink> is the mailing list, where you ask, if you - have a question about installing PEAR, using a certain PEAR - package etc. + PEAR <ulink url="mailto:&email.pear.general">ç·åã¡ã¼ãªã³ã°ãªã¹ã</ulink>ã¯ã + PEAR ã®ã¤ã³ã¹ãã¼ã«ã PEAR ããã±ã¼ã¸ã®ä½¿ç¨ã«é¢ãã質åãããå ´åã«ä½¿ããã + ã¡ã¼ãªã³ã°ãªã¹ãã§ãã </para> <para> - The list is no support forum for question concerning the usage - of PHP. Please use <ulink url="mailto:php-general@lists.php.net"> - php-general@lists.php.net</ulink> instead. + PHP èªä½ã®ä½¿ç¨ã«ã¤ãã¦ã®è³ªåã«å¯¾ãããµãã¼ããã©ã¼ã©ã ã§ã¯ããã¾ããã + ããã«ã¯ <ulink url="mailto:php-general@lists.php.net"> + php-general@lists.php.net</ulink> ãå©ç¨ãã ããã </para> - </sect2> + </sect2> <sect2 id="support.lists.dev"> - <title>Developersã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>éçºè ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - As the name already tells you, this list is the place where the - developers of PEAR come together to make decisions, to discuss - about code and to handle things that are related to this. + ååããå¤ãã¨ããããã®ãªã¹ã㯠PEAR ã®éçºè ãéã¾ãã + 決å®ãä¸ããããã³ã¼ãã«ã¤ãã¦ã®è°è«ãè¡ã£ããã + é¢é£ããäºé ãæ±ã£ããããããã®ãã®ã§ãã </para> <para> - If you are no developer of PEAR itself, this list is of no real - interest for you, unless + ããªãã PEAR ã®éçºè ã§ã¯ãªãå ´åã§ãã以ä¸ã®å ´åã«ã¯ + å½¹ã«ãã¤ããç¥ãã¾ããã <itemizedlist> <listitem> <simpara> - you want to get to know what's going on behind PEAR + PEAR ã®èå°è£ã§èµ·ãã£ã¦ãããã¨ãç¥ãããæ </simpara> </listitem> <listitem> <simpara> - you want to contribute code to PEAR + PEAR ã«ã³ã¼ããå¯ä¸ãããæ </simpara> </listitem> <listitem> <simpara> - you have found a bug in a PEAR package and want to supply a - patch for that. + ãã PEAR ããã±ã¼ã¸ã«ãã°ãè¦ã¤ããããããæ稿ãããæ </simpara> </listitem> </itemizedlist> </para> <para> - The adress for this list is <ulink url="mailto:&email.pear.dev"> - &email.pear.dev</ulink>. + ãã®ãªã¹ãã®ã¢ãã¬ã¹ã¯ã<ulink url="mailto:&email.pear.dev"> + &email.pear.dev</ulink> ã§ãã </para> </sect2> <sect2 id="support.lists.documentation"> - <title>ããã¥ã¡ã³ãä½æç¨ã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>ææ¸é¢é£ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - <ulink url="mailto:&email.pear.doc">This list</ulink> is the - place, where all the things concerning the PEAR documentation, - the manual etc. are discussed. + <ulink url="mailto:&email.pear.doc">ãã®ãªã¹ã</ulink>ã¯ã + PEAR ã®ããã¥ã¡ã³ããããã¥ã¢ã«ã«é¢ãããã¹ã¦ã®äºé ãè°è«ããå ´æã§ãã </para> <para> - If you want to help out documenting PEAR packages, don't hesitate - to drop a mail there. + PEAR ããã±ã¼ã¸ã®ããã¥ã¡ã³ãã«é¢ãã¦ä½ãæ´å©ããããå ´åã + 御æ°æ¥½ã«ã¡ã¼ã«ãæ稿ãã¦ãã ããã </para> </sect2> <sect2 id="support.lists.qa"> - <title>The QA mailing list</title> + <title>å質ä¿è¨¼ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - People being interested in improving the overall quality of PEAR - come together on the <ulink url="mailto:&email.pear.qa;">QA list</ulink>. + PEAR ã®å ¨ä½çãªå質ã®åä¸ã«èå³ã®ããè ã + <ulink url="mailto:&email.pear.qa;">å質ä¿è¨¼ãªã¹ã</ulink>ã«åå ãã¦ãã¾ãã </para> <para> - The Quality Insurance team is always seeking people that want to - help. If you are interested, just - <ulink url="&url.pear.support;">sign up</ulink> and announce - yourself on the mailing list. + å質ä¿è¨¼ãã¼ã ã¯ã常æãæ´å©ãã¦ãããæ¹ãæ¢ãã¦ãã¾ãã + èå³ã®ããæ¹ã¯ã<ulink url="&url.pear.support;">ãµã¤ã³ã¢ãã</ulink>ãã¦ã + æ¬ã¡ã¼ãªã³ã°ãªã¹ãã«ã¢ãã¦ã³ã¹ãã¦ãã ããã </para> </sect2> <sect2 id="support.lists.webmaster"> - <title>Webmasterã¡ã¼ãªã³ã°ãªã¹ã</title> + <title>WEB é¢é£ã¡ã¼ãªã³ã°ãªã¹ã</title> <para> - If you have found a problem on our website or have a question - concerning the site, you can email the guys on + PEAR ã® WEB ãµã¤ãã«åé¡ãè¦ã¤ãããããµã¤ãã«é¢ãã質åãããå ´åã¯ã <ulink url="mailto:&email.pear.webmaster;">&email.pear.webmaster; - </ulink>. + </ulink> ã«ã¡ã¼ã«ãã¦ãã ããã + </para> + </sect2> + + <sect2 id="support.lists.core"> + <title>ã³ã¢éçºã¡ã¼ãªã³ã°ãªã¹ã</title> + <para> + <ulink url="mailto:&email.pear.core;">ãã®ãªã¹ã</ulink>ã¯ã + PEAR ã®å種ã¤ã³ãã©ã«ã¤ãã¦è°è«ããå ´ã§ããPECL ã PHP + å質ä¿è¨¼ãªã© PHP ã®ä»ã®ããã¸ã§ã¯ãã®é¢ã ãã¡ã³ãã¼ã¨ãã¦åå ãã¦ãã¾ãã + ã¨ããã®ãã + ï¼PEAR ã¤ã³ã¹ãã¼ã©ã PEAR WEB ãµã¤ããªã©ã®ï¼PEAR ã®ã¤ã³ãã©ã¯ã + ä»ã®ããã¸ã§ã¯ãã«ãé¢é£ãã¦ããããã§ãã + </para> + <para> + ç¹ã«ä»¥ä¸ã®ãããã¯ãæ±ãã¾ãã + <itemizedlist> + <listitem> + <simpara> + PEAR WEB ãµã¤ãã®æ°æ©è½ã«ã¤ã㦠+ </simpara> + </listitem> + <listitem> + <simpara> + PEAR ã¤ã³ã¹ãã¼ã©ã®éçºã«ã¤ã㦠+ </simpara> + </listitem> + <listitem> + <simpara> + å種㮠PEAR æ¨æºã®å®ç¾©ã«ã¤ã㦠+ </simpara> + </listitem> + </itemizedlist> </para> </sect2> </sect1> <sect1> - <title>Webãªã½ã¼ã¹</title> - + <title>WEB ãªã½ã¼ã¹</title> + <para> - There are a number of web sites that deal with PEAR. We have - compiled a list of them - <ulink url="&url.pear.support;">here</ulink>. If a - site is missing, you can email - <ulink url="mailto:&email.pear.webmaster;">the webmaster</ulink>. + PEAR ã«ã¤ãã¦æ±ã£ã¦ãã WEB ãµã¤ãã¯æ°å¤ãåå¨ãã¾ãã + ãããã®ãªã¹ããã<ulink url="&url.pear.support;">ãã¡ã</ulink>㧠+ ä½æãã¦ãã¾ãã + ããããµã¤ããæ¶ãã¦ããå ´åã¯ã<ulink url="mailto:&email.pear.webmaster;"> + webmaster</ulink> ã¸ã¡ã¼ã«ãã¦ãã ããã </para> </sect1> <sect1 id="support.irc"> - <title>IRCã®#PEAR</title> + <title>IRC ã® #PEAR</title> <para> - PEARããã¸ã§ã¯ãã«ã¯å°ç¨ã®IRCãã£ã³ãã«#PEARãããã<ulink - url="&url.efnet;">EFnet</ulink>ã§å©ç¨å¯è½ã§ãã - åå ãã¦ãã°ã«ã¼ãã¡ã«åã£ã¦ä¸ãããå½¼ãã®ã¤ã³ã¿ã¼ãããæ¥ - ç¶ã®æéãè² æ ããå¿ è¦ã¯ãªããä¸æ¥ä¸IRCã«æ¥ç¶ããã¾ã¾ã¨ãããã¨ã - ã§ãã¾ãã + PEAR ããã¸ã§ã¯ãã«ã¯å°ç¨ã® IRC ãã£ã³ãã« #PEAR ãããã<ulink + url="&url.efnet;">EFnet</ulink> ã§å©ç¨å¯è½ã§ãã + åå ãã¦ãã°ã«ã¼ãã¡ã«é¢ã£ã¦ä¸ãããå½¼ãã®ã¤ã³ã¿ã¼ãããæ¥ç¶ã®æéã + è² æ ããå¿ è¦ã¯ãªããä¸æ¥ä¸ IRC ã«æ¥ç¶ããã¾ã¾ã¨ãããã¨ãã§ãã¾ãã </para> </sect1>