clojure API documentation

[cej38]

Hello,

  I have noticed a couple of things that I think are standard Clojure symbols but that aren't specified in the API documentation.  These are "." and "_".  It may be that they are more Java than Clojure (I don't know Java at all) and are thus supposedly known.  I run across "_" all of the time when reading though other people's code (especially core.logic) and I saw it again today when I was looking at the source code for drop-last.

  Should these symbols be added to the documentation?

  Also, could someone please give me a quick explanation of how to use _?

Thanks.

[Stathis Sideris]

_ is not special, but it is the convention to use it as the name for variables whose value is ignored.

[Michael Gardner]

On Jan 29, 2013, at 11:42 , cej38 <junke...@gmail.com> wrote:

> Should these symbols be added to the documentation?

The dot is documented at http://clojure.org/java_interop#dot -- which you'll be pointed to if you try (doc .) at a repl. It's also linked from http://clojure.org/special_forms.

It's not in the API docs because it's a special form (same as `if', for example). I think this is because the API docs are automatically generated and so don't know about special forms, only functions, macros, and vars.