Bug 84519

Summary: [patch] mdoc(7) manpage needs more about AUTHORS
Product: Documentation Reporter: Gary W. Swearingen <garys>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Gary W. Swearingen 2005-08-03 16:20:05 UTC 
Many manpages name "authors" without indicating whether it applies
to the manpage or the software.

The mdoc manpage doesn't require it.  Nor does it say that
author's e-mail addresses should be inclosed in angle brackets,
which seems to be a de facto standard.

Fix: The bit about e-mail address quoting probably belongs in a
manpage-wide discussion, but I didn't see a good place for it.

How-To-Repeat: n/a
Comment 1 Gary W. Swearingen freebsd_committer freebsd_triage 2005-08-28 21:08:00 UTC 
Responsible Changed
From-To: freebsd-doc->garys

I'll work with vender on this.
Comment 2 Gary W. Swearingen freebsd_committer freebsd_triage 2005-10-02 00:08:41 UTC 
State Changed
From-To: open->suspended

I sent patch to maintainter over a month ago. 
I don't care what happens with this PR.
Comment 3 Gary W. Swearingen freebsd_committer freebsd_triage 2005-10-02 00:08:41 UTC 
Responsible Changed
From-To: garys->freebsd-doc

I sent patch to maintainter over a month ago. 
I don't care what happens with this PR.
Comment 4 ru freebsd_committer freebsd_triage 2006-10-12 21:31:42 UTC 
State Changed
From-To: suspended->closed

This change has been accepted upstream (from ChangeLog): 

: 2005-08-29  Gary W. Swearingen  <garys@opusnet.com> 
:  
:         * tmac/groff_mdoc.man: Go into more details how the `AUTHORS' 
:         section should look like.