cvs commit: doc/en_US.ISO8859-1/books/handbook/bsdinstall chapter.sgml

[Glen Barber]

On 10/12/11 9:45 AM, Manolis Kiagias wrote:
> On 12/10/2011 4: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
>>
> 
> While it's true that it is up to FDP standards, it also only affects the
> 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 at
> 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).
> 

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."

-- 
Glen Barber | gjb at FreeBSD.org
FreeBSD Documentation Project

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 487 bytes
Desc: OpenPGP digital signature
Url : http://lists.freebsd.org/pipermail/cvs-all/attachments/20111012/b963f43a/signature.pgp