This is the mail archive of the guile@cygnus.com mailing list for the guile project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Documentation



I think applying the scwm doc engine to Guile would be a fine thing to 
do.

Andrew Archibald writes:
> Greg Badros <gjb@cs.washington.edu> writes:
> 
> > And, not to beat a dying horse, *documentation*!  I can't begin to
> > describe how much better I am at using scwm now that Maciej, Sam, and I
> > have worked together to create an interactive documentation system.  Sam 
> > wrote a nice Emacs interface to the documentation that is extracted from 
> > our source code, and all the functions are as easy to learn about as
> > Emacs lisp documentation.  It's a joy to use, and would be even better
> > if we linked to the R5RS info pages on scheme, and if Guile procedures
> > were documented in the same way.  Scwm and its scwm-mode for Emacs is a
> > great way to learn about Guile and could easily evolve into a great
> > scheme development environment.
> > 
> > Greg
> 
> Is there any reason not to apply the current scwm doc engine to guile?
> (Apart from requiring time and effort)  Is there any likelihood of
> having to rewrite the in-code doc strings if guie were to switch over
> now?
> 
> Andrew
> 
>