Elaborated fuzzy math function descriptions.

Finished up pow2 and RandomDataGenerator descriptions.

Author: hexus

src/math/fuzzy/Ceil.js

@@ -5,15 +5,15 @@
  */
 
 /**
- * Calculate the ceiling of the given value.
+ * Calculate the fuzzy ceiling of the given value.
  *
  * @function Phaser.Math.Fuzzy.Ceil
  * @since 3.0.0
  *
  * @param {number} value - The value.
  * @param {float} [epsilon=0.0001] - The epsilon.
  *
- * @return {number} The ceiling of the value.
+ * @return {number} The fuzzy ceiling of the value.
  */
 var Ceil = function (value, epsilon)
 {

src/math/fuzzy/Equal.js

@@ -5,7 +5,9 @@
  */
 
 /**
- * Check whether the given values are equal.
+ * Check whether the given values are fuzzily equal.
+ *
+ * Two numbers are fuzzily equal if their difference is less than `epsilon`.
  *
  * @function Phaser.Math.Fuzzy.Equal
  * @since 3.0.0
@@ -14,7 +16,7 @@
  * @param {number} b - The second value.
  * @param {float} [epsilon=0.0001] - The epsilon.
  *
- * @return {boolean} Whether the given values are equal.
+ * @return {boolean} `true` if the values are fuzzily equal, otherwise `false`.
  */
 var Equal = function (a, b, epsilon)
 {

src/math/fuzzy/Floor.js

@@ -5,7 +5,7 @@
  */
 
 /**
- * Calculate the floor of the given value.
+ * Calculate the fuzzy floor of the given value.
  *
  * @function Phaser.Math.Fuzzy.Floor
  * @since 3.0.0

src/math/fuzzy/GreaterThan.js

@@ -5,7 +5,9 @@
  */
 
 /**
- * Check whether `a` is greater than `b`.
+ * Check whether `a` is fuzzily greater than `b`.
+ *
+ * `a` is fuzzily greater than `b` if it is more than `b - epsilon`.
  *
  * @function Phaser.Math.Fuzzy.GreaterThan
  * @since 3.0.0
@@ -14,7 +16,7 @@
  * @param {number} b - The second value.
  * @param {float} [epsilon=0.0001] - The epsilon.
  *
- * @return {boolean} Whether `a` is greater than `b`.
+ * @return {boolean} `true` if `a` is fuzzily greater than than `b`, otherwise `false`.
  */
 var GreaterThan = function (a, b, epsilon)
 {

src/math/fuzzy/LessThan.js

@@ -5,7 +5,9 @@
  */
 
 /**
- * Check whether `a` is less than `b`.
+ * Check whether `a` is fuzzily less than `b`.
+ *
+ * `a` is fuzzily less than `b` if it is less than `b + epsilon`.
  *
  * @function Phaser.Math.Fuzzy.LessThan
  * @since 3.0.0
@@ -14,7 +16,7 @@
  * @param {number} b - The second value.
  * @param {float} [epsilon=0.0001] - The epsilon.
  *
- * @return {boolean} Whether `a` is less than `b`.
+ * @return {boolean} `true` if `a` is fuzzily less than `b`, otherwise `false`.
  */
 var LessThan = function (a, b, epsilon)
 {

src/math/pow2/GetPowerOfTwo.js

@@ -10,13 +10,12 @@
  * @function Phaser.Math.Pow2.GetPowerOfTwo
  * @since 3.0.0
  *
- * @param {number} value - [description]
+ * @param {number} value - The value.
  *
- * @return {integer} [description]
+ * @return {integer} The nearest power of 2 to `value`.
  */
 var GetPowerOfTwo = function (value)
 {
-    //  Math.log(2)
     var index = Math.log(value) / 0.6931471805599453;
 
     return (1 << Math.ceil(index));

src/math/random-data-generator/RandomDataGenerator.js

@@ -8,14 +8,14 @@ var Class = require('../../utils/Class');
 
 /**
  * @classdesc
- * [description]
+ * A seeded random data generator.
  *
  * @class RandomDataGenerator
  * @memberOf Phaser.Math
  * @constructor
  * @since 3.0.0
  *
- * @param {string[]} [seeds] - [description]
+ * @param {string[]} [seeds] - The seeds.
  */
 var RandomDataGenerator = new Class({
 
@@ -79,7 +79,7 @@ var RandomDataGenerator = new Class({
         this.n = 0;
 
         /**
-         * [description]
+         * Signs to choose from.
          *
          * @name Phaser.Math.RandomDataGenerator#signs
          * @type {number[]}
@@ -100,7 +100,7 @@ var RandomDataGenerator = new Class({
      * @since 3.0.0
      * @private
      *
-     * @return {number} [description]
+     * @return {number} A random number.
      */
     rnd: function ()
     {
@@ -121,7 +121,7 @@ var RandomDataGenerator = new Class({
      * @since 3.0.0
      * @private
      *
-     * @param {string} data - [description]
+     * @param {string} data - The value to hash.
      *
      * @return {number} The hashed value.
      */
@@ -150,12 +150,12 @@ var RandomDataGenerator = new Class({
     },
 
     /**
-     * [description]
+     * Initialize the state of the random data generator.
      *
      * @method Phaser.Math.RandomDataGenerator#init
      * @since 3.0.0
      *
-     * @param {(string|string[])} seeds - [description]
+     * @param {(string|string[])} seeds - The seeds to initialize the random data generator with.
      */
     init: function (seeds)
     {
@@ -456,7 +456,7 @@ var RandomDataGenerator = new Class({
      *
      * @method Phaser.Math.RandomDataGenerator#shuffle
      * @since 3.7.0
-     * 
+     *
      * @param {array} [array] - The array to be shuffled.
      *
      * @return {array} The shuffled array.