version 1.34, 2018/11/22 11:30:23 |
version 1.35, 2019/03/09 15:55:01 |
Line 218 Guidelines for writing |
|
Line 218 Guidelines for writing |
|
man pages can be found in |
man pages can be found in |
.Xr mdoc 7 . |
.Xr mdoc 7 . |
.Pp |
.Pp |
|
The |
|
.Xr mandoc.db 5 |
|
database is used for looking up manual page entries. |
|
In cases where the database is absent, outdated, or corrupt, |
|
.Nm |
|
falls back to looking for files called |
|
.Ar name . Ns Ar section . |
If both a formatted and an unformatted version of the same manual page, |
If both a formatted and an unformatted version of the same manual page, |
for example |
for example |
.Pa cat1/foo.0 |
.Pa cat1/foo.0 |
and |
and |
.Pa man1/foo.1 , |
.Pa man1/foo.1 , |
exist in the same directory, only the unformatted version is used. |
exist in the same directory, only the unformatted version is used. |
|
The database is kept up to date with |
|
.Xr makewhatis 8 , |
|
which is run by the |
|
.Xr weekly 8 |
|
maintenance script. |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width MANPATHX |
.Bl -tag -width MANPATHX |
.It Ev MACHINE |
.It Ev MACHINE |