Changed comments for all the web references in core

Author: Anadroid

core/src/processing/awt/PGraphicsJava2D.java

@@ -993,13 +993,43 @@ public void noClip() {
   // BLEND
 
   /**
-   * ( begin auto-generated from blendMode.xml )
    *
-   * This is a new reference entry for Processing 2.0. It will be updated shortly.
+   * Blends the pixels in the display window according to a defined mode. 
+   * There is a choice of the following modes to blend the source pixels (A) 
+   * with the ones of pixels already in the display window (B). Each pixel's 
+   * final color is the result of applying one of the blend modes with each 
+   * channel of (A) and (B) independently. The red channel is compared with 
+   * red, green with green, and blue with blue.<br />
+   * <br />
+   * BLEND - linear interpolation of colors: C = A*factor + B. This is the default.<br />
+   * <br />
+   * ADD - additive blending with white clip: C = min(A*factor + B, 255)<br />
+   * <br />
+   * SUBTRACT - subtractive blending with black clip: C = max(B - A*factor, 0)<br />
+   * <br />
+   * DARKEST - only the darkest color succeeds: C = min(A*factor, B)<br />
+   * <br />
+   * LIGHTEST - only the lightest color succeeds: C = max(A*factor, B)<br />
+   * <br />
+   * DIFFERENCE - subtract colors from underlying image.<br />
+   * <br />
+   * EXCLUSION - similar to DIFFERENCE, but less extreme.<br />
+   * <br />
+   * MULTIPLY - multiply the colors, result will always be darker.<br />
+   * <br />
+   * SCREEN - opposite multiply, uses inverse values of the colors.<br />
+   * <br />
+   * REPLACE - the pixels entirely replace the others and don't utilize alpha (transparency) values<br />
+   * <br />
+   * We recommend using <b>blendMode()</b> and not the previous <b>blend()</b> 
+   * function. However, unlike <b>blend()</b>, the <b>blendMode()</b> function 
+   * does not support the following: HARD_LIGHT, SOFT_LIGHT, OVERLAY, DODGE, 
+   * BURN. On older hardware, the LIGHTEST, DARKEST, and DIFFERENCE modes might 
+   * not be available as well. 
    *
-   * ( end auto-generated )
    *
    * @webref Rendering
+   * @webBrief Blends the pixels in the display window according to a defined mode. 
    * @param mode the blending mode to use
    */
   @Override

core/src/processing/core/PConstants.java

@@ -128,15 +128,14 @@ public interface PConstants {
   // useful goodness
 
   /**
-   * ( begin auto-generated from PI.xml )
    *
    * PI is a mathematical constant with the value 3.14159265358979323846. It
    * is the ratio of the circumference of a circle to its diameter. It is
    * useful in combination with the trigonometric functions <b>sin()</b> and
    * <b>cos()</b>.
    *
-   * ( end auto-generated )
    * @webref constants
+   * @webBrief PI is a mathematical constant with the value 3.14159265358979323846.
    * @see PConstants#TWO_PI
    * @see PConstants#TAU
    * @see PConstants#HALF_PI
@@ -145,15 +144,14 @@ public interface PConstants {
    */
   static final float PI = (float) Math.PI;
   /**
-   * ( begin auto-generated from HALF_PI.xml )
    *
    * HALF_PI is a mathematical constant with the value
    * 1.57079632679489661923. It is half the ratio of the circumference of a
    * circle to its diameter. It is useful in combination with the
    * trigonometric functions <b>sin()</b> and <b>cos()</b>.
    *
-   * ( end auto-generated )
    * @webref constants
+   * @webBrief HALF_PI is a mathematical constant with the value 1.57079632679489661923.
    * @see PConstants#PI
    * @see PConstants#TWO_PI
    * @see PConstants#TAU
@@ -162,47 +160,44 @@ public interface PConstants {
   static final float HALF_PI = (float) (Math.PI / 2.0);
   static final float THIRD_PI = (float) (Math.PI / 3.0);
   /**
-   * ( begin auto-generated from QUARTER_PI.xml )
    *
    * QUARTER_PI is a mathematical constant with the value 0.7853982. It is
    * one quarter the ratio of the circumference of a circle to its diameter.
    * It is useful in combination with the trigonometric functions
    * <b>sin()</b> and <b>cos()</b>.
    *
-   * ( end auto-generated )
    * @webref constants
+   * @webBrief QUARTER_PI is a mathematical constant with the value 0.7853982.
    * @see PConstants#PI
    * @see PConstants#TWO_PI
    * @see PConstants#TAU
    * @see PConstants#HALF_PI
    */
   static final float QUARTER_PI = (float) (Math.PI / 4.0);
   /**
-   * ( begin auto-generated from TWO_PI.xml )
    *
    * TWO_PI is a mathematical constant with the value 6.28318530717958647693.
    * It is twice the ratio of the circumference of a circle to its diameter.
    * It is useful in combination with the trigonometric functions
    * <b>sin()</b> and <b>cos()</b>.
    *
-   * ( end auto-generated )
    * @webref constants
+   * @webBrief TWO_PI is a mathematical constant with the value 6.28318530717958647693.
    * @see PConstants#PI
    * @see PConstants#TAU
    * @see PConstants#HALF_PI
    * @see PConstants#QUARTER_PI
    */
   static final float TWO_PI = (float) (2.0 * Math.PI);
   /**
-   * ( begin auto-generated from TAU.xml )
    *
    * TAU is an alias for TWO_PI, a mathematical constant with the value
    * 6.28318530717958647693. It is twice the ratio of the circumference
    * of a circle to its diameter. It is useful in combination with the
    * trigonometric functions <b>sin()</b> and <b>cos()</b>.
    *
-   * ( end auto-generated )
    * @webref constants
+   * @webBrief An alias for TWO_PI
    * @see PConstants#PI
    * @see PConstants#TWO_PI
    * @see PConstants#HALF_PI

core/src/processing/core/PFont.java

@@ -56,6 +56,7 @@
  *   ^^^^^^^^^^^^^^ setWidth (width displaced by char)
  * </PRE>
  * @webref typography
+ * @webBrief Grayscale bitmap font class used by Processing.
  * @see PApplet#loadFont(String)
  * @see PApplet#createFont(String, float, boolean, char[])
  * @see PGraphics#textFont(PFont)
@@ -869,17 +870,16 @@ public PShape getShape(char ch, float detail) {
 
 
   /**
-   * ( begin auto-generated from PFont_list.xml )
    *
    * Gets a list of the fonts installed on the system. The data is returned
    * as a String array. This list provides the names of each font for input
    * into <b>createFont()</b>, which allows Processing to dynamically format
    * fonts. This function is meant as a tool for programming local
    * applications and is not recommended for use in applets.
    *
-   * ( end auto-generated )
    *
    * @webref pfont
+   * @webBrief Gets a list of the fonts installed on the system.
    * @usage application
    * @brief     Gets a list of the fonts installed on the system
    */