On Mon, Dec 13, 2010 at 5:38 PM, Meikel Brandmeyer <m...@kotka.de> wrote:
> Hi,
>
> Am 13.12.2010 um 21:42 schrieb Ken Wesson:
>
>> (Where did
>> you find vary-meta? There seems to be a lot of stuff that's there, but
>> hardly anyone knows about.)
>
> http://clojure.github.com/clojure/
>
> Hope that helps.

That's not what I meant. I figure all of us have tabs permanently open
to there (I have two actually). What we don't have is the whole thing
memorized, or the time to read it all rather than use it for reference
and, sometimes, control-F it for things. In particular, my due
diligence with atoms and metadata consisted of searching for functions
that work directly with atoms. Of course vary-meta isn't one of them.
My question of Alan was really more a matter of how he found it --
what called his attention to it.

I don't think there's actually a serious problem with the
documentation here; people can't memorize the documentation as there's
too much of it, nor read it all in advance for the same reason, and
search on particular topics won't always find something useful that's
not quite directly related to that topic, but there's little that can
be done about it. The documentation can't be made much shorter without
making it incomplete, nor can every search scenario be anticipated in
advance. So, sometimes people will not know about various functions,
especially more obscure ones that are uncommonly used.

The only problem, in other words, and it is a minor one, is when
people post (possibly only implied) criticisms of other people for
happening to not know about one of those things. That will lead to a
fair amount of time being wasted both on posting such criticisms and
on defending against same by pointing out what due diligence one
performed and why it didn't find whatever particular thing.

Note: that last is not directed at you, in particular, Meikel. It was
Alan (notably the only partly-anonymous user in this thread thus far)
that was a bit abrupt and seemed to be suggesting that I had done
something wrong, or at least questionable, and then explicitly
recommended other people ignore my code (despite the fact that it
works perfectly), and most likely he simply either got up on the wrong
side of the bed or didn't quite mean it that way but misstated
something. At the same time, it was also Alan who called our attention
to the existence of the vary-meta function. Make of that what you
will.

-- 
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
Note that posts from new members are moderated - please be patient with your 
first post.
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

Reply via email to