zip を原文の変更に追従 (2ファイル)

reference/zip/ziparchive/close.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 5cb356334f35b9ae452e3af47d2d9f0b1cd16b63 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="ziparchive.close" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -18,6 +18,16 @@
    変更内容を保存します。このメソッドは、
    スクリプトの最後で自動的にコールされます。
   </simpara>
+  <note>
+   <simpara>
+    アーカイブに対する変更 (エントリの追加・削除・名前の変更) はすべてメモリ上で行われ、
+    このメソッドがコールされたときにはじめてディスクに書き込まれます。
+    そのため、ファイルシステムの操作に関するエラー
+    (権限がない、ディレクトリが存在しないなど) は、
+    変更を行うメソッドをコールした時点ではなく、
+    アーカイブを閉じる時点で発生します。
+   </simpara>
+  </note>
   <simpara>
    アーカイブにファイルが含まれていない場合、
    グローバルフラグ <constant>ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE</constant> に従って、

reference/zip/ziparchive/open.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 5cb356334f35b9ae452e3af47d2d9f0b1cd16b63 Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="ziparchive.open" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -20,6 +20,17 @@
   <simpara>
    libzip 1.6.0 以降では、空のファイルは有効なアーカイブではなくなりました。
   </simpara>
+  <note>
+   <simpara>
+    <constant>ZipArchive::CREATE</constant> で新しいアーカイブを作成する場合、
+    <methodname>ZipArchive::close</methodname> を呼び出すまで、
+    ファイルは実際にはディスクに書き込まれません。
+    そのため、ファイルシステムに関連するエラー
+    (権限がない、親ディレクトリが存在しないなど) は、
+    このメソッドではなく、
+    <methodname>ZipArchive::close</methodname> を呼び出したときに報告されます。
+   </simpara>
+  </note>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;