From cfad25ee8fb9866d0cbdc43e3a89a00aed13e12c Mon Sep 17 00:00:00 2001
From: jethrogb <github@jbeekman.nl>
Date: Fri, 23 Feb 2018 11:57:38 -0800
Subject: [PATCH] Clarify interfaction between File::set_len and file cursor

---
 src/libstd/fs.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index 292a78278ab0a..db52ed67d3a85 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -453,6 +453,10 @@ impl File {
     /// will be extended to `size` and have all of the intermediate data filled
     /// in with 0s.
     ///
+    /// The file's cursor isn't changed. In particular, if the cursor was at the
+    /// end and the file is shrunk using this operation, the cursor will now be
+    /// past the end.
+    ///
     /// # Errors
     ///
     /// This function will return an error if the file is not opened for writing.