Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-19 Thread Rich Hickey
On Sep 19, 12:05 am, "Stephen C. Gilardi" <[EMAIL PROTECTED]> wrote: > On Sep 18, 2008, at 12:34 PM, Rich Hickey wrote: > > > Done, except catch and finally, which are sub-syntax of try, like & > > is for fn. > > Thanks. I've uploaded specialdocs-2.patch. Patch applied (rev 1034) - thanks! Ric

Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-18 Thread Stephen C. Gilardi
On Sep 18, 2008, at 12:34 PM, Rich Hickey wrote: > Done, except catch and finally, which are sub-syntax of try, like & > is for fn. Thanks. I've uploaded specialdocs-2.patch. Clojure user=> (doc doc) - clojure/doc ([name]) Macro Prints documentation for a var or spe

Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-18 Thread Stephen C. Gilardi
On Sep 18, 2008, at 12:36 PM, Allen Rohner wrote: > I completely agree that users should read the site, but can we make > the special form doc just include a reminder of the syntax and then > link to the site? i.e. > > user=> (doc if) > - > (if test then) > (if test then e

Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-18 Thread Allen Rohner
> > > There's simply no substitute for reading the special forms page on the > > site, and everyone who intends to use Clojure should do so in its > > entirety. > > > If we want to make it so (doc def) et al do something, they should > > return the simple message: > > > Please see:http://clojure.

Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-18 Thread Rich Hickey
On Sep 18, 11:47 am, "Stephen C. Gilardi" <[EMAIL PROTECTED]> wrote: > On Sep 18, 2008, at 7:52 AM, Rich Hickey wrote: > > > > > I'm not in favor of doing it this way, for several reasons. First, > > there needs to be one place for canonic docs for each thing. For > > functions and macros, that'

Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-18 Thread Stephen C. Gilardi
On Sep 18, 2008, at 7:52 AM, Rich Hickey wrote: > I'm not in favor of doing it this way, for several reasons. First, > there needs to be one place for canonic docs for each thing. For > functions and macros, that's the inline docs, from which the API page > on the site is generated. For special

Re: Patch to provide special form documentation online (doc, find-doc)

2008-09-18 Thread Rich Hickey
On Sep 18, 2:58 am, "Stephen C. Gilardi" <[EMAIL PROTECTED]> wrote: > This patch makes clojure/doc and clojure/find-doc operate on special > forms as well as vars. I'm enclosing it with this message, but if that > doesn't work I'll upload it to the group's file section as > "specialdocs.tgz". Th

Patch to provide special form documentation online (doc, find-doc)

2008-09-17 Thread Stephen C. Gilardi
This patch makes clojure/doc and clojure/find-doc operate on special forms as well as vars. I'm enclosing it with this message, but if that doesn't work I'll upload it to the group's file section as "specialdocs.tgz". The .tgz file contains a patch file that patches boot.clj and a new file: src/clj