With config(1) as it exists today, a kernel Makefile is able to implement
logic on kernel options so long as those options are not defflag'd or
defparam'd. This works because such options are automatally added to the
IDENT var in the kernel Makefile as a preprocessor define, and the Makefile
can then do an operation like:

.if !empty(IDENT:M-DSOMECOOLCPUOPTION)
CFLAGS+= -mcpu=somecoolcpu
.endif

Unfortunately, this precludes making it possible to generate a compile-time
dependency on SOMECOOLCPUOPTION, or having SOMECOOLCPUOPTION imply another
kernel config option using the normal config(1) option dependency function.

Fix this by introducing a new option description keyword: mkflagvar. This
keyword marks an already defflag'd option as wanting a kernel Makefile var
defined if that option is selected in the kernel config file. So:

defflag opt_coolcpu.h SOMECOOLCPUOPTION ANOTHERCOOLCPUOPTION
mkflagvar SOMECOOLCPUOPTION ANOTHERCOOLCPUOPTION

will cause:

KERNEL_OPT_SOMECOOLCPUOPTION="1"
KERNEL_OPT_ANOTHERCOOLCPUOPTION="1"

...to be emitted into the kernel Makefile if those options are, in fact,
selected with "options ..." in the kernel config file, thus allowing for
a compile-time dependency on the option to be generated in addition to
Makefile logic, which now looks like:

.if !empty(KERNEL_OPT_SOMECOOLCPUOPTION)
CFLAGS+= -mcpu=somecoolcpu
.endif

remove duplicate the article in documentation.

Add missing double p and d for stopped and overriden accordingly.
Fix few more typos along the way, mainly in copy-pasted comments.

s/implicitely/implicitly/

Swtich from -ohang to -tag lists.

-ohang lists are hard to read b/c long config directives are almost
impossible to tell from the following text. Occasional multi-paragraph
descriptions were quite confusing too.

Missed formatting fixes for "no makeoptions".

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.

Formatting improvements.

Minor tweak to list formatting.

Where necessary, use .Bl -ohang -compact and explicit .Pp to be able
to group multiple config directives (separate .It) by omitting .Pp
between them.

While here, add a .|" comment before .It to make them more visible
when editing.

Formatting improvements.

Only comb through the first few pages (OBJECTS AND NAMES) for now.

Use .Em for emphasis, not .Ar (both look the same in text output, but
.Ar is very confusing in PostScript). Reduce emphasis - don't
highlight every usage of a term. Where everything is emphasized
nothing is.

Fix PS formatting of locator syntax examples so that square brackets
are literal and don't look meta-syntactic. Explicitly show optional
locator syntax (in literal square brackets).

Remove workaround for ancient HTML generation code.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.

remove duplicate the article in documentation.

Add missing double p and d for stopped and overriden accordingly.
Fix few more typos along the way, mainly in copy-pasted comments.

s/implicitely/implicitly/

Swtich from -ohang to -tag lists.

-ohang lists are hard to read b/c long config directives are almost
impossible to tell from the following text. Occasional multi-paragraph
descriptions were quite confusing too.

Missed formatting fixes for "no makeoptions".

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.

Formatting improvements.

Minor tweak to list formatting.

Where necessary, use .Bl -ohang -compact and explicit .Pp to be able
to group multiple config directives (separate .It) by omitting .Pp
between them.

While here, add a .|" comment before .It to make them more visible
when editing.

Formatting improvements.

Only comb through the first few pages (OBJECTS AND NAMES) for now.

Use .Em for emphasis, not .Ar (both look the same in text output, but
.Ar is very confusing in PostScript). Reduce emphasis - don't
highlight every usage of a term. Where everything is emphasized
nothing is.

Fix PS formatting of locator syntax examples so that square brackets
are literal and don't look meta-syntactic. Explicitly show optional
locator syntax (in literal square brackets).

Remove workaround for ancient HTML generation code.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.

Add missing double p and d for stopped and overriden accordingly.
Fix few more typos along the way, mainly in copy-pasted comments.

s/implicitely/implicitly/

Swtich from -ohang to -tag lists.

-ohang lists are hard to read b/c long config directives are almost
impossible to tell from the following text. Occasional multi-paragraph
descriptions were quite confusing too.

Missed formatting fixes for "no makeoptions".

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.

Formatting improvements.

Minor tweak to list formatting.

Where necessary, use .Bl -ohang -compact and explicit .Pp to be able
to group multiple config directives (separate .It) by omitting .Pp
between them.

While here, add a .|" comment before .It to make them more visible
when editing.

Formatting improvements.

Only comb through the first few pages (OBJECTS AND NAMES) for now.

Use .Em for emphasis, not .Ar (both look the same in text output, but
.Ar is very confusing in PostScript). Reduce emphasis - don't
highlight every usage of a term. Where everything is emphasized
nothing is.

Fix PS formatting of locator syntax examples so that square brackets
are literal and don't look meta-syntactic. Explicitly show optional
locator syntax (in literal square brackets).

Remove workaround for ancient HTML generation code.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.

s/implicitely/implicitly/

Swtich from -ohang to -tag lists.

-ohang lists are hard to read b/c long config directives are almost
impossible to tell from the following text. Occasional multi-paragraph
descriptions were quite confusing too.

Missed formatting fixes for "no makeoptions".

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.

Formatting improvements.

Minor tweak to list formatting.

Where necessary, use .Bl -ohang -compact and explicit .Pp to be able
to group multiple config directives (separate .It) by omitting .Pp
between them.

While here, add a .|" comment before .It to make them more visible
when editing.

Formatting improvements.

Only comb through the first few pages (OBJECTS AND NAMES) for now.

