From 1a716a5f949b84cd8a84871ad7caa9d985fe91fc Mon Sep 17 00:00:00 2001 From: Nathan Phillip Brink Date: Tue, 20 Apr 2010 09:23:45 -0400 Subject: [PATCH] make.conf(5): document LDFLAGS with a warning, explain the different between C and CXX FLAGS. Thanks to few and abcd. --- man/make.conf.5 | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/man/make.conf.5 b/man/make.conf.5 index c190f565a..1546aae3a 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -91,7 +91,9 @@ This controls the space use limitations for ccache. The default is 2 gigabytes .TP .B CFLAGS CXXFLAGS Use these variables to set the desired optimization/CPU instruction settings -for applications that you compile. Nearly all ebuild files will take advantage +for applications that you compile. These two variables are passed to the C +and C++ compilers, respectively. (CXX is used to refer to the C++ compiler +within many buildsystems.) Nearly all ebuild files will take advantage of your custom settings, resulting in a Gentoo Linux that is fully customized to your specifications. Please use sane settings as some packages will fail to compile/run if the optimizations are too extreme. @@ -488,6 +490,18 @@ Also supported is a \fBPKG_INSTALL_MASK\fR variable that behaves exactly like \fBINSTALL_MASK\fR except that it is processed just before creation of a binary package. .TP +.B LDFLAGS +A list of flags to pass to the compiler when the linker will be called. See +\fBld\fR(1) for linker flags, but don't forget that these flags will be passed +directly to the compiler. Thus, you must use '-Wl' to escape the flags +which only the linker understands (see \fBgcc\fR(1)). + +\fB***warning***\fR +.br +Setting this and other *FLAGS variables arbitrarily may cause compile or +runtime failures. Bug reports submitted when nonstandard values are +enabled for these flags may be closed as INVALID. +.TP .B MAKEOPTS Use this variable if you want to use parallel make. For example, if you have a dual\-processor system, set this variable to "\-j2" or "\-j3" for -- 2.26.2