Deprecation should be more visible in rustdoc output

[sfackler]

It's currently handled like any other stability attribute, but I think we want something more explicit for the case of deprecation. For example, javadoc prints the deprecation warning both in the table of contents and the documentation for a deprecated method: http://docs.oracle.com/javase/7/docs/api/java/lang/Thread.html#resume(). We'll want to make sure that it's easily visible even on the search results page so people can avoid clicking into and using deprecated API by accident.

[tomjakubowski]

I like what the Google Closure Library API docs do with deprecated functions, marking them clearly with a shaded background.

[emberian]

Is what it looks like now. Do you consider this fixed, @sfackler ?

[sfackler]

The deprecation message is still hidden unless you mouse over the "deprecated" text.

[aturon]

cc me

[sfackler]

Search results still have no indication that something's deprecated as well.

[steveklabnik]

I found this annoying today too. We should certainly show the message on the page.

[pnkfelix]

not necessary for 1.0. (also, some note that deprecated is for usage within the standard library, not for end-user crates).

P-high.

[caipre]

I'm still working on this, albeit slowly. It's not as easy (for a rust novice) as I initially suspected it might be.