Re: gpart(8) man page missing list documentation

From: Warren Block <wblock_at_wonkity.com>
Date: Tue, 1 Jul 2014 12:49:32 -0600 (MDT)
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.
Received on Tue Jul 01 2014 - 16:49:48 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:40:50 UTC