localized man pages

Marc Fonvieille blackend at FreeBSD.org
Fri Oct 26 18:11:37 UTC 2007


On Sat, Oct 27, 2007 at 12:37:49AM +0900, Hiroki Sato wrote:
> Gabor Kovesdan <gabor at freebsd.org> wrote
>   in <4721FFC5.9070505 at 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.

-- 
Marc
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20071026/87af4727/attachment.sig>


More information about the freebsd-doc mailing list