Merge pull request #5109 from WalterBright/math-comments

std.math: use proper block comments

Author: WalterBright

std/math.d

@@ -4515,20 +4515,34 @@ public:
     version (IeeeFlagsSupport)
     {
 
-     /// The result cannot be represented exactly, so rounding occurred.
-     /// (example: x = sin(0.1); )
+     /**
+      * The result cannot be represented exactly, so rounding occurred.
+      * Example: `x = sin(0.1);`
+      */
      @property bool inexact() { return (flags & INEXACT_MASK) != 0; }
 
-     /// A zero was generated by underflow (example: x = real.min*real.epsilon/2;)
+     /**
+      * A zero was generated by underflow
+      * Example: `x = real.min*real.epsilon/2;`
+      */
      @property bool underflow() { return (flags & UNDERFLOW_MASK) != 0; }
 
-     /// An infinity was generated by overflow (example: x = real.max*2;)
+     /**
+      * An infinity was generated by overflow
+      * Example: `x = real.max*2;`
+      */
      @property bool overflow() { return (flags & OVERFLOW_MASK) != 0; }
 
-     /// An infinity was generated by division by zero (example: x = 3/0.0; )
+     /**
+      * An infinity was generated by division by zero
+      * Example: `x = 3/0.0;`
+      */
      @property bool divByZero() { return (flags & DIVBYZERO_MASK) != 0; }
 
-     /// A machine NaN was generated. (example: x = real.infinity * 0.0; )
+     /**
+      * A machine NaN was generated.
+      * Example: `x = real.infinity * 0.0;`
+      */
      @property bool invalid() { return (flags & INVALID_MASK) != 0; }
 
      }
@@ -4573,7 +4587,7 @@ else version(ARM)
 /// Set all of the floating-point status flags to false.
 void resetIeeeFlags() { IeeeFlags.resetIeeeFlags(); }
 
-/// Return a snapshot of the current state of the floating-point status flags.
+/// Returns: snapshot of the current state of the floating-point status flags
 @property IeeeFlags ieeeFlags()
 {
    return IeeeFlags(IeeeFlags.getIeeeFlags());
@@ -4745,7 +4759,7 @@ private:
         static assert(false, "Architecture not supported");
 
 public:
-    /// Returns true if the current FPU supports exception trapping
+    /// Returns: true if the current FPU supports exception trapping
     @property static bool hasExceptionTraps() @safe nothrow @nogc
     {
         version(X86_Any)
@@ -4795,7 +4809,7 @@ public:
         setControlState((getControlState() & ~ROUNDING_MASK) | (newMode & ROUNDING_MASK));
     }
 
-    /// Return the exceptions which are currently enabled (unmasked)
+    /// Returns: the exceptions which are currently enabled (unmasked)
     @property static uint enabledExceptions() @nogc
     {
         assert(hasExceptionTraps);
@@ -4805,7 +4819,7 @@ public:
             return (getControlState() & EXCEPTION_MASK);
     }
 
-    /// Return the currently active rounding mode
+    /// Returns: the currently active rounding mode
     @property static RoundingMode rounding() @nogc
     {
         return cast(RoundingMode)(getControlState() & ROUNDING_MASK);