From: David Friend
authorMarc G. Fournier
Sun, 11 May 1997 06:18:33 +0000 (06:18 +0000)
committerMarc G. Fournier
Sun, 11 May 1997 06:18:33 +0000 (06:18 +0000)
Subject: [PATCHES] Documentation update

This patch updates some of the documentation that comes with the
distribution.  The following files are updated:
        COPYRIGHT
        README
        doc/README.flex
        doc/README.support
        doc/bug.template

COPYRIGHT
README
doc/README.flex
doc/README.support
doc/bug.template

index 567e4f486f035d76eb60ddeb1dc313861f6c65e5..6150c0df28674bb687bf4c7da7b20066ff1d3a43 100644 (file)
--- a/COPYRIGHT
+++ b/COPYRIGHT
@@ -1,7 +1,7 @@
+PostgreSQL Data Base Management System (formerly known as Postgres, then
+as Postgres95).
 
-PostgreSQL Data Base Management System (formally known as Postgres95)
-
-Copyright (c) 1994-6 Regents of the University of California
+Copyright (c) 1994-7 Regents of the University of California
 
 Permission to use, copy, modify, and distribute this software and its
 documentation for any purpose, without fee, and without a written agreement
@@ -19,4 +19,3 @@ INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
 ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO
 PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
-
diff --git a/README b/README
index 2094b9a8ec560378cf66c8326710f407453b7570..37e8ee2e50d68b0d80663d4ba2e89f75ac60d763 100644 (file)
--- a/README
+++ b/README
@@ -13,9 +13,10 @@ terms of the the copyright below:
 
 ------------------------------------------------------------------------
 
-POSTGRES95 Data Base Management System
+POSTGRES95 Data Base Management System (formerly known as Postgres, then
+as Postgres95).
 
-Copyright (c) 1994-6 Regents of the University of California
+Copyright (c) 1994-7 Regents of the University of California
 
 Permission to use, copy, modify, and distribute this software and its
 documentation for any purpose, without fee, and without a written agreement
