Update bug tracking advice

diff --git a/README b/README
index 23ca4e6ea96af62cfd287348aa276a2fb1c40293..72f9a4863dc4806258a095224f8b9d98da6d87df 100644 (file)
--- a/README
+++ b/README
@@ -481,9 +481,13 @@ WHERE TO REPORT BUGS: If you want the act of sending in a bug report
 to result in you getting help in the form of a fixed piece of
 software, you are asking for help.  Your bug report is helpful to us,
 but fundamentally you are making a support request, so please use the
-addresses described in the previous paragraphs.  If your bug report
-includes a patch, or if you don't care about getting a response to it,
-you can send it to dhcp-bugs@isc.org without subscribing.
+addresses described in the previous paragraphs.  If you are _sure_ that
+your problem is a bug, and not user error, or if your bug report
+includes a patch, you can send it to dhcp-bugs@isc.org without
+subscribing.   This mailing list goes into a bug tracking system, so
+you don't need to check periodically to see if we still remember the
+bug - if you haven't been notified that the bug has been closed, we
+still consider it a bug, and still have it in the system.
 
 PLEASE DO NOT REPORT BUGS IN OLD SOFTWARE RELEASES!  Fetch the latest
 release and see if the bug is still in that version of the software,
@@ -561,12 +565,12 @@ figure out your problem.   If you need handholding support, please
 consider contacting a commercial provider of the ISC DHCP
 Distribution.
 
-       - The specific operating system name and version of the
+      1.  The specific operating system name and version of the
           machine on which the DHCP server or client is running.
-       - The specific operating system name and version of the
+      2.  The specific operating system name and version of the
           machine on which the client is running, if you are having
           trouble getting a client working with the server.
-       - If you're running Linux, the version number we care about is
+      3.  If you're running Linux, the version number we care about is
           the kernel version and maybe the library version, not the
           distribution version - e.g., while we don't mind knowing
           that you're running Redhat version mumble.foo, we must know
@@ -575,16 +579,16 @@ Distribution.
           although if you don't know that off the top of your head it
           may be hard for you to figure it out, so don't go crazy
           trying.
-       - The specific version of the DHCP distribution you're
+      4.  The specific version of the DHCP distribution you're
           running, for example "2.0b1pl19", not "2.0".
-       - Please explain the problem carefully, thinking through what
+      5.  Please explain the problem carefully, thinking through what
           you're saying to ensure that you don't assume we know
           something about your situation that we don't know.
-       - Include your dhcpd.conf and dhcpd.leases file if they're not
+      6.  Include your dhcpd.conf and dhcpd.leases file if they're not
           huge (if they are huge, we may need them anyway, but don't
           send them until you're asked).   Huge means more than 100
           kilobytes each.
-       - Include a log of your server or client running until it
+      7.  Include a log of your server or client running until it
           encounters the problem - for example, if you are having
           trouble getting some client to get an address, restart the
           server with the -d flag and then restart the client, and
@@ -592,7 +596,7 @@ Distribution.
           include the output of the client as it fails to get an
           address or otherwise does the wrong thing.   Do not leave
           out parts of the output that you think aren't interesting.
-       - If the client or server is dumping core, please run the
+      8.  If the client or server is dumping core, please run the
           debugger and get a stack trace, and include that in your
           bug report.   For example, if your debugger is gdb, do the
           following:
@@ -604,6 +608,14 @@ Distribution.
 
          This assumes that it's the dhcp server you're debugging, and
          that the core file is in dhcpd.core.
+      9.  If you know that the problem is an actual bug, and you can
+         reproduce the bug, you can skip steps 6 through 8 and instead
+         capture a trace file using the -tf flag (see the man page for
+         details).   If you do this, and there is anything in your
+         dhcp configuration that you are not willing to make public,
+         please send the trace file to dhcp-bugs@isc.org and NOT to
+         dhcp-server@isc.org, because the tracefile contains your entire
+         dhcp configuration.
 
 PLEASE DO NOT send queries about non-isc clients to the dhcp-client
 mailing list.   If you're asking about them on an ISC mailing list,