PGBrowse Installation
---------------------

PGBrwose is a Tcl/Tk script which runs under an extended version of the
Tk interpreter called "wishpqx".  Wishpqx includes all of the
functionality of the normal Tcl/Tk wish along with Extended Tcl and
libpq.  The core of pgbrowse includes all of the run-time support you
need to run wishpqx - you do not need to install Tcl/Tk to use pgbrowse
unless you plan to re-compile wishpqx.  The core of pgbrowse, source
and pre-compiled version of wishpqx are available in the pub/pgbrowse
anonymous ftp directory of crseo.ucsb.edu:

	Filename		Description
	--------		-----------
	pgbrowse.tar.Z		core Tcl scripts (required)
	pgbrowse.mips.tar.Z	pre-compiled wishpqx for Dec MIPS Ultrix		
	pgbrowse.alpha.tar.Z	pre-compiled wishpqx for Dec Alpha OSF
	pgbrowse.risc.tar.Z	pre-compiled wishpqx for IBM RS6000
	pgbrowse.sun4.tar.Z	pre-compiled wishpqx for Sun Sparcstation
	pgbrowse.src.tar.Z	source for wishpqx (optional *)

	* If you want to re-compiled wishpqx, you'll need to install
	  Tcl, Tk, Extended Tcl and Postgres with libpq


Installation:
------------


1.  Get pgbrowse.tar.Z and any needed pre-compiled wishpqx files.
2.  Decide on a new directory for installation, call it $PGB.
3.  Extract the core:

	% mkdir $PGB
	% cd $PGB
	% zcat pgbrowse.tar.Z | tar xvf -

4.  Extract the wishpqx binaries you need:

	% cd $PGB
	% zcat pgbrowse.mips.tar.Z | tar xvf -
	% zcat pgbrowse.alpha.tar.Z | tar xvf -
	...

5.  You may want to do something sensible with $PGB/man/man1/pgbrowse.1
    and perhaps link $PGB/bin/pgbrowse to someplace nice.

6.  (Optional) Extract the source to wishpqx:

	% cd $PGB
	% zcat pgbrowse.src.tar.Z | tar xvf -

7.  (Only if you need to re-compile wishpqx) Do the right thing to
    $PGB/src/Makefile and edit the $PGB/bin/pgbrowse script.

8.  You're done!


Running:
-------

Be sure to define the envrionment variable PGBROWSE to point to the
installation directory (called $PGB above) before starting pgbrowse,
for example:

	% setenv PGBROWSE /usr/local/pkg/pgbrowse (csh)
	% PGBROWSE=/usr/local/pkg/pgbrowse; export PGBROWSE (sh)
	% $PGROWSE/bin/pgbrowse




$Id: INSTALL,v 3.1 1993/12/06 18:11:19 jimbo Exp jimbo $

