bootstrap: add an initial stdarch test step

Author: mnmn-f

library/stdarch/Cargo.toml

@@ -18,3 +18,11 @@ incremental = true
 debug = 1
 opt-level = 3
 incremental = true
+
+# The "dist" profile is used by bootstrap when building stdarch docs as part
+# of the distribution pipeline. Keep it aligned with the library workspace so
+# `cargo doc --profile=dist` works when stdarch is built as its own workspace.
+[profile.dist]
+inherits = "release"
+codegen-units = 1
+debug = 1

library/stdarch/crates/core_arch/src/core_arch_docs.md

@@ -199,23 +199,23 @@ others at:
 * [`loongarch64`]
 * [`s390x`]
 
-[`x86`]: ../../core/arch/x86/index.html
-[`x86_64`]: ../../core/arch/x86_64/index.html
-[`arm`]: ../../core/arch/arm/index.html
-[`aarch64`]: ../../core/arch/aarch64/index.html
-[`amdgpu`]: ../../core/arch/amdgpu/index.html
-[`hexagon`]: ../../core/arch/hexagon/index.html
-[`riscv32`]: ../../core/arch/riscv32/index.html
-[`riscv64`]: ../../core/arch/riscv64/index.html
-[`mips`]: ../../core/arch/mips/index.html
-[`mips64`]: ../../core/arch/mips64/index.html
-[`powerpc`]: ../../core/arch/powerpc/index.html
-[`powerpc64`]: ../../core/arch/powerpc64/index.html
-[`nvptx`]: ../../core/arch/nvptx/index.html
-[`wasm32`]: ../../core/arch/wasm32/index.html
-[`loongarch32`]: ../../core/arch/loongarch32/index.html
-[`loongarch64`]: ../../core/arch/loongarch64/index.html
-[`s390x`]: ../../core/arch/s390x/index.html
+[`x86`]: crate::arch::x86
+[`x86_64`]: crate::arch::x86_64
+[`arm`]: crate::arch::arm
+[`aarch64`]: crate::arch::aarch64
+[`amdgpu`]: crate::arch::amdgpu
+[`hexagon`]: crate::arch::hexagon
+[`riscv32`]: crate::arch::riscv32
+[`riscv64`]: crate::arch::riscv64
+[`mips`]: crate::arch::mips
+[`mips64`]: crate::arch::mips64
+[`powerpc`]: crate::arch::powerpc
+[`powerpc64`]: crate::arch::powerpc64
+[`nvptx`]: crate::arch::nvptx
+[`wasm32`]: crate::arch::wasm32
+[`loongarch32`]: crate::arch::loongarch32
+[`loongarch64`]: crate::arch::loongarch64
+[`s390x`]: crate::arch::s390x
 
 # Examples
 

library/stdarch/examples/gaussian.rs

@@ -19,20 +19,26 @@
 //!
 //! To build (requires Hexagon toolchain):
 //!
-//!     RUSTFLAGS="-C target-feature=+hvxv62,+hvx-length128b \
-//!         -C linker=hexagon-unknown-linux-musl-clang" \
-//!         cargo +nightly build -p stdarch_examples --bin gaussian \
-//!         --target hexagon-unknown-linux-musl \
-//!         -Zbuild-std -Zbuild-std-features=llvm-libunwind
+//! ```text
+//! RUSTFLAGS="-C target-feature=+hvxv62,+hvx-length128b \
+//!     -C linker=hexagon-unknown-linux-musl-clang" \
+//!     cargo +nightly build -p stdarch_examples --bin gaussian \
+//!     --target hexagon-unknown-linux-musl \
+//!     -Zbuild-std -Zbuild-std-features=llvm-libunwind
+//! ```
 //!
 //! To run under QEMU:
 //!
-//!     qemu-hexagon -L <sysroot>/target/hexagon-unknown-linux-musl \
-//!         target/hexagon-unknown-linux-musl/debug/gaussian
+//! ```text
+//! qemu-hexagon -L <sysroot>/target/hexagon-unknown-linux-musl \
+//!     target/hexagon-unknown-linux-musl/debug/gaussian
+//! ```
 //!
 //! # Building and Running (Other targets)
 //!
-//!     cargo +nightly run -p stdarch_examples --bin gaussian
+//! ```text
+//! cargo +nightly run -p stdarch_examples --bin gaussian
+//! ```
 
 #![cfg_attr(target_arch = "hexagon", feature(stdarch_hexagon))]
 #![cfg_attr(target_arch = "hexagon", feature(hexagon_target_feature))]