Hi David,
I think part of the problem is that you missed the name space from the data
you retrived with find-doc. meta isn't in the user namespace so you need to
specify it.
user=> (find-doc "metadata")
...
-------------------------
*clojure.core/*meta
([obj])
Returns the metadata of obj, returns nil if there is no metadata.
-------------------------
...
user=> (doc *clojure.core/*meta)
-------------------------
clojure.core/meta
([obj])
Returns the metadata of obj, returns nil if there is no metadata.
nil
user=>
It would be nice to have a (find-docname ...) that restricted the search a
bit from the commend line (puts it on the todo list, watches it dissappear
out of sight). I'm spoiled by Laurent's excellent clojure-dev namespace
browser, if you only come to clojure occasionally I would recommend it.
Cheers
Tom
2009/3/2 David <david.ra...@gmail.com>
>
> 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
-~----------~----~----~----~------~----~------~--~---
