Index: trunk/src/org/openstreetmap/josm/data/projection/proj/AbstractProj.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/projection/proj/AbstractProj.java	(revision 9427)
+++ trunk/src/org/openstreetmap/josm/data/projection/proj/AbstractProj.java	(revision 9428)
@@ -53,8 +53,8 @@
 
     /**
-     * Ellipsoid excentricity, equals to <code>sqrt({@link #excentricitySquared})</code>.
+     * Ellipsoid excentricity, equals to <code>sqrt({@link #e2 excentricity squared})</code>.
      * Value 0 means that the ellipsoid is spherical.
      *
-     * @see #excentricitySquared
+     * @see #e2
      */
     protected double e;
@@ -65,4 +65,6 @@
      * <var>a</var> is the semi major axis length and
      * <var>b</var> is the semi minor axis length.
+     *
+     * @see #e
      */
     protected double e2;
@@ -147,6 +149,8 @@
      * Computes function <code>f(s,c,e²) = c/sqrt(1 - s²&times;e²)</code> needed for the true scale
      * latitude (Snyder 14-15), where <var>s</var> and <var>c</var> are the sine and cosine of
-     * the true scale latitude, and <var>e²</var> is the {@linkplain #excentricitySquared
-     * eccentricity squared}.
+     * the true scale latitude, and <var>e²</var> is the {@linkplain #e2 eccentricity squared}.
+     * @param s sine of the true scale latitude
+     * @param c cosine of the true scale latitude
+     * @return <code>c/sqrt(1 - s²&times;e²)</code>
      */
     final double msfn(final double s, final double c) {
@@ -160,7 +164,5 @@
     final double tsfn(final double lat, double sinlat) {
         sinlat *= e;
-        /*
-         * NOTE: change sign to get the equivalent of Snyder (7-7).
-         */
+        // NOTE: change sign to get the equivalent of Snyder (7-7).
         return Math.tan(0.5 * (Math.PI/2 - lat)) / Math.pow((1 - sinlat) / (1 + sinlat), 0.5*e);
     }
Index: trunk/src/org/openstreetmap/josm/data/projection/proj/AlbersEqualArea.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/projection/proj/AlbersEqualArea.java	(revision 9427)
+++ trunk/src/org/openstreetmap/josm/data/projection/proj/AlbersEqualArea.java	(revision 9428)
@@ -72,10 +72,10 @@
 
     /**
-     * Standards parallel 1 in radians, for {@link #getParameterValues} implementation.
+     * Standards parallel 1 in radians.
      */
     private double phi1;
 
     /**
-     * Standards parallel 2 in radians, for {@link #getParameterValues} implementation.
+     * Standards parallel 2 in radians.
      */
     private double phi2;
Index: trunk/src/org/openstreetmap/josm/data/projection/proj/PolarStereographic.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/projection/proj/PolarStereographic.java	(revision 9427)
+++ trunk/src/org/openstreetmap/josm/data/projection/proj/PolarStereographic.java	(revision 9428)
@@ -8,5 +8,5 @@
 
 /**
- * The polar case of the {@linkplain Stereographic stereographic} projection.
+ * The polar case of the stereographic projection.
  * <p>
  * In the proj.4 library, the code "stere" covers several variants of the
@@ -75,5 +75,4 @@
     /**
      * A constant used in the transformations.
-     * This is <strong>not</strong> equal to the {@link #scaleFactor}.
      */
     private double k0;
@@ -115,7 +114,5 @@
         southPole = latitudeTrueScale < 0;
 
-        /*
-         * Computes coefficients.
-         */
+        // Computes coefficients.
         double latitudeTrueScaleAbs = Math.abs(latitudeTrueScale);
         if (Math.abs(latitudeTrueScaleAbs - Math.PI/2) >= EPSILON) {
@@ -126,5 +123,5 @@
             // True scale at pole (part of (21-33))
             k0 = 2.0 / Math.sqrt(Math.pow(1+e, 1+e)*
-                            Math.pow(1-e, 1-e));
+                                 Math.pow(1-e, 1-e));
         }
     }