2.6.3: correction from James Troup -- <keyring-maint> is indeed the

[developers-reference.git] / developers-reference.sgml

diff --git a/developers-reference.sgml b/developers-reference.sgml
index 5ba52bf0c4a46c7e3d96200509477c7d89acd364..6d10f2562ad8163f7d4f8b7fc9d50a07a445f93c 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -1,9 +1,9 @@
-<!doctype debiandoc system [
-<!-- include version information so we don't have to hard code it
-     within the document -->
-<!entity % versiondata SYSTEM "version.ent"> %versiondata;
-<!entity number-of-pkgs "2250">
-<!entity number-of-maintainers "400">
+<!DOCTYPE debiandoc PUBLIC "-//DebianDoc//DTD DebianDoc//EN" [
+  <!-- include version information so we don't have to hard code it
+       within the document -->
+  <!entity % versiondata SYSTEM "version.ent"> %versiondata;
+  <!entity number-of-pkgs "2250">
+  <!entity number-of-maintainers "400">
 ]>
 <debiandoc>
 <!--
@@ -66,7 +66,7 @@ The resources discussed in this reference include the mailing lists
 and servers (<ref id="servers">); a discussion of the structure of the
 Debian archive (<ref id="archive">); explanation of the different
 servers which accept package uploads (<ref id="upload-master">); and a
-discussion of resources which an help maintainers with the quality of
+discussion of resources which can help maintainers with the quality of
 their packages (<ref id="tools">).
       <p>
 It should be clear that this reference does not discuss the technical
@@ -254,7 +254,7 @@ help.
 
     <chapt id="user-maint">Maintaining Your Debian Information
 
-      <sect>Maintaining Your Public Key
+      <sect id="key-maint">Maintaining Your Public Key
        <p>
 Be very careful with your private keys.  Do not place them on any
 public servers.  Back them up.  Read the documentation that comes with
@@ -263,8 +263,12 @@ measure.
        <p>
 If you add or remove signatures from your public key, or add or remove
 user identities, you need to update the key servers and mail your
-public key to <email>keyring-maint@debian.org</email>.  The same key
-extraction routines from <ref id="registering"> apply.
+public key to <email>keyring-maint@debian.org</email>.
+The same key extraction routines discussed in <ref id="registering">
+apply.
+       <p>
+You can find a more in-depth discussion of Debian key maintenance in
+the documentation for the <package>debian-keyring</package> package.
 
       <sect>Retiring Gracefully
        <p>
@@ -1804,9 +1808,6 @@ you to build packages without being root (packages usually want to
 install files with root ownership).  If you have
 <package>fakeroot</package> installed, you can say, i.e.,
 <tt>dpkg-buildpackage -rfakeroot</tt> as a user.
-       <p>
-Note that <package>fakeroot</package> is being replaced by
-<package>libtool</package> in ``potato''.
 
 
       <sect id="devscripts">
@@ -1819,7 +1820,14 @@ manipulate your <file>debian/changelog</file> file from the
 command-line, and <prgn>build</prgn>, which is a wrapper around
 <prgn>dpkg-buildpackage</prgn>.
 
-<!-- dpkg-awk ? -->
+
+      <sect id="debget">
+       <heading><package>debget</package>
+       <p>
+<package>debget</package> is a package containing a convenient script
+which can be helpful in downloading files from the Debian archive.
+You can use it to download source packages, for instance.
+
 
   </book>
 </debiandoc>