2019-09-21 00:47:00 +03:00
|
|
|
## Name
|
|
|
|
|
|
|
|
|
|
man - read manual pages
|
|
|
|
|
|
|
|
|
|
## Synopsis
|
|
|
|
|
|
|
|
|
|
```**sh
|
|
|
|
|
$ man page
|
|
|
|
|
$ man section page
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
|
|
`man` finds, loads and displays the so-called manual pages,
|
2020-02-18 16:54:29 +08:00
|
|
|
or man pages for short, from the SerenityOS manual. You're reading
|
2019-09-21 00:47:00 +03:00
|
|
|
the manual page for `man` program itself right now.
|
|
|
|
|
|
|
|
|
|
## Sections
|
|
|
|
|
|
2020-02-18 16:54:29 +08:00
|
|
|
The SerenityOS manual is split into the following *sections*, or *chapters*:
|
2019-09-21 00:47:00 +03:00
|
|
|
|
2021-01-03 00:26:27 +00:00
|
|
|
1. User programs
|
2019-09-21 00:47:00 +03:00
|
|
|
2. System calls
|
2019-09-29 16:25:29 -04:00
|
|
|
3. Libraries
|
|
|
|
|
4. Special files
|
|
|
|
|
5. File formats
|
|
|
|
|
6. Games
|
|
|
|
|
7. Miscellanea
|
|
|
|
|
8. Sysadmin tools
|
|
|
|
|
|
|
|
|
|
Sections are subject to change in the future.
|
2019-09-21 00:47:00 +03:00
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
To open documentation for the `echo` command:
|
|
|
|
|
```sh
|
|
|
|
|
$ man echo
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
To open the documentation for the `mkdir` command:
|
|
|
|
|
```sh
|
|
|
|
|
$ man 1 mkdir
|
|
|
|
|
```
|
|
|
|
|
Conversely, to open the documentation about the `mkdir()` syscall:
|
|
|
|
|
```sh
|
|
|
|
|
$ man 2 mkdir
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Files
|
|
|
|
|
|
|
|
|
|
`man` looks for man pages under `/usr/share/man`. For example,
|
|
|
|
|
this man page should be located at `/usr/share/man/man1/man.md`.
|
2021-07-06 19:47:00 -06:00
|
|
|
|
|
|
|
|
## See Also
|
|
|
|
|
|
2021-09-11 14:06:29 +02:00
|
|
|
* [`less`(1)](less.md) For the terminal pager that `man` uses by default
|