From c28614a0b224ff715537d0faf548ceecaf85bc06 Mon Sep 17 00:00:00 2001
From: Chris Hennick <4961925+Pr0methean@users.noreply.github.com>
Date: Fri, 10 May 2024 16:33:54 -0700
Subject: [PATCH] doc: Document the guarantee provided by
 137672cb29a264412211cc20b78f540308a221d3

---
 src/read.rs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/read.rs b/src/read.rs
index 8e80ce13..0199f7e1 100644
--- a/src/read.rs
+++ b/src/read.rs
@@ -658,8 +658,10 @@ impl<R: Read + Seek> ZipArchive<R> {
     /// Extract a Zip archive into a directory, overwriting files if they
     /// already exist. Paths are sanitized with [`ZipFile::enclosed_name`].
     ///
-    /// Extraction is not atomic; If an error is encountered, some of the files
-    /// may be left on disk.
+    /// Extraction is not atomic. If an error is encountered, some of the files
+    /// may be left on disk. However, on Unix systems, no newly-created directories will be
+    /// readable, writable or usable as process working directories by any user except you unless
+    /// and until their contents are fully extracted.
     pub fn extract<P: AsRef<Path>>(&mut self, directory: P) -> ZipResult<()> {
         use std::fs;
         #[cfg(unix)]