[clang][docs] Use `option` directive in User's Manual
authorKAWASHIMA Takahiro <t-kawashima@fujitsu.com>
Wed, 16 Nov 2022 04:23:51 +0000 (13:23 +0900)
committerKAWASHIMA Takahiro <t-kawashima@fujitsu.com>
Tue, 22 Nov 2022 01:40:54 +0000 (10:40 +0900)
commit799b6b9f3193bd8a4499da063dc7f74cfccadefd
treedcfb91b96227e135127aee280f8851cfab0f6b28
parent793ff082da87343b27a367b3d80783aedbde833b
[clang][docs] Use `option` directive in User's Manual

Sphinx has the `option` directive. Most option descriptions
in `clang/docs/UsersManual.rst` used it but some didn't.
This commit changes the remaining option descriptions to use
the `option` directive. This makes a consistent view in HTML.

The `option` directive automatically creates a cross-reference target.
So labeling by `.. _opt_XXX:` is almost unnecessary. However, options
with and without `no-` (e.g. `-fno-show-column`/`-fshow-column`)
cannot be distinguish for the cross-reference. So some required
`.. _opt_XXX:` directives are kept unremoved.

Differential Revision: https://reviews.llvm.org/D138088
clang/docs/OpenCLSupport.rst
clang/docs/UsersManual.rst