On Mon, Mar 2, 2009 at 4:22 AM, David <david.ra...@gmail.com> wrote:
>
> 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.
Are you saying that you wanted the metadata of the meta function? What
did you want from that that you didn't get from (doc meta)?
There is also (source meta) which uses the metadata of the meta
function to output the source code for that function.
I describe this in a little more detail at
http://www.ociweb.com/mark/clojure/article.html#Metadata.
--
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
-~----------~----~----~----~------~----~------~--~---
