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