From owner-svn-src-head@freebsd.org Mon May 14 00:14:43 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 791AFFDC0BF; Mon, 14 May 2018 00:14:43 +0000 (UTC) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id D113473C79; Mon, 14 May 2018 00:14:42 +0000 (UTC) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (localhost [127.0.0.1]) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3) with ESMTP id w4E0Eebs087838; Sun, 13 May 2018 17:14:40 -0700 (PDT) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: (from freebsd@localhost) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3/Submit) id w4E0EeXt087837; Sun, 13 May 2018 17:14:40 -0700 (PDT) (envelope-from freebsd) From: "Rodney W. Grimes" Message-Id: <201805140014.w4E0EeXt087837@pdx.rh.CN85.dnsmgr.net> Subject: Re: svn commit: r333494 - head/share/man/man7 In-Reply-To: To: araujo@freebsd.org Date: Sun, 13 May 2018 17:14:40 -0700 (PDT) CC: "Rodney W. Grimes" , "Conrad E. Meyer" , src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Reply-To: rgrimes@freebsd.org X-Mailer: ELM [version 2.4ME+ PL121h (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII 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: Mon, 14 May 2018 00:14:43 -0000 > On Sat, May 12, 2018, 12:59 AM Rodney W. Grimes < > freebsd@pdx.rh.cn85.dnsmgr.net> wrote: > > > > On Fri, May 11, 2018 at 8:26 AM, Rodney W. Grimes > > > wrote: > > > >> @@ -67,7 +72,8 @@ Changes are first committed to CURRENT and then > > usuall > > > >> 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: > > > > > > What? Are you just inventing these rules out of blue sky? What > > > possible reason is there to do as you have proposed? > > > > Well known and established man page style rules, documented someplace, > > which I can not seem to locate right now. > > > > Could you please find that if possible and share with us? > Personally I'm about to rewrite some man page and that would be useful in > my case! It did take me some time to track down this "crazy concept you all think I just invented", but it is infact in the GNU groff info documentaton (found on my 5.4 systems in /usr/share/info/groff.info.gz): Here are a few hints for preparing text for input to `gtroff'. * First, keep the input lines short. Short input lines are easier to edit, and `gtroff' packs words onto longer lines anyhow. * In keeping with this, it is helpful to begin a new line after every comma or phrase, since common corrections are to add or delete sentences or phrases. * End each sentence with two spaces - or better, start each sentence on a new line. `gtroff' recognizes characters that usually end a sentence, and inserts sentence space accordingly. * Do not hyphenate words at the end of lines - `gtroff' is smart enough to hyphenate words as needed, but is not smart enough to take hyphens out and join a word back together. Also, words such as "mother-in-law" should not be broken over a line, since then a space can occur where not wanted, such as "mother- in-law". Regards, -- Rod Grimes rgrimes@freebsd.org