From owner-freebsd-doc@FreeBSD.ORG  Wed Jul 27 14:39:50 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 0C7C816A41F
	for <freebsd-doc@FreeBSD.org>; Wed, 27 Jul 2005 14:39:50 +0000 (GMT)
	(envelope-from linimon@lonesome.com)
Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66])
	by mx1.FreeBSD.org (Postfix) with ESMTP id C8BD943D58
	for <freebsd-doc@FreeBSD.org>; Wed, 27 Jul 2005 14:39:43 +0000 (GMT)
	(envelope-from linimon@lonesome.com)
Received: by mail.soaustin.net (Postfix, from userid 502)
	id F26C429E7; Wed, 27 Jul 2005 09:39:41 -0500 (CDT)
Date: Wed, 27 Jul 2005 09:39:41 -0500
To: Jeremie Le Hen <jeremie@le-hen.org>
Message-ID: <20050727143941.GA7172@soaustin.net>
References: <20050727114821.GS1610@obiwan.tataz.chchile.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20050727114821.GS1610@obiwan.tataz.chchile.org>
User-Agent: Mutt/1.5.9i
From: linimon@lonesome.com (Mark Linimon)
Cc: freebsd-doc@FreeBSD.org
Subject: Re: developpers-handbook: tools-intro is incorrect
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 27 Jul 2005 14:39:50 -0000

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