From 4247a30bdd73ee3f1c9fa58a4130380a2e47f6ad Mon Sep 17 00:00:00 2001 From: Huon Wilson Date: Fri, 9 Jan 2015 19:47:09 +1100 Subject: [PATCH] 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. --- mk/docs.mk | 6 ++++++ src/doc/guide-crates.md | 4 ++++ src/doc/guide-error-handling.md | 4 ++++ src/doc/guide-ffi.md | 4 ++++ src/doc/guide-macros.md | 4 ++++ src/doc/guide-ownership.md | 4 ++++ src/doc/guide-plugins.md | 4 ++++ src/doc/guide-pointers.md | 4 ++++ src/doc/guide-strings.md | 4 ++++ src/doc/guide-tasks.md | 4 ++++ src/doc/guide-testing.md | 4 ++++ src/doc/guide-unsafe.md | 4 ++++ src/doc/guide.md | 4 ++++ 13 files changed, 54 insertions(+) create mode 100644 src/doc/guide-crates.md create mode 100644 src/doc/guide-error-handling.md create mode 100644 src/doc/guide-ffi.md create mode 100644 src/doc/guide-macros.md create mode 100644 src/doc/guide-ownership.md create mode 100644 src/doc/guide-plugins.md create mode 100644 src/doc/guide-pointers.md create mode 100644 src/doc/guide-strings.md create mode 100644 src/doc/guide-tasks.md create mode 100644 src/doc/guide-testing.md create mode 100644 src/doc/guide-unsafe.md create mode 100644 src/doc/guide.md 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).