From edwin@FreeBSD.org  Wed Dec 15 04:44:34 2004
Return-Path: <edwin@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3F33216A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 15 Dec 2004 04:44:34 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 28E8643D1D
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 15 Dec 2004 04:44:34 +0000 (GMT)
	(envelope-from edwin@FreeBSD.org)
Received: from freefall.freebsd.org (edwin@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id iBF4iY5V025563
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 15 Dec 2004 04:44:34 GMT
	(envelope-from edwin@freefall.freebsd.org)
Received: (from edwin@localhost)
	by freefall.freebsd.org (8.13.1/8.13.1/Submit) id iBF4iYY3025562;
	Wed, 15 Dec 2004 04:44:34 GMT
	(envelope-from edwin)
Message-Id: <200412150444.iBF4iYY3025562@freefall.freebsd.org>
Date: Wed, 15 Dec 2004 04:44:34 GMT
From: Edwin Groothuis <edwin@FreeBSD.org>
Reply-To: Edwin Groothuis <edwin@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] tell porters handbook about IGNOREFILES
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         75091
>Category:       docs
>Synopsis:       [patch] tell porters handbook about IGNOREFILES
>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:   Wed Dec 15 04:50:30 GMT 2004
>Closed-Date:    Wed Dec 22 23:53:12 GMT 2004
>Last-Modified:  Wed Dec 22 23:53:12 GMT 2004
>Originator:     Edwin Groothuis
>Release:        FreeBSD 4.10-STABLE i386
>Organization:
-
>Environment:
System: FreeBSD freefall.freebsd.org 4.10-STABLE FreeBSD 4.10-STABLE #14: Sun Nov 21 01:22:46 GMT 2004 kensmith@freefall.freebsd.org:/c/src/sys/compile/FREEFALL i386


>Description:

Tell the porters handbook about the IGNOREFILES variable.

>How-To-Repeat:
>Fix:

Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.504
diff -u -r1.504 book.sgml
--- book.sgml	14 Dec 2004 18:38:46 -0000	1.504
+++ book.sgml	15 Dec 2004 04:43:11 -0000
@@ -260,6 +260,13 @@
 	<para>Just type <command>make makesum</command>. The ports make rules
 	  will automatically generate the file
 	  <filename>distinfo</filename>.</para>
+
+	<para>If a file fetched has its checksum changed regularly,
+	  for example it comes from manufacturer CDs or documentation
+	  generated daily, you should specify these files in the
+	  <makevar>IGNOREFILES<makevar> variable. Then the checksum
+	  is not calculated for that file when you run <command>make
+	  makesum</command>, but set to <literal>IGNORE</literal>.</para>
       </sect1>
 
       <sect1 id="porting-testing">
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->portmgr 
Responsible-Changed-By: edwin 
Responsible-Changed-When: Wed Dec 22 23:29:55 GMT 2004 
Responsible-Changed-Why:  
Over to potrmgr for approval first. 

<keramida> It looks simple enough.  I should really ask the portmgr team before committing it though. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=75091 
Responsible-Changed-From-To: portmgr->edwin 
Responsible-Changed-By: marcus 
Responsible-Changed-When: Wed Dec 22 23:32:07 GMT 2004 
Responsible-Changed-Why:  
This sounds okay.  You might also add a blurb about making sure the source is 
trusted since checksum validation will not be dine. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=75091 
Responsible-Changed-From-To: edwin->freebsd-doc 
Responsible-Changed-By: edwin 
Responsible-Changed-When: Wed Dec 22 23:33:42 GMT 2004 
Responsible-Changed-Why:  
Approved by portmgr. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=75091 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Dec 22 23:52:09 GMT 2004 
State-Changed-Why:  
Committed, as per our IRC discussion :-) 

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