On Sat, Aug 10, 2024 at 11:44:13PM +0200, Alice Ryhl wrote:
On Sat, Aug 10, 2024 at 11:04 PM Peter Zijlstra [off-list ref] wrote:
quoted
On Thu, Aug 08, 2024 at 05:23:41PM +0000, Alice Ryhl wrote:
quoted
+/// 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?