[src/trunk]: src/share/man/man5 mk.conf(5): tweak BUILDID and option. sort MK...

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e598f45da37a
branches:  trunk
changeset: 378143:e598f45da37a
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jul 22 18:49:40 2023 +0000

description:
mk.conf(5): tweak BUILDID and option. sort MKKDEBUG

Clarify BUILDID behaviour with OBJMACHINE, and remove unnecessary sentence.
Use option not flag; option may include a flag with an argument.
Sort MKKDEBUG before MKKERBEROS4.

diffstat:

 share/man/man5/mk.conf.5 |  29 +++++++++++++++--------------
 1 files changed, 15 insertions(+), 14 deletions(-)

diffs (82 lines):

diff -r f0707153d35f -r e598f45da37a share/man/man5/mk.conf.5
--- a/share/man/man5/mk.conf.5  Sat Jul 22 15:19:17 2023 +0000
+++ b/share/man/man5/mk.conf.5  Sat Jul 22 18:49:40 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mk.conf.5,v 1.106 2023/07/05 16:40:34 lukem Exp $
+.\"    $NetBSD: mk.conf.5,v 1.107 2023/07/22 18:49:40 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 5, 2023
+.Dd July 22, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -134,12 +134,13 @@ targets.
 Identifier for the build.
 If set, this should be a short string that is suitable for use as
 part of a file or directory name.
-The identifier will be appended to
-object directory names, and can be consulted in the
-.Xr make 1
-configuration file in order to set additional build parameters,
-such as compiler flags.
-It will also be used as part of the kernel version string,
+The identifier will be appended to object directory names; if
+.Sy OBJMACHINE
+is also set, then
+.Pa \&. Ns Sy BUILDID
+is appended after
+.Pa \&. Ns Sy MACHINE .
+The identifier will also be used as part of the kernel version string,
 which can be shown by
 .Dq Li uname \-v .
 .DFLTu
@@ -203,7 +204,7 @@ space-separated paths.
 .DFLTu
 .
 .It Sy CONFIGOPTS
-Additional flags to
+Additional options to
 .Xr config 1
 when building kernels.
 .DFLTu
@@ -219,7 +220,7 @@ rather than explicitly set.
 not
 .Sy COPTS ,
 should be used for
-compiler flags that select CPU-related options.
+compiler options that select CPU-related options.
 .Pp
 .Em Note :
 .Sy CFLAGS
@@ -293,7 +294,7 @@ This variable should be used in conjunct
 .Sy HAVE_GCC
 or
 .Sy HAVE_LLVM
-setting to control the compiler flags.
+setting to control the compiler options.
 .Pp
 .Em Note :
 This variable is not yet used in as many places as it should be.
@@ -2422,13 +2423,13 @@ Obsolete.
 .It Sy MKEXTSRC
 Obsolete.
 .
-.It Sy MKKERBEROS4
-Obsolete.
-.
 .It Sy MKKDEBUG
 Use
 .Sy MKDEBUGKERNEL .
 .
+.It Sy MKKERBEROS4
+Obsolete.
+.
 .It Sy MKLLD
 Obsolete.
 .