[src/trunk]: src/sbin/dkctl add notes what 'device' is and also rub in that a...

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

details:   https://anonhg.NetBSD.org/src/rev/df058ae3a1ce
branches:  trunk
changeset: 760430:df058ae3a1ce
user:      spz <spz%NetBSD.org@localhost>
date:      Tue Jan 04 21:42:10 2011 +0000

description:
add notes what 'device' is and also rub in that addwedge doesn't
create stuff on disk a bit more.

diffstat:

 sbin/dkctl/dkctl.8 |  11 ++++++++++-
 1 files changed, 10 insertions(+), 1 deletions(-)

diffs (39 lines):

diff -r cd1e9944d2e9 -r df058ae3a1ce sbin/dkctl/dkctl.8
--- a/sbin/dkctl/dkctl.8        Tue Jan 04 20:52:53 2011 +0000
+++ b/sbin/dkctl/dkctl.8        Tue Jan 04 21:42:10 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dkctl.8,v 1.21 2010/05/18 23:33:03 wiz Exp $
+.\"    $NetBSD: dkctl.8,v 1.22 2011/01/04 21:42:10 spz Exp $
 .\"
 .\" Copyright 2002 Wasabi Systems, Inc.
 .\" All rights reserved.
@@ -52,6 +52,8 @@
 in various ways.
 It is used by specifying a disk to manipulate, the command
 to perform, and any arguments the command may require.
+.Ar device
+is the disk (wdN, sdN, ...) containing the wedges unless noted otherwise.
 If
 .Nm
 is called without any command, it displays strategy, cache, and all of
@@ -120,6 +122,11 @@
 and spanning
 .Ar blkcnt
 blocks.
+You need to create the partition first with
+.Xr fdisk 8
+or
+.Xr gpt 8 ,
+dkctl will just name it.
 The wedge will have the volume name
 .Ar name
 and the partition type
@@ -153,6 +160,8 @@
 from the specified disk.
 .It Ic getwedgeinfo
 Display information about the specified disk wedge.
+.Ar device
+in this case is the wedge name.
 .It Ic listwedges
 List all of the wedges configured on the specified disk.
 .It Ic strategy Op Ar name