[src/trunk]: src/distrib/notes/acorn32 Convert the bulk of the prep.RISCOS fi...

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

details:   https://anonhg.NetBSD.org/src/rev/e010127b1b4a
branches:  trunk
changeset: 525649:e010127b1b4a
user:      bjh21 <bjh21%NetBSD.org@localhost>
date:      Sun Apr 14 14:40:13 2002 +0000

description:
Convert the bulk of the prep.RISCOS file into -mdoc.  This is a purely
syntactic conversion -- the semantics should be exactly the same.

I haven't yet converted section 5 (advanced stuff), appendix A (device
naming) or appendix B (credits), and mdoc, even the souped-up version used
for INSTALL, seems to be lacking a fourth-level header macro, which this
wants.

Of course, the presence of fourth-level headers does somewhat indicate that
this whole area wants cleaning up lots.

diffstat:

 distrib/notes/acorn32/prep |  496 ++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 490 insertions(+), 6 deletions(-)

diffs (truncated from 510 to 300 lines):

diff -r cee86bf634a1 -r e010127b1b4a distrib/notes/acorn32/prep
--- a/distrib/notes/acorn32/prep        Sun Apr 14 14:35:05 2002 +0000
+++ b/distrib/notes/acorn32/prep        Sun Apr 14 14:40:13 2002 +0000
@@ -1,16 +1,500 @@
-.\"    $NetBSD: prep,v 1.1 2001/10/14 14:08:03 bjh21 Exp $
+.\"    $NetBSD: prep,v 1.2 2002/04/14 14:40:13 bjh21 Exp $
 .
 First and foremost, before beginning the installation process,
 .Em make sure you have a reliable backup
 of any data on your hard disk that you
 wish to keep. Repartitioning your hard disk is an excellent way to
 destroy important data.
+.Ss2 Software requirements
+You will need the following RiscOS software:
+.Bl -bullet
+.It
+A program that will unpack sparchives. We recommend that you
+get David Pilling's !SparkPlug. A self-extracting version of this
+can be found at David Pilling's W3 site
+.Pq Lk http://www.pilling.demon.co.uk/free.html .
+.It
+A program that can uncompress gzip files, because the current bootloader
+can't read gzip'ed kernels (yet!).
+.Bl -bullet
+.It
+The included command line gzip program
+.Pa installation/misc/gzip_ff8
+(!) which is a mirror a version
+that Laurent Domisse has patched to work on SA. This is
+also available from:
+.Lk http://www.users.dircon.co.uk/~arcangel/files/index.html .
+Just set the type of the file to
+.Ql ff8 .
+.It
+SparkFS from David Pilling (commercial) (v1.28 for SA-110).
+.It
+!Gzip from HENSA (micros.hensa.ac.uk); is it still alive
+though?
+.El
+.It
+A program to report your disk's geometry:
+.Bl -bullet
+.It
+Not really needed, you can simply boot the installation
+kernel and look for the geometry in the boot messages.
+.It
+Sergio Monesi's fsck suite (a good thing to have around
+anyway). Available from:
+.Lk http://cdc8g5.cdc.polimi.it/~pel0015/fsck.html
+.It
+!Zap (The read disk facility). Available from HENSA.
+.It
+The partition software/formatter for your desired installation
+target:
+.Bl -bullet
+.It
+IDE disks on motherboard interface: !HForm
+.It
+IDE disks on Simtec interface: UNKNOWN
+.It
+IDE disks on ICS interface: UNKNOWN
+.It
+IDE disks on RapIDE interface: UNKNOWN
+.It
+Acorn SCSI cards: ScsiDM
+.It
+Power-tec SCSI cards: !PowerMgr
+.It
+Cumana SCSI-2: !SCSIMgr
+.It
+oak SCSI-1 card: UNKNOWN
+.It
+MCS Connect32 SCSI: UNKNOWN
+.It
+Morley SCSI: UNKNOWN
+.El
+.El
+.It
+An installation kernel for your platform:
 .Pp
