r292968 - [docs] Add TableGen-based generator for command line argument documentation,

[Sean Silva via cfe-commits]

I wasn't sure how to phrase it that wouldn't sound bad. "it's a start"
captures the sentiment in a pretty positive light though :)

One thing that will be useful is increasing the probability that we get
some sort of feedback signal when users find a flag they are interested in
is undocumented (or could be improved). That way we can fill in the missing
pieces on demand, hopefully covering most of the common stuff with
comparatively little effort.

I started adding a "note" box at the top of the page with contents along
the lines of:

"""
This list should be comprehensive, but many options are missing
documentation. If you find that the option you are looking for is missing
documentation, please file a bug at
https://llvm.org/bugs/enter_bug.cgi?product=clang asking for it to be
documented.

Clang supports a large number of options and for historical reasons did not
always have descriptions
"""

But then it struck me that there are two issues:
1. Our bugzilla is currently in lockdown mode due to spam (no new accounts
without emailing llvm-admin). Creating an account in bugzilla is generally
a pain for a small doc improvement request anyway.
2. Users might not read the note (e.g. Ctrl-F directly to the option they
are interested in)

An even more radical idea is to emit an link next to each option that leads
to a pre-populated bug report asking for docs for that specific option.
(for totally undocumented options, link text could be "I need docs for
this" and for ones that already have a description it could be "This
description could be improved")

We could ask them to send an email to cfe-commits (or cfe-dev?), but they
may not (likely not?) be subscribed. That could be done with a "mailto:"
link (which seems to support decent "template"-like functionality
https://css-tricks.com/snippets/html/mailto-links/ ). This may be the best
bet within our current infrastructure. I guess if the messages are mainly
one-way then not being subscribed isn't much of a problem.

(this type of mailto: link is actually how the feedback for the
autocomplete and wolframalpha features seemsto work in Mathematica (though
it generates them dynamically, obviously); I have successfully used these
feedback mechanisms in the past and they are pretty convenient)

Thoughts?

-- Sean Silva

On Sat, Feb 4, 2017 at 10:52 PM, Richard Smith <richard at metafoo.co.uk>
wrote:

> There's still a big pile of undocumented flags, but it's at least a start.
>
> On 4 Feb 2017 9:56 pm, "Sean Silva via cfe-commits" <
> cfe-commits at lists.llvm.org> wrote:
>
>> Thank you so much! With this and the warning documentation you added, we
>> now no longer need to do the "go look at the GCC docs" dance :)
>>
>> -- Sean Silva
>>
>> On Tue, Jan 24, 2017 at 11:39 AM, Richard Smith via cfe-commits <
>> cfe-commits at lists.llvm.org> wrote:
>>
>>> Author: rsmith
>>> Date: Tue Jan 24 13:39:46 2017
>>> New Revision: 292968
>>>
>>> URL: http://llvm.org/viewvc/llvm-project?rev=292968&view=rev
>>> Log:
>>> [docs] Add TableGen-based generator for command line argument
>>> documentation,
>>> and generate documentation for all (non-hidden) options supported by the
>>> 'clang' driver.
>>>
>>> Added:
>>>     cfe/trunk/docs/ClangCommandLineReference.rst
>>>     cfe/trunk/include/clang/Driver/ClangOptionDocs.td
>>>     cfe/trunk/utils/TableGen/ClangOptionDocEmitter.cpp
>>> Modified:
>>>     cfe/trunk/docs/index.rst
>>>     cfe/trunk/include/clang/Driver/CLCompatOptions.td
>>>     cfe/trunk/include/clang/Driver/Options.h
>>>     cfe/trunk/include/clang/Driver/Options.td
>>>     cfe/trunk/utils/TableGen/CMakeLists.txt
>>>     cfe/trunk/utils/TableGen/TableGen.cpp
>>>     cfe/trunk/utils/TableGen/TableGenBackends.h
>>>
>>> Added: cfe/trunk/docs/ClangCommandLineReference.rst
>>> URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/ClangComm
>>> andLineReference.rst?rev=292968&view=auto
>>> ============================================================
>>> ==================
>>> --- cfe/trunk/docs/ClangCommandLineReference.rst (added)
>>> +++ cfe/trunk/docs/ClangCommandLineReference.rst Tue Jan 24 13:39:46
>>> 2017
>>> @@ -0,0 +1,3286 @@
>>> +..
>>> +  -------------------------------------------------------------------
>>> +  NOTE: This file is automatically generated by running clang-tblgen
>>> +  -gen-opt-docs. Do not edit this file by hand!!
>>> +  -------------------------------------------------------------------
>>> +
>>> +=====================================
>>> +Clang command line argument reference
>>> +=====================================
>>> +.. contents::
>>> +   :local:
>>> +
>>> +Introduction
>>> +============
>>> +
>>> +This page lists the command line arguments currently supported by the
>>> +GCC-compatible ``clang`` and ``clang++`` drivers.
>>> +
>>> +
>>> +.. program:: clang
>>> +.. program:: clang0
>>> +.. option:: -A<arg>, --assert <arg>, --assert=<arg>
>>> +
>>> +.. program:: clang1
>>> +.. option:: -B<arg>, --prefix <arg>, --prefix=<arg>
>>> +
>>> +.. program:: clang2
>>> +.. option:: -C, --comments
>>> +
>>> +.. program:: clang3
>>> +.. option:: -CC, --comments-in-macros
>>> +
>>> +.. program:: clang4
>>> +.. option:: -F<arg>
>>> +
>>> +Add directory to framework include search path
>>> +
>>> +.. program:: clang5
>>> +.. option:: -G<arg>
>>> +
>>> +.. program:: clang6
>>> +.. option:: -G=<arg>
>>> +
>>> +.. program:: clang7
>>> +.. option:: -H, --trace-includes
>>> +
>>> +Show header includes and nesting depth
>>> +
>>> +.. program:: clang8
>>> +.. option:: -Mach
>>> +
>>> +.. program:: clang9
>>> +.. option:: -ObjC
>>> +
>>> +Treat source input files as Objective-C inputs
>>> +
>>> +.. program:: clang10
>>> +.. option:: -ObjC++
>>> +
>>> +Treat source input files as Objective-C++ inputs
>>> +
>>> +.. program:: clang11
>>> +.. option:: -P, --no-line-commands
>>> +
>>> +Disable linemarker output in -E mode
>>> +
>>> +.. program:: clang12
>>> +.. option:: -Q
>>> +
>>> +.. program:: clang13
>>> +.. option:: -Qn
>>> +
>>> +.. program:: clang14
>>> +.. option:: -Qunused-arguments
>>> +
>>> +Don't emit warning for unused driver arguments
>>> +
>>> +.. program:: clang15
>>> +.. option:: -Wa,<arg>,<arg2>...
>>> +
>>> +Pass the comma separated arguments in <arg> to the assembler
>>> +
>>> +.. program:: clang16
>>> +.. option:: -Wlarge-by-value-copy=<arg>
>>> +
>>> +.. program:: clang17
>>> +.. option:: -Wp,<arg>,<arg2>...
>>> +
>>> +Pass the comma separated arguments in <arg> to the preprocessor
>>> +
>>> +.. program:: clang18
>>> +.. option:: -X<arg>
>>> +
>>> +.. program:: clang19
>>> +.. option:: -X
>>> +
>>> +.. program:: clang20
>>> +.. option:: -Xanalyzer <arg>
>>> +
>>> +Pass <arg> to the static analyzer
>>> +
>>> +.. program:: clang21
>>> +.. option:: -Xarch\_<arg1> <arg2>
>>> +
>>> +.. program:: clang22
>>> +.. option:: -Xassembler <arg>
>>> +
>>> +Pass <arg> to the assembler
>>> +
>>> +.. program:: clang23
>>> +.. option:: -Xcuda-fatbinary <arg>
>>> +
>>> +Pass <arg> to fatbinary invocation
>>> +
>>> +.. program:: clang24
>>> +.. option:: -Xcuda-ptxas <arg>
>>> +
>>> +Pass <arg> to the ptxas assembler
>>> +
>>> +.. program:: clang25
>>> +.. option:: -Xpreprocessor <arg>
>>> +
>>> +Pass <arg> to the preprocessor
>>> +
>>> +.. program:: clang26
>>> +.. option:: -Z<arg>
>>> +
>>> +.. program:: clang27
>>> +.. option:: -a<arg>, --profile-blocks
>>> +
>>> +.. program:: clang28
>>> +.. option:: -all\_load
>>> +
>>> +.. program:: clang29
>>> +.. option:: -allowable\_client <arg>
>>> +
>>> +.. program:: clang30
>>> +.. option:: --analyze
>>> +
>>> +Run the static analyzer
>>> +
>>> +.. program:: clang31
>>> +.. option:: --analyze-auto
>>> +
>>> +.. program:: clang32
>>> +.. option:: --analyzer-no-default-checks
>>> +
>>> +.. program:: clang33
>>> +.. option:: --analyzer-output<arg>
>>> +
>>> +Static analyzer report output format (html\|plist\|plist-multi-file
>>> \|plist-html\|text).
>>> +
>>> +.. program:: clang34
>>> +.. option:: -ansi, --ansi
>>> +
>>> +.. program:: clang35
>>> +.. option:: -arch <arg>
>>> +
>>> +.. program:: clang36
>>> +.. option:: -arch\_errors\_fatal
>>> +
>>> +.. program:: clang37
>>> +.. option:: -arch\_only <arg>
>>> +
>>> +.. program:: clang38
>>> +.. option:: -arcmt-migrate-emit-errors
>>> +
>>> +Emit ARC errors even if the migrator can fix them
>>> +
>>> +.. program:: clang39
>>> +.. option:: -arcmt-migrate-report-output <arg>
>>> +
>>> +Output path for the plist report
>>> +
>>> +.. program:: clang40
>>> +.. option:: -bind\_at\_load
>>> +
>>> +.. program:: clang41
>>> +.. option:: -bundle
>>> +
>>> +.. program:: clang42
>>> +.. option:: -bundle\_loader <arg>
>>> +
>>> +.. program:: clang43
>>> +.. option:: -c, --compile
>>> +
>>> +Only run preprocess, compile, and assemble steps
>>> +
>>> +.. program:: clang44
>>> +.. option:: -client\_name<arg>
>>> +
>>> +.. program:: clang45
>>> +.. option:: -compatibility\_version<arg>
>>> +
>>> +.. program:: clang46
>>> +.. option:: --constant-cfstrings
>>> +
>>> +.. program:: clang47
>>> +.. option:: -coverage, --coverage
>>> +
>>> +.. program:: clang48
>>> +.. option:: --cuda-compile-host-device
>>> +
>>> +Compile CUDA code for both host and device (default).  Has no effect on
>>> non-CUDA compilations.
>>> +
>>> +.. program:: clang49
>>> +.. option:: --cuda-device-only
>>> +
>>> +Compile CUDA code for device only
>>> +
>>> +.. program:: clang50
>>> +.. option:: --cuda-gpu-arch=<arg>, --no-cuda-gpu-arch=<arg>
>>> +
>>> +CUDA GPU architecture (e.g. sm\_35).  May be specified more than once.
>>> +
>>> +.. program:: clang51
>>> +.. option:: --cuda-host-only
>>> +
>>> +Compile CUDA code for host only.  Has no effect on non-CUDA
>>> compilations.
>>> +
>>> +.. program:: clang52
>>> +.. option:: --cuda-noopt-device-debug, --no-cuda-noopt-device-debug
>>> +
>>> +Enable device-side debug info generation. Disables ptxas optimizations.
>>> +
>>> +.. program:: clang53
>>> +.. option:: -current\_version<arg>
>>> +
>>> +.. program:: clang54
>>> +.. option:: -dead\_strip
>>> +
>>> +.. program:: clang55
>>> +.. option:: -dependency-dot <arg>
>>> +
>>> +Filename to write DOT-formatted header dependencies to
>>> +
>>> +.. program:: clang56
>>> +.. option:: -dependency-file <arg>
>>> +
>>> +Filename (or -) to write dependency output to
>>> +
>>> +.. program:: clang57
>>> +.. option:: -dumpmachine
>>> +
>>> +.. program:: clang58
>>> +.. option:: -dumpversion
>>> +
>>> +.. program:: clang59
>>> +.. option:: --dyld-prefix=<arg>, --dyld-prefix <arg>
>>> +
>>> +.. program:: clang60
>>> +.. option:: -dylib\_file <arg>
>>> +
>>> +.. program:: clang61
>>> +.. option:: -dylinker
>>> +
>>> +.. program:: clang62
>>> +.. option:: -dylinker\_install\_name<arg>
>>> +
>>> +.. program:: clang63
>>> +.. option:: -dynamic
>>> +
>>> +.. program:: clang64
>>> +.. option:: -dynamiclib
>>> +
>>> +.. program:: clang65
>>> +.. option:: -emit-ast
>>> +
>>> +Emit Clang AST files for source inputs
>>> +
>>> +.. program:: clang66
>>> +.. option:: -exported\_symbols\_list <arg>
>>> +
>>> +.. program:: clang67
>>> +.. option:: -faligned-new=<arg>
>>> +
>>> +.. program:: clang68
>>> +.. option:: -fcuda-approx-transcendentals,
>>> -fno-cuda-approx-transcendentals
>>> +
>>> +Use approximate transcendental functions
>>> +
>>> +.. program:: clang69
>>> +.. option:: -fcuda-flush-denormals-to-zero,
>>> -fno-cuda-flush-denormals-to-zero
>>> +
>>> +Flush denormal floating point values to zero in CUDA device mode.
>>> +
>>> +.. program:: clang70
>>> +.. option:: -fheinous-gnu-extensions
>>> +
>>> +.. program:: clang71
>>> +.. option:: -flat\_namespace
>>> +
>>> +.. program:: clang72
>>> +.. option:: -fopenmp-targets=<arg1>,<arg2>...
>>> +
>>> +Specify comma-separated list of triples OpenMP offloading targets to be
>>> supported
>>> +
>>> +.. program:: clang73
>>> +.. option:: -force\_cpusubtype\_ALL
>>> +
>>> +.. program:: clang74
>>> +.. option:: -force\_flat\_namespace
>>> +
>>> +.. program:: clang75
>>> +.. option:: -force\_load <arg>
>>> +
>>> +.. program:: clang76
>>> +.. option:: -framework <arg>
>>> +
>>> +.. program:: clang77
>>> +.. option:: --gcc-toolchain=<arg>, -gcc-toolchain <arg>
>>> +
>>> +Use the gcc toolchain at the given directory
>>> +
>>> +.. program:: clang78
>>> +.. option:: -gcodeview
>>> +
>>> +Generate CodeView debug information
>>> +
>>> +.. program:: clang79
>>> +.. option:: -headerpad\_max\_install\_names<arg>
>>> +
>>> +.. program:: clang80
>>> +.. option:: -help, --help
>>> +
>>> +Display available options
>>> +
>>> +.. program:: clang81
>>> +.. option:: --help-hidden
>>> +
>>> +.. program:: clang82
>>> +.. option:: -image\_base <arg>
>>> +
>>> +.. program:: clang83
>>> +.. option:: -index-header-map
>>> +
>>> +Make the next included directory (-I or -F) an indexer header map
>>> +
>>> +.. program:: clang84
>>> +.. option:: -init <arg>
>>> +
>>> +.. program:: clang85
>>> +.. option:: -install\_name <arg>
>>> +
>>> +.. program:: clang86
>>> +.. option:: -keep\_private\_externs
>>> +
>>> +.. program:: clang87
>>> +.. option:: -lazy\_framework <arg>
>>> +
>>> +.. program:: clang88
>>> +.. option:: -lazy\_library <arg>
>>> +
>>> +.. program:: clang89
>>> +.. option:: -mbig-endian, -EB
>>> +
>>> +.. program:: clang90
>>> +.. option:: --migrate
>>> +
>>> +Run the migrator
>>> +
>>> +.. program:: clang91
>>> +.. option:: -mlinker-version=<arg>
>>> +
>>> +.. program:: clang92
>>> +.. option:: -mlittle-endian, -EL
>>> +
>>> +.. program:: clang93
>>> +.. option:: -mllvm <arg>
>>> +
>>> +Additional arguments to forward to LLVM's option processing
>>> +
>>> +.. program:: clang94
>>> +.. option:: -module-dependency-dir <arg>
>>> +
>>> +Directory to dump module dependencies to
>>> +
>>> +.. program:: clang95
>>> +.. option:: -multi\_module
>>> +
>>> +.. program:: clang96
>>> +.. option:: -multiply\_defined <arg>
>>> +
>>> +.. program:: clang97
>>> +.. option:: -multiply\_defined\_unused <arg>
>>> +
>>> +.. program:: clang98
>>> +.. option:: --no-cuda-version-check
>>> +
>>> +Don't error out if the detected version of the CUDA install is too low
>>> for the requested CUDA gpu architecture.
>>> +
>>> +.. program:: clang99
>>> +.. option:: -no-integrated-cpp, --no-integrated-cpp
>>> +
>>> +.. program:: clang100
>>> +.. option:: -no\_dead\_strip\_inits\_and\_terms
>>> +
>>> +.. program:: clang101
>>> +.. option:: -nobuiltininc
>>> +
>>> +Disable builtin #include directories
>>> +
>>> +.. program:: clang102
>>> +.. option:: -nocudainc
>>> +
>>> +.. program:: clang103
>>> +.. option:: -nocudalib
>>> +
>>> +.. program:: clang104
>>> +.. option:: -nodefaultlibs
>>> +
>>> +.. program:: clang105
>>> +.. option:: -nofixprebinding
>>> +
>>> +.. program:: clang106
>>> +.. option:: -nolibc
>>> +
>>> +.. program:: clang107
>>> +.. option:: -nomultidefs
>>> +
>>> +.. program:: clang108
>>> +.. option:: -nopie
>>> +
>>> +.. program:: clang109
>>> +.. option:: -noprebind
>>> +
>>> +.. program:: clang110
>>> +.. option:: -noseglinkedit
>>> +
>>> +.. program:: clang111
>>> +.. option:: -nostartfiles
>>> +
>>> +.. program:: clang112
>>> +.. option:: -nostdinc, --no-standard-includes
>>> +
>>> +.. program:: clang113
>>> +.. option:: -nostdinc++
>>> +
>>> +Disable standard #include directories for the C++ standard library
>>> +
>>> +.. program:: clang114
>>> +.. option:: -nostdlib, --no-standard-libraries
>>> +
>>> +.. program:: clang115
>>> +.. option:: -nostdlibinc
>>> +
>>> +.. program:: clang116
>>> +.. option:: -o<file>, --output <arg>, --output=<arg>
>>> +
>>> +Write output to <file>
>>> +
>>> +.. program:: clang117
>>> +.. option:: -objcmt-atomic-property
>>> +
>>> +Make migration to 'atomic' properties
>>> +
>>> +.. program:: clang118
>>> +.. option:: -objcmt-migrate-all
>>> +
>>> +Enable migration to modern ObjC
>>> +
>>> +.. program:: clang119
>>> +.. option:: -objcmt-migrate-annotation
>>> +
>>> +Enable migration to property and method annotations
>>> +
>>> +.. program:: clang120
>>> +.. option:: -objcmt-migrate-designated-init
>>> +
>>> +Enable migration to infer NS\_DESIGNATED\_INITIALIZER for initializer
>>> methods
>>> +
>>> +.. program:: clang121
>>> +.. option:: -objcmt-migrate-instancetype
>>> +
>>> +Enable migration to infer instancetype for method result type
>>> +
>>> +.. program:: clang122
>>> +.. option:: -objcmt-migrate-literals
>>> +
>>> +Enable migration to modern ObjC literals
>>> +
>>> +.. program:: clang123
>>> +.. option:: -objcmt-migrate-ns-macros
>>> +
>>> +Enable migration to NS\_ENUM/NS\_OPTIONS macros
>>> +
>>> +.. program:: clang124
>>> +.. option:: -objcmt-migrate-property
>>> +
>>> +Enable migration to modern ObjC property
>>> +
>>> +.. program:: clang125
>>> +.. option:: -objcmt-migrate-property-dot-syntax
>>> +
>>> +Enable migration of setter/getter messages to property-dot syntax
>>> +
>>> +.. program:: clang126
>>> +.. option:: -objcmt-migrate-protocol-conformance
>>> +
>>> +Enable migration to add protocol conformance on classes
>>> +
>>> +.. program:: clang127
>>> +.. option:: -objcmt-migrate-readonly-property
>>> +
>>> +Enable migration to modern ObjC readonly property
>>> +
>>> +.. program:: clang128
>>> +.. option:: -objcmt-migrate-readwrite-property
>>> +
>>> +Enable migration to modern ObjC readwrite property
>>> +
>>> +.. program:: clang129
>>> +.. option:: -objcmt-migrate-subscripting
>>> +
>>> +Enable migration to modern ObjC subscripting
>>> +
>>> +.. program:: clang130
>>> +.. option:: -objcmt-ns-nonatomic-iosonly
>>> +
>>> +Enable migration to use NS\_NONATOMIC\_IOSONLY macro for setting
>>> property's 'atomic' attribute
>>> +
>>> +.. program:: clang131
>>> +.. option:: -objcmt-returns-innerpointer-property
>>> +
>>> +Enable migration to annotate property with NS\_RETURNS\_INNER\_POINTER
>>> +
>>> +.. program:: clang132
>>> +.. option:: -objcmt-whitelist-dir-path=<arg>,
>>> -objcmt-white-list-dir-path=<arg>
>>> +
>>> +Only modify files with a filename contained in the provided directory
>>> path
>>> +
>>> +.. program:: clang133
>>> +.. option:: -object
>>> +
>>> +.. program:: clang134
>>> +.. option:: -p, --profile
>>> +
>>> +.. program:: clang135
>>> +.. option:: -pagezero\_size<arg>
>>> +
>>> +.. program:: clang136
>>> +.. option:: -pg
>>> +
>>> +Enable mcount instrumentation
>>> +
>>> +.. program:: clang137
>>> +.. option:: -pie
>>> +
>>> +.. program:: clang138
>>> +.. option:: -pipe, --pipe
>>> +
>>> +Use pipes between commands, when possible
>>> +
>>> +.. program:: clang139
>>> +.. option:: -prebind
>>> +
>>> +.. program:: clang140
>>> +.. option:: -prebind\_all\_twolevel\_modules
>>> +
>>> +.. program:: clang141
>>> +.. option:: -preload
>>> +
>>> +.. program:: clang142
>>> +.. option:: --print-diagnostic-categories
>>> +
>>> +.. program:: clang143
>>> +.. option:: -print-file-name=<file>, --print-file-name=<file>,
>>> --print-file-name <arg>
>>> +
>>> +Print the full library path of <file>
>>> +
>>> +.. program:: clang144
>>> +.. option:: -print-ivar-layout
>>> +
>>> +Enable Objective-C Ivar layout bitmap print trace
>>> +
>>> +.. program:: clang145
>>> +.. option:: -print-libgcc-file-name, --print-libgcc-file-name
>>> +
>>> +Print the library path for the currently used compiler runtime library
>>> ("libgcc.a" or "libclang\_rt.builtins.\*.a")
>>> +
>>> +.. program:: clang146
>>> +.. option:: -print-multi-directory, --print-multi-directory
>>> +
>>> +.. program:: clang147
>>> +.. option:: -print-multi-lib, --print-multi-lib
>>> +
>>> +.. program:: clang148
>>> +.. option:: -print-prog-name=<name>, --print-prog-name=<name>,
>>> --print-prog-name <arg>
>>> +
>>> +Print the full program path of <name>
>>> +
>>> +.. program:: clang149
>>> +.. option:: -print-search-dirs, --print-search-dirs
>>> +
>>> +Print the paths used for finding libraries and programs
>>> +
>>> +.. program:: clang150
>>> +.. option:: -private\_bundle
>>> +
>>> +.. program:: clang151
>>> +.. option:: -pthread, -no-pthread
>>> +
>>> +Support POSIX threads in generated code
>>> +
>>> +.. program:: clang152
>>> +.. option:: -pthreads
>>> +
>>> +.. program:: clang153
>>> +.. option:: -rdynamic
>>> +
>>> +.. program:: clang154
>>> +.. option:: -read\_only\_relocs <arg>
>>> +
>>> +.. program:: clang155
>>> +.. option:: -relocatable-pch, --relocatable-pch
>>> +
>>> +Whether to build a relocatable precompiled header
>>> +
>>> +.. program:: clang156
>>> +.. option:: -remap
>>> +
>>> +.. program:: clang157
>>> +.. option:: -rewrite-legacy-objc
>>> +
>>> +Rewrite Legacy Objective-C source to C++
>>> +
>>> +.. program:: clang158
>>> +.. option:: -rtlib=<arg>, --rtlib=<arg>, --rtlib <arg>
>>> +
>>> +Compiler runtime library to use
>>> +
>>> +.. program:: clang159
>>> +.. option:: -save-stats=<arg>, --save-stats=<arg>, -save-stats
>>> (equivalent to -save-stats=cwd), --save-stats (equivalent to
>>> -save-stats=cwd)
>>> +
>>> +Save llvm statistics.
>>> +
>>> +.. program:: clang160
>>> +.. option:: -save-temps=<arg>, --save-temps=<arg>, -save-temps
>>> (equivalent to -save-temps=cwd), --save-temps (equivalent to
>>> -save-temps=cwd)
>>> +
>>> +Save intermediate compilation results.
>>> +
>>> +.. program:: clang161
>>> +.. option:: -sectalign <arg1> <arg2> <arg3>
>>> +
>>> +.. program:: clang162
>>> +.. option:: -sectcreate <arg1> <arg2> <arg3>
>>> +
>>> +.. program:: clang163
>>> +.. option:: -sectobjectsymbols <arg1> <arg2>
>>> +
>>> +.. program:: clang164
>>> +.. option:: -sectorder <arg1> <arg2> <arg3>
>>> +
>>> +.. program:: clang165
>>> +.. option:: -seg1addr<arg>
>>> +
>>> +.. program:: clang166
>>> +.. option:: -seg\_addr\_table <arg>
>>> +
>>> +.. program:: clang167
>>> +.. option:: -seg\_addr\_table\_filename <arg>
>>> +
>>> +.. program:: clang168
>>> +.. option:: -segaddr <arg1> <arg2>
>>> +
>>> +.. program:: clang169
>>> +.. option:: -segcreate <arg1> <arg2> <arg3>
>>> +
>>> +.. program:: clang170
>>> +.. option:: -seglinkedit
>>> +
>>> +.. program:: clang171
>>> +.. option:: -segprot <arg1> <arg2> <arg3>
>>> +
>>> +.. program:: clang172
>>> +.. option:: -segs\_read\_<arg>
>>> +
>>> +.. program:: clang173
>>> +.. option:: -segs\_read\_only\_addr <arg>
>>> +
>>> +.. program:: clang174
>>> +.. option:: -segs\_read\_write\_addr <arg>
>>> +
>>> +.. program:: clang175
>>> +.. option:: -serialize-diagnostics <arg>, --serialize-diagnostics <arg>
>>> +
>>> +Serialize compiler diagnostics to a file
>>> +
>>> +.. program:: clang176
>>> +.. option:: -shared, --shared
>>> +
>>> +.. program:: clang177
>>> +.. option:: -shared-libasan
>>> +
>>> +.. program:: clang178
>>> +.. option:: -shared-libgcc
>>> +
>>> +.. program:: clang179
>>> +.. option:: -single\_module
>>> +
>>> +.. program:: clang180
>>> +.. option:: -specs=<arg>, --specs=<arg>
>>> +
>>> +.. program:: clang181
>>> +.. option:: -static, --static
>>> +
>>> +.. program:: clang182
>>> +.. option:: -static-libgcc
>>> +
>>> +.. program:: clang183
>>> +.. option:: -static-libstdc++
>>> +
>>> +.. program:: clang184
>>> +.. option:: -std-default=<arg>
>>> +
>>> +.. program:: clang185
>>> +.. option:: -stdlib=<arg>, --stdlib=<arg>, --stdlib <arg>
>>> +
>>> +C++ standard library to use
>>> +
>>> +.. program:: clang186
>>> +.. option:: -sub\_library<arg>
>>> +
>>> +.. program:: clang187
>>> +.. option:: -sub\_umbrella<arg>
>>> +
>>> +.. program:: clang188
>>> +.. option:: --sysroot=<arg>, --sysroot <arg>
>>> +
>>> +.. program:: clang189
>>> +.. option:: --target-help
>>> +
>>> +.. program:: clang190
>>> +.. option:: --target=<arg>, -target <arg>
>>> +
>>> +Generate code for the given target
>>> +
>>> +.. program:: clang191
>>> +.. option:: -time
>>> +
>>> +Time individual commands
>>> +
>>> +.. program:: clang192
>>> +.. option:: -traditional, --traditional
>>> +
>>> +.. program:: clang193
>>> +.. option:: -traditional-cpp, --traditional-cpp
>>> +
>>> +Enable some traditional CPP emulation
>>> +
>>> +.. program:: clang194
>>> +.. option:: -twolevel\_namespace
>>> +
>>> +.. program:: clang195
>>> +.. option:: -twolevel\_namespace\_hints
>>> +
>>> +.. program:: clang196
>>> +.. option:: -umbrella <arg>
>>> +
>>> +.. program:: clang197
>>> +.. option:: -unexported\_symbols\_list <arg>
>>> +
>>> +.. program:: clang198
>>> +.. option:: -v, --verbose
>>> +
>>> +Show commands to run and use verbose output
>>> +
>>> +.. program:: clang199
>>> +.. option:: --verify-debug-info
>>> +
>>> +Verify the binary representation of debug output
>>> +
>>> +.. program:: clang200
>>> +.. option:: --version
>>> +
>>> +.. program:: clang201
>>> +.. option:: -w, --no-warnings
>>> +
>>> +Suppress all warnings
>>> +
>>> +.. program:: clang202
>>> +.. option:: -weak-l<arg>
>>> +
>>> +.. program:: clang203
>>> +.. option:: -weak\_framework <arg>
>>> +
>>> +.. program:: clang204
>>> +.. option:: -weak\_library <arg>
>>> +
>>> +.. program:: clang205
>>> +.. option:: -weak\_reference\_mismatches <arg>
>>> +
>>> +.. program:: clang206
>>> +.. option:: -whatsloaded
>>> +
>>> +.. program:: clang207
>>> +.. option:: -whyload
>>> +
>>> +.. program:: clang208
>>> +.. option:: -working-directory<arg>, -working-directory=<arg>
>>> +
>>> +Resolve file paths relative to the specified directory
>>> +
>>> +.. program:: clang209
>>> +.. option:: -x<language>, --language <arg>, --language=<arg>
>>> +
>>> +Treat subsequent input files as having type <language>
>>> +
>>> +.. program:: clang210
>>> +.. option:: -y<arg>
>>> +
>>> +Actions
>>> +=======
>>> +The action to perform on the input.
>>> +
>>> +.. program:: clang211
>>> +.. option:: -E, --preprocess
>>> +
>>> +Only run the preprocessor
>>> +
>>> +.. program:: clang212
>>> +.. option:: -S, --assemble
>>> +
>>> +Only run preprocess and compilation steps
>>> +
>>> +.. program:: clang213
>>> +.. option:: -emit-llvm
>>> +
>>> +Use the LLVM representation for assembler and object files
>>> +
>>> +.. program:: clang214
>>> +.. option:: -fsyntax-only
>>> +
>>> +.. program:: clang215
>>> +.. option:: -module-file-info
>>> +
>>> +Provide information about a particular module file
>>> +
>>> +.. program:: clang216
>>> +.. option:: --precompile
>>> +
>>> +Only precompile the input
>>> +
>>> +.. program:: clang217
>>> +.. option:: -rewrite-objc
>>> +
>>> +Rewrite Objective-C source to C++
>>> +
>>> +.. program:: clang218
>>> +.. option:: -verify-pch
>>> +
>>> +Load and verify that a pre-compiled header file is not stale
>>> +
>>> +Compilation flags
>>> +=================
>>> +
>>> +Flags controlling the behavior of Clang during compilation. These flags
>>> have
>>> +no effect during actions that do not perform compilation.
>>> +
>>> +.. program:: clang219
>>> +.. option:: -D<arg>, --define-macro <arg>, --define-macro=<arg>
>>> +
>>> +.. program:: clang220
>>> +.. option:: -U<arg>, --undefine-macro <arg>, --undefine-macro=<arg>
>>> +
>>> +.. program:: clang221
>>> +.. option:: -Xclang <arg>
>>> +
>>> +Pass <arg> to the clang compiler
>>> +
>>> +.. program:: clang222
>>> +.. option:: -fcomment-block-commands=<arg>,<arg2>...
>>> +
>>> +Treat each comma separated argument in <arg> as a documentation comment
>>> block command
>>> +
>>> +.. program:: clang223
>>> +.. option:: -fdeclspec, -fno-declspec
>>> +
>>> +Allow \_\_declspec as a keyword
>>> +
>>> +.. program:: clang224
>>> +.. option:: -fdepfile-entry=<arg>
>>> +
>>> +.. program:: clang225
>>> +.. option:: -fdiagnostics-fixit-info, -fno-diagnostics-fixit-info
>>> +
>>> +.. program:: clang226
>>> +.. option:: -fdiagnostics-format=<arg>
>>> +
>>> +.. program:: clang227
>>> +.. option:: -fdiagnostics-parseable-fixits
>>> +
>>> +Print fix-its in machine parseable form
>>> +
>>> +.. program:: clang228
>>> +.. option:: -fdiagnostics-print-source-range-info
>>> +
>>> +Print source range spans in numeric form
>>> +
>>> +.. program:: clang229
>>> +.. option:: -fdiagnostics-show-category=<arg>
>>> +
>>> +.. program:: clang230
>>> +.. option:: -fexperimental-new-pass-manager,
>>> -fno-experimental-new-pass-manager
>>> +
>>> +Enables an experimental new pass manager in LLVM.
>>> +
>>> +.. program:: clang231
>>> +.. option:: -finline-functions, -fno-inline-functions
>>> +
>>> +Inline suitable functions
>>> +
>>> +.. program:: clang232
>>> +.. option:: -finline-hint-functions
>>> +
>>> +Inline functions which are (explicitly or implicitly) marked inline
>>> +
>>> +.. program:: clang233
>>> +.. option:: -fno-crash-diagnostics
>>> +
>>> +.. program:: clang234
>>> +.. option:: -fno-sanitize-blacklist
>>> +
>>> +Don't use blacklist file for sanitizers
>>> +
>>> +.. program:: clang235
>>> +.. option:: -fparse-all-comments
>>> +
>>> +.. program:: clang236
>>> +.. option:: -fsanitize-address-field-padding=<arg>
>>> +
>>> +Level of field padding for AddressSanitizer
>>> +
>>> +.. program:: clang237
>>> +.. option:: -fsanitize-address-use-after-scope,
>>> -fno-sanitize-address-use-after-scope
>>> +
>>> +Enable use-after-scope detection in AddressSanitizer
>>> +
>>> +.. program:: clang238
>>> +.. option:: -fsanitize-blacklist=<arg>
>>> +
>>> +Path to blacklist file for sanitizers
>>> +
>>> +.. program:: clang239
>>> +.. option:: -fsanitize-cfi-cross-dso, -fno-sanitize-cfi-cross-dso
>>> +
>>> +Enable control flow integrity (CFI) checks for cross-DSO calls.
>>> +
>>> +.. program:: clang240
>>> +.. option:: -fsanitize-coverage=<arg1>,<arg2>...,
>>> -fno-sanitize-coverage=<arg1>,<arg2>...
>>> +
>>> +Specify the type of coverage instrumentation for Sanitizers
>>> +
>>> +.. program:: clang241
>>> +.. option:: -fsanitize-link-c++-runtime
>>> +
>>> +.. program:: clang242
>>> +.. option:: -fsanitize-memory-track-origins,
>>> -fno-sanitize-memory-track-origins
>>> +
>>> +Enable origins tracking in MemorySanitizer
>>> +
>>> +.. program:: clang243
>>> +.. option:: -fsanitize-memory-track-origins=<arg>
>>> +
>>> +Enable origins tracking in MemorySanitizer
>>> +
>>> +.. program:: clang244
>>> +.. option:: -fsanitize-memory-use-after-dtor
>>> +
>>> +Enable use-after-destroy detection in MemorySanitizer
>>> +
>>> +.. program:: clang245
>>> +.. option:: -fsanitize-recover, -fno-sanitize-recover
>>> +
>>> +.. program:: clang246
>>> +.. option:: -fsanitize-recover=<arg1>,<arg2>...,
>>> -fno-sanitize-recover=<arg1>,<arg2>...
>>> +
>>> +Enable recovery for specified sanitizers
>>> +
>>> +.. program:: clang247
>>> +.. option:: -fsanitize-stats, -fno-sanitize-stats
>>> +
>>> +Enable sanitizer statistics gathering.
>>> +
>>> +.. program:: clang248
>>> +.. option:: -fsanitize-thread-atomics, -fno-sanitize-thread-atomics
>>> +
>>> +Enable atomic operations instrumentation in ThreadSanitizer (default)
>>> +
>>> +.. program:: clang249
>>> +.. option:: -fsanitize-thread-func-entry-exit,
>>> -fno-sanitize-thread-func-entry-exit
>>> +
>>> +Enable function entry/exit instrumentation in ThreadSanitizer (default)
>>> +
>>> +.. program:: clang250
>>> +.. option:: -fsanitize-thread-memory-access,
>>> -fno-sanitize-thread-memory-access
>>> +
>>> +Enable memory access instrumentation in ThreadSanitizer (default)
>>> +
>>> +.. program:: clang251
>>> +.. option:: -fsanitize-trap=<arg1>,<arg2>...,
>>> -fno-sanitize-trap=<arg1>,<arg2>...
>>> +
>>> +Enable trapping for specified sanitizers
>>> +
>>> +.. program:: clang252
>>> +.. option:: -fsanitize-undefined-strip-path-components=<number>
>>> +
>>> +Strip (or keep only, if negative) a given number of path components
>>> when emitting check metadata.
>>> +
>>> +.. program:: clang253
>>> +.. option:: -fsanitize-undefined-trap-on-error,
>>> -fno-sanitize-undefined-trap-on-error
>>> +
>>> +.. program:: clang254
>>> +.. option:: -fsanitize=<check>,<arg2>..., -fno-sanitize=<arg1>,<arg2>...
>>> +
>>> +Turn on runtime checks for various forms of undefined or suspicious
>>> behavior. See user manual for available checks
>>> +
>>> +.. program:: clang255
>>> +.. option:: --param <arg>, --param=<arg>
>>> +
>>> +.. program:: clang256
>>> +.. option:: -std=<arg>, --std=<arg>, --std <arg>
>>> +
>>> +Language standard to compile for
>>> +
>>> +Include path management
>>> +~~~~~~~~~~~~~~~~~~~~~~~
>>> +
>>> +Flags controlling how ``#include``\s are resolved to files.
>>> +
>>> +.. program:: clang257
>>> +.. option:: -I<arg>, --include-directory <arg>,
>>> --include-directory=<arg>
>>> +
>>> +Add directory to include search path
>>> +
>>> +.. program:: clang258
>>> +.. option:: -I-, --include-barrier
>>> +
>>> +.. program:: clang259
>>> +.. option:: --cuda-path=<arg>
>>> +
>>> +CUDA installation path
>>> +
>>> +.. program:: clang260
>>> +.. option:: -cxx-isystem<directory>
>>> +
>>> +Add directory to the C++ SYSTEM include search path
>>> +
>>> +.. program:: clang261
>>> +.. option:: -fbuild-session-file=<file>
>>> +
>>> +Use the last modification time of <file> as the build session timestamp
>>> +
>>> +.. program:: clang262
>>> +.. option:: -fbuild-session-timestamp=<time since Epoch in seconds>
>>> +
>>> +Time when the current build session started
>>> +
>>> +.. program:: clang263
>>> +.. option:: -fmodules-cache-path=<directory>
>>> +
>>> +Specify the module cache path
>>> +
>>> +.. program:: clang264
>>> +.. option:: -fmodules-disable-diagnostic-validation
>>> +
>>> +Disable validation of the diagnostic options when loading the module
>>> +
>>> +.. program:: clang265
>>> +.. option:: -fmodules-prune-after=<seconds>
>>> +
>>> +Specify the interval (in seconds) after which a module file will be
>>> considered unused
>>> +
>>> +.. program:: clang266
>>> +.. option:: -fmodules-prune-interval=<seconds>
>>> +
>>> +Specify the interval (in seconds) between attempts to prune the module
>>> cache
>>> +
>>> +.. program:: clang267
>>> +.. option:: -fmodules-user-build-path <directory>
>>> +
>>> +Specify the module user build path
>>> +
>>> +.. program:: clang268
>>> +.. option:: -fmodules-validate-once-per-build-session
>>> +
>>> +Don't verify input files for the modules if the module has been
>>> successfully validated or loaded during this build session
>>> +
>>> +.. program:: clang269
>>> +.. option:: -fmodules-validate-system-headers
>>> +
>>> +Validate the system headers that a module depends on when loading the
>>> module
>>> +
>>> +.. program:: clang270
>>> +.. option:: -fprebuilt-module-path=<directory>
>>> +
>>> +Specify the prebuilt module path
>>> +
>>> +.. program:: clang271
>>> +.. option:: -i<arg>
>>> +
>>> +.. program:: clang272
>>> +.. option:: -idirafter<arg>, --include-directory-after <arg>,
>>> --include-directory-after=<arg>
>>> +
>>> +Add directory to AFTER include search path
>>> +
>>> +.. program:: clang273
>>> +.. option:: -iframework<arg>
>>> +
>>> +Add directory to SYSTEM framework search path
>>> +
>>> +.. program:: clang274
>>> +.. option:: -imacros<file>, --imacros<file>, --imacros=<arg>
>>> +
>>> +Include macros from file before parsing
>>> +
>>> +.. program:: clang275
>>> +.. option:: -include<file>, --include<file>, --include=<arg>
>>> +
>>> +Include file before parsing
>>> +
>>> +.. program:: clang276
>>> +.. option:: -include-pch <file>
>>> +
>>> +Include precompiled header file
>>> +
>>> +.. program:: clang277
>>> +.. option:: -iprefix<dir>, --include-prefix <arg>,
>>> --include-prefix=<arg>
>>> +
>>> +Set the -iwithprefix/-iwithprefixbefore prefix
>>> +
>>> +.. program:: clang278
>>> +.. option:: -iquote<directory>
>>> +
>>> +Add directory to QUOTE include search path
>>> +
>>> +.. program:: clang279
>>> +.. option:: -isysroot<dir>
>>> +
>>> +Set the system root directory (usually /)
>>> +
>>> +.. program:: clang280
>>> +.. option:: -isystem<directory>
>>> +
>>> +Add directory to SYSTEM include search path
>>> +
>>> +.. program:: clang281
>>> +.. option:: -isystem-after<directory>
>>> +
>>> +Add directory to end of the SYSTEM include search path
>>> +
>>> +.. program:: clang282
>>> +.. option:: -ivfsoverlay<arg>
>>> +
>>> +Overlay the virtual filesystem described by file over the real file
>>> system
>>> +
>>> +.. program:: clang283
>>> +.. option:: -iwithprefix<dir>, --include-with-prefix <arg>,
>>> --include-with-prefix-after <arg>, --include-with-prefix-after=<arg>,
>>> --include-with-prefix=<arg>
>>> +
>>> +Set directory to SYSTEM include search path with prefix
>>> +
>>> +.. program:: clang284
>>> +.. option:: -iwithprefixbefore<dir>, --include-with-prefix-before
>>> <arg>, --include-with-prefix-before=<arg>
>>> +
>>> +Set directory to include search path with prefix
>>> +
>>> +.. program:: clang285
>>> +.. option:: -iwithsysroot<directory>
>>> +
>>> +Add directory to SYSTEM include search path, absolute paths are
>>> relative to -isysroot
>>> +
>>> +.. program:: clang286
>>> +.. option:: --ptxas-path=<arg>
>>> +
>>> +Path to ptxas (used for compiling CUDA code)
>>> +
>>> +.. program:: clang287
>>> +.. option:: --system-header-prefix=<prefix>,
>>> --no-system-header-prefix=<prefix>, --system-header-prefix <arg>
>>> +
>>> +Treat all #include paths starting with <prefix> as including a system
>>> header.
>>> +
>>> +Dependency file generation
>>> +~~~~~~~~~~~~~~~~~~~~~~~~~~
>>> +
>>> +Flags controlling generation of a dependency file for ``make``-like
>>> build
>>> +systems.
>>> +
>>> +.. program:: clang288
>>> +.. option:: -M, --dependencies
>>> +
>>> +Like -MD, but also implies -E and writes to stdout by default
>>> +
>>> +.. program:: clang289
>>> +.. option:: -MD, --write-dependencies
>>> +
>>> +Write a depfile containing user and system headers
>>> +
>>> +.. program:: clang290
>>> +.. option:: -MF<file>
>>> +
>>> +Write depfile output from -MMD, -MD, -MM, or -M to <file>
>>> +
>>> +.. program:: clang291
>>> +.. option:: -MG, --print-missing-file-dependencies
>>> +
>>> +Add missing headers to depfile
>>> +
>>> +.. program:: clang292
>>> +.. option:: -MJ<arg>
>>> +
>>> +Write a compilation database entry per input
>>> +
>>> +.. program:: clang293
>>> +.. option:: -MM, --user-dependencies
>>> +
>>> +Like -MMD, but also implies -E and writes to stdout by default
>>> +
>>> +.. program:: clang294
>>> +.. option:: -MMD, --write-user-dependencies
>>> +
>>> +Write a depfile containing user headers
>>> +
>>> +.. program:: clang295
>>> +.. option:: -MP
>>> +
>>> +Create phony target for each dependency (other than main file)
>>> +
>>> +.. program:: clang296
>>> +.. option:: -MQ<arg>
>>> +
>>> +Specify name of main file output to quote in depfile
>>> +
>>> +.. program:: clang297
>>> +.. option:: -MT<arg>
>>> +
>>> +Specify name of main file output in depfile
>>> +
>>> +.. program:: clang298
>>> +.. option:: -MV
>>> +
>>> +Use NMake/Jom format for the depfile
>>> +
>>> +Dumping preprocessor state
>>> +~~~~~~~~~~~~~~~~~~~~~~~~~~
>>> +
>>> +Flags allowing the state of the preprocessor to be dumped in various
>>> ways.
>>> +
>>> +.. program:: clang299
>>> +.. option:: -d
>>> +
>>> +.. program:: clang300
>>> +.. option:: -d<arg>
>>> +
>>> +.. program:: clang301
>>> +.. option:: -dA
>>> +
>>> +.. program:: clang302
>>> +.. option:: -dD
>>> +
>>> +Print macro definitions in -E mode in addition to normal output
>>> +
>>> +.. program:: clang303
>>> +.. option:: -dI
>>> +
>>> +Print include directives in -E mode in addition to normal output
>>> +
>>> +.. program:: clang304
>>> +.. option:: -dM
>>> +
>>> +Print macro definitions in -E mode instead of normal output
>>> +
>>> +Diagnostic flags
>>> +~~~~~~~~~~~~~~~~
>>> +
>>> +Flags controlling which warnings, errors, and remarks Clang will
>>> generate.
>>> +See the :doc:`full list of warning and remark flags
>>> <DiagnosticsReference>`.
>>> +
>>> +.. program:: clang305
>>> +.. option:: -R<remark>
>>> +
>>> +Enable the specified remark
>>> +
>>> +.. program:: clang306
>>> +.. option:: -Rpass-analysis=<arg>
>>> +
>>> +Report transformation analysis from optimization passes whose name
>>> matches the given POSIX regular expression
>>> +
>>> +.. program:: clang307
>>> +.. option:: -Rpass-missed=<arg>
>>> +
>>> +Report missed transformations by optimization passes whose name matches
>>> the given POSIX regular expression
>>> +
>>> +.. program:: clang308
>>> +.. option:: -Rpass=<arg>
>>> +
>>> +Report transformations performed by optimization passes whose name
>>> matches the given POSIX regular expression
>>> +
>>> +.. program:: clang309
>>> +.. option:: -W<warning>, --extra-warnings, --warn-<arg>, --warn-=<arg>
>>> +
>>> +Enable the specified warning
>>> +
>>> +.. program:: clang310
>>> +.. option:: -WCL4
>>> +
>>> +.. program:: clang311
>>> +.. option:: -Wall, --all-warnings
>>> +
>>> +.. program:: clang312
>>> +.. option:: -Wdeprecated, -Wno-deprecated
>>> +
>>> +.. program:: clang313
>>> +.. option:: -Wextra
>>> +
>>> +.. program:: clang314
>>> +.. option:: -Wnonportable-cfstrings<arg>, -Wno-nonportable-cfstrings<arg
>>> >
>>> +
>>> +.. program:: clang315
>>> +.. option:: -Wwrite-strings, -Wno-write-strings
>>> +
>>> +Target-independent compilation options
>>> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>>> +.. program:: clang316
>>> +.. option:: -Wframe-larger-than=<arg>
>>> +
>>> +.. program:: clang317
>>> +.. option:: -fPIC, -fno-PIC
>>> +
>>> +.. program:: clang318
>>> +.. option:: -fPIE, -fno-PIE
>>> +
>>> +.. program:: clang319
>>> +.. option:: -faccess-control, -fno-access-control
>>> +
>>> +.. program:: clang320
>>> +.. option:: -faligned-allocation, -faligned-new, -fno-aligned-allocation
>>> +
>>> +Enable C++17 aligned allocation functions
>>> +
>>> +.. program:: clang321
>>> +.. option:: -fallow-unsupported
>>> +
>>> +.. program:: clang322
>>> +.. option:: -faltivec, -fno-altivec, -maltivec
>>> +
>>> +Enable AltiVec vector initializer syntax
>>> +
>>> +.. program:: clang323
>>> +.. option:: -fansi-escape-codes
>>> +
>>> +Use ANSI escape codes for diagnostics
>>> +
>>> +.. program:: clang324
>>> +.. option:: -fapple-kext, -findirect-virtual-calls, -fterminated-vtables
>>> +
>>> +Use Apple's kernel extensions ABI
>>> +
>>> +.. program:: clang325
>>> +.. option:: -fapple-pragma-pack, -fno-apple-pragma-pack
>>> +
>>> +Enable Apple gcc-compatible #pragma pack handling
>>> +
>>> +.. program:: clang326
>>> +.. option:: -fapplication-extension, -fno-application-extension
>>> +
>>> +Restrict code to those available for App Extensions
>>> +
>>> +.. program:: clang327
>>> +.. option:: -fasm, -fno-asm
>>> +
>>> +.. program:: clang328
>>> +.. option:: -fasm-blocks, -fno-asm-blocks
>>> +
>>> +.. program:: clang329
>>> +.. option:: -fassociative-math, -fno-associative-math
>>> +
>>> +.. program:: clang330
>>> +.. option:: -fassume-sane-operator-new, -fno-assume-sane-operator-new
>>> +
>>> +.. program:: clang331
>>> +.. option:: -fast
>>> +
>>> +.. program:: clang332
>>> +.. option:: -fastcp
>>> +
>>> +.. program:: clang333
>>> +.. option:: -fastf
>>> +
>>> +.. program:: clang334
>>> +.. option:: -fasynchronous-unwind-tables, -fno-asynchronous-unwind-table
>>> s
>>> +
>>> +.. program:: clang335
>>> +.. option:: -fautolink, -fno-autolink
>>> +
>>> +.. program:: clang336
>>> +.. option:: -fblocks, -fno-blocks
>>> +
>>> +Enable the 'blocks' language feature
>>> +
>>> +.. program:: clang337
>>> +.. option:: -fbootclasspath=<arg>, --bootclasspath <arg>,
>>> --bootclasspath=<arg>
>>> +
>>> +.. program:: clang338
>>> +.. option:: -fborland-extensions, -fno-borland-extensions
>>> +
>>> +Accept non-standard constructs supported by the Borland compiler
>>> +
>>> +.. program:: clang339
>>> +.. option:: -fbracket-depth=<arg>
>>> +
>>> +.. program:: clang340
>>> +.. option:: -fbuiltin, -fno-builtin
>>> +
>>> +.. program:: clang341
>>> +.. option:: -fbuiltin-module-map
>>> +
>>> +Load the clang builtins module map file.
>>> +
>>> +.. program:: clang342
>>> +.. option:: -fcaret-diagnostics, -fno-caret-diagnostics
>>> +
>>> +.. program:: clang343
>>> +.. option:: -fclasspath=<arg>, --CLASSPATH <arg>, --CLASSPATH=<arg>,
>>> --classpath <arg>, --classpath=<arg>
>>> +
>>> +.. program:: clang344
>>> +.. option:: -fcolor-diagnostics, -fno-color-diagnostics
>>> +
>>> +Use colors in diagnostics
>>> +
>>> +.. program:: clang345
>>> +.. option:: -fcommon, -fno-common
>>> +
>>> +.. program:: clang346
>>> +.. option:: -fcompile-resource=<arg>, --resource <arg>, --resource=<arg>
>>> +
>>> +.. program:: clang347
>>> +.. option:: -fconstant-cfstrings, -fno-constant-cfstrings
>>> +
>>> +.. program:: clang348
>>> +.. option:: -fconstant-string-class=<arg>
>>> +
>>> +.. program:: clang349
>>> +.. option:: -fconstexpr-backtrace-limit=<arg>
>>> +
>>> +.. program:: clang350
>>> +.. option:: -fconstexpr-depth=<arg>
>>> +
>>> +.. program:: clang351
>>> +.. option:: -fconstexpr-steps=<arg>
>>> +
>>> +.. program:: clang352
>>> +.. option:: -fcoroutines-ts, -fno-coroutines-ts
>>> +
>>> +Enable support for the C++ Coroutines TS
>>> +
>>> +.. program:: clang353
>>> +.. option:: -fcoverage-mapping, -fno-coverage-mapping
>>> +
>>> +Generate coverage mapping to enable code coverage analysis
>>> +
>>> +.. program:: clang354
>>> +.. option:: -fcreate-profile
>>> +
>>> +.. program:: clang355
>>> +.. option:: -fcxx-exceptions, -fno-cxx-exceptions
>>> +
>>> +Enable C++ exceptions
>>> +
>>> +.. program:: clang356
>>> +.. option:: -fcxx-modules, -fno-cxx-modules
>>> +
>>> +.. program:: clang357
>>> +.. option:: -fdata-sections, -fno-data-sections
>>> +
>>> +Place each data in its own section (ELF Only)
>>> +
>>> +.. program:: clang358
>>> +.. option:: -fdebug-info-for-profiling, -fno-debug-info-for-profiling
>>> +
>>> +Emit extra debug info to make sample profile more accurate.
>>> +
>>> +.. program:: clang359
>>> +.. option:: -fdebug-pass-arguments
>>> +
>>> +.. program:: clang360
>>> +.. option:: -fdebug-pass-structure
>>> +
>>> +.. program:: clang361
>>> +.. option:: -fdebug-prefix-map=<arg>
>>> +
>>> +remap file source paths in debug info
>>> +
>>> +.. program:: clang362
>>> +.. option:: -fdebug-types-section, -fno-debug-types-section
>>> +
>>> +Place debug types in their own section (ELF Only)
>>> +
>>> +.. program:: clang363
>>> +.. option:: -fdelayed-template-parsing, -fno-delayed-template-parsing
>>> +
>>> +Parse templated function definitions at the end of the translation unit
>>> +
>>> +.. program:: clang364
>>> +.. option:: -fdenormal-fp-math=<arg>
>>> +
>>> +.. program:: clang365
>>> +.. option:: -fdiagnostics-absolute-paths
>>> +
>>> +Print absolute paths in diagnostics
>>> +
>>> +.. program:: clang366
>>> +.. option:: -fdiagnostics-color, -fno-diagnostics-color
>>> +
>>> +.. program:: clang367
>>> +.. option:: -fdiagnostics-color=<arg>
>>> +
>>> +.. program:: clang368
>>> +.. option:: -fdiagnostics-show-hotness, -fno-diagnostics-show-hotness
>>> +
>>> +Enable profile hotness information in diagnostic line
>>> +
>>> +.. program:: clang369
>>> +.. option:: -fdiagnostics-show-note-include-stack,
>>> -fno-diagnostics-show-note-include-stack
>>> +
>>> +Display include stacks for diagnostic notes
>>> +
>>> +.. program:: clang370
>>> +.. option:: -fdiagnostics-show-option, -fno-diagnostics-show-option
>>> +
>>> +Print option name with mappable diagnostics
>>> +
>>> +.. program:: clang371
>>> +.. option:: -fdiagnostics-show-template-tree
>>> +
>>> +Print a template comparison tree for differing templates
>>> +
>>> +.. program:: clang372
>>> +.. option:: -fdollars-in-identifiers, -fno-dollars-in-identifiers
>>> +
>>> +Allow '$' in identifiers
>>> +
>>> +.. program:: clang373
>>> +.. option:: -fdwarf-directory-asm, -fno-dwarf-directory-asm
>>> +
>>> +.. program:: clang374
>>> +.. option:: -felide-constructors, -fno-elide-constructors
>>> +
>>> +.. program:: clang375
>>> +.. option:: -feliminate-unused-debug-symbols,
>>> -fno-eliminate-unused-debug-symbols
>>> +
>>> +.. program:: clang376
>>> +.. option:: -fembed-bitcode=<option>, -fembed-bitcode (equivalent to
>>> -fembed-bitcode=all), -fembed-bitcode-marker (equivalent to
>>> -fembed-bitcode=marker)
>>> +
>>> +Embed LLVM bitcode (option: off, all, bitcode, marker)
>>> +
>>> +.. program:: clang377
>>> +.. option:: -femit-all-decls
>>> +
>>> +Emit all declarations, even if unused
>>> +
>>> +.. program:: clang378
>>> +.. option:: -femulated-tls, -fno-emulated-tls
>>> +
>>> +Use emutls functions to access thread\_local variables
>>> +
>>> +.. program:: clang379
>>> +.. option:: -fencoding=<arg>, --encoding <arg>, --encoding=<arg>
>>> +
>>> +.. program:: clang380
>>> +.. option:: -ferror-limit=<arg>
>>> +
>>> +.. program:: clang381
>>> +.. option:: -fexceptions, -fno-exceptions
>>> +
>>> +Enable support for exception handling
>>> +
>>> +.. program:: clang382
>>> +.. option:: -fexec-charset=<arg>
>>> +
>>> +.. program:: clang383
>>> +.. option:: -fextdirs=<arg>, --extdirs <arg>, --extdirs=<arg>
>>> +
>>> +.. program:: clang384
>>> +.. option:: -ffast-math, -fno-fast-math
>>> +
>>> +Allow aggressive, lossy floating-point optimizations
>>> +
>>> +.. program:: clang385
>>> +.. option:: -ffinite-math-only, -fno-finite-math-only
>>> +
>>> +.. program:: clang386
>>> +.. option:: -ffor-scope, -fno-for-scope
>>> +
>>> +.. program:: clang387
>>> +.. option:: -ffp-contract=<arg>
>>> +
>>> +Form fused FP ops (e.g. FMAs): fast (everywhere) \| on (according to
>>> FP\_CONTRACT pragma, default) \| off (never fuse)
>>> +
>>> +.. program:: clang388
>>> +.. option:: -ffreestanding
>>> +
>>> +Assert that the compilation takes place in a freestanding environment
>>> +
>>> +.. program:: clang389
>>> +.. option:: -ffunction-sections, -fno-function-sections
>>> +
>>> +Place each function in its own section (ELF Only)
>>> +
>>> +.. program:: clang390
>>> +.. option:: -fgnu-inline-asm, -fno-gnu-inline-asm
>>> +
>>> +.. program:: clang391
>>> +.. option:: -fgnu-keywords, -fno-gnu-keywords
>>> +
>>> +Allow GNU-extension keywords regardless of language standard
>>> +
>>> +.. program:: clang392
>>> +.. option:: -fgnu-runtime
>>> +
>>> +Generate output compatible with the standard GNU Objective-C runtime
>>> +
>>> +.. program:: clang393
>>> +.. option:: -fgnu89-inline, -fno-gnu89-inline
>>> +
>>> +Use the gnu89 inline semantics
>>> +
>>> +.. program:: clang394
>>> +.. option:: -fhonor-infinities, -fhonor-infinites, -fno-honor-infinities
>>> +
>>> +.. program:: clang395
>>> +.. option:: -fhonor-nans, -fno-honor-nans
>>> +
>>> +.. program:: clang396
>>> +.. option:: -fhosted
>>> +
>>> +.. program:: clang397
>>> +.. option:: -fimplicit-module-maps, -fmodule-maps,
>>> -fno-implicit-module-maps
>>> +
>>> +Implicitly search the file system for module map files.
>>> +
>>> +.. program:: clang398
>>> +.. option:: -fimplicit-modules, -fno-implicit-modules
>>> +
>>> +.. program:: clang399
>>> +.. option:: -finput-charset=<arg>
>>> +
>>> +.. program:: clang400
>>> +.. option:: -finstrument-functions
>>> +
>>> +Generate calls to instrument function entry and exit
>>> +
>>> +.. program:: clang401
>>> +.. option:: -fintegrated-as, -fno-integrated-as, -integrated-as
>>> +
>>> +Enable the integrated assembler
>>> +
>>> +.. program:: clang402
>>> +.. option:: -fjump-tables, -fno-jump-tables
>>> +
>>> +.. program:: clang403
>>> +.. option:: -flax-vector-conversions, -fno-lax-vector-conversions
>>> +
>>> +.. program:: clang404
>>> +.. option:: -flimited-precision=<arg>
>>> +
>>> +.. program:: clang405
>>> +.. option:: -flto, -fno-lto
>>> +
>>> +Enable LTO in 'full' mode
>>> +
>>> +.. program:: clang406
>>> +.. option:: -flto-jobs=<arg>
>>> +
>>> +Controls the backend parallelism of -flto=thin (default of 0 means the
>>> number of threads will be derived from the number of CPUs detected)
>>> +
>>> +.. program:: clang407
>>> +.. option:: -flto=<arg>
>>> +
>>> +Set LTO mode to either 'full' or 'thin'
>>> +
>>> +.. program:: clang408
>>> +.. option:: -fmacro-backtrace-limit=<arg>
>>> +
>>> +.. program:: clang409
>>> +.. option:: -fmath-errno, -fno-math-errno
>>> +
>>> +Require math functions to indicate errors by setting errno
>>> +
>>> +.. program:: clang410
>>> +.. option:: -fmax-type-align=<arg>
>>> +
>>> +Specify the maximum alignment to enforce on pointers lacking an
>>> explicit alignment
>>> +
>>> +.. program:: clang411
>>> +.. option:: -fmerge-all-constants, -fno-merge-all-constants
>>> +
>>> +.. program:: clang412
>>> +.. option:: -fmessage-length=<arg>
>>> +
>>> +.. program:: clang413
>>> +.. option:: -fmodule-file-deps, -fno-module-file-deps
>>> +
>>> +.. program:: clang414
>>> +.. option:: -fmodule-file=<file>
>>> +
>>> +Load this precompiled module file
>>> +
>>> +.. program:: clang415
>>> +.. option:: -fmodule-map-file=<file>
>>> +
>>> +Load this module map file
>>> +
>>> +.. program:: clang416
>>> +.. option:: -fmodule-name=<name>, -fmodule-implementation-of <arg>,
>>> -fmodule-name <arg>
>>> +
>>> +Specify the name of the module to build
>>> +
>>> +.. program:: clang417
>>> +.. option:: -fmodules, -fno-modules
>>> +
>>> +Enable the 'modules' language feature
>>> +
>>> +.. program:: clang418
>>> +.. option:: -fmodules-decluse, -fno-modules-decluse
>>> +
>>> +Require declaration of modules used within a module
>>> +
>>> +.. program:: clang419
>>> +.. option:: -fmodules-ignore-macro=<arg>
>>> +
>>> +Ignore the definition of the given macro when building and loading
>>> modules
>>> +
>>> +.. program:: clang420
>>> +.. option:: -fmodules-search-all, -fno-modules-search-all
>>> +
>>> +Search even non-imported modules to resolve references
>>> +
>>> +.. program:: clang421
>>> +.. option:: -fmodules-strict-decluse
>>> +
>>> +Like -fmodules-decluse but requires all headers to be in modules
>>> +
>>> +.. program:: clang422
>>> +.. option:: -fmodules-ts
>>> +
>>> +Enable support for the C++ Modules TS
>>> +
>>> +.. program:: clang423
>>> +.. option:: -fms-compatibility, -fno-ms-compatibility
>>> +
>>> +Enable full Microsoft Visual C++ compatibility
>>> +
>>> +.. program:: clang424
>>> +.. option:: -fms-compatibility-version=<arg>
>>> +
>>> +Dot-separated value representing the Microsoft compiler version number
>>> to report in \_MSC\_VER (0 = don't define it (default))
>>> +
>>> +.. program:: clang425
>>> +.. option:: -fms-extensions, -fno-ms-extensions
>>> +
>>> +Accept some non-standard constructs supported by the Microsoft compiler
>>> +
>>> +.. program:: clang426
>>> +.. option:: -fms-memptr-rep=<arg>
>>> +
>>> +.. program:: clang427
>>> +.. option:: -fms-volatile<arg>
>>> +
>>> +.. program:: clang428
>>> +.. option:: -fmsc-version=<arg>
>>> +
>>> +Microsoft compiler version number to report in \_MSC\_VER (0 = don't
>>> define it (default))
>>> +
>>> +.. program:: clang429
>>> +.. option:: -fmudflap
>>> +
>>> +.. program:: clang430
>>> +.. option:: -fmudflapth
>>> +
>>> +.. program:: clang431
>>> +.. option:: -fnested-functions
>>> +
>>> +.. program:: clang432
>>> +.. option:: -fnew-alignment=<align>, -fnew-alignment <arg>
>>> +
>>> +Specifies the largest alignment guaranteed by '::operator new(size\_t)'
>>> +
>>> +.. program:: clang433
>>> +.. option:: -fnext-runtime
>>> +
>>> +.. program:: clang434
>>> +.. option:: -fno-builtin-<arg>
>>> +
>>> +Disable implicit builtin knowledge of a specific function
>>> +
>>> +.. program:: clang435
>>> +.. option:: -fno-elide-type
>>> +
>>> +Do not elide types when printing diagnostics
>>> +
>>> +.. program:: clang436
>>> +.. option:: -fno-max-type-align
>>> +
>>> +.. program:: clang437
>>> +.. option:: -fno-operator-names
>>> +
>>> +Do not treat C++ operator name keywords as synonyms for operators
>>> +
>>> +.. program:: clang438
>>> +.. option:: -fno-strict-modules-decluse
>>> +
>>> +.. program:: clang439
>>> +.. option:: -fno-working-directory
>>> +
>>> +.. program:: clang440
>>> +.. option:: -fnoopenmp-use-tls
>>> +
>>> +.. program:: clang441
>>> +.. option:: -fobjc-abi-version=<arg>
>>> +
>>> +.. program:: clang442
>>> +.. option:: -fobjc-arc, -fno-objc-arc
>>> +
>>> +Synthesize retain and release calls for Objective-C pointers
>>> +
>>> +.. program:: clang443
>>> +.. option:: -fobjc-arc-exceptions, -fno-objc-arc-exceptions
>>> +
>>> +Use EH-safe code when synthesizing retains and releases in -fobjc-arc
>>> +
>>> +.. program:: clang444
>>> +.. option:: -fobjc-exceptions, -fno-objc-exceptions
>>> +
>>> +Enable Objective-C exceptions
>>> +
>>> +.. program:: clang445
>>> +.. option:: -fobjc-infer-related-result-type,
>>> -fno-objc-infer-related-result-type
>>> +
>>> +.. program:: clang446
>>> +.. option:: -fobjc-legacy-dispatch, -fno-objc-legacy-dispatch
>>> +
>>> +.. program:: clang447
>>> +.. option:: -fobjc-link-runtime
>>> +
>>> +.. program:: clang448
>>> +.. option:: -fobjc-nonfragile-abi, -fno-objc-nonfragile-abi
>>> +
>>> +.. program:: clang449
>>> +.. option:: -fobjc-nonfragile-abi-version=<arg>
>>> +
>>> +.. program:: clang450
>>> +.. option:: -fobjc-runtime=<arg>
>>> +
>>> +Specify the target Objective-C runtime kind and version
>>> +
>>> +.. program:: clang451
>>> +.. option:: -fobjc-sender-dependent-dispatch
>>> +
>>> +.. program:: clang452
>>> +.. option:: -fobjc-weak, -fno-objc-weak
>>> +
>>> +Enable ARC-style weak references in Objective-C
>>> +
>>> +.. program:: clang453
>>> +.. option:: -fomit-frame-pointer, -fno-omit-frame-pointer
>>> +
>>> +.. program:: clang454
>>> +.. option:: -fopenmp, -fno-openmp
>>> +
>>> +.. program:: clang455
>>> +.. option:: -fopenmp-dump-offload-linker-script
>>> +
>>> +.. program:: clang456
>>> +.. option:: -fopenmp-use-tls
>>> +
>>> +.. program:: clang457
>>> +.. option:: -fopenmp-version=<arg>
>>> +
>>> +.. program:: clang458
>>> +.. option:: -fopenmp=<arg>
>>> +
>>> +.. program:: clang459
>>> +.. option:: -foperator-arrow-depth=<arg>
>>> +
>>> +.. program:: clang460
>>> +.. option:: -foptimization-record-file=<arg>
>>> +
>>> +Specify the file name of any generated YAML optimization record
>>> +
>>> +.. program:: clang461
>>> +.. option:: -foptimize-sibling-calls, -fno-optimize-sibling-calls
>>> +
>>> +.. program:: clang462
>>> +.. option:: -foutput-class-dir=<arg>, --output-class-directory <arg>,
>>> --output-class-directory=<arg>
>>> +
>>> +.. program:: clang463
>>> +.. option:: -fpack-struct, -fno-pack-struct
>>> +
>>> +.. program:: clang464
>>> +.. option:: -fpack-struct=<arg>
>>> +
>>> +Specify the default maximum struct packing alignment
>>> +
>>> +.. program:: clang465
>>> +.. option:: -fpascal-strings, -fno-pascal-strings, -mpascal-strings
>>> +
>>> +Recognize and construct Pascal-style string literals
>>> +
>>> +.. program:: clang466
>>> +.. option:: -fpcc-struct-return
>>> +
>>> +Override the default ABI to return all structs on the stack
>>> +
>>> +.. program:: clang467
>>> +.. option:: -fpch-preprocess
>>> +
>>> +.. program:: clang468
>>> +.. option:: -fpic, -fno-pic
>>> +
>>> +.. program:: clang469
>>> +.. option:: -fpie, -fno-pie
>>> +
>>> +.. program:: clang470
>>> +.. option:: -fplugin=<dsopath>
>>> +
>>> +Load the named plugin (dynamic shared object)
>>> +
>>> +.. program:: clang471
>>> +.. option:: -fpreserve-as-comments, -fno-preserve-as-comments
>>> +
>>> +.. program:: clang472
>>> +.. option:: -fprofile-arcs, -fno-profile-arcs
>>> +
>>> +.. program:: clang473
>>> +.. option:: -fprofile-dir=<arg>
>>> +
>>> +.. program:: clang474
>>> +.. option:: -fprofile-generate, -fno-profile-generate
>>> +
>>> +Generate instrumented code to collect execution counts into
>>> default.profraw (overridden by LLVM\_PROFILE\_FILE env var)
>>> +
>>> +.. program:: clang475
>>> +.. option:: -fprofile-generate=<directory>
>>> +
>>> +Generate instrumented code to collect execution counts into
>>> <directory>/default.profraw (overridden by LLVM\_PROFILE\_FILE env var)
>>> +
>>> +.. program:: clang476
>>> +.. option:: -fprofile-instr-generate, -fno-profile-instr-generate
>>> +
>>> +Generate instrumented code to collect execution counts into
>>> default.profraw file (overridden by '=' form of option or
>>> LLVM\_PROFILE\_FILE env var)
>>> +
>>> +.. program:: clang477
>>> +.. option:: -fprofile-instr-generate=<file>
>>> +
>>> +Generate instrumented code to collect execution counts into <file>
>>> (overridden by LLVM\_PROFILE\_FILE env var)
>>> +
>>> +.. program:: clang478
>>> +.. option:: -fprofile-instr-use, -fno-profile-instr-use, -fprofile-use
>>> +
>>> +.. program:: clang479
>>> +.. option:: -fprofile-instr-use=<arg>
>>> +
>>> +Use instrumentation data for profile-guided optimization
>>> +
>>> +.. program:: clang480
>>> +.. option:: -fprofile-sample-use=<arg>, -fauto-profile=<arg>
>>> +
>>> +Enable sample-based profile guided optimizations
>>> +
>>> +.. program:: clang481
>>> +.. option:: -fprofile-use=<pathname>
>>> +
>>> +Use instrumentation data for profile-guided optimization. If pathname
>>> is a directory, it reads from <pathname>/default.profdata. Otherwise, it
>>> reads from file <pathname>.
>>> +
>>> +.. program:: clang482
>>> +.. option:: -freciprocal-math, -fno-reciprocal-math
>>> +
>>> +Allow division operations to be reassociated
>>> +
>>> +.. program:: clang483
>>> +.. option:: -freg-struct-return
>>> +
>>> +Override the default ABI to return small structs in registers
>>> +
>>> +.. program:: clang484
>>> +.. option:: -frelaxed-template-template-args,
>>> -fno-relaxed-template-template-args
>>> +
>>> +Enable C++17 relaxed template template argument matching
>>> +
>>> +.. program:: clang485
>>> +.. option:: -freroll-loops, -fno-reroll-loops
>>> +
>>> +Turn on loop reroller
>>> +
>>> +.. program:: clang486
>>> +.. option:: -fretain-comments-from-system-headers
>>> +
>>> +.. program:: clang487
>>> +.. option:: -frewrite-includes, -fno-rewrite-includes
>>> +
>>> +.. program:: clang488
>>> +.. option:: -frewrite-map-file <arg>
>>> +
>>> +.. program:: clang489
>>> +.. option:: -frewrite-map-file=<arg>
>>> +
>>> +.. program:: clang490
>>> +.. option:: -fropi, -fno-ropi
>>> +
>>> +.. program:: clang491
>>> +.. option:: -frtti, -fno-rtti
>>> +
>>> +.. program:: clang492
>>> +.. option:: -frwpi, -fno-rwpi
>>> +
>>> +.. program:: clang493
>>> +.. option:: -fsave-optimization-record, -fno-save-optimization-record
>>> +
>>> +Generate a YAML optimization record file
>>> +
>>> +.. program:: clang494
>>> +.. option:: -fshort-enums, -fno-short-enums
>>> +
>>> +Allocate to an enum type only as many bytes as it needs for the
>>> declared range of possible values
>>> +
>>> +.. program:: clang495
>>> +.. option:: -fshort-wchar, -fno-short-wchar
>>> +
>>> +Force wchar\_t to be a short unsigned int
>>> +
>>> +.. program:: clang496
>>> +.. option:: -fshow-column, -fno-show-column
>>> +
>>> +.. program:: clang497
>>> +.. option:: -fshow-overloads=<arg>
>>> +
>>> +Which overload candidates to show when overload resolution fails:
>>> best\|all; defaults to all
>>> +
>>> +.. program:: clang498
>>> +.. option:: -fshow-source-location, -fno-show-source-location
>>> +
>>> +.. program:: clang499
>>> +.. option:: -fsignaling-math, -fno-signaling-math
>>> +
>>> +.. program:: clang500
>>> +.. option:: -fsigned-bitfields
>>> +
>>> +.. program:: clang501
>>> +.. option:: -fsigned-char, -fno-signed-char, --signed-char
>>> +
>>> +.. program:: clang502
>>> +.. option:: -fsigned-zeros, -fno-signed-zeros
>>> +
>>> +.. program:: clang503
>>> +.. option:: -fsized-deallocation, -fno-sized-deallocation
>>> +
>>> +Enable C++14 sized global deallocation functions
>>> +
>>> +.. program:: clang504
>>> +.. option:: -fsjlj-exceptions
>>> +
>>> +Use SjLj style exceptions
>>> +
>>> +.. program:: clang505
>>> +.. option:: -fslp-vectorize, -fno-slp-vectorize, -ftree-slp-vectorize
>>> +
>>> +Enable the superword-level parallelism vectorization passes
>>> +
>>> +.. program:: clang506
>>> +.. option:: -fslp-vectorize-aggressive, -fno-slp-vectorize-aggressive
>>> +
>>> +Enable the BB vectorization passes
>>> +
>>> +.. program:: clang507
>>> +.. option:: -fspell-checking, -fno-spell-checking
>>> +
>>> +.. program:: clang508
>>> +.. option:: -fspell-checking-limit=<arg>
>>> +
>>> +.. program:: clang509
>>> +.. option:: -fsplit-dwarf-inlining, -fno-split-dwarf-inlining
>>> +
>>> +Place debug types in their own section (ELF Only)
>>> +
>>> +.. program:: clang510
>>> +.. option:: -fsplit-stack
>>> +
>>> +.. program:: clang511
>>> +.. option:: -fstack-protector, -fno-stack-protector
>>> +
>>> +Enable stack protectors for functions potentially vulnerable to stack
>>> smashing
>>> +
>>> +.. program:: clang512
>>> +.. option:: -fstack-protector-all
>>> +
>>> +Force the usage of stack protectors for all functions
>>> +
>>> +.. program:: clang513
>>> +.. option:: -fstack-protector-strong
>>> +
>>> +Use a strong heuristic to apply stack protectors to functions
>>> +
>>> +.. program:: clang514
>>> +.. option:: -fstandalone-debug, -fno-limit-debug-info,
>>> -fno-standalone-debug
>>> +
>>> +Emit full debug info for all types used by the program
>>> +
>>> +.. program:: clang515
>>> +.. option:: -fstrict-aliasing, -fno-strict-aliasing
>>> +
>>> +.. program:: clang516
>>> +.. option:: -fstrict-enums, -fno-strict-enums
>>> +
>>> +Enable optimizations based on the strict definition of an enum's value
>>> range
>>> +
>>> +.. program:: clang517
>>> +.. option:: -fstrict-overflow, -fno-strict-overflow
>>> +
>>> +.. program:: clang518
>>> +.. option:: -fstrict-return, -fno-strict-return
>>> +
>>> +Always treat control flow paths that fall off the end of a
>>> non-voidfunction as unreachable
>>> +
>>> +.. program:: clang519
>>> +.. option:: -fstrict-vtable-pointers, -fno-strict-vtable-pointers
>>> +
>>> +Enable optimizations based on the strict rules for overwriting
>>> polymorphic C++ objects
>>> +
>>> +.. program:: clang520
>>> +.. option:: -fstruct-path-tbaa, -fno-struct-path-tbaa
>>> +
>>> +.. program:: clang521
>>> +.. option:: -ftabstop=<arg>
>>> +
>>> +.. program:: clang522
>>> +.. option:: -ftemplate-backtrace-limit=<arg>
>>> +
>>> +.. program:: clang523
>>> +.. option:: -ftemplate-depth-<arg>
>>> +
>>> +.. program:: clang524
>>> +.. option:: -ftemplate-depth=<arg>
>>> +
>>> +.. program:: clang525
>>> +.. option:: -ftest-coverage
>>> +
>>> +.. program:: clang526
>>> +.. option:: -fthinlto-index=<arg>
>>> +
>>> +Perform ThinLTO importing using provided function summary index
>>> +
>>> +.. program:: clang527
>>> +.. option:: -fthreadsafe-statics, -fno-threadsafe-statics
>>> +
>>> +.. program:: clang528
>>> +.. option:: -ftime-report
>>> +
>>> +.. program:: clang529
>>> +.. option:: -ftls-model=<arg>
>>> +
>>> +.. program:: clang530
>>> +.. option:: -ftrap-function=<arg>
>>> +
>>> +Issue call to specified function rather than a trap instruction
>>> +
>>> +.. program:: clang531
>>> +.. option:: -ftrapping-math, -fno-trapping-math
>>> +
>>> +.. program:: clang532
>>> +.. option:: -ftrapv
>>> +
>>> +Trap on integer overflow
>>> +
>>> +.. program:: clang533
>>> +.. option:: -ftrapv-handler <arg>
>>> +
>>> +.. program:: clang534
>>> +.. option:: -ftrapv-handler=<function name>
>>> +
>>> +Specify the function to be called on overflow
>>> +
>>> +.. program:: clang535
>>> +.. option:: -ftrigraphs, -fno-trigraphs, -trigraphs, --trigraphs
>>> +
>>> +Process trigraph sequences
>>> +
>>> +.. program:: clang536
>>> +.. option:: -funique-section-names, -fno-unique-section-names
>>> +
>>> +Use unique names for text and data sections (ELF Only)
>>> +
>>> +.. program:: clang537
>>> +.. option:: -funit-at-a-time, -fno-unit-at-a-time
>>> +
>>> +.. program:: clang538
>>> +.. option:: -funroll-loops, -fno-unroll-loops
>>> +
>>> +Turn on loop unroller
>>> +
>>> +.. program:: clang539
>>> +.. option:: -funsafe-math-optimizations, -fno-unsafe-math-optimizations
>>> +
>>> +.. program:: clang540
>>> +.. option:: -funsigned-bitfields
>>> +
>>> +.. program:: clang541
>>> +.. option:: -funsigned-char, -fno-unsigned-char, --unsigned-char
>>> +
>>> +.. program:: clang542
>>> +.. option:: -funwind-tables, -fno-unwind-tables
>>> +
>>> +.. program:: clang543
>>> +.. option:: -fuse-cxa-atexit, -fno-use-cxa-atexit
>>> +
>>> +.. program:: clang544
>>> +.. option:: -fuse-init-array, -fno-use-init-array
>>> +
>>> +Use .init\_array instead of .ctors
>>> +
>>> +.. program:: clang545
>>> +.. option:: -fuse-ld=<arg>
>>> +
>>> +.. program:: clang546
>>> +.. option:: -fuse-line-directives, -fno-use-line-directives
>>> +
>>> +.. program:: clang547
>>> +.. option:: -fveclib=<arg>
>>> +
>>> +Use the given vector functions library
>>> +
>>> +.. program:: clang548
>>> +.. option:: -fvectorize, -fno-vectorize, -ftree-vectorize
>>> +
>>> +Enable the loop vectorization passes
>>> +
>>> +.. program:: clang549
>>> +.. option:: -fverbose-asm, -fno-verbose-asm
>>> +
>>> +.. program:: clang550
>>> +.. option:: -fvisibility-inlines-hidden
>>> +
>>> +Give inline C++ member functions default visibility by default
>>> +
>>> +.. program:: clang551
>>> +.. option:: -fvisibility-ms-compat
>>> +
>>> +Give global types 'default' visibility and global functions and
>>> variables 'hidden' visibility by default
>>> +
>>> +.. program:: clang552
>>> +.. option:: -fvisibility=<arg>
>>> +
>>> +Set the default symbol visibility for all global declarations
>>> +
>>> +.. program:: clang553
>>> +.. option:: -fwhole-program-vtables, -fno-whole-program-vtables
>>> +
>>> +Enables whole-program vtable optimization. Requires -flto
>>> +
>>> +.. program:: clang554
>>> +.. option:: -fwrapv, -fno-wrapv
>>> +
>>> +Treat signed integer overflow as two's complement
>>> +
>>> +.. program:: clang555
>>> +.. option:: -fwritable-strings
>>> +
>>> +Store string literals as writable data
>>> +
>>> +.. program:: clang556
>>> +.. option:: -fxray-instruction-threshold<arg>
>>> +
>>> +.. program:: clang557
>>> +.. option:: -fxray-instruction-threshold=<arg>
>>> +
>>> +Sets the minimum function size to instrument with XRay
>>> +
>>> +.. program:: clang558
>>> +.. option:: -fxray-instrument, -fno-xray-instrument
>>> +
>>> +Generate XRay instrumentation sleds on function entry and exit
>>> +
>>> +.. program:: clang559
>>> +.. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss
>>> +
>>> +.. program:: clang560
>>> +.. option:: -fzvector, -fno-zvector, -mzvector
>>> +
>>> +Enable System z vector language extension
>>> +
>>> +.. program:: clang561
>>> +.. option:: -pedantic, --pedantic, -no-pedantic, --no-pedantic
>>> +
>>> +.. program:: clang562
>>> +.. option:: -pedantic-errors, --pedantic-errors
>>> +
>>> +OpenCL flags
>>> +------------
>>> +.. program:: clang563
>>> +.. option:: -cl-denorms-are-zero
>>> +
>>> +OpenCL only. Allow denormals to be flushed to zero.
>>> +
>>> +.. program:: clang564
>>> +.. option:: -cl-fast-relaxed-math
>>> +
>>> +OpenCL only. Sets -cl-finite-math-only and
>>> -cl-unsafe-math-optimizations, and defines \_\_FAST\_RELAXED\_MATH\_\_.
>>> +
>>> +.. program:: clang565
>>> +.. option:: -cl-finite-math-only
>>> +
>>> +OpenCL only. Allow floating-point optimizations that assume arguments
>>> and results are not NaNs or +-Inf.
>>> +
>>> +.. program:: clang566
>>> +.. option:: -cl-fp32-correctly-rounded-divide-sqrt
>>> +
>>> +OpenCL only. Specify that single precision floating-point divide and
>>> sqrt used in the program source are correctly rounded.
>>> +
>>> +.. program:: clang567
>>> +.. option:: -cl-kernel-arg-info
>>> +
>>> +OpenCL only. Generate kernel argument metadata.
>>> +
>>> +.. program:: clang568
>>> +.. option:: -cl-mad-enable
>>> +
>>> +OpenCL only. Allow use of less precise MAD computations in the
>>> generated binary.
>>> +
>>> +.. program:: clang569
>>> +.. option:: -cl-no-signed-zeros
>>> +
>>> +OpenCL only. Allow use of less precise no signed zeros computations in
>>> the generated binary.
>>> +
>>> +.. program:: clang570
>>> +.. option:: -cl-opt-disable
>>> +
>>> +OpenCL only. This option disables all optimizations. By default
>>> optimizations are enabled.
>>> +
>>> +.. program:: clang571
>>> +.. option:: -cl-single-precision-constant
>>> +
>>> +OpenCL only. Treat double precision floating-point constant as single
>>> precision constant.
>>> +
>>> +.. program:: clang572
>>> +.. option:: -cl-std=<arg>
>>> +
>>> +OpenCL language standard to compile for.
>>> +
>>> +.. program:: clang573
>>> +.. option:: -cl-strict-aliasing
>>> +
>>> +OpenCL only. This option is added for compatibility with OpenCL 1.0.
>>> +
>>> +.. program:: clang574
>>> +.. option:: -cl-unsafe-math-optimizations
>>> +
>>> +OpenCL only. Allow unsafe floating-point optimizations.  Also implies
>>> -cl-no-signed-zeros and -cl-mad-enable.
>>> +
>>> +Target-dependent compilation options
>>> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>>> +.. program:: clang575
>>> +.. option:: -m16
>>> +
>>> +.. program:: clang576
>>> +.. option:: -m32
>>> +
>>> +.. program:: clang577
>>> +.. option:: -m64
>>> +
>>> +.. program:: clang578
>>> +.. option:: -mabi=<arg>
>>> +
>>> +.. program:: clang579
>>> +.. option:: -mabicalls, -mno-abicalls
>>> +
>>> +Enable SVR4-style position-independent code (Mips only)
>>> +
>>> +.. program:: clang580
>>> +.. option:: -malign-double
>>> +
>>> +Align doubles to two words in structs (x86 only)
>>> +
>>> +.. program:: clang581
>>> +.. option:: -march=<arg>
>>> +
>>> +.. program:: clang582
>>> +.. option:: -masm=<arg>
>>> +
>>> +.. program:: clang583
>>> +.. option:: -mbackchain, -mno-backchain
>>> +
>>> +Link stack frames through backchain on System Z
>>> +
>>> +.. program:: clang584
>>> +.. option:: -mcheck-zero-division, -mno-check-zero-division
>>> +
>>> +.. program:: clang585
>>> +.. option:: -mcmodel=<arg>
>>> +
>>> +.. program:: clang586
>>> +.. option:: -mcompact-branches=<arg>
>>> +
>>> +.. program:: clang587
>>> +.. option:: -mconsole<arg>
>>> +
>>> +.. program:: clang588
>>> +.. option:: -mcpu=<arg>, -mv4 (equivalent to -mcpu=hexagonv4), -mv5
>>> (equivalent to -mcpu=hexagonv5), -mv55 (equivalent to -mcpu=hexagonv55),
>>> -mv60 (equivalent to -mcpu=hexagonv60)
>>> +
>>> +.. program:: clang589
>>> +.. option:: -mdll<arg>
>>> +
>>> +.. program:: clang590
>>> +.. option:: -mdouble-float
>>> +
>>> +.. program:: clang591
>>> +.. option:: -mdsp, -mno-dsp
>>> +
>>> +.. program:: clang592
>>> +.. option:: -mdspr2, -mno-dspr2
>>> +
>>> +.. program:: clang593
>>> +.. option:: -mdynamic-no-pic<arg>
>>> +
>>> +.. program:: clang594
>>> +.. option:: -meabi <arg>
>>> +
>>> +Set EABI type, e.g. 4, 5 or gnu (default depends on triple)
>>> +
>>> +.. program:: clang595
>>> +.. option:: -mfloat-abi=<arg>
>>> +
>>> +.. program:: clang596
>>> +.. option:: -mfp32
>>> +
>>> +Use 32-bit floating point registers (MIPS only)
>>> +
>>> +.. program:: clang597
>>> +.. option:: -mfp64
>>> +
>>> +Use 64-bit floating point registers (MIPS only)
>>> +
>>> +.. program:: clang598
>>> +.. option:: -mfpmath=<arg>
>>> +
>>> +.. program:: clang599
>>> +.. option:: -mfpu=<arg>
>>> +
>>> +.. program:: clang600
>>> +.. option:: -mglobal-merge, -mno-global-merge
>>> +
>>> +Enable merging of globals
>>> +
>>> +.. program:: clang601
>>> +.. option:: -mhard-float
>>> +
>>> +.. program:: clang602
>>> +.. option:: -mhwdiv=<arg>, --mhwdiv <arg>, --mhwdiv=<arg>
>>> +
>>> +.. program:: clang603
>>> +.. option:: -miamcu, -mno-iamcu
>>> +
>>> +Use Intel MCU ABI
>>> +
>>> +.. program:: clang604
>>> +.. option:: -mimplicit-float, -mno-implicit-float
>>> +
>>> +.. program:: clang605
>>> +.. option:: -mimplicit-it=<arg>
>>> +
>>> +.. program:: clang606
>>> +.. option:: -mincremental-linker-compatible,
>>> -mno-incremental-linker-compatible
>>> +
>>> +(integrated-as) Emit an object file which can be used with an
>>> incremental linker
>>> +
>>> +.. program:: clang607
>>> +.. option:: -miphoneos-version-min=<arg>, -mios-simulator-version-min=<arg>,
>>> -mios-version-min=<arg>, -miphonesimulator-version-min=<arg>
>>> +
>>> +.. program:: clang608
>>> +.. option:: -mips16
>>> +
>>> +.. program:: clang609
>>> +.. option:: -mkernel
>>> +
>>> +.. program:: clang610
>>> +.. option:: -mldc1-sdc1, -mno-ldc1-sdc1
>>> +
>>> +.. program:: clang611
>>> +.. option:: -mlong-calls, -mno-long-calls
>>> +
>>> +Generate branches with extended addressability, usually via indirect
>>> jumps.
>>> +
>>> +.. program:: clang612
>>> +.. option:: -mmacosx-version-min=<arg>
>>> +
>>> +Set Mac OS X deployment target
>>> +
>>> +.. program:: clang613
>>> +.. option:: -mmicromips, -mno-micromips
>>> +
>>> +.. program:: clang614
>>> +.. option:: -mms-bitfields, -mno-ms-bitfields
>>> +
>>> +Set the default structure layout to be compatible with the Microsoft
>>> compiler standard
>>> +
>>> +.. program:: clang615
>>> +.. option:: -mmsa, -mno-msa
>>> +
>>> +Enable MSA ASE (MIPS only)
>>> +
>>> +.. program:: clang616
>>> +.. option:: -mnan=<arg>
>>> +
>>> +.. program:: clang617
>>> +.. option:: -mno-mips16
>>> +
>>> +.. program:: clang618
>>> +.. option:: -momit-leaf-frame-pointer, -mno-omit-leaf-frame-pointer
>>> +
>>> +Omit frame pointer setup for leaf functions
>>> +
>>> +.. program:: clang619
>>> +.. option:: -moslib=<arg>
>>> +
>>> +.. program:: clang620
>>> +.. option:: -mpie-copy-relocations, -mno-pie-copy-relocations
>>> +
>>> +Use copy relocations support for PIE builds
>>> +
>>> +.. program:: clang621
>>> +.. option:: -mqdsp6-compat
>>> +
>>> +Enable hexagon-qdsp6 backward compatibility
>>> +
>>> +.. program:: clang622
>>> +.. option:: -mrecip
>>> +
>>> +.. program:: clang623
>>> +.. option:: -mrecip=<arg1>,<arg2>...
>>> +
>>> +.. program:: clang624
>>> +.. option:: -mred-zone, -mno-red-zone
>>> +
>>> +.. program:: clang625
>>> +.. option:: -mregparm=<arg>
>>> +
>>> +.. program:: clang626
>>> +.. option:: -mrelax-all, -mno-relax-all
>>> +
>>> +(integrated-as) Relax all machine instructions
>>> +
>>> +.. program:: clang627
>>> +.. option:: -mrtd, -mno-rtd
>>> +
>>> +Make StdCall calling convention the default
>>> +
>>> +.. program:: clang628
>>> +.. option:: -msingle-float
>>> +
>>> +.. program:: clang629
>>> +.. option:: -msmall-data-threshold=<arg>
>>> +
>>> +.. program:: clang630
>>> +.. option:: -msoft-float, -mno-soft-float
>>> +
>>> +Use software floating point
>>> +
>>> +.. program:: clang631
>>> +.. option:: -mstack-alignment=<arg>
>>> +
>>> +Set the stack alignment
>>> +
>>> +.. program:: clang632
>>> +.. option:: -mstack-probe-size=<arg>
>>> +
>>> +Set the stack probe size
>>> +
>>> +.. program:: clang633
>>> +.. option:: -mstackrealign, -mno-stackrealign
>>> +
>>> +Force realign the stack at entry to every function
>>> +
>>> +.. program:: clang634
>>> +.. option:: -mthread-model <arg>
>>> +
>>> +The thread model to use, e.g. posix, single (posix by default)
>>> +
>>> +.. program:: clang635
>>> +.. option:: -mthreads<arg>
>>> +
>>> +.. program:: clang636
>>> +.. option:: -mthumb, -mno-thumb
>>> +
>>> +.. program:: clang637
>>> +.. option:: -mtune=<arg>
>>> +
>>> +.. program:: clang638
>>> +.. option:: -mtvos-version-min=<arg>, -mappletvos-version-min=<arg>,
>>> -mappletvsimulator-version-min=<arg>, -mtvos-simulator-version-min=<arg>
>>> +
>>> +.. program:: clang639
>>> +.. option:: -municode<arg>
>>> +
>>> +.. program:: clang640
>>> +.. option:: -mvx, -mno-vx
>>> +
>>> +.. program:: clang641
>>> +.. option:: -mwarn-nonportable-cfstrings, -mno-warn-nonportable-cfstring
>>> s
>>> +
>>> +.. program:: clang642
>>> +.. option:: -mwatchos-version-min=<arg>, -mwatchos-simulator-version-min=<arg>,
>>> -mwatchsimulator-version-min=<arg>
>>> +
>>> +.. program:: clang643
>>> +.. option:: -mwindows<arg>
>>> +
>>> +.. program:: clang644
>>> +.. option:: -mx32
>>> +
>>> +.. program:: clang645
>>> +.. option:: -mxgot, -mno-xgot
>>> +
>>> +AARCH64
>>> +-------
>>> +.. program:: clang646
>>> +.. option:: -ffixed-x18
>>> +
>>> +Reserve the x18 register (AArch64 only)
>>> +
>>> +.. program:: clang647
>>> +.. option:: -mfix-cortex-a53-835769, -mno-fix-cortex-a53-835769
>>> +
>>> +Workaround Cortex-A53 erratum 835769 (AArch64 only)
>>> +
>>> +.. program:: clang648
>>> +.. option:: -mgeneral-regs-only
>>> +
>>> +Generate code which only uses the general purpose registers (AArch64
>>> only)
>>> +
>>> +AMDGPU
>>> +------
>>> +ARM
>>> +---
>>> +.. program:: clang649
>>> +.. option:: -ffixed-r9
>>> +
>>> +Reserve the r9 register (ARM only)
>>> +
>>> +.. program:: clang650
>>> +.. option:: -mcrc
>>> +
>>> +Allow use of CRC instructions (ARM only)
>>> +
>>> +.. program:: clang651
>>> +.. option:: -mexecute-only, -mno-execute-only, -mpure-code
>>> +
>>> +Disallow generation of data access to code sections (ARM only)
>>> +
>>> +.. program:: clang652
>>> +.. option:: -mno-movt
>>> +
>>> +Disallow use of movt/movw pairs (ARM only)
>>> +
>>> +.. program:: clang653
>>> +.. option:: -mnocrc
>>> +
>>> +Disallow use of CRC instructions (ARM only)
>>> +
>>> +.. program:: clang654
>>> +.. option:: -mrestrict-it, -mno-restrict-it
>>> +
>>> +Disallow generation of deprecated IT blocks for ARMv8. It is on by
>>> default for ARMv8 Thumb mode.
>>> +
>>> +.. program:: clang655
>>> +.. option:: -munaligned-access, -mno-unaligned-access
>>> +
>>> +Allow memory accesses to be unaligned (AArch32/AArch64 only)
>>> +
>>> +Hexagon
>>> +-------
>>> +.. program:: clang656
>>> +.. option:: -mhvx, -mno-hvx
>>> +
>>> +Enable Hexagon Vector eXtensions
>>> +
>>> +.. program:: clang657
>>> +.. option:: -mhvx-double, -mno-hvx-double
>>> +
>>> +Enable Hexagon Double Vector eXtensions
>>> +
>>> +.. program:: clang658
>>> +.. option:: -mieee-rnd-near
>>> +
>>> +PowerPC
>>> +-------
>>> +.. program:: clang659
>>> +.. option:: -mcmpb, -mno-cmpb
>>> +
>>> +.. program:: clang660
>>> +.. option:: -mcrbits, -mno-crbits
>>> +
>>> +.. program:: clang661
>>> +.. option:: -mcrypto, -mno-crypto
>>> +
>>> +.. program:: clang662
>>> +.. option:: -mdirect-move, -mno-direct-move
>>> +
>>> +.. program:: clang663
>>> +.. option:: -mfloat128, -mno-float128
>>> +
>>> +.. program:: clang664
>>> +.. option:: -mfprnd, -mno-fprnd
>>> +
>>> +.. program:: clang665
>>> +.. option:: -mhtm, -mno-htm
>>> +
>>> +.. program:: clang666
>>> +.. option:: -minvariant-function-descriptors,
>>> -mno-invariant-function-descriptors
>>> +
>>> +.. program:: clang667
>>> +.. option:: -misel, -mno-isel
>>> +
>>> +.. program:: clang668
>>> +.. option:: -mlongcall, -mno-longcall
>>> +
>>> +.. program:: clang669
>>> +.. option:: -mmfocrf, -mmfcrf, -mno-mfocrf
>>> +
>>> +.. program:: clang670
>>> +.. option:: -mpopcntd, -mno-popcntd
>>> +
>>> +.. program:: clang671
>>> +.. option:: -mpower8-vector, -mno-power8-vector
>>> +
>>> +.. program:: clang672
>>> +.. option:: -mpower9-vector, -mno-power9-vector
>>> +
>>> +.. program:: clang673
>>> +.. option:: -mqpx, -mno-qpx
>>> +
>>> +.. program:: clang674
>>> +.. option:: -mvsx, -mno-vsx
>>> +
>>> +WebAssembly
>>> +-----------
>>> +.. program:: clang675
>>> +.. option:: -msimd128, -mno-simd128
>>> +
>>> +X86
>>> +---
>>> +.. program:: clang676
>>> +.. option:: -m3dnow, -mno-3dnow
>>> +
>>> +.. program:: clang677
>>> +.. option:: -m3dnowa, -mno-3dnowa
>>> +
>>> +.. program:: clang678
>>> +.. option:: -madx, -mno-adx
>>> +
>>> +.. program:: clang679
>>> +.. option:: -maes, -mno-aes
>>> +
>>> +.. program:: clang680
>>> +.. option:: -mavx, -mno-avx
>>> +
>>> +.. program:: clang681
>>> +.. option:: -mavx2, -mno-avx2
>>> +
>>> +.. program:: clang682
>>> +.. option:: -mavx512bw, -mno-avx512bw
>>> +
>>> +.. program:: clang683
>>> +.. option:: -mavx512cd, -mno-avx512cd
>>> +
>>> +.. program:: clang684
>>> +.. option:: -mavx512dq, -mno-avx512dq
>>> +
>>> +.. program:: clang685
>>> +.. option:: -mavx512er, -mno-avx512er
>>> +
>>> +.. program:: clang686
>>> +.. option:: -mavx512f, -mno-avx512f
>>> +
>>> +.. program:: clang687
>>> +.. option:: -mavx512ifma, -mno-avx512ifma
>>> +
>>> +.. program:: clang688
>>> +.. option:: -mavx512pf, -mno-avx512pf
>>> +
>>> +.. program:: clang689
>>> +.. option:: -mavx512vbmi, -mno-avx512vbmi
>>> +
>>> +.. program:: clang690
>>> +.. option:: -mavx512vl, -mno-avx512vl
>>> +
>>> +.. program:: clang691
>>> +.. option:: -mbmi, -mno-bmi
>>> +
>>> +.. program:: clang692
>>> +.. option:: -mbmi2, -mno-bmi2
>>> +
>>> +.. program:: clang693
>>> +.. option:: -mcx16, -mno-cx16
>>> +
>>> +.. program:: clang694
>>> +.. option:: -mf16c, -mno-f16c
>>> +
>>> +.. program:: clang695
>>> +.. option:: -mfma, -mno-fma
>>> +
>>> +.. program:: clang696
>>> +.. option:: -mfma4, -mno-fma4
>>> +
>>> +.. program:: clang697
>>> +.. option:: -mfsgsbase, -mno-fsgsbase
>>> +
>>> +.. program:: clang698
>>> +.. option:: -mfxsr, -mno-fxsr
>>> +
>>> +.. program:: clang699
>>> +.. option:: -mlzcnt, -mno-lzcnt
>>> +
>>> +.. program:: clang700
>>> +.. option:: -mmmx, -mno-mmx
>>> +
>>> +.. program:: clang701
>>> +.. option:: -mmwaitx, -mno-mwaitx
>>> +
>>> +.. program:: clang702
>>> +.. option:: -mpclmul, -mno-pclmul
>>> +
>>> +.. program:: clang703
>>> +.. option:: -mpku, -mno-pku
>>> +
>>> +.. program:: clang704
>>> +.. option:: -mpopcnt, -mno-popcnt
>>> +
>>> +.. program:: clang705
>>> +.. option:: -mprfchw, -mno-prfchw
>>> +
>>> +.. program:: clang706
>>> +.. option:: -mrdrnd, -mno-rdrnd
>>> +
>>> +.. program:: clang707
>>> +.. option:: -mrdseed, -mno-rdseed
>>> +
>>> +.. program:: clang708
>>> +.. option:: -mrtm, -mno-rtm
>>> +
>>> +.. program:: clang709
>>> +.. option:: -msha, -mno-sha
>>> +
>>> +.. program:: clang710
>>> +.. option:: -msse, -mno-sse
>>> +
>>> +.. program:: clang711
>>> +.. option:: -msse2, -mno-sse2
>>> +
>>> +.. program:: clang712
>>> +.. option:: -msse3, -mno-sse3
>>> +
>>> +.. program:: clang713
>>> +.. option:: -msse4.1, -mno-sse4.1
>>> +
>>> +.. program:: clang714
>>> +.. option:: -msse4.2, -mno-sse4.2, -msse4
>>> +
>>> +.. program:: clang715
>>> +.. option:: -msse4a, -mno-sse4a
>>> +
>>> +.. program:: clang716
>>> +.. option:: -mssse3, -mno-ssse3
>>> +
>>> +.. program:: clang717
>>> +.. option:: -mtbm, -mno-tbm
>>> +
>>> +.. program:: clang718
>>> +.. option:: -mx87, -m80387, -mno-x87
>>> +
>>> +.. program:: clang719
>>> +.. option:: -mxop, -mno-xop
>>> +
>>> +.. program:: clang720
>>> +.. option:: -mxsave, -mno-xsave
>>> +
>>> +.. program:: clang721
>>> +.. option:: -mxsavec, -mno-xsavec
>>> +
>>> +.. program:: clang722
>>> +.. option:: -mxsaveopt, -mno-xsaveopt
>>> +
>>> +.. program:: clang723
>>> +.. option:: -mxsaves, -mno-xsaves
>>> +
>>> +Optimization level
>>> +~~~~~~~~~~~~~~~~~~
>>> +
>>> +Flags controlling how much optimization should be performed.
>>> +
>>> +.. program:: clang724
>>> +.. option:: -O<arg>, -O (equivalent to -O2), --optimize,
>>> --optimize=<arg>
>>> +
>>> +.. program:: clang725
>>> +.. option:: -O0
>>> +
>>> +.. program:: clang726
>>> +.. option:: -O4
>>> +
>>> +.. program:: clang727
>>> +.. option:: -Ofast<arg>
>>> +
>>> +Debug information generation
>>> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>>> +
>>> +Flags controlling how much and what kind of debug information should be
>>> +generated.
>>> +
>>> +Kind and level of debug information
>>> +-----------------------------------
>>> +.. program:: clang728
>>> +.. option:: -g, --debug, --debug=<arg>
>>> +
>>> +Generate source-level debug information
>>> +
>>> +.. program:: clang729
>>> +.. option:: -gdwarf-2
>>> +
>>> +Generate source-level debug information with dwarf version 2
>>> +
>>> +.. program:: clang730
>>> +.. option:: -gdwarf-3
>>> +
>>> +Generate source-level debug information with dwarf version 3
>>> +
>>> +.. program:: clang731
>>> +.. option:: -gdwarf-4, -gdwarf
>>> +
>>> +Generate source-level debug information with dwarf version 4
>>> +
>>> +.. program:: clang732
>>> +.. option:: -gdwarf-5
>>> +
>>> +Generate source-level debug information with dwarf version 5
>>> +
>>> +.. program:: clang733
>>> +.. option:: -gfull
>>> +
>>> +.. program:: clang734
>>> +.. option:: -gused
>>> +
>>> +Debug level
>>> +___________
>>> +.. program:: clang735
>>> +.. option:: -g0
>>> +
>>> +.. program:: clang736
>>> +.. option:: -g2
>>> +
>>> +.. program:: clang737
>>> +.. option:: -g3
>>> +
>>> +.. program:: clang738
>>> +.. option:: -ggdb0
>>> +
>>> +.. program:: clang739
>>> +.. option:: -ggdb1
>>> +
>>> +.. program:: clang740
>>> +.. option:: -ggdb2
>>> +
>>> +.. program:: clang741
>>> +.. option:: -ggdb3
>>> +
>>> +.. program:: clang742
>>> +.. option:: -gline-tables-only, -g1, -gmlt
>>> +
>>> +Emit debug line number tables only
>>> +
>>> +.. program:: clang743
>>> +.. option:: -gmodules
>>> +
>>> +Generate debug info with external references to clang modules or
>>> precompiled headers
>>> +
>>> +Debugger to tune debug information for
>>> +______________________________________
>>> +.. program:: clang744
>>> +.. option:: -ggdb
>>> +
>>> +.. program:: clang745
>>> +.. option:: -glldb
>>> +
>>> +.. program:: clang746
>>> +.. option:: -gsce
>>> +
>>> +Debug information flags
>>> +-----------------------
>>> +.. program:: clang747
>>> +.. option:: -gcolumn-info, -gno-column-info
>>> +
>>> +.. program:: clang748
>>> +.. option:: -gdwarf-aranges
>>> +
>>> +.. program:: clang749
>>> +.. option:: -ggnu-pubnames
>>> +
>>> +.. program:: clang750
>>> +.. option:: -grecord-gcc-switches, -gno-record-gcc-switches
>>> +
>>> +.. program:: clang751
>>> +.. option:: -gsplit-dwarf
>>> +
>>> +.. program:: clang752
>>> +.. option:: -gstrict-dwarf, -gno-strict-dwarf
>>> +
>>> +Linker flags
>>> +============
>>> +Flags that are passed on to the linker
>>> +
>>> +.. program:: clang753
>>> +.. option:: -L<arg>, --library-directory <arg>,
>>> --library-directory=<arg>
>>> +
>>> +.. program:: clang754
>>> +.. option:: -T<arg>
>>> +
>>> +.. program:: clang755
>>> +.. option:: -Tbss<arg>
>>> +
>>> +.. program:: clang756
>>> +.. option:: -Tdata<arg>
>>> +
>>> +.. program:: clang757
>>> +.. option:: -Ttext<arg>
>>> +
>>> +.. program:: clang758
>>> +.. option:: -Wl,<arg>,<arg2>...
>>> +
>>> +Pass the comma separated arguments in <arg> to the linker
>>> +
>>> +.. program:: clang759
>>> +.. option:: -Xlinker <arg>, --for-linker <arg>, --for-linker=<arg>
>>> +
>>> +Pass <arg> to the linker
>>> +
>>> +.. program:: clang760
>>> +.. option:: -Z
>>> +
>>> +.. program:: clang761
>>> +.. option:: -e<arg>, --entry
>>> +
>>> +.. program:: clang762
>>> +.. option:: -filelist <arg>
>>> +
>>> +.. program:: clang763
>>> +.. option:: -l<arg>
>>> +
>>> +.. program:: clang764
>>> +.. option:: -r
>>> +
>>> +.. program:: clang765
>>> +.. option:: -rpath <arg>
>>> +
>>> +.. program:: clang766
>>> +.. option:: -s
>>> +
>>> +.. program:: clang767
>>> +.. option:: -t
>>> +
>>> +.. program:: clang768
>>> +.. option:: -u<arg>, --force-link <arg>, --force-link=<arg>
>>> +
>>> +.. program:: clang769
>>> +.. option:: -undef
>>> +
>>> +undef all system defines
>>> +
>>> +.. program:: clang770
>>> +.. option:: -undefined<arg>, --no-undefined
>>> +
>>> +.. program:: clang771
>>> +.. option:: -z <arg>
>>> +
>>> +Pass -z <arg> to the linker
>>> +
>>> +Fortran compilation flags
>>> +=========================
>>> +
>>> +Flags that will be passed onto the ``gfortran`` compiler when Clang is
>>> given
>>> +a Fortran input.
>>> +
>>> +.. program:: clang772
>>> +.. option:: -A-<arg>
>>> +
>>> +.. program:: clang773
>>> +.. option:: -J<arg>
>>> +
>>> +.. program:: clang774
>>> +.. option:: -cpp
>>> +
>>> +.. program:: clang775
>>> +.. option:: -faggressive-function-elimination,
>>> -fno-aggressive-function-elimination
>>> +
>>> +.. program:: clang776
>>> +.. option:: -falign-commons, -fno-align-commons
>>> +
>>> +.. program:: clang777
>>> +.. option:: -fall-intrinsics, -fno-all-intrinsics
>>> +
>>> +.. program:: clang778
>>> +.. option:: -fautomatic, -fno-automatic
>>> +
>>> +.. program:: clang779
>>> +.. option:: -fbackslash, -fno-backslash
>>> +
>>> +.. program:: clang780
>>> +.. option:: -fbacktrace, -fno-backtrace
>>> +
>>> +.. program:: clang781
>>> +.. option:: -fblas-matmul-limit=<arg>
>>> +
>>> +.. program:: clang782
>>> +.. option:: -fbounds-check, -fno-bounds-check
>>> +
>>> +.. program:: clang783
>>> +.. option:: -fcheck-array-temporaries, -fno-check-array-temporaries
>>> +
>>> +.. program:: clang784
>>> +.. option:: -fcheck=<arg>
>>> +
>>> +.. program:: clang785
>>> +.. option:: -fcoarray=<arg>
>>> +
>>> +.. program:: clang786
>>> +.. option:: -fconvert=<arg>
>>> +
>>> +.. program:: clang787
>>> +.. option:: -fcray-pointer, -fno-cray-pointer
>>> +
>>> +.. program:: clang788
>>> +.. option:: -fd-lines-as-code, -fno-d-lines-as-code
>>> +
>>> +.. program:: clang789
>>> +.. option:: -fd-lines-as-comments, -fno-d-lines-as-comments
>>> +
>>> +.. program:: clang790
>>> +.. option:: -fdefault-double-8, -fno-default-double-8
>>> +
>>> +.. program:: clang791
>>> +.. option:: -fdefault-integer-8, -fno-default-integer-8
>>> +
>>> +.. program:: clang792
>>> +.. option:: -fdefault-real-8, -fno-default-real-8
>>> +
>>> +.. program:: clang793
>>> +.. option:: -fdollar-ok, -fno-dollar-ok
>>> +
>>> +.. program:: clang794
>>> +.. option:: -fdump-fortran-optimized, -fno-dump-fortran-optimized
>>> +
>>> +.. program:: clang795
>>> +.. option:: -fdump-fortran-original, -fno-dump-fortran-original
>>> +
>>> +.. program:: clang796
>>> +.. option:: -fdump-parse-tree, -fno-dump-parse-tree
>>> +
>>> +.. program:: clang797
>>> +.. option:: -fexternal-blas, -fno-external-blas
>>> +
>>> +.. program:: clang798
>>> +.. option:: -ff2c, -fno-f2c
>>> +
>>> +.. program:: clang799
>>> +.. option:: -ffixed-form, -fno-fixed-form
>>> +
>>> +.. program:: clang800
>>> +.. option:: -ffixed-line-length-<arg>
>>> +
>>> +.. program:: clang801
>>> +.. option:: -ffpe-trap=<arg>
>>> +
>>> +.. program:: clang802
>>> +.. option:: -ffree-form, -fno-free-form
>>> +
>>> +.. program:: clang803
>>> +.. option:: -ffree-line-length-<arg>
>>> +
>>> +.. program:: clang804
>>> +.. option:: -ffrontend-optimize, -fno-frontend-optimize
>>> +
>>> +.. program:: clang805
>>> +.. option:: -fimplicit-none, -fno-implicit-none
>>> +
>>> +.. program:: clang806
>>> +.. option:: -finit-character=<arg>
>>> +
>>> +.. program:: clang807
>>> +.. option:: -finit-integer=<arg>
>>> +
>>> +.. program:: clang808
>>> +.. option:: -finit-local-zero, -fno-init-local-zero
>>> +
>>> +.. program:: clang809
>>> +.. option:: -finit-logical=<arg>
>>> +
>>> +.. program:: clang810
>>> +.. option:: -finit-real=<arg>
>>> +
>>> +.. program:: clang811
>>> +.. option:: -finteger-4-integer-8, -fno-integer-4-integer-8
>>> +
>>> +.. program:: clang812
>>> +.. option:: -fintrinsic-modules-path, -fno-intrinsic-modules-path
>>> +
>>> +.. program:: clang813
>>> +.. option:: -fmax-array-constructor=<arg>
>>> +
>>> +.. program:: clang814
>>> +.. option:: -fmax-errors=<arg>
>>> +
>>> +.. program:: clang815
>>> +.. option:: -fmax-identifier-length, -fno-max-identifier-length
>>> +
>>> +.. program:: clang816
>>> +.. option:: -fmax-stack-var-size=<arg>
>>> +
>>> +.. program:: clang817
>>> +.. option:: -fmax-subrecord-length=<arg>
>>> +
>>> +.. program:: clang818
>>> +.. option:: -fmodule-private, -fno-module-private
>>> +
>>> +.. program:: clang819
>>> +.. option:: -fpack-derived, -fno-pack-derived
>>> +
>>> +.. program:: clang820
>>> +.. option:: -fprotect-parens, -fno-protect-parens
>>> +
>>> +.. program:: clang821
>>> +.. option:: -frange-check, -fno-range-check
>>> +
>>> +.. program:: clang822
>>> +.. option:: -freal-4-real-10, -fno-real-4-real-10
>>> +
>>> +.. program:: clang823
>>> +.. option:: -freal-4-real-16, -fno-real-4-real-16
>>> +
>>> +.. program:: clang824
>>> +.. option:: -freal-4-real-8, -fno-real-4-real-8
>>> +
>>> +.. program:: clang825
>>> +.. option:: -freal-8-real-10, -fno-real-8-real-10
>>> +
>>> +.. program:: clang826
>>> +.. option:: -freal-8-real-16, -fno-real-8-real-16
>>> +
>>> +.. program:: clang827
>>> +.. option:: -freal-8-real-4, -fno-real-8-real-4
>>> +
>>> +.. program:: clang828
>>> +.. option:: -frealloc-lhs, -fno-realloc-lhs
>>> +
>>> +.. program:: clang829
>>> +.. option:: -frecord-marker=<arg>
>>> +
>>> +.. program:: clang830
>>> +.. option:: -frecursive, -fno-recursive
>>> +
>>> +.. program:: clang831
>>> +.. option:: -frepack-arrays, -fno-repack-arrays
>>> +
>>> +.. program:: clang832
>>> +.. option:: -fsecond-underscore, -fno-second-underscore
>>> +
>>> +.. program:: clang833
>>> +.. option:: -fsign-zero, -fno-sign-zero
>>> +
>>> +.. program:: clang834
>>> +.. option:: -fstack-arrays, -fno-stack-arrays
>>> +
>>> +.. program:: clang835
>>> +.. option:: -funderscoring, -fno-underscoring
>>> +
>>> +.. program:: clang836
>>> +.. option:: -fwhole-file, -fno-whole-file
>>> +
>>> +.. program:: clang837
>>> +.. option:: -nocpp
>>> +
>>> +.. program:: clang838
>>> +.. option:: -static-libgfortran
>>> +
>>>
>>> Modified: cfe/trunk/docs/index.rst
>>> URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/index.rst
>>> ?rev=292968&r1=292967&r2=292968&view=diff
>>> ============================================================
>>> ==================
>>> --- cfe/trunk/docs/index.rst (original)
>>> +++ cfe/trunk/docs/index.rst Tue Jan 24 13:39:46 2017
>>> @@ -19,6 +19,7 @@ Using Clang as a Compiler
>>>     UsersManual
>>>     Toolchain
>>>     LanguageExtensions
>>> +   ClangCommandLineReference
>>>     AttributeReference
>>>     DiagnosticsReference
>>>     CrossCompilation
>>>
>>> Modified: cfe/trunk/include/clang/Driver/CLCompatOptions.td
>>> URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/include/clang/
>>> Driver/CLCompatOptions.td?rev=292968&r1=292967&r2=292968&view=diff
>>> ============================================================
>>> ==================
>>> --- cfe/trunk/include/clang/Driver/CLCompatOptions.td (original)
>>> +++ cfe/trunk/include/clang/Driver/CLCompatOptions.td Tue Jan 24
>>> 13:39:46 2017
>>> @@ -11,7 +11,7 @@
>>>  //
>>>  //===------------------------------------------------------
>>> ----------------===//
>>>
>>> -def cl_Group : OptionGroup<"<clang-cl options>">,
>>> +def cl_Group : OptionGroup<"<clang-cl options>">, Flags<[CLOption]>,
>>>    HelpText<"CL.EXE COMPATIBILITY OPTIONS">;
>>>
>>>  def cl_compile_Group : OptionGroup<"<clang-cl compile-only options>">,
>>>
>>> Added: cfe/trunk/include/clang/Driver/ClangOptionDocs.td
>>> URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/include/clang/
>>> Driver/ClangOptionDocs.td?rev=292968&view=auto
>>> ============================================================
>>> ==================
>>> --- cfe/trunk/include/clang/Driver/ClangOptionDocs.td (added)
>>> +++ cfe/trunk/include/clang/Driver/ClangOptionDocs.td Tue Jan 24
>>> 13:39:46 2017
>>> @@ -0,0 +1,36 @@
>>> +//==--- ClangOptionDocs.td - Option documentation
>>> -------------------------===//
>>> +//
>>> +//                     The LLVM Compiler Infrastructure
>>> +//
>>> +// This file is distributed under the University of Illinois Open Source
>>> +// License. See LICENSE.TXT for details.
>>> +//
>>> +//===--------------------------------------------------------
>>
>>
>> _______________________________________________
>> cfe-commits mailing list
>> cfe-commits at lists.llvm.org
>> http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
>>
>> ...
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20170205/f303d3a8/attachment-0001.html>