[src/trunk]: src/distrib/notes/acorn32 formatting and whitespace cleanups

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

details:   https://anonhg.NetBSD.org/src/rev/2f162966dc15
branches:  trunk
changeset: 533392:2f162966dc15
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jun 29 08:57:21 2002 +0000

description:
formatting and whitespace cleanups

diffstat:

 distrib/notes/acorn32/prep |  158 ++++++++++++++++++++++++--------------------
 1 files changed, 87 insertions(+), 71 deletions(-)

diffs (truncated from 357 to 300 lines):

diff -r 5613f5c4891b -r 2f162966dc15 distrib/notes/acorn32/prep
--- a/distrib/notes/acorn32/prep        Sat Jun 29 08:56:36 2002 +0000
+++ b/distrib/notes/acorn32/prep        Sat Jun 29 08:57:21 2002 +0000
@@ -1,16 +1,17 @@
-.\"    $NetBSD: prep,v 1.3 2002/05/29 14:21:56 bjh21 Exp $
+.\"    $NetBSD: prep,v 1.4 2002/06/29 08:57:21 lukem 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.
+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
+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://pilling.users.netlink.co.uk/free.html .
 .It
@@ -21,8 +22,8 @@
 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:
+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 .
@@ -40,10 +41,12 @@
 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:
+anyway).
+Available from:
 .Lk http://cdc8g5.cdc.polimi.it/~pel0015/fsck.html
 .It
-!Zap (The read disk facility). Available from HENSA.
+!Zap (The read disk facility).
+Available from HENSA.
 .It
 The partition software/formatter for your desired installation
 target:
@@ -81,7 +84,8 @@
 .Pa BtNetBSD.zip
 as found in the
 .Pa installation/misc
-directory. (This should be pre-extracted if you're installing from CD-ROM).
+directory.
+(This should be pre-extracted if you're installing from CD-ROM).
 .It
 The
 .Nx*M
@@ -93,16 +97,15 @@
 A hardcopy of this document
 .El
 .Ss2 Preliminary steps
-Unpack your BtNetBSD archive in whatever way, set the type of
-the 
+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
+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
@@ -115,15 +118,15 @@
 .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.
+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
+between one or more RiscOS Discs and
 .Nx
 or dedicate a whole
 Device for
@@ -137,10 +140,11 @@
 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
+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
+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
@@ -149,17 +153,19 @@
 .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
+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
+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
+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.
@@ -177,8 +183,9 @@
 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.
+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.
@@ -191,8 +198,8 @@
 .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:
+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
@@ -206,21 +213,20 @@
 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
+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
+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.
+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 .
@@ -287,11 +293,11 @@
 Configure
 .Bl -bullet
 .It
-Here you should set up the RISC OS partitions as you
-like them. Normally the default will be ok.
+Here you should set up the RISC OS partitions as you like them.
+Normally the default will be ok.
 .It
-Click on configure. This will configure your computer
-and give you access to the Discs.
+Click on configure.
+This will configure your computer and give you access to the Discs.
 .El
 .It
 You
@@ -302,13 +308,14 @@
 .Pp
 2.1.4 Acorn SCSI card
 .Pp
-You can only have one RISC OS partition with this card. The rest has
-to be set aside for
+You can only have one RISC OS partition with this card.
+The rest has to be set aside for
 .Nx .
 
 This card does not have a friendly WIMP-based interface on the SCSI
-management program, but the command line version is very good. You
-should run this in a task window (press CTRL-F12):
+management program, but the command line version is very good.
+You should run this in a task window (press
+.Key CTRL-F12 ) :
 .Bd -ragged
 .Li *dir Ar location_of_scsidm
 .br
@@ -353,8 +360,8 @@
 .Pp
 2.1.5 Other interfaces
 .Pp
-It may not be possible to partition devices on other interface. If
-you are using a different interface you have 2 options:
+It may not be possible to partition devices on other interface.
+If you are using a different interface you have 2 options:
 .Bl -bullet
 .It
 Try to work out how to partition devices on it
@@ -367,8 +374,8 @@
 As a safety precaution
 .Nx*M
 looks for a filecore bootblock
-at the beginning of any device it labels. If it finds one and it
-looks as though it is in use then
+at the beginning of any device it labels.
+If it finds one and it looks as though it is in use then
 .Nx*M
 will not touch it.
 .Pp
@@ -393,11 +400,13 @@
 .Ss2 Running bb_riscbsd
 .Pp
 When you run this program, you will first be asked whether you are
-installing to an ADFS drive or a SCSI drive. You can just press
+installing to an ADFS drive or a SCSI drive.
+You can just press
 .Ql A
 or
 .Ql S
-respectively. (The
+respectively.
+(The
 .Ic bb_riscbsd
 program assumes that you are using a
 non-Acorn SCSI card, so if you are using an Acorn card, then you may
@@ -406,27 +415,29 @@
 with
 .Ql SCSIFS_DiscOp . )
 .Pp
-Then you will be asked which disc you want to install
+Then you will be asked which Disc you want to install
 .Nx
-on. This
+on.
+This
 .Em must
-be the first disc on the device.
+be the first Disc on the device.
 .Ic bb_riscbsd
 will now scrutinize the device and see how it has been laid out.
 .Pp
 It will then tell you how much of the device is occupied by RiscOS in
 cylinders, and you will then be asked for the
 .Nx
-starting
-cylinder. Normally you should just enter the number given to you
+starting cylinder.
+Normally you should just enter the number given to you
 since the RISC OS starting cylinder is 0 and therefore the last
-cylinder in use is one less than the figure given. If no figure is
-displayed, then your partitioning software failed to fill in the
-bootblock completely (it doesn't have to do this for you but most do)
-or you selected the wrong device. If you are convinced that this is
-the correct device then you must calculate a cylinder offset using
-the numbers noted down during partitioning (if it is not a whole
-number
+cylinder in use is one less than the figure given.
+If no figure is displayed, then your partitioning software failed to
+fill in the bootblock completely
+(it doesn't have to do this for you but most do)