svn commit: r354824 - head/lib/geom/part

Ed Maste emaste at freebsd.org
Mon Nov 18 20:57:59 UTC 2019


On Mon, 18 Nov 2019 at 15:48, Mark Johnston <markj at 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 at 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.


More information about the svn-src-head mailing list