Clojure Q&A - Recent questions tagged docs

Why clojuredocs is down?

Wed, 01 Jan 2025 14:52:55 +0000

For two days I am trying to enter https://clojuredocs.org/ from different browsers on different devices, always getting error 502 (bad gateway). Did clojuredocs migrate somewhere?

Dedupe doesn't mention statefullness in docstring

Mon, 22 Jan 2024 12:22:44 +0000

Unlike all other core functions which can return a stateful transducer, dedupe doesn't mention this in its docstring. E.g. distinct, drop-while etc. all say:

Returns a stateful transducer when no collection is provided.

But dedupe just says:

Returns a transducer when no collection is provided.

clojure.math/scalb docstring error

Sat, 11 Nov 2023 13:08:46 +0000

The docstring for scalb links to the documentation for nextDown, presumably just a mistake.

It links here: https://docs.oracle.com/javase/8/docs/api/java/lang/Math.html#nextDown-double-

But should link here: https://docs.oracle.com/javase/8/docs/api/java/lang/Math.html#scalb-double-int-

clojure.math/floor docstring error

Mon, 30 Oct 2023 12:55:24 +0000

In the docstring for clojure.math/floor it says:

If a is less than zero but greater than -1.0 => -0.0

but that's obviously not true:

(math/floor -0.3)
;; => -1.0

I guess it was intended to add that line to the docstring of clojure.math/ceil but added it to floor by mistake?

Document how extend-type can be used to provide default protocol implementation

Sat, 19 Dec 2020 19:19:57 +0000

In ClojureScript one can provide default protocol implementations as follows:

(extend-type default 
  AProtocol (f [] ...))

This is nicely documented in ClojureScript's extend-type docstring:

default, meaning the definitions will apply for any value,
unless an extend-type exists for one of the more specific
cases below.

nil, meaning the definitions will apply for the nil value.

It may worthwhile to document how one can provide default implementations for protocols in clojure as well, by using extend-type for Object & nil, on extend-type clj docstring. On the website is documented already.

What is the big O for clojure operations?

Wed, 15 Jul 2020 18:49:21 +0000

Hi, I'm new to clojure.

I have seen that there are some big O on the data structures part. But, is there a place on documentation showing all the big O of the operations in clojure?

Thanks!