Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 12 Oct 2011 10:52:20 -0400
From:      Glen Barber <gjb@FreeBSD.org>
To:        Manolis Kiagias <manolis@FreeBSD.org>
Cc:        =?UTF-8?B?VWxyaWNoIFNww7ZybGVpbg==?= <uqs@spoerlein.net>, doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/bsdinstall chapter.sgml
Message-ID:  <4E95A9A4.80706@FreeBSD.org>
In-Reply-To: <4E9599EA.2000502@FreeBSD.org>
References:  <201110101729.p9AHTQg7030262@repoman.freebsd.org> <20111012132723.GH26743@acme.spoerlein.net> <4E9596B2.9000909@FreeBSD.org> <4E9599EA.2000502@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
This is an OpenPGP/MIME signed message (RFC 2440 and 3156)
--------------enigE707BBC3B4FA02C64D27B5E4
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On 10/12/11 9:45 AM, Manolis Kiagias wrote:
> On 12/10/2011 4:31 =CE=BC=CE=BC, Glen Barber wrote:
>> On 10/12/11 9:27 AM, Ulrich Sp=C3=B6rlein 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  =20
>>>> 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 significan=
t
>>> in the generated output.
>>>
>> It follows the FDP standards as noted directly before Chapter 10.1 her=
e:
>>
>> http://www.freebsd.org/doc/en/books/fdp-primer/writing-style.html
>>
>=20
> While it's true that it is up to FDP standards, it also only affects th=
e
> formatting of the SGML file itself, and not the output. As I am nearly
> completing translation of bsdinstall to Greek, I've found quite a few
> more whitespace only changes and nits in the original text, including a=

> couple of spaces at end of lines and wrong indentation levels at a few
> sections. While I'll make sure to fix these in the Greek text, I will
> not be committing these to the original chapter.
> Whitespace only changes should probably be avoided as they only add
> bloat to the repository (I think this is Urlich's concern also) - and a=
t
> this point the chapter is relatively new and will go over more and more=

> changes that will render the whitespace fixes useless. I think it would=

> be best to let the chapter mature for a while - maybe a month or two -
> and then fix all whitespace issues in a single commit (if deemed
> necessary).
>=20

All of which are valid reasons to avoid whitespace fixes at the moment.
 Your more verbose explanation on why this should probably wait is much
more helpful than "pointless and annoying."

--=20
Glen Barber | gjb@FreeBSD.org
FreeBSD Documentation Project


--------------enigE707BBC3B4FA02C64D27B5E4
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (Darwin)

iQEcBAEBCAAGBQJOlampAAoJEFJPDDeguUajzaYIAKX4FzD3UwsAPMB6codawtax
0d+lsCQOj7SRZKspB8LjJW/7EEE/53IR8hwGjszwwC2EK6PgXQu1nOgiBh8o6wNy
BLnpU31S4iZxwFYM/QIh6qT88YjmOI4T3Oxo9cOD1oAaL6OrSG3D9Xjm5A+1Ovu8
PhksMvK5rDM21bvkv6Q5F6u51JBzHB6wbQ2O/iOActG6M9oPgzB6lEb9F4yT1l63
7KPEi56gOfn2yR1V53m6Ap09qeEFPwa3YKxhRFMD4YpRIMxKdPqy/HSPh05qpAPK
uKTejLcNUESCuPFhZVLPxmYHNUKPP1Bl+Rx/0mR4RHlJbABo/KX4FMmgG4XWvmg=
=KBWn
-----END PGP SIGNATURE-----

--------------enigE707BBC3B4FA02C64D27B5E4--



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