Index: /trunk/src/org/openstreetmap/josm/actions/ReverseWayAction.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/actions/ReverseWayAction.java	(revision 12209)
+++ /trunk/src/org/openstreetmap/josm/actions/ReverseWayAction.java	(revision 12210)
@@ -29,6 +29,12 @@
 import org.openstreetmap.josm.tools.UserCancelException;
 
+/**
+ * Reverses the ways that are currently selected by the user
+ */
 public final class ReverseWayAction extends JosmAction {
 
+    /**
+     * The resulting way after reversing it and the commands to get there.
+     */
     public static class ReverseWayResult {
         private final Way newWay;
@@ -36,4 +42,10 @@
         private final Command reverseCommand;
 
+        /**
+         * Create a new {@link ReverseWayResult}
+         * @param newWay The new way primitive
+         * @param tagCorrectionCommands The commands to correct the tags
+         * @param reverseCommand The command to reverse the way
+         */
         public ReverseWayResult(Way newWay, Collection<Command> tagCorrectionCommands, Command reverseCommand) {
             this.newWay = newWay;
@@ -42,8 +54,16 @@
         }
 
+        /**
+         * Gets the new way object
+         * @return The new, reversed way
+         */
         public Way getNewWay() {
             return newWay;
         }
 
+        /**
+         * Gets the commands that will be required to do a full way reversal including changing the tags
+         * @return The comamnds
+         */
         public Collection<Command> getCommands() {
             List<Command> c = new ArrayList<>();
@@ -53,12 +73,24 @@
         }
 
+        /**
+         * Gets a single sequence command for reversing this way including changing the tags
+         * @return the command
+         */
         public Command getAsSequenceCommand() {
             return new SequenceCommand(tr("Reverse way"), getCommands());
         }
 
+        /**
+         * Gets the basic reverse command that only changes the order of the nodes.
+         * @return The reorder nodes command
+         */
         public Command getReverseCommand() {
             return reverseCommand;
         }
 
+        /**
+         * Gets the command to change the tags of the way
+         * @return The command to reverse the tags
+         */
         public Collection<Command> getTagCorrectionCommands() {
             return tagCorrectionCommands;
@@ -66,4 +98,7 @@
     }
 
+    /**
+     * Creates a new {@link ReverseWayAction} and binds the shortcut
+     */
     public ReverseWayAction() {
         super(tr("Reverse Ways"), "wayflip", tr("Reverse the direction of all selected ways."),