Update documentation

Author: kesara

Doc/library/difflib.rst

@@ -338,6 +338,23 @@ Diff generation
       + tree
       + emu
 
+.. function:: mdiff(fromlines, tolines, context=None, linejunk=None, charjunk=IS_CHARACTER_JUNK)
+
+   Return a generator yielding marked up *fromlines* and *tolines* side by side differences.
+
+   Optional keyword parameters *context* is number of lines to display on each side the difference, if ``None``, all from/to text lines will be generated; *linejunk* and *charjunk* are filtering functions.
+
+   from/to line tuple -- (line num, line text)
+      line num -- integer or None (to indicate a context separation)
+      line text -- original line text with following markers inserted:
+
+         '\0+' -- marks start of added text
+         '\0-' -- marks start of deleted text
+         '\0^' -- marks start of changed text
+         '\1' -- marks end of added/deleted/changed text
+
+   boolean flag -- None indicates context separation, True indicates
+        either "from" or "to" line contains a change, otherwise False.
 
 .. function:: restore(sequence, which)
 

Lib/difflib.py

@@ -10,6 +10,9 @@
 Function ndiff(a, b):
     Return a delta: the difference between `a` and `b` (lists of strings).
 
+Function mdiff(fromlines, tolines):
+    Return a generator yielding marked up from/to side by side differences.
+
 Function restore(delta, which):
     Return one of the two sequences that generated an ndiff delta.
 
@@ -26,7 +29,7 @@
     For producing HTML side by side comparison with change highlights.
 """
 
-__all__ = ['get_close_matches', 'ndiff', 'restore', 'SequenceMatcher',
+__all__ = ['get_close_matches', 'ndiff', 'mdiff', 'restore', 'SequenceMatcher',
            'Differ','IS_CHARACTER_JUNK', 'IS_LINE_JUNK', 'context_diff',
            'unified_diff', 'diff_bytes', 'HtmlDiff', 'Match']