Re: [Jscheme-user] schemedoc

[Geoffrey K. <ge...@kn...>]

On Oct 12, 2004, at 16:19, Ken Anderson wrote:
> Tim and i where at the NEPLS conference Friday and we talked about
> http://www.cs.auc.dk/~normark/schemedoc/
> which a scheme version of javadoc.  There are actually at least 5 =20
> scheme systems to do this.
> Lets develop a simple version, perhaps called jsdoc, for JScheme.

I was pretty impressed with Kurt N=F8rmark's Elucidator 2 example:
http://www.cs.auc.dk/~normark/scheme/examples/elucidator-2/scheme-=20
documentation-tools/html/index.html

What I hope Scheme (and Java) documention systems will evolve into is =20=

not just pretty web pages or typeset manuals, but also a registry of =20
capabilities, like JDocs [1] or the Scheme Cookbook [2], but more =20
dynamic.  I want to Google a capability I need and find a list of =20
implementations meeting that need, scored by metrics of usability and =20=

compatibility with Scheme systems.  At that point the literate =20
programming tools would help me understand the discovered code well =20
enough to reference it in my code without fear, and when I ran my =20
program the Scheme system I was using would be smart enough to go get =20=

the referenced code if I hadn't already downloaded it.

Geoffrey
--
Geoffrey S. Knauth | http://knauth.org/gsk

[1] http://www.jdocs.org/
[2] http://schemecookbook.org/=