[src/trunk]: src/dist/pdisk mdocify. Adapt contents to NetBSD. Requested by mrg.

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

details:   https://anonhg.NetBSD.org/src/rev/0fe41c954700
branches:  trunk
changeset: 535436:0fe41c954700
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Aug 18 23:41:38 2002 +0000

description:
mdocify. Adapt contents to NetBSD. Requested by mrg.

diffstat:

 dist/pdisk/pdisk.8 |  313 +++++++++++++++++++++++-----------------------------
 1 files changed, 141 insertions(+), 172 deletions(-)

diffs (truncated from 367 to 300 lines):

diff -r 0a4db72964a8 -r 0fe41c954700 dist/pdisk/pdisk.8
--- a/dist/pdisk/pdisk.8        Sun Aug 18 19:18:33 2002 +0000
+++ b/dist/pdisk/pdisk.8        Sun Aug 18 23:41:38 2002 +0000
@@ -1,222 +1,191 @@
-.TH PDISK 8 "16 May 2000" "LinuxPPC" "Linux Programmer's Manual"
-.SH NAME
-pdisk \- Apple partition table editor for Linux
-.SH SYNOPSIS
-.B pdisk
-.B "[\-h|\--help]"
-.br
-.B pdisk
-.B "[\-i|\--interactive]"
-.br
-.B pdisk
-.B "[\-l|\--list [name ...]]"
-.br
-.B pdisk
-device ...
-.br
-.B pdisk
-.B "[\-v|\--version] [\-r|\--readonly] [\-abbr] [\--logical] [\-c|\--compute_size] [\-p|\--pname] [\-d|\--debug]"
-.SH DESCRIPTION
-.B pdisk
+.\"    $NetBSD: pdisk.8,v 1.2 2002/08/18 23:41:38 wiz Exp $
+.Dd August 19, 2002
+.Os
+.Dt PDISK 8
+.Sh NAME
+.Nm pdisk
+.Nd Apple partition table editor
+.Sh SYNOPSIS
+.Nm
+.Op Fl acdhilrv
+.\".Op Fl acdhilLprv
+.Ar device ...
+.\".Op Fl -abbr
+.\".Op Fl -compute_size
+.\".Op Fl -debug
+.\".Op Fl -help
+.\".Op Fl -interactive
+.\".Op Fl -list Ar name ...
+.\".Op Fl -logical
+.\".Op Fl -pname
+.\".Op Fl -readonly
+.\".Op Fl -version
+.Sh DESCRIPTION
+.Nm
 is a menu driven program which partitions disks using the standard Apple
 disk partitioning scheme described in "Inside Macintosh: Devices".
-It does not support the intel/dos partitioning scheme supported by 
-.BR fdisk .
-The
-.I device
-is usually one of the following:
-
-.nf
-.RS
-/dev/sda
-/dev/sdb
-/dev/sdc
-/dev/sdd
-/dev/sde
-/dev/sdf
-/dev/sdg
-/dev/hda
-/dev/hdb
-/dev/hdc
-/dev/hdd
-
-.RE
-.fi
-In standard Linux /dev/sda is the first hard disk on the SCSI bus (i.e. the
-one with the lowest id), /dev/sdb is the second hard disk, and so on.
-The
-.I partition
-is a
-.I device
-name followed by a partition number.
-The partition number is the index (starting from one) of the partition
-map entry in the partition map.
-For example,
-.B /dev/sda2
-is the partition described by the second entry in the partiton map on /dev/sda.
-
-.SH OPTIONS
-.TP
-.B \-v | \--version
-Prints version number of the
-.B pdisk
-program.
-.TP
-.B \-h | \--help
-Prints a rather lame set of help messages for the
-.B pdisk
-program.
-.TP
-.B \-i | \--interactive
+It does not support the Intel/DOS partitioning scheme supported by
+.Xr fdisk 8 .
+.Pp
+Supported options are:
+.Bl -tag -width Fl
+.It Fl a
+Abbreviate the partition types shown in the partition list.
+.It Fl c
 Causes
-.B pdisk
-to go into an interactive mode similar to the MacOS version of the program.
-.TP
-.B \-l | \--list
-If no
-.IR name s
-are present then lists the partition tables for
-.BR /dev/sda ,
-.BR /dev/sdb ,
-etc. ,
-.BR /dev/hda ,
-.BR /dev/hdb ,
-etc. , and
-.BR /dev/scd0 ,
-.BR /dev/scd1 ,
-etc..
-Otherwise, lists the partition tables for the specified
-.IR name s.
-.TP
-.B \-r | \--readonly
-Prevents
-.B pdisk
-from writing to the device.
-.TP
-.B \-c | \--compute_size
-Causes
-.B pdisk
+.Nm
 to always ignore the device size listed in the partition table
 and compute the device size by other means.
