From 2c19b7b8cd5ace2c15ae8edbcddd8bae0b67d56f Mon Sep 17 00:00:00 2001 From: Stephen Canon Date: Tue, 12 Aug 2025 15:13:07 -0400 Subject: [PATCH] Last few review notes on complex. --- Sources/ComplexModule/Documentation.docc/Complex.md | 9 +++------ Sources/ComplexModule/Scale.swift | 4 ++-- 2 files changed, 5 insertions(+), 8 deletions(-) diff --git a/Sources/ComplexModule/Documentation.docc/Complex.md b/Sources/ComplexModule/Documentation.docc/Complex.md index c5ce545..7198461 100644 --- a/Sources/ComplexModule/Documentation.docc/Complex.md +++ b/Sources/ComplexModule/Documentation.docc/Complex.md @@ -1,12 +1,9 @@ # ``Complex`` -A Complex number type that conforms to `AlgebraicField` -(so all the normal arithmetic operations are available) and -`ElementaryFunctions` (so all the usual math functions are -available). +A complex number type represented by its real and imaginary parts, and equipped +with the usual arithmetic operators and math functions. -A `Complex` value is represented with two `RealType` values, corresponding to -the real and imaginary parts of the number. +## Overview You can access these Cartesian components using the real and imaginary properties. diff --git a/Sources/ComplexModule/Scale.swift b/Sources/ComplexModule/Scale.swift index df50d57..37275cc 100644 --- a/Sources/ComplexModule/Scale.swift +++ b/Sources/ComplexModule/Scale.swift @@ -22,7 +22,7 @@ // Complex! Obviously, that doesn't help anyone. extension Complex { - /// `self` multiplied by the real value `a`. + /// The result of multiplying this value by the real number `a`. /// /// Equivalent to `self * Complex(a)`, but may be computed more efficiently. @inlinable @inline(__always) @@ -30,7 +30,7 @@ extension Complex { Complex(x*a, y*a) } - /// `self` divided by the real value `a`. + /// The result of dividing this value by the real number `a`. /// /// More efficient than `self / Complex(a)`. May not produce exactly the /// same result, but will always be more accurate if they differ.