[racket] inline source documentation->html tool for Racket? (like Pydoc or Javadoc?)

Hi Christopher,

You probably want this:
http://docs.racket-lang.org/scribble/srcdoc.html

Laurent


On Mon, Jul 1, 2013 at 8:11 PM, Christopher <ultimatemacfanatic at gmail.com>wrote:

> Hey all,
>
> Is there an inline source documentation to HTML tool for Racket?  I want
> to document my Racket module functions and classes and variables in the
> .rkt file and then run it through a tool that will extract the
> documentation from my comments and dump it into an HTML file or files.  You
> know, something like Pydoc or Javadoc.  Does it exist for Racket, something
> that works in that fashion?  If not, what is available?
>
> I looked at Scribble, but that looks like one has to make a file separate
> from the .rkt file and separate the documentation from the implementation
> between two files.  I'm not fond of that approach (though I may capitulate
> to adopting it if I have to) because it's hard enough for me to keep the
> documentation and the implementation in sync when they are in the same
> file, and I imagine it would be even harder if they are in different files.
>  Coming from Python, I'm not used splitting the doc and implementation, and
> I haven't been sold on that way of doing it as yet, but if anyone wants to
> make any argument why doing it the Scribble way is just as good or better,
> I'm open to listening.
>
> Thanks.
>
> --Christopher
> ____________________
>   Racket Users list:
>   http://lists.racket-lang.org/users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20130701/c82a8da9/attachment.html>