From owner-freebsd-doc Thu Mar 28 4:19:44 2002 Delivered-To: freebsd-doc@freebsd.org Received: from isris.pair.com (isris.pair.com [209.68.2.39]) by hub.freebsd.org (Postfix) with SMTP id AC60237B400 for ; Thu, 28 Mar 2002 04:19:41 -0800 (PST) Received: (qmail 90771 invoked by uid 3130); 28 Mar 2002 12:19:40 -0000 Date: Thu, 28 Mar 2002 07:19:40 -0500 From: Garrett Rooney To: Jeroen Ruigrok/asmodai Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/36350: [PATCH] new mtx_pool.9 man page Message-ID: <20020328121940.GC13351@electricjellyfish.net> References: <200203270400.g2R405i68109@freefall.freebsd.org> <20020328094316.GJ13206@daemon.ninth-circle.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020328094316.GJ13206@daemon.ninth-circle.org> User-Agent: Mutt/1.3.25i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Thu, Mar 28, 2002 at 10:43:16AM +0100, Jeroen Ruigrok/asmodai wrote: > -On [20020327 05:15], Garrett Rooney (rooneg@electricjellyfish.net) wrote: > > btw, Dima, if you could just let me know what kind of markup errors > > you find, that would be great. i'm fairly new at writing man pages, > > and any tips on things to avoid in the future would be much > > appreciated. > > Hard sentence break for example. > > We break sentences at the commas or other logical position in the sentence > so that, when we next touch/rewrite a manual page, we can easily alter the > flow of the sentences without obfuscating the diffs much. ahh, so that's the reason. i had noticed that being done at the end of sentences, and wondered why, so now it makes much more sense. thanks, -garrett -- garrett rooney Unix was not designed to stop you from rooneg@electricjellyfish.net doing stupid things, because that would http://electricjellyfish.net/ stop you from doing clever things. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message