Received: by mail.netbsd.org (Postfix, from userid 605)
	id 7384184DC3; Sun,  5 Jan 2020 21:35:34 +0000 (UTC)
Received: from localhost (localhost [127.0.0.1])
	by mail.netbsd.org (Postfix) with ESMTP id ED38284D67
	for <pkgsrc-changes@NetBSD.org>; Sun,  5 Jan 2020 21:35:33 +0000 (UTC)
X-Virus-Scanned: amavisd-new at netbsd.org
Received: from mail.netbsd.org ([127.0.0.1])
	by localhost (mail.netbsd.org [127.0.0.1]) (amavisd-new, port 10025)
	with ESMTP id rgFh79bn6dcu for <pkgsrc-changes@netbsd.org>;
	Sun,  5 Jan 2020 21:35:33 +0000 (UTC)
Received: from cvs.NetBSD.org (ivanova.netbsd.org [199.233.217.197])
	by mail.netbsd.org (Postfix) with ESMTP id 73E1884CE9
	for <pkgsrc-changes@NetBSD.org>; Sun,  5 Jan 2020 21:35:33 +0000 (UTC)
Received: by cvs.NetBSD.org (Postfix, from userid 500)
	id 680A4FA97; Sun,  5 Jan 2020 21:35:33 +0000 (UTC)
Content-Transfer-Encoding: 7bit
Content-Type: multipart/mixed; boundary="_----------=_1578260133234090"
MIME-Version: 1.0
Date: Sun, 5 Jan 2020 21:35:33 +0000
From: "Roland Illig" <rillig@netbsd.org>
Subject: CVS commit: pkgsrc/doc/guide/files
To: pkgsrc-changes@NetBSD.org
Reply-To: rillig@netbsd.org
X-Mailer: log_accum
Message-Id: <20200105213533.680A4FA97@cvs.NetBSD.org>
Sender: pkgsrc-changes-owner@NetBSD.org
List-Id: pkgsrc-changes.NetBSD.org
Precedence: bulk
List-Unsubscribe: <mailto:majordomo@NetBSD.org?subject=Unsubscribe%20pkgsrc-changes&body=unsubscribe%20pkgsrc-changes>

This is a multi-part message in MIME format.

--_----------=_1578260133234090
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="US-ASCII"

Module Name:	pkgsrc
Committed By:	rillig
Date:		Sun Jan  5 21:35:33 UTC 2020

Modified Files:
	pkgsrc/doc/guide/files: submit.xml

Log Message:
doc/guide: add an example for SUPERSEDES

This example makes it easier to see that the assignment operator should
always be += instead of a simple =. Also remove the word dewey since that
is a classification scheme for libraries, not a versioning scheme.


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 pkgsrc/doc/guide/files/submit.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.


--_----------=_1578260133234090
Content-Disposition: inline
Content-Length: 1533
Content-Transfer-Encoding: binary
Content-Type: text/x-diff; charset=us-ascii

Modified files:

Index: pkgsrc/doc/guide/files/submit.xml
diff -u pkgsrc/doc/guide/files/submit.xml:1.33 pkgsrc/doc/guide/files/submit.xml:1.34
--- pkgsrc/doc/guide/files/submit.xml:1.33	Mon Sep 18 14:25:27 2017
+++ pkgsrc/doc/guide/files/submit.xml	Sun Jan  5 21:35:33 2020
@@ -1,4 +1,4 @@
-<!-- $NetBSD: submit.xml,v 1.33 2017/09/18 14:25:27 wiz Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.34 2020/01/05 21:35:33 rillig Exp $ -->
 
 <chapter id="submit"> <?dbhtml filename="submit.html"?>
 <title>Submitting and Committing</title>
@@ -209,17 +209,23 @@ much easier to get wrong than <quote>cvs
 
 <para>Renaming packages is not recommended.</para>
 
-
 <para>When renaming packages, be sure to fix any references to old name
   in other Makefiles, options, buildlink files, etc.</para>
 
-<para>Also When renaming a package, please define
-  <varname>SUPERSEDES</varname> to the package name and dewey version
-  pattern(s) of the previous package name.
+<para>
+  Also when renaming a package, please add
+  the package name and version pattern(s) of the previous package
+  to <varname>SUPERSEDES</varname>.
   This may be repeated for multiple renames.
   The new package would be an exact replacement.
+  Example:
 </para>
 
+<programlisting>
+SUPERSEDES+=    p5-IO-Compress-Zlib&lt;2.017
+SUPERSEDES+=    optcomp-[0-9]*
+</programlisting>
+
 <para>Note that <quote>successor</quote> in the
   CHANGES-<replaceable>YYYY</replaceable> file doesn't necessarily
   mean that it <emphasis>supersedes</emphasis>, as that successor may


--_----------=_1578260133234090--