[pkgsrc/trunk]: pkgsrc/doc/guide/files Some more details for whaty to do when...

[reed <reed%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/680a4a40bbb0
branches:  trunk
changeset: 525541:680a4a40bbb0
user:      reed <reed%pkgsrc.org@localhost>
date:      Mon Feb 19 15:22:29 2007 +0000

description:
Some more details for whaty to do when a distfile changes.

diffstat:

 doc/guide/files/fixes.xml |  9 +++++++--
 1 files changed, 7 insertions(+), 2 deletions(-)

diffs (34 lines):

diff -r 71f75abf6e96 -r 680a4a40bbb0 doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Mon Feb 19 14:50:33 2007 +0000
+++ b/doc/guide/files/fixes.xml Mon Feb 19 15:22:29 2007 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.79 2007/02/19 08:34:00 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.80 2007/02/19 15:22:29 reed Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -675,18 +675,23 @@
     compared against the old one before changing anything, to make
     sure the distfile was really updated on purpose, and that
     no trojan horse or so crept in.
+    Please mention that the distfiles were compared and what was found
+    in your commit message.
     Then, the correct way to work around this is to
     set <varname>DIST_SUBDIR</varname> to a unique directory name,
     usually based on <varname>PKGNAME_NOREV</varname>. All
     <varname>DISTFILES</varname> and
     <varname>PATCHFILES</varname> for this package will be put in that
-    subdirectory of the local distfiles directory.  In case this
+    subdirectory of the local distfiles directory.
+    (See <xref linkend="bumping-pkgrevision"/> for more details.)
+    In case this
     happens more often, <varname>PKGNAME</varname> can be used (thus
     including the <filename>nbX</filename> suffix) or a date stamp
     can be appended, like <varname>${PKGNAME_NOREV}-YYYYMMDD</varname>.
     Do not forget regenerating the <filename>distinfo</filename> file
     after that, since it contains the <varname>DIST_SUBDIR</varname>
     path in the filenames.
+    Also increase the PKGREVISION if the installed package is different.
     Furthermore, a mail to the package's authors seems appropriate
     telling them that changing distfiles after releases without
     changing the file names is not good practice.</para>