Rollup merge of #129645 - beetrees:fix-float-docs, r=tgross35 · patricklam/verify-rust-std@c7cbb41 (original) (raw)

`@@ -1130,8 +1130,8 @@ impl (T,) {}

`

1130

1130

`/// A 16-bit floating point type (specifically, the "binary16" type defined in IEEE 754-2008).

`

1131

1131

`///

`

1132

1132

`` /// This type is very similar to [prim@f32] but has decreased precision because it uses half as many

``

1133

``

`` -

/// bits. Please see [the documentation for [prim@f32] or [Wikipedia on

``

1134

``

`-

/// half-precision values][wikipedia] for more information.

`

``

1133

`` +

/// bits. Please see the documentation for f32 or [Wikipedia on half-precision

``

``

1134

`+

/// values][wikipedia] for more information.

`

1135

1135

`///

`

1136

1136

`` /// Note that most common platforms will not support f16 in hardware without enabling extra target

``

1137

1137

`/// features, with the notable exception of Apple Silicon (also known as M1, M2, etc.) processors.

`

`@@ -1296,14 +1296,12 @@ mod prim_f32 {}

`

1296

1296

`#[doc(alias = "double")]

`

1297

1297

`/// A 64-bit floating point type (specifically, the "binary64" type defined in IEEE 754-2008).

`

1298

1298

`///

`

1299

``

`` -

/// This type is very similar to [f32], but has increased

``

1300

``

`-

/// precision by using twice as many bits. Please see [the documentation for

`

1301

``

`` -

/// f32][f32] or [Wikipedia on double precision

``

``

1299

`` +

/// This type is very similar to [prim@f32], but has increased precision by using twice as many

``

``

1300

`` +

/// bits. Please see the documentation for f32 or [Wikipedia on double-precision

``

1302

1301

`/// values][wikipedia] for more information.

`

1303

1302

`///

`

1304

1303

`` /// See also the std::f64::consts module.

``

1305

1304

`///

`

1306

``

`` -

/// [f32]: prim@f32

``

1307

1305

`/// [wikipedia]: https://en.wikipedia.org/wiki/Double-precision_floating-point_format

`

1308

1306

`#[stable(feature = "rust1", since = "1.0.0")]

`

1309

1307

`mod prim_f64 {}

`

`@@ -1313,12 +1311,12 @@ mod prim_f64 {}

`

1313

1311

`/// A 128-bit floating point type (specifically, the "binary128" type defined in IEEE 754-2008).

`

1314

1312

`///

`

1315

1313

`` /// This type is very similar to [prim@f32] and [prim@f64], but has increased precision by using twice

``

1316

``

`` -

/// as many bits as f64. Please see [the documentation for [prim@f32] or [Wikipedia on

``

``

1314

`` +

/// as many bits as f64. Please see the documentation for f32 or [Wikipedia on

``

1317

1315

`/// quad-precision values][wikipedia] for more information.

`

1318

1316

`///

`

1319

1317

`` /// Note that no platforms have hardware support for f128 without enabling target specific features,

``

1320

1318

`` /// as for all instruction set architectures f128 is considered an optional feature.

``

1321

``

`-

/// Only Power ISA ("PowerPC") and RISCV specify it, and only certain microarchitectures

`

``

1319

`+

/// Only Power ISA ("PowerPC") and RISC-V specify it, and only certain microarchitectures

`

1322

1320

`/// actually implement it. For x86-64 and AArch64, ISA support is not even specified,

`

1323

1321

`` /// so it will always be a software implementation significantly slower than f64.

``

1324

1322

`///

`