summaryrefslogtreecommitdiffstats
path: root/share
diff options
context:
space:
mode:
authorjoerg <joerg@FreeBSD.org>1996-03-31 18:01:55 +0000
committerjoerg <joerg@FreeBSD.org>1996-03-31 18:01:55 +0000
commit1368a0302adfc80686c6840a63848a3312751fda (patch)
tree18210c6dd9db7dcc885479075feb10295fbd7b1a /share
parent61c0414a60385ff3a1ca439741769568391da4c7 (diff)
downloadFreeBSD-src-1368a0302adfc80686c6840a63848a3312751fda.zip
FreeBSD-src-1368a0302adfc80686c6840a63848a3312751fda.tar.gz
Update the information about kernel options. Mention the ``new option
scheme''. Closes PR # docs/1110.
Diffstat (limited to 'share')
-rw-r--r--share/doc/handbook/dialup.sgml6
-rw-r--r--share/doc/handbook/kernelconfig.sgml19
2 files changed, 22 insertions, 3 deletions
diff --git a/share/doc/handbook/dialup.sgml b/share/doc/handbook/dialup.sgml
index 3c4bf34..3fa873c 100644
--- a/share/doc/handbook/dialup.sgml
+++ b/share/doc/handbook/dialup.sgml
@@ -1,6 +1,6 @@
<!-- This is an SGML document in the linuxdoc DTD of the Tutorial for
Configuring a FreeBSD for Dialup Services by Guy Helmer.
- $Id: dialup.sgml,v 1.5 1996/01/31 14:26:02 mpp Exp $
+ $Id: dialup.sgml,v 1.6 1996/03/26 21:33:09 joerg Exp $
<!DOCTYPE linuxdoc PUBLIC "-//Linux//DTD linuxdoc//EN">
@@ -234,7 +234,9 @@ probably need to configure a custom FreeBSD kernel for your system.
Please see the BSD System Manager's Manual chapter on ``Building
Berkeley Kernels with Config'' &lsqb;the source for which is in
<tt>/usr/src/share/doc/smm</tt>&rsqb; and ``FreeBSD Configuration
-Options'' &lsqb;in <tt>/sys/doc/options.doc</tt>&rsqb; for more
+Options'' &lsqb;in <tt>/sys/conf/options</tt> and in
+<tt>/sys/<em>arch</em>/conf/options.<em>arch</em></tt>, with
+<em>arch</em> for example being <tt>i386</tt>&rsqb; for more
information on configuring and building kernels. You may have to
unpack the kernel source distribution if haven't installed the system
sources already (<tt>srcdist/srcsys.??</tt> in FreeBSD 1.1,
diff --git a/share/doc/handbook/kernelconfig.sgml b/share/doc/handbook/kernelconfig.sgml
index 86fda45..3206f7d 100644
--- a/share/doc/handbook/kernelconfig.sgml
+++ b/share/doc/handbook/kernelconfig.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: kernelconfig.sgml,v 1.7 1996/01/20 06:28:11 nate Exp $ -->
+<!-- $Id: kernelconfig.sgml,v 1.8 1996/01/31 14:26:10 mpp Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!-- <!DOCTYPE linuxdoc PUBLIC '-//FreeBSD//DTD linuxdoc//EN'> -->
<chapt><heading>Configuring the FreeBSD Kernel<label id="kernelconfig"></heading>
@@ -149,6 +149,23 @@
located in the same directory as GENERIC. If you are in doubt as to
the purpose or necessity of a line, check first in LINT.
+ <p>The kernel is currently being moved to a better organization
+ of the option handling. Traditionally, each option in the
+ config file was simply converted into a <tt>-D</tt> switch
+ for the <tt>CFLAGS</tt> line of the kernel Makefile. Naturally,
+ this caused a creaping optionism, with nobody really knowing
+ which option has been referenced in what files.
+
+ <p>In the new scheme, every <tt>#ifdef</tt> that is intended to
+ be dependant upon an option gets this option out of an
+ <tt>opt_<em>foo</em>.h</tt> declaration file created in the
+ compile directory by <tt>config</tt>. The list of valid options
+ for <tt>config</tt> lives in two files: options that don't
+ depend on the architecture are listed in
+ <tt>/sys/conf/options</tt>, architecture-dependant ones
+ in <tt>/sys/<em>arch</em>/conf/options.<em>arch</em></tt>,
+ with <em>arch</em> being for example <tt>i386</tt>.
+
<sect1><heading>Mandatory Keywords</heading>
<p>These keywords are required in every kernel you build.
OpenPOWER on IntegriCloud