手冊頁

手冊頁（man page，Manual pages 的縮寫）是指在 Unix 或類 Unix 作業系統中查詢指令使用手冊，使用者可以執行 man 命令查詢指令用法。簡體中文直譯為手冊頁，臺灣正體中文翻譯為使用手冊、線上手冊。在 Unix 或類 Unix 作業系統中有非常多的指令，通常使用者（甚至是資深的系統管理者）都無法記住每個指令的詳細使用方式，尤其是那些有非常多引數可以用的指令，就算是天天在用的 - ls，可能也不是很清楚它所有的引數如何使用。所幸一般 UNIX/Linux 系統中的指令都會附帶相關的線上說明手冊（Manual pages，簡稱 man page），提供使用者查詢與參考，內容包括計算機程式（庫和系統呼叫）。

用法

為查閱某個 Unix 命令的手冊頁，使用者可以在命令列介面執行如下命令：

man

範例：查詢 cal (calendar) 指令用法。

user101@twfo-mdc ~$ man cal

CAL (1) BSD General Commands Manual CAL (1)

NAME

cal - displays a calendar

SYNOPSIS

cal -smjy13 month year

DESCRIPTION

Cal displays a simple calendar. If arguments are not specified, the cur-

rent month is displayed. The options are as follows:

-1 Display single month output. (This is the default.)

-3 Display prev/current/next month output.

-s Display Sunday as the first day of the week. (This is the

default.)

-m Display Monday as the first day of the week.

-j Display Julian dates (days one-based, numbered from January 1).

q -y Display a calendar for the current year.

A single parameter specifies the year (1 - 9999) to be displayed; note

the year must be fully specified: “cal 89” will not display a calendar

for 1989. Two parameters denote the month (1 - 12) and year. If no

parameters are specified, the current month's calendar is displayed.

A year starts on Jan 1.

The Gregorian Reformation is assumed to have occurred in 1752 on the 3rd

of September. By this time, most countries had recognized the reforma-

tion (although a few did not recognize it until the early 1900's.) Ten

days following that date were eliminated by the reformation, so the cal-

endar for that month is a bit unusual.

HISTORY

A cal command appeared in Version 6 AT&T UNIX.

OTHER VERSIONS

Several much more elaborate versions of this program exist, with support

for colors, holidays, birthdays, reminders and appointments, etc. For

example, try the cal from http://home.sprynet.com/~cbagwell/projects.html

or GNU gcal.

BSD June 6, 1993 BSD

例如，“man ftp”。為了方便使用者查閱輸出的資訊，man 命令一般會提供一個 Less。

按慣例，man 頁面可以按照 “程式名 (區段)” 的標記來查閱：例如。相同的手冊頁標記可能出現在多個不同的區段（section）中，例如相同的名字在系統呼叫、使用者命令或 Troff 中重複出現的時候。比如與 ，以及與。

訪問非預設手冊頁區段的語法在不同的軟體實現中是不一樣的。例如，在 Solaris 中，閱讀的語法為：

man -s 3c printf

在 Linux 和類 BSD 系統中，相同的命令語法為：

man 3 printf

此命令在手冊頁的第 3 區段中搜尋 “printf” 的資訊。

歷史

《 UNIX 程式設計師手冊 》1971 年 11 月 3 日第一次出版。1971 年，在主管道格拉斯・麥克羅伊的堅持下，丹尼斯・裡奇和肯・湯普遜編寫了第一份實際意義上的手冊頁。除了手冊頁，《UNIX 程式設計師手冊》還彙整了一些簡短的論文，其中一部分是（例如 Unix 的一般用法、C 語言，以及 Yacc 等工具），另一部分是對作業系統功能的更詳細的說明。手冊的印刷版最初裝在一個活頁夾中，但和 Research Unix 第七版的手冊被分為兩卷，印刷版的手冊頁成為了其第 1 卷。

Unix 或類 Unix 作業系統手冊頁是用 troff 軟體包排版的，是一組 - man 巨集。當時，手冊頁系統帶來的聯機文件可用性被認為是一項偉大的進步。時至今日，幾乎所有的 Unix 命令列應用程式都附帶了手冊頁，而很多 Unix 使用者將缺少手冊頁視為低質量應用程式的一個標誌。事實上，有些專案（如 Debian）不辭勞苦的為缺乏手冊頁的應用編寫手冊頁；4.4BSD 的現代繼任者也將手冊頁作為系統文件的主要形式之一（將舊的 - man 巨集用新的 - mdoc 巨集取代）。

幾乎沒有什麼替代品能像 man 那樣流行，只有 GNU 計劃的系統可能是個例外。

此外，一些 Unix 圖形使用者介面應用程式（尤其是那些使用 GNOME 和 KDE 開發環境構建的）現在提供的 HTML 版本的終端使用者手冊，幷包含內嵌的 HTML 閱讀器，如 Yelp，以供閱讀應用程式中的幫助文件。

Unix 或類 Unix 作業系統手冊頁通常是用英文寫的，在某些系統上可能有翻譯成其他語言的版本。

手冊頁的預設格式是 troff，使用 - man（著重展現）或 - mdoc 巨集軟體包（著重語義）。可以把手冊頁排版成 PostScript、PDF 和其他各種格式進行檢視或列印。

大多數 Unix 系統有一個 man2html 命令的軟體包，該命令允許使用者使用 HTML 瀏覽器瀏覽手冊頁（例如，FreeBSD 的 textproc/man2html，或某些 Linux 發行版中的 man）。

2010 年，OpenBSD 宣佈淘汰 troff，改用展示手冊頁。

手冊區段

在 Research Unix、BSD、OS X 和 Linux 中，手冊通常被分為 8 個區段，安排如下：

Unix System V 採用了類似的編號方案，但順序不同：

在某些系統中還有下述的區段可用：

一些區段利用字尾進一步細分了。例如在一些系統中，區段 3C 是 C 函式庫呼叫，3M 是數學（Math）函式庫，等等。這樣做的結果是區段 8（系統管理命令）有時也被移動到區段 1M（作為命令區段的子區段）。一些子區段字尾有跨區段的一般含義：

佈局

所有的手冊頁遵循一個常見的佈局，其為透過簡單的 ASCII 文字展示而最佳化，而這種情況下可能沒有任何形式的高亮或字型控制。一般包括以下部分內容：

 NAME（名稱）: 該命令或函式的名稱，接著是一行簡介。

 SYNOPSIS（概要）: 對於命令，正式的描述它如何執行，以及需要什麼樣的命令列引數。對於函式，介紹函式所需的引數，以及哪個標頭檔案包含該函式的定義。

 DESCRIPTION（說明）: 命令或函式功能的文字描述。

 EXAMPLES（示例）: 常用的一些示例。

 SEE ALSO（參見）: 相關命令或函式的列表。

也可能存在其他部分內容，但這些部分沒有得到跨手冊頁的標準化。常見的例子包括：OPTIONS（選項），EXIT STATUS（退出狀態），ENVIRONMENT（環境），BUGS（程式漏洞），FILES（檔案），AUTHOR（作者），REPORTING BUGS（已知漏洞），HISTORY（歷史）和 COPYRIGHT（版權）。

使用線上手冊

參考：archlinux 社群的 使用線上手冊