Removed deprecated use_statcache argument.
authorRaymond Hettinger <python@rcn.com>
Sun, 5 Dec 2004 01:58:09 +0000 (01:58 +0000)
committerRaymond Hettinger <python@rcn.com>
Sun, 5 Dec 2004 01:58:09 +0000 (01:58 +0000)
Doc/lib/libfilecmp.tex
Lib/filecmp.py
Misc/NEWS

index 7747c8cac1f9e65da82a9c4f13b0eed660daa1b7..edc3aad5c36dc027be4f5a4d153ea85881307087 100644 (file)
@@ -11,13 +11,12 @@ directories, with various optional time/correctness trade-offs.
 
 The \module{filecmp} module defines the following functions:
 
-\begin{funcdesc}{cmp}{f1, f2\optional{, shallow\optional{, use_statcache}}}
+\begin{funcdesc}{cmp}{f1, f2\optional{, shallow}}
 Compare the files named \var{f1} and \var{f2}, returning \code{True} if
 they seem equal, \code{False} otherwise.
 
 Unless \var{shallow} is given and is false, files with identical
 \function{os.stat()} signatures are taken to be equal.
-\versionchanged[\var{use_statcache} is obsolete and ignored.]{2.3}
 
 Files that were compared using this function will not be compared again
 unless their \function{os.stat()} signature changes.
@@ -27,7 +26,7 @@ portability and efficiency.
 \end{funcdesc}
 
 \begin{funcdesc}{cmpfiles}{dir1, dir2, common\optional{,
-                           shallow\optional{, use_statcache}}}
+                           shallow}}
 Returns three lists of file names: \var{match}, \var{mismatch},
 \var{errors}.  \var{match} contains the list of files match in both
 directories, \var{mismatch} includes the names of those that don't,
@@ -37,8 +36,8 @@ lack permission to read them or many other reasons, but always that
 the comparison could not be done for some reason.
 
 The \var{common} parameter is a list of file names found in both directories.
-The \var{shallow} and \var{use_statcache} parameters have the same
-meanings and default values as for \function{filecmp.cmp()}.
+The \var{shallow} parameter has the same
+meaning and default value as for \function{filecmp.cmp()}.
 \end{funcdesc}
 
 Example:
index 089c6674969ae3d83a30f7378641052fe616058e..35cedef6b8ab10c2ded1ac48ae2d9f80cc9abfb8 100644 (file)
@@ -19,7 +19,7 @@ __all__ = ["cmp","dircmp","cmpfiles"]
 _cache = {}
 BUFSIZE=8*1024
 
-def cmp(f1, f2, shallow=1, use_statcache=None):
+def cmp(f1, f2, shallow=1):
     """Compare two files.
 
     Arguments:
@@ -31,8 +31,6 @@ def cmp(f1, f2, shallow=1, use_statcache=None):
     shallow -- Just check stat signature (do not read the files).
                defaults to 1.
 
-    use_statcache -- obsolete argument.
-
     Return value:
 
     True if the files are the same, False otherwise.
@@ -41,9 +39,6 @@ def cmp(f1, f2, shallow=1, use_statcache=None):
     with a cache invalidation mechanism relying on stale signatures.
 
     """
-    if use_statcache is not None:
-        warnings.warn("use_statcache argument is deprecated",
-                      DeprecationWarning)
 
     s1 = _sig(os.stat(f1))
     s2 = _sig(os.stat(f2))
@@ -244,13 +239,12 @@ class dircmp:
         self.methodmap[attr](self)
         return getattr(self, attr)
 
-def cmpfiles(a, b, common, shallow=1, use_statcache=None):
+def cmpfiles(a, b, common, shallow=1):
     """Compare common files in two directories.
 
     a, b -- directory names
     common -- list of file names found in both directories
     shallow -- if true, do comparison based solely on stat() information
-    use_statcache -- obsolete argument
 
     Returns a tuple of three lists:
       files that compare equal
@@ -258,9 +252,6 @@ def cmpfiles(a, b, common, shallow=1, use_statcache=None):
       filenames that aren't regular files.
 
     """
-    if use_statcache is not None:
-        warnings.warn("use_statcache argument is deprecated",
-                      DeprecationWarning)
     res = ([], [], [])
     for x in common:
         ax = os.path.join(a, x)
index b20b872a452ea221f57761f890477b4ad2c435e4..63c89d236bdd73580078f85be8d8a66b3317522c 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -21,6 +21,8 @@ Extension Modules
 Library
 -------
 
+- the filecmp module no longer uses the deprecated use_statcache argument.
+
 - unittest.TestCase.run() and unittest.TestSuite.run() can now be successfully
   extended or overridden by subclasses.  Formerly, the subclassed method would
   be ignored by the rest of the module.  (Bug #1078905).