I asked Alex Miller about this on Slack and he said (paraphrasing): Something in clojure.spec broke autodoc a while back and then the split of spec to spec.alpha threw a further wrench in the automated doc generation. That means at least some of the API documentation has been stale for a while since the doc-gen task can’t run. Right now, Alex is waiting for Tom Faulhaber to find enough time to fix whatever is causing the problem.
So – the problem is autodoc doesn’t like something in clojure.spec and that affects several Clojure projects (I had wondered why the clojure.spec docs had seemed so out of date!). Sean Corfield -- (970) FOR-SEAN -- (904) 302-SEAN An Architect's View -- http://corfield.org/ "If you're not annoying somebody, you're not really alive." -- Margaret Atwood From: Xiangtao Zhou Sent: Thursday, July 13, 2017 7:43 PM To: Clojure Subject: Re: lein autodoc failed in clojure.java.jdbc hi Sean, The official site of java.jdbc is generated by autodoc, does that mean the clojure team use a different autodoc? please see this. https://clojure.github.io/java.jdbc/ Joe On Thursday, July 13, 2017 at 12:17:45 PM UTC+8, Sean Corfield wrote: Autodoc is not declared in java.jdbc’s project.clj, I’ve never run autodoc on that project (or any other, to be honest), so I have no expectation about which projects autodoc works on an which it doesn’t, but if it can’t read valid Clojure source code, that’s a bug in autodoc as far as I’m concerned. Sean Corfield -- (970) FOR-SEAN -- (904) 302-SEAN An Architect's View -- http://corfield.org/ "If you're not annoying somebody, you're not really alive." -- Margaret Atwood From: Xiangtao Zhou Sent: Wednesday, July 12, 2017 6:50 PM To: Clojure Subject: lein autodoc failed in clojure.java.jdbc hi clojure.java.jdbc's contributor, I checkout master, and run lein autodoc failed with following errors. And there is no error for version java.jdbc-0.6.1. Any detailed infomation about this is appreciated. Joe Exception in thread "main" java.lang.RuntimeException: EOF while reading at clojure.lang.Util.runtimeException(Util.java:221) at clojure.lang.LispReader.read(LispReader.java:246) at clojure.lang.LispReader.read(LispReader.java:196) at clojure.lang.LispReader.read(LispReader.java:190) at clojure.core$read.invoke(core.clj:3640) at clojure.core$read.invoke(core.clj:3638) at clojure.core$read.invoke(core.clj:3636) at clojure.core$read.invoke(core.clj:3634) at autodoc.collect_info_wrapper$do_collect.invoke(collect_info_wrapper.clj:95) at autodoc.autodoc$build_html.doInvoke(autodoc.clj:26) at clojure.lang.RestFn.invoke(RestFn.java:397) at clojure.lang.Var.invoke(Var.java:375) at clojure.lang.AFn.applyToHelper(AFn.java:152) at clojure.lang.Var.applyTo(Var.java:700) at clojure.core$apply.invoke(core.clj:630) at autodoc.autodoc$autodoc.doInvoke(autodoc.clj:102) at clojure.lang.RestFn.invoke(RestFn.java:425) at autodoc.autodoc$autodoc.invoke(autodoc.clj:76) at clojure.lang.AFn.applyToHelper(AFn.java:154) at clojure.lang.RestFn.applyTo(RestFn.java:132) at clojure.core$apply.invoke(core.clj:632) at autodoc.autodoc$execute.doInvoke(autodoc.clj:116) at clojure.lang.RestFn.applyTo(RestFn.java:137) at clojure.core$apply.invoke(core.clj:630) at autodoc.autodoc$_main.doInvoke(autodoc.clj:120) at clojure.lang.RestFn.applyTo(RestFn.java:137) at autodoc.autodoc.main(Unknown Source) -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clo...@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+u...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+u...@googlegroups.com. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
