From e20d310334e12a1d7f96c13ad7e140baea82c9e2 Mon Sep 17 00:00:00 2001
From: Sascha Wildner <saw@online.de>
Date: Sat, 31 Oct 2009 00:57:05 +0100
Subject: [PATCH] make.conf.5: Add documentation for BINUTILSVER and
 DEBUG_FLAGS.

While here, sync a couple of descriptions with the current state of
things.
---
 share/man/man5/make.conf.5 | 39 ++++++++++++++++++++++++++++++++------
 1 file changed, 33 insertions(+), 6 deletions(-)

diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5
index f174edd761..047578af4d 100644
--- a/share/man/man5/make.conf.5
+++ b/share/man/man5/make.conf.5
@@ -25,7 +25,7 @@
 .\" $FreeBSD: src/share/man/man5/make.conf.5,v 1.12.2.30 2003/05/18 17:05:55 brueffer Exp $
 .\" $DragonFly: src/share/man/man5/make.conf.5,v 1.38 2008/11/03 00:25:45 pavalos Exp $
 .\"
-.Dd September 16, 2009
+.Dd October 31, 2009
 .Dt MAKE.CONF 5
 .Os
 .Sh NAME
@@ -116,9 +116,21 @@ It should be set as
 so as not to interfere with overrides from userland.
 We currently recommend that an override NOT be set in
 .Pa /etc/make.conf .
-Currently accepted values are
+Currently accepted values for compilers which are part of
+.Dx
+are
 .Dq gcc41
-(default).
+(default) and
+.Dq gcc44 .
+All other values will handled according to the settings in
+.Xr compilers.conf 5 .
+.It Va BINUTILSVER
+.Pq Vt str
+Controls which binutils to use by default.
+Currently accepted values are
+.Dq binutils217
+(default) and
+.Dq binutils220 .
 .It Va CFLAGS
 .Pq Vt str
 Controls the compiler setting when compiling C code.
@@ -136,6 +148,18 @@ They can be used, if set, by:
 .Bd -literal -offset indent
 CFLAGS+=${BDECFLAGS}
 .Ed
+.It Va DEBUG_FLAGS
+.Pq Vt str
+Similar to
+.Va CFLAGS
+but it will cause
+.Va STRIP
+to be set to a blank value, if set.
+Typically,
+.Va DEBUG_FLAGS
+is set to
+.Fl g
+for compiling with debug symbols.
 .It Va NO_CPU_CFLAGS
 .Pq Vt str
 Setting this variable will prevent CPU specific compiler flags
@@ -191,11 +215,14 @@ to cause
 to follow symlinks.
 .It Va STRIP
 .Pq Vt str
-Set this to the flag to pass the
+Set this to the flag to pass to the
 .Xr strip 1
 command.
-If set to a blank value, components will be installed with debugging
-symbols.
+If set to a blank value, debug symbols will not be removed.
+.Va STRIP
+is automatically set to a blank value if
+.Va DEBUG_FLAGS
+is set.
 .It Va WANT_HESIOD
 .Pq Vt bool
 Set this to build
-- 
2.41.0