Use headings to create a hierarchical structure for your document. The ms macros print headings in bold, using the same font family and point size as the body text.
The following describes the heading macros:
If you specify heading levels out of sequence, such as invoking ‘.NH 3’ after ‘.NH 1’,
groffprints a warning on standard error.
After invocation of
NH, the assigned section number is made available in the strings
SN-DOT(as it appears in a printed section heading with default formatting, followed by a terminating period), and
SN-NO-DOT(with the terminating period omitted). The string
SNis also defined, as an alias for
SN-DOT; if preferred, you may redefine it as an alias for
SN-NO-DOT, by including the initialization.als SN SN-NO-DOT
at any time before you would like the change to take effect.
You may control the style used to print section numbers, within numbered section headings, by defining an appropriate alias for the string
SN-STYLE. The default style, in which the printed section number is followed by a terminating period, is obtained by defining the alias.als SN-STYLE SN-DOT
If you prefer to omit the terminating period, from section numbers appearing in numbered section headings, you may define the alias.als SN-STYLE SN-NO-DOT
Any such change in section numbering style becomes effective from the next use of
.NH, following redefinition of the alias for
The optional match-level argument is a GNU extension. It is a number indicating the level of the heading, in a manner analogous to the curr-level argument to
.NH. Its purpose is to match the point size, at which the heading is printed, to the size of a numbered heading at the same level, when the
PSINCRheading size adjustment mechanism is in effect. See ms Document Control Registers.
HORPHANS register (see ms Document Control Registers)
operates in conjunction with the
SH macros, to
inhibit the printing of orphaned section headings at the bottom of any