From 5fde8ee7754cff40bc1133ab90497cd47b141b10 Mon Sep 17 00:00:00 2001 From: "Sergey \"Shnatsel\" Davidoff" Date: Sun, 20 Sep 2026 08:23:13 +0100 Subject: [PATCH 1/3] Reword the advice on the proc macro usage --- fearless_simd/README.md | 4 +--- fearless_simd/src/lib.rs | 4 +--- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/fearless_simd/README.md b/fearless_simd/README.md index 6ecce2bb..3ea0ea20 100644 --- a/fearless_simd/README.md +++ b/fearless_simd/README.md @@ -143,9 +143,7 @@ hardware-specific intrinsics only when necessary. ### The `#[simd]` annotation -Fearless SIMD requires functions that use SIMD to be annotated with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but run far slower, defeating the purpose of SIMD. - -Use [`dispatch!`] when calling SIMD code from non-SIMD code. +Fearless SIMD requires functions that use SIMD to be annotated with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but may run much slower. If you cannot use proc macros, [you can achieve the same effect manually](https://github.com/linebender/fearless_simd/blob/main/fearless_simd/MANUAL_INLINING.md), but it requires some care. The use of `#[simd]` is recommended as the more robust and ergonomic option. diff --git a/fearless_simd/src/lib.rs b/fearless_simd/src/lib.rs index f1250d6a..5a760a71 100644 --- a/fearless_simd/src/lib.rs +++ b/fearless_simd/src/lib.rs @@ -110,9 +110,7 @@ //! //! ## The `#[simd]` annotation //! -//! Fearless SIMD requires functions that use SIMD to be annotated with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but run far slower, defeating the purpose of SIMD. -//! -//! Use [`dispatch!`] when calling SIMD code from non-SIMD code. +//! Fearless SIMD requires functions that use SIMD to be annotated with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but may run much slower. //! //! If you cannot use proc macros, [you can achieve the same effect manually](https://github.com/linebender/fearless_simd/blob/main/fearless_simd/MANUAL_INLINING.md), but it requires some care. The use of `#[simd]` is recommended as the more robust and ergonomic option. //! From 4b8c7ababac3bc7127af79eb7775102366d01c3c Mon Sep 17 00:00:00 2001 From: Laurenz Stampfl Date: Mon, 21 Sep 2026 18:15:34 +0200 Subject: [PATCH 2/3] tweak readme --- fearless_simd/src/lib.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fearless_simd/src/lib.rs b/fearless_simd/src/lib.rs index 5a760a71..72194fe2 100644 --- a/fearless_simd/src/lib.rs +++ b/fearless_simd/src/lib.rs @@ -110,7 +110,7 @@ //! //! ## The `#[simd]` annotation //! -//! Fearless SIMD requires functions that use SIMD to be annotated with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but may run much slower. +//! It is recommended to annotate functions that use SIMD with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but requires special care to achieve full performance. //! //! If you cannot use proc macros, [you can achieve the same effect manually](https://github.com/linebender/fearless_simd/blob/main/fearless_simd/MANUAL_INLINING.md), but it requires some care. The use of `#[simd]` is recommended as the more robust and ergonomic option. //! From fde58a2e06b763766e90488ba5d5fba49ba65394 Mon Sep 17 00:00:00 2001 From: Laurenz Stampfl Date: Mon, 21 Sep 2026 18:16:11 +0200 Subject: [PATCH 3/3] update --- fearless_simd/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fearless_simd/README.md b/fearless_simd/README.md index 3ea0ea20..35f84d6e 100644 --- a/fearless_simd/README.md +++ b/fearless_simd/README.md @@ -143,7 +143,7 @@ hardware-specific intrinsics only when necessary. ### The `#[simd]` annotation -Fearless SIMD requires functions that use SIMD to be annotated with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but may run much slower. +It is recommended to annotate functions that use SIMD with the `#[simd]` attribute from the `fearless_simd_macros` crate. Without it the code will still compile, but requires special care to achieve full performance. If you cannot use proc macros, [you can achieve the same effect manually](https://github.com/linebender/fearless_simd/blob/main/fearless_simd/MANUAL_INLINING.md), but it requires some care. The use of `#[simd]` is recommended as the more robust and ergonomic option.