Date: Mon, 18 Nov 2019 12:11:17 -0500 From: Ed Maste <emaste@freebsd.org> To: Mark Johnston <markj@freebsd.org> Cc: 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: <CAPyFy2Dc0mRtxgMVNnzzJXw5A=MRhs7cKk2edAgTQZnAXyLvyQ@mail.gmail.com> In-Reply-To: <20191118204836.GB43295@raichu> References: <201911181905.xAIJ5q6A068355@repo.freebsd.org> <CAOtMX2hBeW67S4-8m8za1kakmk3Ks34KRC7t75Mwbb1upLku8A@mail.gmail.com> <20191118194501.GA43295@raichu> <CAOtMX2hmNUqB%2BXbTC8cLGEkqUjqfzO_fvO91RwWJaeChV=xDng@mail.gmail.com> <20191118203529.GA64688@FreeBSD.org> <20191118204836.GB43295@raichu>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 18 Nov 2019 at 15:48, Mark Johnston <markj@freebsd.org> wrote: > > > 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. My understanding as well. My thinking - if the user last read the man page prior to the .Dd date then they know they have a reason to read it again. On Mon, 18 Nov 2019 at 15:50, Cy Schubert <Cy.Schubert@cschubert.com> wrote: > > Should this be documented in the committers guide? Yes, it probably should. We probably need to provide more guidance on documentation in the committer's guide, but there's already a small bit about man pages in "18.3. Other Suggestions" and we could add this there.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAPyFy2Dc0mRtxgMVNnzzJXw5A=MRhs7cKk2edAgTQZnAXyLvyQ>