From bebecb8301098f2858a9d4e9afd2254afd6ec538 Mon Sep 17 00:00:00 2001
From: Marli Frost <marli@frost.red>
Date: Wed, 19 Aug 2020 13:52:27 +0100
Subject: [PATCH] docs: use more descriptive language

---
 src/read.rs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/read.rs b/src/read.rs
index c27200c8..2a8dcff5 100644
--- a/src/read.rs
+++ b/src/read.rs
@@ -1,4 +1,4 @@
-//! Structs for reading a ZIP archive
+//! Types for reading ZIP archives
 
 use crate::compression::CompressionMethod;
 use crate::crc32::Crc32Reader;
@@ -31,7 +31,7 @@ mod ffi {
     pub const S_IFREG: u32 = 0o0100000;
 }
 
-/// Wrapper for reading the contents of a ZIP file.
+/// ZIP archive reader
 ///
 /// ```no_run
 /// # use std::io::prelude::*;
@@ -276,7 +276,9 @@ impl<R: Read + io::Seek> ZipArchive<R> {
         }
     }
 
-    /// Opens a Zip archive and parses the central directory
+    /// Read a ZIP archive, collecting the files it contains
+    ///
+    /// This uses the central directory record of the ZIP file, and ignores local file headers
     pub fn new(mut reader: R) -> ZipResult<ZipArchive<R>> {
         let (footer, cde_start_pos) = spec::CentralDirectoryEnd::find_and_parse(&mut reader)?;