NetBSD Problem Report #6981
Received: (qmail 6208 invoked from network); 10 Feb 1999 19:51:27 -0000
Message-Id: <19990210195125.58D29155@jekyll.piermont.com>
Date: Wed, 10 Feb 1999 14:51:25 -0500 (EST)
From: perry@piermont.com
Reply-To: perry@piermont.com
To: gnats-bugs@gnats.netbsd.org
Subject: kernel config syntax undocumented
X-Send-Pr-Version: 3.95
>Number: 6981
>Category: kern
>Synopsis: kernel config syntax undocumented
>Confidential: no
>Severity: non-critical
>Priority: high
>Responsible: kern-bug-people
>State: closed
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Wed Feb 10 12:05:01 +0000 1999
>Closed-Date: Wed Apr 07 10:52:12 +0000 1999
>Last-Modified: Wed Apr 07 10:52:34 +0000 1999
>Originator: Perry E. Metzger
>Release: NetBSD-1.3I
>Organization:
Perry Metzger perry@piermont.com
--
"Ask not what your country can force other people to do for you."
>Environment:
System: NetBSD jekyll.piermont.com 1.3I NetBSD 1.3I (JEKYLL) #0: Mon Jan 25 12:01:45 EST 1999 perry@jekyll.piermont.com:/usr/src/sys/arch/i386/compile/JEKYLL i386
>Description:
There is no documentation for the syntax of config(8) kernel
configuration files. config(8) describes nothing, and the old "how to
configure your kernel" document is hopelessly out of date and doesn't
cover new config.
As a result, naive users have serious trouble trying to figure out how
to build themselves new kernels, except by trial and error. Usually
they figure this out pretty quickly, but it isn't the right way to go,
and makes us much less friendly than other systems.
Note that this is *different* from the problem of the fact that how
config(8) and autoconfiguration work are not documented. The users
don't need to know about *how* this works, only what the syntax means.
>How-To-Repeat:
"man config(8)"
>Fix:
Someone has to write real documentation on this, possibly
adding it to config(8).
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed
State-Changed-By: fair
State-Changed-When: Wed Apr 7 03:52:12 PDT 1999
State-Changed-Why:
This PR duplicates PR 5571.
>Unformatted:
(Contact us)
$NetBSD: query-full-pr,v 1.51 2026/08/10 02:28:17 riastradh Exp $
$NetBSD: gnats_config.sh,v 1.10 2026/05/13 22:00:09 riastradh Exp $
Copyright © 1994-2026
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.