From owner-svn-src-head@freebsd.org Fri May 11 18:18:59 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id D2F59FB4979 for ; Fri, 11 May 2018 18:18:59 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from outbound1a.eu.mailhop.org (outbound1a.eu.mailhop.org [52.58.109.202]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 5EFCB6B5A9 for ; Fri, 11 May 2018 18:18:59 +0000 (UTC) (envelope-from ian@freebsd.org) X-MHO-User: beb83ff9-5547-11e8-8e23-5bc9f169c8f5 X-Report-Abuse-To: https://support.duocircle.com/support/solutions/articles/5000540958-duocircle-standard-smtp-abuse-information X-Originating-IP: 67.177.211.60 X-Mail-Handler: DuoCircle Outbound SMTP Received: from ilsoft.org (unknown [67.177.211.60]) by outbound1.eu.mailhop.org (Halon) with ESMTPSA id beb83ff9-5547-11e8-8e23-5bc9f169c8f5; Fri, 11 May 2018 18:18:47 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id w4BIIk1C067511; Fri, 11 May 2018 12:18:46 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: <1526062726.2597.2.camel@freebsd.org> Subject: Re: svn commit: r333494 - head/share/man/man7 From: Ian Lepore To: rgrimes@freebsd.org, Edward Tomasz Napierala Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Date: Fri, 11 May 2018 12:18:46 -0600 In-Reply-To: <201805111526.w4BFQ7N3075963@pdx.rh.CN85.dnsmgr.net> References: <201805111526.w4BFQ7N3075963@pdx.rh.CN85.dnsmgr.net> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.18.5.1 FreeBSD GNOME Team Port Mime-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 May 2018 18:19:00 -0000 On Fri, 2018-05-11 at 08:26 -0700, Rodney W. Grimes wrote: > [ Charset UTF-8 unsupported, converting... ] > > > > Author: trasz > > Date: Fri May 11 15:11:53 2018 > > New Revision: 333494 > > URL: https://svnweb.freebsd.org/changeset/base/333494 > > > > Log: > >   Improve development(7): > >    > >    - Use Fx when referring to FreeBSD. > >    - Use Ql instead of Cm for command invocations. > >    - Remove some redundant Pp macros. > >    - Use a literal indented Bd instead of a series of Dl macros. > >    > >   Submitted by: 0mp@ > >   Reviewed by: eadler@ > >   MFC after: 2 weeks > >   Differential Revision: https://reviews.freebsd.org/D15126 > > > > Modified: > >   head/share/man/man7/development.7 > > > > Modified: head/share/man/man7/development.7 > > =================================================================== > > =========== > > [...] > >  to STABLE. > >  Every few years the CURRENT branch is renamed to STABLE, and a new > >  CURRENT is branched, with an incremented major version number. > > -Releases are then branched off STABLE and numbered with > > consecutive minor numbers. > > +Releases are then branched off STABLE and numbered with > > consecutive minor > > +numbers. > Proper place to line break long lines is at conjuncatives such > as the "and" above, yeilding: > Releases are then branched off STABLE > and numbered with consecutive minor numbers. > The last thing we need is more stupid arbitrary rules that discourage people from writing manpages. This commit deserves praise, not pointless nitpicking. -- Ian