> On Wed, Jan 5, 2011 at 8:00 PM, Stuart Halloway
> <stuart.hallo...@gmail.com> wrote:
>> All the code you are referring to is in clojure.contrib. Note the comment at
>> the top of the files:
>>
>> ;; DEPRECATED in 1.2: Promoted to clojure.java.shell
>
> At the top of which files? If you mean the library's source code, it's
> very likely he didn't read a single line of it -- just installed the
> contrib jar along with Clojure and then :required or :used it.
>
> If something people have been using in version x is deprecated in
> later version y, this needs to be announced somewhere more prominently
> than in its source code, like, oh, say, the main documentation page.
This is partially in place already. Deprecated namespaces are marked as such
with {:deprecated true}, and the top of the documentation page shows this (e.g.
http://clojure.github.com/clojure-contrib/shell-api.html).
However, the styling of the deprecation warning is such that it can be easily
missed.
> Better yet, the compiler should say something -- javac emits warnings
> if you call a method marked deprecated with Javadoc; maybe we need a
> {:deprecated true} meta tag that can be used on defns and that makes
> clojure emit warnings when deprecated functions are called? (These can
> be printlns to stderr in the same vein as the warnings generated by
> (set! *warn-on-reflection* true).)
Ticket created: http://dev.clojure.org/jira/browse/CLJ-706.
Thanks,
Stu
--
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
