improve NAME section diagnostics;

confusing messages reported by Jan Stary <hans at stare dot cz>

1 files changed, 3 insertions, 5 deletions

diff --git a/mdoc.7 b/mdoc.7
index 119c4401..cf445be5 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -1930,11 +1930,9 @@ Examples:
 .Dl \&.An Kristaps Dzonsons \&Aq \&Mt kristaps@bsd.lv
 .Ss \&Nd
 A one line description of the manual's content.
-This may only be invoked in the
-.Em SYNOPSIS
-section subsequent the
-.Sx \&Nm
-macro.
+This is the mandatory last macro of the
+.Em NAME
+section and not appropriate for other sections.
 .Pp
 Examples:
 .Dl Pf . Sx \&Nd mdoc language reference