docs: simplify test

src/write.rs

@@ -40,26 +40,27 @@ enum GenericZipWriter<W: Write + io::Seek> {
 /// API to edit its contents.
 ///
 /// ```
-/// fn doit() -> zip::result::ZipResult<()>
+/// # fn doit() -> zip::result::ZipResult<()>
-/// {
+/// # {
-///     use std::io::Write;
+/// # use zip::ZipWriter;
+/// use std::io::Write;
+/// use zip::write::FileOptions;
 ///
-///     // For this example we write to a buffer, but normally you should use a File
+/// // We use a buffer here, though you'd normally use a `File`
-///     let mut buf: &mut [u8] = &mut [0u8; 65536];
+/// let mut buf = [0; 65536];
-///     let mut w = std::io::Cursor::new(buf);
+/// let mut zip = zip::ZipWriter::new(std::io::Cursor::new(&mut buf));
-///     let mut zip = zip::ZipWriter::new(w);
 ///
-///     let options = zip::write::FileOptions::default().compression_method(zip::CompressionMethod::Stored);
+/// let options = zip::write::FileOptions::default().compression_method(zip::CompressionMethod::Stored);
-///     zip.start_file("hello_world.txt", options)?;
+/// zip.start_file("hello_world.txt", options)?;
-///     zip.write(b"Hello, World!")?;
+/// zip.write(b"Hello, World!")?;
 ///
-///     // Optionally finish the zip. (this is also done on drop)
+/// // Apply the changes you've made.
-///     zip.finish()?;
+/// // Dropping the `ZipWriter` will have the same effect, but may silently fail
+/// zip.finish()?;
 ///
-///     Ok(())
+/// # Ok(())
-/// }
+/// # }
-///
+/// # doit().unwrap();
-/// println!("Result: {:?}", doit().unwrap());
 /// ```
 pub struct ZipWriter<W: Write + io::Seek> {
     inner: GenericZipWriter<W>,