From owner-freebsd-doc@FreeBSD.ORG  Mon May 12 09:37:28 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id CEAB937B401; Mon, 12 May 2003 09:37:28 -0700 (PDT)
Received: from rwcrmhc53.attbi.com (rwcrmhc53.attbi.com [204.127.198.39])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 23EF143F85; Mon, 12 May 2003 09:37:28 -0700 (PDT)
	(envelope-from swear@attbi.com)
Received: from localhost.localdomain (unknown[12.242.158.67])
          by attbi.com (rwcrmhc53) with ESMTP
          id <2003051216372705300j2ecbe>; Mon, 12 May 2003 16:37:27 +0000
Received: from localhost.localdomain (localhost [127.0.0.1])
	by localhost.localdomain (8.12.9/8.12.5) with ESMTP id h4CGdoKc068460;
	Mon, 12 May 2003 09:39:50 -0700 (PDT)
	(envelope-from swear@attbi.com)
Received: (from jojo@localhost)
	by localhost.localdomain (8.12.9/8.12.5/Submit) id h4CGdiCk068459;
	Mon, 12 May 2003 09:39:44 -0700 (PDT)
	(envelope-from swear@attbi.com)
X-Authentication-Warning: localhost.localdomain: jojo set sender to
	swear@attbi.com using -f
To: Giorgos Keramidas <keramida@freebsd.org>
References: <200305110053.h4B0rGd9004467@gothmog.gr>
	<20030511010700.GA4585@gothmog.gr> <20030511021605.GB8548@gothmog.gr>
	<20030511024527.GA9150@gothmog.gr>
	<20030510203753.H665@znfgre.qbhto.arg>
	<shissh42gx.ssh@localhost.localdomain>
	<20030511221240.GA37386@gothmog.gr>
From: swear@attbi.com (Gary W. Swearingen)
Date: 12 May 2003 09:39:44 -0700
In-Reply-To: <20030511221240.GA37386@gothmog.gr>
Message-ID: <34el343yr3.l34@localhost.localdomain>
Lines: 25
User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
cc: Doug Barton <DougB@freebsd.org>
cc: doc@freebsd.org
Subject: Re: docs/52041: testing new mdoc-bug class
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 12 May 2003 16:37:29 -0000

Giorgos Keramidas <keramida@freebsd.org> writes:

> Argh!  I hadn't noticed this class.  This makes it silly to make a class
> for doc-src bugs, since then we'd have change-request PRs for both SGML
> and manpages.

We already had that -- the "change-request" class overlaps with all of
the other classes including the old "doc-bug" one.  Splitting "doc-bug"
doesn't add to the silliness.

It seems that the "class" is dividing in two ways: "bugs vs. non-bugs"
and "base code vs. (src & doc) docs vs. ports".  Ideally, you'd have two
fields for this.

To keep the current fields (but with new elements), I'd probably just
remove the bug/change information from "class" (and maybe add a new
"change-request" (or "NA") element to the "severity" field).

But the easiest fix is probably to have classes something like this:

    base-sw-bug,         base-sw-change,
    base-doc-bug,        base-doc-change,
    fdp-doc-bug,         fdp-doc-change,
    port-user-bug,       port-user-change,
    port-maintainer-bug, port-maintainer-change