Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 20 Mar 2002 08:26:39 +0100
From:      Stijn Hoop <stijn@win.tue.nl>
To:        Tom Rhodes <darklogik@pittgoth.com>
Cc:        Mike Meyer <mwm-dated-1017030425.b95013@mired.org>, 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>
In-Reply-To: <20020320000727.284a00c1.darklogik@pittgoth.com>; from darklogik@pittgoth.com on Wed, Mar 20, 2002 at 12:07:27AM -0500
References:  <200203192120.g2JLK3o17280@freefall.freebsd.org> <mfr8mf98vb.8mf@localhost.localdomain> <15512.3992.905972.279159@guru.mired.org> <20020320000727.284a00c1.darklogik@pittgoth.com>

next in thread | previous in thread | raw e-mail | index | archive | help

--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 <mwm-dated-1017030425.b95013@mired.org> wrote:
>=20
> > In <mfr8mf98vb.8mf@localhost.localdomain>,
> >   Gary W. Swearingen <swear@blarg.net> typed:
> > > Mike Meyer <mwm-dated-1017004489.c7e726@mired.org> writes:
> > > >  In <20020319100000.A57951@sumuk.de>,
> > > >  >  Martin Heinen <martin@sumuk.de> 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 .</par=
a>

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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020320082639.A8442>