Minor code edits

Author: peteroupc

Numbers/PeterO/Numbers/EDecimal.cs

@@ -95,12 +95,13 @@ namespace PeterO.Numbers {
   /// too, unless the flag's trap is enabled in the arithmetic context
   /// (see EContext's Traps property).</para>
   /// <para>If an operation requires creating an intermediate value that
-  /// might be too big to fit in memory (or might require more than 2
-  /// gigabytes of memory to store -- due to the current use of a 32-bit
-  /// integer internally as a length), the operation may signal an
-  /// invalid-operation flag and return not-a-number (NaN). In certain
-  /// rare cases, the CompareTo method may throw OutOfMemoryException
-  /// (called OutOfMemoryError in Java) in the same circumstances.</para>
+  /// might be too big to fit in system memory (or might require more
+  /// than 2 gigabytes of system memory to store -- due to the current
+  /// use of a 32-bit integer internally as a length), the operation may
+  /// signal an invalid-operation flag and return not-a-number (NaN). In
+  /// certain rare cases, the CompareTo method may throw
+  /// OutOfMemoryException (called OutOfMemoryError in Java) in the same
+  /// circumstances.</para>
   /// <para><b>Serialization</b>
   /// </para>
   /// <para>An arbitrary-precision decimal value can be serialized
@@ -5337,10 +5338,10 @@ public double ToDouble() {
     /// <summary>Converts this value to an arbitrary-precision integer,
     /// discarding the fractional part in this value. Note that depending
     /// on the value, especially the exponent, generating the
-    /// arbitrary-precision integer may require a huge amount of memory.
-    /// Use the ToSizedEInteger method to convert a number to an EInteger
-    /// only if the integer fits in a bounded bit range; that method will
-    /// throw an exception on overflow.</summary>
+    /// arbitrary-precision integer may require a huge amount of system
+    /// memory. Use the ToSizedEInteger method to convert a number to an
+    /// EInteger only if the integer fits in a bounded bit range; that
+    /// method will throw an exception on overflow.</summary>
     /// <returns>An arbitrary-precision integer.</returns>
     /// <exception cref='OverflowException'>This object's value is infinity
     /// or not-a-number (NaN).</exception>
@@ -5354,9 +5355,10 @@ public EInteger ToEInteger() {
     /// checking whether the fractional part of the value would be lost.
     /// Note that depending on the value, especially the exponent,
     /// generating the arbitrary-precision integer may require a huge
-    /// amount of memory. Use the ToSizedEIntegerIfExact method to convert
-    /// a number to an EInteger only if the integer fits in a bounded bit
-    /// range; that method will throw an exception on overflow.</summary>
+    /// amount of system memory. Use the ToSizedEIntegerIfExact method to
+    /// convert a number to an EInteger only if the integer fits in a
+    /// bounded bit range; that method will throw an exception on
+    /// overflow.</summary>
     /// <returns>An arbitrary-precision integer.</returns>
     /// <exception cref='OverflowException'>This object's value is infinity
     /// or not-a-number (NaN).</exception>
@@ -5371,9 +5373,10 @@ public EInteger ToEIntegerExact() {
     /// checking whether the fractional part of the value would be lost.
     /// Note that depending on the value, especially the exponent,
     /// generating the arbitrary-precision integer may require a huge
-    /// amount of memory. Use the ToSizedEIntegerIfExact method to convert
-    /// a number to an EInteger only if the integer fits in a bounded bit
-    /// range; that method will throw an exception on overflow.</summary>
+    /// amount of system memory. Use the ToSizedEIntegerIfExact method to
+    /// convert a number to an EInteger only if the integer fits in a
+    /// bounded bit range; that method will throw an exception on
+    /// overflow.</summary>
     /// <returns>An arbitrary-precision integer.</returns>
     /// <exception cref='OverflowException'>This object's value is infinity
     /// or not-a-number (NaN).</exception>

Numbers/PeterO/Numbers/EDecimals.cs

@@ -1010,7 +1010,7 @@ internal static byte[] FromLogical(EInteger um, EContext ec, int iradix) {
         null;
       EInteger bytecount = prec.ShiftRight(3).Add(1);
       if (bytecount.CompareTo(0x7fffffff) > 0) {
-        return null; // Out of memory
+        return null; // Out of system memory
       }
       var bitindex = 0;
       var bytes = new byte[bytecount.ToInt32Checked()];

Numbers/PeterO/Numbers/EFloat.cs

@@ -45,12 +45,13 @@ namespace PeterO.Numbers {
   /// identify a particular arbitrary-precision binary floating-point
   /// number value.</item></list>
   /// <para>If an operation requires creating an intermediate value that
-  /// might be too big to fit in memory (or might require more than 2
-  /// gigabytes of memory to store -- due to the current use of a 32-bit
-  /// integer internally as a length), the operation may signal an
-  /// invalid-operation flag and return not-a-number (NaN). In certain
-  /// rare cases, the CompareTo method may throw OutOfMemoryException
-  /// (called OutOfMemoryError in Java) in the same circumstances.</para>
+  /// might be too big to fit in system memory (or might require more
+  /// than 2 gigabytes of system memory to store -- due to the current
+  /// use of a 32-bit integer internally as a length), the operation may
+  /// signal an invalid-operation flag and return not-a-number (NaN). In
+  /// certain rare cases, the CompareTo method may throw
+  /// OutOfMemoryException (called OutOfMemoryError in Java) in the same
+  /// circumstances.</para>
   /// <para><b>Thread safety</b></para>
   /// <para>Instances of this class are immutable, so they are inherently
   /// safe for use by multiple threads. Multiple instances of this object
@@ -4338,9 +4339,9 @@ public EDecimal ToEDecimal() {
     /// fractional part of this value will be discarded when converting to
     /// an arbitrary-precision integer. Note that depending on the value,
     /// especially the exponent, generating the arbitrary-precision integer
-    /// may require a huge amount of memory. Use the ToSizedEInteger method
-    /// to convert a number to an EInteger only if the integer fits in a
-    /// bounded bit range; that method will throw an exception on
+    /// may require a huge amount of system memory. Use the ToSizedEInteger
+    /// method to convert a number to an EInteger only if the integer fits
+    /// in a bounded bit range; that method will throw an exception on
     /// overflow.</summary>
     /// <returns>An arbitrary-precision integer.</returns>
     /// <exception cref='OverflowException'>This object's value is infinity
@@ -4352,10 +4353,10 @@ public EInteger ToEInteger() {
     /// <summary>Converts this value to an arbitrary-precision integer,
     /// checking whether the value contains a fractional part. Note that
     /// depending on the value, especially the exponent, generating the
-    /// arbitrary-precision integer may require a huge amount of memory.
-    /// Use the ToSizedEIntegerIfExact method to convert a number to an
-    /// EInteger only if the integer fits in a bounded bit range; that
-    /// method will throw an exception on overflow.</summary>
+    /// arbitrary-precision integer may require a huge amount of system
+    /// memory. Use the ToSizedEIntegerIfExact method to convert a number
+    /// to an EInteger only if the integer fits in a bounded bit range;
+    /// that method will throw an exception on overflow.</summary>
     /// <returns>An arbitrary-precision integer.</returns>
     /// <exception cref='OverflowException'>This object's value is infinity
     /// or not-a-number (NaN).</exception>
@@ -4369,10 +4370,10 @@ public EInteger ToEIntegerExact() {
     /// <summary>Converts this value to an arbitrary-precision integer,
     /// checking whether the value contains a fractional part. Note that
     /// depending on the value, especially the exponent, generating the
-    /// arbitrary-precision integer may require a huge amount of memory.
-    /// Use the ToSizedEIntegerIfExact method to convert a number to an
-    /// EInteger only if the integer fits in a bounded bit range; that
-    /// method will throw an exception on overflow.</summary>
+    /// arbitrary-precision integer may require a huge amount of system
+    /// memory. Use the ToSizedEIntegerIfExact method to convert a number
+    /// to an EInteger only if the integer fits in a bounded bit range;
+    /// that method will throw an exception on overflow.</summary>
     /// <returns>An arbitrary-precision integer.</returns>
     /// <exception cref='OverflowException'>This object's value is infinity
     /// or not-a-number (NaN).</exception>

docs/PeterO.Numbers.EDecimal.md

@@ -32,7 +32,7 @@ Unless noted otherwise, passing a null arbitrary-precision decimal argument to a
 
 When an arithmetic operation signals the flag FlagInvalid, FlagOverflow, or FlagDivideByZero, it will not throw an exception too, unless the flag's trap is enabled in the arithmetic context (see EContext's Traps property).
 
-If an operation requires creating an intermediate value that might be too big to fit in memory (or might require more than 2 gigabytes of memory to store -- due to the current use of a 32-bit integer internally as a length), the operation may signal an invalid-operation flag and return not-a-number (NaN). In certain rare cases, the CompareTo method may throw OutOfMemoryException (called OutOfMemoryError in Java) in the same circumstances.
+If an operation requires creating an intermediate value that might be too big to fit in system memory (or might require more than 2 gigabytes of system memory to store -- due to the current use of a 32-bit integer internally as a length), the operation may signal an invalid-operation flag and return not-a-number (NaN). In certain rare cases, the CompareTo method may throw OutOfMemoryException (called OutOfMemoryError in Java) in the same circumstances.
 
 <b>Serialization</b>
 
@@ -4809,7 +4809,7 @@ An arbitrary-precision binary floating-point number.
 
     public PeterO.Numbers.EInteger ToEInteger();
 
-Converts this value to an arbitrary-precision integer, discarding the fractional part in this value. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of memory. Use the ToSizedEInteger method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
+Converts this value to an arbitrary-precision integer, discarding the fractional part in this value. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of system memory. Use the ToSizedEInteger method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
 
 <b>Return Value:</b>
 
@@ -4830,7 +4830,7 @@ There is not enough memory to store the value as an EInteger.
 
 <b>Obsolete.</b> Renamed to ToEIntegerIfExact.
 
-Converts this value to an arbitrary-precision integer, checking whether the fractional part of the value would be lost. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
+Converts this value to an arbitrary-precision integer, checking whether the fractional part of the value would be lost. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of system memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
 
 <b>Return Value:</b>
 
@@ -4849,7 +4849,7 @@ This object's value is not an exact integer.
 
     public PeterO.Numbers.EInteger ToEIntegerIfExact();
 
-Converts this value to an arbitrary-precision integer, checking whether the fractional part of the value would be lost. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
+Converts this value to an arbitrary-precision integer, checking whether the fractional part of the value would be lost. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of system memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
 
 <b>Return Value:</b>
 

docs/PeterO.Numbers.EFloat.md

@@ -18,7 +18,7 @@ An arbitrary-precision binary floating-point number value can be serialized in o
 
  * By calling the UnsignedMantissa, Exponent, and IsNegative properties, and calling the IsInfinity, IsQuietNaN, and IsSignalingNaN methods. The return values combined will uniquely identify a particular arbitrary-precision binary floating-point number value.
 
-If an operation requires creating an intermediate value that might be too big to fit in memory (or might require more than 2 gigabytes of memory to store -- due to the current use of a 32-bit integer internally as a length), the operation may signal an invalid-operation flag and return not-a-number (NaN). In certain rare cases, the CompareTo method may throw OutOfMemoryException (called OutOfMemoryError in Java) in the same circumstances.
+If an operation requires creating an intermediate value that might be too big to fit in system memory (or might require more than 2 gigabytes of system memory to store -- due to the current use of a 32-bit integer internally as a length), the operation may signal an invalid-operation flag and return not-a-number (NaN). In certain rare cases, the CompareTo method may throw OutOfMemoryException (called OutOfMemoryError in Java) in the same circumstances.
 
 <b>Thread safety</b>
 
@@ -4423,7 +4423,7 @@ This number, converted to an arbitrary-precision decimal number.
 
     public PeterO.Numbers.EInteger ToEInteger();
 
-Converts this value to an arbitrary-precision integer. Any fractional part of this value will be discarded when converting to an arbitrary-precision integer. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of memory. Use the ToSizedEInteger method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
+Converts this value to an arbitrary-precision integer. Any fractional part of this value will be discarded when converting to an arbitrary-precision integer. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of system memory. Use the ToSizedEInteger method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
 
 <b>Return Value:</b>
 
@@ -4441,7 +4441,7 @@ This object's value is infinity or not-a-number (NaN).
 
 <b>Obsolete.</b> Renamed to ToEIntegerIfExact.
 
-Converts this value to an arbitrary-precision integer, checking whether the value contains a fractional part. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
+Converts this value to an arbitrary-precision integer, checking whether the value contains a fractional part. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of system memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
 
 <b>Return Value:</b>
 
@@ -4460,7 +4460,7 @@ This object's value is not an exact integer.
 
     public PeterO.Numbers.EInteger ToEIntegerIfExact();
 
-Converts this value to an arbitrary-precision integer, checking whether the value contains a fractional part. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
+Converts this value to an arbitrary-precision integer, checking whether the value contains a fractional part. Note that depending on the value, especially the exponent, generating the arbitrary-precision integer may require a huge amount of system memory. Use the ToSizedEIntegerIfExact method to convert a number to an EInteger only if the integer fits in a bounded bit range; that method will throw an exception on overflow.
 
 <b>Return Value:</b>