First pass at a whacking.

6 files changed, 59 insertions, 55 deletions

diff --git a/distrib/notes/cats/contents b/distrib/notes/cats/contents
index 88e03be95d3..d48cd01da44 100644
--- a/distrib/notes/cats/contents
+++ b/distrib/notes/cats/contents
@@ -1,41 +1,24 @@
-dnl	$OpenBSD: contents,v 1.1 2004/02/08 00:35:14 drahn Exp $
+dnl	$OpenBSD: contents,v 1.2 2004/02/08 23:12:14 miod Exp $
 TopPart
 
-OpenBSDfloppy
-
-		cdrom{:--:}OSrev.fs	The MACHINE boot and installation
-				image that contains almost all
-				OpenBSD drivers; see below.
-
 OpenBSDdistsets
 
 OpenBSDbsd
 
 OpenBSDrd
+dnl not yet...
+dnl OpenBSDcd
 
-OpenBSDcd
-
-As well you may be interested in
-
-.../OSREV/tools/
-		miscellaneous MACHINE installation utilities like
-		rawrite.exe, ntrw.exe, gzip.exe, and pfdisk.exe;
-		see installation section, below.
-
-
-In addition, the "tools/" directory contains some utilities that might be
-useful for the installation.
-
-DistributionDescription(ten)
+DistributionDescription(six)
 
-OpenBSDbase(31.0,90.9,shared)
+OpenBSDbase
 
-OpenBSDcomp(17.4,57.6,shared)
+OpenBSDcomp
 
-OpenBSDetc(1.6,6.0)
+OpenBSDetc(,,noupgrade)
 
-OpenBSDgame(2.6,6.0)
+OpenBSDgame
 
-OpenBSDman(6.3,22.4)
+OpenBSDman
 
-OpenBSDmisc(2.0,6.5)
+OpenBSDmisc
diff --git a/distrib/notes/cats/install b/distrib/notes/cats/install
index bd733c2f7ea..1b8b0424582 100644
--- a/distrib/notes/cats/install
+++ b/distrib/notes/cats/install
@@ -1,25 +1,18 @@
-dnl	$OpenBSD: install,v 1.1 2004/02/08 00:35:14 drahn Exp $
+dnl	$OpenBSD: install,v 1.2 2004/02/08 23:12:14 miod Exp $
 OpenBSDInstallPrelude
 
-If OpenBSD will be sharing the disk with DOS or another operating
-system, you should have already completed the section of these notes
-that instructed you on how to prepare your hard disk.  You should know
-the size of the OpenBSD area of the disk and its offset from the
-beginning of the disk.  You will need this information when setting up
-your OpenBSD partitions. 
+There are several ways to install OpenBSD onto a disk.  The easiest way
+is to burn bsd.rd on a CD-ROM, and boot off it. However, the ABLE firmware
+is versatile and will boot from a variety of devices and filesystems.
 
-There are several ways to install OpenBSD onto a disk.  The easiest way,
-should your computer support it, is to boot off the OpenBSD CD-ROM, or
-off the bootable CD-ROM mini image.
+Booting from CD-ROM installation media:
 
-OpenBSDInstallPart2
-
-	XXX 
-	Booting with ABLE
+At the ABLE firmware prompt, enter :
+    boot (cd0)bsd.rd
+to boot from the first detected cd-rom drive.
 
-	XXXX
-	Cyclone firmware not supported.
 
+OpenBSDInstallPart2
 
 OpenBSDBootMsgs
 
@@ -42,7 +35,7 @@ OpenBSDInstallPart3({:- or "wd0" for IDE drives-:})
 	correct this.  Note that you should make OpenBSD be the active
 	partition at least until the install has been completed.
 
