--- a/mercurial/match.py	Sun May 31 17:54:18 2009 -0500
+++ b/mercurial/match.py	Sun May 31 17:54:18 2009 -0500
@@ -81,6 +81,13 @@
         for f in self._files:
             yield f
     def bad(self, f, msg):
+        '''callback for each explicit file that can't be
+        found/accessed, with an error message
+
+        return True to keep file in results, False to discard
+
+        default behavior is to silently keep
+        '''
         return True
     def dir(self, f):
         pass