From rodrigc@h00609772adf0.ne.client2.attbi.com  Sun Apr  4 10:44:47 2004
Return-Path: <rodrigc@h00609772adf0.ne.client2.attbi.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 7F1B216A4CE; Sun,  4 Apr 2004 10:44:47 -0700 (PDT)
Received: from rwcrmhc12.comcast.net (rwcrmhc12.comcast.net [216.148.227.85])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 6928343D55; Sun,  4 Apr 2004 10:44:47 -0700 (PDT)
	(envelope-from rodrigc@h00609772adf0.ne.client2.attbi.com)
Received: from dibbler.crodrigues.org (h00609772adf0.ne.client2.attbi.com[66.31.45.197])
          by comcast.net (rwcrmhc12) with ESMTP
          id <2004040417444101400s6pj3e>; Sun, 4 Apr 2004 17:44:41 +0000
Received: from dibbler.crodrigues.org (localhost.crodrigues.org [127.0.0.1])
	by dibbler.crodrigues.org (8.12.11/8.12.11) with ESMTP id i34His4L095339;
	Sun, 4 Apr 2004 13:44:54 -0400 (EDT)
	(envelope-from rodrigc@h00609772adf0.ne.client2.attbi.com)
Received: (from rodrigc@localhost)
	by dibbler.crodrigues.org (8.12.11/8.12.11/Submit) id i34His89095338;
	Sun, 4 Apr 2004 13:44:54 -0400 (EDT)
	(envelope-from rodrigc)
Message-Id: <200404041744.i34His89095338@dibbler.crodrigues.org>
Date: Sun, 4 Apr 2004 13:44:54 -0400 (EDT)
From: Craig Rodrigues <rodrigc@crodrigues.org>
Reply-To: Craig Rodrigues <rodrigc@crodrigues.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc: krion@freebsd.org, portsmgr@freebsd.org
Subject: Porters Handbook is missing information on monitoring port commits
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         65170
>Category:       docs
>Synopsis:       Porters Handbook is missing information on monitoring port commits
>Confidential:   no
>Severity:       critical
>Priority:       high
>Responsible:    linimon
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Apr 04 10:50:19 PDT 2004
>Closed-Date:    Tue May 18 19:23:51 PDT 2004
>Last-Modified:  Tue May 18 19:23:51 PDT 2004
>Originator:     Craig Rodrigues
>Release:        FreeBSD 5.2-CURRENT i386
>Organization:
>Environment:
System: FreeBSD dibbler.crodrigues.org 5.2-CURRENT FreeBSD 5.2-CURRENT #39: Sat Mar 13 14:49:20 EST 2004 rodrigc@dibbler.crodrigues.org:/usr/obj/usr/src/sys/MYKERNEL1 i386


	
>Description:

Ports committers can get permission to commit changes to a port
without getting prior approval of the port maintainer.  While often
not a problem, there are cases where this lack of coordination with
the port maintainer can lead to problems.  krion@ suggested
that a port maintainer should set up a monitor of commits to a port
by subscribing to freshports.org:

http://lists.freebsd.org/pipermail/freebsd-ports/2004-April/011260.html

I would suggest that this information be added to the Porter's Handbook
in Chapter 19:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/changes.html


In addition, Kris suggested to me in private e-mail that a port maintainer 
should look at /usr/ports/CHANGES to understand changes to the ports
Makefiles.  I think that Chapter 19 of the Porter's Handbook should
also be updated with information about /usr/ports/CHANGES and
/usr/ports/UPDATING.



>How-To-Repeat:
	
>Fix:

	


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->linimon 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Sun Apr 4 10:54:58 PDT 2004 
Responsible-Changed-Why:  
I seem to be the volunteer-of-the-day with respect to the Porter's Handbook. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=65170 
State-Changed-From-To: open->closed 
State-Changed-By: linimon 
State-Changed-When: Tue May 18 19:23:23 PDT 2004 
State-Changed-Why:  
Please see docs/66855 for my proposed text that covers 
these topics. 

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