X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/453d2338500092e1afafca22bb7c81c3de6f66f9..82538114a7761232df236f489e2d59f6e91cde8c:/docs/README.manpages

diff --git a/docs/README.manpages b/docs/README.manpages
index 6d6111df..86cd725c 100644
--- a/docs/README.manpages
+++ b/docs/README.manpages
@@ -10,6 +10,8 @@ nmh manpages should be in this general form and section order:
 comp \- compose a message
 .\"
 .SH SYNOPSIS
+.HP 5
+.na
 .B comp 
 .RI [ +folder ]
 .RI [ msgs ]
@@ -18,6 +20,7 @@ comp \- compose a message
 .RB [ \-use " | " \-nouse ]
 .RB [ \-version ]
 .RB [ \-help ]
+.ad
 .SH DESCRIPTION
 .B Comp
 is used to create a new message to be mailed.  It copies something.
@@ -47,12 +50,12 @@ filename2
 description of filename2
 .\"
 .SH "SEE ALSO"
-.IR dist (1),
-.IR forw (1),
-.IR repl (1),
-.IR send (1),
-.IR whatnow (1),
-.IR mh-profile (5)
+.BR dist (1),
+.BR forw (1),
+.BR repl (1),
+.BR send (1),
+.BR whatnow (1),
+.BR mh-profile (5)
 .\" Leave out the BUGS section if there are none worth describing.
 .SH BUGS
 None
@@ -114,9 +117,10 @@ Program names
 		.B comp
 		.BR comp ,
 
-	If this is a manpage reference, use:
+	The first reference to a documented command should be in the form of
+	a manpage reference:
 
-		.IR mh-draft (5)
+		.BR comp (1)
 
 SYNPOSIS section