Auto merge of #6459 - ehuss:fix-man-checks, r=alexcrichton

Fix new man page links.

The rustc link checker found some problems:
- The raw generated HTML files were being included when they shouldn't.
  Fixed by moving them out of the mdbook directory.
- The `print.html` file concatenates all the pages together, causing duplicate
  `id`'s.  Fix by giving each page a unique set of IDs.

src/doc/Makefile

@@ -4,14 +4,14 @@
 # format. See https://asciidoctor.org/ for more information.
 #
 # Just run `make` and it will generate the man pages in src/etc/man and the
-# HTML pages in src/doc/src/commands/generated.
+# HTML pages in src/doc/man/generated.
 #
 # There are some Asciidoctor extensions, see the file `asciidoc-extensions.rb`
 # for the documentation.
 
 MAN_SOURCE = $(sort $(wildcard man/cargo*.adoc))
 COMMANDS = $(notdir $(MAN_SOURCE))
-HTML = $(patsubst %.adoc,src/commands/generated/%.html,$(COMMANDS))
+HTML = $(patsubst %.adoc,man/generated/%.html,$(COMMANDS))
 MAN_LOCATION = ../etc/man
 MAN = $(patsubst %.adoc,$(MAN_LOCATION)/%.1,$(COMMANDS))
 ASCIIDOCOPTS = -r ./asciidoc-extension.rb
@@ -21,7 +21,7 @@ all: commands-html man
 commands-html: $(HTML)
 man: $(MAN)
 
-$(HTML): src/commands/generated/%.html : man/%.adoc asciidoc-extension.rb $(OTHER_DEPS)
+$(HTML): man/generated/%.html : man/%.adoc asciidoc-extension.rb $(OTHER_DEPS)
  asciidoctor $(ASCIIDOCOPTS) -s $< -o $@
 
 $(MAN): $(MAN_LOCATION)/%.1 : man/%.adoc $(OTHER_DEPS)

src/doc/man/cargo-bench.adoc

@@ -1,4 +1,5 @@
 = cargo-bench(1)
+:idprefix: cargo_bench_
 :doctype: manpage
 :actionverb: Benchmark
 :nouns: benchmarks

src/doc/man/cargo-build.adoc

@@ -1,4 +1,5 @@
 = cargo-build(1)
+:idprefix: cargo_build_
 :doctype: manpage
 :actionverb: Build
 

src/doc/man/cargo-check.adoc

@@ -1,4 +1,5 @@
 = cargo-check(1)
+:idprefix: cargo_check_
 :doctype: manpage
 :actionverb: Check
 

src/doc/man/cargo-clean.adoc

@@ -1,4 +1,5 @@
 = cargo-clean(1)
+:idprefix: cargo_clean_
 :doctype: manpage
 :actionverb: Clean
 

src/doc/man/cargo-doc.adoc

@@ -1,4 +1,5 @@
 = cargo-doc(1)
+:idprefix: cargo_doc_
 :doctype: manpage
 :actionverb: Document
 

src/doc/man/cargo-fetch.adoc

@@ -1,4 +1,5 @@
 = cargo-fetch(1)
+:idprefix: cargo_fetch_
 :doctype: manpage
 :actionverb: Fetch
 

src/doc/man/cargo-fix.adoc

@@ -1,4 +1,5 @@
 = cargo-fix(1)
+:idprefix: cargo_fix_
 :doctype: manpage
 :actionverb: Fix
 

src/doc/man/cargo-generate-lockfile.adoc

@@ -1,4 +1,5 @@
 = cargo-generate-lockfile(1)
+:idprefix: cargo_generate-lockfile_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-help.adoc

@@ -1,4 +1,5 @@
 = cargo-help(1)
+:idprefix: cargo_help_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-init.adoc

@@ -1,4 +1,5 @@
 = cargo-init(1)
+:idprefix: cargo_init_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-install.adoc

@@ -1,4 +1,5 @@
 = cargo-install(1)
+:idprefix: cargo_install_
 :doctype: manpage
 :actionverb: Install
 

src/doc/man/cargo-locate-project.adoc

@@ -1,4 +1,5 @@
 = cargo-locate-project(1)
+:idprefix: cargo_locate-project_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-login.adoc

@@ -1,4 +1,5 @@
 = cargo-login(1)
