From owner-freebsd-doc@FreeBSD.ORG Wed Jul 10 01:05:34 2013 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 763A2339; Wed, 10 Jul 2013 01:05:34 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id D848E19ED; Wed, 10 Jul 2013 01:05:33 +0000 (UTC) X-AuditID: 12074423-b7f168e00000095a-c2-51dcb356196b Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id DB.F7.02394.653BCD15; Tue, 9 Jul 2013 21:05:27 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r6A15P2V002864; Tue, 9 Jul 2013 21:05:26 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r6A15N1i008614 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 9 Jul 2013 21:05:25 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r6A15N3X027947; Tue, 9 Jul 2013 21:05:23 -0400 (EDT) Date: Tue, 9 Jul 2013 21:05:22 -0400 (EDT) From: Benjamin Kaduk To: Warren Block , pgj@FreeBSD.org Subject: Re: svn commit: r42201 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: Message-ID: References: <201307090627.r696RuOg076372@svn.freebsd.org> <51DC7984.4080106@FreeBSD.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpnleLIzCtJLcpLzFFi42IRYrdT0Q3ffCfQYOt7FotTZ7pYLZY92shm MWf1U0aLy+8nslj8OuXhwOox49N8Fo8jHY8YA5iiuGxSUnMyy1KL9O0SuDI6vl1kKnjAXzH1 zTL2BsYtPF2MnBwSAiYSM5o+s0HYYhIX7q0Hsrk4hAT2MUo87VjCDOFsYJQ4Nv0xO4RzkEli 9eMDzCAtQgL1EheeLWMBsVkEtCTWfTkKFmcTUJGY+WYj2FgRATOJpmXbmUBsZoFsia1TVjOC 2MICERKfz+4BGsrBwSlgJ/HprztImFfAUWL1rZMsELsOMEpMaroD1isqoCOxev8UFogiQYmT M5+wQMy0lDj35zrbBEbBWUhSs5CkFjAyrWKUTcmt0s1NzMwpTk3WLU5OzMtLLdI108vNLNFL TSndxAgOYxflHYx/DiodYhTgYFTi4T2gcCdQiDWxrLgy9xCjJAeTkihv9nqgEF9SfkplRmJx RnxRaU5q8SFGCQ5mJRHevFVAOd6UxMqq1KJ8mJQ0B4uSOO+zp2cDhQTSE0tSs1NTC1KLYLIy HBxKEryXNgI1ChalpqdWpGXmlCCkmTg4QYbzAA3fCVLDW1yQmFucmQ6RP8Woy/Hpxdb3jEIs efl5qVLivO9AigRAijJK8+DmwNLPK0ZxoLeEedk2AVXxAFMX3KRXQEuYgJbsSQFbUpKIkJJq YFT99F5Wd3lW16Xs9r1x0qem+L45dPUgn57ZWfPl01TFXl/qWmJk/YpNS8DsSM6t39FtXlIc wX8PmHZs/9G2gytN52SdidzqfatNtCZu8xefyrF2nb133scH7+Me5Dzv/f0k4ts7lr2taikl rvUrtl/c5JK4YKIiu96Neatfpj/WvX1hw1n3LeVKLMUZiYZazEXFiQBmjUhGGgMAAA== Cc: freebsd-doc@FreeBSD.org, Gabor Kovesdan , Warren Block X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 01:05:34 -0000 [moving to the -doc list for discussion] On Tue, 9 Jul 2013, Warren Block wrote: > On Tue, 9 Jul 2013, Gabor Kovesdan wrote: > >> Em 09-07-2013 21:13, Benjamin Kaduk escreveu: >>>> Remove a confusing paragraph whose net contribution is negative. Remove >>>> some   from "Ports Collection", it's unnecessary. Make one example >>> >>> Was this discussed anywhere? I am seeing a pretty long precedent for the >>> non-breaking space. >> Indeed it wasn't discussed but I think that these non-breaking spaces >> should be reconsidered. > > I had added the   to the Ports Collection in the word list very > recently, then saw that it really made no sense to force those two words to > be on the same line. > >> Typography rules and conventions are language-dependent. For example, in >> Hungarian it is not nice to end a line with a sentence-starting >> single-letter article. Afaik, English does not have such rules, except >> widows and orphans, which are more concerned with aesthetics. It is >> reasonable to avoid a line break between FreeBSD and 9.X or similar cases >> but probably not for such long terms as Ports Collection. Actually, it may >> just hit back because it may make justified paragraphs very ugly in our >> print formats. > > Exactly. I have done my share of fitting relatively large font text into a small space and trying to get the wrapping to look nice; with a nbsp there will almost certainly be some font size+page width combinations that look bad. We should probably discuss and decide one way or the other and actually put it in the word list, so we remember for next time. I actually don't have strong feelings either way. I went back through the history of this file, and at least one instance was added in r33364 by pgj (cc'd), with review by gabor@, even! That was back in Dec 2008, so changing our minds now would not be terrible, if we want to. Does anyone want to argue for keeping the nbsp? -Ben