From: Russ Allbery <rra@debian.org>
Date: Mon, 27 Feb 2012 05:02:00 +0000 (-0800)
Subject: Update dpkg-buildpackage documentation to mention fakeroot
X-Git-Url: https://git.donarmstrong.com/?p=debian%2Fdebian-policy.git;a=commitdiff_plain;h=35873dbf46150051120fa6263f3133422d2e0dcd

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 3882be4..911986f 100644
--- 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 5a8de36..53b78b0 100644
--- 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>