Index: /trunk/src/org/openstreetmap/josm/gui/download/DownloadSelection.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/download/DownloadSelection.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/download/DownloadSelection.java	(revision 5899)
@@ -15,5 +15,5 @@
      * the current download area.
      *
-     * @param are the current download area
+     * @param area the current download area
      */
     public void setDownloadArea(Bounds area);
Index: /trunk/src/org/openstreetmap/josm/gui/help/HelpUtil.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/help/HelpUtil.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/help/HelpUtil.java	(revision 5899)
@@ -209,5 +209,5 @@
      * of {@link HelpAction}.
      *
-     * @return
+     * @return instance of help action
      */
     static private Action getHelpAction() {
@@ -227,5 +227,5 @@
      *
      * @param component the component  the component
-     * @param topic the help topic. Set to the default help topic if null.
+     * @param relativeHelpTopic the help topic. Set to the default help topic if null.
      */
     static public void setHelpContext(JComponent component, String relativeHelpTopic) {
Index: /trunk/src/org/openstreetmap/josm/gui/history/HistoryBrowserModel.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/history/HistoryBrowserModel.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/history/HistoryBrowserModel.java	(revision 5899)
@@ -337,6 +337,6 @@
      * in time (see {@link PointInTimeType}).
      *
-     * @param reference the reference history primitive. Must not be null.
-     * @throws IllegalArgumentException thrown if reference is null
+     * @param current the reference history primitive. Must not be {@code null}.
+     * @throws IllegalArgumentException thrown if reference is {@code null}
      * @throws IllegalStateException thrown if this model isn't a assigned a history yet
      * @throws IllegalArgumentException if reference isn't an history primitive for the history managed by this mode
Index: /trunk/src/org/openstreetmap/josm/gui/io/ChangesetManagementPanel.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/io/ChangesetManagementPanel.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/io/ChangesetManagementPanel.java	(revision 5899)
@@ -37,5 +37,5 @@
  * It is displayed as one of the configuration panels in the {@link UploadDialog}.
  *
- * ChangesetManagementPanel is a source for {@link PropertyChangeEvent}s. Clients can listen
+ * ChangesetManagementPanel is a source for {@link java.beans.PropertyChangeEvent}s. Clients can listen
  * to
  * <ul>
Index: /trunk/src/org/openstreetmap/josm/gui/io/FilenameCellEditor.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/io/FilenameCellEditor.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/io/FilenameCellEditor.java	(revision 5899)
@@ -27,7 +27,5 @@
 /**
  * This is a {@link TableCellEditor} for filenames. It provides a text input field and
- * a button for launchinig a {@link JFileChooser}.
- *
- *
+ * a button for launchinig a {@link javax.swing.JFileChooser}.
  */
 class FilenameCellEditor extends JPanel implements TableCellEditor {
Index: /trunk/src/org/openstreetmap/josm/gui/mappaint/ElemStyles.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/mappaint/ElemStyles.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/mappaint/ElemStyles.java	(revision 5899)
@@ -48,6 +48,6 @@
      * @param osm the primitive
      * @param scale the scale (in meters per 100 pixel)
-     * @param nc
-     * @return
+     * @param nc display component
+     * @return list of styles
      */
     public StyleList get(OsmPrimitive osm, double scale, NavigatableComponent nc) {
Index: /trunk/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java	(revision 5899)
@@ -71,5 +71,5 @@
      * Builds the panel with the three privileges the user can grant JOSM
      *
-     * @return
+     * @return constructed panel for the privileges
      */
     protected VerticallyScrollablePanel buildGrantsPanel() {
@@ -81,5 +81,5 @@
      * Builds the panel for entering the username and password
      *
-     * @return
+     * @return constructed panel for the creditentials
      */
     protected VerticallyScrollablePanel buildUserNamePasswordPanel() {
@@ -180,4 +180,5 @@
     /**
      * Initializes the panel with values from the preferences
+     * @param pref Preferences structure
      */
     @Override
@@ -204,5 +205,5 @@
      * Builds the panel with the action button  for starting the authorisation
      *
-     * @return
+     * @return constructed button panel
      */
     protected JPanel buildActionButtonPanel() {
@@ -219,5 +220,5 @@
      * Builds the panel which displays the generated Access Token.
      *
-     * @return
+     * @return constructed panel for the results
      */
     protected JPanel buildResultsPanel() {
Index: /trunk/src/org/openstreetmap/josm/gui/oauth/OAuthAuthorizationWizard.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/oauth/OAuthAuthorizationWizard.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/oauth/OAuthAuthorizationWizard.java	(revision 5899)
@@ -69,5 +69,5 @@
      * Builds the row with the action buttons
      *
-     * @return
+     * @return panel with buttons
      */
     protected JPanel buildButtonRow(){
@@ -89,5 +89,5 @@
      * Builds the panel with general information in the header
      *
-     * @return
+     * @return panel woth information display
      */
     protected JPanel buildHeaderInfoPanel() {
Index: /trunk/src/org/openstreetmap/josm/gui/oauth/RetrieveAccessTokenTask.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/oauth/RetrieveAccessTokenTask.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/oauth/RetrieveAccessTokenTask.java	(revision 5899)
@@ -100,5 +100,5 @@
      * Replies true if the task was canceled.
      *
-     * @return
+     * @return {@code true} if user aborted operation
      */
     public boolean isCanceled() {
Index: /trunk/src/org/openstreetmap/josm/gui/preferences/ServerAccessPreference.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/preferences/ServerAccessPreference.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/preferences/ServerAccessPreference.java	(revision 5899)
@@ -54,5 +54,5 @@
      * Builds the tabbed pane with the server preferences
      *
-     * @return
+     * @return panel with server preferences tabs
      */
     protected JPanel buildTabbedServerPreferences() {
@@ -77,5 +77,5 @@
      * Builds the panel for entering the server access preferences
      *
-     * @return
+     * @return preferences panel for server settings
      */
     protected JPanel buildContentPanel() {
Index: /trunk/src/org/openstreetmap/josm/gui/preferences/server/OAuthAuthenticationPreferencesPanel.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/preferences/server/OAuthAuthenticationPreferencesPanel.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/preferences/server/OAuthAuthenticationPreferencesPanel.java	(revision 5899)
@@ -55,5 +55,5 @@
      * Builds the panel for entering the advanced OAuth parameters
      *
-     * @return
+     * @return panel with advanced settings
      */
     protected JPanel buildAdvancedPropertiesPanel() {
Index: /trunk/src/org/openstreetmap/josm/gui/preferences/server/ProxyPreferencesPanel.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/preferences/server/ProxyPreferencesPanel.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/preferences/server/ProxyPreferencesPanel.java	(revision 5899)
@@ -87,5 +87,5 @@
      * Builds the panel for the HTTP proxy configuration
      *
-     * @return
+     * @return panel with HTTP proxy configuration
      */
     protected JPanel buildHttpProxyConfigurationPanel() {
@@ -163,5 +163,5 @@
      * Builds the panel for the SOCKS proxy configuration
      *
-     * @return
+     * @return panel with SOCKS proxy configuration
      */
     protected JPanel buildSocksProxyConfigurationPanel() {
Index: /trunk/src/org/openstreetmap/josm/gui/tagging/TaggingPresetSearchDialog.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/tagging/TaggingPresetSearchDialog.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/tagging/TaggingPresetSearchDialog.java	(revision 5899)
@@ -343,9 +343,4 @@
     /**
      * Search expression can be in form: "group1/group2/name" where names can contain multiple words
-     *
-     * When groups are given,
-     *
-     *
-     * @param text
      */
     private void filterPresets() {
Index: /trunk/src/org/openstreetmap/josm/gui/widgets/AbstractIdTextField.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/widgets/AbstractIdTextField.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/widgets/AbstractIdTextField.java	(revision 5899)
@@ -29,5 +29,5 @@
      * @param klass The validator class
      * @param columns The number of columns to use to calculate the preferred width
-     * @see JTextField#JTextField(int)
+     * @see JosmTextField#JosmTextField(int)
      */
     public AbstractIdTextField(Class<T> klass, int columns) {
Index: /trunk/src/org/openstreetmap/josm/gui/widgets/AbstractTextComponentValidator.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/widgets/AbstractTextComponentValidator.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/widgets/AbstractTextComponentValidator.java	(revision 5899)
@@ -28,5 +28,5 @@
  *   <li>the content of the text component changes (the validator is a {@link DocumentListener})</li>
  *   <li>the text component loses focus (the validator is a {@link FocusListener})</li>
- *   <li>the text component is a {@link JTextField} and an {@link ActionEvent} is detected</li>
+ *   <li>the text component is a {@link JosmTextField} and an {@link ActionEvent} is detected</li>
  * </ul>
  *
Index: /trunk/src/org/openstreetmap/josm/gui/widgets/TextContextualPopupMenu.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/gui/widgets/TextContextualPopupMenu.java	(revision 5898)
+++ /trunk/src/org/openstreetmap/josm/gui/widgets/TextContextualPopupMenu.java	(revision 5899)
@@ -61,5 +61,5 @@
      * @param component The text component that will display the menu and handle its actions.
      * @return {@code this}
-     * @see #detach(JTextComponent)
+     * @see #detach()
      */
     protected TextContextualPopupMenu attach(JTextComponent component) {