From garys@opusnet.com  Mon Aug 15 15:37:22 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 CAF2716A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 15 Aug 2005 15:37:22 +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 6ED8B43D48
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 15 Aug 2005 15:37:22 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id A6B038FE00A0; Mon, 15 Aug 2005 08:37:20 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j7FFc3Fs026325
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 15 Aug 2005 08:38:03 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j7FFbwwW026324;
	Mon, 15 Aug 2005 08:37:58 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <7zoe7zxlbd.e7z@mail.opusnet.com>
Date: Mon, 15 Aug 2005 08:37:58 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: [patch] mdoc(7) manpage should mention missing documentation in
 BUGS
X-GNATS-Notify:

>Number:         84955
>Category:       docs
>Synopsis:       [patch] mdoc(7) manpage should mention missing documentation in
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ru
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 15 15:40:08 GMT 2005
>Closed-Date:    
>Last-Modified:  Mon Nov 06 15:46:51 GMT 2006
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

The mdoc(7) manpage section "Miscellaneous Macros" discusses
poorly-documneted macros.

Also, the "Keeps" subsection says "More work needs to be done..."


>How-To-Repeat:
n/a

>Fix:

Rather than filing PRs on these (to be suspended or left open
forever), just make note of the problems in the BUGS section:


--- mdoc..orig.7	Sat Aug  6 13:19:51 2005
+++ mdoc.7	Sat Aug  6 13:25:01 2005
@@ -4086,6 +4086,15 @@
 .Pp
 The list and display macros do not do any keeps
 and certainly should be able to.
+.Pp
+The "keep" macros need more work.
+See the
+.Sx Keeps
+subsection.
+.Pp
+The whole
+.Sx "MISCELLANEOUS MACROS"
+section documents more bugs in this manual page.
 .\" Note what happens if the parameter list overlaps a newline
 .\" boundary.
 .\" to make sure a line boundary is crossed:
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Nov 6 15:46:34 UTC 2006 
Responsible-Changed-Why:  
Ruslan's domain.  ;) 

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