> I find it confusing. Nothing seems to be where it should be, there are almost no examples Just my opinion, but I think that Clojure is very well documented, both on clojure.org and on various online articles.
> But I'm tired of doing it every time when some (sub)results type gets changed In good encapsulated fashion, Clojure guarantees the interface of its returned objects, but not the implementation class > to its documentation How about doc and find-doc user=> (doc +) user=> (find-doc "vec") >... namespace names >...distinct intern or public names Take a look at fnuctions mentioned here http://clojure.org/namespaces like ns-name <http://clojure.org/api#ns-name> ns-aliases<http://clojure.org/api#ns-aliases> ns-imports <http://clojure.org/api#ns-imports> ns-interns<http://clojure.org/api#ns-interns> ns-map <http://clojure.org/api#ns-map> ns-publics<http://clojure.org/api#ns-publics> ns-refers <http://clojure.org/api#ns-refers> Joshua On Sun, Mar 1, 2009 at 10:15 PM, David <david.ra...@gmail.com> wrote: > > Every now and again I try to get serious about learning Clojure and > every time I quit due to its documentation. I find it confusing. > Nothing seems to be where it should be, there are almost no examples > etc. So, every time I end up writing (in Java, I might add) a > documentation browser with index, full-text search support, bookmarks > (something similar to Eclipses help system or kchmviewer) and maybe a > possibility of adding custom examples to meta :doc with aspiration of > building a personal tutorial as I go along. > > I can't seem to find a way of obtaining that information from Clojures > runtime in a "standard" manner, however. I tried tackling the > 'problem' with evaluating a (map meta (reduce concat (map vals (map ns- > publics (all-ns))))) and then parsing the result using Clojures java > classes. I can do that without major problems. But I'm tired of doing > it every time when some (sub)results type gets changed (the last one > was from LazyCons to LazySeq) and I naively update everything from the > SVN. > > Is there any guarantee with regard to the internal structure of > evaluation results (speaking in Java terms)? If not, is there > something planed to that effect for official release(s)? > > Alternatively, what's the best (quickest, most robust, ...) way of > obtaining Clojures runtime info in a manner similar to this: > > Map<String, interns> > // keys == distinct namespace names > > interns: Map<String, meta> > // keys == distinct intern or public names > > meta: Map<String, String> (or Map<String, List<String>> for the sake > of arguments ;-) ) > // keys == meta names > > in a sentence: something that could be parsed from within Java using > java.lang.String and Java collection classes? > > Regards, > David > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
