--- clang-21.1 2026-09-28 00:34:21.910495687 +0000 +++ clang-21.1.new 2026-09-28 00:46:35.058584317 +0000 @@ -28,14 +28,12 @@ level margin: \\n[rst2man-indent\\n[rst2 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "CLANG" "1" "Sep 18, 2026" "15" "Clang" +.TH CLANG 1 "Sep 18, 2026" 15 Clang .SH NAME clang \- the Clang C, C++, and Objective-C compiler .SH SYNOPSIS -.sp \fBclang\fP [\fIoptions\fP] \fIfilename ???\fP .SH DESCRIPTION -.sp \fBclang\fP is a C, C++, and Objective\-C compiler which encompasses preprocessing, parsing, optimization, code generation, assembly, and linking. Depending on which high\-level mode setting is passed, Clang will stop before @@ -89,7 +87,7 @@ an ???a.out???, ???.dylib??? or ???.so?? .sp The Clang Static Analyzer is a tool that scans source code to try to find bugs through code analysis. This tool uses many parts of Clang and is built into -the same driver. Please see <\%> for more details +the same driver. Please see <\%> for more details on how to use the static analyzer. .SH OPTIONS .SS Stage Selection Options @@ -262,7 +260,7 @@ ISO C 202y with GNU extensions .UNINDENT .sp The default C language standard is \fBgnu17\fP, except on PS4, where it is -\fBgnu99\fP\&. +\fBgnu99\fP. .sp Supported values for the C++ language are: .INDENT 7.0 @@ -398,7 +396,7 @@ Working draft for C++2c with GNU extensi .UNINDENT .UNINDENT .sp -The default C++ language standard is \fBgnu++17\fP\&. +The default C++ language standard is \fBgnu++17\fP. .sp Supported values for the OpenCL language are: .INDENT 7.0 @@ -442,7 +440,7 @@ OpenCL 2.0 .UNINDENT .UNINDENT .sp -The default OpenCL language standard is \fBcl1.0\fP\&. +The default OpenCL language standard is \fBcl1.0\fP. .sp Supported values for the CUDA language are: .INDENT 7.0 @@ -493,13 +491,13 @@ Indicate that the file should be compile environment. Note that a freestanding build still requires linking against a C Standard Library which supports the freestanding interfaces for the specified language mode and target environment. This includes functions like \fImemcpy\fP, -\fImemmove\fP, and \fImemset\fP\&. +\fImemmove\fP, and \fImemset\fP. .UNINDENT .INDENT 0.0 .TP .B \-fno\-builtin Disable special handling and optimizations of well\-known library functions, -like \fBstrlen()\fP and \fBmalloc()\fP\&. +like \fBstrlen()\fP and \fBmalloc()\fP. .UNINDENT .INDENT 0.0 .TP @@ -512,7 +510,7 @@ For example, \fB\-fno\-builtin\-strlen\f .TP .B \-fno\-builtin\-std\- Disable special handling and optimizations for the specific C++ standard -library function in namespace \fBstd\fP\&. For example, +library function in namespace \fBstd\fP. For example, \fB\-fno\-builtin\-std\-move_if_noexcept\fP removes any special handling for the \fBstd::move_if_noexcept()\fP library function. .sp @@ -522,7 +520,7 @@ in namespace \fBstd\fP, use \fB\-fno\-bu .INDENT 0.0 .TP .B \-fmath\-errno -Indicate that math functions should be treated as updating \fBerrno\fP\&. +Indicate that math functions should be treated as updating \fBerrno\fP. .UNINDENT .INDENT 0.0 .TP @@ -537,8 +535,8 @@ Enable support for Microsoft extensions. .INDENT 0.0 .TP .B \-fmsc\-version= -Set \fB_MSC_VER\fP\&. When on Windows, this defaults to either the same value as -the currently installed version of cl.exe, or \fB1933\fP\&. Not set otherwise. +Set \fB_MSC_VER\fP. When on Windows, this defaults to either the same value as +the currently installed version of cl.exe, or \fB1933\fP. Not set otherwise. .UNINDENT .INDENT 0.0 .TP @@ -592,10 +590,9 @@ default). .TP .B \-fobjc\-nonfragile\-abi, \-fno\-objc\-nonfragile\-abi Enable use of the Objective\-C non\-fragile ABI. On platforms for which this is -the default ABI, it can be disabled with \fB\-fno\-objc\-nonfragile\-abi\fP\&. +the default ABI, it can be disabled with \fB\-fno\-objc\-nonfragile\-abi\fP. .UNINDENT .SS Target Selection Options -.sp Clang fully supports cross compilation as an inherent part of its design. Depending on how your version of Clang is configured, it may have support for a number of cross compilers, or may only support a native target. @@ -614,12 +611,12 @@ target is specified, the system default .INDENT 0.0 .TP .B \-mcpu=?, \-mtune=? -Acts as an alias for \fB\-\-print\-supported\-cpus\fP\&. +Acts as an alias for \fB\-\-print\-supported\-cpus\fP. .UNINDENT .INDENT 0.0 .TP .B \-mcpu=help, \-mtune=help -Acts as an alias for \fB\-\-print\-supported\-cpus\fP\&. +Acts as an alias for \fB\-\-print\-supported\-cpus\fP. .UNINDENT .INDENT 0.0 .TP @@ -656,7 +653,7 @@ Specify which optimization level to use: \fB\-O0\fP Means ???no optimization???: this level compiles the fastest and generates the most debuggable code. .sp -\fB\-O1\fP Somewhere between \fB\-O0\fP and \fB\-O2\fP\&. +\fB\-O1\fP Somewhere between \fB\-O0\fP and \fB\-O2\fP. .sp \fB\-O2\fP Moderate level of optimization which enables most optimizations. @@ -686,7 +683,7 @@ as at \fB\-O1\fP, but the \fB\-fextend\- also set, which tries to prevent optimizations from reducing the liveness of user variables, improving their availability when debugging. .sp -\fB\-O\fP Equivalent to \fB\-O1\fP\&. +\fB\-O\fP Equivalent to \fB\-O1\fP. .sp \fB\-O4\fP and higher .INDENT 0.0 @@ -701,7 +698,7 @@ Currently equivalent to \fB\-O3\fP .TP .B \-g, \-gline\-tables\-only, \-gmodules Control debug information output. Note that Clang debug information works -best at \fB\-O0\fP\&. When more than one option starting with \fI\-g\fP is +best at \fB\-O0\fP. When more than one option starting with \fI\-g\fP is specified, the last one wins: .INDENT 7.0 .INDENT 3.5 @@ -775,7 +772,7 @@ This flag sets the default visibility le .TP .B \-fcommon, \-fno\-common This flag specifies that variables without initializers get common linkage. -It can be disabled with \fB\-fno\-common\fP\&. +It can be disabled with \fB\-fno\-common\fP. .UNINDENT .INDENT 0.0 .TP @@ -809,7 +806,7 @@ compiling and linking in separate steps, ld64 linker not to delete the temporary object file generated during Link Time Optimization (this flag is automatically passed to the linker by Clang if compilation and linking are done in a single step). This allows debugging -the executable as well as generating the \fB\&.dSYM\fP bundle using \fBdsymutil(1)\fP\&. +the executable as well as generating the \fB.dSYM\fP bundle using \fBdsymutil(1)\fP. .UNINDENT .UNINDENT .UNINDENT @@ -910,7 +907,7 @@ Setting \fBCC_PRINT_INTERNAL_STAT_FILE\f statistics to the given file in the JSON format. .sp Note that \fB\-save\-stats\fP take precedence over \fBCC_PRINT_INTERNAL_STAT\fP -and \fBCC_PRINT_INTERNAL_STAT_FILE\fP\&. +and \fBCC_PRINT_INTERNAL_STAT_FILE\fP. .UNINDENT .INDENT 0.0 .TP @@ -995,7 +992,7 @@ Do not search the system C++ standard li .INDENT 0.0 .TP .B \-fkeep\-system\-includes -Usable only with \fB\-E\fP\&. Do not copy the preprocessed content of +Usable only with \fB\-E\fP. Do not copy the preprocessed content of ???system??? headers to the output; instead, preserve the #include directive. This can greatly reduce the volume of text produced by \fB\-E\fP which can be helpful when trying to produce a ???small??? reproduceable test case. @@ -1034,15 +1031,13 @@ paths to be used when processing the cor delimited as for the \fBCPATH\fP environment variable. .UNINDENT .SH BUGS -.sp -To report bugs, please visit <\%>. Most bug reports should +To report bugs, please visit <\%>. Most bug reports should include preprocessed source files (use the \fB\-E\fP option) and the full output of the compiler, along with information to reproduce. .SH SEE ALSO -.sp \fBas(1)\fP, \fBld(1)\fP .SH Author Maintained by the Clang / LLVM Team () .SH Copyright -2007-2026, The Clang Team +2007\(en2026, The Clang Team .\" End of generated man page.