From 808b5e17f8459b8e2e94eabec2a35f47e9388c50 Mon Sep 17 00:00:00 2001 From: madelson <1269046+madelson@users.noreply.github.com> Date: Thu, 21 Jul 2022 09:09:26 -0400 Subject: [PATCH] Update ZipArchiveMode.Create doc comments For context, see #49149. The aim is to reduce confusion around the fact that Create mode supports append (unlike `FileMode.Create`). --- .../src/System/IO/Compression/ZipArchiveMode.cs | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/src/libraries/System.IO.Compression/src/System/IO/Compression/ZipArchiveMode.cs b/src/libraries/System.IO.Compression/src/System/IO/Compression/ZipArchiveMode.cs index 9119fc1a9aba90..45e6f16ce86662 100644 --- a/src/libraries/System.IO.Compression/src/System/IO/Compression/ZipArchiveMode.cs +++ b/src/libraries/System.IO.Compression/src/System/IO/Compression/ZipArchiveMode.cs @@ -13,10 +13,9 @@ public enum ZipArchiveMode /// Read, /// - /// Only supports the creation of new archives. - /// Only writing to newly created entries in the archive is permitted. - /// Each entry in the archive can only be opened for writing once. - /// If only one entry is written to at a time, data will be written to the underlying stream or file as soon as it is available. + /// Only supports appending new entries to a new or existing archive. Only writing to these newly-created entries is permitted. + /// Each such entry can only be opened for writing once, and only one entry may be open at a time. + /// Data written to entries will be directly written through to the underlying stream or file. /// The underlying stream must be writable, but need not be seekable. /// Create,