+:idprefix: cargo_login_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-metadata.adoc

@@ -1,4 +1,5 @@
 = cargo-metadata(1)
+:idprefix: cargo_metadata_
 :doctype: manpage
 :source-highlighter: highlightjs
 

src/doc/man/cargo-new.adoc

@@ -1,4 +1,5 @@
 = cargo-new(1)
+:idprefix: cargo_new_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-owner.adoc

@@ -1,4 +1,5 @@
 = cargo-owner(1)
+:idprefix: cargo_owner_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-package.adoc

@@ -1,4 +1,5 @@
 = cargo-package(1)
+:idprefix: cargo_package_
 :doctype: manpage
 :actionverb: Package
 

src/doc/man/cargo-pkgid.adoc

@@ -1,4 +1,5 @@
 = cargo-pkgid(1)
+:idprefix: cargo_pkgid_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-publish.adoc

@@ -1,4 +1,5 @@
 = cargo-publish(1)
+:idprefix: cargo_publish_
 :doctype: manpage
 :actionverb: Publish
 

src/doc/man/cargo-run.adoc

@@ -1,4 +1,5 @@
 = cargo-run(1)
+:idprefix: cargo_run_
 :doctype: manpage
 :actionverb: Run
 

src/doc/man/cargo-rustc.adoc

@@ -1,4 +1,5 @@
 = cargo-rustc(1)
+:idprefix: cargo_rustc_
 :doctype: manpage
 :actionverb: Build
 

src/doc/man/cargo-rustdoc.adoc

@@ -1,4 +1,5 @@
 = cargo-rustdoc(1)
+:idprefix: cargo_rustdoc_
 :doctype: manpage
 :actionverb: Document
 

src/doc/man/cargo-search.adoc

@@ -1,4 +1,5 @@
 = cargo-search(1)
+:idprefix: cargo_search_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-test.adoc

@@ -1,4 +1,5 @@
 = cargo-test(1)
+:idprefix: cargo_test_
 :doctype: manpage
 :actionverb: Test
 :nouns: tests

src/doc/man/cargo-uninstall.adoc

@@ -1,4 +1,5 @@
 = cargo-uninstall(1)
+:idprefix: cargo_uninstall_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-update.adoc

@@ -1,4 +1,5 @@
 = cargo-update(1)
+:idprefix: cargo_update_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-verify-project.adoc

@@ -1,4 +1,5 @@
 = cargo-verify-project(1)
+:idprefix: cargo_verify-project_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-version.adoc

@@ -1,4 +1,5 @@
 = cargo-version(1)
+:idprefix: cargo_version_
 :doctype: manpage
 
 == NAME

src/doc/man/cargo-yank.adoc

@@ -1,4 +1,5 @@
 = cargo-yank(1)
+:idprefix: cargo_yank_
 :doctype: manpage
 
 == NAME

src/doc/src/commands/generated/cargo-bench.html → src/doc/man/generated/cargo-bench.html

@@ -1,17 +1,17 @@
-<h2 id="_name">NAME</h2>
+<h2 id="cargo_bench_name">NAME</h2>
 <div class="sectionbody">
 <p>cargo-bench - Execute benchmarks of a package</p>
 </div>
 <div class="sect1">
-<h2 id="_synopsis">SYNOPSIS</h2>
+<h2 id="cargo_bench_synopsis">SYNOPSIS</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p><code>cargo bench [<em>OPTIONS</em>] [BENCHNAME] [-- <em>BENCH-OPTIONS</em>]</code></p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_description">DESCRIPTION</h2>
+<h2 id="cargo_bench_description">DESCRIPTION</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Compile and execute benchmarks.</p>
@@ -42,10 +42,10 @@ <h2 id="_description">DESCRIPTION</h2>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_options">OPTIONS</h2>
+<h2 id="cargo_bench_options">OPTIONS</h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="_benchmark_options">Benchmark Options</h3>
+<h3 id="cargo_bench_benchmark_options">Benchmark Options</h3>
 <div class="dlist">
 <dl>
 <dt class="hdlist1"><strong>--no-run</strong></dt>
@@ -63,7 +63,7 @@ <h3 id="_benchmark_options">Benchmark Options</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_package_selection">Package Selection</h3>
+<h3 id="cargo_bench_package_selection">Package Selection</h3>
 <div class="paragraph">
 <p>By default, when no package selection options are given, the packages selected
 depend on the current working directory. In the root of a virtual workspace,
