Document the AUTHORS section in mdoc(7). Expand the description

of the AUTHORS section in mdoc.samples(7) to document how the
authors name should be specified.

PR:		docs/13131
Pointed out by: Alexey M. Zelkin <phantom@cris.net>

2 files changed, 7 insertions, 2 deletions

diff --git a/share/man/man7/mdoc.7 b/share/man/man7/mdoc.7
index 1b69894..0d8b3a9 100644
--- a/share/man/man7/mdoc.7
+++ b/share/man/man7/mdoc.7
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)mdoc.7	8.2 (Berkeley) 12/30/93
-.\"	$Id: mdoc.7,v 1.8 1998/12/04 00:51:17 jkoshy Exp $
+.\"	$Id: mdoc.7,v 1.9 1999/06/15 19:03:54 mpp Exp $
 .\"
 .Dd December 30, 1993
 .Os
@@ -122,6 +122,8 @@ If a standard is not applicable, the history
 of the subject should be given.
 .It Ar BUGS
 Gotchas and caveats.
+.It Ar AUTHORS
+Credits, if need be, should be placed here.
 .It Ar other
 Customized headers may be added at
 the authors discretion.
diff --git a/share/man/man7/mdoc.samples.7 b/share/man/man7/mdoc.samples.7
index 826bc03e..16e4215 100644
--- a/share/man/man7/mdoc.samples.7
+++ b/share/man/man7/mdoc.samples.7
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)mdoc.samples.7	8.2 (Berkeley) 12/30/93
-.\"	$Id: mdoc.samples.7,v 1.18 1999/06/24 00:18:46 mpp Exp $
+.\"	$Id: mdoc.samples.7,v 1.19 1999/06/24 00:59:40 mpp Exp $
 .\"
 .\" This tutorial sampler invokes every macro in the package several
 .\" times and is guaranteed to give a worst case performance
@@ -1999,6 +1999,9 @@ Any command which does not adhere to any specific standards
 should be outlined historically in this section.
 .It \&.Sh AUTHORS
 Credits, if need be, should be placed here.
+The
+.Ql \&.An
+macro should be used to specify the name of the person.
 .It \&.Sh DIAGNOSTICS
 Diagnostics from a command should be placed in this section.
 .It \&.Sh ERRORS