config.5: Document CONF_CFLAGS under 'makeoptions'

This variable serves to tweak CFLAGS from the kernel configuration file,
easing some custom kernel builds.  It was introduced by bde@ in 1999.
This commit is contained in:
Olivier Certner 2025-05-27 09:41:19 +02:00
parent dec24dbb29
commit e89d737041
No known key found for this signature in database
GPG key ID: 8CA13040971E2627

View file

@ -316,11 +316,27 @@ variable is specified,
.Ar value
is assumed to be the empty string.
.Pp
Note that, as the common makefiles override the
.Va CFLAGS
variable after having processed the configuration file,
customizing
.Va CFLAGS
directly via
.Ic makeoptions
is not possible.
However, custom compiler flags can be specified using the
.Va CONF_CFLAGS
variable.
They are appended after most of the flags automatically going into
.Va CFLAGS ,
allowing to override those that are not essential to the build process.
.Pp
Example:
.Bd -literal -offset indent -compact
makeoptions MYMAKEOPTION="foo"
makeoptions MYMAKEOPTION+="bar"
makeoptions MYNULLMAKEOPTION
makeoptions CONF_CFLAGS+="-DSOME_CONTROLLING_MACRO"
.Ed
.\" -------- MAXUSERS --------
.Pp