New FAQ's.

doc/FAQ

 Frequently Asked Questions (FAQ) for Postgres95
 
-Last updated: Fri Sep 27 17:48:23 EDT 1996
+Last updated: Mon Oct 14 08:05:23 EDT 1996
 Version: 2.0
 
 Current maintainer: Bruce Momjian (maillist@candle.pha.pa.us)
@@ -8,9 +8,15 @@ Current maintainer: Bruce Momjian (maillist@candle.pha.pa.us)
 The most recent version of this document can be viewed at the postgres95 Web
 site, http://www.ki.net/postgres95.
 
+Linux-specific questions are answered in
+http://www.ki.net/postgres95/docs/FAQ-Linux.phtml.
+
+Irix-specific questions are answered in
+http://www.ki.net/postgres95/docs/FAQ-Irix.phtml.
+
 Changes in this version (* = modified, + = new):
 
-   * *3.23) How do I create a serial field?
+   * *3.41) What is the meaning of some of the terms used in Postgres?
 
 ----------------------------------------------------------------------------
 
@@ -241,7 +247,7 @@ home page at:
 
 1.6) Latest release of Postgres95
 
-The latest release of postgres95 is version 1.07.
+The latest release of postgres95 is version 1.08.
 
 1.7) Is there a commercial version of Postgres95?
 
@@ -277,7 +283,7 @@ eventually we can also add the missing features listed above.
 
 1.10) Does Postgres95 work with databases from earlier versions of postgres?
 
-Postgres95 v1.07 is compatible with databases created with v1.01. Those
+Postgres95 v1.08 is compatible with databases created with v1.01. Those
 upgrading from 1.0 should read the directions in the MIGRATION_1.0_TO_1.02
 directory.
 
@@ -546,7 +552,7 @@ sending a mail to:
    * majordomo@listserv.direct.net
 
 OpenLink ODBC is currently in beta under Linux. You can get it from
-http://www.openlinksw.com/postgre s.html. It works with our standard ODBC
+http://www.openlinksw.com/postgres.html. It works with our standard ODBC
 client software so you'll have Postgres ODBC available on every client
 platform we support (Win, Mac, Unix, VMS).
 
@@ -626,8 +632,8 @@ Place the word 'EXPLAIN' at the beginning of the query, for example:
 Postgres does not allow the user to specifiy a user column as type SERIAL.
 Instead, you can use each row's oid field as a unique value. However, if you
 need to dump and reload the database, you need to be using postgres version
-1.07 or 2.* with pgdump's -o option or COPY's WITH OIDS option to preserver
-the oids.
+1.07 or later or 2.* with pgdump's -o option or COPY's WITH OIDS option to
+preserver the oids.
 
 Another valid way of doing this is to create a function:
 
@@ -771,7 +777,8 @@ INSERTed rows get a timestamp too, so rows that were not in the table at the
 desired time will not appear.
 
 Vacuum removes rows that are no longer current. This time-warp feature is
-used by the engine for rollback and crash recovery.
+used by the engine for rollback and crash recovery. Expiration times can be
+set with purge.
 
 3.38) How do I tune the database engine for better performance?
 
@@ -852,6 +859,8 @@ common usage. Here are some:
    * retrieve, select
    * replace, update
    * oid, serial value
+   * portal, cursor
+   * range variable, table name, table alias
 
 Please let me know if you think of any more.
 

doc/FAQ-Irix

