hirokawa Tue Jan 22 09:01:28 2002 EDT
Modified files:
/phpdoc/ja/functions bzip2.xml mcal.xml mcrypt.xml
Log:
updated translation.
Index: phpdoc/ja/functions/bzip2.xml
diff -u phpdoc/ja/functions/bzip2.xml:1.11 phpdoc/ja/functions/bzip2.xml:1.12
--- phpdoc/ja/functions/bzip2.xml:1.11 Mon Jan 14 10:48:00 2002
+++ phpdoc/ja/functions/bzip2.xml Tue Jan 22 09:01:27 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
<reference id="ref.bzip2">
<title>Bzip2 圧縮関数</title>
<titleabbrev>Bzip2</titleabbrev>
@@ -12,7 +12,7 @@
<para>
PHPにおけるbzip2サポートはデフォルトで有効になっていません。PHPで
bzip2サポートを有効にするには、PHPのコンパイル時に設定オプションに
- <link linkend="install.configure.with-bzip2">--with-bz2</link>を使
+ <link linkend="install.configure.with-bz2">--with-bz2</link>を使
用する必要があります。このモジュールは、bzip2/libbzip2 version
>= 1.0.x を必要とします。
</para>
Index: phpdoc/ja/functions/mcal.xml
diff -u phpdoc/ja/functions/mcal.xml:1.18 phpdoc/ja/functions/mcal.xml:1.19
--- phpdoc/ja/functions/mcal.xml:1.18 Wed Dec 12 15:53:17 2001
+++ phpdoc/ja/functions/mcal.xml Tue Jan 22 09:01:27 2002
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.19 $ -->
<reference id="ref.mcal">
<title>MCAL 関数</title>
<titleabbrev>MCAL</titleabbrev>
@@ -8,7 +9,7 @@
MCAL は、Modular Calendar Access Library を意味します。
</para>
<para>
- Libmcal は、カレンダーアクセス用の C
ライブラリです。このライブラ
+ libmcal は、カレンダーアクセス用の C
+ライブラリです。このライブラ
リは、結合性の高いドライバとして書かれています。MCAL
は、メールボッ
クス用の IMAP モジュールのカレンダー版です。
</para>
@@ -38,35 +39,90 @@
</para>
<para>
MCALモジュールを使用する場合に次の定数が定義されます。
-
- MCAL_SUNDAY,
- MCAL_MONDAY,
- MCAL_TUESDAY,
- MCAL_WEDNESDAY,
- MCAL_THURSDAY,
- MCAL_FRIDAY,
- MCAL_SATURDAY,
-
- MCAL_RECUR_NONE,
- MCAL_RECUR_DAILY,
- MCAL_RECUR_WEEKLY,
- MCAL_RECUR_MONTHLY_MDAY,
- MCAL_RECUR_MONTHLY_WDAY,
- MCAL_RECUR_YEARLY,
-
- MCAL_JANUARY,
- MCAL_FEBRUARY,
- MCAL_MARCH,
- MCAL_APRIL,
- MCAL_MAY,
- MCAL_JUNE,
- MCAL_JULY,
- MCAL_AUGUGT,
- MCAL_SEPTEMBER,
- MCAL_OCTOBER,
- MCAL_NOVEMBER,
- MCAL_DECEMBER
-
+ 曜日用 :
+ <itemizedlist>
+ <listitem><simpara>
+ MCAL_SUNDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_MONDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_TUESDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_WEDNESDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_THURSDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_FRIDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_SATURDAY
+ </simpara></listitem>
+ </itemizedlist>
+ 反復用 :
+ <itemizedlist>
+ <listitem><simpara>
+ MCAL_RECUR_NONE
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_RECUR_DAILY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_RECUR_WEEKLY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_RECUR_MONTHLY_MDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_RECUR_MONTHLY_WDAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_RECUR_YEARLY
+ </simpara></listitem>
+ </itemizedlist>
+ 月用 :
+ <itemizedlist>
+ <listitem><simpara>
+ MCAL_JANUARY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_FEBRUARY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_MARCH
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_APRIL
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_MAY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_JUNE
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_JULY
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_AUGUST
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_SEPTEMBER
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_OCTOBER
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_NOVEMBER
+ </simpara></listitem>
+ <listitem><simpara>
+ MCAL_DECEMBER
+ </simpara></listitem>
+ </itemizedlist>
多くの関数は、各ストリーム毎に固有の内部イベント構造体を使用します。
これにより、大きなオブジェクトを関数の間で渡すことが容易になります。
イベント構造体の値を設定、初期化、取得する便利な関数があります。
@@ -435,13 +491,24 @@
</listitem>
<listitem>
<simpara>
- 2 - This event recurs on a weekly basis</simpara></listitem>
- <listitem><simpara>
- 3 - This event recurs monthly on a specific day of the month (e.g. the 10th of
the month)</simpara></listitem>
- <listitem><simpara>
- 4 - This event recurs monthly on a sequenced day of the week (e.g. the 3rd
Saturday) </simpara></listitem>
- <listitem><simpara>
- 5 - This event recurs on an annual basis</simpara></listitem>
+ 2 - このイベントが1週間毎に繰り返す
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 3 - このイベントは指定した日に毎月発生する (例
+毎月十日)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 4 - このイベントは月単位の週の曜日に発生する (例
+第３土曜日)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 5 - このイベントは年単位で発生する
+ </simpara>
+ </listitem>
</itemizedlist>
</para>
</refsect1>
@@ -951,9 +1018,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>mcal_date_valid</function> は、
- 指定した年月日が有効な日付である場合に &true; を、
- そうでない場合に &false; を返します。</para>
+ <function>mcal_date_valid</function>は、指定した年月日が有効な日
+ 付である場合に &true; を、そうでない場合に &false;
+を返します。
+ </para>
</refsect1>
</refentry>
@@ -961,7 +1028,7 @@
<refnamediv>
<refname>mcal_time_valid</refname>
<refpurpose>
- 指定した時間、分、秒が有効な時間である場合に &true;
を返す
+ 指定した時間、分、秒が有効な時間である場合に &true;
+を返す
</refpurpose>
</refnamediv>
<refsect1>
@@ -975,9 +1042,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>mcal_time_valid</function> は、
- 指定した時間、分、秒が有効な時間である場合に &true; を、
- そうでない場合に &false; を返します。</para>
+ <function>mcal_time_valid</function>は、指定した時間、分、秒が有
+ 効な時間である場合に &true;を、そうでない場合に &false;
+を返しま
+ す。
+ </para>
</refsect1>
</refentry>
@@ -1435,6 +1503,29 @@
<para>
<function>mcal_expunge</function> は、過去に削除マークを付けられ
た全てのイベントを削除します。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.mcal-week-of-year'>
+ <refnamediv>
+ <refname>mcal_week_of_year</refname>
+ <refpurpose>
+ 指定した日付の週番号を返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mcal_week_of_year</function></funcdef>
+ <paramdef>int <parameter>day</parameter></paramdef>
+ <paramdef>int <parameter>month</parameter></paramdef>
+ <paramdef>int <parameter>year</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
</para>
</refsect1>
</refentry>
Index: phpdoc/ja/functions/mcrypt.xml
diff -u phpdoc/ja/functions/mcrypt.xml:1.16 phpdoc/ja/functions/mcrypt.xml:1.17
--- phpdoc/ja/functions/mcrypt.xml:1.16 Wed Dec 12 15:53:17 2001
+++ phpdoc/ja/functions/mcrypt.xml Tue Jan 22 09:01:28 2002
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.17 $ -->
<reference id="ref.mcrypt">
<title>Mcrypt暗号化関数</title>
<titleabbrev>mcrypt</titleabbrev>
@@ -9,12 +10,11 @@
使用して動作します。
</para>
<para>
- この関数は、CBC, OFB, CFB ,ECB 暗号モードの
- DES,TripleDES,Blowfish (デフォルト),3-WAY,
- SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 ,GOST の
- ような広範なブロックアルゴリズムをサポートする
- mcrypt ライブラリへのインターフェースです。
- 加えて、"フリーではない" と思われるRC6 および IDEA
もサポートします。
+ この関数は、CBC, OFB, CFB ,ECB 暗号モードのDES,TripleDES,Blowfish
+ (デフォルト),3-WAY, SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2
+ ,GOST
+のような広範なブロックアルゴリズムをサポートするmcryptライブ
+ ラリへのインターフェースです。加えて、"フリーではない"
+と思われる
+ RC6 および IDEA もサポートします。
</para>
<para>
libmcrypt 2.4.xとリンクした場合、加えてブロックアルゴリズム:
@@ -41,16 +41,18 @@
<example>
<title>入力値を2.2.xにおいて ECB モードの TripleDES
で暗号化する</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$key = "this is a very secret key";
$input = "Let us meet at 9 o'clock at the secret place.";
$encrypted_data = mcrypt_ecb (MCRYPT_3DES, $key, $input, MCRYPT_ENCRYPT);
-?>
+?>
+]]>
</programlisting>
</example>
- この例では、$encrypted_data
に文字列として暗号化されたデータが
- 返されます。
+ この例では、<literal>$encrypted_data</literal>に文字列として暗号化
+ されたデータが返されます。
</para>
<para>
libmcrypt 2.4.x
とリンクした場合、上記の関数も利用可能ですが、新し
@@ -58,16 +60,18 @@
<example>
<title>2.4.xにおいてECBモードでTripleDESにより入力を暗号化する</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$key = "this is a very secret key";
$input = "Let us meet at 9 o'clock at the secret place.";
-$td = mcrypt_module_open (MCRYPT_TripleDES, "", MCRYPT_MODE_ECB);
+$td = mcrypt_module_open (MCRYPT_TripleDES, "", MCRYPT_MODE_ECB, "");
$iv = mcrypt_create_iv (mcrypt_enc_get_iv_size ($td), MCRYPT_RAND);
mcrypt_generic_init ($td, $key, $iv);
$encrypted_data = mcrypt_generic ($td, $input);
mcrypt_generic_end ($td);
-?>
+?>
+]]>
</programlisting>
</example>
この例は、<literal>$encrypted_data</literal>に文字列として暗号化さ
@@ -393,19 +397,23 @@
<example>
<title><function>mcrypt_get_cipher_name</function>の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$cipher = MCRYPT_TripleDES;
-print mcrypt_get_cipher_name($cipher);
-?>
+print mcrypt_get_cipher_name ($cipher);
+?>
+]]>
</programlisting>
- </example>
- </para>
- <para>
- 上の例の出力は次のようになります。
- <programlisting>
+ <para>
+ 上の例の出力は次のようになります。
+ <screen>
+<![CDATA[
3DES
- </programlisting>
+]]>
+ </screen>
+ </para>
+ </example>
</para>
</refsect1>
</refentry>
@@ -515,7 +523,7 @@
<para>
source には、MCRYPT_RAND (システムの乱数生成器),
MCRYPT_DEV_RANDOM (/dev/random からデータを読む) ,MCRYPT_DEV_URANDOM
- (/dev/urandom からÜÂ??読む) を指定できます。
+ (/dev/urandomからデータを読む) を指定できます。
MCRYPT_RAND を使用した場合、乱数生成器を初期化するために
必ず前もって srand() をコールして下さい。
</para>
@@ -523,11 +531,13 @@
<example>
<title><function>mcrypt_create_iv</function>の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$cipher = MCRYPT_TripleDES;
$block_size = mcrypt_get_block_size ($cipher);
$iv = mcrypt_create_iv ($block_size, MCRYPT_DEV_RANDOM);
-?>
+?>
+]]>
</programlisting>
</example>
</para>
@@ -844,20 +854,22 @@
<example>
<title><function>mcrypt_list_algorithms</function> の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$algorithms = mcrypt_list_algorithms ("/usr/local/lib/libmcrypt");
foreach ($algorithms as $cipher) {
- echo $cipher."/n";
+ echo $cipher."/n";
}
-?>
+?>
+]]>
</programlisting>
+ <para>
+ 上記の例は、"/usr/local/lib/libmcrypt"
+ディレクトリにある全ての
+ サポートされるアルゴリズムの一覧を表示します。
+ </para>
</example>
</para>
- <para>
- 上記の例は、"/usr/local/lib/libmcrypt"
ディレクトリにある全てのサ
- ポートされるアルゴリズムの一覧を表示します。
- </para>
</refsect1>
</refentry>
@@ -892,22 +904,24 @@
<example>
<title><function>mcrypt_list_modes</function> の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$modes = mcrypt_list_modes ();
foreach ($modes as $mode) {
- echo "$mode </br>";
+ echo "$mode <br/>";
}
-?>
+?>
+]]>
</programlisting>
+ <para>
+
+上の例は、デフォルトのモードディレクトリにあるサポートされる全
+ てのアルゴリズムの一覧を出力します。ini
+ディレクティブの
+ mcrypt.modes_dir
+でこれが設定されていない場合、mcryptのデフォル
+ トディレクトリ(/usr/local/lib/libmcrypt)が使用されます。
+ </para>
</example>
</para>
- <para>
-
上の例は、デフォルトのモードディレクトリにあるサポートされる全て
- のアルゴリズムの一覧を出力します。ini ディレクティブの
- mcrypt.modes_dir
でこれが設定されていない場合、mcryptのデフォルト
- ディレクトリ(/usr/local/lib/libmcrypt)が使用されます。
- </para>
</refsect1>
</refentry>
@@ -1012,7 +1026,8 @@
<example>
<title><function>mcrypt_encrypt</function> の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$iv = mcrypt_create_iv (mcrypt_get_iv_size (MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB),
MCRYPT_RAND);
$key = "This is a very secret key";
$text = "Meet me at 11 o'clock behind the monument.";
@@ -1020,14 +1035,19 @@
$crypttext = mcrypt_encrypt (MCRYPT_RIJNDAEL_256, $key, $text, MCRYPT_MODE_ECB, $iv);
echo strlen ($crypttext)."\n";
-?>
+?>
+]]>
</programlisting>
- </example>
- 上記の例の出力は次のようになります。
- <programlisting>
+ <para>
+ 上記の例の出力は次のようになります。
+ <screen>
+<![CDATA[
42
64
- </programlisting>
+]]>
+ </screen>
+ </para>
+ </example>
</para>
</refsect1>
</refentry>
@@ -1132,17 +1152,63 @@
<example>
<title><function>mcrypt_module_open</function> の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$td = mcrypt_module_open (MCRYPT_DES, "", MCRYPT_MODE_ECB, "/usr/lib/mcrypt-modes");
-?>
+?>
+]]>
</programlisting>
+ <para>
+
+上記の例は、デフォルトのディレクトリからDES暗号、ディレクトリ
+ /usr/lib/mcrypt-modesからEBCモードをオープンします。
+ </para>
</example>
-
上記の例は、デフォルトのディレクトリからDES暗号、ディレクトリ
- /usr/lib/mcrypt-modesからEBCモードをオープンします。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.mcrypt-module-close'>
+ <refnamediv>
+ <refname>mcrypt_module_close</refname>
+ <refpurpose>
+ デストラクタtdを解放する
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>mcrypt_module_close</function></funcdef>
+ <paramdef>resource <parameter>td</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
</para>
</refsect1>
</refentry>
+ <refentry id='function.mcrypt-generic-deinit'>
+ <refnamediv>
+ <refname>mcrypt_generic_deinit</refname>
+ <refpurpose>
+ デストラクタtdにより指定された暗号化を終了する
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>mcrypt_generic_deinit</function></funcdef>
+ <paramdef>resource <parameter>td</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+
<refentry id="function.mcrypt-generic-init">
<refnamediv>
<refname>mcrypt_generic_init</refname>
@@ -1224,7 +1290,8 @@
<example>
<title><function>mdecrypt_generic</function> の例</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$iv_size = mcrypt_enc_get_iv_size ($td));
$iv = @mcrypt_create_iv ($iv_size, MCRYPT_RAND);
@@ -1238,11 +1305,14 @@
echo "ok";
else
echo "error";
-?>
+?>
+]]>
</programlisting>
+ <para>
+
+上記の例は、暗号化前のデータ複合化したデータと同じであるかどう
+ かを調べる方法を示すものです。
+ </para>
</example>
-
上記の例は、暗号化前のデータ複合化したデータと同じであるかどうか
- を調べる方法を示すものです。
</para>
</refsect1>
</refentry>
