Index: trunk/src/org/openstreetmap/josm/io/NameFinder.java
===================================================================
--- trunk/src/org/openstreetmap/josm/io/NameFinder.java	(revision 11015)
+++ trunk/src/org/openstreetmap/josm/io/NameFinder.java	(revision 11016)
@@ -7,4 +7,5 @@
 import java.io.Reader;
 import java.net.URL;
+import java.util.Collections;
 import java.util.LinkedList;
 import java.util.List;
@@ -40,8 +41,20 @@
     }
 
+    /**
+     * Performs a Nominatim search.
+     * @param searchExpression Nominatim search expression
+     * @return search results
+     * @throws IOException if any IO error occurs.
+     */
     public static List<SearchResult> queryNominatim(final String searchExpression) throws IOException {
         return query(new URL(NOMINATIM_URL + Utils.encodeUrl(searchExpression)));
     }
 
+    /**
+     * Performs a custom search.
+     * @param url search URL to any Nominatim instance
+     * @return search results
+     * @throws IOException if any IO error occurs.
+     */
     public static List<SearchResult> query(final URL url) throws IOException {
         final HttpClient connection = HttpClient.create(url);
@@ -54,4 +67,12 @@
     }
 
+    /**
+     * Parse search results as returned by Nominatim.
+     * @param reader reader
+     * @return search results
+     * @throws ParserConfigurationException if a parser cannot be created which satisfies the requested configuration.
+     * @throws SAXException for SAX errors.
+     * @throws IOException if any IO error occurs.
+     */
     public static List<SearchResult> parseSearchResults(Reader reader) throws IOException, ParserConfigurationException, SAXException {
         InputSource inputSource = new InputSource(reader);
@@ -249,5 +270,5 @@
 
         public List<SearchResult> getResult() {
-            return data;
+            return Collections.unmodifiableList(data);
         }
     }