From owner-freebsd-doc@FreeBSD.ORG Sat Oct 27 10:24:05 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 1CF4B16A41B; Sat, 27 Oct 2007 10:24:05 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (unknown [IPv6:2001:2f0:104:e002::2]) by mx1.freebsd.org (Postfix) with ESMTP id CD05513C480; Sat, 27 Oct 2007 10:24:04 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p4054-ipbf904funabasi.chiba.ocn.ne.jp [122.26.39.54]) (authenticated bits=128) by mail.allbsd.org (8.13.8/8.13.8) with ESMTP id l9RANqPF001629; Sat, 27 Oct 2007 19:24:03 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) (authenticated bits=0) by delta.allbsd.org (8.13.4/8.13.4) with ESMTP id l9RANcgr006026; Sat, 27 Oct 2007 19:23:41 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sat, 27 Oct 2007 19:21:16 +0900 (JST) Message-Id: <20071027.192116.230183501.hrs@allbsd.org> To: blackend@FreeBSD.org From: Hiroki Sato In-Reply-To: <20071027065754.GA1015@gothic.blackend.org> References: <20071026175650.GA1074@gothic.blackend.org> <47226158.4070304@FreeBSD.org> <20071027065754.GA1015@gothic.blackend.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 5.2 on Emacs 22.1 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sat_Oct_27_19_21_16_2007_930)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV version 0.91.2, clamav-milter version 0.91.2 on gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH authentication, not delayed by milter-greylist-3.0 (mail.allbsd.org [133.31.130.32]); Sat, 27 Oct 2007 19:24:03 +0900 (JST) Cc: ru@FreeBSD.org, doc@FreeBSD.org, gabor@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 10:24:05 -0000 ----Security_Multipart(Sat_Oct_27_19_21_16_2007_930)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Marc Fonvieille wrote in <20071027065754.GA1015@gothic.blackend.org>: bl> > Ubuntu Linux uses groff 1.18.1 and has some Hungarian manual pages. I bl> > succeeded to render them correctly by using "nroff -Tutf8 manpage", so we bl> > must be able to do this with our groff 1.19.2, too. I'm not sure how to bl> > adjust man(1) to do it automatically, though. Miklos, the guy, who bl> > volunteered to do some translation work on the manpages also claimed that bl> > he could see the translated manpages properly by using latin1 encoding bl> > instead of ascii. bl> > Hmm, I have not use the latest groff, so I will give it a try. If it accepts UTF-8 and other encodings and there is no regression, upgrading our stock groff would be good. bl> I used to use: bl> groff -man -mtty-char -Tlatin1 -dlang=fr.ISO8859-1 blahblah.1 bl> which is still working. Now I'm trying to recall why I really stopped bl> committing translated manual pages. I remember I had a mail exchange bl> with Ruslan about the manual page system especially the mechanism bl> allowing the selection of the manual page to display according to the bl> locale. I'm unable to find this mail, but I now think the problem was bl> on this point: our manual page system does not easily allow this bl> selection and the fall-back on the en_US version when the manual page is bl> not translated. This should also work with ports manual pages. The man(1) we are using partially support such selection by $LANG. For example, if you have: /usr/local/man/ja_JP.eucJP/man1/nkf.1.gz /usr/local/man/man1/nkf.1.gz and type "env LANG=ja_JP.eucJP man nkf" and "env LANG=C man nkf", you will find the different results. However, selection of command line option (such as -Tlatin1 and -Tutf8) by $LANG is not supported, IIRC. Even if the latest groff supports non-ascii encodings, pager is still a problem. Our stock less does not support so many encodings at least (I often use misc/lv for non-English text files which less does not support). -- | Hiroki SATO ----Security_Multipart(Sat_Oct_27_19_21_16_2007_930)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.7 (FreeBSD) iD8DBQBHIxEcTyzT2CeTzy0RAsUuAKCQG2DV2Z1hxrQXdFz633f2p/NTZQCgoLUy KkJ7/RYabvZFYWogTI38paA= =6Tik -----END PGP SIGNATURE----- ----Security_Multipart(Sat_Oct_27_19_21_16_2007_930)----