OSDN Git Service

Update FAQ to explain process of submitting bug and feature requests.
authorBruce Momjian <bruce@momjian.us>
Tue, 22 Nov 2005 15:04:25 +0000 (15:04 +0000)
committerBruce Momjian <bruce@momjian.us>
Tue, 22 Nov 2005 15:04:25 +0000 (15:04 +0000)
doc/FAQ
doc/src/FAQ/FAQ.html

diff --git a/doc/FAQ b/doc/FAQ
index e68f2fb..a7c9e45 100644 (file)
--- a/doc/FAQ
+++ b/doc/FAQ
@@ -1,7 +1,7 @@
 
                 Frequently Asked Questions (FAQ) for PostgreSQL
                                        
-   Last updated: Mon Nov 21 16:01:05 EST 2005
+   Last updated: Tue Nov 22 10:04:06 EST 2005
    
    Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
    
    company. To get involved, see the developer's FAQ at
    http://www.postgresql.org/files/documentation/faqs/FAQ_DEV.html
    
+  1.2) Who controls PostgreSQL?
+  
+   If you are looking for a PostgreSQL gatekeeper, central committee, or
+   controlling company, give up --- there isn't one. We do have a core
+   committee and CVS committers, but these groups are more for
+   administrative purposes than control. The project is directed by the
+   community of developers and users, which anyone can join. All you need
+   to do is subscribe to the mailing lists and participate in the
+   discussions. (See the Developer's FAQ for information on how to get
+   involved in PostgreSQL development.)
+   
   1.3) What is the copyright of PostgreSQL?
   
    PostgreSQL is distributed under the classic BSD license. Basically, it
    Via web browser, use http://www.postgresql.org/ftp/, and via ftp, use
    ftp://ftp.PostgreSQL.org/pub/.
    
+  1.6) What is the latest release?
+  
+   The latest release of PostgreSQL is version 8.1.1
+   
+   We plan to have a major release every year, with minor releases every
+   few months.
+   
   1.7) Where can I get support?
   
    The PostgreSQL community provides assistance to many of its users via
    Also check out our ftp site ftp://ftp.PostgreSQL.org/pub/ to see if
    there is a more recent PostgreSQL version.
    
-  1.6) What is the latest release?
+   Bugs submitted using the bug form or posted to any PostgreSQL mailing
+   list typically generates one of the following replies:
+     * It is not a bug, and why
+     * It is a known bug and is known already on the TODO list
+     * The bug has been fixed in the current release
+     * The bug has been fixed but is not packaged yet in an official
+       release
+     * A request is made for more detailed information:
+          + Operating system
+          + PostgreSQL version
+          + Reproducible test case
+          + Debugging information
+          + Debugger backtrace output
+     * The bug is new. The following might happen:
+          + A patch has been created and will be included in the next
+            major or minor release
+          + The bug cannot be fixed immediately and is added to the TODO
+            list
+       
+  1.9) How do I find out about known bugs or missing features?
   
-   The latest release of PostgreSQL is version 8.1.1
+   PostgreSQL supports an extended subset of SQL:2003. See our TODO list
+   for known bugs, missing features, and future plans.
    
-   We plan to have a major release every year, with minor releases every
-   few months.
+   A feature request usually results in one of the following replies:
+     * The feature is already on the TODO list
+     * The feature is not desired because:
+          + It duplicates existing functionality that already follows the
+            SQL standard
+          + The feature would increase code complexity but add little
+            benefit
+          + The feature would be insecure or unreliable
+     * The new feature is added to the TODO list
+       
+   PostgreSQL does not use a bug tracking system because we find it more
+   efficient to respond directly to email and keep the TODO list
+   up-to-date. In practice, bugs don't last very long in the software,
+   and bugs that affect a large number of users are fixed rapidly. The
+   only single place to find all changes, improvements, and fixes in a
+   PostgreSQL release is to read our CVS logs messages. Even the release
+   notes do not contain every change made to the software.
    
   1.10) What documentation is available?
   
    
    Our web site contains even more documentation.
    
