Auto merge of #10398 - piggynl:cargo-doc-fixes-1, r=weihanglo

Fix errors in `cargo fetch` usage guide

This is a recreation of #9785.

1. By [the doc](https://doc.rust-lang.org/cargo/commands/cargo-build.html#manifest-options), `cargo build` will always access the network unless `--frozen` or `--offline` is present. Instead, `cargo fetch` will fetch dependencies, and which will allow running subsequent Cargo commands in offline mode.

2. A general template was used for `--target` that is not appropriate for `cargo fetch`.

Author: bors

src/doc/man/cargo-fetch.md

@@ -1,5 +1,6 @@
 # cargo-fetch(1)
 {{*set actionverb="Fetch"}}
+{{*set target-default-to-all-arch=true}}
 
 ## NAME
 
@@ -13,7 +14,7 @@ cargo-fetch - Fetch dependencies of a package from the network
 
 If a `Cargo.lock` file is available, this command will ensure that all of the
 git dependencies and/or registry dependencies are downloaded and locally
-available. Subsequent Cargo commands never touch the network after a `cargo
+available. Subsequent Cargo commands will be able to run offline after a `cargo
 fetch` unless the lock file changes.
 
 If the lock file is not available, then this command will generate the lock

src/doc/man/generated_txt/cargo-fetch.txt

@@ -9,7 +9,7 @@ SYNOPSIS
 DESCRIPTION
        If a Cargo.lock file is available, this command will ensure that all of
        the git dependencies and/or registry dependencies are downloaded and
-       locally available. Subsequent Cargo commands never touch the network
+       locally available. Subsequent Cargo commands will be able to run offline
        after a cargo fetch unless the lock file changes.
 
        If the lock file is not available, then this command will generate the
@@ -25,8 +25,8 @@ DESCRIPTION
 OPTIONS
    Fetch options
        --target triple
-           Fetch for the given architecture. The default is the host
-           architecture. The general format of the triple is
+           Fetch for the given architecture. The default is all architectures.
+           The general format of the triple is
            <arch><sub>-<vendor>-<sys>-<abi>. Run rustc --print target-list for
            a list of supported targets.
 

src/doc/man/includes/options-target-triple.md

@@ -1,6 +1,8 @@
 {{#option "`--target` _triple_"}}
-{{actionverb}} for the given architecture. The default is the host
-architecture. The general format of the triple is
+{{actionverb}} for the given architecture.
+{{~#if target-default-to-all-arch}} The default is all architectures.
+{{~else}} The default is the host architecture.
+{{~/if}} The general format of the triple is
 `<arch><sub>-<vendor>-<sys>-<abi>`. Run `rustc --print target-list` for a
 list of supported targets.
 

src/doc/src/commands/cargo-bench.md

@@ -241,8 +241,7 @@ be specified multiple times, which enables all specified features.</dd>
 <dl>
 
 <dt class="option-term" id="option-cargo-bench---target"><a class="option-anchor" href="#option-cargo-bench---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Benchmark for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Benchmark for the given architecture. The default is the host architecture. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>

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

@@ -169,8 +169,7 @@ be specified multiple times, which enables all specified features.</dd>
 <dl>
 
 <dt class="option-term" id="option-cargo-build---target"><a class="option-anchor" href="#option-cargo-build---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Build for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Build for the given architecture. The default is the host architecture. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>

src/doc/src/commands/cargo-check.md

@@ -174,8 +174,7 @@ be specified multiple times, which enables all specified features.</dd>
 <dl>
 
 <dt class="option-term" id="option-cargo-check---target"><a class="option-anchor" href="#option-cargo-check---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Check for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Check for the given architecture. The default is the host architecture. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>

src/doc/src/commands/cargo-clean.md

@@ -57,8 +57,7 @@ Defaults to <code>target</code> in the root of the workspace.</dd>
 
 
 <dt class="option-term" id="option-cargo-clean---target"><a class="option-anchor" href="#option-cargo-clean---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Clean for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Clean for the given architecture. The default is the host architecture. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>

src/doc/src/commands/cargo-doc.md

@@ -152,8 +152,7 @@ be specified multiple times, which enables all specified features.</dd>
 <dl>
 
 <dt class="option-term" id="option-cargo-doc---target"><a class="option-anchor" href="#option-cargo-doc---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Document for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Document for the given architecture. The default is the host architecture. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>

src/doc/src/commands/cargo-fetch.md

@@ -1,6 +1,7 @@
 # cargo-fetch(1)
 
 
+
 ## NAME
 
 cargo-fetch - Fetch dependencies of a package from the network
@@ -13,7 +14,7 @@ cargo-fetch - Fetch dependencies of a package from the network
 
 If a `Cargo.lock` file is available, this command will ensure that all of the
 git dependencies and/or registry dependencies are downloaded and locally
-available. Subsequent Cargo commands never touch the network after a `cargo
+available. Subsequent Cargo commands will be able to run offline after a `cargo
 fetch` unless the lock file changes.
 
 If the lock file is not available, then this command will generate the lock
@@ -31,8 +32,7 @@ you plan to use Cargo without a network with the `--offline` flag.
 
 <dl>
 <dt class="option-term" id="option-cargo-fetch---target"><a class="option-anchor" href="#option-cargo-fetch---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Fetch for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Fetch for the given architecture. The default is all architectures. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>

src/doc/src/commands/cargo-fix.md

@@ -254,8 +254,7 @@ be specified multiple times, which enables all specified features.</dd>
 <dl>
 
 <dt class="option-term" id="option-cargo-fix---target"><a class="option-anchor" href="#option-cargo-fix---target"></a><code>--target</code> <em>triple</em></dt>
-<dd class="option-desc">Fix for the given architecture. The default is the host
-architecture. The general format of the triple is
+<dd class="option-desc">Fix for the given architecture. The default is the host architecture. The general format of the triple is
 <code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
 list of supported targets.</p>
 <p>This may also be specified with the <code>build.target</code>