GETNAME(8)

NAME
getNAME - get NAME sections from manual source for whatis/apropos data base

SYNOPSIS
getNAME [-itvw] path [path ...]

DESCRIPTION
The getNAME utility looks inside manual page sources to find the name of the page. It can be used to create a table of contents, report the style of manual, or to create an introductory manual page. By default, getNAME returns data for use in an apropos(1) database. getNAME is designed to be called from manual grovelling tools, not to be used directly.

Historically, makewhatis(8) used to use getNAME to get manpage names, but that's no longer the case.

OPTIONS
The following options are available:

-i  Print information useful in creating an introduction manual. See intro(1), intro(2), etc. for examples.

-t  Print information useful for creating a table of contents.

-v  Complain about incorrectly formatted man pages.

-w  Print information whether the manpage uses traditional man (“OLD”), new mandoc (“NEW”), or some unknown (“UNKNOWN”) macros.

SEE ALSO
man(1), catman(8), makewhatis(8)

HISTORY
The getNAME command first appeared in 2.0BSD.

BUGS
It would be nice if getNAME could deal with compressed and/or preformatted manual pages. Looks for .S[Hh] NAME for consistency checking, but that breaks man pages in other languages.