Adding upstream version 1.64.0+dfsg1.upstream/1.64.0+dfsg1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

59 files changed, 633 insertions, 0 deletions

diff --git a/src/doc/book/first-edition/book.toml b/src/doc/book/first-edition/book.toml
new file mode 100644
index 000000000..3a3189c4d
--- /dev/null
+++ b/src/doc/book/first-edition/book.toml
@@ -0,0 +1,3 @@
+[book]
+title = "The Rust Programming Language"
+author = "The Rust Project Developers"
diff --git a/src/doc/book/first-edition/src/README.md b/src/doc/book/first-edition/src/README.md
new file mode 100644
index 000000000..31babb298
--- /dev/null
+++ b/src/doc/book/first-edition/src/README.md
@@ -0,0 +1,10 @@
+# The Rust Programming Language
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/README.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/SUMMARY.md b/src/doc/book/first-edition/src/SUMMARY.md
new file mode 100644
index 000000000..c3763cdf9
--- /dev/null
+++ b/src/doc/book/first-edition/src/SUMMARY.md
@@ -0,0 +1,60 @@
+# Summary
+
+[Introduction](README.md)
+
+* [Getting Started](getting-started.md)
+* [Tutorial: Guessing Game](guessing-game.md)
+* [Syntax and Semantics](syntax-and-semantics.md)
+    * [Variable Bindings](variable-bindings.md)
+    * [Functions](functions.md)
+    * [Primitive Types](primitive-types.md)
+    * [Comments](comments.md)
+    * [if](if.md)
+    * [Loops](loops.md)
+    * [Vectors](vectors.md)
+    * [Ownership](ownership.md)
+    * [References and Borrowing](references-and-borrowing.md)
+    * [Lifetimes](lifetimes.md)
+    * [Mutability](mutability.md)
+    * [Structs](structs.md)
+    * [Enums](enums.md)
+    * [Match](match.md)
+    * [Patterns](patterns.md)
+    * [Method Syntax](method-syntax.md)
+    * [Strings](strings.md)
+    * [Generics](generics.md)
+    * [Traits](traits.md)
+    * [Drop](drop.md)
+    * [if let](if-let.md)
+    * [Trait Objects](trait-objects.md)
+    * [Closures](closures.md)
+    * [Universal Function Call Syntax](ufcs.md)
+    * [Crates and Modules](crates-and-modules.md)
+    * [`const` and `static`](const-and-static.md)
+    * [Attributes](attributes.md)
+    * [`type` aliases](type-aliases.md)
+    * [Casting between types](casting-between-types.md)
+    * [Associated Types](associated-types.md)
+    * [Unsized Types](unsized-types.md)
+    * [Operators and Overloading](operators-and-overloading.md)
+    * [Deref coercions](deref-coercions.md)
+    * [Macros](macros.md)
+    * [Raw Pointers](raw-pointers.md)
+    * [`unsafe`](unsafe.md)
+* [Effective Rust](effective-rust.md)
+    * [The Stack and the Heap](the-stack-and-the-heap.md)
+    * [Testing](testing.md)
+    * [Conditional Compilation](conditional-compilation.md)
+    * [Documentation](documentation.md)
+    * [Iterators](iterators.md)
+    * [Concurrency](concurrency.md)
+    * [Error Handling](error-handling.md)
+    * [Choosing your Guarantees](choosing-your-guarantees.md)
+    * [FFI](ffi.md)
+    * [Borrow and AsRef](borrow-and-asref.md)
+    * [Release Channels](release-channels.md)
+    * [Using Rust without the standard library](using-rust-without-the-standard-library.md)
+    * [Procedural Macros (and custom derive)](procedural-macros.md)
+* [Glossary](glossary.md)
+* [Syntax Index](syntax-index.md)
+* [Bibliography](bibliography.md)
diff --git a/src/doc/book/first-edition/src/associated-types.md b/src/doc/book/first-edition/src/associated-types.md
new file mode 100644
index 000000000..626048e9e
--- /dev/null
+++ b/src/doc/book/first-edition/src/associated-types.md
@@ -0,0 +1,10 @@
+# Associated Types
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-03-advanced-traits.html#specifying-placeholder-types-in-trait-definitions-with-associated-types) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/associated-types.html).
diff --git a/src/doc/book/first-edition/src/attributes.md b/src/doc/book/first-edition/src/attributes.md
new file mode 100644
index 000000000..b39fcdd67
--- /dev/null
+++ b/src/doc/book/first-edition/src/attributes.md
@@ -0,0 +1,10 @@
+# Attributes
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/attributes.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/bibliography.md b/src/doc/book/first-edition/src/bibliography.md
new file mode 100644
index 000000000..9609068fd
--- /dev/null
+++ b/src/doc/book/first-edition/src/bibliography.md
@@ -0,0 +1,10 @@
+# Bibliography
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/bibliography.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/borrow-and-asref.md b/src/doc/book/first-edition/src/borrow-and-asref.md
new file mode 100644
index 000000000..a088bc8d7
--- /dev/null
+++ b/src/doc/book/first-edition/src/borrow-and-asref.md
@@ -0,0 +1,10 @@
+# Borrow and AsRef
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch15-00-smart-pointers.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/borrow-and-asref.html).
diff --git a/src/doc/book/first-edition/src/casting-between-types.md b/src/doc/book/first-edition/src/casting-between-types.md
new file mode 100644
index 000000000..34d4e84e5
--- /dev/null
+++ b/src/doc/book/first-edition/src/casting-between-types.md
@@ -0,0 +1,10 @@
+# Casting Between Types
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/casting-between-types.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/choosing-your-guarantees.md b/src/doc/book/first-edition/src/choosing-your-guarantees.md
new file mode 100644
index 000000000..9e56d9da2
--- /dev/null
+++ b/src/doc/book/first-edition/src/choosing-your-guarantees.md
@@ -0,0 +1,10 @@
+# Choosing your Guarantees
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch15-00-smart-pointers.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/choosing-your-guarantees.html).
diff --git a/src/doc/book/first-edition/src/closures.md b/src/doc/book/first-edition/src/closures.md
new file mode 100644
index 000000000..3852e28f5
--- /dev/null
+++ b/src/doc/book/first-edition/src/closures.md
@@ -0,0 +1,10 @@
+# Closures
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch13-01-closures.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/closures.html).
diff --git a/src/doc/book/first-edition/src/comments.md b/src/doc/book/first-edition/src/comments.md
new file mode 100644
index 000000000..cf56cd67b
--- /dev/null
+++ b/src/doc/book/first-edition/src/comments.md
@@ -0,0 +1,10 @@
+# Comments
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-04-comments.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/comments.html).
diff --git a/src/doc/book/first-edition/src/concurrency.md b/src/doc/book/first-edition/src/concurrency.md
new file mode 100644
index 000000000..adb6e85b8
--- /dev/null
+++ b/src/doc/book/first-edition/src/concurrency.md
@@ -0,0 +1,10 @@
+# Concurrency
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch16-00-concurrency.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/concurrency.html).
diff --git a/src/doc/book/first-edition/src/conditional-compilation.md b/src/doc/book/first-edition/src/conditional-compilation.md
new file mode 100644
index 000000000..80184ba3e
--- /dev/null
+++ b/src/doc/book/first-edition/src/conditional-compilation.md
@@ -0,0 +1,10 @@
+# Conditional Compilation
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/conditional-compilation.html).
diff --git a/src/doc/book/first-edition/src/const-and-static.md b/src/doc/book/first-edition/src/const-and-static.md
new file mode 100644
index 000000000..aa634112b
--- /dev/null
+++ b/src/doc/book/first-edition/src/const-and-static.md
@@ -0,0 +1,10 @@
+# const and static
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-01-unsafe-rust.html#accessing-or-modifying-a-mutable-static-variable) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/const-and-static.html).
diff --git a/src/doc/book/first-edition/src/crates-and-modules.md b/src/doc/book/first-edition/src/crates-and-modules.md
new file mode 100644
index 000000000..66262b340
--- /dev/null
+++ b/src/doc/book/first-edition/src/crates-and-modules.md
@@ -0,0 +1,10 @@
+# Crates and Modules
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch07-00-managing-growing-projects-with-packages-crates-and-modules.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/crates-and-modules.html).
diff --git a/src/doc/book/first-edition/src/deref-coercions.md b/src/doc/book/first-edition/src/deref-coercions.md
new file mode 100644
index 000000000..1e43ff453
--- /dev/null
+++ b/src/doc/book/first-edition/src/deref-coercions.md
@@ -0,0 +1,10 @@
+# `Deref` coercions
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch15-02-deref.html#implicit-deref-coercions-with-functions-and-methods) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/deref-coercions.html).
diff --git a/src/doc/book/first-edition/src/documentation.md b/src/doc/book/first-edition/src/documentation.md
new file mode 100644
index 000000000..ac9ecba80
--- /dev/null
+++ b/src/doc/book/first-edition/src/documentation.md
@@ -0,0 +1,10 @@
+# Documentation
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch14-02-publishing-to-crates-io.html#making-useful-documentation-comments) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/documentation.html).
diff --git a/src/doc/book/first-edition/src/drop.md b/src/doc/book/first-edition/src/drop.md
new file mode 100644
index 000000000..1abde150e
--- /dev/null
+++ b/src/doc/book/first-edition/src/drop.md
@@ -0,0 +1,10 @@
+# Drop
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch15-03-drop.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/drop.html).
diff --git a/src/doc/book/first-edition/src/effective-rust.md b/src/doc/book/first-edition/src/effective-rust.md
new file mode 100644
index 000000000..1087c6541
--- /dev/null
+++ b/src/doc/book/first-edition/src/effective-rust.md
@@ -0,0 +1,10 @@
+# Effective Rust
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/effective-rust.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/enums.md b/src/doc/book/first-edition/src/enums.md
new file mode 100644
index 000000000..e26e19820
--- /dev/null
+++ b/src/doc/book/first-edition/src/enums.md
@@ -0,0 +1,10 @@
+# Enums
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch06-01-defining-an-enum.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/enums.html).
diff --git a/src/doc/book/first-edition/src/error-handling.md b/src/doc/book/first-edition/src/error-handling.md
new file mode 100644
index 000000000..35b780ae7
--- /dev/null
+++ b/src/doc/book/first-edition/src/error-handling.md
@@ -0,0 +1,10 @@
+# Error Handling
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch09-00-error-handling.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/error-handling.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/ffi.md b/src/doc/book/first-edition/src/ffi.md
new file mode 100644
index 000000000..2adaff9d8
--- /dev/null
+++ b/src/doc/book/first-edition/src/ffi.md
@@ -0,0 +1,10 @@
+# Foreign Function Interface
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-01-unsafe-rust.html#calling-rust-functions-from-other-languages) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/ffi.html).
diff --git a/src/doc/book/first-edition/src/functions.md b/src/doc/book/first-edition/src/functions.md
new file mode 100644
index 000000000..b6af0f670
--- /dev/null
+++ b/src/doc/book/first-edition/src/functions.md
@@ -0,0 +1,10 @@
+# Functions
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-03-how-functions-work.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/functions.html).
diff --git a/src/doc/book/first-edition/src/generics.md b/src/doc/book/first-edition/src/generics.md
new file mode 100644
index 000000000..953ba03e2
--- /dev/null
+++ b/src/doc/book/first-edition/src/generics.md
@@ -0,0 +1,10 @@
+# Generics
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch10-00-generics.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/generics.html).
diff --git a/src/doc/book/first-edition/src/getting-started.md b/src/doc/book/first-edition/src/getting-started.md
new file mode 100644
index 000000000..cd3ccf775
--- /dev/null
+++ b/src/doc/book/first-edition/src/getting-started.md
@@ -0,0 +1,10 @@
+# Getting Started
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch00-00-introduction.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/getting-started.html).
diff --git a/src/doc/book/first-edition/src/glossary.md b/src/doc/book/first-edition/src/glossary.md
new file mode 100644
index 000000000..03a2833e4
--- /dev/null
+++ b/src/doc/book/first-edition/src/glossary.md
@@ -0,0 +1,10 @@
+# Glossary
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/glossary.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/guessing-game.md b/src/doc/book/first-edition/src/guessing-game.md
new file mode 100644
index 000000000..3191cc972
--- /dev/null
+++ b/src/doc/book/first-edition/src/guessing-game.md
@@ -0,0 +1,10 @@
+# Guessing Game
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch02-00-guessing-game-tutorial.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/guessing-game.html).
diff --git a/src/doc/book/first-edition/src/if-let.md b/src/doc/book/first-edition/src/if-let.md
new file mode 100644
index 000000000..b4a95d24f
--- /dev/null
+++ b/src/doc/book/first-edition/src/if-let.md
@@ -0,0 +1,10 @@
+# if let
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch06-03-if-let.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/if-let.html).
diff --git a/src/doc/book/first-edition/src/if.md b/src/doc/book/first-edition/src/if.md
new file mode 100644
index 000000000..bd8f8e6c7
--- /dev/null
+++ b/src/doc/book/first-edition/src/if.md
@@ -0,0 +1,10 @@
+# if
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-05-control-flow.html#if-expressions) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/if.html).
diff --git a/src/doc/book/first-edition/src/iterators.md b/src/doc/book/first-edition/src/iterators.md
new file mode 100644
index 000000000..d4dbd1e29
--- /dev/null
+++ b/src/doc/book/first-edition/src/iterators.md
@@ -0,0 +1,10 @@
+# Iterators
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch13-02-iterators.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/iterators.html).
diff --git a/src/doc/book/first-edition/src/lifetimes.md b/src/doc/book/first-edition/src/lifetimes.md
new file mode 100644
index 000000000..2208c966e
--- /dev/null
+++ b/src/doc/book/first-edition/src/lifetimes.md
@@ -0,0 +1,10 @@
+# Lifetimes
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch10-03-lifetime-syntax.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/lifetimes.html).
diff --git a/src/doc/book/first-edition/src/loops.md b/src/doc/book/first-edition/src/loops.md
new file mode 100644
index 000000000..07ecd3342
--- /dev/null
+++ b/src/doc/book/first-edition/src/loops.md
@@ -0,0 +1,10 @@
+# Loops
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-05-control-flow.html#repetition-with-loops) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/loops.html).
diff --git a/src/doc/book/first-edition/src/macros.md b/src/doc/book/first-edition/src/macros.md
new file mode 100644
index 000000000..6bafdc1e4
--- /dev/null
+++ b/src/doc/book/first-edition/src/macros.md
@@ -0,0 +1,10 @@
+# Macros
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-06-macros.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/macros.html).
diff --git a/src/doc/book/first-edition/src/match.md b/src/doc/book/first-edition/src/match.md
new file mode 100644
index 000000000..b9808193e
--- /dev/null
+++ b/src/doc/book/first-edition/src/match.md
@@ -0,0 +1,10 @@
+# Match
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch06-02-match.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/match.html).
diff --git a/src/doc/book/first-edition/src/method-syntax.md b/src/doc/book/first-edition/src/method-syntax.md
new file mode 100644
index 000000000..74c232bf9
--- /dev/null
+++ b/src/doc/book/first-edition/src/method-syntax.md
@@ -0,0 +1,10 @@
+# Method Syntax
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch05-03-method-syntax.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/method-syntax.html).
diff --git a/src/doc/book/first-edition/src/mutability.md b/src/doc/book/first-edition/src/mutability.md
new file mode 100644
index 000000000..2f557de1d
--- /dev/null
+++ b/src/doc/book/first-edition/src/mutability.md
@@ -0,0 +1,10 @@
+# Mutability
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-01-variables-and-mutability.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/mutability.html).
diff --git a/src/doc/book/first-edition/src/operators-and-overloading.md b/src/doc/book/first-edition/src/operators-and-overloading.md
new file mode 100644
index 000000000..921a2a685
--- /dev/null
+++ b/src/doc/book/first-edition/src/operators-and-overloading.md
@@ -0,0 +1,10 @@
+# Operators and Overloading
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-03-advanced-traits.html#default-generic-type-parameters-and-operator-overloading) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/operators-and-overloading.html).
diff --git a/src/doc/book/first-edition/src/ownership.md b/src/doc/book/first-edition/src/ownership.md
new file mode 100644
index 000000000..70fbe4847
--- /dev/null
+++ b/src/doc/book/first-edition/src/ownership.md
@@ -0,0 +1,10 @@
+# Ownership
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch04-00-understanding-ownership.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/ownership.html).
diff --git a/src/doc/book/first-edition/src/patterns.md b/src/doc/book/first-edition/src/patterns.md
new file mode 100644
index 000000000..d722d397e
--- /dev/null
+++ b/src/doc/book/first-edition/src/patterns.md
@@ -0,0 +1,10 @@
+# Patterns
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch18-03-pattern-syntax.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/patterns.html).
diff --git a/src/doc/book/first-edition/src/primitive-types.md b/src/doc/book/first-edition/src/primitive-types.md
new file mode 100644
index 000000000..39ee0b2d1
--- /dev/null
+++ b/src/doc/book/first-edition/src/primitive-types.md
@@ -0,0 +1,10 @@
+# Primitive Types
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-02-data-types.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/primitive-types.html).
diff --git a/src/doc/book/first-edition/src/procedural-macros.md b/src/doc/book/first-edition/src/procedural-macros.md
new file mode 100644
index 000000000..9778383d8
--- /dev/null
+++ b/src/doc/book/first-edition/src/procedural-macros.md
@@ -0,0 +1,10 @@
+# Procedural Macros (and custom Derive)
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-06-macros.html?highlight=procedural#procedural-macros-for-generating-code-from-attributes) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/procedural-macros.html).
diff --git a/src/doc/book/first-edition/src/raw-pointers.md b/src/doc/book/first-edition/src/raw-pointers.md
new file mode 100644
index 000000000..c149da868
--- /dev/null
+++ b/src/doc/book/first-edition/src/raw-pointers.md
@@ -0,0 +1,10 @@
+# Raw Pointers
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-01-unsafe-rust.html#dereferencing-a-raw-pointer) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/raw-pointers.html).
diff --git a/src/doc/book/first-edition/src/references-and-borrowing.md b/src/doc/book/first-edition/src/references-and-borrowing.md
new file mode 100644
index 000000000..1d8c75e2d
--- /dev/null
+++ b/src/doc/book/first-edition/src/references-and-borrowing.md
@@ -0,0 +1,10 @@
+# References and Borrowing
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch04-02-references-and-borrowing.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/references-and-borrowing.html).
diff --git a/src/doc/book/first-edition/src/release-channels.md b/src/doc/book/first-edition/src/release-channels.md
new file mode 100644
index 000000000..f0a643f27
--- /dev/null
+++ b/src/doc/book/first-edition/src/release-channels.md
@@ -0,0 +1,10 @@
+# Release Channels
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/release-channels.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/strings.md b/src/doc/book/first-edition/src/strings.md
new file mode 100644
index 000000000..f7648cde5
--- /dev/null
+++ b/src/doc/book/first-edition/src/strings.md
@@ -0,0 +1,10 @@
+# Strings
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch08-02-strings.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/strings.html).
diff --git a/src/doc/book/first-edition/src/structs.md b/src/doc/book/first-edition/src/structs.md
new file mode 100644
index 000000000..acfcdaf51
--- /dev/null
+++ b/src/doc/book/first-edition/src/structs.md
@@ -0,0 +1,10 @@
+# Structs
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch05-00-structs.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/structs.html).
diff --git a/src/doc/book/first-edition/src/syntax-and-semantics.md b/src/doc/book/first-edition/src/syntax-and-semantics.md
new file mode 100644
index 000000000..62740385c
--- /dev/null
+++ b/src/doc/book/first-edition/src/syntax-and-semantics.md
@@ -0,0 +1,10 @@
+# Syntax and Semantics
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch03-00-common-programming-concepts.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/syntax-and-semantics.html).
diff --git a/src/doc/book/first-edition/src/syntax-index.md b/src/doc/book/first-edition/src/syntax-index.md
new file mode 100644
index 000000000..a2ab62cac
--- /dev/null
+++ b/src/doc/book/first-edition/src/syntax-index.md
@@ -0,0 +1,10 @@
+# Syntax Index
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/syntax-index.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/testing.md b/src/doc/book/first-edition/src/testing.md
new file mode 100644
index 000000000..d59418979
--- /dev/null
+++ b/src/doc/book/first-edition/src/testing.md
@@ -0,0 +1,10 @@
+# Testing
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch11-00-testing.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/testing.html).
diff --git a/src/doc/book/first-edition/src/the-stack-and-the-heap.md b/src/doc/book/first-edition/src/the-stack-and-the-heap.md
new file mode 100644
index 000000000..5c53af356
--- /dev/null
+++ b/src/doc/book/first-edition/src/the-stack-and-the-heap.md
@@ -0,0 +1,10 @@
+# The Stack and the Heap
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch04-01-what-is-ownership.html#the-stack-and-the-heap) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/the-stack-and-the-heap.html).
diff --git a/src/doc/book/first-edition/src/trait-objects.md b/src/doc/book/first-edition/src/trait-objects.md
new file mode 100644
index 000000000..871bad614
--- /dev/null
+++ b/src/doc/book/first-edition/src/trait-objects.md
@@ -0,0 +1,10 @@
+# Trait Objects
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch17-02-trait-objects.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/trait-objects.html).
diff --git a/src/doc/book/first-edition/src/traits.md b/src/doc/book/first-edition/src/traits.md
new file mode 100644
index 000000000..955776a74
--- /dev/null
+++ b/src/doc/book/first-edition/src/traits.md
@@ -0,0 +1,10 @@
+# Traits
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch10-02-traits.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/traits.html).
diff --git a/src/doc/book/first-edition/src/type-aliases.md b/src/doc/book/first-edition/src/type-aliases.md
new file mode 100644
index 000000000..7ac51ff19
--- /dev/null
+++ b/src/doc/book/first-edition/src/type-aliases.md
@@ -0,0 +1,10 @@
+# Type Aliases
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-04-advanced-types.html#creating-type-synonyms-with-type-aliases) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/type-aliases.html).
diff --git a/src/doc/book/first-edition/src/ufcs.md b/src/doc/book/first-edition/src/ufcs.md
new file mode 100644
index 000000000..dad121ab3
--- /dev/null
+++ b/src/doc/book/first-edition/src/ufcs.md
@@ -0,0 +1,10 @@
+# Universal Function Call Syntax
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/ufcs.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/unsafe.md b/src/doc/book/first-edition/src/unsafe.md
new file mode 100644
index 000000000..be816dfd3
--- /dev/null
+++ b/src/doc/book/first-edition/src/unsafe.md
@@ -0,0 +1,10 @@
+# Unsafe
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-01-unsafe-rust.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/unsafe.html).
diff --git a/src/doc/book/first-edition/src/unsized-types.md b/src/doc/book/first-edition/src/unsized-types.md
new file mode 100644
index 000000000..4ec43ecad
--- /dev/null
+++ b/src/doc/book/first-edition/src/unsized-types.md
@@ -0,0 +1,10 @@
+# Unsized Types
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch19-04-advanced-types.html#dynamically-sized-types-and-the-sized-trait) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/unsized-types.html).
diff --git a/src/doc/book/first-edition/src/using-rust-without-the-standard-library.md b/src/doc/book/first-edition/src/using-rust-without-the-standard-library.md
new file mode 100644
index 000000000..28e4e763b
--- /dev/null
+++ b/src/doc/book/first-edition/src/using-rust-without-the-standard-library.md
@@ -0,0 +1,10 @@
+# Using Rust Without the Standard Library
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/using-rust-without-the-standard-library.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/variable-bindings.md b/src/doc/book/first-edition/src/variable-bindings.md
new file mode 100644
index 000000000..d11c926fd
--- /dev/null
+++ b/src/doc/book/first-edition/src/variable-bindings.md
@@ -0,0 +1,10 @@
+# Variable Bindings
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../index.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/variable-bindings.html).
\ No newline at end of file
diff --git a/src/doc/book/first-edition/src/vectors.md b/src/doc/book/first-edition/src/vectors.md
new file mode 100644
index 000000000..14f83b7f7
--- /dev/null
+++ b/src/doc/book/first-edition/src/vectors.md
@@ -0,0 +1,10 @@
+# Vectors
+
+The first edition of the book is no longer distributed with Rust's documentation.
+
+If you came here via a link or web search, you may want to check out [the current
+version of the book](../ch08-01-vectors.html) instead.
+
+If you have an internet connection, you can [find a copy distributed with
+Rust
+1.30](https://doc.rust-lang.org/1.30.0/book/first-edition/vectors.html).