Add support generating Deprecated annotations and docs

[altro3]

Removed support swagger1 annotations for java generator

[altro3]

removing swagger 1 annotations is a breaking change.

Why are we mixing this removal with a PR to add Deprecated annotations? You are wrong, this change is not breaking. No one could generate code with swagger1 annotations before, simply because no one had the ability to change this setting (it is not passed in the plugin for gradle and maven).

In fact, this is just garbage that was left after moving the generator to this repository and this code was only in templates. By the way, in the generator for Kotlin, which I already wrote myself, there was no support for the first swagger.

I just removed the extra garbage, and this will not affect the previously generated code in any way.

[graemerocher]

please resolve the conflicts

[altro3]

@graemerocher done