Thanks for the link, Mark. I'll look into the contents.
What I'm talking about, though, is not that there is no documentation,
but rather I can't find my way around it very well. I only get around
to Clojure every so often and I find I forget a lot, so I'd have to go
through practically all the docs every time to refresh my memory.
That's quite a lot of docs to go through, mind you. And usually I
leave off before I can get to serious work. Or, right in the middle of
it I get frustrated and start working on the help browser. I don't
finish it of course, and then I leave things be for a couple of
months. It's a vicious circle, from my standpoint.
I know, the fault is entirely mine. I'm so used to full-text search
with highlighted results that I find everything less than that...
well... unsatisfactory.
For example: I know that there is a meta data one can obtain from
objects, so I type
user=>(find-doc "metadata")
and get, among other things
clojure/meta
([obj])
Returns the metadata of obj, returns nil if there is no metadata.
Great!, Let's try it:
user=> (meta meta)
nil
Ups! Let's try again:
user=> (meta 'meta)
nil
Erm. Let's try yet again:
user=> ^#meta
java.lang.Exception: No dispatch macro for: m
java.lang.Exception: ReaderError:(17,1) No dispatch macro for: m
at clojure.lang.LispReader.read(LispReader.java:160)
etc.
OK. Final try:
user=> ^#'meta
{:line 142, :doc "Returns the metadata of obj, returns nil if there is
no metadata.", :file "boot.clj", :ns #<Namespace: clojure>, :name
meta, :arglists ([obj])}
Allelluyah! But... if such an example would be right there in the docs
I got with the (find-doc "metadata"), I'd get where I want to be in 10
secs instead of a couple of minutes.
Regards,
David
P.S. Joshua and Laurent, thanks for your explanations, too.
On Mar 1, 9:34 pm, Mark Volkmann <r.mark.volkm...@gmail.com> wrote:
> On Sun, Mar 1, 2009 at 2: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.
>
> There are lots of examples in the article I wrote
> athttp://www.ociweb.com/mark/clojure.
>
> --
> R. Mark Volkmann
> Object Computing, Inc.
--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---
