From 5aa2f9a208162389a743c45cebb72a994effca1c Mon Sep 17 00:00:00 2001 From: Alex H Date: Sat, 4 May 2024 12:54:34 -0700 Subject: [PATCH] Make f128 docs mention lack of any normal platform support Co-authored-by: Jubilee <46493976+workingjubilee@users.noreply.github.com> Update library/core/src/primitive_docs.rs Remove orphaned doc link and clean up grammar a bit Update library/core/src/primitive_docs.rs --- library/core/src/primitive_docs.rs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/library/core/src/primitive_docs.rs b/library/core/src/primitive_docs.rs index 7fa119b5006..cc369f1733f 100644 --- a/library/core/src/primitive_docs.rs +++ b/library/core/src/primitive_docs.rs @@ -1187,15 +1187,15 @@ mod prim_f64 {} /// as many bits as `f64`. Please see [the documentation for [`prim@f32`] or [Wikipedia on /// quad-precision values][wikipedia] for more information. /// -/// Note that no platforms have hardware support for `f128` without enabling target specific features -/// (and [only some consumer level hardware has support][wikipedia-support], for example RISC-V has support, but -/// neither amd64 nor aarch64 has support), in which case a software implementation will be used. This can be -/// significantly slower than using `f64`. +/// Note that no platforms have hardware support for `f128` without enabling target specific features, +/// as for all instruction set architectures `f128` is considered an optional feature. +/// Only Power ISA ("PowerPC") and RISCV specify it, and only certain microarchitectures +/// actually implement it. For x86-64 and AArch64, ISA support is not even specified, +/// so it will always be a software implementation significantly slower than `f64`. /// /// *[See also the `std::f128::consts` module](crate::f128::consts).* /// /// [wikipedia]: https://en.wikipedia.org/wiki/Quadruple-precision_floating-point_format -/// [wikipedia-support]: https://en.wikipedia.org/wiki/Quadruple-precision_floating-point_format#Hardware_support #[unstable(feature = "f128", issue = "116909")] mod prim_f128 {}