Add an example of Replaces for a package split

* Add an example for Replaces when a package is split.  Thanks, Uwe
  Kleine-König.  (Closes: #572253)

diff --git a/debian/changelog b/debian/changelog
index 5cbd885bfad81325c0b4786cb08b62f212704439..5bbc225a7d5d56abd3d46807ebfd665ce00ab26b 100644 (file)
--- 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 02d6f8d935c95755c28f16fe6d369854e42fad2d..da3a687069bc4f3b395dbcb0e435e76c623805d8 100644 (file)
--- 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