Use .Em for emphasis, not .Ar (both look the same in text output, but
.Ar is very confusing in PostScript). Reduce emphasis - don't
highlight every usage of a term. Where everything is emphasized
nothing is.

Fix PS formatting of locator syntax examples so that square brackets
are literal and don't look meta-syntactic. Explicitly show optional
locator syntax (in literal square brackets).

Remove workaround for ancient HTML generation code.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.

Swtich from -ohang to -tag lists.

-ohang lists are hard to read b/c long config directives are almost
impossible to tell from the following text. Occasional multi-paragraph
descriptions were quite confusing too.

Missed formatting fixes for "no makeoptions".

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.

Formatting improvements.

Minor tweak to list formatting.

Where necessary, use .Bl -ohang -compact and explicit .Pp to be able
to group multiple config directives (separate .It) by omitting .Pp
between them.

While here, add a .|" comment before .It to make them more visible
when editing.

Formatting improvements.

Only comb through the first few pages (OBJECTS AND NAMES) for now.

Use .Em for emphasis, not .Ar (both look the same in text output, but
.Ar is very confusing in PostScript). Reduce emphasis - don't
highlight every usage of a term. Where everything is emphasized
nothing is.

Fix PS formatting of locator syntax examples so that square brackets
are literal and don't look meta-syntactic. Explicitly show optional
locator syntax (in literal square brackets).

Remove workaround for ancient HTML generation code.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.

Remove workaround for ancient HTML generation code.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.

Don't reference older CFATTACH_DECL

branches: 1.36.2;
New sentence, new line. Bump date for previous.

Extend syntax of config phrase, a quoted string instead of a device name
is passed as root specification string. This can be used to specify a
wedge by name.

Introduce a new syntax, "buildprefix", to specify prefix of files under kernel
build subdirectory. This is not used now that everything is built at the
top of kernel build directory. It will become mandatory for source/object
files put out of kernel source tree to specify corresponding build subdirectory.
Only ``no dots'' relative path is accepted as "buildprefix".

Allow redefinition of options (with only a warning message). Removal
of non-included options was already only a warning.

This also affects redefinition and removal of file-system and makeoption
entries.

Reviewed and OKd by uebayasi@

Need to read closer - there was another occurrence of the same tyepo

Tyepo

Fix a macro usage. Add more markup.

Define `makeoptions' values as parameters with "makeoptions_" prefix too.
C sources are encouraged to include relevant opt_*.h files rather than relying
on -DXXX passed via makefiles.

Revert "Retire optional `rule' argument of `file' command". It is still used
in m68k ports.

Retire optional `rule' argument of `file' command.

This has existed since Rev. 1.1 of Torek's config(8) [1], but probably has
never been used by anyone.

(I can not imagine how a `file' like look like if `rule' is specified.)

[1] http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.sbin/config.new/Attic/files.c?rev=1.1

Paths given to "file" and "object" are relative from "prefix" if defined.

config(1), config(5): Introduce "select"

o Introduce a new selection directive "select" to select an attribute (as a
module) and its dependencies.
o Support "no select" too.
o Stop abusing "options" to select an attribute.
o Bump config(1) version.

branches: 1.24.2;
Bump date for previous.

implement "no ident".

branches: 1.22.2;
Fix some typos found by Rich Neswold and reported in PR 48597.

branches: 1.21.6; 1.21.12;
Remove fs_foo.h support from deffs now that nothing uses it.

Bump date.

Remove mentions that a kernel configuration file must support at least one
file-system because it's no longer true.

branches: 1.18.6;
Disable use of pseudo-devices defined "defpseudo" with interface
attributes, but provide compatibility for older source trees (according
to the "version" in conf/files and other files.*.
reviewed by cube

Bump date for previous.

Seperate pseudo-devs which don't use device_t et al. (the classical
ones, mostly network pseudo interfaces) and those which use autoconf
to attach instances dynamically, or to attach child devices.
Use a new keyword "defpseudodev" for the latter.
Issue a warning if interface attributes are used with "old" pseudodevs,
but let it work as before for now. This will be removed soon.
approved by cube

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Typo.

Make the "machine" statement define attributes for `machine', `arch' and
all the `subarch' given as parameters. This is useful in combination with
ifdef...

Add support for "ifdef <attribute>" blocks. It goes like this:

ifdef <attr> / ifndef <attr>
elifdef <attr>
elifndef <attr>
else
endif

No indentation is possible for now, it will come later.

Some more licence clean up.

branches: 1.10.4;
Add new syntaxic sugar to provide a value in lint (i.e., config -L)
configurations for defparams. It will be used _only_ by config -L.

This will greatly help automating tests with lint configurations,
hopefully.

Improve formatting, fix typo, bump date for previous.

- Document "source /path" and "build /path".
- Move documentation for "package", because as I learned tonight, it's not
allowed before setmachine. You get to discover scary new stuff about
config(1) each time you look at it.

Mention that newlines mid-statement are allowed, and clarify how
needs-count and needs-flag work, notably for simple attributes.

fix spelling of accommodate; from Zapher.

Fix typo.

Add support for specifying a default value on a 'defparam' line.
If a default is specified then the option is always defined in the
corresponding .h file.
Particularly useful for parameters where the default action isn't the
same a defining the value zero, given that the current use of #if defined(opt)
is open to problems wehere the relevant .h file isn't actually included, so
requiring an option to always have a value makes sense.
Also included (but commented out) is code that adds a global symbol to
the object file to stop objects compiled with different values for the
same option being linked together - I'm not quite happy with it yet!

s/setmachine/machine. Overlook pointed out by Havard Eidnes.

branches: 1.2.2;
Set a more realistic date than the day I started writing it.

Everything you've always wanted to know about config(1) without daring
asking (with reason).

You've entered the config(1) dungeon--More--
An option hits you. You die.