NAME

jcatman — preformat Japanese or original (English) man pages

SYNOPSIS

DESCRIPTION

Jcatman format Japanese or original (English) man pages to ASCII/EUC. It's like typing ‘man program’ for all Japanese or original man pages in directories. Directories is a list of Japanese or original man directories or subdirectories separated by spaces or colons. You have to set the envionment variable LC_CTYPE (or LANG) to ja_JP.EUC if you include Japanese man directories in directories. Use existing directories of /usr/share/man/ja_JP.EUC, /usr/share/man/ja_JP, /usr/share/man/ja (if LC_CTYPE or LANG set to ja_JP.EUC) or /usr/share/man (other) if no directories defined.

OPTIONS

-f, -force

Force overwriting old cat pages. Normally only those pages will be formatted which are not up to date. This option is a waste of time, CPU and RAM.

-h, -help

Print options and exit.

-p, -print

Don't actually format man pages. Show what would be done.

-r, -remove

Remove garbage, e. g. catpage without manpage, uncompressed catpage but a compressed catpage exist, filenames with non-alphanumeric characters, uncompressed manpage but a compressed manpage exist.

-v, -verbose

More warnings.

EXAMPLES

Format man pages in existing directories of /usr/share/man/ja_JP.EUC, /usr/share/man/ja_JP, /usr/share/man/ja if necessary.

Format all your man pages if necessary.

Force reformatting of all man pages in /usr/share/man/ja/man1 and /usr/share/man/ja/manl.

Show only.

FEATURES

Very fast if all man Japanese pages already formatted. Does not support the -w option as some other systems do. Use jmakewhatis(1) to rebuild the ‘whatis’ database.

BUGS

jman(1) is a setuid program. Be careful that user ‘man’ has write permissions to the jcatman directories. Jcatman does not check for any ‘.so’ in Japanese man page sources. Use hard or symlinks to avoid redundant formatted Japanese man pages.

SEE ALSO

jman(1), jmanpath(1), jmakewhatis(1).

HISTORY

The original version of catman command appeared in FreeBSD 2.1. Japanized jcatman command appeared in ports/packages collection of FreeBSD 2.2.

AUTHORS

Wolfram Schneider ⟨wosch@FreeBSD.org⟩, Berlin.

JAPANIZATION

KUMANO, Tadashi ⟨kumano@jp.freebsd.org⟩