install correct aliases file

[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 d0b0801..228a082 100644 (file)
--- a/usr/src/usr.sbin/config/config.8
+++ b/usr/src/usr.sbin/config/config.8
@@ -1,8 +1,19 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)config.8    6.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.\"    @(#)config.8    6.3 (Berkeley) %G%

 .\"
 .TH CONFIG 8 ""
 .UC 4
 .\"
 .TH CONFIG 8 ""
 .UC 4


@@ -13,7 +24,7 @@ config \- build system configuration files
 [
 .B \-p
 ]
 [
 .B \-p
 ]

-.I config_file
+.I SYSTEM_NAME

 .SH DESCRIPTION
 .PP
 .I Config
 .SH DESCRIPTION
 .PP
 .I Config


@@ -30,57 +41,65 @@ If the
 option is supplied, 
 .I config
 will configure a system for profiling; c.f.
 option is supplied, 
 .I config
 will configure a system for profiling; c.f.

-.IR kgmon (8),
+.IR kgmon (8)
+and

 .IR gprof (1).
 .PP
 .I Config
 should be run from the
 .B conf
 subdirectory of the system source (usually /sys/conf).
 .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
+containing device specifications, configuration options
+and other system parameters for one system configuration.

 .I Config
 assumes that there is already a directory
 .I Config
 assumes that there is already a directory

-.I "../config_file"
+.I "../SYSTEM_NAME"

 created and it places all its output files in there.  
 The output of
 .I config
 created and it places all its output files in there.  
 The output of
 .I config

-consists of a number files:
+consists of a number of files; for the VAX, they are:

 .B ioconf.c
 contains a description
 .B ioconf.c
 contains a description

-of what i/o devices are attached to the system,;
+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 ubglue.s
 contains a set of interrupt service routines for devices
 attached to the UNIBUS;

-.B makefile
+.B ubvec.s
+contains offsets into a structure used for counting per-device interrupts;
+.B Makefile

 is a file used by
 .IR make (1)
 is a file used by
 .IR make (1)

-in building the system; a set of header files which contain
+in building the system; a set of header files contain 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 which contain definitions for
+and a set of swap configuration files contain definitions for

 the disk areas to be used for swapping, the root file system,
 argument processing, and system dumps.
 .PP
 After running
 .IR config ,
 the disk areas to be used for swapping, the root file system,
 argument processing, and system dumps.
 .PP
 After running
 .IR config ,

-it is necessary to run "make depend" in the directory where the new makefile
+it is necessary to run ``make depend'' in the directory where the new makefile

 was created.
 .I Config
 was created.
 .I Config

-reminds you of this when it completes.
+prints a reminder of this when it completes.

 .PP
 .PP

-If you get any other error messages from
+If any other error messages are produced by

 .I config,
 .I config,

-you should fix the problems in your configuration file and try again.
-If you try to compile a system that had configuration errors, you
-will likely meet with failure.
+the problems in the configuration file should be corrected and
+.I config
+should be run again.
+Attempts to compile a system that had configuration errors
+are likely to meet with failure.

 .SH FILES
 .nf
 .SH FILES
 .nf

-/sys/conf/makefile.vax generic makefile for the VAX
+/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
 /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.2BSD UNIX System with Config''
+``Building 4.3BSD UNIX System with Config''

 .br
 The SYNOPSIS portion of each device in section 4.
 .SH BUGS
 .br
 The SYNOPSIS portion of each device in section 4.
 .SH BUGS