os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add a section explaining  

Browse source 
Reviewed by:	Lukasz Bojarski <ni@merkury.pol.lublin.pl>
Approved by:	murray, alex (mentor)
This commit is contained in:
Martin Heinen 2002-10-10 08:40:52 +00:00
parent 70ced0286c
commit 2bfcee3890
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=14576
1 changed files with 36 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml
View file

@ -314,6 +314,42 @@ V
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>
<listitem>
<para>between multiword names (use with caution when applying this
to more than 3-4 word names like <quote>The FreeBSD Brazilian
Portuguese Documentation Project</quote>):</para>
<programlisting><![ CDATA [Sun&nbsp;Microsystems]]></programlisting>
</listitem>
</itemizedlist>
</sect2>
</sect1>
<sect1>