This is the mail archive of the
guile@sourceware.cygnus.com
mailing list for the Guile project.
Re: Suggestion: new snarf macro set
thi <ttn@revel.glug.org> writes:
> ** Docstring
>
> All `SCM_DEFINE_' macros should define docstrings.
> `SCM_DEFINE_C_' macros do not necessarily define docstrings.
>
> might as well be consistent and require docstrings for `SCM_DEFINE_C_'
> macros, too. the snarfer should be able to handle these specially,
> perhaps by ignoring them in the initial implementation. avoiding this
> inconsistency also prevents an interface (macro definition) change
> requirement later.
Right. Probably we can define SCM_DEFINE_C_FUNCTION and
SCM_DEFINE_C_MACRO (for documentation) as well, and all Guile's API
can be defined and documented by using them.