From owner-freebsd-doc Thu Mar 28 1:43:20 2002 Delivered-To: freebsd-doc@freebsd.org Received: from a96180.upc-a.chello.nl (a96180.upc-a.chello.nl [62.163.96.180]) by hub.freebsd.org (Postfix) with ESMTP id 4C3C737B416 for ; Thu, 28 Mar 2002 01:43:18 -0800 (PST) Received: by a96180.upc-a.chello.nl (Postfix, from userid 1001) id D57762172; Thu, 28 Mar 2002 10:43:16 +0100 (CET) Date: Thu, 28 Mar 2002 10:43:16 +0100 From: Jeroen Ruigrok/asmodai To: Garrett Rooney Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/36350: [PATCH] new mtx_pool.9 man page Message-ID: <20020328094316.GJ13206@daemon.ninth-circle.org> References: <200203270400.g2R405i68109@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200203270400.g2R405i68109@freefall.freebsd.org> User-Agent: Mutt/1.3.28i Organisation: Ninth Circle Enterprises 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 [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. -- Jeroen Ruigrok van der Werven / asmodai / Kita no Mono asmodai@[wxs.nl|xmach.org], finger asmodai@ninth-circle.org http://www.softweyr.com/asmodai/ | http://www.[tendra|xmach].org/ O, what a tangle web we weave, when first we practice to deceive... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message