From owner-freebsd-doc  Wed Oct  9  6:46:51 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 730EA37B404
	for <freebsd-doc@freebsd.org>; Wed,  9 Oct 2002 06:46:49 -0700 (PDT)
Received: from merkury.pol.lublin.pl (merkury.pol.lublin.pl [212.182.59.190])
	by mx1.FreeBSD.org (Postfix) with SMTP id 4E7B243E3B
	for <freebsd-doc@freebsd.org>; Wed,  9 Oct 2002 06:46:48 -0700 (PDT)
	(envelope-from ni@merkury.pol.lublin.pl)
Received: (qmail 1746 invoked by uid 9999); 9 Oct 2002 13:46:42 -0000
Date: Wed, 9 Oct 2002 15:46:42 +0200
From: Lukasz Bojarski <ni@merkury.pol.lublin.pl>
To: freebsd-doc@freebsd.org
Subject: Re: docs/41546: [PATCH] adding non-breaking spaces to the handbook
Message-ID: <20021009154642.A1703@merkury.pol.lublin.pl>
References: <200210010916.g919GafL015248@freefall.freebsd.org> <20021009113333.B86009@sumuk.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20021009113333.B86009@sumuk.de>; from martin@sumuk.de on Wed, Oct 09, 2002 at 11:33:33AM +0200
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

> 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.</para>
>      </sect2>
> +
> +    <sect2>
> +      <title>Nonbreaking space</title>
> +
> +      <para>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:</para>
> +
> +      <literallayout class="monospaced">Data capacity ranges from 40 MB to 15
> +GB.  Hardware compression &hellip;</literallayout>
> +
> +      <para>The general entity <literal>&amp;nbsp;</literal> prohibits
> +	line breaks between parts belonging together.  Use nonbreaking
> +	spaces in the following places:</para>
> +
> +      <itemizedlist>
> +	<listitem>
> +	  <para>between numbers and units:</para>
> +	  <programlisting><![ CDATA [57600&nbsp;bps]]></programlisting>
> +	</listitem>
> +
> +	<listitem>
> +	  <para>between program names and version numbers:</para>
> +	  <programlisting><![ CDATA [FreeBSD&nbsp;4.7]]></programlisting>
> +	</listitem>

Also IMHO:

+	<listitem>
+	  <para>between first and last name:</para>
+	  <programlisting><![ CDATA [John&nbsp;Smith]]></programlisting>
+	</listitem>
+
+	<listitem>
+	  <para>between multiword names (use with caution when applying this
+	  to more than 3-4 word names like 
+	  "The FreeBSD Brazilian Portuguese Documentation Project"):</para>
+	  <programlisting><![ CDATA [Sun&nbsp;Microsystems]]></programlisting>
+	</listitem>

> +      </itemizedlist>
> +    </sect2>
>    </sect1>
>  
>    <sect1>
> ***

Best Wishes
Lukasz Bojarski


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message