From 8799241437c2fe87e24fb4ac65e44e1d046898ee Mon Sep 17 00:00:00 2001 From: jsg Date: Sat, 1 May 2021 01:00:41 +0000 Subject: [PATCH] regen llvm man pages from rst with cd /usr/src/gnu/llvm/llvm/docs gmake -f Makefile.sphinx man cd /usr/src/gnu/llvm/clang/docs gmake -f Makefile.sphinx man cmake -DLLVM_ENABLE_SPHINX=ON -DLLDB_INCLUDE_TESTS=OFF /usr/src/gnu/llvm/lldb/ make docs-lldb-man --- gnu/usr.bin/clang/clang/clang.1 | 25 ++++++++++++++---- gnu/usr.bin/clang/lldb/lldb.1 | 29 ++++++++++++++++----- gnu/usr.bin/clang/llvm-config/llvm-config.1 | 4 +-- 3 files changed, 44 insertions(+), 14 deletions(-) diff --git a/gnu/usr.bin/clang/clang/clang.1 b/gnu/usr.bin/clang/clang/clang.1 index 54de509dd86..bbd50b6241a 100644 --- a/gnu/usr.bin/clang/clang/clang.1 +++ b/gnu/usr.bin/clang/clang/clang.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "CLANG, CLANG++, CLANG-CPP" "1" "Jun 15, 2020" "10" "Clang" +.TH "CLANG, CLANG++, CLANG-CPP" "1" "May 01, 2021" "11" "Clang" .SH NAME clang, clang++, clang-cpp \- the Clang C, C++, and Objective-C compiler . @@ -223,7 +223,7 @@ ISO C 2017 with GNU extensions .UNINDENT .UNINDENT .sp -The default C language standard is \fBgnu11\fP, except on PS4, where it is +The default C language standard is \fBgnu17\fP, except on PS4, where it is \fBgnu99\fP\&. .sp Supported values for the C++ language are: @@ -416,7 +416,9 @@ Enable trigraphs. .TP .B \-ffreestanding Indicate that the file should be compiled for a freestanding, not a hosted, -environment. +environment. Note that it is assumed that a freestanding environment will +additionally provide \fImemcpy\fP, \fImemmove\fP, \fImemset\fP and \fImemcmp\fP +implementations, as these are needed for efficient codegen for many programs. .UNINDENT .INDENT 0.0 .TP @@ -572,7 +574,7 @@ size further. \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\&. +\fI\%\-O\fP Equivalent to \fI\%\-O1\fP\&. .sp \fI\%\-O4\fP and higher .INDENT 0.0 @@ -676,6 +678,19 @@ 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. +.sp +\fBNOTE:\fP +.INDENT 7.0 +.INDENT 3.5 +On Darwin, when using \fI\%\-flto\fP along with \fB\-g\fP and +compiling and linking in separate steps, you also need to pass +\fB\-Wl,\-object_path_lto,.o\fP at the linking step to instruct the +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\&. +.UNINDENT +.UNINDENT .UNINDENT .SS Driver Options .INDENT 0.0 @@ -881,6 +896,6 @@ output of the compiler, along with information to reproduce. .SH AUTHOR Maintained by the Clang / LLVM Team () .SH COPYRIGHT -2007-2020, The Clang Team +2007-2021, The Clang Team .\" Generated by docutils manpage writer. . diff --git a/gnu/usr.bin/clang/lldb/lldb.1 b/gnu/usr.bin/clang/lldb/lldb.1 index a941b8e2aa2..f4c99a9efb4 100644 --- a/gnu/usr.bin/clang/lldb/lldb.1 +++ b/gnu/usr.bin/clang/lldb/lldb.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "LLDB" "1" "Jun 15, 2020" "8" "LLDB" +.TH "LLDB" "1" "May 01, 2021" "11" "LLDB" .SH NAME lldb \- LLDB Documentation . @@ -315,12 +315,20 @@ Tells the debugger to use the specified scripting language for user\-defined scr .sp The debugger can be started in several modes. .sp -Passing an executable as a positional argument prepares \fBlldb\fP to -debug the given executable. Arguments passed after \-\- are considered arguments -to the debugged executable. +Passing an executable as a positional argument prepares lldb to debug the given +executable. To disambiguate between arguments passed to lldb and arguments +passed to the debugged executable, arguments starting with a \- must be passed +after \-\-. .INDENT 0.0 .INDENT 3.5 -lldb \-\-arch x86_64 /path/to/program \-\- \-\-arch arvm7 +lldb \-\-arch x86_64 /path/to/program program argument \-\- \-\-arch armv7 +.UNINDENT +.UNINDENT +.sp +For convenience, passing the executable after \-\- is also supported. +.INDENT 0.0 +.INDENT 3.5 +lldb \-\-arch x86_64 \-\- /path/to/program program argument \-\-arch armv7 .UNINDENT .UNINDENT .sp @@ -373,7 +381,14 @@ For instance, "apropos breakpoint" will list any command that has the word .SH CONFIGURATION FILES .sp \fBlldb\fP reads things like settings, aliases and commands from the -.lldbinit file. It will first look for ~/.lldbinit and load that first. +\&.lldbinit file. +.sp +First, it will read the application specific init file whose name is +~/.lldbinit followed by a "\-" and the name of the current program. This would +be ~/.lldbinit\-lldb for the command line \fBlldb\fP and ~/.lldbinit\-Xcode +for Xcode. If there is no application specific init file, the global +~/.lldbinit is read. +.sp Secondly, it will look for an .lldbinit file in the current working directory. For security reasons, \fBlldb\fP will print a warning and not source this file by default. This behavior can be changed by changing the @@ -403,6 +418,6 @@ coming from gdb. .SH AUTHOR LLVM project .SH COPYRIGHT -2007-2020, The LLDB Team +2007-2021, The LLDB Team .\" Generated by docutils manpage writer. . diff --git a/gnu/usr.bin/clang/llvm-config/llvm-config.1 b/gnu/usr.bin/clang/llvm-config/llvm-config.1 index 0fd0e5b2f30..394cb666706 100644 --- a/gnu/usr.bin/clang/llvm-config/llvm-config.1 +++ b/gnu/usr.bin/clang/llvm-config/llvm-config.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "LLVM-CONFIG" "1" "2019-06-23" "8" "LLVM" +.TH "LLVM-CONFIG" "1" "2021-05-01" "11" "LLVM" .SH NAME llvm-config \- Print LLVM compilation options . @@ -204,6 +204,6 @@ occurs, it will exit with a non\-zero value. .SH AUTHOR Maintained by the LLVM Team (https://llvm.org/). .SH COPYRIGHT -2003-2019, LLVM Project +2003-2021, LLVM Project .\" Generated by docutils manpage writer. . -- 2.20.1