From owner-freebsd-doc Wed Oct 9 2:33:41 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6F3A237B401; Wed, 9 Oct 2002 02:33:39 -0700 (PDT) Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12FCF43E6A; Wed, 9 Oct 2002 02:33:38 -0700 (PDT) (envelope-from vincent@sumuk.de) Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1]) by Kain.sumuk.de (8.12.5/8.12.5) with ESMTP id g999Xajv039747; Wed, 9 Oct 2002 11:33:36 +0200 (CEST) (envelope-from vincent@sumuk.de) Received: from Moses.earth.sol (localhost.earth.sol [127.0.0.1]) by Moses.earth.sol (8.12.5/8.12.5) with ESMTP id g999XYLS086070; Wed, 9 Oct 2002 11:33:35 +0200 (CEST) (envelope-from vincent@Moses.earth.sol) Received: (from vincent@localhost) by Moses.earth.sol (8.12.5/8.12.5/Submit) id g999XYbo086069; Wed, 9 Oct 2002 11:33:34 +0200 (CEST) Date: Wed, 9 Oct 2002 11:33:33 +0200 From: Martin Heinen To: Murray Stokely Cc: martin@sumuk.de, freebsd-doc@FreeBSD.org Subject: Re: docs/41546: [PATCH] adding non-breaking spaces to the handbook Message-ID: <20021009113333.B86009@sumuk.de> References: <200210010916.g919GafL015248@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200210010916.g919GafL015248@freefall.freebsd.org>; from murray@FreeBSD.org on Tue, Oct 01, 2002 at 02:16:36AM -0700 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 Tue, Oct 01, 2002 at 02:16:36AM -0700, Murray Stokely wrote: > Synopsis: [PATCH] adding non-breaking spaces to the handbook > This is great work, thanks! I've committed your huge patch. Do you > think you could update the Doc Project Primer so that other new doc > authors remember to use non-breaking spaces in the appropriate places? > I don't recall if this is covered in the primer. How about the following patch? *** Index: writing-style/chapter.sgml =================================================================== RCS file: /u/cvs/doc/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml,v retrieving revision 1.30 diff -u -r1.30 chapter.sgml --- writing-style/chapter.sgml 31 Aug 2002 20:14:13 -0000 1.30 +++ writing-style/chapter.sgml 9 Oct 2002 09:10:22 -0000 @@ -314,6 +314,35 @@ the second change, be sure to indicate that this is a whitespace-only change, and that the translation team can ignore it. + + + Nonbreaking space + + Avoid line breaks in places where they look ugly + or make it difficult to follow a sentence. Line breaks depend + on the width of the chosen output medium. In particular, viewing + the HTML documentation with a text browser can lead to badly + formatted paragraphs like the next one: + + Data capacity ranges from 40 MB to 15 +GB. Hardware compression … + + The general entity &nbsp; prohibits + line breaks between parts belonging together. Use nonbreaking + spaces in the following places: + + + + between numbers and units: + + + + + between program names and version numbers: + + + + *** -- Marxpitn To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message