From owner-freebsd-stable@FreeBSD.ORG Tue Jul 1 19:12:25 2014 Return-Path: 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 76617287; Tue, 1 Jul 2014 19:12:25 +0000 (UTC) Received: from mx2.paymentallianceintl.com (mx2.paymentallianceintl.com [216.26.158.171]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "mx2.paymentallianceintl.com", Issuer "Go Daddy Secure Certification Authority" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 21A862493; Tue, 1 Jul 2014 19:12:24 +0000 (UTC) Received: from firewall.mikej.com (162-238-140-44.lightspeed.lsvlky.sbcglobal.net [162.238.140.44]) by mx2.paymentallianceintl.com (8.14.5/8.13.8) with ESMTP id s61J0oB3078552 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Tue, 1 Jul 2014 15:00:51 -0400 (EDT) (envelope-from mikej@mikej.com) Received: from mail.mikej.com (firewall.mikej.com [192.168.6.63]) by firewall.mikej.com (8.14.9/8.14.9) with ESMTP id s61J0Tuj007295; Tue, 1 Jul 2014 15:00:49 -0400 (EDT) (envelope-from mikej@firewall.mikej.com) X-Authentication-Warning: firewall.mikej.com: Host firewall.mikej.com [192.168.6.63] claimed to be mail.mikej.com MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Date: Tue, 01 Jul 2014 15:00:29 -0400 From: mikej To: Warren Block Subject: Re: gpart(8) man page missing list documentation In-Reply-To: References: <6D400FD8-FF1F-42AC-AC54-EA1B5723EF1B@distal.com> Message-ID: <576b495b365440555d7b036765c908ed@mail.mikej.com> X-Sender: mikej@localhost User-Agent: Roundcube Webmail/1.0.1 Cc: freebsd-current@freebsd.org, freebsd-stable@freebsd.org, Chris Ross , owner-freebsd-current@freebsd.org X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Jul 2014 19:12:25 -0000 On 2014-07-01 14:49, Warren Block wrote: > 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. > _______________________________________________ > freebsd-current@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-current > To unsubscribe, send any mail to > "freebsd-current-unsubscribe@freebsd.org" Chris: Just looked at gmirror(8) and geom(8) and I concur that having it listed in the synopsis with a reference in the description would suffice nicely. Thanks!