sync Japanese document with r15606.

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@15692 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/ja/module_specs/Zend_Acl-Advanced.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15101 -->
+<!-- EN-Revision: 15606 -->
 <sect1 id="zend.acl.advanced">
 
     <title>高度な使用法</title>
@@ -23,7 +23,7 @@
         データの使用法にはさまざまなものが考えられるので、
         ACL データの保存は、場面に応じて開発者側で考えることになります。
         <classname>Zend_Acl</classname> はシリアライズ可能なので、ACL オブジェクトを PHP の
-        <ulink url="http://php.net/serialize"><code>serialize()</code></ulink>
+        <ulink url="http://php.net/serialize"><methodname>serialize()</methodname></ulink>
         関数でシリアライズすることができます。シリアライズした結果を、
         ファイルやデータベースあるいはキャッシュなどのお好みの場所に保存することができます。
         </para>
@@ -46,7 +46,7 @@
         <para>
         <classname>Zend_Acl</classname> は、条件付きの規則を <classname>Zend_Acl_Assert_Interface</classname>
         でサポートしています。規則のアサーション用インターフェイスを使用するには、
-        これを実装したクラスで <code>assert()</code> メソッドを作成します。
+        これを実装したクラスで <methodname>assert()</methodname> メソッドを作成します。
         </para>
 
         <programlisting role="php"><![CDATA[
@@ -71,7 +71,7 @@ class CleanIPAssertion implements Zend_Acl_Assert_Interface
         アサーションクラスを作成したら、条件付きの規則を定義を割り当てる際に
         このアサーションクラスのインスタンスを指定します。
         アサーションつきで作成された規則は、アサーションメソッドが
-        true を返す場合にのみ適用されます。
+        <constant>TRUE</constant> を返す場合にのみ適用されます。
         </para>
 
         <programlisting role="php"><![CDATA[
@@ -93,8 +93,8 @@ $acl->allow(null, null, null, new CleanIPAssertion());
         </para>
 
         <para>
-        アサーションオブジェクトの <code>assert()</code> メソッドは、認証問い合わせ
-        (すなわち <code>isAllowed()</code>) が適用される ACL、ロール、リソース
+        アサーションオブジェクトの <methodname>assert()</methodname> メソッドは、認証問い合わせ
+        (すなわち <methodname>isAllowed()</methodname>) が適用される ACL、ロール、リソース
         および権限に渡されます。これを用いて、必要な場所でアサーションクラスが
         条件を判断します。
         </para>

documentation/manual/ja/module_specs/Zend_Acl-Refining.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15101 -->
+<!-- EN-Revision: 15606 -->
 <sect1 id="zend.acl.refining">
 
     <title>アクセス制御の洗練</title>
@@ -127,9 +127,9 @@ echo $acl->isAllowed('administrator', 'announcement', 'archive') ?
 
         <para>
         ACL からひとつあるいは複数のアクセス規則を削除するには、
-        <code>removeAllow()</code> メソッドあるいは <code>removeDeny()</code>
-        メソッドを使用します。<code>allow()</code> および <code>deny()</code>
-        と同様、<code>null</code> 値を指定すると
+        <methodname>removeAllow()</methodname> メソッドあるいは <methodname>removeDeny()</methodname>
+        メソッドを使用します。<methodname>allow()</methodname> および <methodname>deny()</methodname>
+        と同様、<constant>NULL</constant> 値を指定すると
         すべてのロールやリソース、権限を表すことになります。
         </para>
 
@@ -157,7 +157,7 @@ echo $acl->isAllowed('marketing', 'newsletter', 'archive') ?
 
         <para>
         上で説明したように、徐々に権限を変更していくこともできますが、
-        権限に対して <code>null</code> 値を設定すると、
+        権限に対して <constant>NULL</constant> 値を設定すると、
         このような変更を一括で行うことができます。
         </para>
 

documentation/manual/ja/module_specs/Zend_Acl.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15346 -->
+<!-- EN-Revision: 15606 -->
 <sect1 id="zend.acl.introduction">
     <title>導入</title>
 
@@ -12,22 +12,24 @@
 
     <para>
         このドキュメントにおいて、
+    </para>
 
-        <itemizedlist>
-            <listitem>
-                <para>
-                    <emphasis>リソース (Resource)</emphasis>
-                    とは、アクセス制御の対象となるオブジェクトのことです。
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>ロール (Role)</emphasis>
-                    とは、リソースに対してのアクセスを要求するオブジェクトのことです。
-                </para>
-            </listitem>
-        </itemizedlist>
+    <itemizedlist>
+        <listitem>
+            <para>
+                <emphasis>リソース (Resource)</emphasis>
+                とは、アクセス制御の対象となるオブジェクトのことです。
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                <emphasis>ロール (Role)</emphasis>
+                とは、リソースに対してのアクセスを要求するオブジェクトのことです。
+            </para>
+        </listitem>
+    </itemizedlist>
 
+    <para>
         簡単に言うと、<emphasis>ロールがリソースに対してのアクセスを要求する</emphasis>
         ということです。たとえば、ある人が自動車を利用したいと考えているとしましょう。
         この場合、自動車を誰が利用できるのかが管理されているとすると
@@ -48,7 +50,7 @@
             開発者がリソースを作成するの手助けする機能が含まれています。
             リソースクラスは、単にこのインターフェイスを実装するだけで作成できます。
             このインターフェイスに含まれるメソッドはひとつだけで、それは
-            <code>getResourceId()</code> です。このメソッドにより、
+            <methodname>getResourceId()</methodname> です。このメソッドにより、
             <classname>Zend_Acl</classname> はそのオブジェクトがリソースであると判断します。さらに、
             基本的なリソースの実装を含む <classname>Zend_Acl_Resource</classname>
             が <classname>Zend_Acl</classname> にインクルードされています。
@@ -86,7 +88,7 @@
             開発者がロールを作成するの手助けする機能が含まれています。
             ロールクラスは、単にこのインターフェイスを実装するだけで作成できます。
             このインターフェイスに含まれるメソッドはひとつだけで、それは
-            <code>getRoleId()</code> です。このメソッドにより、
+            <methodname>getRoleId()</methodname> です。このメソッドにより、
             Zend_Acl はそのオブジェクトがロールであると判断します。さらに、
             基本的なロールの実装を含む <classname>Zend_Acl_Role</classname>
             が <classname>Zend_Acl</classname> にインクルードされています。
@@ -110,12 +112,12 @@
         <example id="zend.acl.introduction.roles.example.multiple_inheritance">
             <title>ロールの多重継承</title>
             <para>
-                以下のコードでは、基本となる三つのロール "<code>guest</code>"、"<code>member</code>"
-                および "<code>admin</code>" を定義しています。他のロールはこれらを継承することになります。
-                次に、"<code>someUser</code>" というロールを作成してこれらの三つのロールを継承します。
+                以下のコードでは、基本となる三つのロール "guest"、"member"
+                および "admin" を定義しています。他のロールはこれらを継承することになります。
+                次に、"someUser" というロールを作成してこれらの三つのロールを継承します。
                 これらのロールが配列 <code>$parents</code> にあらわれる順序が重要となります。
-                問い合わせ先のロール (ここでは "<code>someUser</code>" にアクセス規則が定義されていないが
-                その継承元 (ここでは "<code>guest</code>"、"<code>member</code>" および "<code>admin</code>")
+                問い合わせ先のロール (ここでは "someUser" にアクセス規則が定義されていないが
+                その継承元 (ここでは "guest"、"member" および "admin")
                 には定義されているという場合、<classname>Zend_Acl</classname> はそちらを検索します。
             </para>
             <programlisting role="php"><![CDATA[
@@ -146,7 +148,7 @@ echo $acl->isAllowed('someUser', 'someResource') ? 'allowed' : 'denied';
             </para>
             <para>
                 しかし、仮に <classname>Zend_Acl</classname> がさらに別の親に対しても規則の検索を続けたとすると、
-                "guest" は "<code>someResource</code>" へのアクセスが拒否されていることに気づくことでしょう。
+                "guest" は "someResource" へのアクセスが拒否されていることに気づくことでしょう。
                 これは問題となります。というのも、"someUser" は
                 "someResource" へのアクセスが許可されていると同時に拒否されているわけで、
                 それぞれ別の親ロールから取得した規則が衝突することになるからです。
@@ -156,7 +158,7 @@ echo $acl->isAllowed('someUser', 'someResource') ? 'allowed' : 'denied';
                 直近に継承されたロールの優先度が高くなるようにしています。
                 今回の場合は、"member" のほうが
                 "guest" ロールより先に調べられ、例のコードの出力は
-                "<code>allowed</code>" となります。
+                "allowed" となります。
             </para>
         </example>
         <note>
@@ -328,7 +330,7 @@ $acl->allow('administrator');
 ]]></programlisting>
 
         <para>
-            上の <code>allow()</code> のコールにおける <code>null</code> は、
+            上の <methodname>allow()</methodname> のコールにおける <constant>NULL</constant> は、
             規則をすべてのリソースに対して適用することを意味します。
         </para>
 
@@ -341,7 +343,7 @@ $acl->allow('administrator');
             これで、柔軟な ACL が作成できました。これにより、
             ウェブアプリケーションの使用者が、
             ある機能を使用するために必要な権限を持っているかを調べられるようになりました。
-            問い合わせを行うのは簡単で、単に <code>isAllowed()</code>
+            問い合わせを行うのは簡単で、単に <methodname>isAllowed()</methodname>
             メソッドを使用するだけです。
         </para>