]> diplodocus.org Git - nmh/blobdiff - docs/README.manpages
Increment VERSION on the head to 1.7+dev.
[nmh] / docs / README.manpages
index 6d6111df8eb7616b768bf9a02866613154b6938f..86cd725cafd3f500cadbdd31182b5fabb3bbf8b4 100644 (file)
@@ -10,6 +10,8 @@ nmh manpages should be in this general form and section order:
 comp \- compose a message
 .\"
 .SH SYNOPSIS
 comp \- compose a message
 .\"
 .SH SYNOPSIS
+.HP 5
+.na
 .B comp 
 .RI [ +folder ]
 .RI [ msgs ]
 .B comp 
 .RI [ +folder ]
 .RI [ msgs ]
@@ -18,6 +20,7 @@ comp \- compose a message
 .RB [ \-use " | " \-nouse ]
 .RB [ \-version ]
 .RB [ \-help ]
 .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.
 .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"
 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
 .\" Leave out the BUGS section if there are none worth describing.
 .SH BUGS
 None
@@ -114,9 +117,10 @@ Program names
                .B comp
                .BR comp ,
 
                .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
 
 
 SYNPOSIS section