docs/104126: [ docs ] [ patch ] add a section about distfile rerolling to the PH

[Roman Bogorodskiy]

>Number:         104126
>Category:       docs
>Synopsis:       [ docs ] [ patch ] add a section about distfile rerolling to the PH
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Sat Oct 07 18:30:44 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Roman Bogorodskiy
>Release:        FreeBSD 6.1-STABLE i386
>Organization:
>Environment:
System: FreeBSD novel.fannet.ru 6.1-STABLE FreeBSD 6.1-STABLE #4: Thu Aug 24 15:55:09 MSD 2006 root at novel.fannet.ru:/usr/obj/usr/src/sys/NOVEL i386


>Description:
Add a guide how to deal with the rerolled distfiles to the
"Dos and Don'ts" chapter of the Porters Handbook. Builds fine
but probably needs style/grammer fixes.
>How-To-Repeat:
>Fix:

--- distfile_rerolling.diff begins here ---
Index: book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.757
diff -u -r1.757 book.sgml
--- book.sgml	6 Oct 2006 19:18:17 -0000	1.757
+++ book.sgml	7 Oct 2006 18:14:17 -0000
@@ -10222,6 +10222,22 @@
 	  special need.</para>
       </sect1>
 
+      <sect1 id="dads-distfiles-rerolling">
+	<title>Distfiles rerolling</title>
+
+	<para>It could happen that the distfile of your port gets
+	  rerolled (i.e. its content was changed without changing the
+	  name).  It is a bad sign usually and you have to make sure
+	  that no harmful changes were made.  Save the old distfile,
+	  download the new one and compare them with &man.diff.1;. If
+	  you see nothing criminal you can update
+	  <filename>distinfo</filename>.  Be sure to summarize changes
+	  so other people knew nothing critial happened.</para>
+
+        <para>You might want to contact the developers of the software
+	 and ask not to reroll distfiles.</para>
+      </sect1>
+
       <sect1 id="dads-workarounds">
 	<title>Necessary workarounds</title>
 
--- distfile_rerolling.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: