매뉴얼 페이지를 직접 표시하려면 어떻게 해야 합니까?

매뉴얼 페이지를 직접 표시하려면 어떻게 해야 합니까?

나는 패키징하고 있는 프로그램의 매뉴얼 페이지를 작성하고 있습니다. 내가 만든 맨페이지 파일을 표시하여 문제가 없는지 확인하려면 어떻게 해야 합니까? man설치된 맨페이지를 이름으로 검색하는 대신 내 파일을 명령에 직접 전달할 수 있는 방법이 있습니까 ?

man myprog.1나는 다음과 같은 작업을 시도했지만 man < myprog.1두 경우 모두 매뉴얼 페이지를 찾을 수 없다는 오류가 발생했습니다.

답변1

man로컬 파일을 읽는 옵션이 있습니다.-l

-l, --local-file

'로컬' 모드를 활성화합니다. 시스템의 수동 컬렉션을 검색하는 대신 로컬 수동 파일의 형식을 지정하고 표시합니다. 각 매뉴얼 페이지 인수는 올바른 형식의 nroff 소스 파일로 해석됩니다. cat 파일이 생성되지 않습니다.

'-'가 인수 중 하나로 나열되면 stdin에서 입력을 가져옵니다. 이 옵션을 사용하지 않고 사람이 필요한 페이지를 찾는 데 실패하면 오류 메시지를 표시하기 전에 이름을 파일 이름으로 사용하고 정확히 일치하는 항목을 찾아 이 옵션이 제공된 것처럼 작동하려고 시도합니다.

따라서 다음을 통해 진행 중인 작업을 미리 볼 수 있습니다.

man -l /path/to/manfile.1

답변2

옵션 이전의 시스템에 대한 '구식' 방식은 다음 -l과 같습니다.

nroff -man filename | more -s

답변3

저는 간단하게 사용해봤는데

man ./path/to/man.1

경로에 슬래시를 포함해야 합니다. 그렇지 않으면 시스템 디렉터리를 검색합니다. 내가 가지고 있는 Linux 및 OS X 시스템에서 작동합니다(후자는 없습니다 -l).

$ cd /tmp
$ cp /usr/share/man/man1/ls.1 .
$ man ls.1
No manual entry for ls.1
$ man ./ls.1     # works

답변4

Solaris에서 -M스위치는 man맨페이지의 검색 경로를 재정의합니다.

man -M path/to/man myprog

맨페이지 파일은 섹션 및 마크업 언어에 해당하는 적절한 하위 디렉토리에 있어야 합니다(예: path/to/man/man1/myprog.1섹션 1의 nroff-manpage의 경우).

관련 정보