From 4beea88ea87d577c74e93debf4129aeb46dc6707 Mon Sep 17 00:00:00 2001 From: "G. Branden Robinson" Date: Mon, 12 Dec 2022 16:03:57 -0600 Subject: groff_mdoc(7): Revise sectn "A man page template". Revise `Dt`'s second argument description to sync with forthcoming change to the macro's own presentation. Set references to the package's own macros with ".Pf . Ic \&Xx", following a suggestion from Ingo Schwarze. --- tmac/groff_mdoc.7.man | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'tmac/groff_mdoc.7.man') diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man index 2a40336fa..f752947c2 100644 --- a/tmac/groff_mdoc.7.man +++ b/tmac/groff_mdoc.7.man @@ -661,7 +661,7 @@ to construct a man page from the following template. .Bd -literal -offset indent \&.\e" The following commands are required for all man pages. \&.Dd date -\&.Dt topic [section-identifier [volume-name]] +\&.Dt topic [section-identifier [section-keyword-or-title]] \&.Os [package-or-operating system [version-or-release]] \&.Sh Name \&.Nm topic @@ -697,10 +697,10 @@ to construct a man page from the following template. . .Pp The first items in the template are the commands -.Ql \&Dd , -.Ql \&Dt , +.Pf . Ic \&Dd , +.Pf . Ic \&Dt , and -.Ql \&Os . +.Pf . Ic \&Os . . These correspond to the document date; the page topic and section of the manual to which the page belongs; @@ -713,7 +713,7 @@ These commands identify the page and are discussed below in section . .Pp The remaining items in the template are section headings -.Pf ( Ql \&Sh ) ; +.Pf ( Pf . Ic \&Sh ) ; of which .Sx Name and -- cgit v1.2.1