[src/trunk]: src/sbin/fdisk Clarify description of -f and -u options.

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

details:   https://anonhg.NetBSD.org/src/rev/d5a3b8bce9d8
branches:  trunk
changeset: 749389:d5a3b8bce9d8
user:      tsutsui <tsutsui%NetBSD.org@localhost>
date:      Sat Nov 28 16:45:20 2009 +0000

description:
Clarify description of -f and -u options.
(-u means updating partition data, not interactive mode)

diffstat:

 sbin/fdisk/fdisk.8 |  68 +++++++++++++++++++++++++++++++----------------------
 1 files changed, 40 insertions(+), 28 deletions(-)

diffs (124 lines):

diff -r 992a52d1bdd8 -r d5a3b8bce9d8 sbin/fdisk/fdisk.8
--- a/sbin/fdisk/fdisk.8        Sat Nov 28 13:53:28 2009 +0000
+++ b/sbin/fdisk/fdisk.8        Sat Nov 28 16:45:20 2009 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: fdisk.8,v 1.63 2009/10/14 22:00:55 joerg Exp $
+.\"    $NetBSD: fdisk.8,v 1.64 2009/11/28 16:45:20 tsutsui Exp $
 .\"
-.Dd August 10, 2009
+.Dd November 28, 2009
 .Dt FDISK 8
 .Os
 .Sh NAME
@@ -155,13 +155,13 @@
 .Pp
 .Bl -tag -width Ds
 .It Fl 0
-Update partition slot 0.
+Specify partition slot 0 to be printed or updated.
 .It Fl 1
-Update partition slot 1.
+Specify partition slot 1 to be printed or updated.
 .It Fl 2
-Update partition slot 2.
+Specify partition slot 2 to be printed or updated.
 .It Fl 3
-Update partition slot 3.
+Specify partition slot 3 to be printed or updated.
 .It Fl a
 Change the active partition.
 In interactive mode this question will be asked after the partitions
@@ -200,10 +200,11 @@
 on an i386 machine, and leave the bootcode empty for other
 machines.
 .It Fl E Ar number
-Update extended partition
-.Ar number .
-If the specified extended partition doesn't exist an additional extended
-partition will be created.
+Specify extended partition
+.Ar number
+to be printed or updated.
+If the specified extended partition doesn't exist on updating partition data
+an additional extended partition will be created.
 .It Fl f
 Run
 .Nm
@@ -224,16 +225,9 @@
 .Ar head ,
 and
 .Ar sector
-fields.
+fields
+.Pq only Ar start No and Ar size No can be specified by Fl s No option .
 They will be automatically computed using the BIOS geometry.
-.Pp
-If
-.Fl u
-and
-.Fl s
-are specified then the details of the specified partition will be changed.
-Any other partitions which overlap the requested part of the disk will be
-silently deleted.
 .It Fl F
 Indicate that
 .Ar device
@@ -274,14 +268,7 @@
 and optionally
 .Ar bootmenu .
 This flag requires the use of a partition selection flag
-.Po
-.Fl 0 ,
-.Fl 1 ,
-.Fl 2 ,
-.Fl 3 ,
-or
-.Fl E Ar number
-.Pc
+.Pq Fl 0 , 1 , 2 , 3 , No or Fl E Ar number .
 .It Fl S
 When used with no other flags print a series of
 .Pa /bin/sh
@@ -300,7 +287,15 @@
 instead of the disklabel on
 .Ar device .
 .It Fl u
-Display the partitions and interactively ask which one you want to edit.
+Update partition data, including
+.Em id , start , No and Em size .
+Unless
+.Fl f
+option
+.Pq non-interactive mode
+is specified,
+.Nm
+will display the partitions and interactively ask which one you want to edit.
 .Nm
 will step through each field showing the old value and asking for a new one.
 The
@@ -316,8 +311,25 @@
 .Em $
 in which case the partition will extend to the end of the available free space.
 .Pp
+In a non-interactive mode
+.Pq specified by Fl f No option ,
+partition data should be specified by
+.Fl s
+option.
+A partition selection option
+.Pq Fl 0 , 1 , 2 , 3 , No or Fl E Ar number
+should also be specified to select a partition slot to be updated.
+.Pp
 .Nm
 will not allow you to create partitions which overlap.
+If
+.Fl u
+and
+.Fl s
+are specified in a non-interactive mode
+then the details of the specified partition will be changed.
+Any other partitions which overlap the requested part of the disk will be
+silently deleted.
 .Pp
 If
 .Em bootmenu