From owner-freebsd-doc@FreeBSD.ORG Tue Oct 30 20:52:34 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 F033116A419; Tue, 30 Oct 2007 20:52:34 +0000 (UTC) (envelope-from rermilov@team.vega.ru) Received: from mail.vega.ru (infra.dev.vega.ru [90.156.167.14]) by mx1.freebsd.org (Postfix) with ESMTP id 9C99C13C4E3; Tue, 30 Oct 2007 20:52:34 +0000 (UTC) (envelope-from rermilov@team.vega.ru) Received: from [87.242.97.68] (port=50568 helo=edoofus.dev.vega.ru) by mail.vega.ru with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.68 (FreeBSD)) (envelope-from ) id 1Imxg1-0002YL-0C; Tue, 30 Oct 2007 20:27:05 +0000 Received: from edoofus.dev.vega.ru (localhost [127.0.0.1]) by edoofus.dev.vega.ru (8.14.1/8.14.1) with ESMTP id l9UKQKrO024712; Tue, 30 Oct 2007 23:26:20 +0300 (MSK) (envelope-from rermilov@team.vega.ru) Received: (from ru@localhost) by edoofus.dev.vega.ru (8.14.1/8.14.1/Submit) id l9UKQKmv024711; Tue, 30 Oct 2007 23:26:20 +0300 (MSK) (envelope-from rermilov@team.vega.ru) X-Authentication-Warning: edoofus.dev.vega.ru: ru set sender to rermilov@team.vega.ru using -f Date: Tue, 30 Oct 2007 23:26:20 +0300 From: Ruslan Ermilov To: Marc Fonvieille Message-ID: <20071030202620.GA23715@team.vega.ru> References: <4721FFC5.9070505@FreeBSD.org> <20071027.003749.76175923.hrs@allbsd.org> <20071026175650.GA1074@gothic.blackend.org> <47226158.4070304@FreeBSD.org> <20071027065754.GA1015@gothic.blackend.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20071027065754.GA1015@gothic.blackend.org> User-Agent: Mutt/1.5.16 (2007-06-09) Cc: doc@freebsd.org, Gabor Kovesdan 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 20:52:35 -0000 On Sat, Oct 27, 2007 at 08:57:54AM +0200, Marc Fonvieille wrote: > [...] 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. > Isn't this easy enough (copied from the man(1) manpage)? : By default, man searches for a localized manpage in a set of : locale subdirectories of each manpath(1) component. : : Locale name is taken from the first of three environment vari- : ables with a nonempty value: LC_ALL, LC_CTYPE, or LANG, in the : specified order. : : If the value could not be determined, or is not a valid locale : name, then only non-localized manpage will be looked up. : : Otherwise, man will search in the following subdirectories, in : the order of precedence: : : _. : . : en. : : For example, for the ``de_DE.ISO8859-1'' locale, man will : search in the following subdirectories of the /usr/share/man : manpath component: : : /usr/share/man/de_DE.ISO8859-1 : /usr/share/man/de.ISO8859-1 : /usr/share/man/en.ISO8859-1 : : Finally, if the search of localized manpage fails, it will be : looked up in the default /usr/share/man directory. Cheers, -- Ruslan Ermilov ru@FreeBSD.org FreeBSD committer