Fork me on GitHub

Someone pointed out the auto-generated docs for tools.cli are out of date -- is the doc process broken right now, or only for certain projects? Is this because I switched from .clj to .cljc files? Anything any of us can do to help?

Alex Miller (Clojure team)20:09:04

it’s broken but I can manually run it (for most projects)

Alex Miller (Clojure team)20:09:24

when I get a chance I can try to poke it for tools.cli

Alex Miller (Clojure team)20:09:12

clojure’s own doc-gen is working (usually), this is really contribs, mostly due to parameterization


It's from the contrib-api-doc project, yes?


You have PROJECT=spec.alpha hardcoded in there BTW.


I ran it manually for tools.cli thanks.

Alex Miller (Clojure team)21:09:16

there are a bunch of hard-coded things

Alex Miller (Clojure team)21:09:34

but yes, it’s a variant of that

Alex Miller (Clojure team)21:09:02

if that worked for you, then great :)


It did highlight that the last "build" for tools.cli didn't complete properly -- it pushed 0.4.1 to Maven Central but didn't update the pom.xml file...

ERROR: Sorry, but @clojure has blocked access to SSH keys created by some third-party applications. Your key was created before GitHub tracked keys created by applications, so we need your help.

If you personally created this key, you can approve it at:


Otherwise, please upload a new key:


Fingerprint: 44:e1:82:44:97:c1:14:09:8b:c1:32:0d:a4:46:05:9c


fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
Finished: FAILURE


Also looks like everything failed to build last night...


I ran it for java.jdbc as well since that was slightly stale. Looks like you need to be careful to remove repo and repo-docs before you run it, at least in situ? Not sure how it's meant to be run but I guess I can run it manually now whenever I need to.

Alex Miller (Clojure team)21:09:42

It’s currently designed to be run by me in a modified version on my machine :) There are a number of dangerous things about it, so be careful. :)


Translation: Sean, your machine is now part of Alex's botnet 🙂

Alex Miller (Clojure team)21:09:24

I have some in work parameterization that actually automatically builds ci jobs like the test matrix jobs on build box


I'll be careful. It's not like I need to run it very often or on many projects 🙂