Index: trunk/src/org/openstreetmap/josm/data/osm/Filter.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/Filter.java	(revision 9112)
+++ trunk/src/org/openstreetmap/josm/data/osm/Filter.java	(revision 9113)
@@ -8,5 +8,6 @@
 
 /**
- *
+ * Data class representing one entry in the filter dialog.
+ * 
  * @author Petr_Dlouhý
  */
Index: trunk/src/org/openstreetmap/josm/data/osm/FilterWorker.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/FilterWorker.java	(revision 9112)
+++ trunk/src/org/openstreetmap/josm/data/osm/FilterWorker.java	(revision 9113)
@@ -9,5 +9,8 @@
 
 /**
- *
+ * Class for applying {@link Filter}s to {@link OsmPrimitive}s.
+ * 
+ * Provides a bridge between Filter GUI and the data.
+ * 
  * @author Petr_Dlouhý
  */
@@ -58,8 +61,20 @@
     }
 
+    /**
+     * Apply the filters to a single primitive.
+     * 
+     * @param primitive the primitive 
+     * @param filterMatcher the FilterMatcher
+     * @return true, if the filter state (normal / disabled / hidden)
+     * of the primitive has changed in the process
+     */
     public static boolean executeFilters(OsmPrimitive primitive, FilterMatcher filterMatcher) {
         return doExecuteFilters(Collections.singleton(primitive), filterMatcher);
     }
 
+    /**
+     * Clear all filter flags, i.e. turn off filters.
+     * @param prims the primitives
+     */
     public static void clearFilterFlags(Collection<OsmPrimitive> prims) {
         for (OsmPrimitive osm : prims) {