blob: cd4fd6b69261f61005b7dcdf062dabba64802a14 [file] [log] [blame]
Fred Drake64bc94e1999-06-17 15:11:35 +00001\section{\module{cmpcache} ---
2 Efficient file comparisons}
3
4\declaremodule{standard}{cmpcache}
Fred Drake57657bc2000-12-01 15:25:23 +00005\sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}
Fred Drake64bc94e1999-06-17 15:11:35 +00006\modulesynopsis{Compare files very efficiently.}
7
Fred Drake7eaf6821999-10-26 16:31:51 +00008% XXX check version number before release!
9\deprecated{1.5.3}{Use the \module{filecmp} module instead.}
10
Fred Drakede69ae11999-06-17 17:40:52 +000011The \module{cmpcache} module provides an identical interface and similar
12functionality as the \refmodule{cmp} module, but can be a bit more efficient
13as it uses \function{statcache.stat()} instead of \function{os.stat()}
14(see the \refmodule{statcache} module for information on the
15difference).
Fred Drake64bc94e1999-06-17 15:11:35 +000016
Fred Drakede69ae11999-06-17 17:40:52 +000017\strong{Note:} Using the \refmodule{statcache} module to provide
18\function{stat()} information results in trashing the cache
19invalidation mechanism: results are not as reliable. To ensure
20``current'' results, use \function{cmp.cmp()} instead of the version
21defined in this module, or use \function{statcache.forget()} to
22invalidate the appropriate entries.