+====================================================
+Frequently Asked Questions (FAQ) for Postgres95
+IRIX Specific
+TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
+====================================================
+last updated:           Fri Oct 11 14:45:00 BST 1996
+
+current maintainer:     Andrew C.R. Martin (martin@biochem.ucl.ac.uk)
+original author:        Andrew C.R. Martin (martin@biochem.ucl.ac.uk)
+
+
+Changes in this version (* = modified, + = new):
++3.1)   How do I compile a C program to create a function for extending
+        Postgres95
+
+
+This file is divided approximately as follows:
+0.*)    Bugs in Postgres95 V1.08
+1.*)    Installing Postgres95
+2.*)    Uninstalling Postgres95
+3.*)    Extending Postgres95
+
+
+Questions answered:
+0.1)    What bugs do I need to fix before Postgres95 will compile
+        under Irix?
+1.1)    What extra items do I need to install Postgres95 under Irix?
+1.2)    What changes do I need to make to src/Makefile.global?
+1.3)    What are the references in X11_LIB to libsocket and libnsl in
+        src/Makefile.global?
+1.4)    Are there any other changes I should make?
+2.1)    Why can't I move the executable files?
+
+----------------------------------------------------------------------
+Section 0:      Bugs in Postgres95 V1.08
+----------------------------------------------------------------------
+0.1)    What bugs do I need to fix before Postgres95 will compile
+        under Irix?
+
+        a) Fix the bug in src/Makefile.global:
+           Change
+                # Globally pass PORTNAME
+                CFLAGS+= -DPORTNAME_$(PORTNAME)
+                CFLAGS += -I ../../backend/port/$(PORTNAME)
+           to 
+                # Globally pass PORTNAME
+                CFLAGS+= -DPORTNAME_$(PORTNAME)
+                CFLAGS += -I../../backend/port/$(PORTNAME)
+
+           (i.e. remove the space after the -I)
+
+
+        b) Add the missing prototype to src/bin/pg_dump/pg_dump.h
+           After the line
+                extern int findLastBuiltinOid();
+           add
+                extern void setMaxOid(FILE *fout);
+
+
+----------------------------------------------------------------------
+Section 1:      Installing Postgres95
+----------------------------------------------------------------------
+
+1.1)    What extra items do I need to install Postgres95 under Irix?
+
+        You *must* have the following installed:
+        a) Gnu make (installed as gmake)
+
+        You are recommended to install the following:
+        a) GNU install (installed as ginstall)
+
+        You may choose to install the following:
+        a) GNU readline library (if you wish psql to have readline
+           support).
+        b) tcl/tk (if you wish to compile pgtclsh)
+
+1.2)    What changes do I need to make to src/Makefile.global?
+
+        You *must* set the following variables:
+                PORTNAME=       irix5
+                IPCSDIR=        /usr/sbin
+
+        You will also need to change the following to match your own
+        installation:
+                SRCDIR
+                POSTGRESDIR
+
+        If you switch on the USE_TCL option, you will need to set these:
+                TCL_INCDIR= 
+                TCL_LIBDIR= 
+                TCL_LIB = 
+                TK_INCDIR=
+                TK_LIBDIR=
+                TK_LIB =
+
+        You may also make any other changes you need as documented in
+        the INSTALL file and in Makefile.global
+
+1.3)    What are the references in X11_LIB to libsocket and libnsl in
+        src/Makefile.global?
+
+        These are Sun Solaris specific and shouldn't be in Makefile.global
+        The compile (including pgtclsh) seems to go OK even though 
+        these don't exist...
+
+1.4)    Are there any other changes I should make?
+
+        If you have installed the GNU install program (ginstall), you
+        should edit src/mk/port/postgres.mk.irix5
+        and change the line:
+                INSTALL=/usr/bin/X11/bsdinst
+        to
+                INSTALL=ginstall
+
+        For an explanation as to why this is a good idea, see Question 2.1
+
+
+----------------------------------------------------------------------
+Section 2:      Deinstalling Postgres95
+----------------------------------------------------------------------
+
+2.1)    Why can't I move the executable files?
+
+        By default, the IRIX port uses the BSD compatible version of
+        install from /usr/bin/X11. If you read the man page for this
+        version of install, you will see that it is not meant for
+        end-user use; it has the interesting side-effect of chowning
+        files it installs to root.
+
+        You should still be able to delete the files as you (the
+        postgres user) will own the directory in which they are
+        stored.
+
+        The normal IRIX install program cannot be used easily as it
+        takes its arguments in the reverse order. It is therefore
+        recommended to use the GNU version of install (ginstall).
+        See Question 1.4
+
+
+----------------------------------------------------------------------
+Section 3:      Extending Postgres95
+----------------------------------------------------------------------
+3.1)    How do I compile a C program to create a function for extending
+        Postgres95
+
+        Here is a sample command line:
+
+        cc -I/usr/local/postgres95/include/ -I/usr/local/postgres95/src/backend 
+                -shared -o funcs.so funcs.c
+
+****************************************************************************
+Dr. Andrew C.R. Martin,         University College London & SciTech Software
+EMAIL: martin@biochem.ucl.ac.uk                Tel:(Work) +44(0)171 419 3890
+URL: http://www.biochem.ucl.ac.uk/~martin          (Home) +44(0)1372 275775
+****************************************************************************