added the descriptions about Unicode
hamigaki/trunk/libs/archivers/doc/format.xml (diff)| @@ -78,6 +78,13 @@ | ||
| 78 | 78 | <listitem>System Use Sharing Protocol 終端 ("ST" System Use Entry)</listitem> |
| 79 | 79 | <listitem>拡張の選択 ("ES" System Use Entry)</listitem> |
| 80 | 80 | </itemizedlist> |
| 81 | + | |
| 82 | + <itemizedlist> | |
| 83 | + <title>Unicode対応</title> | |
| 84 | + <listitem>Joliet拡張はファイル名や追加情報にUCS-2(ビッグエンディアン)を用いる。</listitem> | |
| 85 | + <listitem><classname>wiso_file_sink</classname>では、<code>set_joliet()</code>メンバ関数でJoliet拡張を有効にしたボリューム記述子を追加することで、Unicodeファイル名を含んだ書庫を作成することができる。</listitem> | |
| 86 | + <listitem><classname>wiso_file_source</classname>では、<code>is_joliet()</code>が<code>true</code>となるボリューム記述子を選択することで、Unicodeファイル名を読み出すことができる。</listitem> | |
| 87 | + </itemizedlist> | |
| 81 | 88 | </section> |
| 82 | 89 | |
| 83 | 90 | <section id="archivers.format.lzh"> |
| @@ -115,6 +122,12 @@ | ||
| 115 | 122 | <listitem>ユーザー名ヘッダ (0x53)</listitem> |
| 116 | 123 | <listitem>更新日時ヘッダ (0x54)</listitem> |
| 117 | 124 | </itemizedlist> |
| 125 | + | |
| 126 | + <itemizedlist> | |
| 127 | + <title>Unicode対応</title> | |
| 128 | + <listitem>Level 2ヘッダでは拡張ヘッダ「Unicode ファイル名ヘッダ」と「Unicode パス名ヘッダ」が利用可能である。これらの拡張ヘッダではUTF-16(リトルエンディアン)が用いられる。</listitem> | |
| 129 | + <listitem><classname>wlzh_file_sink</classname>では、<classname alt="lha::basic_header">wheader</classname>の<code>level</code>に2(既定値)を設定することで、Unicodeファイル名を含んだ書庫を作成することができる。</listitem> | |
| 130 | + </itemizedlist> | |
| 118 | 131 | </section> |
| 119 | 132 | |
| 120 | 133 | <section id="archivers.format.tar"> |
| @@ -147,6 +160,12 @@ | ||
| 147 | 160 | <listitem>ユーザー名ヘッダ (uname)</listitem> |
| 148 | 161 | <listitem>最終状態変更時間ヘッダ (ctime)</listitem> |
| 149 | 162 | </itemizedlist> |
| 163 | + | |
| 164 | + <itemizedlist> | |
| 165 | + <title>Unicode対応</title> | |
| 166 | + <listitem>pax拡張ヘッダは全てのデータをUTF-8で記録することになっている。</listitem> | |
| 167 | + <listitem><classname>wtar_file_sink</classname>では、<classname alt="tar::basic_header">wheader</classname>の<code>format</code>に<code>tar::pax</code>を設定することで、Unicodeファイル名を含んだ書庫を作成することができる。</listitem> | |
| 168 | + </itemizedlist> | |
| 150 | 169 | </section> |
| 151 | 170 | |
| 152 | 171 | <section id="archivers.format.zip"> |
| @@ -173,5 +192,11 @@ | ||
| 173 | 192 | <listitem>拡張タイムスタンプフィールド (0x5455)</listitem> |
| 174 | 193 | <listitem>Info-ZIP互換 新UNIXフィールド (0x7855)</listitem> |
| 175 | 194 | </itemizedlist> |
| 195 | + | |
| 196 | + <itemizedlist> | |
| 197 | + <title>Unicode対応</title> | |
| 198 | + <listitem>ファイル名とコメントにUTF-8を用いるオプション「Language encoding flag」が存在する。</listitem> | |
| 199 | + <listitem><classname>wzip_file_sink</classname>は、ファイル名とコメントをUTF-8に変換して出力する。</listitem> | |
| 200 | + </itemizedlist> | |
| 176 | 201 | </section> |
| 177 | 202 | </section> |
