From owner-cvs-all Wed Mar 1 12:39:39 2000 Delivered-To: cvs-all@freebsd.org Received: from alcanet.com.au (mail.alcanet.com.au [203.62.196.10]) by hub.freebsd.org (Postfix) with ESMTP id B48BC37BA61 for ; Wed, 1 Mar 2000 12:39:35 -0800 (PST) (envelope-from jeremyp@gsmx07.alcatel.com.au) Received: by border.alcanet.com.au id <115221>; Thu, 2 Mar 2000 07:40:08 +1100 Content-return: prohibited From: Peter Jeremy Subject: Re: cvs commit: src/bin/dd dd.1 In-reply-to: <200003011603.e21G3hJ84176@nimitz.ca.sandia.gov>; from bmah@CA.Sandia.GOV on Thu, Mar 02, 2000 at 03:06:21AM +1100 To: "Bruce A. Mah" Cc: cvs-all@FreeBSD.ORG Message-Id: <00Mar2.074008est.115221@border.alcanet.com.au> MIME-version: 1.0 X-Mailer: Mutt 1.0i Content-type: text/plain; charset=us-ascii References: <73922.951896978@axl.ops.uunet.co.za> <200003011603.e21G3hJ84176@nimitz.ca.sandia.gov> Date: Thu, 2 Mar 2000 07:40:05 +1100 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk On 2000-Mar-02 03:06:21 +1100, "Bruce A. Mah" wrote: >If memory serves me right, Sheldon Hearn wrote: >> We should put something about this in the committers guide. ... >Ummm, and for us lowly non-committers, who can only file PRs? :-) The `committers guide' is part of the doc subtree (look in .../doc/en_US.ISO_8859-1/articles/committers-guide/ - it doesn't appear to have been translated anywhere else). There's nothing to stop anyone reading it. (Which makes sense - aspiring committers can learn what they're in for :-). >From your subsequent commits, it seems to me that we want newlines in >the groff source at the ends of sentences, and that having a sentence >break in the middle of a line of groff source is bad. Is that right? That's the general idea. Traditionally, troff sees various punctuation ('.', '?' and '!') as sentence terminators when they occur at the end of the line. This causes it to insert (I think) 1em instead of 1en whitespace. I presume groff works the same way (though I can't see where the ENDS_SENTENCE flag, with or without a following newline, changes the spacing). Since '.' means end-of-sentence only when it occurs at the end of the line, this prevents it incorrectly adding an inter-sentence gap following a contraction (eg Mr.). The other guideline I've seen (back when I first started using troff), was to insert linebreaks at the end of clauses, and keep lines fairly short. This tends to minimise the number of lines affected by a change. This writing style is significantly different to that used in (eg) the GNU texinfo documentation. Peter To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message