developpers-handbook: tools-intro is incorrect

Mark Linimon linimon at lonesome.com
Wed Jul 27 14:39:50 UTC 2005


On Wed, Jul 27, 2005 at 01:48:21PM +0200, Jeremie Le Hen wrote:
> Note that the patch is a little bit fat regarding of what it's
> supposed to do, because I needed to redo line wrapping.

Well, that's not the standard way things are done in -doc-land :-)
The problem is that multiline changes make life harder for the translators
since it makes it less obvious what has changed.

So the correct change to e.g. remove 7 words (like your first one) leaves
a short line and that's acceptable.  If desired, a later change can more
the whitespace around, but if so that one gets done with "translators
please ignore".

In any case since whitespace in the document doesn't affect the rendering
it is more often than not left that way, especially for short lines.  It's
also less CVS churn that way.

mcl



More information about the freebsd-doc mailing list