gpart(8) man page missing list documentation
mikej
mikej at mikej.com
Tue Jul 1 19:12:25 UTC 2014
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!
More information about the freebsd-stable
mailing list