documentation-lib.scm: Clarify ref-ify docstring.

diff --git a/scm/documentation-lib.scm b/scm/documentation-lib.scm
index ba434f1947e89bcbbb907c18ffa97371e290274b..8315a765c120e9f6ad0097940344ef412ad7059a 100644 (file)
--- a/scm/documentation-lib.scm
+++ b/scm/documentation-lib.scm
@@ -149,7 +149,8 @@ string-to-use).  If QUOTE? is #t, embed table in a @quotation environment."
   name)
 
 (define (ref-ify x)
-  "Add ref to X"
+  "Return @ref{X}. If mapping ref-ify to a list that needs to be sorted,
+   sort the list first."
   (string-append "@ref{" x "}"))
 
 (define (human-listify lst)