[src/trunk]: src/distrib/notes/mvme68k clean up formatting

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

details:   https://anonhg.NetBSD.org/src/rev/72951399d008
branches:  trunk
changeset: 533423:72951399d008
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sun Jun 30 00:46:48 2002 +0000

description:
clean up formatting

diffstat:

 distrib/notes/mvme68k/hardware |   14 ++-
 distrib/notes/mvme68k/install  |  163 ++++++++++++++++++++++++----------------
 distrib/notes/mvme68k/prep     |   47 +++++++----
 distrib/notes/mvme68k/xfer     |   95 ++++++++++++-----------
 4 files changed, 183 insertions(+), 136 deletions(-)

diffs (truncated from 717 to 300 lines):

diff -r 6bd8c3e3a1be -r 72951399d008 distrib/notes/mvme68k/hardware
--- a/distrib/notes/mvme68k/hardware    Sun Jun 30 00:25:04 2002 +0000
+++ b/distrib/notes/mvme68k/hardware    Sun Jun 30 00:46:48 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hardware,v 1.8 2000/11/21 12:38:59 scw Exp $
+.\"    $NetBSD: hardware,v 1.9 2002/06/30 00:46:48 lukem Exp $
 .
 .Nx*M
 \*V runs on Motorola
@@ -16,9 +16,10 @@
 .Pp
 The minimal configuration requires 8 MB of RAM and ~200 MB of disk space.
 To install the entire system requires much more disk space (approx.
-600 MB additional space is necessary for full sources. Double that if you
-want to recompile it all!). To run X (clients only) or compile the system,
-more RAM is recommended. Good performance requires 16 MB of RAM, or 32 MB
+600 MB additional space is necessary for full sources.
+Double that if you want to recompile it all!).
+To run X (clients only) or compile the system, more RAM is recommended.
+Good performance requires 16 MB of RAM, or 32 MB
 when running the X Window System.
 .Pp
 Note that you can install
@@ -44,8 +45,9 @@
 .Nx*M
 installation procedure uses a
 .Em miniroot
