[src/trunk]: src/distrib/notes/acorn32 Copy the arm32 INSTALL notes, removing...

[bjh21 <bjh21%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/76be726134c0
branches:  trunk
changeset: 516045:76be726134c0
user:      bjh21 <bjh21%NetBSD.org@localhost>
date:      Sun Oct 14 14:08:03 2001 +0000

description:
Copy the arm32 INSTALL notes, removing references to CATS, DNARD and RC7500
along the way.

diffstat:

 distrib/notes/acorn32/Makefile    |    5 +
 distrib/notes/acorn32/hardware    |  156 ++++++++++
 distrib/notes/acorn32/install     |  574 ++++++++++++++++++++++++++++++++++++++
 distrib/notes/acorn32/legal       |   10 +
 distrib/notes/acorn32/prep        |   25 +
 distrib/notes/acorn32/prep.RISCOS |  559 +++++++++++++++++++++++++++++++++++++
 distrib/notes/acorn32/upgrade     |    3 +
 distrib/notes/acorn32/whatis      |   13 +
 distrib/notes/acorn32/xfer        |    3 +
 9 files changed, 1348 insertions(+), 0 deletions(-)

diffs (truncated from 1384 to 300 lines):

diff -r a4d8d3f2abad -r 76be726134c0 distrib/notes/acorn32/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/acorn32/Makefile    Sun Oct 14 14:08:03 2001 +0000
@@ -0,0 +1,5 @@
+#      $NetBSD: Makefile,v 1.1 2001/10/14 14:08:03 bjh21 Exp $
+
+MERGED_SRCS+=${.CURDIR}/../common/upgrade
+
+.include <bsd.man.mk>
diff -r a4d8d3f2abad -r 76be726134c0 distrib/notes/acorn32/hardware
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/acorn32/hardware    Sun Oct 14 14:08:03 2001 +0000
@@ -0,0 +1,156 @@
+.\"    $NetBSD: hardware,v 1.1 2001/10/14 14:08:03 bjh21 Exp $
+.
+.Nx*M
+\*V runs on Acorn systems with
+.Tn ARM6
+or later processors,
+with or without FPU coprocessor. The minimal configuration is said to
+require 8 MB of RAM and 50 MB of disk space, though we do not know of anyone
+running with a system quite this minimal today. To install the entire
+system requires much more disk space (the unpacked binary distribution,
+without sources, requires at least 65 MB without counting space needed for
+swap space, etc), and to run X or compile the system, more RAM is
+recommended. (8 MB of RAM will actually allow you to run X and/or compile,
+but it won't be speedy. Note that until you have around 16 MB of RAM,
+getting more RAM is more important than getting a faster CPU.)
+.
+.Ss2 Supported devices
+.(bullet -offset indent
+RiscPC/A7000(+) floppy controller
+.It
+IDE controllers
+.(bullet -compact
+Acorn motherboard IDE
+.It
+Simtec IDE controller
+.It
+RapIDE Issue 2 IDE controller
+.It
+ICS V5 & V6 IDE controller
+.bullet)
+.It
+SCSI host adapters
+.(bullet -compact
+Cumana SCSI 2
+.It
+PowerTec SCSI 2
+.It
+MCS Connect32 SCSI 2
+.It
+Acorn SCSI
+.It
+Oak SCSI I
+.It
+Morley SCSI I (uncached only)
+.bullet)
+.It
+VIDC20 video
+.It
+RiscPC Motherboard serial port
+.It
+RiscPC Motherboard parallel port
+.It
+Ethernet adapters
+.(bullet -compact
+Acorn Ether1
+.It
+Atomwide Ether3
+.It
+ANT Ether3
+.It
+ANT Ether5
+.It
+Atomwide EtherA
+.It
+ANT EtherB
+.It
+Acorn EtherH
+.It
+I-cubed EtherH
+.It
+ANT EtherM
+.bullet)
+.It
+Most SCSI disk drives
+.It
+Most SCSI tape drives
+.It
+CD-ROM drives
+.(bullet -compact
+Most SCSI CD-ROM drives
+.It
+Most ATAPI CD-ROM drives
+.(Note
+Some low-priced IDE CD-ROM drives are known for being not or not fully
+ATAPI compliant, and thus requires some hack (generally an entry to a
+quirk table) to work with
+.Nx .
+.Note)
+.bullet)
+.It
+Mice
+.(bullet -compact
+RiscPC quadrature mouse
+.It
+A7000 PS/2 mouse
+.bullet)
+.It
+Processors
+.(bullet -compact
+ARM 610
+.It
+ARM 700
+.It
+ARM 700 + FPA11
+.It
+ARM 710
+.It
+ARM 7500
+.It
+ARM 7500FE
+.It
+ARM 810. [*]
+.It
+SA110
+.bullet)
+.It
+Motherboards
+.(bullet -compact
+Acorn RiscPC
+.It
+Acorn A7000
+.It
+Acorn A7000+
+.bullet)
+.It
+Other devices
+.(bullet -compact
+RiscPC keyboard
+.It
+A7000 keyboard
+.It
+RiscPC realtime clock
+.bullet)
+.bullet)
+.Pp
+Drivers for hardware marked with
+.Dq [*]
+are
+.Em not
+present in installation kernels.
+.Pp
+Support for some devices is limited to particular kernels. eg there is no
+SA110 support in A7000 kernels.
+.
+.Ss2 Unsupported devices
+.(bullet -offset indent -compact
+Acorn/Aleph1 PC cards
+.It
+Any SCSI card using a PowerROM
+.It
+Podule based serial ports
+.It
+Castle SCSI/Ethernet cards
+.bullet)
+.Pp
+Drivers are planned for some of the above devices.
diff -r a4d8d3f2abad -r 76be726134c0 distrib/notes/acorn32/install
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/acorn32/install     Sun Oct 14 14:08:03 2001 +0000
@@ -0,0 +1,574 @@
+.\"    $NetBSD: install,v 1.1 2001/10/14 14:08:03 bjh21 Exp $
+.\"
+.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+Installing
+.Nx
+is a relatively complex process, but if you have
+this document in hand and are careful to read and remember the
+information which is presented to you by the install program, it
+shouldn't be too much trouble.
+.Pp
+Before you begin, you should know the geometry of your hard disk, i.e.
+the sector size (note that sector sizes other than 512 bytes are not
+currently supported), the number of sectors per track, the number of
+tracks per cylinder (also known as the number of heads), and the
+number of cylinders on the disk. The
+.Nx
+kernel will try to
+discover these parameters on its own, and if it can it will print them
+at boot time. If possible, you should use the parameters it prints.
+(You might not be able to because you're sharing your disk with
+another operating system, or because your disk is old enough that the
+kernel can't figure out its geometry.)
+.Pp
+If
+.Nx
+will be sharing the disk with RiscOS 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
+.Nx
+area of the disk and its offset from the
+beginning of the disk. You will need this information when setting up
+your
+.Nx
+partitions.
+.Pp
+You should now be ready to install
+.Nx .
+It might be handy for you
+to have a pencil, some paper, and a calculator handy.
+.Pp
+The following is a walk-through of the steps you will take while
+getting
+.Nx
+installed on your hard disk. If any question has a
+default answer, it will be displayed in brackets
+.Pq Dq []
+after the
+question. If you wish to stop the installation, you may press
+.Key CONTROL-C
+at any time, but if you do, you'll have to begin the installation
+process again from scratch.
+.Pp
+Boot your machine using the installation kernel for your
+platform. (Instructions for doing this on your platform can be
+found in the preparation section of this document.)
+.Pp
+If this doesn't work, ensure that you're using the correct
+kernel for your hardware.
+.Pp
+Depending upon your platform and the method of loading the,
+it may take a while to load the kernel.
+.Pp
+You will then be presented with the
+.Nx
+kernel boot
+messages. You will want to read them, to determine your
+disk's name and geometry. Its name will be something like
+.Li sd0
+or
+.Li wd0
+and the geometry will be printed on a line that
+begins with its name. As mentioned above, you will need your
+disk's geometry when creating
+.Nx 's
+partitions. You will
+also need to know the name, to tell the install tools what
+disk to install on.
+.Pp
+While booting, you will probably see several warnings. You
+should be warned that no swap space is present, and that
+.Xr init 8
+cannot find
+.Pa /etc/rc.
+Do not be alarmed, these are
+completely normal. When you reach the prompt asking you for a
+shell name, just press
+.Key RETURN .
+.Pp
+You will be asked if you wish to install or upgrade your
+system or go to a shell prompt. Enter
+.Ic install .
+.Pp
+You will be presented with a welcome message and a prompt,
+asking if you wish to proceed with the installation process.
+If you wish to proceed, enter
+.Sq Ic y