wip

Author: nsfisis

reference/ffi/ffi.xml

@@ -21,19 +21,23 @@
     新しい C のデータ構造を作成するのに使用できます。
    </para>
    <para>
+    FFI 定義のパースや共有ライブラリの読み込みには長い時間がかかることがあります。
+    Web 環境において、各 HTTP リクエストでこれを行うのは不便です。
+    しかし、FFI 定義やライブラリを PHP の起動時に事前ロードし、FFI オブジェクトを必要なときにインスタンス化することが可能です。
     !!!
-    FFI definition parsing and shared library loading may take significant time. It is not useful
-    to do it on each HTTP request in a Web environment. However, it is possible to preload FFI definitions
-    and libraries at PHP startup, and to instantiate FFI objects when necessary. Header files
-    may be extended with special <literal>FFI_SCOPE</literal> defines (e.g. <code>#define FFI_SCOPE "foo"</code>;
-    the default scope is "C") and then loaded by <methodname>FFI::load</methodname> during preloading.
+
+    Header files
+    may be extended with special <literal>FFI_SCOPE</literal> defines (例: <code>#define FFI_SCOPE "foo"</code>
+    デフォルトのスコープは "C" です) and then loaded by <methodname>FFI::load</methodname> during preloading.
+
     This leads to the creation of a persistent binding, that will be available to all the following
     requests through <methodname>FFI::scope</methodname>.
+
     詳しくは <link linkend="ffi.examples-complete">PHP/FFI/事前ロードの完全な例</link>
     を参照してください。
    </para>
    <para>
-    一つ以上の C のヘッダーファイルを同一のスコープへと事前ロードすることは可能です。
+    複数の C のヘッダーファイルを同一のスコープへと事前ロードできます。
    </para>
   </section>
 <!-- }}} -->

reference/ffi/ffi/arraytype.xml

@@ -2,7 +2,6 @@
 <!-- $Revision$ -->
 <!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: nsfisis Status: working -->
 
-!!!
 <refentry xml:id="ffi.arraytype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>FFI::arrayType</refname>

reference/ffi/ffi/cdef.xml

@@ -27,10 +27,8 @@
     <term><parameter>code</parameter></term>
     <listitem>
      <para>
-      !!!
-      A string containing a sequence of declarations in regular C language
-      (types, structures, functions, variables, etc). Actually, this string may
-      be copy-pasted from C header files.
+      通常の C 言語の宣言 (型、構造体、関数、変数など) を含む文字列。
+      実際には、この文字列は C のヘッダーファイルからコピーペーストしてきたものかもしれません。
      </para>
      <note>
       <para>
@@ -44,16 +42,15 @@
     <term><parameter>lib</parameter></term>
     <listitem>
      <para>
-      !!!
-      The name of a shared library file, to be loaded and linked with the
-      definitions.
+      共有ライブラリの名前。
+      ここで指定したライブラリが読み込まれ、与えた定義とリンクされます。
      </para>
      <note>
       <para>
-       !!!
-       If <parameter>lib</parameter> is omitted or &null;, platforms supporting <literal>RTLD_DEFAULT</literal>
-       attempt to lookup symbols declared in <parameter>code</parameter> in the normal global
-       scope. Other systems will fail to resolve these symbols.
+       <parameter>lib</parameter> を省略したり &null; を渡したりすると、
+       <literal>RTLD_DEFAULT</literal> をサポートしているプラットフォームでは、
+       通常のグローバルスコープから <parameter>code</parameter> で宣言されているシンボルを探索しようとします。
+       そうでないシステムでは、シンボルの解決に失敗します。
       </para>
      </note>
     </listitem>

reference/ffi/ffi/load.xml

@@ -16,9 +16,8 @@
   </methodsynopsis>
   <para>
    C のヘッダーファイルから C の宣言を読み込みます。
-   !!!
-   Loads C declarations from a C header file. It is possible to specify shared libraries that should be loaded,
-   using special <literal>FFI_LIB</literal> defines in the loaded C header file.
+   読み込まれる C のヘッダーファイル内で特殊な define <literal>FFI_LIB</literal> を使うことで、
+   読み込む共有ライブラリを指定することが可能です。
   </para>
  </refsect1>
 
@@ -34,21 +33,20 @@
      <para>
       C のプリプロセッサーディレクティブはサポートされていません。
       例えば、<code>#include</code> や <code>#define</code>、プリプロセッサーマクロは動作しません。
-      ただし、次に列挙する特殊な場合を除きます。
+      ただし、次に挙げる特殊な場合を除きます。
      </para>
      <para>
-      !!!
-      The header file <emphasis>should</emphasis> contain a <literal>#define</literal> statement for the
-      <literal>FFI_SCOPE</literal> variable, e.g.: <code>#define FFI_SCOPE "MYLIB"</code>.
-      詳しくは <link linkend="ffi.intro">class introduction</link> を参照してください。
+      このヘッダーファイルでは、<literal>#define</literal> 文で
+      <literal>FFI_SCOPE</literal> 変数を定義<emphasis>すべき</emphasis>です
+      (例: <code>#define FFI_SCOPE "MYLIB"</code>)。
+      詳しくは <link linkend="ffi.intro">FFI クラスの概要</link> を参照してください。
      </para>
      <para>
-      !!!
-      The header file <emphasis>may</emphasis> contain a <literal>#define</literal> statement for the
-      <literal>FFI_LIB</literal> variable to specify the library it exposes. If it is
-      a system library only the file name is required, e.g.: <code>#define FFI_LIB
-      "libc.so.6"</code>.  If it is a custom library, a relative path is required,
-      e.g.: <code>#define FFI_LIB "./mylib.so"</code>.
+      このヘッダーファイルでは、<literal>#define</literal> 文で
+      <literal>FFI_LIB</literal> 変数を定義することで、公開するライブラリを指定<emphasis>しても構いません</emphasis>。
+      それがシステムライブラリなら、必要なのはファイル名だけです (例: <code>#define FFI_LIB
+      "libc.so.6"</code>)。カスタムライブラリなら、相対パスが必要です
+      (例: <code>#define FFI_LIB "./mylib.so"</code>)。
      </para>
     </listitem>
    </varlistentry>
@@ -77,11 +75,10 @@
      <row>
       <entry>8.3.0</entry>
       <entry>
-       !!!
-       <methodname>FFI::load</methodname> is now allowed in
-       <link linkend="opcache.preloading">preload scripts</link> when the
-       current system user is the same as the one defined in the
-       <literal>opcache.preload_user</literal> configuration directive.
+       現在のシステムユーザが <literal>opcache.preload_user</literal>
+       設定ディレクティブで定義されたユーザと同じである場合、
+       <link linkend="opcache.preloading">事前ロードスクリプト</link> の中で
+       <methodname>FFI::load</methodname> を呼べるようになりました。
       </entry>
      </row>
     </tbody>