Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 04 Aug 2005 08:15:29 -0700
From:      "Gary W. Swearingen" <garys@opusnet.com>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/84550: mdoc(7) manpage erroneously requires SYNOPSIS section
Message-ID:  <2lvf2l20oe.f2l@mail.opusnet.com>
Resent-Message-ID: <200508041520.j74FK9p3000621@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         84550
>Category:       docs
>Synopsis:       mdoc(7) manpage erroneously requires SYNOPSIS section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Aug 04 15:20:09 GMT 2005
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?2lvf2l20oe.f2l>