tagging improvements and editorial improvements in config-wise-debconf

git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@1822 313b444b-1b9f-4f58-a734-7bb04f332e8d

diff --git a/developers-reference.sgml b/developers-reference.sgml
index 2ed1d7f1d6ac2e4b36945bfeab10e02e4ccabad1..7253cad50195d12456fb528aed8fed9749836fc0 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -6,7 +6,7 @@
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.131 $">
+  <!entity cvs-rev "$Revision: 1.132 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -3028,15 +3028,18 @@ source package.
     <sect id="config-mgmt">
        <heading>Configuration management</heading>
        
-       <sect1 id="config-wise-debconf">The wise use of debconf
-       <p>
-Debconf is a configuration management system, it is used by all the
-various packaging scripts (<file>postinst</file> mainly) to request feedback from the
-user concerning how to configure the package. Direct user interactions
-must now be avoided in favor of debconf interaction. This will enable
-non-interactive installations in the future.
+       <sect1 id="config-wise-debconf">
+          <heading>Proper use of <package>debconf</package></heading>
+       <p>
+<package>Debconf</package> is a configuration management system which
+can be used by all the various packaging scripts
+(<file>postinst</file> mainly) to request feedback from the user
+concerning how to configure the package. Direct user interactions must
+now be avoided in favor of <package>debconf</package>
+interaction. This will enable non-interactive installations in the
+future.
        <p>
-Debconf is a great tool but it is often badly used ... many common mistakes
+Debconf is a great tool but it is often poorly used.   Many common mistakes
 are listed in the <manref name="debconf-devel" section="8"> man page. 
 It is something that you must read if you decide to use debconf.