-Second, read and perform the instructions in
-.Pa \*M/ Ns Ar platform Ns Pa /prep
-that are specific to your platform for partitioning and booting (even if you're
-dedicating a device to
-.Nx ) .
+RiscPC/A7000(+)/NC's  : INSTALL kernel
+.It
+The Bootloader and RiscOS tools:
+.Pa BtNetBSD.tar.gz
+or
+.Pa BtNetBSD.zip
+as found in the
+.Pa installation/misc
+directory. (This should be pre-extracted if you're installing from CD-ROM).
+.It
+The
+.Nx*M
+distribution sets (Will be on the CD-ROM, or
+available from your nearest
+.Nx
+ftp site).
+.It
+A hardcopy of this document
+.El
+.Ss2 Preliminary steps
+Unpack your BtNetBSD archive in whatever way, set the type of
+the 
+.Pa Settype
+file in the
+.Pa BtNetBSD
+directory to
+.Ql Obey
+and run
+it. This will make the files RISC OS typed correctly. this is
+also explained in a bit more detail in the enclosed
+.Pa README
+file.
+.Ss2 Preparing your hard disk
+Terms:
+.Bl -tag -width "File system"
+.It Device
+The actual physical hard disk
+.It Partition
+A section of a device.
+.It File system
+A structured partition that is able to hold files.
+.It Disc
+A RiscOS file system in a partition. There can be
+more than one Disc per Device.
+.El
+.Pp
+You will have to decide which device you wish to install
+.Nx
+on.
+You will also have to decide whether you want to split the device
+between one or more RiscOS discs and
+.Nx
+or dedicate a whole
+Device for
+.Nx .
+.Pp
+In making this decision you should consider the possibility that if
+.Nx
+is incorrectly configured on a shared device then your shared
+data is at risk.
+.Pp
+It is still recommended that if you decide to dedicate a device to
+.Nx
+that you set aside a small RISC OS partition at the beginning
+of the device. This is a useful place to store the RiscOS side of
+.Nx ,
+and will make the use of UnixFS easier to configure. If you
+do decide to create a minimal RiscOS partition at the beginning of
+the device, a size of 10-20 MB is recommended (some partitioning
+software has problems with partitions smaller than this).
+.Pp
+The point is that you will have to repartition your device to make
+room for a separate partition after the RISC OS one for
+.Nx .
+This
+means backing up your device, re-partitioning it and then copying all
+the data back afterwards. We recommend that you only copy the needed
+data back and put off installing the rest until you have
+.Nx
+up
+and running. This way you will save yourself a lot of work if
+something goes wrong and you have to start all over again.
+.Ss2 Sharing your device
+2.1.1 Acorn IDE
+.Pp
+Use !HForm for this interface. This is a program that is delivered
+with your computer and is located in the
+.Pa Utilities
+directory on your
+hard disk.
+.Pp
+With this software you only have the possibility of using one
+partition for RISC OS, so you have to set the rest aside for
+.Nx .
+.Pp
+Use this procedure to set up your device:
+.Bl -bullet
+.It
+Start !HForm by double-clicking on its icon.
+.It
+Choose the "custom" or "other" option when prompted (usually
+the last).
+.It
+Use the default values for the geometry but do not enter the
+full number of cylinders. Just enter the number you want to
+use for RISC OS. Make a note of this number.
+.It
+Continue to accept the default answers until you're asked
+whether you want to format or initialize, choose initialize.
+.It
+Go to the section about running
+.Ic bb_riscbsd .
+.El
+.Pp
+2.1.2 Cumana SCSI-2 card
+.Pp
+It is recommended that you use a newer version of !SCSIMgr (newer
+than v1.55) since this will be easier to use when you want to leave
+part of the device unused by RISC OS. You should check for the latest
+version of this software at the following URL:
+.Lk http://www.cumana.demon.co.uk
+.Pp
+You need to create one or more RISC OS partitions, and you do it in
+in the following way:
+.Bl -bullet
+.It
+Run !SCSIMgr by double-clicking on it.
+.It
+Select the device you wish to repartition.
+.It
+Click on the clear icon in the partitions subwindow.
+.It
+This will give you a dialogue box where you can specify the
+size of the RISC OS partitions. Do not select all since you
+want to use part of it for
+.Nx .
+.It
+Enter the amount of the device you wish to reserve for
+RiscOS. This will be the whole device size less the amount
+you want to reserve for
+.Nx .
+Make a note of this number.
+.It
+If you like, split the RISC OS portion of the device into
+several partition (you should only "see" the RiscOS portion).
+.It
+Click on Execute when you are happy with the partitions. This
+will create your partitions, and wipe your device.
+.It
+Go to the section about running
+.Ic bb_riscbsd .
+.El
+.Pp
+2.1.3 Alsystems Power-tec SCSI-2 card
+.Pp
+You must use the !PowerMgr program to partition the device.
+.Pp
+The RISC OS partitions should be called
+.Ql RiscOs: ,
+and the
+.Nx
+one should be called
+.Ql Empty: .
+.Pp
+Here is the procedure you should use:
+.Bl -bullet
+.It
+Start !PowerMgr by double-clicking on its icon.
+.It
+Click on advanced in the main window
+.It
+Click on Define/create partitions
+.Bl -bullet
+.It
+Click on the device you want to set up for NetBSD.
+.It
+Set up the RISC OS partitions as
+.Ql RiscOs:
+and the        remaining one as
+.Ql Empty: .
+.It
+Click on each figure and press RETURN.
+.It
+Click on partition drive.
+.It
+Click on yes to warning as you really want to wipe
+the device.
+.It
+Click on yes to proceed, this will lead you to the
+partition init.
+.El
+.It
+Partition init
+.Bl -bullet
+.It
+Set a tick on all
+.Ql RiscOs:
+partitions, give them a name and set LFAU to auto.
+.It
+Unset the tick on your
+.Ql Empty:
+partition.
+.It
+Click on Inititialize selected partitions.
+.It
+Click on yes to proceed init as you want to wipe the
+selected partitions.
+.It
+Click on yes to proceed to configure.
+.El
+.It
+Configure
+.Bl -bullet
+.It
+Here you should set up the RISC OS partitions as you