Index: trunk/src/org/openstreetmap/josm/gui/oauth/AuthorizationProcedure.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/oauth/AuthorizationProcedure.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/gui/oauth/AuthorizationProcedure.java	(revision 12646)
@@ -2,4 +2,7 @@
 package org.openstreetmap.josm.gui.oauth;
 
+/**
+ * The type of procedure to use for retrieving OAuth credentials.
+ */
 public enum AuthorizationProcedure {
     /**
Index: trunk/src/org/openstreetmap/josm/gui/oauth/AuthorizationProcedureComboBox.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/oauth/AuthorizationProcedureComboBox.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/gui/oauth/AuthorizationProcedureComboBox.java	(revision 12646)
@@ -13,4 +13,7 @@
 import org.openstreetmap.josm.gui.widgets.JosmComboBox;
 
+/**
+ * Combo box that lets the user choose one of the avaliable {@link AuthorizationProcedure}s.
+ */
 public class AuthorizationProcedureComboBox extends JosmComboBox<AuthorizationProcedure> {
 
Index: trunk/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticPropertiesPanel.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticPropertiesPanel.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticPropertiesPanel.java	(revision 12646)
@@ -17,4 +17,10 @@
 import org.openstreetmap.josm.gui.widgets.SelectAllOnFocusGainedDecorator;
 
+/**
+ * Panel to enter username and password for the "fully automatic" authorization
+ * procedure.
+ * 
+ * @see AuthorizationProcedure#FULLY_AUTOMATIC
+ */
 public class FullyAutomaticPropertiesPanel extends JPanel {
 
Index: trunk/src/org/openstreetmap/josm/gui/oauth/OsmPrivilegesPanel.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/oauth/OsmPrivilegesPanel.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/gui/oauth/OsmPrivilegesPanel.java	(revision 12646)
@@ -15,4 +15,8 @@
 import org.openstreetmap.josm.gui.widgets.VerticallyScrollablePanel;
 
+/**
+ * Panel letting the user choose from a detailed list of privileges that will be 
+ * requested for the OAuth token.
+ */
 public class OsmPrivilegesPanel extends VerticallyScrollablePanel {
 
Index: trunk/src/org/openstreetmap/josm/gui/tagging/presets/TaggingPresetLabel.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/tagging/presets/TaggingPresetLabel.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/gui/tagging/presets/TaggingPresetLabel.java	(revision 12646)
@@ -11,4 +11,10 @@
 import javax.swing.JLabel;
 
+/**
+ * A hyperlink {@link JLabel}.
+ * 
+ * To indicate that the user can click on the text, it displays an appropriate
+ * mouse cursor and dotted underline when the mouse is inside the hover area.
+ */
 public class TaggingPresetLabel extends JLabel {
 
Index: trunk/src/org/openstreetmap/josm/gui/tagging/presets/TaggingPresetMenu.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/tagging/presets/TaggingPresetMenu.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/gui/tagging/presets/TaggingPresetMenu.java	(revision 12646)
@@ -25,4 +25,9 @@
 import org.openstreetmap.josm.tools.AlphanumComparator;
 
+/**
+ * Menu that groups several presets from one topic.
+ * <p>
+ * Used, to create the nested directory structure in the preset main menu entry.
+ */
 public class TaggingPresetMenu extends TaggingPreset {
     public JMenu menu; // set by TaggingPresets
Index: trunk/src/org/openstreetmap/josm/io/auth/AbstractCredentialsAgent.java
===================================================================
--- trunk/src/org/openstreetmap/josm/io/auth/AbstractCredentialsAgent.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/io/auth/AbstractCredentialsAgent.java	(revision 12646)
@@ -11,4 +11,10 @@
 import org.openstreetmap.josm.gui.util.GuiHelper;
 
+/**
+ * Partial implementation of the {@link CredentialsAgent} interface.
+ * <p>
+ * Provides a memory cache for the credentials and means to query the information 
+ * from the user.
+ */
 public abstract class AbstractCredentialsAgent implements CredentialsAgent {
 
Index: trunk/src/org/openstreetmap/josm/io/auth/CredentialsAgentException.java
===================================================================
--- trunk/src/org/openstreetmap/josm/io/auth/CredentialsAgentException.java	(revision 12645)
+++ trunk/src/org/openstreetmap/josm/io/auth/CredentialsAgentException.java	(revision 12646)
@@ -2,4 +2,11 @@
 package org.openstreetmap.josm.io.auth;
 
+/**
+ * Exception thrown for errors while handling credentials.
+ * <p>
+ * Missing credentials and discarded password dialog are not considered an error.
+ * At time of writing, methods return <code>null</code> in this case.
+ * @see CredentialsAgent
+ */
 public class CredentialsAgentException extends Exception {