From linimon@lonesome.com  Tue Jan 20 14:53:59 2004
Return-Path: <linimon@lonesome.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 1C1B916A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 Jan 2004 14:53:59 -0800 (PST)
Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66])
	by mx1.FreeBSD.org (Postfix) with ESMTP id DAAD143D2F
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 Jan 2004 14:53:48 -0800 (PST)
	(envelope-from linimon@lonesome.com)
Received: from lonesome.lonesome.com (cs242719-195.austin.rr.com [24.27.19.195])
	(using TLSv1 with cipher EDH-RSA-DES-CBC3-SHA (168/168 bits))
	(No client certificate requested)
	by mail.soaustin.net (Postfix) with ESMTP id 739271469F
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 Jan 2004 16:53:48 -0600 (CST)
Received: from lonesome.lonesome.com (localhost.lonesome.com [127.0.0.1])
	by lonesome.lonesome.com (8.12.9/8.12.9) with ESMTP id i0KMqqql076660
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 Jan 2004 16:52:52 -0600 (CST)
	(envelope-from linimon@lonesome.lonesome.com)
Received: (from linimon@localhost)
	by lonesome.lonesome.com (8.12.9/8.12.9/Submit) id i0KMqqpl076659;
	Tue, 20 Jan 2004 16:52:52 -0600 (CST)
	(envelope-from linimon)
Message-Id: <200401202252.i0KMqqpl076659@lonesome.lonesome.com>
Date: Tue, 20 Jan 2004 16:52:52 -0600 (CST)
From: Mark Linimon <linimon@lonesome.com>
Reply-To: Mark Linimon <linimon@lonesome.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] two minor additions to Porter's Handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         61654
>Category:       docs
>Synopsis:       [patch] two minor additions to Porter's Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 20 15:00:26 PST 2004
>Closed-Date:    Tue Jan 20 16:07:18 PST 2004
>Last-Modified:  Tue Jan 20 16:07:18 PST 2004
>Originator:     Mark Linimon
>Release:        FreeBSD 4.9-PRERELEASE i386
>Organization:
Lonesome Dove Computing Services
>Environment:
System: FreeBSD lonesome.lonesome.com 4.9-PRERELEASE FreeBSD 4.9-PRERELEASE #0: Fri Sep 5 01:19:33 CDT 2003 linimon@lonesome.lonesome.com:/usr/src/sys/compile/MULTIMEDIA_DEBUG i386
	(n/a)
>Description:
	While reviewing the updated Porter's Handbook, I found one
	bit of text that was out of date, and one obvious thing to add.
>How-To-Repeat:
	(n/a)
>Fix:

--- book.sgml.dist	Tue Jan 20 16:33:11 2004
+++ book.sgml	Tue Jan 20 16:50:37 2004
@@ -2836,6 +2835,10 @@
 
 	<para>The COMMENT variable should immediately follow the MAINTAINER
 	  variable in the <filename>Makefile</filename>.</para>
+
+	<para>Please try to keep the COMMENT line less than 70
+	  characters, as it is displayed to users as a one-line
+	  summary of the port.</para>
       </sect1>
 
       <sect1 id="makefile-depend">
@@ -3798,8 +3801,8 @@
     <sect1 id="using-gnome">
       <title>Using GNOME</title>
 
-      <para>The FreeBSD/GNOME project uses a system called
-	<literal>GNOMENG</literal> to define which GNOME components a
+      <para>The FreeBSD/GNOME project uses its own set of variables
+	to define which GNOME components a
 	particular port uses. A
 	<ulink url="http://www.FreeBSD.org/gnome/docs/porting.html">comprehensive
 	list of these variables</ulink> exists within the FreeBSD/GNOME
>Release-Note:
>Audit-Trail:

From: Ceri Davies <ceri@submonkey.net>
To: Mark Linimon <linimon@lonesome.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/61654: [patch] two minor additions to Porter's Handbook
Date: Tue, 20 Jan 2004 23:06:44 +0000

 --5/6IVfYouxg+lu1D
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Tue, Jan 20, 2004 at 04:52:52PM -0600, Mark Linimon wrote:
 
 > >Number:         61654
 > >Category:       docs
 > >Synopsis:       [patch] two minor additions to Porter's Handbook
 
 > >Description:
 > 	While reviewing the updated Porter's Handbook, I found one
 > 	bit of text that was out of date, and one obvious thing to add.
 
 Approved.  Please commit if you like, or kick me if you want me to do
 it.
 
 Ceri
 
 --=20
 
 --5/6IVfYouxg+lu1D
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.4 (FreeBSD)
 
 iD8DBQFADbSEocfcwTS3JF8RAjO9AKCXVXawXYdL1ygK+/ccVPnJhlDhPgCeMsL/
 9lYUBJ+SjMSEbFHFHyIspQg=
 =RU0H
 -----END PGP SIGNATURE-----
 
 --5/6IVfYouxg+lu1D--
State-Changed-From-To: open->closed 
State-Changed-By: linimon 
State-Changed-When: Tue Jan 20 16:07:05 PST 2004 
State-Changed-Why:  
Committed after review by ceri. 

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