API Review: Clarify deprecated docs and rethrow from system server

1) Clarify why there are new APIs being added as @deprecated
   (backwards compatibility), and
2) onLineIdentificationSupplementaryServiceResponse should throw
an exception instead of silently failing.

Test: atest CtsTelephonyTestCases FrameworksTelephonyTests
Bug: 149997057
Bug: 143987946
Fixes: 151172761
Merged-In: I5c2bacad43917a6ecad49dcf9d3213b3472534cc
Change-Id: I5c2bacad43917a6ecad49dcf9d3213b3472534cc