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

[Manolis Kiagias]

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