From owner-svn-src-projects@freebsd.org Sun Dec 24 13:06:39 2017 Return-Path: Delivered-To: svn-src-projects@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 068D1E8D257 for ; Sun, 24 Dec 2017 13:06:39 +0000 (UTC) (envelope-from dim@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id D269678BFA; Sun, 24 Dec 2017 13:06:38 +0000 (UTC) (envelope-from dim@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id vBOD6c7P081039; Sun, 24 Dec 2017 13:06:38 GMT (envelope-from dim@FreeBSD.org) Received: (from dim@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id vBOD6cEM081038; Sun, 24 Dec 2017 13:06:38 GMT (envelope-from dim@FreeBSD.org) Message-Id: <201712241306.vBOD6cEM081038@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: dim set sender to dim@FreeBSD.org using -f From: Dimitry Andric Date: Sun, 24 Dec 2017 13:06:38 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r327148 - projects/clang600-import/usr.bin/clang/clang X-SVN-Group: projects X-SVN-Commit-Author: dim X-SVN-Commit-Paths: projects/clang600-import/usr.bin/clang/clang X-SVN-Commit-Revision: 327148 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-projects@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: "SVN commit messages for the src " projects" tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 24 Dec 2017 13:06:39 -0000 Author: dim Date: Sun Dec 24 13:06:37 2017 New Revision: 327148 URL: https://svnweb.freebsd.org/changeset/base/327148 Log: Regenerate clang manpage. Modified: projects/clang600-import/usr.bin/clang/clang/clang.1 Modified: projects/clang600-import/usr.bin/clang/clang/clang.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/clang/clang.1 Sun Dec 24 13:02:43 2017 (r327147) +++ projects/clang600-import/usr.bin/clang/clang/clang.1 Sun Dec 24 13:06:37 2017 (r327148) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "CLANG" "1" "March 04, 2016" "3.8" "Clang" +.TH "CLANG" "1" "Dec 24, 2017" "6" "Clang" .SH NAME clang \- the Clang C, C++, and Objective-C compiler . @@ -135,10 +135,16 @@ Specify the language standard to compile for. .TP .B \-stdlib= Specify the C++ standard library to use; supported options are libstdc++ and -libc++. +libc++. If not specified, platform default will be used. .UNINDENT .INDENT 0.0 .TP +.B \-rtlib= +Specify the compiler runtime library to use; supported options are libgcc and +compiler\-rt. If not specified, platform default will be used. +.UNINDENT +.INDENT 0.0 +.TP .B \-ansi Same as \-std=c89. .UNINDENT @@ -207,18 +213,6 @@ Enable the "Blocks" language feature. .UNINDENT .INDENT 0.0 .TP -.B \-fobjc\-gc\-only -Indicate that Objective\-C code should be compiled in GC\-only mode, which only -works when Objective\-C Garbage Collection is enabled. -.UNINDENT -.INDENT 0.0 -.TP -.B \-fobjc\-gc -Indicate that Objective\-C code should be compiled in hybrid\-GC mode, which -works with both GC and non\-GC mode. -.UNINDENT -.INDENT 0.0 -.TP .B \-fobjc\-abi\-version=version Select the Objective\-C ABI version to use. Available versions are 1 (legacy "fragile" ABI), 2 (non\-fragile ABI 1), and 3 (non\-fragile ABI 2). @@ -233,9 +227,9 @@ default). .UNINDENT .INDENT 0.0 .TP -.B \-fobjc\-nonfragile\-abi +.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 \fI\%\-fno\-objc\-nonfragile\-abi\fP\&. .UNINDENT .SS Target Selection Options .sp @@ -270,7 +264,7 @@ but which may not exist on earlier ones. .SS Code Generation Options .INDENT 0.0 .TP -.B \-O0, \-O1, \-O2, \-O3, \-Ofast, \-Os, \-Oz, \-O, \-O4 +.B \-O0, \-O1, \-O2, \-O3, \-Ofast, \-Os, \-Oz, \-Og, \-O, \-O4 Specify which optimization level to use: .INDENT 7.0 .INDENT 3.5 @@ -296,6 +290,9 @@ size. \fI\%\-Oz\fP Like \fI\%\-Os\fP (and thus \fI\%\-O2\fP), but reduces code size further. .sp +\fI\%\-Og\fP Like \fI\%\-O1\fP\&. In future versions, this option might +disable different optimizations in order to improve debuggability. +.sp \fI\%\-O\fP Equivalent to \fI\%\-O2\fP\&. .sp \fI\%\-O4\fP and higher @@ -309,22 +306,34 @@ Currently equivalent to \fI\%\-O3\fP .UNINDENT .INDENT 0.0 .TP -.B \-g -Generate debug information. Note that Clang debug information works best at \-O0. -.UNINDENT -.INDENT 0.0 -.TP -.B \-gmodules -Generate debug information that contains external references to -types defined in clang modules or precompiled headers instead of -emitting redundant debug type information into every object file. -This option implies \fB\-fmodule\-format=obj\fP\&. +.B \-g, \-gline\-tables\-only, \-gmodules +Control debug information output. Note that Clang debug information works +best at \fI\%\-O0\fP\&. When more than one option starting with \fI\-g\fP is +specified, the last one wins: +.INDENT 7.0 +.INDENT 3.5 +\fB\-g\fP Generate debug information. .sp +\fB\-gline\-tables\-only\fP Generate only line table debug information. This +allows for symbolicated backtraces with inlining information, but does not +include any information about variables, their locations or types. +.sp +\fI\%\-gmodules\fP Generate debug information that contains external +references to types defined in Clang modules or precompiled headers instead +of emitting redundant debug type information into every object file. This +option transparently switches the Clang module format to object file +containers that hold the Clang module together with the debug information. +When compiling a program that uses Clang modules or precompiled headers, +this option produces complete debug information with faster compile +times and much smaller object files. +.sp This option should not be used when building static libraries for distribution to other machines because the debug info will contain -references to the module cache on the machine the object files in -the library were built on. +references to the module cache on the machine the object files in the +library were built on. .UNINDENT +.UNINDENT +.UNINDENT .INDENT 0.0 .TP .B \-fstandalone\-debug \-fno\-standalone\-debug @@ -362,9 +371,9 @@ This flag sets the default visibility level. .UNINDENT .INDENT 0.0 .TP -.B \-fcommon +.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 \fI\%\-fno\-common\fP\&. .UNINDENT .INDENT 0.0 .TP @@ -377,11 +386,17 @@ to choose a more efficient model if possible. .UNINDENT .INDENT 0.0 .TP -.B \-flto, \-emit\-llvm +.B \-flto, \-flto=full, \-flto=thin, \-emit\-llvm Generate output files in LLVM formats, suitable for link time optimization. When used with \fI\%\-S\fP this generates LLVM intermediate language assembly files, otherwise this generates LLVM bitcode format object files (which may be passed to the linker depending on the stage selection options). +.sp +The default for \fI\%\-flto\fP is "full", in which the +LLVM bitcode is suitable for monolithic Link Time Optimization (LTO), where +the linker merges all such modules into a single combined module for +optimization. With "thin", ThinLTO +compilation is invoked instead. .UNINDENT .SS Driver Options .INDENT 0.0 @@ -447,7 +462,8 @@ Print the full library path of file. .INDENT 0.0 .TP .B \-print\-libgcc\-file\-name -Print the library path for "libgcc.a". +Print the library path for the currently used compiler runtime library +("libgcc.a" or "libclang_rt.builtins.*.a"). .UNINDENT .INDENT 0.0 .TP @@ -466,6 +482,13 @@ Save intermediate compilation results. .UNINDENT .INDENT 0.0 .TP +.B \-save\-stats, \-save\-stats=cwd, \-save\-stats=obj +Save internal code generation (LLVM) statistics to a file in the current +directory (\fI\%\-save\-stats\fP/"\-save\-stats=cwd") or the directory +of the output file ("\-save\-state=obj"). +.UNINDENT +.INDENT 0.0 +.TP .B \-integrated\-as, \-no\-integrated\-as Used to enable and disable, respectively, the use of the integrated assembler. Whether the integrated assembler is on by default is target @@ -575,10 +598,10 @@ include preprocessed source files (use the \fI\%\-E\fP output of the compiler, along with information to reproduce. .SH SEE ALSO .sp -\fIas(1)\fP, \fIld(1)\fP +\fBas(1)\fP, \fBld(1)\fP .SH AUTHOR Maintained by the Clang / LLVM Team () .SH COPYRIGHT -2007-2016, The Clang Team +2007-2017, The Clang Team .\" Generated by docutils manpage writer. .