Thanks to all whom replied so far. <br><br>It seems that SchemeDoc should be usable with module files too (at least nothing I read seem to prohibit it), and the generated document looks pretty good, but doesn't seem compatible with with
doc.txt. <br><br>Scribble, on the other hand, still lives in the pre branch, so not sure if it's ready for prime time yet... <br><br>I will try both and see which one works better for my needs. <br><br>So no one pick up on the docstring question yet - does that mean no one likes docstring? ;)
<br><br>Thanks,<br>yinso <br><br><div><span class="gmail_quote">On 6/8/07, <b class="gmail_sendername">Noel Welsh</b> <<a href="mailto:noelwelsh@gmail.com">noelwelsh@gmail.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
I think the future belongs to Scribble, which I understand is being<br>used to document future versions of PLT Scheme. I have yet to use it,<br>but Dave tells me it is easy to use.<br><br>I'm about a gnats whisker away from make a macro ala:
<br><br> (define/doc name documentation value)<br><br>[Actually it will probably all definition of contract as well, have a<br>shorter name, and support more forms, but you get the idea]<br><br>N.<br><br>On 6/8/07, Grant Rettke <
<a href="mailto:grettke@acm.org">grettke@acm.org</a>> wrote:<br>> Schemedoc works for code that does not live in modules and runs on v370:<br>><br>> <a href="http://www.cs.aau.dk/~normark/schemedoc/">http://www.cs.aau.dk/~normark/schemedoc/
</a><br>_________________________________________________<br> For list-related administrative tasks:<br> <a href="http://list.cs.brown.edu/mailman/listinfo/plt-scheme">http://list.cs.brown.edu/mailman/listinfo/plt-scheme
</a><br></blockquote></div><br>