From a16e0e25517eec5ad00b4aef0991b23928aff5d6 Mon Sep 17 00:00:00 2001
From: Steve Klabnik <steve@steveklabnik.com>
Date: Mon, 8 Jun 2015 15:33:17 -0400
Subject: [PATCH] Add note about append not implying write

Hopefully this will reduce the kind of confusion @joelmccracken repots in
http://joelmccracken.github.io/entries/a-simple-web-app-in-rust-pt-2b/
---
 src/libstd/fs.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index b60a84da81ddf..e6e26060fbdd4 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -422,6 +422,11 @@ impl OpenOptions {
     /// This option, when true, means that writes will append to a file instead
     /// of overwriting previous contents.
     ///
+    /// Note that this isn't the same as `write` with the cursor starting at
+    /// the end of the file; this mode only allows writing to the end of the
+    /// file, but not changing any of its previous contents. This is common for
+    /// things like log files.
+    ///
     /// # Examples
     ///
     /// ```no_run