src.conf.5: Expand WITH_LLVM_BINUTILS description

List the specific tools that are controlled by WITH_LLVM_BINUTILS, and
mention the tools that are always or never taken from LLVM.  Tools come
from one of three sources (LLVM, ELF Tool Chain, bespoke base system)
and it is useful to be explicit.

Reviewed by:	markj
Sponsored by:	The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D39428
This commit is contained in:
Ed Maste 2023-04-05 11:21:26 -04:00
parent ce12afaa6f
commit a9d0665bbb
2 changed files with 36 additions and 2 deletions

View file

@ -906,7 +906,24 @@ some other way.
.It Va WITHOUT_LLVM_ASSERTIONS
Disable debugging assertions in LLVM.
.It Va WITH_LLVM_BINUTILS
Install LLVM's binutils (ar, addr2line, nm, etc.) instead of ELF Tool Chain's.
Install LLVM's binutils (without an llvm- prefix),
instead of ELF Tool Chain's tools.
This includes
.Xr addr2line 1 ,
.Xr ar 1 ,
.Xr nm 1 ,
.Xr objcopy 1 ,
.Xr ranlib 1 ,
.Xr readelf 1 ,
.Xr size 1 ,
and
.Xr strip 1 .
Regardless of this setting, LLVM tools are used for
.Xr c++filt 1
and
.Xr objdump 1 .
.Xr strings 1
is always provided by ELF Tool Chain.
.It Va WITHOUT_LLVM_COV
Do not build the
.Xr llvm-cov 1

View file

@ -1,2 +1,19 @@
.\" $FreeBSD$
Install LLVM's binutils (ar, addr2line, nm, etc.) instead of ELF Tool Chain's.
Install LLVM's binutils (without an llvm- prefix),
instead of ELF Tool Chain's tools.
This includes
.Xr addr2line 1 ,
.Xr ar 1 ,
.Xr nm 1 ,
.Xr objcopy 1 ,
.Xr ranlib 1 ,
.Xr readelf 1 ,
.Xr size 1 ,
and
.Xr strip 1 .
Regardless of this setting, LLVM tools are used for
.Xr c++filt 1
and
.Xr objdump 1 .
.Xr strings 1
is always provided by ELF Tool Chain.