One effective way to do it is to change the background color of either the whole page, or of the title (eg API for shell - clojure-contrib v1.2 (stable))
An analogous case that is handled well I think: http://reference.wolfram.com/mathematica/NonlinearRegression/ref/NonlinearRegress.html On Wed, Jan 5, 2011 at 6:40 PM, Stuart Halloway <stuart.hallo...@gmail.com> wrote: >> 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 -- 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
