JCATMAN(1)

NAME
jcatman - preformat Japanese or original (English) man pages

SYNOPSIS
jcatman [-f | -force] [-h | -help] [-p | -print] [-r | -remove] [-v | -verbose] [directories ...]

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

    $ jcatman

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

    $ jcatman $MANPATH

Format all your man pages if necessary.

    $ jcatman -f /usr/share/man/ja/man1 /usr/share/man/ja/manl

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

    $ jcatman -p /usr/X11R6/man/ja

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>