Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/etc Tidy up comments a bit, to make the manpages generated f...
details: https://anonhg.NetBSD.org/src/rev/09d110e25db5
branches: trunk
changeset: 476497:09d110e25db5
user: hubertf <hubertf%NetBSD.org@localhost>
date: Sat Sep 18 00:23:35 1999 +0000
description:
Tidy up comments a bit, to make the manpages generated from the a bit
nicer. Also, add a comment on how to re-generate the manpages if the
MAKEDEV file was changed.
diffstat:
etc/etc.alpha/MAKEDEV | 43 +++++++++++++++++++++++++++----------------
etc/etc.amiga/MAKEDEV | 23 +++++++++++++++--------
etc/etc.arm32/MAKEDEV | 18 ++++++++++++------
etc/etc.atari/MAKEDEV | 13 ++++++++++---
etc/etc.bebox/MAKEDEV | 9 ++++++++-
etc/etc.hp300/MAKEDEV | 15 ++++++++++-----
etc/etc.hpcmips/MAKEDEV | 9 ++++++++-
etc/etc.i386/MAKEDEV | 24 +++++++++++++++---------
etc/etc.mac68k/MAKEDEV | 11 +++++++++--
etc/etc.macppc/MAKEDEV | 9 ++++++++-
etc/etc.mvme68k/MAKEDEV | 15 ++++++++++-----
etc/etc.newsmips/MAKEDEV | 9 ++++++++-
etc/etc.next68k/MAKEDEV | 9 ++++++++-
etc/etc.pc532/MAKEDEV | 11 +++++++++--
etc/etc.pmax/MAKEDEV | 18 ++++++++++++++----
etc/etc.sparc/MAKEDEV | 33 +++++++++++++++++++--------------
etc/etc.sparc64/MAKEDEV | 33 +++++++++++++++++++--------------
etc/etc.sun3/MAKEDEV | 19 ++++++++++++-------
etc/etc.vax/MAKEDEV | 11 +++++++++--
etc/etc.x68k/MAKEDEV | 15 +++++++++++----
20 files changed, 241 insertions(+), 106 deletions(-)
diffs (truncated from 885 to 300 lines):
diff -r b594799cd9b6 -r 09d110e25db5 etc/etc.alpha/MAKEDEV
--- a/etc/etc.alpha/MAKEDEV Sat Sep 18 00:20:16 1999 +0000
+++ b/etc/etc.alpha/MAKEDEV Sat Sep 18 00:23:35 1999 +0000
@@ -1,5 +1,5 @@
#!/bin/sh -
-# $NetBSD: MAKEDEV,v 1.48 1999/08/27 14:13:32 augustss Exp $
+# $NetBSD: MAKEDEV,v 1.49 1999/09/18 00:23:35 hubertf Exp $
#
# Copyright (c) 1990 The Regents of the University of California.
# All rights reserved.
@@ -32,13 +32,24 @@
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
+###########################################################################
+#
+# PLEASE RUN "cd ../share/man/man8 ; perl5 MAKEDEV2manpage.pl"
+# AFTER CHANGING THIS FILE, AND COMMIT THE UPDATED MANPAGE!
+#
+###########################################################################
+#
# Device "make" file. Valid arguments:
-# all makes all known devices, including local devices.
-# Tries to make the 'standard' number of each type.
+# all Makes all known devices, including local devices.
+# If units are expected for a device MAKEDEV supplies the
+# standard numbers.
# minimal A minimal set of devices for install disks, etc.
-# std standard devices
-# local configuration specific devices
-# usbs make USB devices
+# std The standard devices (console, drum, klog, kmem, mem,
+# null, stderr, stdin, stdout, tty, zero).
+# local Configuration specific devices which are created by running
+# the MAKEDEV.local shell script with the argument "all".
+# usbs All USB devices. If units are expected for a device
+# MAKEDEV supplies the standard numbers.
#
# Tapes:
# st* SCSI tape
@@ -46,12 +57,12 @@
# Disks:
# ccd* concatenated disk driver
# cd* SCSI CD-ROM
-# md* "memory disk" pseudo-disks
+# md* memory pseudo-disks
# raid* RAIDframe disk driver
-# sd* SCSI disks
-# vnd* "file" pseudo-disks
+# sd* ATAPI and SCSI disks
+# vnd* file pseudo-disks
# wd* IDE disks
-# fd* PC-ish floppy disks
+# fd* PC-style floppy disks
#
# Terminals:
# ttyB? DEC 3000 ZS8530 ("scc") serial ports
@@ -62,28 +73,28 @@
# pty* set of 16 master and slave pseudo terminals
#
# Printers:
-# lpt* stock lp
-# lpa* interruptless lp
+# lpt* PC parallel port driver ("lpt") units
+# lpa* polled PC parallel port driver ("lpt") units
#
# USB devices:
# usb* Bus control devices used by usbd for attach/detach
# uhid* Generic HID devices
# ulpt* Printer devices
-# ugen* Generic device
+# ugen* Generic devices
# ttyU* Modem
#
# Special purpose devices:
# audio* audio devices
-# bpf* packet filter
+# bpf* Berkeley packet filter devices
# ch* SCSI media changer
-# fd file descriptors
+# fd file descriptors (/dev/fd/*)
# ipl IP filter
# kbd keyboard (provides events, for X11)
# lkm loadable kernel modules interface
# mouse mouse (provides events, for X11)
# random Random number generator
# satlink* PlanetConnect satellite receiver driver
-# scsibus* SCSI busses
+# scsibus* SCSI busses, see scsictl(8), scsi(8)
# speaker PC speaker (IBM BASIC playstring emulation)
# ss* SCSI scanner
# tun* network tunnel driver
diff -r b594799cd9b6 -r 09d110e25db5 etc/etc.amiga/MAKEDEV
--- a/etc/etc.amiga/MAKEDEV Sat Sep 18 00:20:16 1999 +0000
+++ b/etc/etc.amiga/MAKEDEV Sat Sep 18 00:23:35 1999 +0000
@@ -1,6 +1,6 @@
#!/bin/sh -
#
-# $NetBSD: MAKEDEV,v 1.49 1999/09/15 20:31:53 is Exp $
+# $NetBSD: MAKEDEV,v 1.50 1999/09/18 00:23:35 hubertf Exp $
#
# Copyright (c) 1990 The Regents of the University of California.
# All rights reserved.
@@ -37,8 +37,15 @@
# hp300/MAKEDEV (1/15/94), from:
# @(#)MAKEDEV 5.5 (Berkeley) 5/28/91
#
+###########################################################################
+#
+# PLEASE RUN "cd ../share/man/man8 ; perl5 MAKEDEV2manpage.pl"
+# AFTER CHANGING THIS FILE, AND COMMIT THE UPDATED MANPAGE!
+#
+###########################################################################
+#
# Device "make" file. Valid arguments:
-# all makes all known devices, including local devices,
+# all makes all known devices, including local devices.
# Tries to make the ``standard'' number of each.
# fd makes fd/* for the fdescfs.
# floppy devices needed for install floppies
@@ -63,7 +70,7 @@
# mouse* Amiga mice
#
# Terminal ports:
-# tty00 standard serial port.
+# tty00 standard serial port
# ttyA* mfc serial ports
# ttyB* msc serial ports
# ttyC* com style serial ports (DraCo, HyperCom)
@@ -83,18 +90,18 @@
# CyberVision 64 (grf5), ET4000 boards (grf6)
# or CyberVision 64/3D (grf7).
# kbd Amiga keyboard
-# view* generic interface to graphic displays.
-# lkm loadable kernel modules interface.
-# ipl ip filter
+# view* generic interface to graphic displays
+# lkm loadable kernel modules interface
+# ipl IP filter
# random Random number generator
# bpf* Berkeley Packet Filter
# tun* network tunnel driver
-# scsibus* SCSI busses
+# scsibus* SCSI busses, see scsictl(8), scsi(4)
# ss* SCSI scanner
# uk* SCSI unknown
# ch* SCSI changer
# audio* one unit of the audio device. On Amiga machines,
-# Unit 0 is custom chip audio, if configured.
+# Unit 0 is custom chip audio, if configured
#
# for new-style serial interfaces:
diff -r b594799cd9b6 -r 09d110e25db5 etc/etc.arm32/MAKEDEV
--- a/etc/etc.arm32/MAKEDEV Sat Sep 18 00:20:16 1999 +0000
+++ b/etc/etc.arm32/MAKEDEV Sat Sep 18 00:23:35 1999 +0000
@@ -1,6 +1,6 @@
#!/bin/sh -
#
-# $NetBSD: MAKEDEV,v 1.40 1999/08/27 14:13:33 augustss Exp $
+# $NetBSD: MAKEDEV,v 1.41 1999/09/18 00:23:36 hubertf Exp $
#
# Copyright (c) 1990 The Regents of the University of California.
# All rights reserved.
@@ -24,12 +24,20 @@
#
# @(#)MAKEDEV 5.2 (Berkeley) 6/22/90
#
+###########################################################################
+#
+# PLEASE RUN "cd ../share/man/man8 ; perl5 MAKEDEV2manpage.pl"
+# AFTER CHANGING THIS FILE, AND COMMIT THE UPDATED MANPAGE!
+#
+###########################################################################
+#
# Device "make" file. Valid arguments:
# all makes all known devices, including local devices.
# Tries to make the 'standard' number of each type.
# floppy devices to be put on install floppies
# std standard devices
-# local configuration specific devices
+# local configuration specific devices which are created by running
+# the MAKEDEV.local shell script with the argument "all".
#
# Tapes:
# st* SCSI tapes
@@ -78,8 +86,6 @@
# ugen* Generic device
# ttyU* Modem
#
-# Call units:
-#
# Special purpose devices:
# md memory disk
# kbd raw keyboard
@@ -87,13 +93,13 @@
# fd file descriptors
# bpf* packet filter
# beep riscpc speaker
-# ipl ip filter control
+# ipl IP filter control
# random Random number generator
# lkm loadable kernel modules interface
# tun* network tunnel driver
# ch* SCSI Auto changer
# uk* SCSI Unknown device
-# scsibus* SCSI busses
+# scsibus* SCSI busses, see scsi(4), scsictl(8)
# ss* SCSI scanner device
# iic* IIC bus device
# rtc* RTC device
diff -r b594799cd9b6 -r 09d110e25db5 etc/etc.atari/MAKEDEV
--- a/etc/etc.atari/MAKEDEV Sat Sep 18 00:20:16 1999 +0000
+++ b/etc/etc.atari/MAKEDEV Sat Sep 18 00:23:35 1999 +0000
@@ -1,6 +1,6 @@
#!/bin/sh -
#
-# $NetBSD: MAKEDEV,v 1.34 1999/04/30 19:05:47 leo Exp $
+# $NetBSD: MAKEDEV,v 1.35 1999/09/18 00:23:36 hubertf Exp $
#
# Copyright (c) 1990 The Regents of the University of California.
# All rights reserved.
@@ -37,6 +37,13 @@
# hp300/MAKEDEV (1/15/94), from:
# @(#)MAKEDEV 5.5 (Berkeley) 5/28/91
#
+###########################################################################
+#
+# PLEASE RUN "cd ../share/man/man8 ; perl5 MAKEDEV2manpage.pl"
+# AFTER CHANGING THIS FILE, AND COMMIT THE UPDATED MANPAGE!
+#
+###########################################################################
+#
# Device "make" file. Valid arguments:
# all makes all known devices, including local devices,
# Tries to make the ``standard'' number of each.
@@ -80,10 +87,10 @@
# kbd Atari keyboard.
# view* generic interface to graphic displays.
# aconf autoconfig information (not yet)
-# lkm loadable kernel modules interface.
+# lkm loadable kernel modules interface
# bpf* Berkeley Packet Filter
# tun* network tunnel driver
-# scsibus* SCSI busses
+# scsibus* SCSI busses, see scsictl(8), scsi(4)
# ss* SCSI scanner
# uk* SCSI unknown
# ch SCSI changer
diff -r b594799cd9b6 -r 09d110e25db5 etc/etc.bebox/MAKEDEV
--- a/etc/etc.bebox/MAKEDEV Sat Sep 18 00:20:16 1999 +0000
+++ b/etc/etc.bebox/MAKEDEV Sat Sep 18 00:23:35 1999 +0000
@@ -1,6 +1,6 @@
#!/bin/sh -
#
-# $NetBSD: MAKEDEV,v 1.5 1999/08/25 23:06:47 augustss Exp $
+# $NetBSD: MAKEDEV,v 1.6 1999/09/18 00:23:36 hubertf Exp $
#
# Copyright (c) 1990 The Regents of the University of California.
# All rights reserved.
@@ -23,6 +23,13 @@
#
# @(#)MAKEDEV 5.2 (Berkeley) 6/22/90
#
+###########################################################################
+#
+# PLEASE RUN "cd ../share/man/man8 ; perl5 MAKEDEV2manpage.pl"
+# AFTER CHANGING THIS FILE, AND COMMIT THE UPDATED MANPAGE!
+#
+###########################################################################
+#
# Device "make" file. Valid arguments:
# all makes all known devices, including local devices.
# Tries to make the 'standard' number of each type.
diff -r b594799cd9b6 -r 09d110e25db5 etc/etc.hp300/MAKEDEV
--- a/etc/etc.hp300/MAKEDEV Sat Sep 18 00:20:16 1999 +0000
+++ b/etc/etc.hp300/MAKEDEV Sat Sep 18 00:23:35 1999 +0000
@@ -1,6 +1,6 @@
#!/bin/sh -
#
-# $NetBSD: MAKEDEV,v 1.27 1999/01/16 01:40:28 abs Exp $
+# $NetBSD: MAKEDEV,v 1.28 1999/09/18 00:23:36 hubertf Exp $
#
# Copyright (c) 1990 The Regents of the University of California.
# All rights reserved.
@@ -35,6 +35,13 @@
#
# @(#)MAKEDEV 5.5 (Berkeley) 5/28/91
#
+###########################################################################
+#
+# PLEASE RUN "cd ../share/man/man8 ; perl5 MAKEDEV2manpage.pl"
+# AFTER CHANGING THIS FILE, AND COMMIT THE UPDATED MANPAGE!
+#
+###########################################################################
+#
# Device "make" file. Valid arguments:
# std standard devices
# local configuration specific devices
@@ -54,8 +61,6 @@
Home |
Main Index |
Thread Index |
Old Index