Max, Sorry that the code for the robot is such a stew. The way it should work is to build all the doc data and then format that data for the wiki, but that's not how it happened. I'll probably do that when Rich moves contrib to a different wiki :-).
A lot of the code in there is just to deal with the google code wiki itself which is a little nasty. Unfortunately, the assumptions about that are just kind of mixed in all over the place. It has occurred to me to do an html-only version, but I'm mostly thinking about other things just at the moment. That having been said, there's no reason that the same basic idea couldn't be used to generate anything from the doc-strings and other metadata. The kernel of this came from some code that Rich Hickey wrote to create the API reference for clojure.org. He posted it here: http://paste.lisp.org/display/77339. Tom On May 24, 11:59 am, Max Suica <max.su...@gmail.com> wrote: > Hey, is there such a wiki/doc for core clojure? The wiki for clojure- > contrib's project page is so nice, but clojure's wiki has very little. > Heh, I've been using clj-doc to make my own reference for it, but the > wiki is a lot prettier. It would be nice to generate one for core. > I've looked at the robot code but it was scary and I put it away for > now, so I am still wondering if the generator can be decoupled from > clojure-contrib's and the wiki's svn to make a generic library doc > generator. > > On the notion of separating the documentation from the code, shouldn't > it be possible to generate a wiki interface for each code branch, and > allow changes in the wiki to be commited as changes to the doc strings > in the code? It might be fairly comfortable for coders to edit > documentation like that, but then again, it's pretty easy to just open > a file and add to a doc-string. > > max --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en -~----------~----~----~----~------~----~------~--~---