-.TP
-.B \-p | \--pname
-Since the default behaviour of
-.B pdisk
-is to show the Mac volume name, this flag forces
-.B pdisk
-to show the partition name instead.
-.TP
-.B \-d | \--debug
+.It Fl d
 Turns on debugging.  Doesn't add that much output, but does add
-a new command 'x' to the editing commands that accesses an
-eclectic bunch of undocumented functionality.
-.SH "Editing Partition Tables"
+a new command
+.Sq x
+to the editing commands that accesses an eclectic bunch of
+undocumented functionality.
+.It Fl h
+Prints a short help message.
+.It Fl i
+Causes
+.Nm
+to go into an interactive mode similar to the MacOS version of the program.
+.It Fl l
+If no
+.Ar device
+argument is given,
+.Nm
+tries to list partition tables for all available hard drives.
+Otherwise,
+.Nm
+lists the partition tables for the specified
+.Ar devices .
+.\".It Fl L
+.\"Show physical limits of partition in the partition list.
+.\"Defaults to on.
+.\".It Fl p
+.\"Since the default behaviour of
+.\".Nm
+.\"is to show the Mac volume name, this flag forces
+.\".Nm
+.\"to show the partition name instead.
+.It Fl r
+Prevents
+.Nm
+from writing to the device.
+.It Fl v
+Prints the version number of
+.Nm "" .
+.El
+.Ss Editing Partition Tables
 An argument which is simply the name of a
-.I device
+.Ar device
 indicates that
-.B pdisk
+.Nm
 should edit the partition table of that device.
-
+.Pp
 The current top level editing commands are:
-
-.nf
-.RS
+.Bd -unfilled -offset indent
+C    (create with type also specified)
+c    create new partition
+d    delete a partition
 h    command help
-p    print the partition table
+i    initialize partition map
+n    (re)name a partition
 P    (print ordered by base address)
-i    initialize partition map
+p    print the partition table
+q    quit editing (don't save changes)
+r    reorder partition entry in map
 s    change size of partition map
-c    create new partition (standard MkLinux type)
-C    (create with type also specified)
-n    (re)name a partition
-d    delete a partition
-r    reorder partition entry in map
 w    write the partition table
-q    quit editing (don't save changes)
-
-.RE
-.fi
+.Ed
+.Pp
 Commands which take arguments prompt for each argument in turn.
 You can also type any number of the arguments separated by spaces
 and those prompts will be skipped.
 The only exception to typeahead are the confirmation prompts on the
-.B i
+.Ic i
 and
-.B w
-commands.
-The idea being that if we expect you to confirm the decision we
-shouldn't undermine that by allowing you to be precipitate about it.
-
+.Ic w
+commands,
+since if we expect you to confirm the decision, we shouldn't undermine
+that by allowing you to be precipitate about it.
+.Pp
 Partitions are always specified by their number,
-which the index of the partition entry in the partition map.
+which is the index of the partition entry in the partition map.
 Most of the commands will change the index numbers of all partitions
 after the affected partition.
 You are advised to print the table as frequently as necessary.
-
+.Pp
 Creating more than fifteen partitions is not advised.
-There is currently a bug in the some (all?) of the kernels which causes
-access to the whole disk fail if more than fifteen partitions are in the map.
-
+.\"There is currently a bug in the some (all?) of the kernels which causes
+.\"access to the whole disk fail if more than fifteen partitions are in the map.
+.Pp
 The
-.B c
+.Ic c
 (create new partition) command is the only one with complicated arguments.
 The first argument is the base address (in blocks) of the partition.
 Besides a raw number, you can also specify a partition number followed
-by the letter 'p' to indicate that the first block of the new partition should
-be the same as the first block of that existing free  space partition.
+by the letter
+.Sq p
+to indicate that the first block of the new partition should be the same
+as the first block of that existing free space partition.
 The second argument is the length of the partition in blocks.
 This can be a raw number or can be a partition number followed by the
-letter 'p' to use the size of that partition or can be a number followed
-by 'k', 'm', or 'g' to indicate the size in kilobytes, megabytes, or gigabytes
-respectively.
+letter
+.Sq p
+to use the size of that partition or can be a number followed
+by
+.Sq k ,
+.Sq m ,
+or
+.Sq g
+to indicate the size in kilobytes, megabytes, or gigabytes respectively.
 (These are powers of 1024, of course, not powers of 1000.)
 The last argument is the name of the partition.
 This can be a single word without quotes, or a string surrounded by
 single or double quotes.
-The type of the created partition is the correct type for MkLinux.
-
+The type of the created partition is the correct type for
+.Nx .
+.Pp
 The
-.B C
+.Ic C
 command is identical to the
-.B c