about summary refs log tree commit diff
diff options
context:
space:
mode:
authorSteve Klabnik <steve@steveklabnik.com>2015-11-16 10:38:25 -0500
committerSteve Klabnik <steve@steveklabnik.com>2015-11-16 10:38:25 -0500
commit54db4d6c685e50e0162a7f48ceacca3c9eab8a1d (patch)
treeb999db27fafeb6f927a69581645121f05c65e8d2
parent57c8a3e8b6a3200bb01d0ea60e4686a1ecfcb907 (diff)
downloadrust-54db4d6c685e50e0162a7f48ceacca3c9eab8a1d.tar.gz
rust-54db4d6c685e50e0162a7f48ceacca3c9eab8a1d.zip
Reaffirm that this is an abstraction
Fixes #29853
Fixes #29852

While these points are true, we're not going for 100% accuracy here,
this is introductory material. Changing these things would be more
confusing, but it is important to note that we're presenting an
abstraction here.
-rw-r--r--src/doc/trpl/the-stack-and-the-heap.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/src/doc/trpl/the-stack-and-the-heap.md b/src/doc/trpl/the-stack-and-the-heap.md
index f835322ee71..0c78f876aa0 100644
--- a/src/doc/trpl/the-stack-and-the-heap.md
+++ b/src/doc/trpl/the-stack-and-the-heap.md
@@ -7,6 +7,14 @@ and a heap. If you’re familiar with how C-like languages use stack allocation,
 this chapter will be a refresher. If you’re not, you’ll learn about this more
 general concept, but with a Rust-y focus.
 
+As with most things, when learning about them, we’ll use a simplified model to
+start. This lets you get a handle on the basics, without getting bogged down
+with details which are, for now, irrelevant. The examples we’ll use aren’t 100%
+accurate, but are representative for the level we’re trying to learn at right
+now. Once you have the basics down, learning more about how allocators are
+implemented, virtual memory, and other advanced topics will reveal the leaks in
+this particular abstraction.
+
 # Memory management
 
 These two terms are about memory management. The stack and the heap are