Re: ANN: Full, continuously updated documentation for clojure.contrib

[Stephen C. Gilardi]

Hi Tom,

I like the docs a lot. Thanks for making the robot!

I have a suggestion for a refinement.



        http://code.google.com/p/clojure-contrib/wiki/ZipFilterApiDoc

contains:

        Usage:

        (ns <your-namespace>
          (:use clojure.contrib.zip-filter))



There are at least a couple of ways to fix this:







Thanks,

--Steve

On May 4, 2009, at 12:30 PM, Tom Faulhaber wrote:

We've received an issue for clojure-contrib noting that the doc for zip-filter at: This doesn't work as written because clojure.contrib.zip-filer defines ancestors and descendants which are also defined by clojure.core. - change :use (which may not always be correct) to :require (which is always correct) - include in the usage example any :refer-clojure clauses that are present in the contrib's ns form. I recommend the first option. Please consider making a change along these lines.

By the way, source of the robot is available on GitHub, for those who
appreciate fine masochism:

http://github.com/tomfaulhaber/contrib-autodoc/

Really, nothing to see there, but we like to be open.

Enjoy!

smime.p7s
Description: S/MIME cryptographic signature