macro and text revision (-mdoc version 3)

[unix-history] / usr / src / usr.sbin / config / config.8

diff --git a/usr/src/usr.sbin/config/config.8 b/usr/src/usr.sbin/config/config.8
index e82715a..d3131ed 100644 (file)
--- a/usr/src/usr.sbin/config/config.8
+++ b/usr/src/usr.sbin/config/config.8
@@ -1,96 +1,134 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1991 The Regents of the University of California.

 .\" All rights reserved.
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\" All rights reserved.
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"    @(#)config.8    6.4 (Berkeley) %G%
+.\"     @(#)config.8   6.5 (Berkeley) %G%

 .\"
 .\"

-.TH CONFIG 8 ""
-.UC 4
-.SH NAME
-config \- build system configuration files
-.SH SYNOPSIS
-.B config
-[
-.B \-p
-]
-.I SYSTEM_NAME
-.SH DESCRIPTION
-.PP
-.I Config
-builds a set of system configuration files from a short file which describes
-the sort of system that is being configured.  It also takes as input a file
-which tells
-.I config
-what files are needed to generate a system.
-This can be augmented by a configuration specific set of files
+.Dd 
+.Dt CONFIG 8
+.Os BSD 4
+.Sh NAME
+.Nm config
+.Nd build system configuration files
+.Sh SYNOPSIS
+.Nm config
+.Op Fl p
+.Ar SYSTEM_NAME
+.Sh DESCRIPTION
+.Pp
+.Nm Config
+builds a set of system configuration files from the file
+.Ar SYSTEM_NAME
+which describes
+the system to configure.
+A second file
+tells
+.Nm config
+what files are needed to generate a system and
+can be augmented by configuration specific set of files

 that give alternate files for a specific machine.
 that give alternate files for a specific machine.

-(see the FILES section below)
+(see the
+.Sx FILES
+section below)
+.Pp
+Available option and operand:
+.Pp
+.Bl -tag -width SYSTEM_NAME
+.It Fl p

 If the
 If the

-.B \-p
+.Fl p

 option is supplied, 
 option is supplied, 

-.I config
-will configure a system for profiling; c.f.
-.IR kgmon (8)
+.Nm config
+will configure a system for profiling; for example,
+.Xr kgmon 8

 and
 and

-.IR gprof (1).
-.PP
-.I Config
-should be run from the
-.B conf
-subdirectory of the system source (usually /sys/conf).
-Its argument is the name of a system configuration file
+.Xr gprof 1 .
+.It Ar SYSTEM_NAME
+specifies the name of the system configuration file

 containing device specifications, configuration options
 and other system parameters for one system configuration.
 containing device specifications, configuration options
 and other system parameters for one system configuration.

-.I Config
-assumes that there is already a directory
-.I "../SYSTEM_NAME"
-created and it places all its output files in there.  
+.El
+.Pp
+.Nm Config
+should be run from the
+.Pa conf
+subdirectory of the system source (usually
+.Pa /sys/conf ) .
+.Nm Config
+assumes the directory
+.Pa ../SYSTEM_NAME
+exists and places all output files there.  

 The output of
 The output of

-.I config
-consists of a number of files; for the VAX, they are:
-.B ioconf.c
-contains a description
-of what I/O devices are attached to the system,;
-.B ubglue.s
-contains a set of interrupt service routines for devices
-attached to the UNIBUS;
-.B ubvec.s
-contains offsets into a structure used for counting per-device interrupts;
-.B Makefile
-is a file used by
-.IR make (1)
-in building the system; a set of header files contain definitions of
+.Nm config
+consists of a number of files; for the
+.Tn VAX ,
+they are:
+.Pa ioconf.c ,
+a description
+of what I/O devices are attached to the system;
+.Pa ubglue.s ,
+a set of interrupt service routines for devices
+attached to the
+.Tn UNIBUS ;
+.Pa ubvec.s ,
+offsets into a structure used for counting per-device interrupts;
+.Pa Makefile ,
+used by
+.Xr make 1
+in building the system;
+header files,
+definitions of

 the number of various devices that will be compiled into the system;
 the number of various devices that will be compiled into the system;

-and a set of swap configuration files contain definitions for
+swap configuration files,
+definitions for

 the disk areas to be used for swapping, the root file system,
 argument processing, and system dumps.
 the disk areas to be used for swapping, the root file system,
 argument processing, and system dumps.

-.PP
+.Pp

 After running
 After running

-.IR config ,
-it is necessary to run ``make depend'' in the directory where the new makefile
+.Nm config ,
+it is necessary to run
+.Dq Li make depend
+in the directory where the new makefile

 was created.
 was created.

-.I Config
+.Nm Config

 prints a reminder of this when it completes.
 prints a reminder of this when it completes.

-.PP
+.Pp

 If any other error messages are produced by
 If any other error messages are produced by

-.I config,
+.Nm config ,

 the problems in the configuration file should be corrected and
 the problems in the configuration file should be corrected and

-.I config
+.Nm config

 should be run again.
 Attempts to compile a system that had configuration errors
 should be run again.
 Attempts to compile a system that had configuration errors

-are likely to meet with failure.
-.SH FILES
-.nf
-/sys/conf/Makefile.vax generic makefile for the VAX
-/sys/conf/files        list of common files system is built from
-/sys/conf/files.vax    list of VAX specific files
-/sys/conf/devices.vax  name to major device mapping file for the VAX
-/sys/conf/files.ERNIE  list of files specific to ERNIE system
-.fi
-.SH SEE ALSO
-``Building 4.3BSD UNIX System with Config''
-.br
+are likely to fail.
+.Sh FILES
+.Bl -tag -width /sys/conf/Makefile.vax -compact
+.It Pa /sys/conf/Makefile.vax
+generic makefile for the
+.Tn VAX
+.It Pa /sys/conf/files
+list of common files system is built from
+.It Pa /sys/conf/files.vax
+list of
+.Tn VAX
+specific files
+.It Pa /sys/conf/devices.vax
+name to major device mapping file for the
+.Tn VAX
+.It Pa /sys/conf/files. Ns Em ERNIE
+list of files specific to
+.Em ERNIE
+system
+.El
+.Sh SEE ALSO

 The SYNOPSIS portion of each device in section 4.
 The SYNOPSIS portion of each device in section 4.

-.SH BUGS
+.Rs
+.%T "Building 4.3 BSD UNIX System with Config"
+.Re
+.Sh BUGS

 The line numbers reported in error messages are usually off by one.
 The line numbers reported in error messages are usually off by one.

+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.1 .