On Sat, Aug 10, 2024 at 11:44:13PM +0200, Alice Ryhl wrote: > On Sat, Aug 10, 2024 at 11:04 PM Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote: > > > > On Thu, Aug 08, 2024 at 05:23:41PM +0000, Alice Ryhl wrote: > > > > > +/// Wrapper around `asm!` that uses at&t syntax on x86. > > > +// Uses a semicolon to avoid parsing ambiguities, even though this does not match native `asm!` > > > +// syntax. > > > +#[cfg(target_arch = "x86_64")] > > > +#[macro_export] > > > +macro_rules! asm { > > > + ($($asm:expr),* ; $($rest:tt)*) => { > > > + ::core::arch::asm!( $($asm)*, options(att_syntax), $($rest)* ) > > > + }; > > > +} > > > + > > > +/// Wrapper around `asm!` that uses at&t syntax on x86. > > > > ^ the above line seems out of place given the 'not' below. > > Comments with three slashes are what gets rendered in the html version > of the docs [1]. This way, the rendered docs will say that the `asm!` > macro is a wrapper around the built-in `asm!` that uses at&t syntax on > x86 regardless of which platform you build the docs on. > Urgh, that's not half-way confusing. Also, whoever wants to read HTML when you already have the code open in your text-editor?