Index: CHANGES.txt
===================================================================
--- CHANGES.txt	(revision 617963)
+++ CHANGES.txt	(working copy)
@@ -18,7 +18,11 @@
 	
  3. LUCENE-584: Changed Filter API to return a DocIdSet instead of a
     java.util.BitSet. This allows using more efficient data structures
-    for Filters and makes them more flexible. (Paul Elschot, Michael Busch)
+    for Filters and makes them more flexible. This deprecates
+    Filter.bits(), so all filters that implement this outside
+    the Lucene code base will need to be adapted. See also the javadocs
+    of the Filter class.
+    (Paul Elschot, Michael Busch)
 
 Bug fixes