Update info about mailing lists, make a few other minor improvements.

Author: tglsfdc

doc/src/sgml/problems.sgml

@@ -1,3 +1,7 @@
+<!--
+$Header: /cvsroot/pgsql/doc/src/sgml/problems.sgml,v 2.7 2001/03/24 03:40:44 tgl Exp $
+-->
+
 <sect1 id="bug-reporting">
  <title>Bug Reporting Guidelines</title>
 
@@ -119,15 +123,19 @@
       The exact sequence of steps <emphasis>from program start-up</emphasis>
       necessary to reproduce the problem. This should be self-contained;
       it is not enough to send in a bare select statement without the
-      preceeding create table and insert statements, if the output should
+      preceding create table and insert statements, if the output should
       depend on the data in the tables. We do not have the time
-      to decode your database schema, and if we are supposed to make up
-      our own data we would probably miss the problem.
+      to reverse-engineer your database schema, and if we are supposed to make
+      up our own data we would probably miss the problem.
       The best format for a test case for
       query-language related problems is a file that can be run through the
       <application>psql</application> frontend
       that shows the problem. (Be sure to not have anything in your
-      <filename>~/.psqlrc</filename> start-up file.) You are encouraged to
+      <filename>~/.psqlrc</filename> start-up file.)  An easy start at this
+      file is to use <application>pg_dump</application> to dump out the table
+      declarations and data needed to set the scene, then add the problem
+      query.
+      You are encouraged to
       minimize the size of your example, but this is not absolutely necessary.
       If the bug is reproduceable, we will find it either way.
      </para>
@@ -155,8 +163,8 @@
       <para>
        In case of fatal errors, the error message provided by the client might
        not contain all the information available. In that case, also look at the
-       output of the database server. If you do not keep your server output,
-       this would be a good time to start doing so.
+       log output of the database server. If you do not keep your server
+       output, this would be a good time to start doing so.
       </para>
      </note>
     </listitem>
@@ -224,8 +232,8 @@
       processor, memory information. In most cases it is sufficient to report
       the vendor and version, but do not assume everyone knows what exactly
       "Debian" contains or that everyone runs on Pentiums. If
-      you have installation problems information about compilers, make, etc.
-      is also necessary.
+      you have installation problems then information about compilers, make,
+      etc. is also necessary.
      </para>
     </listitem>
    </itemizedlist>
@@ -302,13 +310,12 @@
    <para>
     Due to the unfortunate amount of spam going around, all of the above
     email addresses are closed mailing lists. That is, you need to be
-    subscribed to them in order to be allowed to post. If you simply
+    subscribed to a list to be allowed to post on it. If you simply
     want to send mail but do not want to receive list traffic, you can
-    subscribe to the special pgsql-loophole mailing list, which
-    allows you to post to all <productname>PostgreSQL</productname>
-    mailing lists without receiving any messages. Send email to
-    <email>pgsql-loophole-request@postgresql.org</email>
-    to subscribe.
+    subscribe and set your subscription option to <literal>nomail</>.
+    For more information send mail to
+    <email>majordomo@postgresql.org</email>
+    with the single word <literal>help</> in the body of the message.
    </para>
   </note>
  </sect2>