From owner-cvs-doc@FreeBSD.ORG Wed Oct 12 20:16:10 2011 Return-Path: Delivered-To: cvs-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1ADA01065672; Wed, 12 Oct 2011 20:16:10 +0000 (UTC) (envelope-from uqs@spoerlein.net) Received: from acme.spoerlein.net (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by mx1.freebsd.org (Postfix) with ESMTP id 92E8D8FC0A; Wed, 12 Oct 2011 20:16:09 +0000 (UTC) Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by acme.spoerlein.net (8.14.4/8.14.4) with ESMTP id p9CKG8mP009474 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Wed, 12 Oct 2011 22:16:08 +0200 (CEST) (envelope-from uqs@spoerlein.net) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=spoerlein.net; s=dkim200908; t=1318450568; bh=kwIcswkFpK8eNlL5sms3UyQqVr7CIkiVqTcFewvq2ro=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Transfer-Encoding:In-Reply-To; b=if3mq8shpn3ZFzBia+S/UjaVctk4k1fWKdEWpKCWSunJelTAIuCFVJRs+VRr+pIJu mISf4CZJWAzFkK/e57HeW1dmf3m2XDuutHuijONtmFcqtl0oVJBHPhffzf5SeCIsCW lpXsDbp1ArlIP3QGQX7BR3M2IELWZbiq8eOLC5zQ= Date: Wed, 12 Oct 2011 22:16:08 +0200 From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= To: Benedict Reuschling Message-ID: <20111012201607.GJ26743@acme.spoerlein.net> References: <201110101729.p9AHTQg7030262@repoman.freebsd.org> <20111012132723.GH26743@acme.spoerlein.net> <4E9596B2.9000909@FreeBSD.org> <4E95981E.2070303@gmail.com> <4E9598FD.2010801@FreeBSD.org> <20111012164101.GI26743@acme.spoerlein.net> <4E95CA78.6040503@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <4E95CA78.6040503@FreeBSD.org> User-Agent: Mutt/1.5.21 (2010-09-15) Cc: Niclas Zeising , cvs-doc@freebsd.org, doceng@freebsd.org, cvs-all@freebsd.org, Glen Barber , doc-committers@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/bsdinstall chapter.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Oct 2011 20:16:10 -0000 On Wed, 2011-10-12 at 19:12:24 +0200, Benedict Reuschling wrote: > Am 12.10.11 18:41, schrieb Ulrich Spörlein: > > On Wed, 2011-10-12 at 09:41:17 -0400, Glen Barber wrote: > >> On 10/12/11 9:37 AM, Niclas Zeising wrote: > >>> On 10/12/11 15:31, Glen Barber wrote: > >>>> On 10/12/11 9:27 AM, Ulrich Spörlein wrote: > >>>>> On Mon, 2011-10-10 at 17:29:26 +0000, Glen Barber wrote: > >>>>>> gjb 2011-10-10 17:29:26 UTC > >>>>>> > >>>>>> FreeBSD doc repository > >>>>>> > >>>>>> Modified files: > >>>>>> en_US.ISO8859-1/books/handbook/bsdinstall chapter.sgml > >>>>>> Log: > >>>>>> Use two spaces between end of sentence and beginning of sentence. > >>>>>> > >>>>>> Revision Changes Path > >>>>>> 1.9 +10 -10 > >>>>>> doc/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.sgml > >>>>> > >>>>> Why oh why? Please stop doing that, it's pointless, annoying and will > >>>>> get lost with paragraph reformatting eventually and is not significant > >>>>> in the generated output. > >>>>> > >>>> > >>>> It follows the FDP standards as noted directly before Chapter 10.1 here: > >>>> > >>>> http://www.freebsd.org/doc/en/books/fdp-primer/writing-style.html > >>>> > >>> > >>> From what I've come to understand it does not matter for the rendered > >>> output. > >> > >> The only "significant" spaces in SGML/HTML output is " ". > >> > >>> It makes the source (i.e. sgml file) more readable though. > >> > >> In addition to being "proper" writing style. > > > > Yes, the 20th century called and wants you to return your typewriter. > > > > Please stop this double-spaced end of sentence madness. > > http://www.slate.com/articles/technology/technology/2011/01/space_invaders.html > > I've read the article, but my experience is the complete opposite. In > school we learned that there is one space after the full stop. I do not > find a single email in my work email nor in FreeBSD emails from users of > all ages that use two spaces, either. My guess is that nowadays, this > two spaces thing has been indeed been a thing of the past an no one uses > it anymore (or they are simply too lazy to hit the spacebar a second time). > > When I learned the ways of being a doc committer, I was under the > impression that it was project convention (similar to style(9)), but I > did not ask and ran with it. Probably a good example for not taking > anything for granted and question some of the this that have been done > since "the dawn of time(tm)". > > My suggestion is that we involve doceng@ (which I did in CC) and ask for > a decision. A patch to the fdp-primer correcting this should be fairly > easy, changing what nearly every doc committer has learned during > his/her mentee phase in this regard is a different story. > > I propose that once we decide to use just one single space in the > future, that new documents which are added to the doc tree should use > this new convention, but old documents should not be changed. This > reduces the amount of work for translators immensely. PRs that are being > filed with sweeping doc patches to correct this in old documents should > also be closed with a reference to the policy. > > Your thoughts on this? For the SGML case, people should use whatever they want. They should also accept that different authors do it differently and not commit patches that simply change single to double spacing or vice versa. I'd drop this suggestion from the fdp-primer, as it only fuels pointless debates on cvs-doc :). How does it make life easier for emacs using folk? Cheers, Uli