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 + diff --git a/src/bin/pgaccess/README.pga b/src/bin/pgaccess/README.pga deleted file mode 100644 index fdfca9490e..0000000000 --- a/src/bin/pgaccess/README.pga +++ /dev/null @@ -1,91 +0,0 @@ -PGACCESS 0.3 , 29 September 1997 -================================ - - - -1.Why PGACCESS ? - -First of all because PostgreSQL lacks a graphical interface from within -you could manage your tables, edit them, define queries, sequences and -functiones more simple than in psql. -In Tcl/Tk because it's a powerfull language, and it tooks me only 3 days -of hard work to get it like you see it. -It's for free! Probably I should enter here that kind of text that says -that is GNU-like license or whatsoever. -Let's say : -If PostgreSQL and Linux are for free, so PGACCESS should be. - - - -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.so and because most of the people asked for it, I -will supply a version compiled for 6.2 along with theese files. -It is compiled and it's working on my system, a RedHat 4.2 Linux on -Pentium machine. -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 - - - -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) - - - -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 would find always the last version at http://www.flex.ro/pgaccess - -Please feel free to e-mail me any suggestion , bug description that would -help me improving this - diff --git a/src/bin/pgaccess/pgaccess.tcl b/src/bin/pgaccess/pgaccess.tcl index d656ed77d0..bff19aa475 100644 --- a/src/bin/pgaccess/pgaccess.tcl +++ b/src/bin/pgaccess/pgaccess.tcl @@ -1,4 +1,3 @@ -#!/usr/bin/wish ############################################################################# # Visual Tcl v1.10 Project #