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 special form given its name
nil
user=> (doc def)
-------------------------
def
Special Form
   Please see http://clojure.org/special_forms#def
nil
user=> (doc catch)
-------------------------
catch
Syntax Symbol
   Please see http://clojure.org/special_forms#try
nil
user=> (doc fn*)
java.lang.Exception: Unable to resolve var: fn* in this context  
(NO_SOURCE_FILE:6)
user=>

- The patched code includes support for &, catch, and finally,  
pointing the user to fn or try on the special forms page. That support  
is easy to remove if you don't like it.

- fn*, let*, and loop* get no special treatment as we discussed:  
they're unbound vars

- fn, let, and loop are now treated as special forms rather than  
macros. Doc will point the user to the complete docs on the  
special_forms page rather than the abbreviated docs in the code.  
That's easy to change if you don't like it. Find-doc will still search  
through the old docs, so if you like fn, let, and loop pointing to the  
special_forms page, I recommend removing the abbreviated docs from  
their macro definitions.

--Steve


--~--~---------~--~----~------------~-------~--~----~
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 [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/clojure?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to