docs: a page for deprecated and removed commands

Author: weihanglo

src/doc/book.toml

@@ -10,3 +10,6 @@ search.use-boolean-and = true
 
 [output.html.redirect]
 "/guide/build-cache.html" = "../reference/build-cache.html"
+"/commands/cargo-git-checkout.html" = "./deprecated-and-removed.html"
+"/commands/cargo-read-manifest.html" = "./deprecated-and-removed.html"
+"/commands/cargo-verify-project.html" = "./deprecated-and-removed.html"

src/doc/src/SUMMARY.md

@@ -94,6 +94,7 @@
         * [cargo package](commands/cargo-package.md)
         * [cargo publish](commands/cargo-publish.md)
         * [cargo yank](commands/cargo-yank.md)
+    * [Deprecated and Removed](commands/deprecated-and-removed.md)
 
 * [FAQ](faq.md)
 * [Appendix: Glossary](appendix/glossary.md)

src/doc/src/commands/deprecated-and-removed.md

@@ -0,0 +1,10 @@
+## Deprecated and Removed Commands
+
+These commands have been deprecated or removed in early Rust releases.
+Deprecated commands receive only critical bug fixes,
+and may be removed in future versions.
+Removed commands are no longer functional and are unsupported.
+
+* `read-manifest` --- deprecated since Rust 1.13
+* `git-checkout` --- removed since Rust 1.44
+* `verify-project` --- deprecated since Rust 1.84

src/doc/src/commands/index.md

@@ -4,3 +4,4 @@
 * [Manifest Commands](manifest-commands.md)
 * [Package Commands](package-commands.md)
 * [Publishing Commands](publishing-commands.md)
+* [Deprecated and Removed](deprecated-and-removed.md)