Index: trunk/src/org/openstreetmap/josm/actions/CloseChangesetAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/CloseChangesetAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/CloseChangesetAction.java	(revision 12581)
@@ -30,4 +30,10 @@
 import org.xml.sax.SAXException;
 
+/**
+ * User action to close open changesets.
+ *
+ * The list of open changesets will be downloaded from the server and presented
+ * to the user.
+ */
 public class CloseChangesetAction extends JosmAction {
 
Index: trunk/src/org/openstreetmap/josm/actions/CopyCoordinatesAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/CopyCoordinatesAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/CopyCoordinatesAction.java	(revision 12581)
@@ -15,4 +15,7 @@
 import org.openstreetmap.josm.tools.Shortcut;
 
+/**
+ * User action to copy the coordinates of one or several node(s) to the clipboard.
+ */
 public class CopyCoordinatesAction extends JosmAction {
 
Index: trunk/src/org/openstreetmap/josm/actions/PreferenceToggleAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/PreferenceToggleAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/PreferenceToggleAction.java	(revision 12581)
@@ -9,4 +9,10 @@
 import org.openstreetmap.josm.data.preferences.BooleanProperty;
 
+/**
+ * User action to toggle a custom boolean preference value.
+ *
+ * A user action will just change a preference value. To take any real action,
+ * register another {@link PreferenceChangedListener} for the given preference key.
+ */
 public class PreferenceToggleAction extends JosmAction implements PreferenceChangedListener {
 
@@ -14,4 +20,11 @@
     private final BooleanProperty pref;
 
+    /**
+     * Create a new PreferenceToggleAction.
+     * @param name the (translated) title
+     * @param tooltip tooltip text
+     * @param prefKey the preference key to toggle
+     * @param prefDefault default value for the preference entry
+     */
     public PreferenceToggleAction(String name, String tooltip, String prefKey, boolean prefDefault) {
         super(name, null, tooltip, null, false);
Index: trunk/src/org/openstreetmap/josm/actions/SelectAllAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/SelectAllAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/SelectAllAction.java	(revision 12581)
@@ -12,4 +12,7 @@
 import org.openstreetmap.josm.tools.Shortcut;
 
+/**
+ * User action to select all primitives in the current dataset.
+ */
 public class SelectAllAction extends JosmAction {
 
Index: trunk/src/org/openstreetmap/josm/actions/ShowStatusReportAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/ShowStatusReportAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/ShowStatusReportAction.java	(revision 12581)
@@ -44,8 +44,8 @@
 
 /**
+ * Opens a dialog with useful status information like version numbers for Java, JOSM and plugins
+ * Also includes preferences with stripped username and password.
+ *
  * @author xeen
- *
- * Opens a dialog with useful status information like version numbers for Java, JOSM and plugins
- * Also includes preferences with stripped username and password
  */
 public final class ShowStatusReportAction extends JosmAction {
Index: trunk/src/org/openstreetmap/josm/actions/UnselectAllAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/UnselectAllAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/UnselectAllAction.java	(revision 12581)
@@ -10,4 +10,7 @@
 import org.openstreetmap.josm.tools.Shortcut;
 
+/**
+ * User action to clear the current selection.
+ */
 public class UnselectAllAction extends JosmAction {
 
Index: trunk/src/org/openstreetmap/josm/actions/UpdateDataAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/UpdateDataAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/UpdateDataAction.java	(revision 12581)
@@ -20,4 +20,10 @@
 import org.openstreetmap.josm.tools.Shortcut;
 
+/**
+ * This action synchronizes the dataset with the current state on the server.
+ *
+ * It does so by re-downloading all areas and thereby merging all compatible
+ * changes from the current server version.
+ */
 public class UpdateDataAction extends JosmAction {
 
Index: trunk/src/org/openstreetmap/josm/actions/ZoomToAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/ZoomToAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/ZoomToAction.java	(revision 12581)
@@ -26,5 +26,5 @@
 
 /**
- * An action that zooms to the selected OSM primitive in a table of primitives
+ * An action that zooms to the selected OSM primitive in a table of primitives.
  */
 public class ZoomToAction extends AbstractAction implements LayerChangeListener, ActiveLayerChangeListener, ListSelectionListener {
Index: trunk/src/org/openstreetmap/josm/actions/mapmode/DrawSnapHelper.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/mapmode/DrawSnapHelper.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/mapmode/DrawSnapHelper.java	(revision 12581)
@@ -32,4 +32,11 @@
 import org.openstreetmap.josm.tools.Utils;
 
+/**
+ * Class that enables the user to draw way segments in angles of exactly 30, 45,
+ * 60, 90 degrees.
+ *
+ * With enabled snapping, the new way node will be projected onto the helper line
+ * that indicates a certain fixed angle relative to the previous segment.
+ */
 class DrawSnapHelper {
 
Index: trunk/src/org/openstreetmap/josm/actions/mapmode/ImproveWayAccuracyAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/mapmode/ImproveWayAccuracyAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/mapmode/ImproveWayAccuracyAction.java	(revision 12581)
@@ -52,4 +52,7 @@
 
 /**
+ * A special map mode that is optimized for improving way geometry.
+ * (by efficiently moving, adding and deleting way-nodes)
+ *
  * @author Alexander Kachkaev <alexander@kachkaev.ru>, 2011
  */
Index: trunk/src/org/openstreetmap/josm/actions/mapmode/ParallelWayAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/mapmode/ParallelWayAction.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/mapmode/ParallelWayAction.java	(revision 12581)
@@ -53,6 +53,11 @@
 import org.openstreetmap.josm.tools.Shortcut;
 
-//// TODO: (list below)
-/* == Functionality ==
+/**
+ * MapMode for making parallel ways.
+ *
+ * All calculations are done in projected coordinates.
+ *
+ * TODO:
+ * == Functionality ==
  *
  * 1. Use selected nodes as split points for the selected ways.
@@ -81,10 +86,4 @@
  * Current code doesn't not take into account that ways might been highlighted
  * by other than us. Don't think that situation should ever happen though.
- */
-
-/**
- * MapMode for making parallel ways.
- *
- * All calculations are done in projected coordinates.
  *
  * @author Ole Jørgen Brønner (olejorgenb)
Index: trunk/src/org/openstreetmap/josm/actions/upload/ApiPreconditionCheckerHook.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/upload/ApiPreconditionCheckerHook.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/upload/ApiPreconditionCheckerHook.java	(revision 12581)
@@ -20,4 +20,8 @@
 import org.openstreetmap.josm.io.OsmTransferCanceledException;
 
+/**
+ * Checks certain basic conditions, that are listed in the OSM API
+ * {@link org.openstreetmap.josm.io.Capabilities}.
+ */
 public class ApiPreconditionCheckerHook implements UploadHook {
 
Index: trunk/src/org/openstreetmap/josm/actions/upload/UploadHook.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/upload/UploadHook.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/actions/upload/UploadHook.java	(revision 12581)
@@ -4,4 +4,9 @@
 import org.openstreetmap.josm.data.APIDataSet;
 
+/**
+ * A check right before the upload. The UploadHook may modify the uploaded data
+ * silently, it may display a warning message to the user or prevent the upload
+ * altogether.
+ */
 @FunctionalInterface
 public interface UploadHook {
Index: trunk/src/org/openstreetmap/josm/command/ScaleCommand.java
===================================================================
--- trunk/src/org/openstreetmap/josm/command/ScaleCommand.java	(revision 12580)
+++ trunk/src/org/openstreetmap/josm/command/ScaleCommand.java	(revision 12581)
@@ -11,4 +11,8 @@
 import org.openstreetmap.josm.data.osm.OsmPrimitive;
 
+/**
+ * Command, to scale a given set of primitives.
+ * The relative distance of the nodes will be increased/decreased.
+ */
 public class ScaleCommand extends TransformNodesCommand {
     /**