From e780f220d844b1b3cc0a9bd1b5e0d769a702b111 Mon Sep 17 00:00:00 2001
From: ru <ru@FreeBSD.org>
Date: Tue, 12 Dec 2006 15:26:25 +0000
Subject: - Document -u, -i, and the difference between them better. - Remove
 some historical notes about "future" decisions.

---
 sbin/fdisk/fdisk.8 | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

(limited to 'sbin/fdisk')

diff --git a/sbin/fdisk/fdisk.8 b/sbin/fdisk/fdisk.8
index d99e109..78eafa7 100644
--- a/sbin/fdisk/fdisk.8
+++ b/sbin/fdisk/fdisk.8
@@ -1,6 +1,6 @@
 .\" $FreeBSD$
 .\"
-.Dd December 9, 2006
+.Dd December 12, 2006
 .Dt FDISK 8
 .Os
 .Sh NAME
@@ -75,7 +75,7 @@ Set slice values using the file
 .Ar configfile .
 The
 .Ar configfile
-always modifies existing slices, unless
+only modifies explicitly specified slices, unless
 .Fl i
 is also given, in which case all existing slices are deleted (marked
 as
@@ -100,13 +100,12 @@ table (as you are in the interactive mode).
 Use with caution!
 .It Fl i
 Initialize sector 0 of the disk.
-This implies
-.Fl u ,
-unless
-.Fl f
-is given.
+Existing slice entries will be cleared
+(marked as unused) before editing.
+(Compare with
+.Fl u . )
 .It Fl I
-Initialize the contents of sector 0
+Initialize sector 0 slice table
 for one
 .Fx
 slice covering the entire disk.
@@ -120,7 +119,7 @@ option to see what would be written to the slice table.
 Implies
 .Fl v .
 .It Fl u
-Is used for updating (editing) sector 0 of the disk.
+Update (edit) the disk's sector 0 slice table.
 Ignored if
 .Fl f
 is given.
@@ -257,13 +256,15 @@ and
 flags is that
 the
 .Fl u
-flag just edits (updates) the fields as they appear on the disk,
+flag edits (updates) the existing slice parameters
 while the
 .Fl i
 flag is used to
 .Dq initialize
-sector 0;
-it will set up the first BIOS slice to use the whole disk for
+them (old values will be ignored);
+if you edit the first slice,
+.Fl i
+will also set it up to use the whole disk for
 .Fx
 and make it active.
 .Sh NOTES
@@ -281,8 +282,6 @@ If you hand craft your disk layout,
 please make sure that the
 .Fx
 slice starts on a cylinder boundary.
-A number of decisions made later may assume this.
-(This might not be necessary later.)
 .Pp
 Editing an existing slice will most likely result in the loss of
 all data in that slice.
@@ -413,7 +412,6 @@ for 2503871 sectors (note: these numbers will be rounded upwards and
 downwards to correspond to head and cylinder boundaries):
 .Pp
 .Dl "p       1       165     1       2503871"
-.Pp
 .It Ic a Ar slice
 Make
 .Ar slice
-- 
cgit v1.1