Deprecate emu unit - #5906

@pllim - I like this approach! I wonder, though, whether it wouldn't make sense to follow imperial a bit more closely and just define the units and use add_enabled_units in enable. In the comments you note possible name clashes. Are you thinking of something specific? The prefixed earth/jupiter mass? I think this might well "just work" even with add_enabled_units... (but have not checked).

Also, obviously needs some mention in the documentation...

@mhvk

Re: "add" vs "set". No particular reason. It was just cut-and-paste. And apparently I chose the wrong module. Fixed that in the second commit.

Re: Documentation. It is auto-generated. The following will appear at the end of the API documentation. Given that the unit is deprecated, I decided against giving it extra publicity, as we do not want to encourage people to use it (but it is there if they really, really want to).

@pllim - OK, all looks good. Feel free to merge once the tests have passed.

hm, deprecated.enable() sounds like a very good 2017-4-1 feature. 😄

We can always wait till Apr 1 to merge, it is not that far away. 😂

@pllim @mhvk - I agree that this doesn't need much publicity, thus I wonder whether we even need the table of the deprecated units, or the description above the table should be enough?

@bsipocz , then there is no easy way to find out what unit is deprecated. Also, this provides a consistent API presentation. So, I am against removing the table but I will if overruled.

Since this is approved and tests passed, merging.