From owner-freebsd-doc@FreeBSD.ORG Mon Aug 15 15:40:10 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 85F8916A41F for ; Mon, 15 Aug 2005 15:40:10 +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 71CC043D53 for ; Mon, 15 Aug 2005 15:40:09 +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 j7FFe9rg045558 for ; Mon, 15 Aug 2005 15:40:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j7FFe9YE045557; Mon, 15 Aug 2005 15:40:09 GMT (envelope-from gnats) Resent-Date: Mon, 15 Aug 2005 15:40:09 GMT Resent-Message-Id: <200508151540.j7FFe9YE045557@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 CAF2716A41F for ; 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 ; 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 ; 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" To: FreeBSD-gnats-submit@FreeBSD.org Cc: Subject: docs/84955: [patch] mdoc(7) manpage should mention missing documentation in BUGS 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: Mon, 15 Aug 2005 15:40:10 -0000 >Number: 84955 >Category: docs >Synopsis: [patch] mdoc(7) manpage should mention missing documentation in BUGS >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: Mon Aug 15 15:40:08 GMT 2005 >Closed-Date: >Last-Modified: >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: >Unformatted: