src/final.lisp (test-module): Fix egregiously wrong docstring.

Make the doc stub match too.

diff --git a/doc/misc.tex b/doc/misc.tex
index 8b7536c70318e6e3aece7f0546c54c621edf3362..f43ec98c9a41ef0c8f2618883980e28e5adcbe22 100644 (file)
--- a/doc/misc.tex
+++ b/doc/misc.tex
@@ -568,7 +568,7 @@ These symbols are defined in the @!optparse| package.
 \begin{describe}{var}{*debugout-pathname*}
 \end{describe}
 
-\begin{describe}{fun}{test-module @<path> @<reason>}
+\begin{describe}{fun}{test-module @<path> @<reason> @> @<status>}
 \end{describe}
 
 \begin{describe}{fun}

diff --git a/src/final.lisp b/src/final.lisp
index ee75705ceb4ff4898794e38f7af75ebc0f67bb48..6b81e3d9d4982b7444a021bdb35d25c326b6efc3 100644 (file)
--- a/src/final.lisp
+++ b/src/final.lisp
@@ -40,8 +40,13 @@ (defvar *debugout-pathname* #p"debugout.c")
 
 (export 'test-module)
 (defun test-module (path reason)
-  "Reset the translator's state, read a module from PATH and output it with
-   REASON, returning the result as a string."
+  "Read a module from PATH, to exercise the machinery.
+
+   If REASON is non-nil, then output the module to `*debugout-pathname*' with
+   that REASON.
+
+   Return a two-element list (NERROR NWARNING) of the number of errors and
+   warnings encountered while processing the module."
   (multiple-value-bind (module nerror nwarning)
       (count-and-report-errors () (read-module path))
     (when reason