groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Groff] viewing UTF-8 encoded man pages


From: Bruno Haible
Subject: [Groff] viewing UTF-8 encoded man pages
Date: Mon, 4 Jul 2005 13:15:34 +0200
User-agent: KMail/1.5.4

Is someone aware of an easy way to view UTF-8 encoded man pages?
So far, groff supports only Latin1 encoded input, i.e. it does not support
Greek, Russian, Japanese, Chinese, Vietnamese etc. manpages.

Here is an extension of groff that permits to view UTF-8 encoded man pages.
It installs a new command "groff-utf8", which has the same command line
options as groff. The supported output devices are "utf8" (denoting a tty
device in UTF-8 encoding, such as xterm, rxvt, or gnome-terminal) and
"html".

Prerequisite:
  groff 1.18.1 or newer.

Installation:
  $ tar xvfz groff-utf8.tar.gz
  $ cd groff-utf8
  $ make
  $ make install PREFIX=/usr/local      # Choose a PREFIX directory in such
                                        # a way that $PREFIX/bin is in your
                                        # $PATH.

Sample use:
  $ groff-utf8 -Tutf8 -mandoc find.vi.1 | less
  $ groff-utf8 -Thtml -mandoc find.vi.1 > find.html; mozilla find.html

You can also in /etc/manpath.config edit the definitions of the variables
'troff' and 'nroff', to use groff-utf8 instead of groff.

Find attached also two man pages, for testing, one in Vietnamese, by
Clytie Siddall, and one in Japanese.

Of course this is only a stopgap measure, until groff can process UTF-8
encoded man pages by itself, sometime in the future.

Bruno







Attachment: groff-utf8.tar.gz
Description: application/tgz

Attachment: find.vi.1
Description: Troff document

Attachment: java.ja.1
Description: Troff document


reply via email to

[Prev in Thread] Current Thread [Next in Thread]