Tweak around docstring to make prettier sphinx autodocs.

1 files changed, 10 insertions, 5 deletions

diff --git a/string_utils.py b/string_utils.py
index a2f4633..dbd50f2 100644
--- a/string_utils.py
+++ b/string_utils.py
@@ -1246,13 +1246,18 @@ def strip_ansi_sequences(in_str: str) -> str:
 
 class SprintfStdout(contextlib.AbstractContextManager):
     """
-    A context manager that captures outputs to stdout.
+    A context manager that captures outputs to stdout to a buffer
+    without printing them.  e.g.::
 
-    with SprintfStdout() as buf:
-        print("test")
-    print(buf())
+        with SprintfStdout() as buf:
+            print("test")
+            print("1, 2, 3")
+        print(buf())
+
+    This yields::
+
+        'test\\n1, 2, 3\\n'
 
-    'test\n'
     """
 
     def __init__(self) -> None: