New upstream version 1.63.0+dfsg1

[rustc.git] / src / doc / rust-by-example / src / std / arc.md

diff --git a/src/doc/rust-by-example/src/std/arc.md b/src/doc/rust-by-example/src/std/arc.md
index 08d1ad31aaaf958eb06b2f273d40ca55606f8f83..f4c1ce80e7e7ad64e1717511e4e4ceb309704c87 100644 (file)
--- a/src/doc/rust-by-example/src/std/arc.md
+++ b/src/doc/rust-by-example/src/std/arc.md
@@ -1,8 +1,13 @@
 # Arc
 
-When shared ownership between threads is needed, `Arc`(Atomic Reference Counted) can be used. This struct, via the `Clone` implementation can create a reference pointer for the location of a value in the memory heap while increasing the reference counter. As it shares ownership between threads, when the last reference pointer to a value is out of scope, the variable is dropped.
+When shared ownership between threads is needed, `Arc`(Atomically Reference
+Counted) can be used. This struct, via the `Clone` implementation can create
+a reference pointer for the location of a value in the memory heap while
+increasing the reference counter. As it shares ownership between threads, when
+the last reference pointer to a value is out of scope, the variable is dropped.
 
 ```rust,editable
+use std::time::Duration;
 use std::sync::Arc;
 use std::thread;
 
@@ -11,8 +16,8 @@ fn main() {
     let apple = Arc::new("the same apple");
 
     for _ in 0..10 {
-        // Here there is no value specification as it is a pointer to a reference
-        // in the memory heap.
+        // Here there is no value specification as it is a pointer to a
+        // reference in the memory heap.
         let apple = Arc::clone(&apple);
 
         thread::spawn(move || {
@@ -21,6 +26,8 @@ fn main() {
             println!("{:?}", apple);
         });
     }
-}
 
+    // Make sure all Arc instances are printed from spawned threads.
+    thread::sleep(Duration::from_secs(1));
+}
 ```