CATMAN(8)

이름
catman - 사전 서식처리한 설명서 페이지를 만들거나 업데이트합니다

개요
catman [-d?V] [-M 경로] [-C 파일] [섹션] ...

설명
catman은 캣 페이지로 알려진 사전 서식화 설명서 페이지 모음을 최신판으로 만드는데 활용합니다. 캣 페이지는 보통 원조 설명서 페이지보다는 표시가 훨씬 빠르지만, 추가 저장 공간이 필요합니다. 캣 페이지 지원 결정은 로컬 관리자의 몫이며, 캣 페이지를 넣을 적절한 디렉터리를 제공해야합니다. catman에서 활용할 수 있는 옵션은 사전 서식화할 설명서 페이지 계층과 섹션입니다. 기본 계층은 man-db 설정 파일의 시스템 계층으로 지정하며, 기본 섹션은 $MANSECT 환경 변수에 콜론으로 구분한 내용이거나, 이 변수가 없을 경우 man에 컴파일하여 넣은 기본 세트 값입니다. catman에 공백으로 구분한 여러 섹션 이름을 넣으면 위 값보다 우선하여 활용합니다. catman은 각 계층에 연동한 색인 데이터베이스 캐시를 활용하여 어떤 파일을 서식화해야 하는지 판단합니다.

옵션

-d, --debug
    디버깅 정보를 출력합니다.

-M 경로, --manpath=경로
    콜론으로 구분한 설명서 페이지 계층 검색 경로를 지정합니다. 기본적으로, man-db 설정 파일의 시스템 계층으로 나타나는 모든 경로입니다.

-C 파일, --config-file=파일
    ~/.manpath 기본값 대신 사용자 설정 파일을 활용합니다.

-?, --help
    도움말 메시지를 출력하고 나갑니다.

--usage
    간단한 사용법 메시지를 출력하고 나갑니다.

-V, --version
    버전 정보를 출력합니다.

환경

MANSECT
    $MANSECT를 설정하면, 이 값은 콜론 구분 섹션 목록이며, 어떤 설명서 섹션을 어떤 순서로 검색할 지 결정하는데 활용합니다. 기본은 /etc/man_db.conf 파일의 SECTION 지시자에서 우선적으로 값을 적용하지 않는 한, "1 1p 8 2 3 3p 4 5 6 7 9 0p tcl n l p o 1x 2x 3x 4x 5x 6x 7x 8x"입니다.

MANPATH
    $MANPATH를 설정했다면, 콜론으로 구분한 설명서 페이지 검색 경로로 값을 해석합니다. 환경 변수 처리 방식의 기본 동작 및 자세한 내용은 manpath(5)의 검색 경로 섹션을 살펴보십시오.

파일

/etc/man_db.conf
    man-db 구성 파일.

/usr/man/index.(bt|db|dir|pag)
    전통 전역 색인 데이터베이스 캐시입니다.

/var/catman/index.(bt|db|dir|pag)
    대체 또는 FSSTND 준수 전역 색인 데이터베이스 캐시입니다.

추가 참조
man(1), manpath(5), mandb(8)

저작자
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

버그
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db