Re: [Chicken-users] ideas

[Tony Garnock-Jones]

> > That would be great. Would you say texinfo is the right format?
> > (I never used it, I just know plain text and HTML).
> 
> I'd rather it be LaTeX, if people are asking. That way, I can help too.

DSSSL is schemely; so maybe docbook?

scribe (available via the bigloo page) has worked *very* well for me
in recent months. Full Scheme, compiles to LaTeX or HTML... the PDF
it generates is goodlooking (as per Tex's usual) and the HTML is at least
acceptable...

Maybe some kind of SXML-DSSSL hybrid monster?

I'm also interested in getting docstrings into Chicken somehow. How
tricky do you think that might be, Felix?

(define (myfunction foo bar)
  "Returns the result of mapping blorch over foo, followed by appending bar"
  ...)

Combine that with an interation protocol for enumerating all the symbols
in the symbol table, (even (*all-symbols*) returning a list might be
good enough) and we could have both online and autogenerated offline
documentation...

>>> (documentation car)
"Returns the car of the pair passed in as an argument."
>>> (documentation (lambda () 'dummy))
#f
>>> (documentation (lambda () "hi"))
#f
>>> (documentation (lambda () "hi" "there"))
"hi"
>>> (documentation-parameters with-exception-handler)
(new-handler body-thunk)
>>>

Tony

-- 
"How's my programming? 1-800-DEV-NULL"