aboutsummaryrefslogtreecommitdiff
path: root/asm.rs
diff options
context:
space:
mode:
authorGravatar Jonas Schievink <jonasschievink@gmail.com> 2020-08-26 21:11:43 +0200
committerGravatar Jonas Schievink <jonasschievink@gmail.com> 2020-08-26 21:21:11 +0200
commitac0cb85ddf09fbb379f6844029a7a6bda9d9a0cf (patch)
treeb7a829295bdf40290d3725b0e4fa0450d1c4c1f8 /asm.rs
parent5e9347e53485f6c676dbd06b0ded7abdf05b264b (diff)
downloadcortex-m-ac0cb85ddf09fbb379f6844029a7a6bda9d9a0cf.tar.gz
cortex-m-ac0cb85ddf09fbb379f6844029a7a6bda9d9a0cf.tar.zst
cortex-m-ac0cb85ddf09fbb379f6844029a7a6bda9d9a0cf.zip
automate, automate
Diffstat (limited to 'asm.rs')
-rw-r--r--asm.rs13
1 files changed, 11 insertions, 2 deletions
diff --git a/asm.rs b/asm.rs
index 0bbf0c7..f5b0179 100644
--- a/asm.rs
+++ b/asm.rs
@@ -14,11 +14,20 @@
//! assembly.
//!
//! For developers and contributors to `cortex-m`, this setup means that they don't have to install
-//! any binutils, assembler, or C compiler to hack on the crate. All they need is a nightly rustc
-//! and run `cargo xtask assemble` to rebuild the archives from this file.
+//! any binutils, assembler, or C compiler to hack on the crate. All they need is to run `cargo
+//! xtask assemble` to rebuild the archives from this file.
//!
//! Cool, right?
//!
+//! # Rust version management
+//!
+//! Since inline assembly is still unstable, and we want to ensure that the created blobs are
+//! up-to-date in CI, we have to pin the nightly version we use for this. The nightly toolchain is
+//! stored in `asm-toolchain`.
+//!
+//! The `cargo xtask` automation will automatically install the `asm-toolchain` as well as all
+//! Cortex-M targets needed to generate the blobs.
+//!
//! [linker plugin LTO]: https://doc.rust-lang.org/stable/rustc/linker-plugin-lto.html
#![feature(asm)]