From owner-freebsd-stable@FreeBSD.ORG  Tue Jul  1 18:49:48 2014
Return-Path: <owner-freebsd-stable@FreeBSD.ORG>
Delivered-To: freebsd-stable@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 6126CFEA;
 Tue,  1 Jul 2014 18:49:48 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 1087D21B3;
 Tue,  1 Jul 2014 18:49:47 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.9/8.14.9) with ESMTP id s61InW2b080273
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Tue, 1 Jul 2014 12:49:32 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id s61InWtU080270;
 Tue, 1 Jul 2014 12:49:32 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Tue, 1 Jul 2014 12:49:32 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Chris Ross <cross+freebsd@distal.com>
Subject: Re: gpart(8) man page missing list documentation
In-Reply-To: <6D400FD8-FF1F-42AC-AC54-EA1B5723EF1B@distal.com>
Message-ID: <alpine.BSF.2.11.1407011245080.79495@wonkity.com>
References: <6D400FD8-FF1F-42AC-AC54-EA1B5723EF1B@distal.com>
User-Agent: Alpine 2.11 (BSF 23 2013-08-11)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Tue, 01 Jul 2014 12:49:32 -0600 (MDT)
Cc: freebsd-current@freebsd.org, freebsd-stable@freebsd.org
X-BeenThere: freebsd-stable@freebsd.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: Production branch of FreeBSD source code <freebsd-stable.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-stable>,
 <mailto:freebsd-stable-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-stable/>
List-Post: <mailto:freebsd-stable@freebsd.org>
List-Help: <mailto:freebsd-stable-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-stable>,
 <mailto:freebsd-stable-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 01 Jul 2014 18:49:48 -0000

On Tue, 1 Jul 2014, Chris Ross wrote:

>
>  Looking at the man page for gpart(8) on a recent 10-stable system, I was trying to find out what the -a option to list does.  (shown in the output of gpart when run with no parameters).  Interestingly, despite ?list? being highlighted in paragraph text as an action for the command, it does not appear in the summary at the top of the page, nor in the detailed DESCRIPTION section that describes each of the actions.
>
>  This appears to still be the case on HEAD, as well.  I assume this is worth fixing and MFC?ing?

A PR was just entered for that: 
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=191534

"list" and "status" and a couple of others that only apply for some GEOM 
modules (load, unload) are part of the base GEOM command set.  I was 
going to say we should just refer the reader to another page, maybe 
geom(8).

But gmirror(8) does include those commands in the synopsis.  We should 
be consistent with this, and I'd lean toward doing it the way gmirror(8) 
does now.