Cleanup of the intro(4) manpages, suggested by ericj@

Among other things:
- keep phrasing consistent across arches
- put "see also" and "history" sections at the end
- add history sections to i386 which lacks it
- name gdt and ubsec on i386 (.It nothing is bad)
- try to improve the nice look of the supported device list.
- remove "unsupported device" section (sparc only) and "supported systems"
  which is largealy out of date for, say, alpha, and completely off topic.
- correct /usr/adm/messages reference left in hp300 (gasp)
- provide intro(4) for sparc64.

Left to do:
- update supported device listings (even, create one for alpha).
- sprinkle .Tn macros where needed.

I wouldn't mind some help on this.

1 files changed, 93 insertions, 0 deletions

diff --git a/share/man/man4/man4.sparc64/intro.4 b/share/man/man4/man4.sparc64/intro.4
new file mode 100644
index 00000000000..5b31b916496
--- /dev/null
+++ b/share/man/man4/man4.sparc64/intro.4
@@ -0,0 +1,93 @@
+.\"     $OpenBSD: intro.4,v 1.1 2001/10/04 22:03:46 miod Exp $
+.\"
+.\" Copyright (c) 2001 The OpenBSD Project
+.\" All Rights Reserved.
+.\"
+.Dd October 4, 2001
+.Dt INTRO 4 sparc64
+.Os
+.Sh NAME
+.Nm intro
+.Nd introduction to special files and hardware support
+.Sh DESCRIPTION
+The manual pages in section 4 describe the special files, 
+related driver functions, and networking support
+available in the system.
+In this part of the manual, the
+.Tn SYNOPSIS
+section of
+each configurable device gives a sample specification
+for use in constructing a system description for the
+.Xr config 8
+program.
+The
+.Tn DIAGNOSTICS
+section lists messages which may appear on the console
+and/or in the system error log
+.Pa /var/log/messages
+due to errors in device operation;
+see
+.Xr syslogd 8
+for more information.
+.Pp
+This section contains both devices
+which may be configured into the system
+and network related information.
+The networking support is introduced in
+.Xr netintro 4 .
+.Sh DEVICE SUPPORT
+This section describes the hardware supported on the
+sparc64
+platform.
+Software support for these devices comes in two forms.  A hardware
+device may be supported with a character or block
+.Em device driver ,
+or it may be used within the networking subsystem and have a
+.Em network interface driver .
+Block and character devices are accessed through files in the file
+system of a special type; see
+.Xr mknod 8 .
+Network interfaces are indirectly accessed through the interprocess
+communication facilities provided by the system; see
+.Xr socket 2 .
+.Pp
+A hardware device is identified to the system at configuration time
+and the appropriate device or network interface driver is then compiled
+into the system.  When the resultant system is booted, the
+autoconfiguration facilities in the system probe for the device
+and, if found, enable the software support for it.
+If a device does not respond at autoconfiguration
+time it is not accessible at any time afterwards.
+To enable a device which did not autoconfigure,
+the system will have to be rebooted.
+.Pp
+The autoconfiguration system is described in
+.Xr autoconf 4 .
+A list of the supported devices is given below.
+.Sh LIST OF DEVICES
+The devices listed below are supported in this incarnation of
+the system.  Pseudo-devices are not listed.
+Devices are indicated by their functional interface.
+Not all supported devices are listed.
+.Pp
+.Bl -tag -width le/lebuffer -compact -offset indent
+.It audiocs
+CS4231 based audio.
+.It esp
+ESP SCSI controller.
+.It hme
+SBus HME Ethernet controllers (SunSwift).
+.It le/lebuffer
+AMD 7990 LANCE ethernet controller.
+.It openprom
+Sun Open boot PROM (what became IEEE 1275) configuration driver.
+.El
+.Sh SEE ALSO
+.Xr autoconf 4 ,
+.Xr config 8
+.Sh HISTORY
+The
+sparc64
+.Nm intro
+first appeared in
+.Ox 3.0 .