svn commit: r267357 - head/sys/geom/part

[John-Mark Gurney]

Andrey V. Elsukov wrote this message on Thu, Jun 12, 2014 at 11:04 +0400:
> On 11.06.2014 17:48, Dmitry Morozovsky wrote:
> > On Wed, 11 Jun 2014, Andrey V. Elsukov wrote:
> > 
> >> Author: ae
> >> Date: Wed Jun 11 10:19:11 2014
> >> New Revision: 267357
> >> URL: http://svnweb.freebsd.org/changeset/base/267357
> >>
> >> Log:
> >>   Add aliases for DragonFlyBSD's partition types.
> > 
> > These should be documented in sbin/geom/class/part/gpart.8 also.
> 
> I don't think we should document partition types for all foreign
> systems. gpart(8) exists only in FreeBSD and it's purpose manage
> partitions in FreeBSD. We already have a lot of NetBSD's and Apple's
> aliases that aren't documented, but nobody complained about that.

I did...  The problem is it's hard for users to complain about stuff
not being documented when they don't know to complain about it...

I sent direct email to the authors who committed the undocumented work,
and one of them (Thanks Dmitry!) did spend the time to fix it...

> In this case it is mostly cosmetic change. It allows to see aliases in
> the `gpart show` output. Having a lot of partition types documented can
> confuse users. IMHO. :)

If the user gets confused by this, they probably shouldn't be using
the command, or at least reading other docs for help on using them...

-- 
  John-Mark Gurney				Voice: +1 415 225 5579

     "All that I will do, has been done, All that I have, has not."