From owner-freebsd-doc Tue Mar 19 23:28:39 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 E642137B41B for ; Tue, 19 Mar 2002 23:26:53 -0800 (PST) Received: (from stijn@localhost) by pcwin002.win.tue.nl (8.11.6/8.11.6) id g2K7Qdk08566; Wed, 20 Mar 2002 08:26:39 +0100 (CET) (envelope-from stijn) Date: Wed, 20 Mar 2002 08:26:39 +0100 From: Stijn Hoop To: Tom Rhodes Cc: Mike Meyer , swear@blarg.net, freebsd-doc@freebsd.org Subject: Re: docs/36042: [PATCH] There's not a good description of shared builds in the handbook Message-ID: <20020320082639.A8442@pcwin002.win.tue.nl> References: <200203192120.g2JLK3o17280@freefall.freebsd.org> <15512.3992.905972.279159@guru.mired.org> <20020320000727.284a00c1.darklogik@pittgoth.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="bp/iNruPH9dso1Pn" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020320000727.284a00c1.darklogik@pittgoth.com>; from darklogik@pittgoth.com on Wed, Mar 20, 2002 at 12:07:27AM -0500 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 --bp/iNruPH9dso1Pn Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [Tom, could you wrap your lines at 72 characters please?] On Wed, Mar 20, 2002 at 12:07:27AM -0500, Tom Rhodes wrote: > On Tue, 19 Mar 2002 22:27:04 -0600 > Mike Meyer wrote: >=20 > > In , > > Gary W. Swearingen typed: > > > Mike Meyer writes: > > > > In <20020319100000.A57951@sumuk.de>, > > > > > Martin Heinen typed: > > > > > Please put two spaces at the end of sentences. > >=20 > > You're saying he wants the raw text formatted the way he would like to > > read it. Personally, I disagree with you and prefer one space after a > > period, even in fixed pitch text. That's why I wrote it that way. >=20 > To be honest, in high school and college english I have always been taught > to use two spaces at the end of any typed sentance, so I think its a set > standard. This is different in Europe - I think most of the European countries use just one space between sentences. This goes to show that it's mostly a cultural thing. I don't see any problems with accepting both styles for the *source* of the Handbook (or articles for that matter) - especially given Mike's comment below: > > This is the first time anyone's ever objected to that practice in the > > documentation I've submitted. I don't see anything in the instructions > > for submitting documentation to the project on this, or a manual page > > in section 7 that looks relevant. Personally, I think raising hurdles > > for those volunteering to write documentation is a bad idea. I fully agree. I'm also used to typing just one space between a sentence; just because a lot of the contributors grew up in countries with another default, should I switch my style? > 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 . I couldn't find this; but even if it was in there, I don't agree with it. > As far as mdoc(7) is concerned I think that a person to ask would be > ru@FreeBSD.org, he knows alot about the process. Yes, but this is not markup. This is writing style. > With this situation, I don't think of it as hurdles, It is if you're used to the 'European 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 spaces > between sentances, maybe the reason is because of my learnings through the > American education system, now the last thing I ever want to do is compla= in > about the education system of another country, or the teachings of certain > institutions, its just that we have always done it this way, > and I feel strongly that this standard should be upheld. >=20 > Please take this comment in the friendly and informative way of its inten= t, > I hope that no offense has really been taken by anyone. 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). --Stijn --=20 Q: Why is Batman better than Bill Gates? A: Batman was able to beat the Penguin. --bp/iNruPH9dso1Pn 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 iD8DBQE8mDmvY3r/tLQmfWcRAn4hAKCcTOByiyEIuw2kIAGVaPLdhGEw8wCfU4/m WlyvpwrnF/Xca9R45obJ2ic= =6oxa -----END PGP SIGNATURE----- --bp/iNruPH9dso1Pn-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message