From nobody@FreeBSD.org  Tue Jan  8 05:21:14 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id 7D206A4D
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  8 Jan 2013 05:21:14 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 50ABCAF2
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  8 Jan 2013 05:21:14 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id r085LEM8091978
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 8 Jan 2013 05:21:14 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id r085LD5N091974;
	Tue, 8 Jan 2013 05:21:13 GMT
	(envelope-from nobody)
Message-Id: <201301080521.r085LD5N091974@red.freebsd.org>
Date: Tue, 8 Jan 2013 05:21:13 GMT
From: Garrett Cooper <yaneurabeya@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [geom] gpart list/status isn't documented in usage section of gpart(8)
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         175123
>Category:       docs
>Synopsis:       [geom] gpart list/status isn't documented in usage section of gpart(8)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 08 05:30:00 UTC 2013
>Closed-Date:    
>Last-Modified:  Sun Feb 03 22:32:00 UTC 2013
>Originator:     Garrett Cooper
>Release:        9.1-PRERELEASE
>Organization:
EMC Isilon
>Environment:
FreeBSD forza.west.isilon.com 9.1-PRERELEASE FreeBSD 9.1-PRERELEASE #0 r+336aa21: Wed Dec 19 18:05:45 PST 2012     gcooper@forza.west.isilon.com:/usr/obj/usr/src/sys/FORZA  amd64
>Description:
More items are documented in the usage text for gpart(8) than the manpage.

From gpart(8):

     gpart add -t type [-a alignment] [-b start] [-s size] [-i index]
           [-l label] [-f flags] geom
     gpart backup geom
     gpart bootcode [-b bootcode] [-p partcode -i index] [-f flags] geom
     gpart commit geom
     gpart create -s scheme [-n entries] [-f flags] provider
     gpart delete -i index [-f flags] geom
     gpart destroy [-F] [-f flags] geom
     gpart modify -i index [-l label] [-t type] [-f flags] geom
     gpart recover [-f flags] geom
     gpart resize -i index [-a alignment] [-s size] [-f flags] geom
     gpart restore [-lF] [-f flags] provider [...]
     gpart set -a attrib -i index [-f flags] geom
     gpart show [-l | -r] [-p] [geom ...]
     gpart undo geom
     gpart unset -a attrib -i index [-f flags] geom

From gpart --help:

$ gpart list --help
gpart: illegal option -- -
usage: gpart add -t type [-a alignment] [-b start] [-s size] [-i index] [-l label] [-f flags] geom
       gpart backup geom
       gpart bootcode [-b bootcode] [-p partcode -i index] [-f flags] geom
       gpart commit geom
       gpart create -s scheme [-n entries] [-f flags] provider
       gpart delete -i index [-f flags] geom
       gpart destroy [-F] [-f flags] geom
       gpart modify -i index [-l label] [-t type] [-f flags] geom
       gpart set -a attrib -i index [-f flags] geom
       gpart show [-l | -r] [-p] [geom ...]
       gpart undo geom
       gpart unset -a attrib -i index [-f flags] geom
       gpart resize -i index [-a alignment] [-s size] [-f flags] geom
       gpart restore [-lF] [-f flags] provider [...]
       gpart recover [-f flags] geom
       gpart help
       gpart list [-a] [name ...]
       gpart status [-ags] [name ...]
       gpart load [-v]
       gpart unload [-v]
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:

From: "Andrey V. Elsukov" <bu7cher@yandex.ru>
To: Garrett Cooper <yaneurabeya@gmail.com>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/175123: [geom] gpart list/status isn't documented in usage
 section of gpart(8)
Date: Tue, 08 Jan 2013 12:56:15 +0400

 On 08.01.2013 09:21, Garrett Cooper wrote:
 > More items are documented in the usage text for gpart(8) than the manpage.
 
 The rest are documented in the geom(8).
 
 -- 
 WBR, Andrey V. Elsukov

From: Garrett Cooper <yaneurabeya@gmail.com>
To: "Andrey V. Elsukov" <bu7cher@yandex.ru>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/175123: [geom] gpart list/status isn't documented in usage
 section of gpart(8)
Date: Tue, 8 Jan 2013 11:59:55 -0800

 On Tue, Jan 8, 2013 at 12:56 AM, Andrey V. Elsukov <bu7cher@yandex.ru> wrote:
 > On 08.01.2013 09:21, Garrett Cooper wrote:
 >> More items are documented in the usage text for gpart(8) than the manpage.
 >
 > The rest are documented in the geom(8).
 
     Perhaps, but for a newbie (or forgetful people like me ;)..) there
 isn't really a pointer from gpart(8) to geom(8) to note that
 additional subcommands are available and note what the syntax is for
 all of the commands. I would be satisfied with a more explicit pointer
 to geom(8) (other than the SEE ALSO section at the bottom of the
 manpage), as one doesn't exist today.
 Thanks,
 -Garrett
>Unformatted:
