{{위키데이터 속성 추적}}
{{소문자}}
[[파일:Unix manual.png|섬네일|man에 대한 매뉴얼 페이지|330x330px]]

'''man 페이지'''(<small>←매뉴얼 페이지(Manual pages)의 줄임말</small>)는 거의 모든 [[유닉스]] 및 [[유닉스 계열]]의 [[운영 체제]]에 기본으로 설치되는 광범위의 문서들이다. <code>man</code>라는 유닉스 명령어를 이용하면 이 문서들을 볼 수 있다. 각 페이지는 개별 문서로 이루어져 있다.

== 역사 ==
[[유닉스의 역사]] 처음 2년 동안은 문서화란 존재하지 않았다.<ref name="reader">{{기술보고서 인용 |first1=M. D. |last1=McIlroy |authorlink1=Doug McIlroy |year=1987 |url=http://www.cs.dartmouth.edu/~doug/reader.pdf |title=A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986 |series=CSTR |number=139 |institution=Bell Labs}}</ref> [http://man.cat-v.org/unix-1st/ 유닉스 프로그래머의 매뉴얼]이 1971년 11월 3일 처음 출판되었다.

실제 최초의 man page는 1971년 [[더글러스 매클로이]]의 주장으로 [[데니스 리치]]와 [[켄 톰프슨]]이 작성하였다. man page 외에 "프로그래머의 매뉴얼" 또한 짧은 문서들을 모아두었고, 그 중 일부는 [[강좌]]였고 그 외에는 운영 체제 기능에 대한 더 자세한 설명이었다.

Man page는 일반적으로 영어로 작성되어 있지만, 시스템에서 다른 언어로의 번역 또한 가능하다.

== 사용 ==
[[셸]] 프롬프트에서 다음과 같은 식을 이용하면 유닉스 명령어에 대한 매뉴얼 페이지를 볼 수 있다.
<syntaxhighlight lang="bash">
 man <명령어_이름>
</syntaxhighlight>
예를 들면, "<code>man ftp</code>"과 같이 입력할 수 있다. 일반적으로 man의 기본 페이저는 초기값이 [[Less (유닉스)|less]]이다.<ref>{{웹 인용|url=https://www.freebsd.org/cgi/man.cgi?query=man&apropos=0&sektion=0&manpath=FreeBSD+10.3-RELEASE+and+Ports&arch=default&format=html|제목=man|웹사이트=www.freebsd.org|확인날짜=2016-07-04}}</ref><ref>{{웹 인용|url=http://man7.org/linux/man-pages/man1/man.1.html|제목=man(1) - Linux manual page|웹사이트=man7.org|확인날짜=2016-07-04}}</ref> 즉, man 페이지를 보여줄 때 less를 사용한다. 그렇기 때문에 페이지를 탐색할 때 less의 명령어를 사용한다. (ex. {{키눌림|Space bar}}: 다음 페이지로 이동. q: 종료.)

페이저는 환경변수 <syntaxhighlight lang="bash"> MANPAGER </syntaxhighlight> 또는 <syntaxhighlight lang="bash"> PAGER</syntaxhighlight>를 덮어씌워서 자신이 원하는 프로그램(ex. [[Vim]])으로 설정할 수 있다.

설명 페이지들은 전통적으로 "이름(단락)" 기호를 이용하여 나타낸다. 예를 들면, {{man|1|ftp|||inline}}라고 입력한다. 하나의 명령어에 대한 매뉴얼 페이지가 여러 단락에서 나타나기도 한다.

예를 들면, 리눅스와 BSD 계열의 {{man|3|printf|||inline}}의 설명을 보기 위한 명령어는 다음과 같다.
<syntaxhighlight lang="bash">
 man 3 printf
</syntaxhighlight>

== 매뉴얼 단락 ==
매뉴얼은 일반적으로 여덟 개의 단락으로 나뉘어 있는데, ([[BSD]], [[유닉스]], [[리눅스]] 등에서의) 단락은 다음과 같이 구성된다.

{| class="wikitable"
!단락
!설명
|-
|1
| 일반 [[명령어 (컴퓨팅)|명령어]]
|-
|2
|[[시스템 호출]]
|-
|3
|[[C 표준 라이브러리]] 함수들
|-
|4
|[[장치 파일|특수 파일]] (보통 /dev에서 발견되는 장치 파일)과 [[장치 드라이버|드라이버]]
|-
|5
|[[파일 형식]]과 convensions
|-
|6
|[[PC 게임|게임]]과 [[화면 보호기]]
|-
|7
|기타
|-
|8
|시스템 관리 [[명령어 (컴퓨팅)|명령어]]와 [[데몬 (컴퓨팅)|데몬]]
|}

[[유닉스 시스템 V]]에서는 비슷한 방식을 사용하지만, 순서가 다르다.

{| class="wikitable"
!단락
!설명
|-
|1
| 일반 [[명령어 (컴퓨팅)|명령어]]
|-
|1M
|시스템 관리 [[명령어 (컴퓨팅)|명령어]]와 [[데몬 (컴퓨팅)|데몬]]
|-
|2
|[[시스템 호출]]
|-
|3
|[[C 표준 라이브러리]] 함수들
|-
|4
|[[파일 형식]]과 convensions
|-
|5
|Miscellanea
|-
|6
|[[PC 게임|게임]]과 [[화면 보호기]]
|-
|7
|[[장치 파일|특수 파일]] (보통 /dev에서 발견되는 장치 파일)과 [[장치 드라이버|드라이버]]
|-
|}

어떤 시스템에서는 다음 단락이 나타난다.

{| class="wikitable"
!단락
!설명
|-
|0
|[[C 표준 라이브러리]] [[헤더 파일]]들
|-
|9
|[[커널 (컴퓨팅)|커널]] 루틴들
|-
|n
|[[Tcl]]/[[Tk]] 키워드들
|-
|x
|[[X 윈도 시스템]]
|}

단락들은 숫자 다음에 나타나는 문자들에 더 나뉜다. 예를 들면, 3C는 C 라이브러리 호출, 3M 은 수학 라이브러리 등등.

<code>man</code>명령어에 사용할 수 있는 옵션을 보려면 터미널에서 <code>man man</code>을 입력한다.

== 레이아웃 ==
모든 man page들은 잠재적으로는 어떠한 글꼴 제어 강조 부분 없이 단순 [[ASCII]] 텍스트 디스플레이에 출력하기에 최적화된 공통 레이아웃을 따른다. 단락은 다음을 포함할 수 있다:

; NAME: 명령이나 함수의 이름으로, 한 줄의 설명이 뒤따른다.
; SYNOPSIS: 명령의 경우, 실행 방법 및 명령 줄 옵션이 어떠한지를 설명한다. 프로그램 함수의 경우 함수가 취하는 매개변수의 목록과 어느 파일 헤더가 이에 대한 정의를 포함하는지 설명한다.
; DESCRIPTION: 명령이나 함수의 기능에 대한 텍스트 설명이다.
; EXAMPLES: 일반적인 사용법의 몇 가지 예시이다.
; SEE ALSO: 관련 명령이나 함수의 목록이다.

그 밖의 단락들도 존재할 수 있지만, man page 간에 제대로 표준화된 것들은 아니다. 일반적인 예로는 다음을 포함한다: OPTIONS, EXIT STATUS, ENVIRONMENT, BUGS, FILES, AUTHOR, REPORTING BUGS, HISTORY, COPYRIGHT.

== 같이 보기 ==
* [[리드미]]
* [[RTFM]]
== 각주 ==
{{각주}}

== 외부 링크 ==
* [http://man.cat-v.org/unix-1st/ ''Unix Programmer's Manual''] 1971년 11월 3일, ([https://web.archive.org/web/20080518013206/http://cm.bell-labs.com/cm/cs/who/dmr/1stEdman.html 스캔된 원본 PS 와 PDF] 참고).
* [https://web.archive.org/web/20120502051559/http://primates.ximian.com/~flucifredi/man/ man]: 오픈소스 버전의 매뉴얼, Red Hat, Mac OS X 등에 사용됨.
* [http://man-db.nongnu.org/ man-db]: 다른 버전의 매뉴얼, 데비안/우분투, SUSE 등에서 사용됨.
* [http://manpages.bsd.lv UNIX 매뉴얼 페이지]: 유닉스 매뉴얼 페이지 언어 ''mdoc''의 리소스.
* {{man|1|man||온라인 매뉴얼 페이지 형식}}

{{유닉스 명령어}}
{{기본정렬:Man Page}}

[[분류:기술 소통]]
[[분류:유닉스 SUS2008 유틸리티]]
[[분류:온라인 도움말]]