Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 18 Nov 2019 15:30:38 -0800 (PST)
From:      "Rodney W. Grimes" <freebsd@gndrsh.dnsmgr.net>
To:        Cy Schubert <Cy.Schubert@cschubert.com>
Cc:        Mark Johnston <markj@freebsd.org>, Alexey Dokuchaev <danfe@freebsd.org>, Alan Somers <asomers@freebsd.org>, svn-src-head <svn-src-head@freebsd.org>, svn-src-all <svn-src-all@freebsd.org>, src-committers <src-committers@freebsd.org>
Subject:   Re: svn commit: r354824 - head/lib/geom/part
Message-ID:  <201911182330.xAINUcUJ068636@gndrsh.dnsmgr.net>
In-Reply-To: <201911182050.xAIKoX32000661@slippy.cwsent.com>

next in thread | previous in thread | raw e-mail | index | archive | help
> In message <20191118204836.GB43295@raichu>, Mark Johnston writes:
> > On Mon, Nov 18, 2019 at 08:35:30PM +0000, Alexey Dokuchaev wrote:
> > > On Mon, Nov 18, 2019 at 01:09:19PM -0700, Alan Somers wrote:
> > > > On Mon, Nov 18, 2019 at 12:48 PM Mark Johnston <markj@freebsd.org> wrote:
> > > > > On Mon, Nov 18, 2019 at 12:43:48PM -0700, Alan Somers wrote:
> > > > > > On Mon, Nov 18, 2019 at 12:06 PM Mark Johnston <markj@freebsd.org>
> > > > > wrote:
> > > > > >
> > > > > > > Author: markj
> > > > > > > Date: Mon Nov 18 19:05:52 2019
> > > > > > > New Revision: 354824
> > > > > > > URL: https://svnweb.freebsd.org/changeset/base/354824
> > > > > > >
> > > > > > > Log:
> > > > > > >   Fix grammar in gpart.8.
> > > > > > >
> > > > > > >   PR:           241973
> > > > > > >   MFC after:    3 days
> > > > > > >
> > > > > > > Modified:
> > > > > > >   head/lib/geom/part/gpart.8
> > > > > >
> > > > > > Don't forget to bump the .Dd date.
> > > > >
> > > > > AFAIK we do not bump .Dd for such changes, only for content changes.
> > > > 
> > > > Isn't that a content change?  I thought anything displayed to the user
> > > > counts as a content change?
> > > 
> > > I presume that "content" means more like semantic, functional changes
> > > that affect some particular meaning.  Grammar fixes are just, well,
> > > grammar fixes and thus do not warrant .Dd bump.
> >
> > Indeed, this was always my understanding as well.  I can't find a
> > concrete definition anywhere.  I don't understand why it would be useful
> > as a user to see the date of the last "content change" if such changes
> > might consist only of a small formatting change or typo fix.
> >
> 
> Should this be documented in the committers guide?

This should be documented someplace,
that place probably being where bumping of .Dd is documented as a minimum.

> Cy Schubert <Cy.Schubert@cschubert.com>
-- 
Rod Grimes                                                 rgrimes@freebsd.org



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201911182330.xAINUcUJ068636>