@@ -93,7 +93,7 @@ <h3 id="_package_selection">Package Selection</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_target_selection">Target Selection</h3>
+<h3 id="cargo_bench_target_selection">Target Selection</h3>
 <div class="paragraph">
 <p>When no target selection options are given, <code>cargo bench</code> will build the
 following targets of the selected packages:</p>
@@ -184,7 +184,7 @@ <h3 id="_target_selection">Target Selection</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_feature_selection">Feature Selection</h3>
+<h3 id="cargo_bench_feature_selection">Feature Selection</h3>
 <div class="paragraph">
 <p>When no feature options are given, the <code>default</code> feature is activated for
 every selected package.</p>
@@ -210,7 +210,7 @@ <h3 id="_feature_selection">Feature Selection</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_compilation_options">Compilation Options</h3>
+<h3 id="cargo_bench_compilation_options">Compilation Options</h3>
 <div class="dlist">
 <dl>
 <dt class="hdlist1"><strong>--target</strong> <em>TRIPLE</em></dt>
@@ -258,7 +258,7 @@ <h3 id="_compilation_options">Compilation Options</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_output_options">Output Options</h3>
+<h3 id="cargo_bench_output_options">Output Options</h3>
 <div class="dlist">
 <dl>
 <dt class="hdlist1"><strong>--target-dir</strong> <em>DIRECTORY</em></dt>
@@ -272,7 +272,7 @@ <h3 id="_output_options">Output Options</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_display_options">Display Options</h3>
+<h3 id="cargo_bench_display_options">Display Options</h3>
 <div class="paragraph">
 <p>By default the Rust test harness hides output from benchmark execution to keep
 results readable. Benchmark output can be recovered (e.g. for debugging) by
@@ -341,7 +341,7 @@ <h3 id="_display_options">Display Options</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_manifest_options">Manifest Options</h3>
+<h3 id="cargo_bench_manifest_options">Manifest Options</h3>
 <div class="dlist">
 <dl>
 <dt class="hdlist1"><strong>--manifest-path</strong> <em>PATH</em></dt>
@@ -366,7 +366,7 @@ <h3 id="_manifest_options">Manifest Options</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_common_options">Common Options</h3>
+<h3 id="cargo_bench_common_options">Common Options</h3>
 <div class="dlist">
 <dl>
 <dt class="hdlist1"><strong>-h</strong></dt>
@@ -383,7 +383,7 @@ <h3 id="_common_options">Common Options</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_miscellaneous_options">Miscellaneous Options</h3>
+<h3 id="cargo_bench_miscellaneous_options">Miscellaneous Options</h3>
 <div class="paragraph">
 <p>The <code>--jobs</code> argument affects the building of the benchmark executable but
 does not affect how many threads are used when running the benchmarks. The
@@ -404,7 +404,7 @@ <h3 id="_miscellaneous_options">Miscellaneous Options</h3>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_profiles">PROFILES</h2>
+<h2 id="cargo_bench_profiles">PROFILES</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Profiles may be used to configure compiler options such as optimization levels
@@ -427,7 +427,7 @@ <h2 id="_profiles">PROFILES</h2>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_environment">ENVIRONMENT</h2>
+<h2 id="cargo_bench_environment">ENVIRONMENT</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>See <a href="reference/environment-variables.html">the reference</a> for
@@ -436,7 +436,7 @@ <h2 id="_environment">ENVIRONMENT</h2>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_exit_status">Exit Status</h2>
+<h2 id="cargo_bench_exit_status">Exit Status</h2>
 <div class="sectionbody">
 <div class="dlist">
 <dl>
@@ -453,7 +453,7 @@ <h2 id="_exit_status">Exit Status</h2>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_examples">EXAMPLES</h2>
+<h2 id="cargo_bench_examples">EXAMPLES</h2>
 <div class="sectionbody">
 <div class="olist arabic">
 <ol class="arabic">
@@ -478,7 +478,7 @@ <h2 id="_examples">EXAMPLES</h2>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_see_also">SEE ALSO</h2>
+<h2 id="cargo_bench_see_also">SEE ALSO</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p><a href="commands/index.html">cargo(1)</a>, <a href="commands/cargo-test.html">cargo-test(1)</a></p>