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.
This commit is contained in:
uwe 2020-07-31 23:42:21 +00:00
parent 0f7930473b
commit 57d0cb113c
1 changed files with 33 additions and 9 deletions

View File

@ -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 @@ indicates when the relevant line should be added to
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 @@ is defined with
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