Skip to content

Latest commit

 

History

History
127 lines (97 loc) · 2.59 KB

compatibility.adoc

File metadata and controls

127 lines (97 loc) · 2.59 KB

Compatibility

Emacs

CIDER supports Emacs 26.1+. More generally we try to support the last 3 major Emacs releases when that’s feasible and doesn’t add a lot of maintenance overhead.

Note
We pay special attention to supporting whatever Emacs is bundled with the current stable Debian and RHEL GNU/Linux distributions.

nREPL

CIDER supports nREPL 0.6+.

Note
We pay special attention to supporting whatever nREPL is bundled with the current stable Leiningen and Boot releases.

Java

CIDER officially targets Java 8, Java 11, Java 17, and the most recent rapid release version (e.g. Java 18). Generally speaking, we aim to support all Java releases that are currently officially supported by Oracle.

Note
The requirements for Java are pretty much cider-nrepl's requirements.

On Linux you are also strongly advised to make sure that JDK sources and javadocs are installed. You can find example commands in Troubleshooting.

Clojure

CIDER targets Clojure 1.8+. As Clojure doesn’t have the concept of supported releases we have to get a bit creative to determine the minimum version to target.

The minimum required Clojure version is currently derived using data from the State of Clojure survey. In general we consider a Clojure release eligible for dropping once its usage drops below 5%, but we’d not drop support for any release just for the sake of doing it. We’d do it only if this would lessen the maintenance burden or open up the possibility for big CIDER improvements.

ClojureScript

Currently we apply the same policy for Clojure and ClojureScript support.

Compatibility Matrix

Note
For a very long time CIDER and cider-nrepl were released in lock-step, but this changed in CIDER 0.18. The actual releases diverged for the first time in CIDER 0.23.

Below you can find the official compatibility matrix for CIDER.

Table 1. Compatibility Matrix
CIDER Emacs nREPL cider-nrepl Required JDK Required Clojure

0.22

25.1

0.6

0.22

8

1.8

0.23

25.1

0.6

0.22

8

1.8

0.24

25.1

0.6

0.24

8

1.8

0.25

25.1

0.6

0.25

8

1.8

0.26

25.1

0.6

0.25

8

1.8

1.0

25.1

0.6

0.25

8

1.8

1.1

25.1

0.6

0.25

8

1.8

1.2

26.1

0.9

0.25

8

1.8

1.3

26.1

0.9

0.28

8

1.8

Tip
You can also check the requirements of a particular CIDER version by inspecting the values of some CIDER variables. For instance, the required cider-nrepl version is in cider-required-middleware-version, and so on.