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

$ 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.

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⟩