doc: add a link to the throw-deprecations flag.
Motivation: On the deprecated api's doc, the --pending-deprecation
flag is a clickable link to the command line docs.
This commit makes the --throw-deprecation
flag, which is described in the next paragraph of that doc, also a link.
This is to keep things consistent
Checklist
-
documentation is changed or added -
commit message follows commit guidelines