|
| 1 | + |
| 2 | + |
| 3 | +Copyright (c) 1994-7 Regents of the University of California |
| 4 | + |
| 5 | +Permission to use, copy, modify, and distribute this software and its |
| 6 | +documentation for any purpose, without fee, and without a written agreement |
| 7 | +is hereby granted, provided that the above copyright notice and this |
| 8 | +paragraph and the following two paragraphs appear in all copies. |
| 9 | + |
| 10 | +IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR |
| 11 | +DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING |
| 12 | +LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS |
| 13 | +DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE |
| 14 | +POSSIBILITY OF SUCH DAMAGE. |
| 15 | + |
| 16 | +THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, |
| 17 | +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY |
| 18 | +AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS |
| 19 | +ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO |
| 20 | +PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. |
| 21 | + |
| 22 | + |
| 23 | + |
| 24 | + |
| 25 | +PGACCESS 0.3 , 29 September 1997 |
| 26 | +================================ |
| 27 | + |
| 28 | + |
| 29 | + |
| 30 | +1.Why PGACCESS ? |
| 31 | + |
| 32 | +First of all because PostgreSQL lacks a graphical interface where you |
| 33 | +can manage your tables, edit them, define queries, sequences and |
| 34 | +functions. |
| 35 | + |
| 36 | +I use Tcl/Tk because it's a powerfull language, and it took me only |
| 37 | +three days of hard work to get it as you see it now. |
| 38 | + |
| 39 | + |
| 40 | + |
| 41 | +2.How to INSTALL ? |
| 42 | + |
| 43 | +You will need Tcl/Tk package, I am using now Tcl 7.6 and Tk 4.2. There |
| 44 | +are some problems running under Tcl/Tk 8.0 but I will soon fix them. |
| 45 | + |
| 46 | +Also, you will need the PostgreSQL to Tcl interface library. It is |
| 47 | +called libpgtcl and the source is located in the PostgreSQL directory |
| 48 | +/src/interfaces/libpgtcl. Specifically, you will need a libpgtcl |
| 49 | +library that is 'load'-able from tck/tk. |
| 50 | + |
| 51 | +Under Linux, this is called libpgtcl.so. You will find a pre-compiled |
| 52 | +copy of it for Linux i386 systems at : http://www.flex.ro/pgaccess. |
| 53 | +Just copy libpgtcl.so into your system library director (/usr/lib) and |
| 54 | +go for it. |
| 55 | + |
| 56 | + |
| 57 | +3.How to run it? |
| 58 | + |
| 59 | +You run it with the command: |
| 60 | + |
| 61 | +wish -f pgaccess.tcl. |
| 62 | + |
| 63 | +Another way of loading the PostgreSQL library is running it with pgwish. |
| 64 | +It's a wish compiled with libpgtcl library so it could understand the |
| 65 | +commands for working with PostgreSQL. For this, remove the line "load |
| 66 | +libpgtcl.so" from the source. If your operating system has a different |
| 67 | +library name or location, change the 'load libpgtcl.so' line in the |
| 68 | +pgaccess.tcl file. |
| 69 | + |
| 70 | + |
| 71 | +4.What does it now ? |
| 72 | + |
| 73 | +Opens any database on a specified host at the specified port. |
| 74 | + |
| 75 | +Tables |
| 76 | +- opening tables for vieweing, max 200 records |
| 77 | +- column resizing by dragging the vertical grid lines |
| 78 | +- table layout saved for every table |
| 79 | +- import/export to external files (SDF,CSV) |
| 80 | +- filter capabilities ,enter filter like price>3.14 |
| 81 | +- sort order capabilities ,enter manually the sort field(s) |
| 82 | +- editing in place |
| 83 | +- table generator assistant lizzard :-) (not wizzard) |
| 84 | +- table renaming and deleting (dropping) |
| 85 | +Queries |
| 86 | +- define, edit and store "user defined queries" |
| 87 | +- can store queries as views |
| 88 | +- execution of queries |
| 89 | +- vieweing of select type queries result |
| 90 | +- running action queries (insert, update, delete) |
| 91 | +Sequences |
| 92 | +- define them |
| 93 | +- inspect them |
| 94 | +- delete them |
| 95 | +Views |
| 96 | +- defining them saving queries as views |
| 97 | +- view them , with filtering and sorting capabilities |
| 98 | +- delete them |
| 99 | + |
| 100 | + |
| 101 | +5.What it should do in the future ? |
| 102 | + |
| 103 | +- table design (add new fields, renaming, etc) |
| 104 | +- script execution (simple SQL commands) |
| 105 | +- function manipulation (defining, vieweing) |
| 106 | +- a simple report generator and viewer |
| 107 | +- help on line |
| 108 | + |
| 109 | + |
| 110 | + |
| 111 | +6. How you should report the errors? |
| 112 | +First of all : operating system, PostgreSQL version,Tcl/Tk version. |
| 113 | +A more detailed story of what have you done when error had occured. |
| 114 | +Tcl/Tk stops usually with a error message and there is a button there |
| 115 | +"Stack Trace" and if you press it, you will see a detailed information |
| 116 | +about the place where it stucks. Please send it to me. |
| 117 | +Some information about table structure, no. of fields, records would |
| 118 | +be also good. |
| 119 | + |
| 120 | +=========================================================================== |
| 121 | + |
| 122 | +You will always find the latest version at: http://www.flex.ro/pgaccess |
| 123 | + |
| 124 | +Please feel free to e-mail me with any suggestion or bug description |
| 125 | +that will help to improve this. |
| 126 | + |
| 127 | +Constantin Teodorescu <teo@flex.ro> |
| 128 | + |