Tom, I like the idea of an "added in version", javadocs do it too. Perhaps it could go in the metadata?
There is an issue to figure out, though. In the upgrade to 1.1, slurp got a new arity. In JavaLand this would be a non issue, because the new arity would have its own docs. However, in Clojure the docs & meta are shared. I don't see an obvious way of documention this distinction. Any ideas on how to solve this issue? Am I making something out of nothing? Sean On Dec 9, 10:10 am, Tom Faulhaber <tomfaulha...@gmail.com> wrote: > Enhancing the doc tool so that we have versions for the multiple > branches (1.0, 1.1, master, new) is on my agenda. > > Maybe there's a way that Rich could add a link to the old 1.0 doc in > the meantime. > > I think that the "added in version" metadata tag is a good idea, at > least for clojure itself. Python does this and I've always liked it. > > Tom > > On Dec 9, 5:43 am, Mark Tomko <mjt0...@gmail.com> wrote: > > > I second this - since many of the IDE plugins bundle the clojure-1.0 > > jar, new users trying out Clojure (and IDEs) can't use all the > > features listed in the docs, and it's hard to tell which is which. > > Maybe we could at least add a 'added in version' to the new method > > metadata? > > > On Dec 9, 4:48 am, Jarkko Oranen <chous...@gmail.com> wrote: > > > > I just noticed that the API link on the clojure web site brings up > > > documentation for the master branch of Clojure instead of 1.0.0. I > > > can't find the 1.0.0 docs anywhere either. > > > > This is obviously a problem for 1.0.0 users, since the docs refer to > > > features that don't exist. > > > > I think it would be good to have the API page contain links to 1.0.0 > > > docs as well as master and perhaps other branches as well. Also, a > > > clear indication (preferably in a bold font or something) of which > > > revision the doc was generated for would be useful. > > > > -- > > > Jarkko -- 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