-image which is placed into the swap area of the disk. The swap partition
-must be large enough to hold this miniroot image (\*> 7.5 MB).
+image which is placed into the swap area of the disk.
+The swap partition must be large enough to hold this miniroot image
+(\*> 7.5 MB).
 .
 .Ss2 Supported VME147 hardware
 .(bullet -offset indent
diff -r 6bd8c3e3a1be -r 72951399d008 distrib/notes/mvme68k/install
--- a/distrib/notes/mvme68k/install     Sun Jun 30 00:25:04 2002 +0000
+++ b/distrib/notes/mvme68k/install     Sun Jun 30 00:46:48 2002 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: install,v 1.16 2002/04/05 21:14:35 scw Exp $
+.\"    $NetBSD: install,v 1.17 2002/06/30 00:46:49 lukem Exp $
 .\"
-.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -38,13 +38,15 @@
 .Pp
 There are several ways to install
 .Nx
-onto your disk. If your
+onto your disk.
+If your
 .Tn MVME147
 machine has a tape drive the easiest way is
 .Sx "Installing from tape"
 (details below).
 All other machines can be installed easily over the network from a
-suitable NFS server. See
+suitable NFS server.
+See
 .Sx "Installing from NFS"
 for details.
 Otherwise, if you have another \*M machine running
@@ -68,10 +70,11 @@
 As mentioned earlier, this assumes your tape is jumpered for SCSI-ID 5.
 .Pp
 As the tape loads (which may take 20 to 30 seconds), you will see a
-series of status messages. It may be useful if you can capture these
-messages to a file, or a scrollable xterm window. In particular, you
-should make a note of the lines which describe the geometry of the
-SCSI disks detected by
+series of status messages.
+It may be useful if you can capture these
+messages to a file, or a scrollable xterm window.
+In particular, you should make a note of the lines which describe the
+geometry of the SCSI disks detected by
 .Nx .
 They are of the form:
 .(disp
@@ -80,8 +83,8 @@
 .disp)
 .Pp
 The information of most interest is the number of sectors; for the fictitious
-disk above, it's 1638400. You will need this number when you come to create
-a disklabel for that drive.
+disk above, it's 1638400.
+You will need this number when you come to create a disklabel for that drive.
 .Pp
 Here is an example of an MVME147 system booting from tape:
 .(disp
@@ -93,7 +96,7 @@
 Volume: NBSD
 
 IPL loaded at:  $003F0000
-\*>\*> BSD MVME147 tapeboot [$Revision: 1.16 $]
+\*>\*> BSD MVME147 tapeboot [$Revision: 1.17 $]
 578616+422344+55540+[46032+51284]=0x11a6e4
 Start @ 0x8000 ...
 Copyright (c) 1996, 1997, 1998, 1999, 2000
@@ -178,7 +181,8 @@
 .It Li sd0b
 The swap partition.
 .It Li sd0c
-The whole disk. Also known as the
+The whole disk.
+Also known as the
 .Em raw partition .
 .tag)
 .Pp
@@ -186,8 +190,9 @@
 .Em raw partition No is special;
 .Nx
 is able to use it even if the
-disk has no label. You should never create a file system on the Raw
-Partition, even on a non-boot disk.
+disk has no label.
+You should never create a file system on the Raw Partition,
+even on a non-boot disk.
 .Pp
 It is good practice to put
 .Pa /usr
@@ -262,14 +267,16 @@
 .Dl edlabel/modify\*>
 .Pp
 When you enter the start and length of a partition, you can use either
-blocks or cylinder/track/sector notation. If this is the first time
-you've partitioned a disk for
+blocks or cylinder/track/sector notation.
+If this is the first time you've partitioned a disk for
 .Nx ,
 it's probably easiest to use block
-notation. The above example creates partition
+notation.
+The above example creates partition
 .Sq Li a ,
 starting at block zero
-and with a size of 65536 blocks. Note that the usual size of a block is
+and with a size of 65536 blocks.
+Note that the usual size of a block is
 512 bytes, so this creates a 32 MB partition.
 .Pp
 The
@@ -278,9 +285,9 @@
 .Li 4.2BSD ,
 otherwise you won't be able to create a file system on it.
 .Pp
-Next, create a swap partition (b). Note that the minimum size of this
-swap partition should be 8 MB, otherwise you won't be able to use a
-miniroot to complete the
+Next, create a swap partition (b).
+Note that the minimum size of this swap partition should be 8 MB,
+otherwise you won't be able to use a miniroot to complete the
 .Nx
 installation!
 .Pp
@@ -295,14 +302,17 @@
 .Li start
 such that the swap partition follows immediately after partition
 .Sq Li a ,
-i.e. 65536. The length of the swap
-partition should be a multiple of the amount of RAM you have in your
-system. Here, we've chosen 32768, or 16 MB. The next available block on the
-drive is thus 65536 + 32768. We will use this to create partition
+i.e. 65536.
+The length of the swap partition should be a multiple of the
+amount of RAM you have in your system.
+Here, we've chosen 32768, or 16 MB.
+The next available block on the drive is thus 65536 + 32768.
+We will use this to create partition
 .Sq Li d
 for our
 .Pa /usr
-file system. (Note that for a busy system, or a system with more
+file system.
+(Note that for a busy system, or a system with more
 than 8 MB of RAM, you'll be better off with a 32 or 64 MB swap partition.)
 .Pp
 .Dl edlabel/modify\*> Ic d
@@ -322,15 +332,17 @@
 gives
 .Sy d No a size of 1540096.
 .Pp
-Note that the above partition sizes are just guidelines. If your disk is
-large enough, you should resize the partitions appropriately and
-perhaps also create a /var partition as well.
+Note that the above partition sizes are just guidelines.
+If your disk is large enough, you should resize the partitions
+appropriately and perhaps also create a /var partition as well.
 .Pp
 You now need to write this new disklabel, together with the partition
-details you've just entered, to disk. You might also try the
+details you've just entered, to disk.
+You might also try the
 .Sq Ic p
 command
-to view the partitions. Once written, you can quit back to the shell using
+to view the partitions.
+Once written, you can quit back to the shell using
 .Sq Ic q .
 .Pp
 .Dl edlabel\*> Ic p
@@ -357,9 +369,11 @@
 .Dl #
 .Pp
 Now that your disk's partitioned, you need to get the proper installation
-miniroot image onto it. The miniroot image is designed to be copied into
-the swap partition of your disk. This is a safe place which won't be
-overwritten by the installation procedure. From the shell prompt, use the
+miniroot image onto it.
+The miniroot image is designed to be copied into
+the swap partition of your disk.
+This is a safe place which won't be overwritten by the installation procedure.
+From the shell prompt, use the
 following commands to copy the miniroot image from tape to swap (b).
 .Pp
 .Dl # Ic "mt -f /dev/nrst0 rewind"
@@ -368,7 +382,8 @@
 .Pp
 The disk and the miniroot must now be made bootable using the
 .Xr installboot 8
-command. To do this, issue the following commands:
+command.
+To do this, issue the following commands:
 .Pp
 .Dl # Ic "mount /dev/sd0b /mnt"
 .Dl # Ic "installboot /mnt/usr/mdec/bootsd /bootxx /dev/rsd0b"
@@ -389,8 +404,8 @@
 .Dl Execute Soft Reset [Y,N] N? Ic y
 .Pp
 Resetting the other types of MVME boards are very similar.
-You should now reboot from that just installed miniroot. See the section
-entitled
+You should now reboot from that just installed miniroot.
+See the section entitled
 .Sx "Booting the miniroot"
 for details.
 .
@@ -411,7 +426,8 @@
 .Pa install
 directory of the \*M distribution).
 You can either do that through the console line or through a 2nd serial
-connection. For example, an MVME147 connected to a sun4/110 and accessed via
+connection.
+For example, an MVME147 connected to a sun4/110 and accessed via
 .Xr tip 1
 can be loaded as follows:
 .Pp
@@ -438,12 +454,14 @@
 .Dl \*>\*>\*>
 .Pp
 Now, if you want to do it through serial line 1, then connect serial
-line one to a machine. At the
+line one to a machine.
+At the
 .Li 147-Bug\*> No prompt type Ic \&tm 1
 You should then login to the machine it is connected to.
 Then press
 .Key CONTROL-A
-to escape to Bug. do
+to escape to Bug.
+Do
 .Ic lo 1;x=cat sboot Em ...
 then when that is done you can reconnect
 .Ic tm 1 No and logout.
@@ -477,8 +495,8 @@
 on the board as described in the section entitled "Preparing your System
 for
 .Nx
-Installation. On a properly configured MVME162/172 or MVME167/177, all you need
-to type is:
+Installation.
+On a properly configured MVME162/172 or MVME167/177, all you need to type is:
 .Pp
 .Dl 1xx-Bug\*> Ic nbo
 .Pp
@@ -486,7 +504,7 @@
 .Pp
 .(disp
 Start @ 0x8000 ...
-\*>\*> BSD MVME147 netboot (via sboot) [$Revision: 1.16 $]
+\*>\*> BSD MVME147 netboot (via sboot) [$Revision: 1.17 $]
 device: le0 attached to 08:00:3e:20:cb:87
 boot: client IP address: 192.168.1.4
 boot: client name: soapy
@@ -521,11 +539,13 @@
 .Pq Pa / .
 Follow the instructions in the previous section entitled
 .Sx "Installing from tape"
-to do this. (But stop short of the part which describes how to
+to do this.
+(But stop short of the part which describes how to
 copy the miniroot from tape.)
 .Pp
 You must now configure the network interface before you can access the
-NFS server containing the miniroot image. For example the command:
+NFS server containing the miniroot image.
+For example the command:
 .Pp