From owner-freebsd-doc@FreeBSD.ORG Thu Aug 4 15:20:11 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5D9FC16A41F for ; Thu, 4 Aug 2005 15:20:11 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12B2443D58 for ; Thu, 4 Aug 2005 15:20:10 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j74FK9rE000622 for ; Thu, 4 Aug 2005 15:20:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j74FK9p3000621; Thu, 4 Aug 2005 15:20:09 GMT (envelope-from gnats) Resent-Date: Thu, 4 Aug 2005 15:20:09 GMT Resent-Message-Id: <200508041520.j74FK9p3000621@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, 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 ; 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 ; 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 ; 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" To: FreeBSD-gnats-submit@FreeBSD.org Cc: Subject: docs/84550: mdoc(7) manpage erroneously requires SYNOPSIS section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: garys@opusnet.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 04 Aug 2005 15:20:11 -0000 >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), (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: