|
|
@@ -205,18 +205,16 @@ class Zend_CodeGenerator_Php_Class extends Zend_CodeGenerator_Php_Abstract
|
|
|
<title>Zend_CodeGenerator_Php_Docblock</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_Docblock</classname> can be used to
|
|
|
- generate arbitrary PHP docblocks, including all the standard
|
|
|
- docblock features: short and long descriptions and annotation
|
|
|
- tags.
|
|
|
+ <classname>Zend_CodeGenerator_Php_Docblock</classname>は、
|
|
|
+ すべての標準的なdocblock機能を含む任意のPHP docblockを生成することで使うことができます:
|
|
|
+ 短い、または長い説明や注釈タグ。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Annotation tags may be set using the <code>setTag()</code> and
|
|
|
- <code>setTags()</code> methods; these each take either an array
|
|
|
- describing the tag that may be passed to the
|
|
|
- <classname>Zend_CodeGenerator_Php_Docblock_Tag</classname> constructor, or
|
|
|
- an instance of that class.
|
|
|
+ 注釈タグは<code>setTag()</code>や<code>setTags()</code>メソッドを用いてセットされるかもしれません;
|
|
|
+ これらは<classname>Zend_CodeGenerator_Php_Docblock_Tag</classname>コンストラクタに渡されるかもしれないタグを記述している配列、
|
|
|
+ またはそのクラスのインスタンスどちらもそれぞれ
|
|
|
+ <!-- TODO -->take
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -245,11 +243,9 @@ class Zend_CodeGenerator_Php_Docblock extends Zend_CodeGenerator_Php_Abstract
|
|
|
<title>Zend_CodeGenerator_Php_Docblock_Tag</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_Docblock_Tag</classname> is intended for
|
|
|
- creating arbitrary annotation tags for inclusion in PHP
|
|
|
- docblocks. Tags are expected to contain a name (the portion
|
|
|
- immediately following the '@' symbol) and a description
|
|
|
- (everything following the tag name).
|
|
|
+ <classname>Zend_CodeGenerator_Php_Docblock_Tag</classname>は、
|
|
|
+ PHP docblockに含む任意の注釈タグを作成することを目的とします。
|
|
|
+ タグは、名前（＠記号にすぐ続く部分）と説明（タグ名に続いているすべて）を含むことになっています。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -276,13 +272,12 @@ class Zend_CodeGenerator_Php_Docblock_Tag
|
|
|
<title>Zend_CodeGenerator_Php_DocBlock_Tag_Param</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_DocBlock_Tag_Param</classname> is a
|
|
|
- specialized version of
|
|
|
- <classname>Zend_CodeGenerator_Php_DocBlock_Tag</classname>, and represents
|
|
|
- a method parameter. The tag name is therefor known ("param"),
|
|
|
- but due to the format of this annotation tag, additional
|
|
|
- information is required in order to generate it: the parameter
|
|
|
- name and data type it represents.
|
|
|
+ <classname>Zend_CodeGenerator_Php_DocBlock_Tag_Param</classname>は
|
|
|
+ <classname>Zend_CodeGenerator_Php_DocBlock_Tag</classname>の分化したバージョンで、
|
|
|
+ メソッド・パラメータを表します。
|
|
|
+ そこで、タグ名は("param")として知られています、
|
|
|
+ しかし、この注釈タグを構成するパラメータ名とデータ型を生成するために、
|
|
|
+ 追加の情報が必要とされます。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -309,11 +304,10 @@ class Zend_CodeGenerator_Php_Docblock_Tag_Param
|
|
|
<title>Zend_CodeGenerator_Php_DocBlock_Tag_Return</title>
|
|
|
|
|
|
<para>
|
|
|
- Like the param docblock tag variant,
|
|
|
- <classname>Zend_CodeGenerator_Php_Docblock_Tab_Return</classname> is an
|
|
|
- annotation tag variant for representing a method return value.
|
|
|
- In this case, the annotation tag name is known ("return"), but
|
|
|
- requires a return type.
|
|
|
+ param docblock <!-- TODO -->tag variantのように、
|
|
|
+ <classname>Zend_CodeGenerator_Php_Docblock_Tab_Return</classname>は
|
|
|
+ メソッドの戻り値を表すための注釈<!-- TODO -->tag variantです。
|
|
|
+ この場合、注釈タグ名は("return")として知られていますが、戻す型を必要とします。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -338,20 +332,18 @@ class Zend_CodeGenerator_Php_Docblock_Tag_Param
|
|
|
<title>Zend_CodeGenerator_Php_File</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_File</classname> is used to generate
|
|
|
- the full contents of a file that will contain PHP code. The file
|
|
|
- may contain classes or arbitrary PHP code, as well as a
|
|
|
- file-level docblock if desired.
|
|
|
+ <classname>Zend_CodeGenerator_Php_File</classname>は、
|
|
|
+ PHPコードを含むファイルの完全なコンテンツを生成することに使われます。
|
|
|
+ ファイル・レベルのdocblockと同様に必要に応じて、
|
|
|
+ ファイルはクラスまたは任意のPHPコードを含むかもしれません。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- When adding classes to the file, you will need to pass either an
|
|
|
- array of information to pass to the
|
|
|
- <classname>Zend_CodeGenerator_Php_Class</classname> constructor, or an
|
|
|
- instance of that class. Similarly, with docblocks, you will need
|
|
|
- to pass information for the
|
|
|
- <classname>Zend_CodeGenerator_Php_Docblock</classname> constructor to
|
|
|
- consume or an instance of the class.
|
|
|
+ クラスをファイルに加えるとき、
|
|
|
+ <classname>Zend_CodeGenerator_Php_Class</classname>コンストラクタに渡す情報の配列か、
|
|
|
+ そのクラスのインスタンスのどちらかを渡す必要があります。
|
|
|
+ 同様にdocblockで、<classname>Zend_CodeGenerator_Php_Docblock</classname>コンストラクタが消費する情報、
|
|
|
+ またはクラスのインスタンスを渡す必要があります。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -388,11 +380,9 @@ class Zend_CodeGenerator_Php_File extends Zend_CodeGenerator_Php_Abstract
|
|
|
<title>Zend_CodeGenerator_Php_Member_Container</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_Member_Container</classname> is used
|
|
|
- internally by <classname>Zend_CodeGenerator_Php_Class</classname> to keep
|
|
|
- track of class members -- properties and methods alike. These
|
|
|
- are indexed by name, using the concrete instances of the members
|
|
|
- as values.
|
|
|
+ <classname>Zend_CodeGenerator_Php_Member_Container</classname>は、
|
|
|
+ <classname>Zend_CodeGenerator_Php_Class</classname>によって、
|
|
|
+ 内部的にクラスのメンバー - プロパティやメソッドなど - の経過を追う目的に使われます。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -411,20 +401,18 @@ class Zend_CodeGenerator_Php_Member_Container extends ArrayObject
|
|
|
<title>Zend_CodeGenerator_Php_Method</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_Method</classname> describes a class
|
|
|
- method, and can generate both the code and the docblock for the
|
|
|
- method. The visibility and status as static,
|
|
|
- abstract, or final may be indicated, per its parent class,
|
|
|
- <classname>Zend_CodeGenerator_Php_Member_Abstract</classname>. Finally,
|
|
|
- the parameters and return value for the method may be specified.
|
|
|
+ <classname>Zend_CodeGenerator_Php_Method</classname>は、
|
|
|
+ クラス・メソッドを記述して、
|
|
|
+ メソッドのためにコードとdocblockを生成することができます。
|
|
|
+ その親クラス、<classname>Zend_CodeGenerator_Php_Member_Abstract</classname>の通りに、
|
|
|
+ static、abstractまたはfinalとしての可視性と状態が指示されるかもしれません。
|
|
|
+ 最後に、メソッドのパラメータと戻り値は、指定されるかもしれません。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Parameters may be set using <code>setParameter()</code> or
|
|
|
- <code>setParameters()</code>. In each case, a parameter should
|
|
|
- either be an array of information to pass to the
|
|
|
- <classname>Zend_CodeGenerator_Php_Parameter</classname> constructor or an
|
|
|
- instance of that class.
|
|
|
+ パラメータは<code>setParameter()</code>または<code>setParameters()</code>を用いて設定されるかもしれません。
|
|
|
+ それぞれの場合、パラメータは<classname>Zend_CodeGenerator_Php_Parameter</classname>コンストラクタに渡す情報の配列か、
|
|
|
+ またはそのクラスのインスタンスでなければいけません。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -455,11 +443,11 @@ class Zend_CodeGenerator_Php_Method
|
|
|
<title>Zend_CodeGenerator_Php_Parameter</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_Parameter</classname> may be used to
|
|
|
- specify method parameters. Each parameter may have a position
|
|
|
- (if unspecified, the order in which they are registered with the
|
|
|
- method will be used), a default value, and a data type; a
|
|
|
- parameter name is required.
|
|
|
+ <classname>Zend_CodeGenerator_Php_Parameter</classname>は、
|
|
|
+ メソッドのパラメータを指定することに使われるかもしれません。
|
|
|
+ 各々のパラメータは、位置やデフォルト値、データ型を持つかもしれません;
|
|
|
+ パラメータ名は必須です。
|
|
|
+ 位置がもし明確でなければ、それらがメソッドで記載された順序が使われます。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -489,12 +477,11 @@ class Zend_CodeGenerator_Php_Parameter extends Zend_CodeGenerator_Php_Abstract
|
|
|
<title>Zend_CodeGenerator_Php_Property</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_CodeGenerator_Php_Property</classname> describes a class
|
|
|
- property, which may be either a constant or a variable. In each
|
|
|
- case, the property may have an optional default value associated
|
|
|
- with it. Additionally, the visibility of variable properties may
|
|
|
- be set, per the parent class,
|
|
|
- <classname>Zend_CodeGenerator_Php_Member_Abstract</classname>.
|
|
|
+ <classname>Zend_CodeGenerator_Php_Property</classname>はクラスのプロパティを記述します。
|
|
|
+ それは定数か変数であるかもしれません。
|
|
|
+ どちらの場合も、プロパティには関連するデフォルト値をオプションで持つかもしれません。
|
|
|
+ さらに、親クラス（<classname>Zend_CodeGenerator_Php_Member_Abstract</classname>）を通じて
|
|
|
+ 変数のプロパティの可視性が設定されるかもしれません。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
yoshida@zend.co.jp