Reformat asciidoc man pages to markdown.

Author: ehuss

src/doc/man/cargo-bench.md

@@ -1,27 +1,25 @@
-= cargo-bench(1)
-:idprefix: cargo_bench_
-:doctype: manpage
-:actionverb: Benchmark
-:nouns: benchmarks
+# cargo-bench(1)
+{{*set actionverb="Benchmark"}}
+{{*set nouns="benchmarks"}}
 
-== NAME
+## NAME
 
 cargo-bench - Execute benchmarks of a package
 
-== SYNOPSIS
+## SYNOPSIS
 
-`cargo bench [_OPTIONS_] [BENCHNAME] [-- _BENCH-OPTIONS_]`
+`cargo bench` [_options_] [_benchname_] [`--` _bench-options_]
 
-== DESCRIPTION
+## DESCRIPTION
 
 Compile and execute benchmarks.
 
-The benchmark filtering argument `BENCHNAME` and all the arguments following
+The benchmark filtering argument _benchname_ and all the arguments following
 the two dashes (`--`) are passed to the benchmark binaries and thus to
-_libtest_ (rustc's built in unit-test and micro-benchmarking framework).  If
-you're passing arguments to both Cargo and the binary, the ones after `--` go
-to the binary, the ones before go to Cargo.  For details about libtest's
-arguments see the output of `cargo bench \-- --help`.  As an example, this will
+_libtest_ (rustc's built in unit-test and micro-benchmarking framework). If
+you are passing arguments to both Cargo and the binary, the ones after `--` go
+to the binary, the ones before go to Cargo. For details about libtest's
+arguments see the output of `cargo bench -- --help`.  As an example, this will
 run only the benchmark named `foo` (and skip other similarly named benchmarks
 like `foobar`):
 
@@ -36,27 +34,24 @@ The libtest harness may be disabled by setting `harness = false` in the target
 manifest settings, in which case your code will need to provide its own `main`
 function to handle running benchmarks.
 
-
 > **Note**: The
-> link:https://doc.rust-lang.org/nightly/unstable-book/library-features/test.html[`#[bench\]` attribute]
+> [`#[bench]` attribute](https://doc.rust-lang.org/nightly/unstable-book/library-features/test.html)
 > is currently unstable and only available on the
-> link:https://doc.rust-lang.org/book/appendix-07-nightly-rust.html[nightly channel].
+> [nightly channel](https://doc.rust-lang.org/book/appendix-07-nightly-rust.html).
 > There are some packages available on
-> link:https://crates.io/keywords/benchmark[crates.io] that may help with
+> [crates.io](https://crates.io/keywords/benchmark) that may help with
 > running benchmarks on the stable channel, such as
-> link:https://crates.io/crates/criterion[Criterion].
-
-== OPTIONS
+> [Criterion](https://crates.io/crates/criterion).
 
-=== Benchmark Options
+## OPTIONS
 
-include::options-test.adoc[]
+### Benchmark Options
 
-=== Package Selection
+{{> options-test }}
 
-include::options-packages.adoc[]
+{{> section-package-selection }}
 
-=== Target Selection
+### Target Selection
 
 When no target selection options are given, `cargo bench` will build the
 following targets of the selected packages:
@@ -75,53 +70,65 @@ them from being benchmarked by default. Target selection options that take a
 target by name ignore the `bench` flag and will always benchmark the given
 target.
 
-include::options-targets.adoc[]
+{{> options-targets }}
+
+{{> section-features }}
 
-include::options-features.adoc[]
+### Compilation Options
 
-=== Compilation Options
+{{#options}}
 
-include::options-target-triple.adoc[]
+{{> options-target-triple }}
 
-=== Output Options
+{{/options}}
 
-include::options-target-dir.adoc[]
+### Output Options
 
-=== Display Options
+{{#options}}
+{{> options-target-dir }}
+{{/options}}
+
+### Display Options
 
 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
 passing `--nocapture` to the benchmark binaries:
 
     cargo bench -- --nocapture
 
-include::options-display.adoc[]
+{{#options}}
+
+{{> options-display }}
 
-include::options-message-format.adoc[]
+{{> options-message-format }}
 
-=== Manifest Options
+{{/options}}
 
-include::options-manifest-path.adoc[]
+### Manifest Options
 
-include::options-locked.adoc[]
+{{#options}}
+{{> options-manifest-path }}
 
-=== Common Options
+{{> options-locked }}
+{{/options}}
 
-include::options-common.adoc[]
+{{> section-options-common }}
 
-=== Miscellaneous Options
+### Miscellaneous Options
 
 The `--jobs` argument affects the building of the benchmark executable but
 does not affect how many threads are used when running the benchmarks. The
 Rust test harness runs benchmarks serially in a single thread.
 
-include::options-jobs.adoc[]
+{{#options}}
+{{> options-jobs }}
+{{/options}}
 
-== PROFILES
+## PROFILES
 
 Profiles may be used to configure compiler options such as optimization levels
 and debug settings. See
-linkcargo:reference/profiles.html[the reference]
+[the reference](../reference/profiles.html)
 for more details.
 
 Benchmarks are always built with the `bench` profile. Binary and lib targets
@@ -130,23 +137,23 @@ are built with the `release` profiles when linked to binaries and benchmarks.
 Dependencies use the `release` profile.
 
 If you need a debug build of a benchmark, try building it with
-man:cargo-build[1] which will use the `test` profile which is by default
+{{man "cargo-build" 1}} which will use the `test` profile which is by default
 unoptimized and includes debug information. You can then run the debug-enabled
 benchmark manually.
 
-include::section-environment.adoc[]
+{{> section-environment }}
 
-include::section-exit-status.adoc[]
+{{> section-exit-status }}
 
-== EXAMPLES
+## EXAMPLES
 
-. Build and execute all the benchmarks of the current package:
+1. Build and execute all the benchmarks of the current package:
 
-    cargo bench
+       cargo bench
 
-. Run only a specific benchmark within a specific benchmark target:
+2. Run only a specific benchmark within a specific benchmark target:
 
-    cargo bench --bench bench_name -- modname::some_benchmark
+       cargo bench --bench bench_name -- modname::some_benchmark
 
-== SEE ALSO
-man:cargo[1], man:cargo-test[1]
+## SEE ALSO
+{{man "cargo" 1}}, {{man "cargo-test" 1}}

src/doc/man/cargo-build.md

@@ -1,98 +1,107 @@
-= cargo-build(1)
-:idprefix: cargo_build_
-:doctype: manpage
-:actionverb: Build
+# cargo-build(1)
+{{*set actionverb="Build"}}
 
-== NAME
+## NAME
 
 cargo-build - Compile the current package
 
-== SYNOPSIS
+## SYNOPSIS
 
-`cargo build [_OPTIONS_]`
+`cargo build` [_options_]
 
-== DESCRIPTION
+## DESCRIPTION
 
 Compile local packages and all of their dependencies.
 
-== OPTIONS
+## OPTIONS
 
-=== Package Selection
+{{> section-package-selection }}
 
-include::options-packages.adoc[]
-
-=== Target Selection
+### Target Selection
 
 When no target selection options are given, `cargo build` will build all
 binary and library targets of the selected packages. Binaries are skipped if
 they have `required-features` that are missing.
 
-include::options-targets.adoc[]
+{{> options-targets }}
+
+{{> section-features }}
+
+### Compilation Options
+
+{{#options}}
 
-include::options-features.adoc[]
+{{> options-target-triple }}
 
-=== Compilation Options
+{{> options-release }}
 
-include::options-target-triple.adoc[]
+{{/options}}
 
-include::options-release.adoc[]
+### Output Options
 
-=== Output Options
+{{#options}}
+{{> options-target-dir }}
 
-include::options-target-dir.adoc[]
+{{#option "`--out-dir` _directory_" }}
+Copy final artifacts to this directory.
 
-*--out-dir* _DIRECTORY_::
-    Copy final artifacts to this directory.
-+
 This option is unstable and available only on the
-link:https://doc.rust-lang.org/book/appendix-07-nightly-rust.html[nightly channel]
+[nightly channel](https://doc.rust-lang.org/book/appendix-07-nightly-rust.html)
 and requires the `-Z unstable-options` flag to enable.
 See https://github.com/rust-lang/cargo/issues/6790 for more information.
+{{/option}}
 
-=== Display Options
+{{/options}}
 
-include::options-display.adoc[]
+### Display Options
 
-include::options-message-format.adoc[]
+{{#options}}
+{{> options-display }}
+
+{{> options-message-format }}
+
+{{#option "`--build-plan`" }}
+Outputs a series of JSON messages to stdout that indicate the commands to run
+the build.
 
-*--build-plan*::
-    Outputs a series of JSON messages to stdout that indicate the commands to
-    run the build.
-+
 This option is unstable and available only on the
-link:https://doc.rust-lang.org/book/appendix-07-nightly-rust.html[nightly channel]
+[nightly channel](https://doc.rust-lang.org/book/appendix-07-nightly-rust.html)
 and requires the `-Z unstable-options` flag to enable.
-See https://github.com/rust-lang/cargo/issues/5579 for more information.
-
-=== Manifest Options
+See <https://github.com/rust-lang/cargo/issues/5579> for more information.
+{{/option}}
+{{/options}}
 
-include::options-manifest-path.adoc[]
+### Manifest Options
 
-include::options-locked.adoc[]
+{{#options}}
+{{> options-manifest-path }}
 
-=== Common Options
+{{> options-locked }}
+{{/options}}
 
-include::options-common.adoc[]
+{{> section-options-common }}
 
-=== Miscellaneous Options
+### Miscellaneous Options
 
-include::options-jobs.adoc[]
+{{#options}}
+{{> options-jobs }}
+{{/options}}
 
-include::section-profiles.adoc[]
+{{> section-profiles }}
 
-include::section-environment.adoc[]
+{{> section-environment }}
 
-include::section-exit-status.adoc[]
+{{> section-exit-status }}
 
-== EXAMPLES
+## EXAMPLES
 
-. Build the local package and all of its dependencies:
+1. Build the local package and all of its dependencies:
 
-    cargo build
+       cargo build
 
-. Build with optimizations:
+2. Build with optimizations:
 
-    cargo build --release
+       cargo build --release
 
-== SEE ALSO
-man:cargo[1], man:cargo-rustc[1]
+## SEE ALSO
+{{man "cargo" 1}}, {{man "cargo-rustc" 1}}