documentation updates per code review

python · dougthor42 · May 9, 2025 · May 9, 2025 · May 9, 2025 · May 9, 2025
commit 833d86a4a5f0d999a1d42640220f44c0afdcdab9
diff --git a/Doc/whatsnew/3.15.rst b/Doc/whatsnew/3.15.rst
@@ -99,6 +99,7 @@ difflib
   This can be controlled by :ref:`environment variables
   <using-on-controlling-color>`.
   (Contributed by Douglas Thor in :gh:`133725`.)
+
 * Improved the styling of HTML diff pages generated by the :class:`difflib.HtmlDiff`
   class, and migrated the output to the HTML5 standard.
   (Contributed by Jiahao Li in :gh:`134580`.)

diff --git a/Lib/difflib.py b/Lib/difflib.py
@@ -1112,9 +1112,9 @@ def unified_diff(a, b, fromfile='', tofile='', fromfiledate='',
     For inputs that do not have trailing newlines, set the lineterm
     argument to "" so that the output will be uniformly newline free.
 
-   Set *color* to ``True`` to enable output in color, similar to
-   :program:`git diff --color`. Even if enabled, it can be
-   :ref:`controlled using environment variables <using-on-controlling-color>`.
+    Set 'color' to True to enable output in color, similar to
+    'git diff --color'. Even if enabled, it can be
+    controlled using environment variables such as 'NO_COLOR'.
 
     The unidiff format normally has a header for filenames and modification
     times.  Any or all of these may be specified using strings for