From 7a47e2c85314ec5c13c5d0bd2992997bb10033d6 Mon Sep 17 00:00:00 2001
From: ch-iv <icheppy101@gmail.com>
Date: Wed, 23 Nov 2022 16:55:25 -0500
Subject: [PATCH] Demonstrate with an &mut reference

---
 library/core/src/pin.rs | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/library/core/src/pin.rs b/library/core/src/pin.rs
index f94969d7c1ac9..3f8acc8505ff1 100644
--- a/library/core/src/pin.rs
+++ b/library/core/src/pin.rs
@@ -491,9 +491,9 @@ impl<P: Deref<Target: Unpin>> Pin<P> {
     /// ```
     /// use std::pin::Pin;
     ///
-    /// let val: u8 = 5;
+    /// let mut val: u8 = 5;
     /// // We can pin the value, since it doesn't care about being moved
-    /// let pinned: Pin<&u8> = Pin::new(&val);
+    /// let mut pinned: Pin<&mut u8> = Pin::new(&mut val);
     /// ```
     #[inline(always)]
     #[rustc_const_unstable(feature = "const_pin", issue = "76654")]
@@ -514,7 +514,8 @@ impl<P: Deref<Target: Unpin>> Pin<P> {
     /// ```
     /// use std::pin::Pin;
     ///
-    /// let pinned: Pin<&u8> = Pin::new(&5);
+    /// let mut val: u8 = 5;
+    /// let pinned: Pin<&mut u8> = Pin::new(&mut val);
     /// // Unwrap the pin to get a reference to the value
     /// let r = Pin::into_inner(pinned);
     /// assert_eq!(*r, 5);
@@ -728,6 +729,18 @@ impl<P: DerefMut> Pin<P> {
     ///
     /// This overwrites pinned data, but that is okay: its destructor gets
     /// run before being overwritten, so no pinning guarantee is violated.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// use std::pin::Pin;
+    ///
+    /// let mut val: u8 = 5;
+    /// let mut pinned: Pin<&mut u8> = Pin::new(&mut val);
+    /// println!("{}", pinned); // 5
+    /// pinned.as_mut().set(10);
+    /// println!("{}", pinned); // 10
+    /// ```
     #[stable(feature = "pin", since = "1.33.0")]
     #[inline(always)]
     pub fn set(&mut self, value: P::Target)