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
Fixes: 149997057
Fixes: 143987946
Change-Id: I5c2bacad43917a6ecad49dcf9d3213b3472534cc