dump_api: emits @deprecated in comments

Since @deprecated is an important part of versioned interfaces, we need
to emit them in API dumps so that clients of older versions are warned
when they use deprecated entities.

Bug: 177277347
Test: aidl_unittests
Merged-In: I65c97b85cb4e340d5f3feb3a23dabc078348ce8c
Change-Id: I65c97b85cb4e340d5f3feb3a23dabc078348ce8c
(cherry picked from commit ef1039bd8cd2407c470cce1c30ae6941313300c8)
3 files changed