Add stub deprecation files for each of the old guides.

There are hundreds of stackoverflow answers, reddit posts and blog
articles that link to these documents, so it's a nicer user experience
if they're not plain 404s.

The intention is to let these hang around only for relatively short
while. The alpha is likely to bring in many new users and they will be
reading the documents mentioned above.

13 files changed, 54 insertions, 0 deletions

diff --git a/mk/docs.mk b/mk/docs.mk
index 1104c3eb6db..3f8b677185f 100644
--- a/mk/docs.mk
+++ b/mk/docs.mk
@@ -29,6 +29,12 @@ DOCS := index intro tutorial complement-bugreport \
     complement-lang-faq complement-design-faq complement-project-faq \
     rustdoc reference
 
+# Legacy guides, preserved for a while to reduce the number of 404s
+DOCS += guide-crates guide-error-handling guide-ffi guide-macros guide \
+    guide-ownership guide-plugins guide-pointers guide-strings guide-tasks \
+    guide-testing
+
+
 PDF_DOCS := reference
 
 RUSTDOC_DEPS_reference := doc/full-toc.inc
diff --git a/src/doc/guide-crates.md b/src/doc/guide-crates.md
new file mode 100644
index 00000000000..8277988b7fe
--- /dev/null
+++ b/src/doc/guide-crates.md
@@ -0,0 +1,4 @@
+% The (old) Rust Crates and Modules Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/crates-and-modules.html).
diff --git a/src/doc/guide-error-handling.md b/src/doc/guide-error-handling.md
new file mode 100644
index 00000000000..215fe6a441e
--- /dev/null
+++ b/src/doc/guide-error-handling.md
@@ -0,0 +1,4 @@
+% Error Handling in Rust
+
+This content has moved into the
+[the Rust Programming Language book](book/error-handling.html).
diff --git a/src/doc/guide-ffi.md b/src/doc/guide-ffi.md
new file mode 100644
index 00000000000..4c818cacbfa
--- /dev/null
+++ b/src/doc/guide-ffi.md
@@ -0,0 +1,4 @@
+% The (old) Rust Foreign Function Interface Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/ffi.html).
diff --git a/src/doc/guide-macros.md b/src/doc/guide-macros.md
new file mode 100644
index 00000000000..534ae3504c3
--- /dev/null
+++ b/src/doc/guide-macros.md
@@ -0,0 +1,4 @@
+% The (old) Rust Macros Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/macros.html).
diff --git a/src/doc/guide-ownership.md b/src/doc/guide-ownership.md
new file mode 100644
index 00000000000..26e059aeb26
--- /dev/null
+++ b/src/doc/guide-ownership.md
@@ -0,0 +1,4 @@
+% The (old) Rust Ownership Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/ownership.html).
diff --git a/src/doc/guide-plugins.md b/src/doc/guide-plugins.md
new file mode 100644
index 00000000000..abfe7a44703
--- /dev/null
+++ b/src/doc/guide-plugins.md
@@ -0,0 +1,4 @@
+% The (old) Rust Compiler Plugins Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/plugins.html).
diff --git a/src/doc/guide-pointers.md b/src/doc/guide-pointers.md
new file mode 100644
index 00000000000..e72eaf62720
--- /dev/null
+++ b/src/doc/guide-pointers.md
@@ -0,0 +1,4 @@
+% The (old) Rust Pointer Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/pointers.html).
diff --git a/src/doc/guide-strings.md b/src/doc/guide-strings.md
new file mode 100644
index 00000000000..fd1420024c6
--- /dev/null
+++ b/src/doc/guide-strings.md
@@ -0,0 +1,4 @@
+% The (old) Guide to Rust Strings
+
+This content has moved into the
+[the Rust Programming Language book](book/strings.html).
diff --git a/src/doc/guide-tasks.md b/src/doc/guide-tasks.md
new file mode 100644
index 00000000000..be8cb670986
--- /dev/null
+++ b/src/doc/guide-tasks.md
@@ -0,0 +1,4 @@
+% The (old) Rust Threads and Communication Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/tasks.html).
diff --git a/src/doc/guide-testing.md b/src/doc/guide-testing.md
new file mode 100644
index 00000000000..79721300d94
--- /dev/null
+++ b/src/doc/guide-testing.md
@@ -0,0 +1,4 @@
+% The (old) Rust Testing Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/testing.html).
diff --git a/src/doc/guide-unsafe.md b/src/doc/guide-unsafe.md
new file mode 100644
index 00000000000..fe8fcc4c19d
--- /dev/null
+++ b/src/doc/guide-unsafe.md
@@ -0,0 +1,4 @@
+% Writing Safe Low-level and Unsafe Code in Rust
+
+This content has moved into the
+[the Rust Programming Language book](book/unsafe.html).
diff --git a/src/doc/guide.md b/src/doc/guide.md
new file mode 100644
index 00000000000..ba1e2590e7f
--- /dev/null
+++ b/src/doc/guide.md
@@ -0,0 +1,4 @@
+% The (old) Rust Guide
+
+This content has moved into the
+[the Rust Programming Language book](book/README.html).