From owner-freebsd-doc@FreeBSD.ORG Sat Oct 27 06:57:58 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 2B79216A41A; Sat, 27 Oct 2007 06:57:58 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (ns0.blackend.org [82.227.222.164]) by mx1.freebsd.org (Postfix) with ESMTP id 9D73013C4AA; Sat, 27 Oct 2007 06:57:56 +0000 (UTC) (envelope-from marc@blackend.org) Received: from gothic.blackend.org (gothic.blackend.org [192.168.1.203]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id l9R6vtOG076267; Sat, 27 Oct 2007 08:57:55 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from gothic.blackend.org (localhost [127.0.0.1]) by gothic.blackend.org (8.14.1/8.14.1) with ESMTP id l9R6vt0E001123; Sat, 27 Oct 2007 08:57:55 +0200 (CEST) (envelope-from marc@gothic.blackend.org) Received: (from marc@localhost) by gothic.blackend.org (8.14.1/8.14.1/Submit) id l9R6vs0L001122; Sat, 27 Oct 2007 08:57:54 +0200 (CEST) (envelope-from marc) Date: Sat, 27 Oct 2007 08:57:54 +0200 From: Marc Fonvieille To: Gabor Kovesdan Message-ID: <20071027065754.GA1015@gothic.blackend.org> References: <4721FFC5.9070505@FreeBSD.org> <20071027.003749.76175923.hrs@allbsd.org> <20071026175650.GA1074@gothic.blackend.org> <47226158.4070304@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <47226158.4070304@FreeBSD.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 7.0-PRERELEASE User-Agent: Mutt/1.5.16 (2007-06-09) Cc: ru@FreeBSD.org, Hiroki Sato , doc@FreeBSD.org 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: Sat, 27 Oct 2007 06:57:58 -0000 On Fri, Oct 26, 2007 at 11:51:20PM +0200, Gabor Kovesdan wrote: > Marc Fonvieille escribió: >> On Sat, Oct 27, 2007 at 12:37:49AM +0900, Hiroki Sato wrote: >> >>> Gabor Kovesdan wrote >>> in <4721FFC5.9070505@FreeBSD.org>: >>> >>> ga> I have a volunteer, who is going to send me Hungarian man page >>> ga> translations. I've noticed that Japanese people have some old >>> translated >>> ga> man pages in the doc repository, but I'd rather commit the pages into >>> ga> src so that we can have the appropriate versions for our branches in >>> the >>> ga> future. I like the idea of making some progress about a more wide >>> ga> language support by translating the manpages to Hungrian, so please >>> give >>> ga> me an idea how I can do it in the src repo, where should they go. >>> ga> (Ruslan, our mdoc guru is CC'd.) >>> >>> Before adding non-English manual page, we need i18n support of man, >>> nroff, and pager at least. Japanese old manual pages depend on >>> Japanized tools such as japanese/man and japanese/groff (and not >>> actively maintained these days...). It makes putting them into the >>> src tree difficult. >>> >>> >> >> This is the reason why I stopped to add things to >> doc/fr_FR.ISO8859-1/man, i.e, problematic toolchain. >> >> >>> Since groff's i18n support is still poor, I personally think we >>> should adopt UTF-8-capable toolchain if possible. I have surveyed >>> such tools some time ago and found textproc/heirloom-doctools would >>> be a promising one. It is from OpenSolaris (i.e. CDDL'd) and >>> supports UTF-8 output. I am not sure compatibility of roff macro >>> between the groff and the heirloom-doctools, though. >>> >>> >> >> What Linux people use on their various distributions? Last time I >> checked (well, it was in 99...) most of Linux distributions provided >> localized manual pages. >> >> > Ubuntu Linux uses groff 1.18.1 and has some Hungarian manual pages. I > succeeded to render them correctly by using "nroff -Tutf8 manpage", so we > must be able to do this with our groff 1.19.2, too. I'm not sure how to > adjust man(1) to do it automatically, though. Miklos, the guy, who > volunteered to do some translation work on the manpages also claimed that > he could see the translated manpages properly by using latin1 encoding > instead of ascii. > I used to use: groff -man -mtty-char -Tlatin1 -dlang=fr.ISO8859-1 blahblah.1 which is still working. Now I'm trying to recall why I really stopped committing translated manual pages. I remember I had a mail exchange with Ruslan about the manual page system especially the mechanism allowing the selection of the manual page to display according to the locale. I'm unable to find this mail, but I now think the problem was on this point: our manual page system does not easily allow this selection and the fall-back on the en_US version when the manual page is not translated. This should also work with ports manual pages. -- Marc