Update pgtcl to 0.3. Update README.

1 files changed, 128 insertions, 0 deletions

diff --git a/src/bin/pgaccess/README b/src/bin/pgaccess/README
new file mode 100644
index 0000000000..dbd5e5830f
--- /dev/null
+++ b/src/bin/pgaccess/README
@@ -0,0 +1,128 @@
+
+
+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
+is hereby granted, provided that the above copyright notice and this
+paragraph and the following two paragraphs appear in all copies.
+
+IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
+LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
+DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
+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.
+
+
+
+
+PGACCESS 0.3 , 29 September 1997
+================================
+
+
+
+1.Why PGACCESS ?
+
+First of all because PostgreSQL lacks a graphical interface where you
+can manage your tables, edit them, define queries, sequences and
+functions.
+
+I use Tcl/Tk because it's a powerfull language, and it took me only
+three days of hard work to get it as you see it now.
+
+
+
+2.How to INSTALL ?
+
+You will need Tcl/Tk package, I am using now Tcl 7.6 and Tk 4.2. There
+are some problems running under Tcl/Tk 8.0 but I will soon fix them.
+
+Also, you will need the PostgreSQL to Tcl interface library.  It is
+called libpgtcl and the source is located in the PostgreSQL directory
+/src/interfaces/libpgtcl.  Specifically, you will need a libpgtcl
+library that is 'load'-able from tck/tk.
+
+Under Linux, this is called libpgtcl.so.  You will find a pre-compiled
+copy of it for Linux i386 systems at : http://www.flex.ro/pgaccess. 
+Just copy libpgtcl.so into your system library director (/usr/lib) and
+go for it.
+
+
+3.How to run it?
+
+You run it with the command:
+
+	wish -f pgaccess.tcl.
+
+Another way of loading the PostgreSQL library is running it with pgwish.
+It's a wish compiled with libpgtcl library so it could understand the
+commands for working with PostgreSQL. For this, remove the line "load
+libpgtcl.so" from the source.  If your operating system has a different
+library name or location, change the 'load libpgtcl.so' line in the
+pgaccess.tcl file.
+
+
+4.What does it now ?
+
+Opens any database on a specified host at the specified port.
+
+Tables
+- opening tables for vieweing, max 200 records
+- column resizing by dragging the vertical grid lines
+- table layout saved for every table
+- import/export to external files (SDF,CSV)
+- filter capabilities ,enter filter like price>3.14
+- sort order capabilities ,enter manually the sort field(s)
+- editing in place
+- table generator assistant lizzard :-) (not wizzard)
+- table renaming and deleting (dropping)
+Queries
+- define, edit and store "user defined queries"
+- can store queries as views
+- execution of queries
+- vieweing of select type queries result
+- running action queries (insert, update, delete)
+Sequences
+- define them
+- inspect them
+- delete them
+Views
+- defining them saving queries as views
+- view them , with filtering and sorting capabilities
+- delete them
+
+
+5.What it should do in the future ?
+
+- table design (add new fields, renaming, etc)
+- script execution (simple SQL commands)
+- function manipulation (defining, vieweing)
+- a simple report generator and viewer
+- help on line
+
+
+
+6. How you should report the errors?
+First of all : operating system, PostgreSQL version,Tcl/Tk version.
+A more detailed story of what have you done when error had occured.
+Tcl/Tk stops usually with a error message and there is a button there
+"Stack Trace" and if you press it, you will see a detailed information
+about the place where it stucks. Please send it to me.
+Some information about table structure, no. of fields, records would
+be also good.
+
+===========================================================================
+
+You will always find the latest version at:  http://www.flex.ro/pgaccess
+
+Please feel free to e-mail me with any suggestion or bug description
+that will help to improve this.
+
+Constantin Teodorescu <teo@flex.ro>
+