From owner-freebsd-doc Wed Mar 20 0:46:52 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pcwin002.win.tue.nl (pcwin002.win.tue.nl [131.155.71.72]) by hub.freebsd.org (Postfix) with ESMTP id 1CF4D37B400 for ; Wed, 20 Mar 2002 00:46:47 -0800 (PST) Received: (from stijn@localhost) by pcwin002.win.tue.nl (8.11.6/8.11.6) id g2K8kjS09335; Wed, 20 Mar 2002 09:46:45 +0100 (CET) (envelope-from stijn) Date: Wed, 20 Mar 2002 09:46:45 +0100 From: Stijn Hoop To: freebsd-doc@freebsd.org Cc: Tom Rhodes , Mike Meyer , swear@blarg.net Subject: Re: docs/36042: [PATCH] There's not a good description of shared builds in the handbook Message-ID: <20020320094644.A90049@pcwin002.win.tue.nl> References: <200203192120.g2JLK3o17280@freefall.freebsd.org> <15512.3992.905972.279159@guru.mired.org> <20020320000727.284a00c1.darklogik@pittgoth.com> <20020320082639.A8442@pcwin002.win.tue.nl> <20020320093559.A65168@sumuk.de> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="2fHTh5uZTiUOsy+g" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020320093559.A65168@sumuk.de>; from martin@sumuk.de on Wed, Mar 20, 2002 at 09:36:00AM +0100 X-Bright-Idea: Let's abolish HTML mail! 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 --2fHTh5uZTiUOsy+g Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Mar 20, 2002 at 09:36:00AM +0100, Martin Heinen wrote: > On Wed, Mar 20, 2002 at 08:26:39AM +0100, Stijn Hoop wrote: > > On Wed, Mar 20, 2002 at 12:07:27AM -0500, Tom Rhodes wrote: > > > I think that the FDP Primer makes requirements for two spaces at the = end > > > of each period exept for the ending of paragraphs, which just > > > have . > >=20 > > I couldn't find this; but even if it was in there, I don't agree with i= t. >=20 > You'll find it in the writing style section of the FDP-Primer: >=20 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style= .html Ah, OK. Was there thought given to the fact that this is *not* the usual st= yle for a lot of writers around the world? I think this should at least be mentioned (or else this discussion comes around again in a few months). > One reason given there, is that it is easier to recognize > the end of sentences in tools, although I never searched for > the end of sentences :) What it really does, is enhancing > the readability of the SGML source, which is very useful > when translating the document. OK, I hadn't thought of translations; it would be nice to standardize for translators I guess. > > > With this situation, I don't think of it as hurdles, > >=20 > > It is if you're used to the 'European style'. >=20 > Sure, it takes some time to get accustomed to :) Especially if all your other writings are in the other style. > > > but more of a set standard to make things easier for people. For one= , I > > > find it relativly native to use a space between every word and two sp= aces > > > between sentances, maybe the reason is because of my learnings throug= h the > > > American education system, now the last thing I ever want to do is > > > complain about the education system of another country, or the teachi= ngs > > > of certain institutions, its just that we have always done it this wa= y, > > > and I feel strongly that this standard should be upheld. > > >=20 > > > Please take this comment in the friendly and informative way of its > > > intent, I hope that no offense has really been taken by anyone. > >=20 > > No offense taken, it's just that the hurdle has been raised for people > > wanting to contribute to the doc project. That's Bad(TM). >=20 > Maybe we could lower the bar by not making this a requirement > for contributions, but I would like to have two spaces > in the committed document. Yes, but who would convert the single spaced documents then? Anyway, thanks for pointing out the reason for using this style. I still th= ink that a clarifying paragraph in the FDP primer should be written, but I don't have the time right now to summarize this discussion. --Stijn --=20 This sentence contradicts itself -- no actually it doesn't. -- Hofstadter --2fHTh5uZTiUOsy+g Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iD8DBQE8mEx0Y3r/tLQmfWcRAmoVAJ9CYI05XYfTC70dAe1tha+K/yGMrQCfQQuZ FtKquu0KXI5bk6NIsYWu3gA= =stjy -----END PGP SIGNATURE----- --2fHTh5uZTiUOsy+g-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message