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

diff --git a/gnu/usr.bin/clang/clang/clang.1 b/gnu/usr.bin/clang/clang/clang.1
index 54de509..bbd50b6 100644 (file)
--- 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,<lto\-filename>.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 (<http://clang.llvm.org>)
 .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 a941b8e..f4c99a9 100644 (file)
--- 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 0fd0e5b..394cb66 100644 (file)
--- 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.
 .