[Snow-users-list] Provide APIs in snowballs documentation
Ludovic Courtès
ludo at gnu.org
Mon Jun 2 14:07:25 EDT 2008
Hello,
Adrien Pierard <pierarda at iro.umontreal.ca>
writes:
> (define* (function args)
> (annotation: "foo bar quux => dadidada")
> (frobnicate args))
>
> This annotation only lives at compile time, and is deleted afterwards
> from interpreted code, but gives enough information when parsed to
> generate some text for the web page or to the snowman.
GNU Guile (which is an interpreter) has "docstrings" similar to what
Emacs Lisp has, i.e.,
(define (make-chbouib foo bar)
"Return a chbouib made from @var{foo} and @var{bar}."
...)
It's simple, and Snow's `define*' could surely be made to discard such
docstrings when using a compiler---but even if it doesn't, having the
string in here doesn't hurt since it has no effect.
Thanks,
Ludovic.
More information about the Snow-users-list
mailing list