-  1.9) How do I find out about known bugs or missing features?
-  
-   PostgreSQL supports an extended subset of SQL:2003. See our TODO list
-   for known bugs, missing features, and future plans.
-   
   1.11) How can I learn SQL?
   
    First, consider the PostgreSQL-specific books mentioned above. Another
           We are free for all use, both commercial and non-commercial.
           You can add our code to your product with no limitations,
           except those outlined in our BSD-style license stated above.
-          
-  1.2) Who controls PostgreSQL?
-  
-   If you are looking for a PostgreSQL gatekeeper, central committee, or
-   controlling company, give up --- there isn't one. We do have a core
-   committee and CVS committers, but these groups are more for
-   administrative purposes than control. The project is directed by the
-   community of developers and users, which anyone can join. All you need
-   to do is subscribe to the mailing lists and participate in the
-   discussions. (See the Developer's FAQ for information on how to get
-   involved in PostgreSQL development.)
      _________________________________________________________________
    
                            User Client Questions
index d3c5246..6f3fd77 100644 (file)
@@ -10,7 +10,7 @@
   alink="#0000ff">
     <H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1>
 
-    <P>Last updated: Mon Nov 21 16:01:05 EST 2005</P>
+    <P>Last updated: Tue Nov 22 10:04:06 EST 2005</P>
 
     <P>Current maintainer: Bruce Momjian (<A href=
     "mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)
     http://www.postgresql.org/files/documentation/faqs/FAQ_DEV.html</A>
     </P>
 
+    <H3><A name="1.2">1.2</A>) Who controls PostgreSQL?<BR></H3>
+
+    <P>If you are looking for a PostgreSQL gatekeeper, central committee,
+    or controlling company, give up --- there isn't one.  We do have a
+    core committee and CVS committers, but these groups are more for
+    administrative purposes than control.  The project is directed by
+    the community of developers and users, which anyone can join.  All
+    you need to do is subscribe to the mailing lists and participate in the
+    discussions.   (See the <a href="http://www.postgresql.org/docs/faqs.FAQ_DEV.html">
+    Developer's FAQ</A> for information on how to get involved in PostgreSQL
+    development.)</P>
+
     <H3><A name="1.3">1.3</A>) What is the copyright of
     PostgreSQL?</H3>
 
     <A href="ftp://ftp.PostgreSQL.org/pub/">
     ftp://ftp.PostgreSQL.org/pub/</A>.</P>
 
+    <H3><A name="1.6">1.6</A>) What is the latest release?</H3>
+
+    <P>The latest release of PostgreSQL is version 8.1.1</P>
+
+    <P>We plan to have a major release every year, with minor releases
+    every few months.</P>
+
     <H3><A name="1.7">1.7</A>) Where can I get support?</H3>
 
     <P>The PostgreSQL community provides assistance to many of its users
     "ftp://ftp.PostgreSQL.org/pub/">ftp://ftp.PostgreSQL.org/pub/</A> to
     see if there is a more recent PostgreSQL version.</P>
 
-    <H3><A name="1.6">1.6</A>) What is the latest release?</H3>
-
-    <P>The latest release of PostgreSQL is version 8.1.1</P>
+    <P>Bugs submitted using the bug form or posted to any PostgreSQL mailing
+    list typically generates one of the following replies:</P>
+    <ul>
+    <li>It is not a bug, and why</li>
+    <li>It is a known bug and is known already on the TODO list</li>
+    <li>The bug has been fixed in the current release</li>
+    <li>The bug has been fixed but is not packaged yet in an official 
+    release</li>
+    <li>A request is made for more detailed information:
+        <ul>
+       <li>Operating system</li>
+       <li>PostgreSQL version</li>
+       <li>Reproducible test case</li>
+       <li>Debugging information</li>
+       <li>Debugger backtrace output</li>
+       </ul>
+    </li>
+    <li>The bug is new.  The following might happen:
+        <ul>
+       <li>A patch has been created and will be included in the next major 
+       or minor release</li>
+       <li>The bug cannot be fixed immediately and is added
+       to the TODO list</li>
+       </ul>
+    </li>
+    </ul>
+       
+    <H3><A name="1.9">1.9</A>) How do I find out about known bugs or
+    missing features?</H3>
 
