[Arakhnę-Dev] [408] * Fixing javadoc.

[ Thread Index | Date Index | More arakhne.org/dev Archives ]


Revision: 408
Author:   galland
Date:     2013-04-05 12:04:20 +0200 (Fri, 05 Apr 2013)
Log Message:
-----------
* Fixing javadoc.

Modified Paths:
--------------
    trunk/math/src/main/java/org/arakhne/afc/math/MathUtil.java

Modified: trunk/math/src/main/java/org/arakhne/afc/math/MathUtil.java
===================================================================
--- trunk/math/src/main/java/org/arakhne/afc/math/MathUtil.java	2013-04-04 18:23:34 UTC (rev 407)
+++ trunk/math/src/main/java/org/arakhne/afc/math/MathUtil.java	2013-04-05 10:04:20 UTC (rev 408)
@@ -744,16 +744,27 @@
 	}
 
 	/**
-	 * Replies the relative counterclockwise (CCW) of a segment against a point. Returns an indicator of where the specified point {@code (px,py)} lies with respect to the line segment from {@code (x1,y1)} to {@code (x2,y2)}. The return value can be either 1, -1, or 0 and indicates in which direction the specified line must pivot around its first end point, {@code (x1,y1)}, in order to point at the specified point {@code (px,py)}.
+	 * Replies the relative counterclockwise (CCW) of a segment against a point. Returns an indicator of where 
+	 * the specified point {@code (px,py)} lies with respect to the line segment from {@code (x1,y1)}
+	 *  to {@code (x2,y2)}. The return value can be either 1, -1, or 0 and indicates in which 
+	 *  direction the specified line must pivot around its first end point, {@code (x1,y1)}, in 
+	 *  order to point at the specified point {@code (px,py)}.
 	 * In other words, given three point P1, P2, and P, is the segments (P1-P2-P) a counterclockwise turn?
 	 * <p>
-	 * A return value of 1 indicates that the line segment must turn in the direction that takes the positive X axis towards the negative Y axis. In the default coordinate system used by Java 2D, this direction is counterclockwise.
+	 * A return value of 1 indicates that the line segment must turn in the direction that takes the 
+	 * positive X axis towards the negative Y axis. In the default coordinate system used by Java 2D, 
+	 * this direction is counterclockwise.
 	 * <p>
-	 * A return value of -1 indicates that the line segment must turn in the direction that takes the positive X axis towards the positive Y axis. In the default coordinate system, this direction is clockwise.
+	 * A return value of -1 indicates that the line segment must turn in the direction that takes the 
+	 * positive X axis towards the positive Y axis. In the default coordinate system, this 
+	 * direction is clockwise.
 	 * <p>
-	 * A return value of 0 indicates that the point lies exactly on the line segment. Note that an indicator value of 0 is rare and not useful for determining colinearity because of floating point rounding issues.
+	 * A return value of 0 indicates that the point lies exactly on the line segment. 
+	 * Note that an indicator value of 0 is rare and not useful for determining colinearity 
+	 * because of floating point rounding issues.
 	 * <p>
-	 * If the point is colinear with the line segment, but not between the end points, then the value will be -1 if the point lies "beyond {@code (x1,y1)}" or 1 if the point lies "beyond {@code (x2,y2)}".
+	 * If the point is colinear with the line segment, but not between the end points, then the value will be 
+	 * -1 if the point lies "beyond {@code (x1,y1)}" or 1 if the point lies "beyond {@code (x2,y2)}".
 	 * 
 	 * @param x1
 	 *            the X coordinate of the start point of the specified line segment
@@ -770,6 +781,7 @@
 	 * @param approximateZero
 	 *            indicates if zero may be approximated or not.
 	 * @return an integer that indicates the position of the third specified coordinates with respect to the line segment formed by the first two specified coordinates.
+	 * @see #ccw(float, float, float, float, float, float) 
 	 * @see #relativeDistancePointToLine(float, float, float, float, float, float)
 	 */
 	public static int ccw(float x1, float y1, float x2, float y2, float px, float py, boolean approximateZero) {


Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/