1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-09 09:40:42 +00:00

mdoc(7) police: misc formatting fixes.

(This page still needs a lot of work.)
This commit is contained in:
Ruslan Ermilov 2001-03-05 15:33:54 +00:00
parent 1530a45dfb
commit 7733674e31
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=73755
2 changed files with 100 additions and 56 deletions

View File

@ -235,7 +235,9 @@ itself must be provided as the canonical name, i.e. not as a full
path name.
.Pp
For most harddisks, a label based on percentages for most partitions (and
one partition with a size of '*') will produce a reasonable configuration.
one partition with a size of
.Ql * )
will produce a reasonable configuration.
.Pp
PC-based systems have special requirements in order for the BIOS to properly
recognize a
@ -569,7 +571,9 @@ specifies that the drive can perform bad sector remapping.
.It Nm sectors/unit
describes the total size of the disk. This value must be correct.
.It Nm the partition table
This is the UNIX partition table, not the Microsoft partition table described in
This is the
.Ux
partition table, not the Microsoft partition table described in
.Xr fdisk 8 .
.El
.Pp
@ -578,28 +582,35 @@ information:
.Bl -hang -width 10n
.It identifier
The partition identifier is a single letter in the range
.Nm a
.Dq a
to
.Nm h .
.Dq h .
By convention, partition
.Nm c
.Dq c
is reserved to describe the entire disk.
.It size
is the size of the partition in sectors,
.Nm K
.Cm K
(kilobytes - 1024),
.Nm M
.Cm M
(megabytes - 1024*1024),
.Nm G
.Cm G
(gigabytes - 1024*1024*1024),
.Nm %
.Cm %
(percentage of free space AFTER removing any fixed-size partitions other
than partition
.Nm c
), or * (all remaining free space AFTER fixed-size and percentage
.Dq c) ,
or
.Cm *
(all remaining free space AFTER fixed-size and percentage
partitions). For partition
.Nm c ,
a size of * indicates the entire disk. Lowercase versions of K, M, and G
.Dq c ,
a size of
.Cm *
indicates the entire disk. Lowercase versions of
.Cm K , M ,
and
.Cm G
are allowed.
Size and type should be specifed without any spaces between them.
.Pp
@ -607,38 +618,41 @@ Example: 2097152, 1g, 1024m and 1048576k are all the same size
(assuming 512-byte sectors).
.It offset
is the offset of the start of the partition from the beginning of the
drive in sectors, or * to have
drive in sectors, or
.Cm *
to have
.Nm
calculate the correct offset to use (the end of the previous partition plus
one, ignoring partition
.Nm c .
.Dq c .
For partition
.Nm c ,
* will be interpreted as an offset of 0.
.Dq c ,
.Cm *
will be interpreted as an offset of 0.
.It fstype
describes the purpose of the partition. The example shows most normal usages.
For UFS file systems, use type
.Nm 4.2BSD .
.Cm 4.2BSD .
Other common types are
.Nm unused
.Cm unused
and
.Nm swap .
.Cm swap .
See
.Pa /usr/include/sys/disklabel.h
for a complete list.
.It fsize
For
.Nm 4.2BSD
.Cm 4.2BSD
and LFS file systems only, the fragment size. Defaults to 8192 for
partitions smaller than 1 GB, 16384 for partitions 1GB or larger.
.It bsize
For
.Nm 4.2BSD
.Cm 4.2BSD
and LFS file systems only, the block size. Defaults to 1024 for
partitions smaller than 1 GB, 4096 for partitions 1GB or larger.
.It bps/cpg
For
.Nm 4.2BSD
.Cm 4.2BSD
file systems, the number of cylinders in a cylinder group. For LFS file
systems, the segment shift value. Defaults to 16 for
partitions smaller than 1 GB, 64 for partitions 1GB or larger.
@ -719,7 +733,11 @@ Display what the label would be for
using the partition layout in
.Pa label_layout .
This is useful for determining how much space would be alloted for various
partitions with a labelling scheme using %-based or * partition sizes.
partitions with a labelling scheme using
.Cm % Ns -based
or
.Cm *
partition sizes.
.Pp
.Dl disklabel -B da0s1
.Pp
@ -758,7 +776,11 @@ commands are optional, but may be necessary for some BIOSes to properly
recognize the disk.
.Pp
This is an example disklabel that uses some of the new partition size types
such as %, M, G, and *, which could be used as a source file for
such as
.Cm % , M , G ,
and
.Cm * ,
which could be used as a source file for
.Pp
.Dl disklabel -R ad0s1c new_label_file
.Bd -literal -offset 4n
@ -853,8 +875,8 @@ starts at absolute block 0 on the disk.
.Pp
.Nm
does not perform all possible error checking. Warning *is* given if partitions
overlap; if an absolute offset doesn't match the expected offset; if the
.Nm c
partition doesn't start at 0 or doesn't cover the entire slice; if a
overlap; if an absolute offset does not match the expected offset; if the
.Dq c
partition does not start at 0 or does not cover the entire slice; if a
partition runs past the end of the device; and a number of other errors; but
no warning is given if space remains unused.

View File

@ -235,7 +235,9 @@ itself must be provided as the canonical name, i.e. not as a full
path name.
.Pp
For most harddisks, a label based on percentages for most partitions (and
one partition with a size of '*') will produce a reasonable configuration.
one partition with a size of
.Ql * )
will produce a reasonable configuration.
.Pp
PC-based systems have special requirements in order for the BIOS to properly
recognize a
@ -569,7 +571,9 @@ specifies that the drive can perform bad sector remapping.
.It Nm sectors/unit
describes the total size of the disk. This value must be correct.
.It Nm the partition table
This is the UNIX partition table, not the Microsoft partition table described in
This is the
.Ux
partition table, not the Microsoft partition table described in
.Xr fdisk 8 .
.El
.Pp
@ -578,28 +582,35 @@ information:
.Bl -hang -width 10n
.It identifier
The partition identifier is a single letter in the range
.Nm a
.Dq a
to
.Nm h .
.Dq h .
By convention, partition
.Nm c
.Dq c
is reserved to describe the entire disk.
.It size
is the size of the partition in sectors,
.Nm K
.Cm K
(kilobytes - 1024),
.Nm M
.Cm M
(megabytes - 1024*1024),
.Nm G
.Cm G
(gigabytes - 1024*1024*1024),
.Nm %
.Cm %
(percentage of free space AFTER removing any fixed-size partitions other
than partition
.Nm c
), or * (all remaining free space AFTER fixed-size and percentage
.Dq c) ,
or
.Cm *
(all remaining free space AFTER fixed-size and percentage
partitions). For partition
.Nm c ,
a size of * indicates the entire disk. Lowercase versions of K, M, and G
.Dq c ,
a size of
.Cm *
indicates the entire disk. Lowercase versions of
.Cm K , M ,
and
.Cm G
are allowed.
Size and type should be specifed without any spaces between them.
.Pp
@ -607,38 +618,41 @@ Example: 2097152, 1g, 1024m and 1048576k are all the same size
(assuming 512-byte sectors).
.It offset
is the offset of the start of the partition from the beginning of the
drive in sectors, or * to have
drive in sectors, or
.Cm *
to have
.Nm
calculate the correct offset to use (the end of the previous partition plus
one, ignoring partition
.Nm c .
.Dq c .
For partition
.Nm c ,
* will be interpreted as an offset of 0.
.Dq c ,
.Cm *
will be interpreted as an offset of 0.
.It fstype
describes the purpose of the partition. The example shows most normal usages.
For UFS file systems, use type
.Nm 4.2BSD .
.Cm 4.2BSD .
Other common types are
.Nm unused
.Cm unused
and
.Nm swap .
.Cm swap .
See
.Pa /usr/include/sys/disklabel.h
for a complete list.
.It fsize
For
.Nm 4.2BSD
.Cm 4.2BSD
and LFS file systems only, the fragment size. Defaults to 8192 for
partitions smaller than 1 GB, 16384 for partitions 1GB or larger.
.It bsize
For
.Nm 4.2BSD
.Cm 4.2BSD
and LFS file systems only, the block size. Defaults to 1024 for
partitions smaller than 1 GB, 4096 for partitions 1GB or larger.
.It bps/cpg
For
.Nm 4.2BSD
.Cm 4.2BSD
file systems, the number of cylinders in a cylinder group. For LFS file
systems, the segment shift value. Defaults to 16 for
partitions smaller than 1 GB, 64 for partitions 1GB or larger.
@ -719,7 +733,11 @@ Display what the label would be for
using the partition layout in
.Pa label_layout .
This is useful for determining how much space would be alloted for various
partitions with a labelling scheme using %-based or * partition sizes.
partitions with a labelling scheme using
.Cm % Ns -based
or
.Cm *
partition sizes.
.Pp
.Dl disklabel -B da0s1
.Pp
@ -758,7 +776,11 @@ commands are optional, but may be necessary for some BIOSes to properly
recognize the disk.
.Pp
This is an example disklabel that uses some of the new partition size types
such as %, M, G, and *, which could be used as a source file for
such as
.Cm % , M , G ,
and
.Cm * ,
which could be used as a source file for
.Pp
.Dl disklabel -R ad0s1c new_label_file
.Bd -literal -offset 4n
@ -853,8 +875,8 @@ starts at absolute block 0 on the disk.
.Pp
.Nm
does not perform all possible error checking. Warning *is* given if partitions
overlap; if an absolute offset doesn't match the expected offset; if the
.Nm c
partition doesn't start at 0 or doesn't cover the entire slice; if a
overlap; if an absolute offset does not match the expected offset; if the
.Dq c
partition does not start at 0 or does not cover the entire slice; if a
partition runs past the end of the device; and a number of other errors; but
no warning is given if space remains unused.