Update information about DEB_*_ARCH variables

Recommend using the DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables instead
of the GNU style ones. And mention that the latter are mostly intended
for use with upstream build systems, and not Debian packaging.

diff --git a/policy.sgml b/policy.sgml
index 0a924f78b42f7fb3b70625ca262f9f72b3989f92..6a626748166126d93cf114185a98882209fe65c1 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -1985,6 +1985,12 @@
            <item>
                <tt>DEB_*_ARCH</tt> (the Debian architecture)
            </item>
+           <item>
+               <tt>DEB_*_ARCH_CPU</tt> (the Debian CPU name)
+           </item>
+           <item>
+               <tt>DEB_*_ARCH_OS</tt> (the Debian System name)
+           </item>
            <item>
                <tt>DEB_*_GNU_TYPE</tt> (the GNU style architecture
                specification string)
@@ -2013,8 +2019,10 @@
          It is important to understand that the <tt>DEB_*_ARCH</tt>
          string only determines which Debian architecture we are
          building on or for. It should not be used to get the CPU
-         or system information; the GNU style variables should be
-         used for that.
+         or system information; the <tt>DEB_*_ARCH_CPU</tt> and
+         <tt>DEB_*_ARCH_OS</tt> variables should be used for that.
+         GNU style variables should generally only be used with upstream
+         build systems.
        </p>
 
        <sect1 id="debianrules-options">