From garys@opusnet.com  Thu Aug  4 15:13:52 2005
Return-Path: <garys@opusnet.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 54C2416A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  4 Aug 2005 15:13:52 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id EAC7143D48
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  4 Aug 2005 15:13:51 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id A0AE4E76006E; Thu, 04 Aug 2005 08:13:50 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j74FFY1c042961
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 4 Aug 2005 08:15:34 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j74FFTEg042960;
	Thu, 4 Aug 2005 08:15:29 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <2lvf2l20oe.f2l@mail.opusnet.com>
Date: Thu, 04 Aug 2005 08:15:29 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: mdoc(7) manpage erroneously requires SYNOPSIS section
X-GNATS-Notify:

>Number:         84550
>Category:       docs
>Synopsis:       mdoc(7) manpage erroneously requires SYNOPSIS section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Aug 04 15:20:09 GMT 2005
>Closed-Date:    Thu Oct 12 20:53:45 GMT 2006
>Last-Modified:  Thu Oct 12 20:53:45 GMT 2006
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

The "a Manual Page Template" (BTW, notice the bad capitalization) says
that the SYNOPSIS section is "required" and "mandatory", while intro(1)
.. intro(9), netstat(1), rtld(1), sigstack(2), libarchive(3), geom(4), 
<almost all>(5), tuning(7), boot(8), module(9), and many others need or
don't have a SYNOPSIS.

>How-To-Repeat:
n/a

>Fix:
Remove the requirement. Capitalize "a Manual..".
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: simon 
Responsible-Changed-When: Mon Aug 8 15:54:11 GMT 2005 
Responsible-Changed-Why:  
Over to our mdoc guru since he's the main guy to decide if we want to 
change this in mdoc(7). 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84550 
State-Changed-From-To: open->suspended 
State-Changed-By: garys 
State-Changed-When: Sun Aug 28 19:48:19 GMT 2005 
State-Changed-Why:  
Problem submitted to vender who agreed. 
Re-analyze after next update from vender. 


Responsible-Changed-From-To: ru->garys 
Responsible-Changed-By: garys 
Responsible-Changed-When: Sun Aug 28 19:48:19 GMT 2005 
Responsible-Changed-Why:  
Ruslan said I could take this PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84550 
Responsible-Changed-From-To: garys->freebsd-doc 
Responsible-Changed-By: garys 
Responsible-Changed-When: Sat Oct 1 23:19:28 GMT 2005 
Responsible-Changed-Why:  
Maintainer agreed the change would be good, but apparently is 
waiting (a month now) for a patch.  I now don't care what happens 
with this PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84550 
State-Changed-From-To: suspended->closed 
State-Changed-By: ru 
State-Changed-When: Thu Oct 12 20:53:15 UTC 2006 
State-Changed-Why:  
Originator lost interest in this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84550 
>Unformatted:
