Update pgtcl to 0.3. Update README.

This commit is contained in:
Bruce Momjian 1997-09-30 00:22:43 +00:00
parent 8e4169c786
commit f19ccf932e
3 changed files with 128 additions and 92 deletions

128
src/bin/pgaccess/README Normal file
View File

@ -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>

View File

@ -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

View File

@ -1,4 +1,3 @@
#!/usr/bin/wish
#############################################################################
# Visual Tcl v1.10 Project
#