announcements

2025-11-22T23:05:54.919559Z

Announcing https://github.com/behrica/calva-javadoc , a small helper to make it easy to show javadoc for the "current form" in Calva (VS Code Clojure extension), powered by https://github.com/clojure/java.doc

2
1
🆒 2
🎉 12
ericdallo 2025-11-23T03:22:20.702059Z

Although I find awesome, I believe we could add this functionality in clojure-lsp which is used by Calva, and deliver this feature for all editors changing a single place via the clojure-lsp hover feature

👍 4
ericdallo 2025-11-23T03:22:51.717939Z

I actually was planning to do that soon, but any help is welcome

2025-11-23T17:54:32.274189Z

I noticed that Calva gets its javadoc information "from nrepl", not from clojure-lsp. Better said: I see that nrepl-logging shows "javadoc" info comming in.

ericdallo 2025-11-23T17:55:07.964449Z

Interesting, via clojure-lsp seems better as wouldn't require repl connection :)

2025-11-23T17:58:33.937599Z

I know that in Calva there is a bit of overlap in taking things "from nrepl" and "from clojure-lsp". Some of this is configurable, if I remember well. Please have a look here, we have know more details on Calva javadoc support: https://calva.io/javadocs/ I have tried out what we say there, so I "believe" Calva takes javadoc info from nrepl... But I never checked the code..., I admit

2025-11-23T18:03:18.158029Z

The Calva settings read like this: Calva: Definition Provider Priority Calva can provide definitions using both the REPL connection and via clojure-lsp. Which provider should Calva prioritize when both are available? repl,lsp repl,lsp lsp,repl

ericdallo 2025-11-23T18:04:23.267109Z

yeah I know about that, It's just weird to me why one would prefer "javadoc that works" vs "javadoc that works, but require repl connected", if add this javadoc support for clojure-lsp

ericdallo 2025-11-23T18:04:38.467169Z

but yeah, I'm ok with that

2025-11-23T18:05:37.680519Z

But does clojure-lsp javadoc support rely as well on "source jars" being available on local disk ?

ericdallo 2025-11-23T18:06:48.075459Z

AFAIK if using the new clojure.java.doc, no?

2025-11-23T18:09:32.359439Z

indeed, but I mean "today" . Reading here: https://clojure-lsp.io/settings/#java-support seems to say that it can only find "javadoc" for the JDK classes, if src.zip is found. (but never for non-jdk classes) (which nrepl can)

ericdallo 2025-11-23T18:11:34.118309Z

ah yeah, for sure

2025-11-23T18:11:37.730099Z

But nrepl requires them to be "downloaded" by user. (so far). in form of "source jars" which are on maven central for most java open source libraries. Cider does this download automatic, but not nrepl

2025-11-23T18:13:09.328689Z

But indeed, know both clojure-lsp and nrepl have a new option (https://github.com/clojure/java.doc) to get to the javadoc. (not brand new, but easier)

👍 1