Index: trunk/src/org/openstreetmap/josm/actions/AlignInCircleAction.java =================================================================== --- trunk/src/org/openstreetmap/josm/actions/AlignInCircleAction.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/actions/AlignInCircleAction.java (revision 8795) @@ -110,10 +110,10 @@ * * Case 1: One unclosed way. - * --> allow action, and align selected way nodes + * --> allow action, and align selected way nodes * If nodes contained by this way are selected, there are fix. * If nodes outside from the way are selected there are ignored. * * Case 2: One or more ways are selected and can be joined into a polygon - * --> allow action, and align selected ways nodes + * --> allow action, and align selected ways nodes * If 1 node outside of way is selected, it became center * If 1 node outside and 1 node inside are selected there define center and radius @@ -124,5 +124,5 @@ * * Case 3: Only nodes are selected - * --> Align these nodes, all are fix + * --> Align these nodes, all are fix */ @Override Index: trunk/src/org/openstreetmap/josm/actions/CreateMultipolygonAction.java =================================================================== --- trunk/src/org/openstreetmap/josm/actions/CreateMultipolygonAction.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/actions/CreateMultipolygonAction.java (revision 8795) @@ -190,4 +190,7 @@ /** * Returns a {@link Pair} of the old multipolygon {@link Relation} (or null) and the newly created/modified multipolygon {@link Relation}. + * @param selectedWays selected ways + * @param selectedMultipolygonRelation selected multipolygon relation + * @return pair of old and new multipolygon relation */ public static Pair updateMultipolygonRelation(Collection selectedWays, Relation selectedMultipolygonRelation) { @@ -207,4 +210,7 @@ /** * Returns a {@link Pair} null and the newly created/modified multipolygon {@link Relation}. + * @param selectedWays selected ways + * @param showNotif if {@code true}, shows a notification if an error occurs + * @return pair of null and new multipolygon relation */ public static Pair createMultipolygonRelation(Collection selectedWays, boolean showNotif) { @@ -220,4 +226,7 @@ /** * Returns a {@link Pair} of a multipolygon creating/modifying {@link Command} as well as the multipolygon {@link Relation}. + * @param selectedWays selected ways + * @param selectedMultipolygonRelation selected multipolygon relation + * @return pair of command and multipolygon relation */ public static Pair createMultipolygonCommand(Collection selectedWays, @@ -274,4 +283,5 @@ * This method analyzes ways and creates multipolygon. * @param selectedWays list of selected ways + * @param showNotif if {@code true}, shows a notification if an error occurs * @return null, if there was a problem with the ways. */ @@ -301,4 +311,5 @@ * Builds a relation from polygon ways. * @param pol data storage class containing polygon information + * @param clone relation to clone, can be null * @return multipolygon relation */ Index: trunk/src/org/openstreetmap/josm/actions/DistributeAction.java =================================================================== --- trunk/src/org/openstreetmap/josm/actions/DistributeAction.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/actions/DistributeAction.java (revision 8795) @@ -210,7 +210,8 @@ * that are furthest apart, and then to distribute all other selected * nodes along the straight line between these nodes. + * @param nodes nodes to distribute * @return Commands to execute to perform action */ - private Collection distributeNodes(Collection nodes) { + private static Collection distributeNodes(Collection nodes) { // Find from the selected nodes two that are the furthest apart. // Let's call them A and B. Index: trunk/src/org/openstreetmap/josm/actions/JoinAreasAction.java =================================================================== --- trunk/src/org/openstreetmap/josm/actions/JoinAreasAction.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/actions/JoinAreasAction.java (revision 8795) @@ -528,4 +528,5 @@ * @param areas list of areas to join * @return new area formed. + * @throws UserCancelException if user cancels the operation */ private JoinAreasResult joinAreas(List areas) throws UserCancelException { @@ -1194,4 +1195,5 @@ * @param polygon The list of outer ways that belong to that multigon. * @return The newly created outer way + * @throws UserCancelException if user cancels the operation */ private Multipolygon joinPolygon(AssembledMultipolygon polygon) throws UserCancelException { @@ -1209,4 +1211,5 @@ * @param ways The list of outer ways that belong to that multigon. * @return The newly created outer way + * @throws UserCancelException if user cancels the operation */ private Way joinWays(List ways) throws UserCancelException { @@ -1237,4 +1240,5 @@ * @param ways The list of ways to join and reverse * @return The newly created way + * @throws UserCancelException if user cancels the operation */ private Way joinOrientedWays(List ways) throws UserCancelException { Index: trunk/src/org/openstreetmap/josm/actions/ToggleAction.java =================================================================== --- trunk/src/org/openstreetmap/josm/actions/ToggleAction.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/actions/ToggleAction.java (revision 8795) @@ -120,4 +120,5 @@ * the component already set the selected state. * This method needs to be called especially if the action is associated with a keyboard shortcut to ensure correct selected state. + * @param e ActionEvent that trigerred the action * @see Changes to Actions in 1.6 * @see Interface Action Index: trunk/src/org/openstreetmap/josm/data/cache/ICachedLoaderJob.java =================================================================== --- trunk/src/org/openstreetmap/josm/data/cache/ICachedLoaderJob.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/data/cache/ICachedLoaderJob.java (revision 8795) @@ -43,5 +43,5 @@ * * @param listener cache loader listener - * @param force true if the load should skip all the caches (local & remote) + * @param force true if the load should skip all the caches (local & remote) * @throws IOException on failure from getUrl() call */ Index: trunk/src/org/openstreetmap/josm/data/gpx/GpxConstants.java =================================================================== --- trunk/src/org/openstreetmap/josm/data/gpx/GpxConstants.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/data/gpx/GpxConstants.java (revision 8795) @@ -53,5 +53,5 @@ String PT_TIME = "time"; - /** Magnetic variation (in degrees) at the point. 0.0 <= value < 360.0 */ + /** Magnetic variation (in degrees) at the point. 0.0 <= value < 360.0 */ String PT_MAGVAR = "magvar"; @@ -83,5 +83,5 @@ String PT_AGEOFDGPSDATA = "ageofdgpsdata"; - /** Represents a differential GPS station. 0 <= value <= 1023 */ + /** Represents a differential GPS station. 0 <= value <= 1023 */ String PT_DGPSID = "dgpsid"; Index: trunk/src/org/openstreetmap/josm/data/projection/Ellipsoid.java =================================================================== --- trunk/src/org/openstreetmap/josm/data/projection/Ellipsoid.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/data/projection/Ellipsoid.java (revision 8795) @@ -25,5 +25,5 @@ /** - * Australian National Spheroid (Australian Natl & S. Amer. 1969) + * Australian National Spheroid (Australian Natl & S. Amer. 1969) * same as GRS67 Modified */ Index: trunk/src/org/openstreetmap/josm/data/validation/routines/RegexValidator.java =================================================================== --- trunk/src/org/openstreetmap/josm/data/validation/routines/RegexValidator.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/data/validation/routines/RegexValidator.java (revision 8795) @@ -34,16 +34,16 @@ *

*

    - *
  • Validate true or false:
    • + *
  • Validate true or false: *
      *
    • boolean valid = validator.isValid(value);
      • - *
    - *
  • Validate returning an aggregated String of the matched groups:
    • + *
+ *
  • Validate returning an aggregated String of the matched groups: *
      *
    • String result = validator.validate(value);
      • - *
    - *
  • Validate returning the matched groups:
    • + * + *
  • Validate returning the matched groups: *
      *
    • String[] result = validator.match(value);
      • - *
    + *
    • * *

    Index: trunk/src/org/openstreetmap/josm/data/validation/routines/UrlValidator.java =================================================================== --- trunk/src/org/openstreetmap/josm/data/validation/routines/UrlValidator.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/data/validation/routines/UrlValidator.java (revision 8795) @@ -28,5 +28,5 @@ /** *

    URL Validation routines.

    - * Behavior of validation is modified by passing in options: + * Behavior of validation is modified by passing in options:
      *
    • ALLOW_2_SLASHES - [FALSE] Allows double '/' characters in the path * component.
      • @@ -35,5 +35,5 @@ *
    • ALLOW_ALL_SCHEMES - [FALSE] By default only http, https, and ftp are * considered valid schemes. Enabling this option will let any scheme pass validation.
      • - * + *
    *

    Originally based in on php script by Debbie Dyer, validation.php v1.2b, Date: 03/07/02, * http://javascript.internet.com. However, this validation now bears little resemblance Index: trunk/src/org/openstreetmap/josm/gui/PleaseWaitRunnable.java =================================================================== --- trunk/src/org/openstreetmap/josm/gui/PleaseWaitRunnable.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/gui/PleaseWaitRunnable.java (revision 8795) @@ -177,4 +177,7 @@ * exception is thrown, a message box will be displayed and closeDialog * is called. finish() is called in any case. + * @throws SAXException if a SAX error occurs + * @throws IOException if an I/O error occurs + * @throws OsmTransferException if a communication error with the OSM server occurs */ protected abstract void realRun() throws SAXException, IOException, OsmTransferException; Index: trunk/src/org/openstreetmap/josm/gui/mappaint/mapcss/ExpressionFactory.java =================================================================== --- trunk/src/org/openstreetmap/josm/gui/mappaint/mapcss/ExpressionFactory.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/gui/mappaint/mapcss/ExpressionFactory.java (revision 8795) @@ -565,8 +565,8 @@ /** - * Function associated to the logical ">=" operator. + * Function associated to the logical ">=" operator. * @param a first value * @param b second value - * @return {@code true} if {@code a >= b} + * @return {@code true} if {@code a >= b} */ public static boolean greater_equal(float a, float b) { @@ -575,8 +575,8 @@ /** - * Function associated to the logical "<=" operator. + * Function associated to the logical "<=" operator. * @param a first value * @param b second value - * @return {@code true} if {@code a <= b} + * @return {@code true} if {@code a <= b} */ public static boolean less_equal(float a, float b) { @@ -585,8 +585,8 @@ /** - * Function associated to the logical ">" operator. + * Function associated to the logical ">" operator. * @param a first value * @param b second value - * @return {@code true} if {@code a > b} + * @return {@code true} if {@code a > b} */ public static boolean greater(float a, float b) { @@ -595,8 +595,8 @@ /** - * Function associated to the logical "<" operator. + * Function associated to the logical "<" operator. * @param a first value * @param b second value - * @return {@code true} if {@code a < b} + * @return {@code true} if {@code a < b} */ public static boolean less(float a, float b) { Index: trunk/src/org/openstreetmap/josm/gui/widgets/AbstractFileChooser.java =================================================================== --- trunk/src/org/openstreetmap/josm/gui/widgets/AbstractFileChooser.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/gui/widgets/AbstractFileChooser.java (revision 8795) @@ -179,5 +179,5 @@ * Pops up an "Open File" file chooser dialog. Note that the * text that appears in the approve button is determined by - * the L&F. + * the L&F. * * @param parent the parent component of the dialog, @@ -199,5 +199,5 @@ * Pops up a "Save File" file chooser dialog. Note that the * text that appears in the approve button is determined by - * the L&F. + * the L&F. * * @param parent the parent component of the dialog, Index: trunk/src/org/openstreetmap/josm/plugins/PluginHandler.java =================================================================== --- trunk/src/org/openstreetmap/josm/plugins/PluginHandler.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/plugins/PluginHandler.java (revision 8795) @@ -463,5 +463,5 @@ /** - * Alerts the user if a plugin required by another plugin is missing, and offer to download them & restart JOSM + * Alerts the user if a plugin required by another plugin is missing, and offer to download them & restart JOSM * * @param parent The parent Component used to display error popup Index: trunk/src/org/openstreetmap/josm/tools/Utils.java =================================================================== --- trunk/src/org/openstreetmap/josm/tools/Utils.java (revision 8792) +++ trunk/src/org/openstreetmap/josm/tools/Utils.java (revision 8795) @@ -1316,10 +1316,10 @@ /** - * Returns a pair containing the number of threads (n), and a thread pool (if n > 1) to perform + * Returns a pair containing the number of threads (n), and a thread pool (if n > 1) to perform * multi-thread computation in the context of the given preference key. * @param pref The preference key * @param nameFormat see {@link #newThreadFactory(String, int)} * @param threadPriority see {@link #newThreadFactory(String, int)} - * @return a pair containing the number of threads (n), and a thread pool (if n > 1, null otherwise) + * @return a pair containing the number of threads (n), and a thread pool (if n > 1, null otherwise) * @since 7423 */