[src/trunk]: src/usr.bin/config The tale of two makeoptions.

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

details:   https://anonhg.NetBSD.org/src/rev/8c47ce982fc0
branches:  trunk
changeset: 936620:8c47ce982fc0
user:      uwe <uwe%NetBSD.org@localhost>
date:      Fri Jul 31 23:42:21 2020 +0000

description:
The tale of two makeoptions.

There are two forms that were both documented in the selections
section, but the form with the condition (and only that form) can be
used only in the descriptions section.  Move it to the appropriate .Ss
and add prominent notice to both.

diffstat:

 usr.bin/config/config.5 |  42 +++++++++++++++++++++++++++++++++---------
 1 files changed, 33 insertions(+), 9 deletions(-)

diffs (63 lines):

diff -r 7c23dbff74cd -r 8c47ce982fc0 usr.bin/config/config.5
--- a/usr.bin/config/config.5   Fri Jul 31 23:30:23 2020 +0000
+++ b/usr.bin/config/config.5   Fri Jul 31 23:42:21 2020 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: config.5,v 1.41 2020/07/31 23:30:23 uwe Exp $
+.\" $NetBSD: config.5,v 1.42 2020/07/31 23:42:21 uwe Exp $
 .\"
 .\"  Copyright (c) 2006, 2007 The NetBSD Foundation.
 .\"  All rights reserved.
@@ -666,6 +666,26 @@
 and works just like the
 .Ic file
 statement.
+.\"
+.Pp
+.It Ic makeoptions \
+    Ar condition name Ns Ic += Ns Ar value \
+    Ns Op Ic \&, Ar condition name Ns Ic += Ns Ar value \
+    Ns Op Ic \&, Ar ...
+Appends to a definition in the generated
+.Pa Makefile .
+.Pp
+This variant of
+.Ic makeoptions
+belongs to the options description section.
+The
+.Ar condition
+is mandatory and only
+.Ic +=
+can be used.
+Not to be confused with the the confusingly similar variant of
+.Ic makeoptions
+used in the selections section.
 .El
 .\"
 .\"
@@ -868,14 +888,18 @@
 the
 .Ar value
 is defined as an option too.
-.\"
-.\" XXX: This variant of makeoptions can only be specified in the descriptions.
-.It Ic makeoptions \
-    Ar condition name Ns Ic += Ns Ar value \
-    Ns Op Ic \&, Ar condition name Ns Ic += Ns Ar value \
-    Ns Op Ic \&, Ar ...
-Appends to a definition in the generated
-.Pa Makefile .
+.Pp
+This variant of
+.Ic makeoptions
+belongs to the options selection section.
+Both
+.Ic =
+and
+.Ic +=
+can be used.
+Not to be confused with the confusingly similar variant of
+.Ic makeoptions
+used in the descriptions section.
 .\"
 .It Ic no makeoptions Ar name Op , Ar name Op , Ar ...
 Removes one or more definitions from the generated