index ab3c34948fda28807b8791e00ff12e3d6d19bdd8..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 100644 (file)
@@ -1,147 +0,0 @@
-
-Hi,
-
-thank you for the latest Postgres95 distribution! 
-
->does the createuser bug still persist, or have
->we finally worked that one out?
-
-As has been indication by Bruce Momjian, the createuser problem was
-caused by a bug in flex 2.5.3 (which has been confirmed by Vern
-Paxson, the flex maintainer - many thanks to them); the bug will be
-fixed in flex 2.5.4. Vern Paxson has been so kind as to supply me with
-a patch that will be part of the 2.5.4 release; I'm including it below
-in case someone has installed flex 2.5.3 and doesn't want to go
-back to 2.5.2...
-
-Regards,
-
-Ernst
----
-*** flex-2.5.3/flex.skl    Sat May 25 21:02:33 1996
---- flex.skl   Tue Jul  2 16:35:49 1996
-***************
-*** 1,7 ****
-  /* A lexical scanner generated by flex */
-
-  /* Scanner skeleton version:
-!  * $Header: /cvsroot/pgsql/doc/Attic/README.flex,v 1.1.1.1 1996/08/18 22:14:17 scrappy Exp $
-   */
-
-  #define FLEX_SCANNER
---- 1,7 ----
-  /* A lexical scanner generated by flex */
-
-  /* Scanner skeleton version:
-!  * $Header: /cvsroot/pgsql/doc/Attic/README.flex,v 1.1.1.1 1996/08/18 22:14:17 scrappy Exp $
-   */
-
-  #define FLEX_SCANNER
-***************
-*** 783,789 ****
-       /* don't do the read, it's not guaranteed to return an EOF,
-        * just force an EOF
-        */
-!      yy_n_chars = 0;
-
-   else
-       {
---- 783,789 ----
-       /* don't do the read, it's not guaranteed to return an EOF,
-        * just force an EOF
-        */
-!      yy_current_buffer->yy_n_chars = yy_n_chars = 0;
-
-   else
-       {
-***************
-*** 838,843 ****
---- 838,845 ----
-       /* Read in more data. */
-       YY_INPUT( (&yy_current_buffer->yy_ch_buf[number_to_move]),
-           yy_n_chars, num_to_read );
-+
-+      yy_current_buffer->yy_n_chars = yy_n_chars;
-       }
-
-   if ( yy_n_chars == 0 )
-***************
-*** 947,953 ****
-
-       yy_cp += (int) (dest - source);
-       yy_bp += (int) (dest - source);
-!      yy_n_chars = yy_current_buffer->yy_buf_size;
-
-       if ( yy_cp < yy_current_buffer->yy_ch_buf + 2 )
-           YY_FATAL_ERROR( "flex scanner push-back overflow" );
---- 949,956 ----
-
-       yy_cp += (int) (dest - source);
-       yy_bp += (int) (dest - source);
-!      yy_current_buffer->yy_n_chars =
-!          yy_n_chars = yy_current_buffer->yy_buf_size;
-
-       if ( yy_cp < yy_current_buffer->yy_ch_buf + 2 )
-           YY_FATAL_ERROR( "flex scanner push-back overflow" );
-***************
-*** 997,1009 ****
-
-           switch ( yy_get_next_buffer() )
-               {
-               case EOB_ACT_END_OF_FILE:
-                   {
-                   if ( yywrap() )
--                      {
--                      yy_c_buf_p = yytext_ptr + offset;
-                       return EOF;
--                      }
-
-                   if ( ! yy_did_buffer_switch_on_eof )
-                       YY_NEW_FILE;
---- 1000,1025 ----
-
-           switch ( yy_get_next_buffer() )
-               {
-+              case EOB_ACT_LAST_MATCH:
-+                  /* This happens because yy_g_n_b()
-+                   * sees that we've accumulated a
-+                   * token and flags that we need to
-+                   * try matching the token before
-+                   * proceeding.  But for input(),
-+                   * there's no matching to consider.
-+                   * So convert the EOB_ACT_LAST_MATCH
-+                   * to EOB_ACT_END_OF_FILE.
-+                   */
-+
-+                  /* Reset buffer status. */
-+                  yyrestart( yyin );
-+
-+                  /* fall through */
-+
-               case EOB_ACT_END_OF_FILE:
-                   {
-                   if ( yywrap() )
-                       return EOF;
-
-                   if ( ! yy_did_buffer_switch_on_eof )
-                       YY_NEW_FILE;
-***************
-*** 1017,1031 ****
-               case EOB_ACT_CONTINUE_SCAN:
-                   yy_c_buf_p = yytext_ptr + offset;
-                   break;
--
--              case EOB_ACT_LAST_MATCH:
-- #ifdef __cplusplus
--                  YY_FATAL_ERROR(
--                  "unexpected last match in yyinput()" );
-- #else
--                  YY_FATAL_ERROR(
--                  "unexpected last match in input()" );
-- #endif
-               }
-           }
-       }
---- 1033,1038 ----
-
index d0088721857f4e8f581090c9be25b3c2ef1f18c3..c25c6f1657d984b80702e97b56ae98e42329f12e 100644 (file)
+                     PostgreSQL Support
 
-PostgreSQL Mailing Lists
 
-General Users/Questions
+PostgreSQL is a freeware database server that is user
+developed, maintained and supported.  It was originally
+known as Postgres, then as Postgres95.  It is not ANSI
+SQL compliant but it is getting closer with every release.
 
-     This list is designed as a forum geared towards installation and usage
-     problems related to PostgreSQL, as well as a place to discuss general
-     SQL related problems.
+For support on PostgreSQL, look in the following places:
 
-     To subscribe, send a message of subscribe to:
+   * ftp://ftp.postgresql.org/pub/
+   * http://www.postgresql.org/
+   * Text files in directory /usr/src/pgsql.
+   * Text files in directory /usr/src/pgsql/docs.
+   * The FAQ, located in /usr/src/pgsql/doc/FAQ.  The
+     latest version may be found at
+     http://www.postgresql.org/ under documentation.
+   * Digests of all of the PostgreSQL mailing lists are
+     archived at ftp://ftp.postgresql.org/pub/majordomo/.
+   * The mailing list, which are described below.
 
-Hackers/Development Discussions
 
-     This list is where bugs reports and server improvements are discussed,
-     providing the developers with an area seperate from the general
-     questions, while allowing both end-users and administrators a chance to
-     join in and follow the discussions.
+Support Mailing Lists:
 
-     To subscribe, send a message of subscribe to:
+   * Announce for announcements.
+   * Ports for OS-specific bugs.
+   * Bugs for other unsolved bugs.
+   * Questions for general discussion.
 
-All the mailing lists are archived, with archives available at:
-ftp://ftp.postgreSQL.org/pub/majordomo
 
+Mailing Lists for Developers:
+
+   * Hackers for server internals discussion.
+   * Docs for the documentation project.
+   * Patches for patches and discussion.
+   * Mirrors for mirror site announcements.
+
+
+         Descriptions of PostgreSQL Mailing Lists
+
+Announce
+
+   * This is an announcement list pertaining to
+     PostgreSQL and various third party software.
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body
+     of the message should contain the single line
+     subscribe or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The
+     body of the message should contain the single line
+     subscribe or unsubscribe.
+
+Ports
+
+   * This list is for porting related and platform
+     specific discussions.
+   * If PostgreSQL failed to compile on your computer
+     then fill out the form typically located at
+     /usr/src/pgsql/doc/bug.template and mail it here.
+   * If you get PostgreSQL running on an unsupported
+     platform, tell us how you did it here. And before
+     you attempt the port, check the archives for this
+     area to see if someone else has already done it.
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body of
+     the message should contain the single line subscribe
+     or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The body
+     of the message should contain the single line
+     subscribe or unsubscribe.
+
+Bugs
+
+   * If PostgreSQL failed to compile on your computer,
+     report this to [email protected]. Do not
+     report it here.
+   * If you find bug, fill out the form typically located
+     at /usr/src/pgsql/doc/bug.template and mail it here.
+   * If you not only found the problem but solved it and
+     generated a patch then also mail it to the patches
+     list.
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body of
+     the message should contain the single line subscribe
+     or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The body
+     of the message should contain the single line
+     subscribe or unsubscribe.
+
+Questions
+
+   * This is a general discussion area for users.
+   * Outside of compile, acceptance test and bug
+     problems, most new users who don't want to
+     contribute to development or documentation will
+     probably only be interested in this mailing list.
+   * All non-bug related questions regarding PostgreSQL's
+     version of SQL should be restricted to this area.
+   * All installation related questions that do not
+     involve bugs or failed compiles should be restricted
+     to this area.
+   * Please note that many of the developers monitor this
+     area.
+   * To post, send mail to
+     [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body
+     of the message should contain the single line
+     subscribe or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The
+     body of the message should contain the single line
+     subscribe or unsubscribe.
+
+Hackers
+
+   * The PostgreSQL developer's team lives here.
+   * This list is for the discussion of current
+     development issues, problems and bugs and the
+     discussion of proposed new features.
+   * If people in the other lists don't know the answer
+     to a question and it is likely that only a developer
+     will know the answer, you may re-post that question
+     here. You must try elsewhere first!
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body of
+     the message should contain the single line subscribe
+     or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The
+     body of the message should contain the single line
+     subscribe or unsubscribe.
+Docs
+
+   * The PostgreSQL documentation team lives here and at
+     http://www.postgresql.org/~dunlop.
+   * If you come up with SQL examples that are not shown
+     in the current man pages or manuals, please let us
+     know here.
+   * If you are looking for "secret" manuals, check here.
+     Old manuals that are mostly not relevant or works in
+     progress that are not ready for general distribution
+     might be mentione here. But please don't ask us.
+     Check the archives for examples.
+   * The team leader is J. Douglas Dunlop.
+   * Please note that suggestions regarding the web site
+     should be directed to our webmaster at
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body of
+     the message should contain the single line subscribe
+     or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The body
+     of the message should contain the single line
+     subscribe or unsubscribe.
+
+Patches
+
+   * Mail patches you created to this area. Explain what
+     the patches do, and which source tree they are meant
+     to be applied against.
+   * This list also contains notices (normally from
+     [email protected]) that the patch has been applied are
+     posted here.
+   * Discussion of any problems that a recent patch
+     caused should also be here.
+   * Please use a context diff (diff -c) when submitting
+     patches. It would also be helpful if you checked
+     whether your patches apply against the latest
+     development source.
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body of
+     the message should contain the single line subscribe
+     or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The
+     body of the message should contain the single line
+     subscribe or unsubscribe.
+
+Mirrors
+
+   * This is an announcement list for mirror sites.
+   * If you don't run a PostgreSQL mirror site, please
+     don't post here.
+   * To post, send mail to [email protected].
+   * To subscribe or unsubscribe from the list, send mail
+     to [email protected]. The body of
+     the message should contain the single line subscribe
+     or unsubscribe.
+   * If you hate getting many mail messages per day then
+     you should consider a digest (where you receive
+     multiple messages to the list as one message to
+     you). To subscribe or unsubscribe from the digested
+     list, send mail to
+     [email protected]. The
+     body of the message should contain the single line
+     subscribe or unsubscribe.
index 7c86c3f5193f26df2424b0e880acc4fa253fe80e..577e07eb1c63069b02afb8ee1b45061fff630702 100644 (file)
@@ -1,5 +1,16 @@
-To report a bug, please complete the following form and send it by
-email to [email protected].
+If PostgreSQL failed to compile on your computer or you found a bug that
+is likely to be specific to one platform then please fill out this form
+and e-mail it to [email protected].
+
+To report any other bug, fill out the form below and e-mail it to
+
+If you not only found the problem but solved it and generated a patch
+then e-mail it to [email protected] instead.  Please use the
+command "diff -c" to generate the patch.
+
+You may also enter a bug report at http://www.postgresql.org/ instead of
+e-mail-ing this form.
 
 ============================================================================
                         POSTGRESQL BUG REPORT TEMPLATE
@@ -14,11 +25,11 @@ System Configuration
 ---------------------
   Architecture (example: Intel Pentium)    :
 
-  Operating System (example: Linux 1.3.42 ELF)     :
+  Operating System (example: Linux 2.0.26 ELF)     :
 
   PostgreSQL version (example: PostgreSQL-6.1)  :   PostgreSQL-6.1
 
-  Compiler used (example:  gcc 2.7.0)      :
+  Compiler used (example:  gcc 2.7.2)      :
 
 
 Please enter a FULL description of your problem:
@@ -39,3 +50,4 @@ concise reproducible example, if at all possible:
 If you know how this problem might be fixed, list the solution below:
 ---------------------------------------------------------------------
 
+