diff -r 5cab0ada97b2 Lib/difflib.py --- a/Lib/difflib.py Sun Mar 16 15:56:24 2014 -0500 +++ b/Lib/difflib.py Sun Mar 16 21:05:00 2014 -0600 @@ -1302,11 +1302,14 @@ functions (or None): - linejunk: A function that should accept a single string argument, and - return true iff the string is junk. The default is None, and is - recommended; as of Python 2.3, an adaptive notion of "noise" lines is - used that does a good job on its own. + return true if the string is junk. The default is None, and is + recommended; as of Python 2.3, the underlying SequenceMatcher class does + a dynamic analysis of which lines are so frequent as to constitute noise, + the idea is to find the longest contiguous matching subsequence that + contains no "junk" elements. - - charjunk: A function that should accept a string of length 1. The + - charjunk: A function that should accepts a character (string of length 1), + and returns true if the character is junk, or false if not. The default is module-level function IS_CHARACTER_JUNK, which filters out whitespace characters (a blank or tab; note: bad idea to include newline in this!).