Put @Deprecated annotation on disabled methods

[andreoss]

We can annotate disabled methods which throw UnsupportedOperationException (i.e mutation methods on Collection) in order to provide an extra clue for static analyzers and IDEs about them.

[fabriciofx]

@andreoss I think it a good idea. @victornoel WDYT?

[victornoel]

@andreoss @fabriciofx I'm not clear what this does provide exactly in practice… I'm a bit reluctant to annotate a method with something that is not really the "truth" without a good reason :)