Re: Docstring snarfing directions

[Steve Tell <tell at telltronics dot org>]

On 8 Aug 2000, Greg J. Badros wrote:

> > I guess what I'm asking is, has this all been planned or even prototyped
> > already such that I can borrow ideas or additional pieces.  Or, if I
> > charge ahead, is there general interest in somthing like the above?
> 
> Nothing further has been planned by me as I'm still swamped with non guile
> activities for a bit.  I'm definitely interested in seeing this all
> cleaned up and pushing forward.

Thanks to this encouragement, I've started prototyping things on a copy of
guile-snarf.awk.  It does seem truely bizarre that I'm having to learn
(g)awk to extend this in the "guile way."

I can't help but wonder if it would be possible to do the .x file
extraction in a simpler matter (somewhat like the old guile-snarf), finish
building guile (to avoid bootstrap problems), and then use a guile program
to extract and build the documentation, and to check
documentation/declaration consistency.


So far, I've got somthing slapped together for hooks,
building on SCWM_HOOK and SCM_DEFINE.  A taste:

SCM_HOOK(new_wavepanel_hook,"new-wavepanel-hook", 1, (SCM wp),
"This hook is invoked with one WavePanel argument, WP, when the
WavePanel is first created and added to the waveform window.
The main purpose of this hook is to allow creation of 
popup menus and other event bindings for the wavepanel.");


Steve