New submission from Chris Jerdonek <chris.jerdo...@gmail.com>:

The documentation for the dircmp class doesn't say that the same_files and 
diff_files attributes are determined using the "shallow=True" rules described 
in the filecmp.cmp() and filecmp.cmpfiles().  It should say this.

For example, the documentation describes diff_files as, "Files which are in 
both a and b, whose contents differ."  But this isn't true since files whose 
contents differ aren't included if their os.stat() signatures are equal.

See also issue 12932 to allow dircmp to perform non-shallow comparisons.

----------
assignee: docs@python
components: Documentation
keywords: easy
messages: 164646
nosy: cjerdonek, docs@python
priority: normal
severity: normal
status: open
title: document that filecmp.dircmp comparisons are "shallow"
versions: Python 3.3

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue15250>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to