whatsnew: filecmp.clear_cache, and reword description of cache in docs.
diff --git a/Lib/filecmp.py b/Lib/filecmp.py
index 3285288..dd5a2af 100644
--- a/Lib/filecmp.py
+++ b/Lib/filecmp.py
@@ -43,8 +43,8 @@
     True if the files are the same, False otherwise.
 
     This function uses a cache for past comparisons and the results,
-    with a cache invalidation mechanism relying on stale signatures
-    or by explicitly calling clear_cache().
+    with cache entries invalidated if their stat information
+    changes.  The cache may be cleared by calling clear_cache().
 
     """