summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorR. David Murray <rdmurray@bitdance.com>2010-04-12 16:35:19 (GMT)
committerR. David Murray <rdmurray@bitdance.com>2010-04-12 16:35:19 (GMT)
commit1a14d3d169a34293f416abe4a41e4141c4e07965 (patch)
tree66c9de2d714533b17be4f16c7326da7771242c0d /Doc/library
parent9aca91d7d73121a73cdf5d742a8b6cae30989f50 (diff)
downloadcpython-1a14d3d169a34293f416abe4a41e4141c4e07965.zip
cpython-1a14d3d169a34293f416abe4a41e4141c4e07965.tar.gz
cpython-1a14d3d169a34293f416abe4a41e4141c4e07965.tar.bz2
Issue #7585: use tab between components in unified and context diff headers.
Instead of spaces between the filename and date (or whatever the string is that follows the filename, if any) use tabs. This is what the unix 'diff' command does, for example, and difflib was intended to follow the 'standard' way of doing diffs. This improves compatibility with patch tools. The docs and examples are also changed to recommended that the date format used be the ISO 8601 format, which is what modern diff tools emit by default. Patch by Anatoly Techtonik.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/difflib.rst8
1 files changed, 4 insertions, 4 deletions
diff --git a/Doc/library/difflib.rst b/Doc/library/difflib.rst
index d749e14..8556e1d 100644
--- a/Doc/library/difflib.rst
+++ b/Doc/library/difflib.rst
@@ -146,8 +146,8 @@ diffs. For comparing directories and files, see also, the :mod:`filecmp` module.
The context diff format normally has a header for filenames and modification
times. Any or all of these may be specified using strings for *fromfile*,
- *tofile*, *fromfiledate*, and *tofiledate*. The modification times are normally
- expressed in the format returned by :func:`time.ctime`. If not specified, the
+ *tofile*, *fromfiledate*, and *tofiledate*. The modification times are normally
+ expressed in the ISO 8601 format. If not specified, the
strings default to blanks.
>>> s1 = ['bacon\n', 'eggs\n', 'ham\n', 'guido\n']
@@ -281,8 +281,8 @@ diffs. For comparing directories and files, see also, the :mod:`filecmp` module.
The context diff format normally has a header for filenames and modification
times. Any or all of these may be specified using strings for *fromfile*,
- *tofile*, *fromfiledate*, and *tofiledate*. The modification times are normally
- expressed in the format returned by :func:`time.ctime`. If not specified, the
+ *tofile*, *fromfiledate*, and *tofiledate*. The modification times are normally
+ expressed in the ISO 8601 format. If not specified, the
strings default to blanks.
>>> s1 = ['bacon\n', 'eggs\n', 'ham\n', 'guido\n']