Re: gpart(8) man page missing list documentation

From: mikej <mikej_at_mikej.com>
Date: Tue, 01 Jul 2014 15:00:29 -0400
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_at_freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-current
> To unsubscribe, send any mail to 
> "freebsd-current-unsubscribe_at_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!
Received on Tue Jul 01 2014 - 17:12:25 UTC

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