CATMAN(1)

명칭
catman - 온라인 메뉴얼을 사전에 포맷 한다

서식
catman [-f | -force] [-h | -help] [-L | -locale] [-p | -print] [-r | -remove] [-v | -verbose] [directories ...]

해설
catman (은)는 메뉴얼을 ASCII 형식에 포맷 합니다. 이것은 directories 그리고 모든 메뉴얼에 대해 ‘man program’ (와)과 타이프 치는 것과 닮아 있습니다. directories (은)는 메뉴얼의 격납되고 있는 디렉토리나 서브 디렉토리를 스페이스나 코론으로 단락지은 것입니다. directories 하지만 지정되지 않았던 경우, 디폴트로서 /usr/share/man 하지만 사용됩니다.

옵션

-f, -force
    이미 있는 cat 형식의 메뉴얼에의 덧쓰기를 강제합니다. 보통은, 메뉴얼이 낡아졌을 때만, 포맷 다시 해져야 할 것입니다. 이 옵션은 시간과 CPU 와 RAM 의 낭비입니다.

-h, -help
    옵션을 표시해 종료합니다.

-L, -locale
    로케일 환경 변수를 조사해, 로컬라이즈 된 메뉴얼 서브 디렉토리와 본엔트리에만 사용하는 처리를 조사합니다.

-p, -print
    실제로는 메뉴얼의 포맷을 실시하지 않고, 무엇을 실시할까만을 표시합니다.

-r, -remove
    불요 파일을 삭제합니다. 예를 들면, man 형식이 없는 cat 형식, 압축된 cat 형식이 있는 비압축의 cat 형식, 영숫자로 구성되어 있지 않은 파일명을 가지는 파일, 압축된 man 형식이 있는 비압축의 man 형식입니다.

-v, -verbose
    보다 많은 경고를 표시합니다.

사용예
    $ catman

/usr/share/man 이하의 메뉴얼을, 필요한 분만큼 포맷 합니다.

    $ catman $MANPATH

유저의 모든 메뉴얼 패스 이하의 메뉴얼을, 필요한 분만큼 포맷 합니다.

    $ catman -f /usr/local/man/man1 /usr/local/man/manl

/usr/local/man/man1 (와)과 /usr/local/man/manl 이하의 메뉴얼을 강제적으로 포맷 다시 합니다.

    $ catman -p /usr/X11/man

무엇을 하는지를 표시할 뿐입니다.

관련 파일

/etc/periodic/weekly/330.catman
    이 프로그램을 기동합니다

특징
이미 모든 메뉴얼이 포맷 되고 있는 경우, 동작이 매우 빨라집니다. 몇개의 시스템으로 채용되고 있다 -w (은)는 서포트되고 있지 않습니다. ‘whatis’ 데이타베이스를 재구축 하려면 makewhatis(1) (을)를 사용해 주세요.

버그
man(1) (은)는 setuid 프로그램입니다. 유저 ‘man’ 하지만 cat 형식의 메뉴얼을 격납하는 디렉토리에 대해 기입 권한을 가지도록(듯이) 주의해 주세요. catman 하 ‘.so’ 그렇다고 하는 메뉴얼을 체크하지 않습니다. 메뉴얼의 필요 이상의 포맷을 피하려면 하드 링크, 기호 연결을 사용해 주세요.

관련 항목
makewhatis(1), man(1), manpath(1)

역사
이 버젼의 catman 하 FreeBSD 2.1 (으)로부터 부속되었습니다.

저자
Wolfram Schneider <wosch@FreeBSD.org>, Berlin.