Index: trunk/src/org/openstreetmap/josm/actions/DeleteAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/DeleteAction.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/actions/DeleteAction.java	(revision 5275)
@@ -2,6 +2,6 @@
 package org.openstreetmap.josm.actions;
 
+import static org.openstreetmap.josm.gui.help.HelpUtil.ht;
 import static org.openstreetmap.josm.tools.I18n.tr;
-import static org.openstreetmap.josm.gui.help.HelpUtil.ht;
 
 import java.awt.event.ActionEvent;
Index: trunk/src/org/openstreetmap/josm/actions/JosmAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/JosmAction.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/actions/JosmAction.java	(revision 5275)
@@ -15,4 +15,5 @@
 import org.openstreetmap.josm.data.osm.OsmPrimitive;
 import org.openstreetmap.josm.gui.MapView;
+import org.openstreetmap.josm.gui.MapView.LayerChangeListener;
 import org.openstreetmap.josm.gui.layer.Layer;
 import org.openstreetmap.josm.gui.layer.OsmDataLayer;
@@ -25,6 +26,6 @@
  *
  * A JosmAction is a {@link LayerChangeListener} and a {@link SelectionChangedListener}. Upon
- * a layer change event or a selection change event it invokes {@link #updateEnabled()}.
- * Subclasses can override {@link #updateEnabled()} in order to update the {@link #isEnabled()}-state
+ * a layer change event or a selection change event it invokes {@link #updateEnabledState()}.
+ * Subclasses can override {@link #updateEnabledState()} in order to update the {@link #isEnabled()}-state
  * of a JosmAction depending on the {@link #getCurrentDataSet()} and the current layers
  * (see also {@link #getEditLayer()}).
Index: trunk/src/org/openstreetmap/josm/actions/PasteTagsAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/PasteTagsAction.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/actions/PasteTagsAction.java	(revision 5275)
@@ -1,4 +1,3 @@
 // License: GPL. Copyright 2007 by Immanuel Scholz and others
-// Author: David Earl
 package org.openstreetmap.josm.actions;
 
@@ -29,4 +28,12 @@
 import org.openstreetmap.josm.tools.Shortcut;
 
+/**
+ * Action, to paste all tags from one primitive to another.
+ *
+ * It will take the primitive from the copy-paste buffer an apply all its tags
+ * to the selected primitive(s).
+ *
+ * @author David Earl
+ */
 public final class PasteTagsAction extends JosmAction implements PasteBufferChangedListener {
 
@@ -54,6 +61,4 @@
          * Replies true if the source for tag pasting is heterogeneous, i.e. if it doesn't consist of
          * {@link OsmPrimitive}s of exactly one type
-         *
-         * @return
          */
         protected boolean isHeteogeneousSource() {
@@ -130,11 +135,9 @@
 
         /**
-         * Pastes the tags from a homogeneous source (i.e. the {@link Main#pasteBuffer}s selection consisting
-         * of one type of {@link OsmPrimitive}s only.
+         * Pastes the tags from a homogeneous source (the {@link Main#pasteBuffer}s selection consisting
+         * of one type of {@link OsmPrimitive}s only).
          *
          * Tags from a homogeneous source can be pasted to a heterogeneous target. All target primitives,
          * regardless of their type, receive the same tags.
-         *
-         * @param targets the collection of target primitives
          */
         protected void pasteFromHomogeneousSource() {
@@ -166,9 +169,8 @@
 
         /**
-         * Replies true if there is at least one primitive of type <code>type</code> in the collection
-         * <code>selection</code>
-         *
-         * @param <T>
-         * @param selection  the collection of primitives
+         * Replies true if there is at least one primitive of type <code>type</code> 
+         * is in the target collection
+         *
+         * @param <T>
          * @param type  the type to look for
          * @return true if there is at least one primitive of type <code>type</code> in the collection
@@ -199,6 +201,4 @@
          * Pastes the tags in the current selection of the paste buffer to a set of target
          * primitives.
-         *
-         * @param targets the collection of target primitives
          */
         protected void pasteFromHeterogeneousSource() {
Index: trunk/src/org/openstreetmap/josm/actions/downloadtasks/PostDownloadHandler.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/downloadtasks/PostDownloadHandler.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/actions/downloadtasks/PostDownloadHandler.java	(revision 5275)
@@ -36,5 +36,5 @@
      * constructor
      * @param task the asynchronous download task
-     * @param future the future on which the completion of the download task can be synchronized
+     * @param futures the futures on which the completion of the download task can be synchronized
      */
     public PostDownloadHandler(DownloadTask task, Future<?> ... futures) {
@@ -50,5 +50,5 @@
      * constructor
      * @param task the asynchronous download task
-     * @param future the future on which the completion of the download task can be synchronized
+     * @param futures the futures on which the completion of the download task can be synchronized
      */
     public PostDownloadHandler(DownloadTask task, List<Future<?>> futures) {
Index: trunk/src/org/openstreetmap/josm/actions/mapmode/DeleteAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/mapmode/DeleteAction.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/actions/mapmode/DeleteAction.java	(revision 5275)
@@ -33,5 +33,5 @@
 
 /**
- * An action that enables the user to delete nodes and other objects.
+ * A map mode that enables the user to delete nodes and other objects.
  *
  * The user can click on an object, which gets deleted if possible. When Ctrl is
@@ -43,5 +43,5 @@
  *
  * If the user enters the mapmode and any object is selected, all selected
- * objects that can be deleted will.
+ * objects are deleted, if possible.
  *
  * @author imi
@@ -162,5 +162,5 @@
     /**
      * Listen to mouse move to be able to update the cursor (and highlights)
-     * @param MouseEvent The mouse event that has been captured
+     * @param e The mouse event that has been captured
      */
     @Override public void mouseMoved(MouseEvent e) {
@@ -256,6 +256,6 @@
      * highlights
      *
-     * @param MouseEvent
-     * @param int modifiers
+     * @param e
+     * @param modifiers
      */
     private void updateCursor(MouseEvent e, int modifiers) {
@@ -330,6 +330,5 @@
 
     /**
-     * Deletes the relation in the context of the given layer. Also notifies
-     * {@link RelationDialogManager} and {@link OsmDataLayer#fireDataChange()} events.
+     * Deletes the relation in the context of the given layer.
      *
      * @param layer the layer in whose context the relation is deleted. Must not be null.
@@ -385,5 +384,5 @@
      * that should be deleted but does not actually delete them.
      * @param e MouseEvent from which modifiers and position are taken
-     * @param int modifiers For explanation: @see updateCursor
+     * @param modifiers For explanation: @see updateCursor
      * @param silet Set to true if the user should not be bugged with additional
      *        dialogs
Index: trunk/src/org/openstreetmap/josm/gui/ExceptionDialogUtil.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/ExceptionDialogUtil.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/gui/ExceptionDialogUtil.java	(revision 5275)
@@ -14,4 +14,5 @@
 
 import org.openstreetmap.josm.Main;
+import org.openstreetmap.josm.data.osm.OsmPrimitive;
 import org.openstreetmap.josm.io.ChangesetClosedException;
 import org.openstreetmap.josm.io.IllegalDataException;
Index: trunk/src/org/openstreetmap/josm/gui/ExtendedDialog.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/ExtendedDialog.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/gui/ExtendedDialog.java	(revision 5275)
@@ -42,18 +42,18 @@
  * General configurable dialog window.
  *
- * If dialog is modal, you can use getValue() to retrieve the
+ * If dialog is modal, you can use {@link #getValue()} to retrieve the
  * button index. Note that the user can close the dialog
  * by other means. This is usually equivalent to cancel action.
  *
- * For non-modal dialogs, buttonAction(int) can be overridden.
+ * For non-modal dialogs, {@link #buttonAction(int, ActionEvent)} can be overridden.
  *
  * There are various options, see below.
  *
  * Note: The button indices are counted from 1 and upwards.
- * So for getValue(), setDefaultButton(int) and setCancelButton(int) the
- * first button has index 1.
+ * So for {@link #getValue()}, {@link #setDefaultButton(int)} and 
+ * {@link #setCancelButton} the first button has index 1.
  * 
  * Simple example:
- * <code>
+ * <pre>
  *  ExtendedDialog ed = new ExtendedDialog(
  *          Main.parent, tr("Dialog Title"),
@@ -66,5 +66,5 @@
  *      // proceed...
  *  }
- * </code>
+ * </pre>
  */
 public class ExtendedDialog extends JDialog {
@@ -171,6 +171,6 @@
 
     /**
-     * Allows decorating the buttons with tooltips. Expects an String[] with translated
-     * tooltip texts.
+     * Allows decorating the buttons with tooltips. Expects a String array with
+     * translated tooltip texts.
      *
      * @param toolTipTexts the tool tip texts. Ignored, if null.
@@ -224,5 +224,5 @@
     /**
      * Decorate the dialog with an icon that is shown on the left part of
-     * the window area. (Similar to how it is done in JOptionPane)
+     * the window area. (Similar to how it is done in {@link JOptionPane})
      */
     public ExtendedDialog setIcon(Icon icon) {
@@ -232,5 +232,5 @@
 
     /**
-     * Convenience method to allow values that would be accepted by JOptionPane as messageType.
+     * Convenience method to allow values that would be accepted by {@link JOptionPane} as messageType.
      */
     public ExtendedDialog setIcon(int messageType) {
@@ -253,5 +253,5 @@
     /**
      * Show the dialog to the user. Call this after you have set all options
-     * for the dialog. You can retrieve the result using <code>getValue</code>
+     * for the dialog. You can retrieve the result using {@link #getValue()}.
      */
     public ExtendedDialog showDialog() {
@@ -273,6 +273,9 @@
 
     /**
-     * @return int * The selected button. The count starts with 1.
-     *             * A return value of ExtendedDialog.DialogClosedOtherwise means the dialog has been closed otherwise.
+     * Retrieve the user choice after the dialog has been closed.
+     * 
+     * @return <ul> <li>The selected button. The count starts with 1.</li>
+     *              <li>A return value of {@link #DialogClosedOtherwise} means the dialog has been closed otherwise.</li>
+     *         </ul>
      */
     public int getValue() {
@@ -283,5 +286,5 @@
 
     /**
-     * This is called by showDialog().
+     * This is called by {@link #showDialog()}.
      * Only invoke from outside if you need to modify the contentPane
      */
@@ -402,4 +405,5 @@
     /**
      * This gets performed whenever a button is clicked or activated
+     * @param buttonIndex the button index (first index is 0)
      * @param evt the button event
      */
@@ -574,5 +578,5 @@
     /**
      * This function checks the state of the "Do not show again" checkbox and
-     * writes the corresponding pref
+     * writes the corresponding pref.
      */
     private void toggleSaveState() {
Index: trunk/src/org/openstreetmap/josm/gui/FileDrop.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/FileDrop.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/gui/FileDrop.java	(revision 5275)
@@ -134,5 +134,4 @@
      *
      * @param out PrintStream to record debugging info or null for no debugging.
-     * @param out
      * @param c Component on which files will be dropped.
      * @param listener Listens for <tt>filesDropped</tt>.
@@ -161,5 +160,4 @@
      *
      * @param out PrintStream to record debugging info or null for no debugging.
-     * @param out
      * @param c Component on which files will be dropped.
      * @param recursive Recursively set children as drop targets.
Index: trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListDialog.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListDialog.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListDialog.java	(revision 5275)
@@ -42,4 +42,5 @@
 import javax.swing.event.ChangeEvent;
 import javax.swing.event.ChangeListener;
+import javax.swing.event.ListDataEvent;
 import javax.swing.event.ListSelectionEvent;
 import javax.swing.event.ListSelectionListener;
Index: trunk/src/org/openstreetmap/josm/gui/layer/OsmDataLayer.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/layer/OsmDataLayer.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/gui/layer/OsmDataLayer.java	(revision 5275)
@@ -84,5 +84,5 @@
 
 /**
- * A layer holding data from a specific dataset.
+ * A layer that holds OSM data from a specific dataset.
  * The data can be fully edited.
  *
Index: trunk/src/org/openstreetmap/josm/gui/mappaint/StyleSource.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/mappaint/StyleSource.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/gui/mappaint/StyleSource.java	(revision 5275)
@@ -89,5 +89,5 @@
         else
             return ImageProvider.overlay(getSourceIcon(),
-                    "dialogs/mappaint/error_small",
+                    ImageProvider.get("dialogs/mappaint/error_small"),
                     ImageProvider.OverlayPosition.SOUTHEAST);
     }
Index: trunk/src/org/openstreetmap/josm/tools/GBC.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/GBC.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/tools/GBC.java	(revision 5275)
@@ -98,5 +98,5 @@
     /**
      * Specifies how to distribute extra horizontal space.
-     * @param weidhtx   Weight in horizontal direction
+     * @param weightx   Weight in horizontal direction
      * @param weighty   Weight in vertical direction
      * @return This constraint for chaining.
@@ -114,4 +114,5 @@
      * @param y If higher than 0, this will be a vertical glue with y as minimum
      *      vertical strut.
+     * @return the glue component
      */
     public static Component glue(int x, int y) {
Index: trunk/src/org/openstreetmap/josm/tools/Geometry.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/Geometry.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/tools/Geometry.java	(revision 5275)
@@ -32,9 +32,16 @@
 
     /**
-     * Will find all intersection and add nodes there for list of given ways. Handles self-intersections too.
-     * And make commands to add the intersection points to ways.
-     * @param List<Way> - a list of ways to test
-     * @return ArrayList<Node> List of new nodes
+     * Will find all intersection and add nodes there for list of given ways.
+     * Handles self-intersections too.
+     * And makes commands to add the intersection points to ways.
+     *
      * Prerequisite: no two nodes have the same coordinates.
+     * 
+     * @param ways  a list of ways to test
+     * @param test  if false, do not build list of Commands, just return nodes
+     * @param cmds  list of commands, typically empty when handed to this method.
+     *              Will be filled with commands that add intersection nodes to
+     *              the ways.
+     * @return list of new nodes
      */
     public static Set<Node> addIntersections(List<Way> ways, boolean test, List<Command> cmds) {
@@ -472,6 +479,14 @@
 
     /**
-     * returns area of a closed way in square meters
+     * Returns area of a closed way in square meters.
      * (approximate(?), but should be OK for small areas)
+     *
+     * Relies on the current projection: Works correctly, when
+     * one unit in projected coordinates corresponds to one meter.
+     * This is true for most projections, but not for WGS84 and
+     * Mercator (EPSG:3857).
+     *
+     * @param way Way to measure, should be closed (first node is the same as last node)
+     * @return area of the closed way.
      */
     public static double closedWayArea(Way way) {
@@ -532,8 +547,9 @@
      * If the area is negative the way is ordered in a clockwise direction.
      *
+     * See http://paulbourke.net/geometry/polyarea/
+     *
      * @param w the way to be checked.
      * @return true if and only if way is oriented clockwise.
      * @throws IllegalArgumentException if way is not closed (see {@link Way#isClosed}).
-     * @see http://paulbourke.net/geometry/polyarea/
      */
     public static boolean isClockwise(Way w) {
Index: trunk/src/org/openstreetmap/josm/tools/ImageProvider.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/ImageProvider.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/tools/ImageProvider.java	(revision 5275)
@@ -115,6 +115,6 @@
 
     /**
-     * @param subdir    Subdirectory the image lies in.
-     * @param name      The name of the image. If it does not end with '.png' or '.svg',
+     * @param subdir    subdirectory the image lies in
+     * @param name      the name of the image. If it does not end with '.png' or '.svg',
      *                  both extensions are tried.
      */
@@ -137,5 +137,7 @@
 
     /**
-     * An id used for caching. Id is not used for cache if name starts with http://. (URL is unique anyway.)
+     * Set an id used for caching.
+     * If name starts with <tt>http://</tt> Id is not used for the cache.
+     * (A URL is unique anyway.)
      */
     public ImageProvider setId(String id) {
@@ -145,5 +147,7 @@
 
     /**
-     * A zip file where the image is located.
+     * Specify a zip file where the image is located.
+     *
+     * (optional)
      */
     public ImageProvider setArchive(File archive) {
@@ -153,5 +157,5 @@
 
     /**
-     * The dimensions of the image.
+     * Set the dimensions of the image.
      *
      * If not specified, the original size of the image is used.
@@ -166,5 +170,5 @@
 
     /**
-     * see setSize
+     * @see #setSize
      */
     public ImageProvider setWidth(int width) {
@@ -174,5 +178,5 @@
 
     /**
-     * see setSize
+     * @see #setSize
      */
     public ImageProvider setHeight(int height) {
@@ -182,5 +186,5 @@
 
     /**
-     * The maximum size of the image.
+     * Limit the maximum size of the image.
      *
      * It will shrink the image if necessary, but keep the aspect ratio.
@@ -196,5 +200,5 @@
 
     /**
-     * see setMaxSize
+     * @see #setMaxSize
      */
     public ImageProvider setMaxWidth(int maxWidth) {
@@ -204,5 +208,5 @@
 
     /**
-     * see setMaxSize
+     * @see #setMaxSize
      */
     public ImageProvider setMaxHeight(int maxHeight) {
@@ -212,7 +216,11 @@
 
     /**
-     * The image URL comes from user data and the image may be missing.
-     *
-     * Set true, if JOSM should *not* throw a RuntimeException in case the image cannot be located.
+     * Decide, if an exception should be thrown, when the image cannot be located.
+     *
+     * Set to true, when the image URL comes from user data and the image may be missing.
+     *
+     * @param optional true, if JOSM should <b>not</b> throw a RuntimeException
+     * in case the image cannot be located.
+     * @return the current object, for convenience
      */
     public ImageProvider setOptional(boolean optional) {
@@ -241,4 +249,5 @@
     /**
      * Execute the image request.
+     * @return the requested image or null if the request failed
      */
     public ImageIcon get() {
@@ -267,9 +276,8 @@
      * asynchronously.
      *
-     * @param callback is called, when the image is ready. This can happen
-     * before the call to getInBackground returns or it may be invoked some
-     * time (seconds) later.
-     * If no image is available, a null value is returned to callback (just
-     * like ImageProvider.get).
+     * @param callback a callback. It is called, when the image is ready.
+     * This can happen before the call to this method returns or it may be
+     * invoked some time (seconds) later. If no image is available, a null 
+     * value is returned to callback (just like {@link #get}).
      */
     public void getInBackground(final ImageCallback callback) {
@@ -290,10 +298,10 @@
 
     /**
-     * Return an image from the specified location. Throws a RuntimeException if
-     * the image cannot be located.
-     *
-     * @param subdir The position of the directory, e.g. 'layer'
-     * @param name The icons name (with or without '.png' or '.svg' extension)
+     * Load an image with a given file name.
+     *
+     * @param subdir subdirectory the image lies in
+     * @param name The icon name (base name with or without '.png' or '.svg' extension)
      * @return The requested Image.
+     * @throws RuntimeException if the image cannot be located
      */
     public static ImageIcon get(String subdir, String name) {
@@ -301,14 +309,25 @@
     }
 
+    /**
+     * @see #get(java.lang.String, java.lang.String)
+     */
     public static ImageIcon get(String name) {
         return new ImageProvider(name).get();
     }
 
+    /**
+     * Load an image with a given file name, but do not throw an exception
+     * when the image cannot be found.
+     * @see #get(java.lang.String, java.lang.String)
+     */
+    public static ImageIcon getIfAvailable(String subdir, String name) {
+        return new ImageProvider(subdir, name).setOptional(true).get();
+    }
+
+    /**
+     * @see #getIfAvailable(java.lang.String, java.lang.String) 
+     */
     public static ImageIcon getIfAvailable(String name) {
         return new ImageProvider(name).setOptional(true).get();
-    }
-
-    public static ImageIcon getIfAvailable(String subdir, String name) {
-        return new ImageProvider(subdir, name).setOptional(true).get();
     }
 
@@ -691,5 +710,5 @@
         ImageIcon img = get("cursor", name);
         if (overlay != null) {
-            img = overlay(img, "cursor/modifier/" + overlay, OverlayPosition.SOUTHEAST);
+            img = overlay(img, ImageProvider.get("cursor/modifier/" + overlay), OverlayPosition.SOUTHEAST);
         }
         Cursor c = Toolkit.getDefaultToolkit().createCustomCursor(img.getImage(),
@@ -698,12 +717,19 @@
     }
 
-    /**
+    @Deprecated
+    public static ImageIcon overlay(Icon ground, String overlayImage, OverlayPosition pos) {
+        return overlay(ground, ImageProvider.get(overlayImage), pos);
+    }
+
+    /**
+     * Decorate one icon with an overlay icon.
+     *
+     * @param ground the base image
+     * @param overlay the overlay image (can be smaller than the base image)
+     * @param pos position of the overlay image inside the base image (positioned
+     * in one of the corners)
      * @return an icon that represent the overlay of the two given icons. The second icon is layed
      * on the first relative to the given position.
      */
-    public static ImageIcon overlay(Icon ground, String overlayImage, OverlayPosition pos) {
-        return overlay(ground, ImageProvider.get(overlayImage), pos);
-    }
-
     public static ImageIcon overlay(Icon ground, Icon overlay, OverlayPosition pos) {
         GraphicsConfiguration conf = GraphicsEnvironment.getLocalGraphicsEnvironment().getDefaultScreenDevice()
@@ -739,8 +765,5 @@
     }
 
-    /*
-     * from: http://www.jidesoft.com/blog/2008/02/29/rotate-an-icon-in-java/ License:
-     * "feel free to use"
-     */
+    /** 90 degrees in radians units */
     final static double DEGREE_90 = 90.0 * Math.PI / 180.0;
 
@@ -750,5 +773,5 @@
      * @param c The component to get properties useful for painting, e.g. the foreground or
      * background color.
-     * @param icon the image to be rotated.
+     * @param img the image to be rotated.
      * @param rotatedAngle the rotated angle, in degree, clockwise. It could be any double but we
      * will mod it with 360 before using it.
@@ -811,5 +834,5 @@
      * @return the icon
      */
-    public static ImageIcon get(OsmPrimitiveType type) throws IllegalArgumentException {
+    public static ImageIcon get(OsmPrimitiveType type) {
         CheckParameterUtil.ensureParameterNotNull(type, "type");
         return get("data", type.getAPIName());
Index: trunk/src/org/openstreetmap/josm/tools/LanguageInfo.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/LanguageInfo.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/tools/LanguageInfo.java	(revision 5275)
@@ -2,6 +2,7 @@
 package org.openstreetmap.josm.tools;
 
+import static org.openstreetmap.josm.tools.I18n.tr;
+
 import java.util.Locale;
-import static org.openstreetmap.josm.tools.I18n.tr;
 
 public class LanguageInfo {
@@ -81,5 +82,5 @@
      * In most cases JOSM and Java uses the same codes, but for some exceptions this is needed.
      *
-     * @param code the locale code.
+     * @param localeName the locale code.
      * @return the resulting locale
      */
Index: trunk/src/org/openstreetmap/josm/tools/WikiReader.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/WikiReader.java	(revision 5272)
+++ trunk/src/org/openstreetmap/josm/tools/WikiReader.java	(revision 5275)
@@ -33,5 +33,4 @@
      * pathes etc..
      *
-     * @return
      * @throws IOException Throws, if the page could not be loaded.
      */
