cvs: peardoc /ja/chapters pear2cs.xml standards.xml /ja/chapters/faq users.xml /ja/chapters/installation getting.xml introduction.xml /ja/guide/developers package2.xml release.xml /ja/guide/developers/package2 license.xml /ja/guide/newmaint getting-started.xml when-to-contribute.xml /ja/package/caching/cache-lite/cache-lite extendlife.xml /ja/package/database/db-dataobject/db-dataobject whereadd.xml /ja/package/html/html-quickform/html-quickform-hierselect html-quickform-hierselect.xml setoptions.xml /ja/package/html/pager pager.xml /ja/package/php/php-codesniffer config-options.xml /ja/package/webservices/xml-rpc support.xml
[email protected] ("TAKAGI Masahiro")
| Newsgroups | php.pear.doc |
|---|---|
| Message-ID | <cvstakagi1196591076@cvsserver> |
takagi Sun Dec 2 10:24:36 2007 UTC
Modified files:
/peardoc/ja/package/webservices/xml-rpc support.xml
/peardoc/ja/package/php/php-codesniffer config-options.xml
/peardoc/ja/package/html/pager pager.xml
/peardoc/ja/package/html/html-quickform/html-quickform-hierselect
setoptions.xml
html-quickform-hierselect.xml
/peardoc/ja/package/database/db-dataobject/db-dataobject
whereadd.xml
/peardoc/ja/package/caching/cache-lite/cache-lite extendlife.xml
/peardoc/ja/guide/newmaint when-to-contribute.xml
getting-started.xml
/peardoc/ja/guide/developers/package2 license.xml
/peardoc/ja/guide/developers release.xml package2.xml
/peardoc/ja/chapters/installation introduction.xml getting.xml
/peardoc/ja/chapters/faq users.xml
/peardoc/ja/chapters standards.xml pear2cs.xml
Log:
sync with en.
takagi-20071202102436.txt
(text/plain, 25.1 KB)
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/webservices/xml-rpc/support.xml?r1=1.2&r2=1.3&diff_format=u
Index: peardoc/ja/package/webservices/xml-rpc/support.xml
diff -u peardoc/ja/package/webservices/xml-rpc/support.xml:1.2 peardoc/ja/package/webservices/xml-rpc/support.xml:1.3
--- peardoc/ja/package/webservices/xml-rpc/support.xml:1.2 Sat Dec 1 18:52:56 2007
+++ peardoc/ja/package/webservices/xml-rpc/support.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready -->
<refentry id="package.webservices.xml-rpc.support">
<refnamediv>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/php/php-codesniffer/config-options.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/package/php/php-codesniffer/config-options.xml
diff -u peardoc/ja/package/php/php-codesniffer/config-options.xml:1.3 peardoc/ja/package/php/php-codesniffer/config-options.xml:1.4
--- peardoc/ja/package/php/php-codesniffer/config-options.xml:1.3 Tue Nov 27 08:59:47 2007
+++ peardoc/ja/package/php/php-codesniffer/config-options.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready -->
<refentry id="package.php.php-codesniffer.config-options">
<refnamediv>
<refname>設定オプション</refname>
@@ -31,6 +31,26 @@
</example>
</refsect2>
+ <refsect2 id="package.php.php-codesniffer.config-options.php-codesniffer.report-format">
+ <title>デフォルトの出力書式の設定</title>
+ <para>
+ デフォルトでは、コマンドラインで出力書式を指定しなかった場合は
+ PHP_CodeSniffer は <emphasis>完全版</emphasis> のレポートを出力します。
+ デフォルトの出力書式を変更するには、設定オプション
+ <literal>report_format</literal> を指定します。
+ </para>
+ <example>
+ <title>デフォルトの出力書式を要約版に設定</title>
+ <screen>
+ <userinput>
+<![CDATA[
+$ phpcs --config-set report_format summary
+]]>
+ </userinput>
+ </screen>
+ </example>
+ </refsect2>
+
<refsect2 id="package.php.php-codesniffer.config-options.php-codesniffer.show-warnings">
<title>警告をデフォルトで隠す</title>
<para>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/html/pager/pager.xml?r1=1.4&r2=1.5&diff_format=u
Index: peardoc/ja/package/html/pager/pager.xml
diff -u peardoc/ja/package/html/pager/pager.xml:1.4 peardoc/ja/package/html/pager/pager.xml:1.5
--- peardoc/ja/package/html/pager/pager.xml:1.4 Sun Nov 25 16:38:28 2007
+++ peardoc/ja/package/html/pager/pager.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.6 Maintainer: shimooka Status: ready -->
<refentry id="package.html.pager.pager">
<refnamediv>
<refname><function>Pager::Pager</function></refname>
@@ -98,13 +98,6 @@
</para>
</listitem>
<listitem>
- <para><parameter>addSlash</parameter> [boolean]</para>
- <para>
- もし &false; なら、<parameter>path</parameter> と
- <parameter>fileName</parameter> の間にスラッシュが追加されません。
- </para>
- </listitem>
- <listitem>
<para><parameter>append</parameter> [boolean]</para>
<para>
もし&true;なら、pageIDはGET値としてURLに追加されます。
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/html/html-quickform/html-quickform-hierselect/setoptions.xml?r1=1.2&r2=1.3&diff_format=u
Index: peardoc/ja/package/html/html-quickform/html-quickform-hierselect/setoptions.xml
diff -u peardoc/ja/package/html/html-quickform/html-quickform-hierselect/setoptions.xml:1.2 peardoc/ja/package/html/html-quickform/html-quickform-hierselect/setoptions.xml:1.3
--- peardoc/ja/package/html/html-quickform/html-quickform-hierselect/setoptions.xml:1.2 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/package/html/html-quickform/html-quickform-hierselect/setoptions.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.html.html-quickform.html-quickform-hierselect.setoptions">
<refnamediv>
<refname>HTML_QuickForm_hierselect::setOptions()</refname>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/html/html-quickform/html-quickform-hierselect/html-quickform-hierselect.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/package/html/html-quickform/html-quickform-hierselect/html-quickform-hierselect.xml
diff -u peardoc/ja/package/html/html-quickform/html-quickform-hierselect/html-quickform-hierselect.xml:1.3 peardoc/ja/package/html/html-quickform/html-quickform-hierselect/html-quickform-hierselect.xml:1.4
--- peardoc/ja/package/html/html-quickform/html-quickform-hierselect/html-quickform-hierselect.xml:1.3 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/package/html/html-quickform/html-quickform-hierselect/html-quickform-hierselect.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.5 Maintainer: takagi Status: ready -->
<refentry id="package.html.html-quickform.html-quickform-hierselect.html-quickform-hierselect">
<refnamediv>
<refname>コンストラクタ HTML_QuickForm_hierselect()</refname>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/database/db-dataobject/db-dataobject/whereadd.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/package/database/db-dataobject/db-dataobject/whereadd.xml
diff -u peardoc/ja/package/database/db-dataobject/db-dataobject/whereadd.xml:1.3 peardoc/ja/package/database/db-dataobject/db-dataobject/whereadd.xml:1.4
--- peardoc/ja/package/database/db-dataobject/db-dataobject/whereadd.xml:1.3 Sat Dec 1 22:43:25 2007
+++ peardoc/ja/package/database/db-dataobject/db-dataobject/whereadd.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.4 Maintainer: shimooka Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready -->
<refentry id="package.database.db-dataobject.db-dataobject.whereadd">
<refnamediv>
<refname>->whereAdd()</refname>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/caching/cache-lite/cache-lite/extendlife.xml?r1=1.2&r2=1.3&diff_format=u
Index: peardoc/ja/package/caching/cache-lite/cache-lite/extendlife.xml
diff -u peardoc/ja/package/caching/cache-lite/cache-lite/extendlife.xml:1.2 peardoc/ja/package/caching/cache-lite/cache-lite/extendlife.xml:1.3
--- peardoc/ja/package/caching/cache-lite/cache-lite/extendlife.xml:1.2 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/package/caching/cache-lite/cache-lite/extendlife.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.caching.cache-lite.cache-lite.extend-life">
<refnamediv>
<refname><function>Cache_Lite::extendLife</function></refname>
http://cvs.php.net/viewvc.cgi/peardoc/ja/guide/newmaint/when-to-contribute.xml?r1=1.6&r2=1.7&diff_format=u
Index: peardoc/ja/guide/newmaint/when-to-contribute.xml
diff -u peardoc/ja/guide/newmaint/when-to-contribute.xml:1.6 peardoc/ja/guide/newmaint/when-to-contribute.xml:1.7
--- peardoc/ja/guide/newmaint/when-to-contribute.xml:1.6 Sun Dec 2 04:18:11 2007
+++ peardoc/ja/guide/newmaint/when-to-contribute.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8" ?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.11 Maintainer: haruki Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.12 Maintainer: haruki Status: ready -->
<chapter id="newmaint.when-to-contribute">
<chapterinfo>
<author>
@@ -11,7 +11,7 @@
<firstname>Gregory</firstname>
<surname>Beaver</surname>
</author>
- <date>$Date: 2007/12/02 04:18:11 $</date>
+ <date>$Date: 2007/12/02 10:24:35 $</date>
</chapterinfo>
<title>PEAR に貢献するための方法</title>
<titleabbrev>貢献</titleabbrev>
http://cvs.php.net/viewvc.cgi/peardoc/ja/guide/newmaint/getting-started.xml?r1=1.4&r2=1.5&diff_format=u
Index: peardoc/ja/guide/newmaint/getting-started.xml
diff -u peardoc/ja/guide/newmaint/getting-started.xml:1.4 peardoc/ja/guide/newmaint/getting-started.xml:1.5
--- peardoc/ja/guide/newmaint/getting-started.xml:1.4 Sun Dec 2 04:18:11 2007
+++ peardoc/ja/guide/newmaint/getting-started.xml Sun Dec 2 10:24:35 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8" ?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.8 Maintainer: haruki Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.9 Maintainer: haruki Status: ready -->
<chapter id="newmaint.getting-started">
<chapterinfo>
<author>
@@ -11,7 +11,7 @@
<firstname>Gregory</firstname>
<surname>Beaver</surname>
</author>
- <date>$Date: 2007/12/02 04:18:11 $</date>
+ <date>$Date: 2007/12/02 10:24:35 $</date>
</chapterinfo>
<title>PEAR コミュニティーへの参加</title>
<titleabbrev>はじめかた</titleabbrev>
http://cvs.php.net/viewvc.cgi/peardoc/ja/guide/developers/package2/license.xml?r1=1.2&r2=1.3&diff_format=u
Index: peardoc/ja/guide/developers/package2/license.xml
diff -u peardoc/ja/guide/developers/package2/license.xml:1.2 peardoc/ja/guide/developers/package2/license.xml:1.3
--- peardoc/ja/guide/developers/package2/license.xml:1.2 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/guide/developers/package2/license.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="guide.developers.package2.license">
<refnamediv>
<refname><license></refname>
http://cvs.php.net/viewvc.cgi/peardoc/ja/guide/developers/release.xml?r1=1.9&r2=1.10&diff_format=u
Index: peardoc/ja/guide/developers/release.xml
diff -u peardoc/ja/guide/developers/release.xml:1.9 peardoc/ja/guide/developers/release.xml:1.10
--- peardoc/ja/guide/developers/release.xml:1.9 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/guide/developers/release.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.17 Maintainer: haruki Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.18 Maintainer: haruki Status: ready -->
<chapter id="developers.release">
<chapterinfo>
<author>
@@ -33,7 +33,7 @@
このマニュアルで説明されていない重要な内容が含まれています。
さらに、この規則のほかにも数多くの RFC が存在します。
これらは、
- <ulink url="http://pear.php.net/pepr/index.php?filter=finished">
+ <ulink url="&url.pear.pepr;?filter=finished">
終了した</ulink> PEPr プロポーザル一覧の中の
'R' の欄にあります。'R' は RFC の 'R' です。
残念ながら、これらの文書はまだこのマニュアルに統合されていません。
http://cvs.php.net/viewvc.cgi/peardoc/ja/guide/developers/package2.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/guide/developers/package2.xml
diff -u peardoc/ja/guide/developers/package2.xml:1.3 peardoc/ja/guide/developers/package2.xml:1.4
--- peardoc/ja/guide/developers/package2.xml:1.3 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/guide/developers/package2.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.16 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.17 Maintainer: takagi Status: ready -->
<chapter id="guide.developers.package2">
<title>パッケージ定義ファイル <filename>package.xml</filename>、バージョン 2.0</title>
<titleabbrev><filename>package.xml 2.0</filename></titleabbrev>
http://cvs.php.net/viewvc.cgi/peardoc/ja/chapters/installation/introduction.xml?r1=1.1&r2=1.2&diff_format=u
Index: peardoc/ja/chapters/installation/introduction.xml
diff -u peardoc/ja/chapters/installation/introduction.xml:1.1 peardoc/ja/chapters/installation/introduction.xml:1.2
--- peardoc/ja/chapters/installation/introduction.xml:1.1 Sun Nov 26 08:40:55 2006
+++ peardoc/ja/chapters/installation/introduction.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.1 $ -->
-<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<sect1 id="installation.introduction">
<title>はじめに</title>
<para>
@@ -15,7 +15,8 @@
<para>
PHP とは別に配布されているパッケージは、
PEAR パッケージマネージャを使ってインストールします。
- このマネージャは、Debian の <quote>apt-get</quote> と似ています。
+ このマネージャは、Debian の <quote>apt-get</quote>
+ や yum のようなパッケージ管理ユーティリティと同じような方法でインストールを行います。
最近のバージョン (> 4.3.0) の PHP を使用している場合は、次節を読み飛ばしてもかまいません。
ただ、PHP 4.2.* 以前のバージョンを使用している場合は、
(次節に従い) パッケージマネージャを別途インストールする必要があります。
http://cvs.php.net/viewvc.cgi/peardoc/ja/chapters/installation/getting.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/chapters/installation/getting.xml
diff -u peardoc/ja/chapters/installation/getting.xml:1.3 peardoc/ja/chapters/installation/getting.xml:1.4
--- peardoc/ja/chapters/installation/getting.xml:1.3 Sun Dec 2 04:18:11 2007
+++ peardoc/ja/chapters/installation/getting.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready -->
<sect1 id="installation.getting">
<title>パッケージマネージャの取得</title>
http://cvs.php.net/viewvc.cgi/peardoc/ja/chapters/faq/users.xml?r1=1.4&r2=1.5&diff_format=u
Index: peardoc/ja/chapters/faq/users.xml
diff -u peardoc/ja/chapters/faq/users.xml:1.4 peardoc/ja/chapters/faq/users.xml:1.5
--- peardoc/ja/chapters/faq/users.xml:1.4 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/chapters/faq/users.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.5 Maintainer: haruki Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.7 Maintainer: haruki Status: ready -->
<!-- CREDITS: takagi -->
<sect1 id="faq.users">
<title>ユーザ向け FAQ</title>
@@ -159,6 +159,59 @@
</para>
</sect2>
+ <sect2 id="faq.macosx">
+ <title>
+ PEAR は Mac OS X で使えますか?
+ </title>
+ <titleabbrev>
+ PEAR と Max OS X
+ </titleabbrev>
+ <simpara>
+ Brett Bieber による回答
+ </simpara>
+ <para>
+ 10.5 までのすべてのバージョンの Mac OS X には、PEAR がデフォルトで含まれています。
+ Mac OS X 10.5 (Leopard) の場合は、標準的な手順で
+ PEAR をインストールしなければなりません。
+ </para>
+ <para>
+ OS X 10.4 以前を使用している場合は、Marc Liyanage's PHP packages
+ のようなバイナリパッケージを用いて新しいバージョンの
+ PHP にアップグレードしたくなるかもしれません。
+ 別の PHP パッケージをインストールしている場合、システム上に複数のバージョンの
+ PHP や PEAR がインストールされていることもあるでしょう。
+ このような場合に自分がどのバージョンを使用しているのかを知るには、まずコンソールで
+ <command>which pear</command> と入力して PEAR の場所を確かめます。そして
+ <command>pear -V</command> で PEAR のバージョンに関する情報を取得し、
+ <command>pear config-show</command> で設定の詳細を調べます。
+ </para>
+ <para>
+ Max OS X のデフォルトの状態から何も変更していない場合、使用している PEAR
+ は <filename>/usr/bin/pear</filename> であり、これは OS X
+ に含まれている PHP 4 用に設定されています。
+ この場合は、いくつかの選択肢があります。
+ </para>
+ <para>
+ Marc Liyanage's PHP package を使用する場合は
+ <command>/usr/local/php5/bin/pear install {packagename}</command>
+ (パッケージのインストールやアップグレードには sudo が必要です)
+ のように指定し、コンソールから pear や php を実行する場合は常にフルパスで指定します。
+ </para>
+ <para>
+ あるいは、config-set を使用して OS X 版の PEAR のすべてのパスを変更することもできます。
+ もうひとつ、私がやっている方法は、 <command>sudo rm /usr/bin/php /usr/bin/pear</command>
+ をしてから <command>sudo ln -s /usr/local/php5/bin/php /usr/bin/php</command>
+ <command>sudo ln -s /usr/local/php5/bin/pear /usr/bin/pear</command>
+ をするというものです。これは PHP 4 を削除し、かわりに Marc Liyanage 版の PHP 5 にリンクしています。
+ 注意すべき点としては、Apple がたまに OSX 版の PHP を更新するということがあります。その場合、
+ <filename>/usr/bin/php</filename> が標準版に戻されてしまいます。
+ </para>
+ <simpara>
+ 注意: Apple が Mac OS X <= 10.4 用に PHP 4 を配布し続けるかどうかは定かではありません。
+ つまり、この手順は変わる可能性があり、Mac OS X のバージョンによっても異なるかもしれません。
+ Apple のドキュメントでデフォルトのインストール内容について調べてから修正を加えるようにしましょう。
+ </simpara>
+ </sect2>
<sect2 id="faq.windows">
<title>
@@ -306,7 +359,7 @@
<command>$ which pear</command> とすると <filename>/home/user/pear/bin/pear</filename>
と表示され、<command>$ pear -V</command> で "PEAR Version: 1.4.8"
(執筆時。これ以降であればよい)と出力されると問題ありません。
- 最新の安定版については、 http://pear.php.net/package/PEAR の
+ 最新の安定版については、&url.pear.package;PEAR の
<emphasis>Current Release</emphasis> のところをチェックしてください。
</para>
<para>
@@ -376,4 +429,4 @@
</para>
</sect2>
- </sect1>
\ No newline at end of file
+ </sect1>
http://cvs.php.net/viewvc.cgi/peardoc/ja/chapters/standards.xml?r1=1.16&r2=1.17&diff_format=u
Index: peardoc/ja/chapters/standards.xml
diff -u peardoc/ja/chapters/standards.xml:1.16 peardoc/ja/chapters/standards.xml:1.17
--- peardoc/ja/chapters/standards.xml:1.16 Sat Dec 1 21:03:45 2007
+++ peardoc/ja/chapters/standards.xml Sun Dec 2 10:24:36 2007
@@ -1,6 +1,6 @@
<?xml encoding="utf-8"?>
-<!-- $Revision: 1.16 $ -->
-<!-- EN-Revision: 1.55 Maintainer: haruki Status: working -->
+<!-- $Revision: 1.17 $ -->
+<!-- EN-Revision: 1.57 Maintainer: haruki Status: working -->
<!-- CREDITS: hirokawa,takagi -->
<chapter id="standards">
<title>標準コーディング規約</title>
http://cvs.php.net/viewvc.cgi/peardoc/ja/chapters/pear2cs.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/chapters/pear2cs.xml
diff -u peardoc/ja/chapters/pear2cs.xml:1.3 peardoc/ja/chapters/pear2cs.xml:1.4
--- peardoc/ja/chapters/pear2cs.xml:1.3 Sun Dec 2 04:18:12 2007
+++ peardoc/ja/chapters/pear2cs.xml Sun Dec 2 10:24:36 2007
@@ -1,12 +1,18 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.10 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.14 Maintainer: takagi Status: ready -->
<chapter id="pear2cs">
<chapterinfo>
<date>2007-11-26</date>
</chapterinfo>
<title>PEAR2 コーディング規約</title>
<subtitle>PEAR2 で使用するコーディング規約</subtitle>
+ <note>
+ <simpara>
+ このドキュメントは、現在マニュアルへの統合作業中であり、
+ まだ完成していません。
+ </simpara>
+ </note>
<para>
<itemizedlist>
<listitem>
@@ -268,34 +274,6 @@
</sect3>
</sect2>
- <sect2 id="pear2cs.rules.otherclasses">
- <title>他のクラスの読み込み</title>
- <para>
- オプションのコンポーネントを読み込むメソッド
- (ファクトリメソッドやドライバの読み込みなど)
- の内部で <methodname>class_exists</methodname>($classname, true)
- を使用し、致命的なエラー "class not found" となることを避けます。
- たとえばドライバの読み込みに失敗した場合は、
- 単なる致命的なエラーにしてしまうのではなく
- わかりやすいメッセージをつけた例外を発生させて終了することをお勧めします。
- </para>
- <programlisting role="php">
- <![CDATA[
-<?php
-if (!class_exists("PEAR2_PackageName_Driver_$class", true)) {
- throw new PEAR2::PackageName::Exception('Unknown driver ' .
- $class . ', be sure the driver exists and is loaded
- prior to use');
-}
-?>
- ]]>
- </programlisting>
- <sect3 id="pear2cs.rules.otherclasses.requirement">
- <title>要件</title>
- <simpara>このルールはオプションで、推奨するコーディング手法です。</simpara>
- </sect3>
- </sect2>
-
<sect2 id="pear2cs.rules.dirstructure">
<title>ディレクトリ構造</title>
<para>PEAR2 Subversion ディレクトリ内のディレクトリ構造にしたがってください。</para>
@@ -336,8 +314,10 @@
すべての公開クラスは、そのクラス名のアンダースコア (_)
あるいは名前空間セパレータ (::)
の部分をディレクトリ区切り文字に置き換えた場所になければなりません。
- つまり、PEAR2_PackageName_Base クラスや PEAR2::PackageName::Base
- クラスは PEAR2/PackageName/Base.php というファイルに書くことになります
+ つまり、<classname>PEAR2_PackageName_Base</classname>
+ クラスや <classname>PEAR2::PackageName::Base</classname>
+ クラスは <literal>PEAR2/PackageName/Base.php</literal>
+ というファイルに書くことになります
(これは、autoload を機能させるために必須です)。
</para>
<sect3 id="pear2cs.rules.classtofile.requirement">
@@ -386,9 +366,9 @@
しかし、doc ファイルや test ファイルについては置換を使用してもかまいません。
</para>
<para>
- パッケージのインストール先は php_dir/src であり、
+ パッケージのインストール先は <literal>php_dir/src</literal> であり、
データファイルの場所は、常に
- php_dir/data/channel/PackageName/ となります。
+ <literal>php_dir/data/channel/PackageName/</literal> となります。
<literal>PEAR2/PackageName/Subfile.php</literal>
の中からデータファイルを取得するには、このようなコードを使用します。
</para>
@@ -407,6 +387,35 @@
<simpara>このルールには例外はありません。</simpara>
</sect3>
</sect2>
+
+ <sect2 id="pear2cs.rules.otherclasses">
+ <title>他のクラスの読み込み</title>
+ <para>
+ オプションのコンポーネントを読み込むメソッド
+ (ファクトリメソッドやドライバの読み込みなど)
+ の内部で <methodname>class_exists</methodname>($classname, true)
+ を使用し、致命的なエラー "class not found" となることを避けます。
+ たとえばドライバの読み込みに失敗した場合は、
+ 単なる致命的なエラーにしてしまうのではなく
+ わかりやすいメッセージをつけた例外を発生させて終了することをお勧めします。
+ </para>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+if (!class_exists("PEAR2_PackageName_Driver_$class", true)) {
+ throw new PEAR2::PackageName::Exception('Unknown driver ' .
+ $class . ', be sure the driver exists and is loaded
+ prior to use');
+}
+?>
+ ]]>
+ </programlisting>
+ <sect3 id="pear2cs.rules.otherclasses.requirement">
+ <title>要件</title>
+ <simpara>このルールはオプションで、推奨するコーディング手法です。</simpara>
+ </sect3>
+ </sect2>
+
</sect1>
</chapter>