From fbdcb33c369704af4dfa7b8812c3f566ef631c38 Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@debian.org>
Date: Sat, 12 Jun 2010 11:39:42 -0700
Subject: [PATCH] Add an example of Replaces for a package split
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

* Add an example for Replaces when a package is split.  Thanks, Uwe
  Kleine-König.  (Closes: #572253)
---
 debian/changelog |  2 ++
 policy.sgml      | 14 ++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 5cbd885..5bbc225 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -90,6 +90,8 @@ debian-policy (3.8.5.0) UNRELEASED; urgency=low
     traditional foreground and background colors for Process.html and
     README.html.  (Closes: #584521)
   * Fix typo in footnote about help2man.  (Closes: #584796)
+  * Add an example for Replaces when a package is split.  Thanks, Uwe
+    Kleine-König.  (Closes: #572253)
 
  -- Bill Allombert <ballombe@debian.org>  Mon, 31 May 2010 20:00:28 +0200
 
diff --git a/policy.sgml b/policy.sgml
index 02d6f8d..da3a687 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -4743,6 +4743,20 @@ Provides: bar
 	    will no longer be listed as "owned" by the old package.
 	  </p>
 
+	  <p>
+	    For example, if a package <package>foo</package> is split
+	    into <package>foo</package> and <package>foo-data</package>
+	    starting at version 1.2-3, <package>foo-data</package> should
+	    have the field
+	    <example compact="compact">
+Replaces: foo (&lt;&lt; 1.2-3)
+	    </example>
+	    in its control file.  The package <package>foo</package>
+	    doesn't need any special control fields in this example,
+	    although would generally depend on or
+	    recommend <package>foo-data</package>.
+	  </p>
+
 	  <p>
 	    If a package is completely replaced in this way, so that
 	    <prgn>dpkg</prgn> does not know of any files it still
-- 
2.39.5