Improved Math.Angle function documentation.

src/math/angle/Between.js

@@ -5,9 +5,7 @@
  */
 
 /**
- * Calculate the angle between two sets of coordinates (points).
+ * Find the angle of a segment from (x1, y1) -> (x2, y2).
- *
- * Calculates the angle of the vector from the first point to the second point.
  *
  * @function Phaser.Math.Angle.Between
  * @since 3.0.0

src/math/angle/BetweenPoints.js

@@ -5,7 +5,7 @@
  */
 
 /**
- * Calculate the angle between two points.
+ * Find the angle of a segment from (point1.x, point1.y) -> (point2.x, point2.y).
  *
  * Calculates the angle of the vector from the first point to the second point.
  *

src/math/angle/BetweenPointsY.js

@@ -5,7 +5,10 @@
  */
 
 /**
- * [description]
+ * Find the angle of a segment from (point1.x, point1.y) -> (point2.x, point2.y).
+ *
+ * The difference between this method and {@link Phaser.Math.Angle.BetweenPoints} is that this assumes the y coordinate
+ * travels down the screen.
  *
  * @function Phaser.Math.Angle.BetweenPointsY
  * @since 3.0.0

src/math/angle/BetweenY.js

@@ -5,7 +5,10 @@
  */
 
 /**
- * [description]
+ * Find the angle of a segment from (x1, y1) -> (x2, y2).
+ *
+ * The difference between this method and {@link Phaser.Math.Angle.Between} is that this assumes the y coordinate
+ * travels down the screen.
  *
  * @function Phaser.Math.Angle.BetweenY
  * @since 3.0.0

src/math/angle/Normalize.js

@@ -5,9 +5,7 @@
  */
 
 /**
- * Normalize the given angle.
+ * Normalize an angle to the [0, 2pi] range.
- *
- * [description] TODO: Needs elaborating
  *
  * @function Phaser.Math.Angle.Normalize
  * @since 3.0.0