From owner-freebsd-doc@FreeBSD.ORG Tue Oct 30 09:05:09 2007 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CA9EB16A417 for ; Tue, 30 Oct 2007 09:05:09 +0000 (UTC) (envelope-from ale@FreeBSD.org) Received: from andxor.it (relay.andxor.it [195.223.2.3]) by mx1.freebsd.org (Postfix) with SMTP id E9ADE13C4BE for ; Tue, 30 Oct 2007 09:05:08 +0000 (UTC) (envelope-from ale@FreeBSD.org) Received: (qmail 72351 invoked from network); 30 Oct 2007 09:04:47 -0000 Received: from unknown (HELO ale.andxor.it) (192.168.2.5) by andxor.it with SMTP; 30 Oct 2007 09:04:47 -0000 Message-ID: <4726F3AE.1050504@FreeBSD.org> Date: Tue, 30 Oct 2007 10:04:46 +0100 From: Alex Dupre User-Agent: Thunderbird 2.0.0.6 (X11/20070827) MIME-Version: 1.0 To: Gabor Kovesdan References: <4721FFC5.9070505@FreeBSD.org> <20071027.003749.76175923.hrs@allbsd.org> <20071026175650.GA1074@gothic.blackend.org> <47259CCB.2070303@FreeBSD.org> <472661B0.6010903@FreeBSD.org> In-Reply-To: <472661B0.6010903@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Cc: ru@FreeBSD.org, Hiroki Sato , doc@FreeBSD.org, Marc Fonvieille Subject: Re: localized man pages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Oct 2007 09:05:09 -0000 Gabor Kovesdan wrote: > Well, I think it might apply to all kind of docs. As I see, the Spanish, > Russian, Japanese and Italian documentation set is also pretty outdated. No, it's different. I read the general documentation to have an overview, I read the man pages to know exactly what does the X flag. Outdated documentation is not an issue like an outdated man page. Man pages are and need to be very specific. Wrong (or incomplete) specific information is very bad. Not having the GELI section in the translated handbook is a completely different case. Hiroki Sato wrote: > Right. I think it is no problem with adding localized manual pages > but before that it needs toolchain which supports various languages > in a consistent way as well as some framework for informing that > "this is out-of-date" to the users in some way. Yes, this is the only solution. An automated way to display on top of the translated man page that's outdated, and a simple way to display the english one (or vice-versa). -- Alex Dupre