Update dpkg-buildpackage documentation to mention fakeroot

* Update the dpkg-buildpackage -r documentation in the appendix to
  reflect the current behavior of using fakeroot.  Wording from Sam
  Morris.  (Closes: #658009)

diff --git a/debian/changelog b/debian/changelog
index 3882be4dafaa2af2dab3b0f595463cec31002e9a..911986f731b849065e9ca3b920dbc2f08e3151f6 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -19,6 +19,9 @@ debian-policy (3.9.3.1) UNRELEASED; urgency=low
     of the wording.  (Closes: #601839)
   * Clearly state that "yes" is the only valid value of DM-Upload-Allowed
     and rewrite its description to be less indirect.  (Closes: #622263)
+  * Update the dpkg-buildpackage -r documentation in the appendix to
+    reflect the current behavior of using fakeroot.  Wording from Sam
+    Morris.  (Closes: #658009)
   * Install the HTML version of upgrading-checklist in the policy.html
     directory as upgrading-checklist.html so that it can be deployed on
     www.debian.org in a way that will allow links to Policy sections to

diff --git a/policy.sgml b/policy.sgml
index 5a8de36f71841cc9c03b1df5c6ca3f9521a99a66..53b78b0d349fa4c4707df1b3eaebc8310bfb5631 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -10482,10 +10482,10 @@ END-INFO-DIR-ENTRY
                  the <prgn>PATH</prgn> if necessary, and pass its
                  second and subsequent arguments to the command it
                  calls.  If no <var>root-command</var> is supplied
-                 then <var>dpkg-buildpackage</var> will take no
-                 special action to gain root privilege, so that for
-                 most packages it will have to be invoked as root to
-                 start with.</p>
+                 then <var>dpkg-buildpackage</var> will use
+                 the <prgn>fakeroot</prgn> command, which is sufficient
+                 to build most packages without actually requiring root
+                 privileges.</p>
              </item>
              <tag><tt>-b</tt>, <tt>-B</tt></tag>
              <item>