[Denemo-devel] Documenting the procedures and variables defined in scheme

[Richard Shann]

Neil Jerram has come up with the following runes for documenting the
interface to denemo from scheme: 

(module-for-each (lambda (name var)
                      (format #t "variable `~A', value `~s'~%" name
                              (variable-ref var)))
                    (current-module))

This splurges out the name and value of all the things we define in
scheme from C, and I am not sure what else. I have written a little
variant

 (module-for-each (lambda (name var)
                    (let ((mystring ""))
                      (set! mystring (format #f "`~a'" (variable-ref var)))
                      (display (string-append mystring "\n"))))

(current-module))

this one just putting out the (variable-ref var) thing - what I referred
to as the value above - after getting it into a string (called mystring
in the code).

With a better understanding of things like variable-ref we could write
something elegant, but in any case we could simple hack at the mystring
to create a list of variables and a list of procedures, potentially
other information.
Anybody any thoughts on getting the tooltip/associating documentation
string with variables?

Richard