Apply suggestions from code review

Author: fmease

src/ieee.rs

@@ -12,8 +12,8 @@ use core::ops::Neg;
 
 /// A floating point number that uses IEEE semantics.
 ///
-/// Usually you will want the type aliases ([`Single`], [`Double`], ...) rather than using this
-/// directly.
+/// Usually you will want to use the available type aliases of this type
+/// (e.g., [`Single`], [`Double`]) rather than referencing it directly.
 ///
 /// If `S` implements [`Semantics`], this type will implement [`Float`].
 #[must_use]
@@ -344,7 +344,7 @@ ieee_semantics! {
 
 // FIXME(eddyb) consider moving X87-specific logic to a "has explicit integer bit"
 // associated `const` on `Semantics` itself.
-/// Floating point semantics for [`X87DoubleExtended`]
+/// Floating point semantics for [`X87DoubleExtended`].
 ///
 /// See that type for more details.
 pub struct X87DoubleExtendedS;

src/lib.rs

@@ -64,8 +64,7 @@ bitflags! {
     }
 }
 
-/// The result of a computation including the output value and and any exceptions if there were
-/// errors.
+/// The result of a computation consisting of the output value and the exceptions, if any.
 #[must_use]
 #[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Debug)]
 pub struct StatusAnd<T> {
@@ -157,7 +156,7 @@ pub const IEK_INF: ExpInt = ExpInt::max_value();
 pub const IEK_NAN: ExpInt = ExpInt::min_value();
 pub const IEK_ZERO: ExpInt = ExpInt::min_value() + 1;
 
-/// An error creating a floating point from a string.
+/// An error which can occur when parsing a floating point number from a string.
 #[derive(Copy, Clone, PartialEq, Eq, Debug)]
 pub struct ParseError(pub &'static str);
 

src/ppc.rs

@@ -15,7 +15,7 @@ pub struct DoubleFloat<F>(F, F);
 /// 128-bit floating point number comprised of two IEEE [`Double`](ieee::Double) values.
 ///
 /// This is the "IBM Extended Double" format, described at
-/// <https://www.ibm.com/docs/bg/aix/7.1?topic=sepl-128-bit-long-double-floating-point-data-type>.
+/// <https://www.ibm.com/docs/en/aix/7.3?topic=sepl-128-bit-long-double-floating-point-data-type>.
 pub type DoubleDouble = DoubleFloat<ieee::Double>;
 
 // These are legacy semantics for the Fallback, inaccrurate implementation of