-    <P>We plan to have a major release every year, with minor releases
-    every few months.</P>
+    <P>PostgreSQL supports an extended subset of <SMALL>SQL:2003</SMALL>.
+    See our <A href="http://www.postgresql.org/docs/faqs.TODO.html">TODO</A>
+    list for known bugs, missing features, and future plans.</P>
 
+    <P>A feature request usually results in one of the following
+    replies:</P>
+    <ul>
+    <li>The feature is already on the TODO list</li>
+    <li>The feature is not desired because:
+        <ul>
+        <li>It duplicates existing functionality that already
+        follows the SQL standard</li>
+        <li>The feature would increase code complexity but add little
+        benefit</li>
+        <li>The feature would be insecure or unreliable</li>
+        </ul>
+    </li>
+    <li>The new feature is added to the TODO list</li>
+    </ul>
+    
+    <P>PostgreSQL does not use a bug tracking system because we find
+    it more efficient to respond directly to email and keep the TODO
+    list up-to-date. In practice, bugs don't last very long in the
+    software, and bugs that affect a large number of users are fixed
+    rapidly. The only single place to find all changes, improvements,
+    and fixes in a PostgreSQL release is to read our CVS logs messages.
+    Even the release notes do not contain every change made to the
+    software.</P>
+    
     <H3><A name="1.10">1.10</A>) What documentation is available?</H3>
 
     <P>PostgreSQL includes extensive documentation, including a large
 
     <P>Our web site contains even more documentation.</P>
 
-    <H3><A name="1.9">1.9</A>) How do I find out about known bugs or
-    missing features?</H3>
-
-    <P>PostgreSQL supports an extended subset of <SMALL>SQL:2003</SMALL>.
-    See our <A href="http://www.postgresql.org/docs/faqs.TODO.html">TODO</A>
-    list for known bugs, missing features, and future plans.</P>
-
     <H3><A name="1.11">1.11</A>) How can I learn
     <SMALL>SQL</SMALL>?</H3>
 
       </DD>
     </DL>
 
-    <H3><A name="1.2">1.2</A>) Who controls PostgreSQL?<BR>
-
-    <P>If you are looking for a PostgreSQL gatekeeper, central committee,
-    or controlling company, give up --- there isn't one.  We do have a
-    core committee and CVS committers, but these groups are more for
-    administrative purposes than control.  The project is directed by
-    the community of developers and users, which anyone can join.  All
-    you need to do is subscribe to the mailing lists and participate in the
-    discussions.   (See the <a href="http://www.postgresql.org/docs/faqs.FAQ_DEV.html">
-    Developer's FAQ</A> for information on how to get involved in PostgreSQL
-    development.)</P>
-
     <HR>
 
     <H2 align="center">User Client Questions</H2>
@@ -1023,11 +1075,11 @@ length</TD></TR>
     <P>The most common cause is the use of double-quotes around table or
     column names during table creation. When double-quotes are used,
     table and column names (called identifiers) are stored <a
-    href="http://www.postgresql.org/docs/8.0/static/sql-syntax.html#SQL-
-    SYNTAX-IDENTIFIERS">case-sensitive</a>, meaning you must use
-    double-quotes when referencing the names in a query. Some interfaces,
-    like pgAdmin, automatically double-quote identifiers during table
-    creation. So, for identifiers to be recognized, you must either:
+    href="http://www.postgresql.org/docs/8.0/static/sql-syntax.html#SQL-SYNTAX-IDENTIFIERS"> 
+    case-sensitive</a>, meaning you must use double-quotes when
+    referencing the names in a query. Some interfaces, like pgAdmin,
+    automatically double-quote identifiers during table creation. So,
+    for identifiers to be recognized, you must either:
     <UL>
     <LI>Avoid double-quoting identifiers when creating tables</LI>
     <LI>Use only lowercase characters in identifiers</LI>