Auto merge of #7687 - giraffate:Update_the_layout_of_cargo_commands, …

…r=ehuss

Update the layout of `Cargo Commands` in doc

It seems better to improve the follwing two points.
- A subcategory like [`Build Commands`](https://doc.rust-lang.org/stable/cargo/commands/build-commands.html) does not contain any contents.
- [`Cargo Commands`](https://doc.rust-lang.org/stable/cargo/commands/index.html) actually just points to `cargo` command.

So, I fix categories like `Build Commands` to include links to each
commands. In addition, I add `cargo` command to `General Commands`.

I just changed the way it was arranged and nothing about the contents.
The following is an example.

before
<img width="1283" alt="スクリーンショット 2019-12-09 10 01 44" src="https://user-images.githubusercontent.com/17407489/70399888-f2c3df80-1a6a-11ea-813b-4bba47d3b659.png">

after
<img width="1415" alt="スクリーンショット 2019-12-09 10 06 43" src="https://user-images.githubusercontent.com/17407489/70400018-a4631080-1a6b-11ea-8bd4-ab15338ae508.png">

src/doc/src/SUMMARY.md

@@ -34,41 +34,42 @@
     * [Unstable Features](reference/unstable.md)
 
 * [Cargo Commands](commands/index.md)
+    * [General Commands](commands/general-commands.md)
+        * [cargo](commands/cargo.md)
+        * [cargo help](commands/cargo-help.md)
+        * [cargo version](commands/cargo-version.md)
     * [Build Commands](commands/build-commands.md)
-        * [bench](commands/cargo-bench.md)
-        * [build](commands/cargo-build.md)
-        * [check](commands/cargo-check.md)
-        * [clean](commands/cargo-clean.md)
-        * [doc](commands/cargo-doc.md)
-        * [fetch](commands/cargo-fetch.md)
-        * [fix](commands/cargo-fix.md)
-        * [run](commands/cargo-run.md)
-        * [rustc](commands/cargo-rustc.md)
-        * [rustdoc](commands/cargo-rustdoc.md)
-        * [test](commands/cargo-test.md)
+        * [cargo bench](commands/cargo-bench.md)
+        * [cargo build](commands/cargo-build.md)
+        * [cargo check](commands/cargo-check.md)
+        * [cargo clean](commands/cargo-clean.md)
+        * [cargo doc](commands/cargo-doc.md)
+        * [cargo fetch](commands/cargo-fetch.md)
+        * [cargo fix](commands/cargo-fix.md)
+        * [cargo run](commands/cargo-run.md)
+        * [cargo rustc](commands/cargo-rustc.md)
+        * [cargo rustdoc](commands/cargo-rustdoc.md)
+        * [cargo test](commands/cargo-test.md)
     * [Manifest Commands](commands/manifest-commands.md)
-        * [generate-lockfile](commands/cargo-generate-lockfile.md)
-        * [locate-project](commands/cargo-locate-project.md)
-        * [metadata](commands/cargo-metadata.md)
-        * [pkgid](commands/cargo-pkgid.md)
-        * [update](commands/cargo-update.md)
-        * [vendor](commands/cargo-vendor.md)
-        * [verify-project](commands/cargo-verify-project.md)
+        * [cargo generate-lockfile](commands/cargo-generate-lockfile.md)
+        * [cargo locate-project](commands/cargo-locate-project.md)
+        * [cargo metadata](commands/cargo-metadata.md)
+        * [cargo pkgid](commands/cargo-pkgid.md)
+        * [cargo update](commands/cargo-update.md)
+        * [cargo vendor](commands/cargo-vendor.md)
+        * [cargo verify-project](commands/cargo-verify-project.md)
     * [Package Commands](commands/package-commands.md)
-        * [init](commands/cargo-init.md)
-        * [install](commands/cargo-install.md)
-        * [new](commands/cargo-new.md)
-        * [search](commands/cargo-search.md)
-        * [uninstall](commands/cargo-uninstall.md)
+        * [cargo init](commands/cargo-init.md)
+        * [cargo install](commands/cargo-install.md)
+        * [cargo new](commands/cargo-new.md)
+        * [cargo search](commands/cargo-search.md)
+        * [cargo uninstall](commands/cargo-uninstall.md)
     * [Publishing Commands](commands/publishing-commands.md)
-        * [login](commands/cargo-login.md)
-        * [owner](commands/cargo-owner.md)
-        * [package](commands/cargo-package.md)
-        * [publish](commands/cargo-publish.md)
-        * [yank](commands/cargo-yank.md)
-    * [General Commands](commands/general-commands.md)
-        * [help](commands/cargo-help.md)
-        * [version](commands/cargo-version.md)
+        * [cargo login](commands/cargo-login.md)
+        * [cargo owner](commands/cargo-owner.md)
+        * [cargo package](commands/cargo-package.md)
+        * [cargo publish](commands/cargo-publish.md)
+        * [cargo yank](commands/cargo-yank.md)
 
 * [FAQ](faq.md)
 * [Appendix: Glossary](appendix/glossary.md)

src/doc/src/commands/build-commands.md

@@ -1 +1,12 @@
 # Build Commands
+* [cargo bench](cargo-bench.md)
+* [cargo build](cargo-build.md)
+* [cargo check](cargo-check.md)
+* [cargo clean](cargo-clean.md)
+* [cargo doc](cargo-doc.md)
+* [cargo fetch](cargo-fetch.md)
+* [cargo fix](cargo-fix.md)
+* [cargo run](cargo-run.md)
+* [cargo rustc](cargo-rustc.md)
+* [cargo rustdoc](cargo-rustdoc.md)
+* [cargo test](cargo-test.md)

src/doc/src/commands/cargo.md

@@ -0,0 +1,3 @@
+# cargo
+{{#include command-common.html}}
+{{#include ../../man/generated/cargo.html}}

src/doc/src/commands/general-commands.md

@@ -1 +1,4 @@
 # General Commands
+* [cargo](cargo.md)
+* [cargo help](cargo-help.md)
+* [cargo version](cargo-version.md)

src/doc/src/commands/index.md

@@ -1,3 +1,6 @@
-# cargo
-{{#include command-common.html}}
-{{#include ../../man/generated/cargo.html}}
+# Cargo Commands
+* [General Commands](general-commands.md)
+* [Build Commands](build-commands.md)
+* [Manifest Commands](manifest-commands.md)
+* [Package Commands](package-commands.md)
+* [Publishing Commands](publishing-commands.md)

src/doc/src/commands/manifest-commands.md

@@ -1 +1,8 @@
 # Manifest Commands
+* [cargo generate-lockfile](cargo-generate-lockfile.md)
+* [cargo locate-project](cargo-locate-project.md)
+* [cargo metadata](cargo-metadata.md)
+* [cargo pkgid](cargo-pkgid.md)
+* [cargo update](cargo-update.md)
+* [cargo vendor](cargo-vendor.md)
+* [cargo verify-project](cargo-verify-project.md)

src/doc/src/commands/package-commands.md

@@ -1 +1,6 @@
 # Package Commands
+* [cargo init](cargo-init.md)
+* [cargo install](cargo-install.md)
+* [cargo new](cargo-new.md)
+* [cargo search](cargo-search.md)
+* [cargo uninstall](cargo-uninstall.md)

src/doc/src/commands/publishing-commands.md

@@ -1 +1,6 @@
 # Publishing Commands
+* [cargo login](cargo-login.md)
+* [cargo owner](cargo-owner.md)
+* [cargo package](cargo-package.md)
+* [cargo publish](cargo-publish.md)
+* [cargo yank](cargo-yank.md)