-OpenBSDInstallPart4({:- If you have DOS or Linux partitions
+OpenBSDInstallPart4({:- If you have Linux partitions
 	defined on the disk, these will usually show up as partition
 	'h', 'i' and so on.-:})
 
diff --git a/distrib/notes/cats/prep b/distrib/notes/cats/prep
index fd778ad089e..2d501520f18 100644
--- a/distrib/notes/cats/prep
+++ b/distrib/notes/cats/prep
@@ -1,19 +1,41 @@
-dnl	$OpenBSD: prep,v 1.1 2004/02/08 00:35:14 drahn Exp $
+dnl	$OpenBSD: prep,v 1.2 2004/02/08 23:12:14 miod Exp $
 To be able to boot the OpenBSD/MACHINE installation program, you will
 need to acquire some limited knowledge of ABLE Firmware, the low-level
 process that controls the microprocessor after hardware initialization
 and diagnostics are performed but before control is handed to the
 operating system.
 
-Important ABLE Firmware command examples:
+A complete documentation on the ABLE firmware is available from Simtec at
+the following URL:
+  http://www.simtec.co.uk/products/SWABLE/files/able-doc-allset/
+
+For convenience, a few ABLE commands are described below:
 
 boot (hd0)bsd
-	boot the ELF file 'bsd' from the disk partition idenfied
+	boot the ELF file 'bsd' from the disk partition identified
 	by firmware as hd0.
 
+nvset variable value
+	sets a firmware environment variable.
+
+nvsave
+	saves all variable changes to non-volatile memory.
+
+nvclear
+	restores environment variables defaults.
 
-XXX autoboot 
+The following environment variables control the system startup:
 
-XXX arguments to kernel
+boot.auto
+	when set to "true" (which is its default value), the system will
+	attempt to execute the command set in the "boot.cmd" variable
+	after "boot.timeout" seconds.
+boot.cmd
+	command used to auto-boot, such as "boot (hd0)bsd" to boot the
+	bsd kernel from the first hard disk drive.
+boot.timeout
+	delay until the system boots, in seconds
 
-XXX bootable partitions
+dnl XXX arguments to kernel
+dnl
+dnl XXX bootable partitions
diff --git a/distrib/notes/cats/upgrade b/distrib/notes/cats/upgrade
index 9ffd4971744..76db79a926b 100644
--- a/distrib/notes/cats/upgrade
+++ b/distrib/notes/cats/upgrade
@@ -1 +1,4 @@
-OpenBSDUpgrade({:-the CD-ROM-:})
+dnl	$OpenBSD: upgrade,v 1.2 2004/02/08 23:12:14 miod Exp $
+Since OpenBSD/OSREV is the first MACHINE release, there is no upgrade
+functionnality.
+dnl OpenBSDUpgrade({:-the CD-ROM-:})
diff --git a/distrib/notes/cats/whatis b/distrib/notes/cats/whatis
index ede7e06faa9..083649745f0 100644
--- a/distrib/notes/cats/whatis
+++ b/distrib/notes/cats/whatis
@@ -1,2 +1,3 @@
-dnl	$OpenBSD: whatis,v 1.1 2004/02/08 00:35:14 drahn Exp $
-For MACHINE, OpenBSD OSREV adds support for CATS StrongARM systems.
+dnl	$OpenBSD: whatis,v 1.2 2004/02/08 23:12:14 miod Exp $
+OpenBSD/MACHINE is a new port to the CATS StrongARM systems, with the
+intention to support more ARM-based hardware in the near future.
diff --git a/distrib/notes/cats/xfer b/distrib/notes/cats/xfer
index 6929aff13d9..d0f437bce3b 100644
--- a/distrib/notes/cats/xfer
+++ b/distrib/notes/cats/xfer
@@ -1,13 +1,15 @@
-dnl	$OpenBSD: xfer,v 1.1 2004/02/08 00:35:14 drahn Exp $
+dnl	$OpenBSD: xfer,v 1.2 2004/02/08 23:12:14 miod Exp $
 Installation is supported from several media types, including:
 
 	CDROM
 	FFS partitions
+	Tape
 	FTP
 	HTTP
 
 OpenBSDXferShortPrelude
 
-OpenBSDXferBareTape()
+
+OpenBSDXferBareTape
 
 OpenBSDXferFFS