Index: trunk/src/org/openstreetmap/josm/actions/search/SearchAction.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/search/SearchAction.java	(revision 12333)
+++ trunk/src/org/openstreetmap/josm/actions/search/SearchAction.java	(revision 12334)
@@ -29,4 +29,6 @@
 import java.util.function.Predicate;
 
+import javax.swing.BorderFactory;
+import javax.swing.ButtonGroup;
 import javax.swing.JCheckBox;
 import javax.swing.JLabel;
@@ -36,6 +38,4 @@
 import javax.swing.text.BadLocationException;
 import javax.swing.text.JTextComponent;
-import javax.swing.BorderFactory;
-import javax.swing.ButtonGroup;
 
 import org.openstreetmap.josm.Main;
@@ -61,8 +61,18 @@
 import org.openstreetmap.josm.tools.Utils;
 
+/**
+ * The search action allows the user to search the data layer using a complex search string.
+ *
+ * @see SearchCompiler
+ */
 public class SearchAction extends JosmAction implements ParameterizedAction {
 
+    /**
+     * The default size of the search history
+     */
     public static final int DEFAULT_SEARCH_HISTORY_SIZE = 15;
-    /** Maximum number of characters before the search expression is shortened for display purposes. */
+    /**
+     * Maximum number of characters before the search expression is shortened for display purposes.
+     */
     public static final int MAX_LENGTH_SEARCH_EXPRESSION_DISPLAY = 100;
 
@@ -120,8 +130,16 @@
     }
 
+    /**
+     * Gets the search history
+     * @return The last searched terms. Do not modify it.
+     */
     public static Collection<SearchSetting> getSearchHistory() {
         return searchHistory;
     }
 
+    /**
+     * Saves a search to the search history.
+     * @param s The search to save
+     */
     public static void saveToHistory(SearchSetting s) {
         if (searchHistory.isEmpty() || !s.equals(searchHistory.getFirst())) {
@@ -143,4 +161,8 @@
     }
 
+    /**
+     * Gets a list of all texts that were recently used in the search
+     * @return The list of search texts.
+     */
     public static List<String> getSearchExpressionHistory() {
         List<String> ret = new ArrayList<>(getSearchHistory().size());