From owner-freebsd-doc@FreeBSD.ORG Fri Oct 26 21:51:47 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 5F5AC16A46E; Fri, 26 Oct 2007 21:51:47 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.t-hosting.hu (server.t-hosting.hu [81.2.252.59]) by mx1.freebsd.org (Postfix) with ESMTP id 9D1B913C48E; Fri, 26 Oct 2007 21:51:46 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) by server.t-hosting.hu (Postfix) with ESMTP id 0505EA4AA96; Fri, 26 Oct 2007 23:51:44 +0200 (CEST) X-Virus-Scanned: amavisd-new at t-hosting.hu Received: from server.t-hosting.hu ([127.0.0.1]) by localhost (server.t-hosting.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 4i9xgRlLmCTE; Fri, 26 Oct 2007 23:51:36 +0200 (CEST) Received: from [192.168.2.186] (catv-5063f539.catv.broadband.hu [80.99.245.57]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by server.t-hosting.hu (Postfix) with ESMTP id 4CD5EA4AA80; Fri, 26 Oct 2007 23:51:36 +0200 (CEST) Message-ID: <47226158.4070304@FreeBSD.org> Date: Fri, 26 Oct 2007 23:51:20 +0200 From: Gabor Kovesdan User-Agent: Thunderbird 2.0.0.6 (Windows/20070728) MIME-Version: 1.0 To: Marc Fonvieille References: <4721FFC5.9070505@FreeBSD.org> <20071027.003749.76175923.hrs@allbsd.org> <20071026175650.GA1074@gothic.blackend.org> In-Reply-To: <20071026175650.GA1074@gothic.blackend.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit Cc: doc@FreeBSD.org, Hiroki Sato , ru@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: Fri, 26 Oct 2007 21:51:47 -0000 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. -- Gabor Kovesdan FreeBSD Volunteer EMAIL: gabor@FreeBSD.org .:|:. gabor@kovesdan.org WEB: http://people.FreeBSD.org/~gabor .:|:. http://kovesdan.org