cvs: phpdoc-ja /language namespaces.xml

takagi Sun Mar 8 10:01:49 2009 UTC Modified files: /phpdoc-ja/language namespaces.xml Log: sync with en. http://cvs.php.net/viewvc.cgi/phpdoc-ja/language/namespaces.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ja/language/namespaces.xml diff -u phpdoc-ja/language/namespaces.xml:1.6 phpdoc-ja/language/namespaces.xml:1.7 --- phpdoc-ja/language/namespaces.xml:1.6 Wed Mar 4 20:58:30 2009 +++ phpdoc-ja/language/namespaces.xml Sun Mar 8 10:01:49 2009 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- EN-Revision: 1.10 Maintainer: takagi Status: working --> <chapter xml:id="language.namespaces" xmlns="http://docbook.org/ns/docbook" version="1.1"> @@ -145,14 +145,14 @@ </para> </sect1> <sect1 xml:id="language.namespaces.definitionmultiple"> - <title>Defining multiple namespaces in the same file</title> + <title>同一ファイル内での複数の名前空間の定義</title> <para> - Multiple namespaces may also be declared in the same file. There are two allowed - syntaxes. + 複数の名前空間を同一ファイル内で宣言することもあります。 + この場合の構文は次の 2 通りです。 </para> <para> <example> - <title>Declaring multiple namespaces, simple combination syntax</title> + <title>シンプルな組み合わせ方式による複数の名前空間の宣言</title> <programlisting role="php"> <![CDATA[ <?php @@ -173,12 +173,12 @@ </example> </para> <para> - This syntax is not recommended for combining namespaces into a single file. - Instead it is recommended to use the alternate bracketed syntax. + この構文は、複数の名前空間をひとつのファイルに含める場合の方法としてはお勧めしません。 + かわりに、次の波括弧構文を使うことを推奨します。 </para> <para> <example> - <title>Declaring multiple namespaces, bracketed syntax</title> + <title>波括弧構文による複数の名前空間の宣言</title> <programlisting role="php"> <![CDATA[ <?php @@ -201,16 +201,15 @@ </example> </para> <para> - It is strongly discouraged as a coding practice to combine multiple namespaces into - the same file. The primary use case is to combine multiple PHP scripts into the same - file. + ただ、複数の名前空間をひとつのファイルに記述するようなコーディングはできるだけ避けるべきです。 + 主な使い道としては、複数の PHP スクリプトをひとつのファイルにまとめるときくらいでしょう。 </para> <para> - To combine global non-namespaced code with namespaced code, only bracketed syntax is - supported. Global code should be - encased in a namespace statement with no namespace name as in: + 名前空間に属さないグローバルなコードを名前空間つきのコードと組み合わせるときには、 + 波括弧構文しか使用できません。グローバルなコードは、名前空間の名前を指定しない + namespace 文で囲みます。たとえば次のようになります。 <example> - <title>Declaring multiple namespaces and unnamespaced code</title> + <title>複数の名前空間および名前空間に属さないコードの宣言</title> <programlisting role="php"> <![CDATA[ <?php @@ -221,7 +220,7 @@ function connect() { /* ... */ } } -namespace { // global code +namespace { // グローバルコード session_start(); $a = MyProject\connect(); echo MyProject\Connection::start(); @@ -232,10 +231,9 @@ </example> </para> <para> - No PHP code may exist outside of the namespace brackets except for an opening - declare statement. + namespace の波括弧の外側に書くことができる PHP コードは、最初の declare 文だけです。 <example> - <title>Declaring multiple namespaces and unnamespaced code</title> + <title>複数の名前空間および名前空間に属さないコードの宣言</title> <programlisting role="php"> <![CDATA[ <?php