Add doc-comment for fn handle_output_stream

diff --git a/update.py b/update.py
index 4900498cd4d9d55c2d2079eae234d4fb3c5bbec5..e3850ef4952b4fd4ed0cdfb65d05739a05c353aa 100755 (executable)
--- a/update.py
+++ b/update.py
@@ -1084,6 +1084,11 @@ def cleanup_sccache(chroot: str):
 
 
 def handle_output_stream(handle, output_file, other_state):
+    """Reads lines from an input stream "handle" and writes them to
+    "output_file". Flags in "other_state" determine certain behaviors, such as
+    prepending a timestamp to each line, or the filesize-limit for the
+    "output_file"."""
+
     log_count = 0
     limit_reached = False
     while True: