module-stexi-documentation #:docs-resolver keyword arg

* module/texinfo/reflection.scm (module-stexi-documentation): Make
  #:docs-resolver a keyword argument.  Provide back compat with
  docs-resolver as an optional argument, though.

1 files changed, 7 insertions, 2 deletions

diff --git a/module/texinfo/reflection.scm b/module/texinfo/reflection.scm
index a69436f89..d85f61239 100644
--- a/module/texinfo/reflection.scm
+++ b/module/texinfo/reflection.scm
@@ -288,11 +288,16 @@
           (else (lp (cdr forms))))))
 
 (define* (module-stexi-documentation sym-name
-                                     #:optional (docs-resolver
-                                                 (lambda (name def) def)))
+                                     #:optional %docs-resolver
+                                     #:key (docs-resolver
+                                            (or %docs-resolver
+                                                (lambda (name def) def))))
   "Return documentation for the module named @var{sym-name}. The
 documentation will be formatted as @code{stexi}
  (@pxref{texinfo,texinfo})."
+  (if %docs-resolver
+      (issue-deprecation-warning
+       "module-stexi-documentation: use #:docs-resolver instead of a positional argument."))
   (let* ((commentary (and=> (module-commentary sym-name)
                             (lambda (x) (string-trim-both x #\newline))))
          (stexi (string->stexi commentary))