From e51146a98cc7c83ea574d13b4b5d8e7ceeeb004b Mon Sep 17 00:00:00 2001 From: datdenkikniet Date: Sun, 23 Apr 2023 13:22:35 +0200 Subject: Move tips into their own subdir --- book/en/src/by-example/tips_view_code.md | 47 -------------------------------- 1 file changed, 47 deletions(-) delete mode 100644 book/en/src/by-example/tips_view_code.md (limited to 'book/en/src/by-example/tips_view_code.md') diff --git a/book/en/src/by-example/tips_view_code.md b/book/en/src/by-example/tips_view_code.md deleted file mode 100644 index b4a9066..0000000 --- a/book/en/src/by-example/tips_view_code.md +++ /dev/null @@ -1,47 +0,0 @@ -# Inspecting generated code - -`#[rtic::app]` is a procedural macro that produces support code. If for some reason you need to inspect the code generated by this macro you have two options: - -You can inspect the file `rtic-expansion.rs` inside the `target` directory. This file contains the expansion of the `#[rtic::app]` item (not your whole program!) of the *last built* (via `cargo build` or `cargo check`) RTIC application. The expanded code is not pretty printed by default, so you'll want to run `rustfmt` on it before you read it. - -``` console -$ cargo build --example smallest --target thumbv7m-none-eabi -``` - -``` console -$ rustfmt target/rtic-expansion.rs -``` - -``` console -$ tail target/rtic-expansion.rs -``` - -``` rust -#[doc = r" Implementation details"] -mod app { - #[doc = r" Always include the device crate which contains the vector table"] - use lm3s6965 as _; - #[no_mangle] - unsafe extern "C" fn main() -> ! { - rtic::export::interrupt::disable(); - let mut core: rtic::export::Peripherals = core::mem::transmute(()); - core.SCB.scr.modify(|r| r | 1 << 1); - rtic::export::interrupt::enable(); - loop { - rtic::export::wfi() - } - } -} -``` - -Or, you can use the [`cargo-expand`] sub-command. This sub-command will expand *all* the macros, including the `#[rtic::app]` attribute, and modules in your crate and print the output to the console. - -[`cargo-expand`]: https://crates.io/crates/cargo-expand - -``` console -# produces the same output as before -``` - -``` console -cargo expand --example smallest | tail -``` -- cgit v1.2.3