MAN(1)

명칭
man - 온라인 메뉴얼의 포맷, 표시를 행한다

서식
man [-adfhkotw] [-m machine] [-p string] [-M path] [-P pager] [-S list] [section] name ...

해설
man (은)는 온라인 메뉴얼을 포맷 해, 표시합니다. 이 버젼에서는, 환경 변수 MANPATH (와)과 PAGER (을)를 참조하므로, 각 유저가 고유의 온라인 메뉴얼을 가지는 일이나, 화면에서 볼 때의 페이쟈를 선택하는 것이 가능합니다. 섹션을 지정했을 경우, man (은)는 그 섹션만을 찾습니다. 또, 명령행 옵션이나 환경 변수에 의해, 검색하는 섹션의 순서나, 원시 파일을 처리하는 프리프로세서를 지정할 수도 있습니다. 시스템 관리 책임자의 설정에 따라서는, 디스크 스페이스를 절약하기 위해서, 포맷 끝난 온라인 메뉴얼을 `/usr/bin/gzip -c'명령에 의해 압축해 격납하도록(듯이) 할 수도 있습니다.

옵션을 이하에 나타냅니다:

-M path
    다른 manpath 를 지정합니다. 통상, man 하 manpath(1) ( man 바이너리에 짜넣어지고 있습니다)를 사용해, 검색하는 패스를 결정합니다. 이 옵션은 환경 변수 MANPATH 보다 우선됩니다.

-P pager
    사용하는 페이쟈를 지정합니다. 통상, man (은)는, more -s (을)를 사용합니다. 이 옵션은 환경 변수 PAGER 보다 우선됩니다.

-S list
    list 는 코론으로 단락지어진 검색하는 메뉴얼의 섹션의 리스트입니다. 이 옵션은 환경 변수 MANSECT 보다 우선됩니다.

-a  통상, man (은)는 최초로 발견된 메뉴얼 페이지를 표시한 후 종료합니다만, 이 옵션을 사용하면(자), 최초로 발견된 메뉴얼 페이지 뿐만이 아니라, name 에 매치 한 메뉴얼 페이지를 모두 표시합니다.

-d  메뉴얼 페이지는 표시하지 않고, 디버그용의 정보를 표시합니다.

-f  whatis (와)과 같습니다.

-h  헬프 메세지를 표시해 종료합니다.

-k  apropos (와)과 같습니다.

-m machine
    메뉴얼 페이지에 따라서는, 특정의 아키텍쳐에 특화한 것이 있습니다. man (은)는, 검색 대상의 모든 디렉토리안으로, 현재의 아키텍쳐와 같은 이름의 서브 디렉토리를 검색합니다. 머신 고유의 검색 범위가, 일반적인 검색 범위의 전에 검색됩니다. 현재의 머신 타입은, 환경 변수 MACHINE (을)를 특정의 아키텍쳐명으로 설정하는 것으로 바꿀 수 있습니다. 본옵션은, MACHINE 환경 변수에 우선합니다.

-o  원래의, 비로컬라이즈판 메뉴얼 페이지만을 검색합니다.

    디폴트에서는, man (은)는, 각 manpath(1) 원가요소마다 로컬라이즈판 서브 디렉토리를 검색합니다.

    로케일명은, 3 개의 환경 변수 LC_ALL, LC_CTYPE, LANG 가운데, 이 차례로 둘 수 있는 최초의 하늘은 아닌 것으로부터 얻을 수 있습니다.

    값을 결정할 수 없는 경우인가, 무효인 로케일명인 경우, 로컬라이즈되어 있지 않은 메뉴얼 페이지만이 검색됩니다.

    그렇지 않은 경우, man (은)는 다음의 서브 디렉토리를, 다음의 우선 순위로 검색합니다:

    <lang>_<country>.<charset>
    <lang>.<charset>
    en.<charset>

    예를 들면 “de_DE.ISO8859-1” 로케일의 경우, /usr/share/man manpath 원가요소중의 다음의 서브 디렉토리를 man (은)는 검색합니다:

    /usr/share/man/de_DE.ISO8859-1
    /usr/share/man/de.ISO8859-1
    /usr/share/man/en.ISO8859-1

    마지막으로, 로컬라이즈 된 메뉴얼 페이지가 발견되지 않았던 경우, 디폴트의 /usr/share/man 디렉토리를 검색합니다.

-p string
    nroff 나 troff 를 실시하기 전에 실행하는 프리프로세서의 순서를 지정합니다. 모든 프리프로세서가 인스톨 되고 있다고는인가 선. 프리프로세서와 그것을 지정하는데 사용되는 캐릭터는 이하와 같습니다. eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). 이 옵션은 환경 변수 MANROFFSEQ 보다 우선됩니다.

-t  메뉴얼 페이지를 포맷 하는데 /usr/bin/groff -S -man (을)를 사용해, 표준 출력에 출력합니다. /usr/bin/groff -S -man 의 출력은 표시하기 전에 어떠한 필터를 통할 필요가 있겠지요.

-w  메뉴얼 페이지의 표시는 실시하지 않고, 포맷이나 표시를 행해야 할 파일의 장소를 표시합니다.

환경 변수

LC_ALL, LC_CTYPE, LANG
    이러한 환경 변수는, 메뉴얼 페이지의 기호의 언어를 지정합니다 (전술의 -o 옵션을 참조해 주세요).

MACHINE
    MACHINE 하지만 설정되면(자), 머신 고유의 서브 디렉토리를 검색할 경우에, 이 값이 현재의 머신 타입에 우선합니다.

MANPATH
    MANPATH 하지만 세트 되고 있으면, 그 값은 메뉴얼 페이지를 검색하는 패스로 해서 사용됩니다.

MANROFFSEQ
    MANROFFSEQ 하지만 세트 되고 있으면, 그 값은 nroff 나 troff 를 실시하기 전에 실행된다 프리프로세서의 순서를 나타내는데 사용됩니다. 디폴트에서는, nroff 의 전에 tbl 프리프로세서가 실행됩니다.

MANSECT
    MANSECT 하지만 세트 되고 있으면, 그 값은 어느 메뉴얼 섹션을 검색하는지를 결정하는데 사용됩니다.

PAGER
    PAGER 하지만 세트 되고 있으면, 그 값은 메뉴얼 페이지를 표시하는데 사용된다 프로그램의 이름을 지정하는데 사용됩니다. 세트되어 있지 않으면, more -s 하지만 사용됩니다.

사용예
통상, getopt 의 적절한 메뉴얼 페이지 정보를 검색하려면 , 다음과 같이 합니다:

    man getopt

한편, 특정의 메뉴얼 섹션, 예를 들면 getopt(3) (을)를 검색하려면 , 다음과 같이 합니다:

    man 3 getopt

관련 항목
apropos(1), groff(1), manpath(1), more(1), whatis(1), man(7), mdoc(7)

버그
-t 옵션은 troff(1) 좋아하는 프로그램이 인스톨 되고 있는 경우만 유효합니다.