FSPtool v1.3.1 -- (c)1993 A.J.Doherty ===================================== FSPtool is an OpenLook compliant X-Windows program which gives an easy to use front end to the fsp client side software. It uses the XView libraries which are distributed with X11R5 and System V R4. If you are installing for a Sun then these will almost certainly be installed already, otherwise you may have to get hold of them (latest version is 3.2 -- you need at least 3.0) yourself. The standard fgetcmd, flscmd etc programs are retained and driven by the program, this means that updates to the FSP client and server programs are more easily accomodated. You simply install the new client executables and FSPtool uses them. I prefered this approach to hacking the FSP client code to suit and then incorp- orating it into the program. Feature wise it will be familiar to anyone who has used Ftptool. Essentially it provides directory browsing, semi-intelligent file typing and execution of downloaded files. The best thing is to try it and see ... Notes: ------ The main points to note about the current release are: * ~/.fsptoollayout files are no longer used so this version won't read the layout information in from that file. That's the bad news, the good news is that the application now has full resource management so the layout and all options can be saved to an ~/.fsptooldefaults file. * Functionality has been increased over previous versions, see "REVISIONS" for the gory details. * Bug reports, comments, whatever should be sent to ssudoher@uk.ac.reading * You can get help through the On-Line help feature provided as part of the OpenLook standard. Pressing the key on your system over an item of the program will bring up help text of the function and use of that item. Almost all items in the application have some help attached to them in this manner. On Sun Type-4 keyboard the help key is literally at the lower left of the keyboard, on other systems ask your SysAdmin which key has been defined for the help functionality. Note this Help feature will not work if the FSPtool.info file is not installed correctly or not accessible to the user at run-time. Installation: ------------- You will need to have a copy of the FSP client programs - version 2.7.1 is the latest available at the time of writing. These will need to be compiled and placed somewhere which is accessible to the FSPtool program at run-time. 1) Edit the "config.h" file as required, mainly this should involve changing the names of the FSP client programs to suitable ones for your setup and setting the location of the "FSPtool.info" help file. 2) Edit the Imakefile - if required - for your system. 3) type "xmkmf" to create a new Makefile 4) type "make" to compile and link the program. 5) Install the FSPtool.info help file in the directory you have told the program to find it in. This should produce an executable for fsptool in this directory, install it wherever you wish. Portability: ------------ FSPtool runs happily under OLWM/OLVWM, MWM and TWM window managers. TWM doesn't ( in our setup anyway) provide a close button so this can be a problem. However in contrast to previous release all of the sub-windows should now open and close with the main window and should pop up in the locations in which you saved them with "Save Layout". As for System variances the file should help to keep down any problems and the C library routines used are all fairly run of the mill UNIX things ... of course this could be a problem if you're not running unix :-) . I'm attempting to make the whole thing as portable as possible, so if people could let me know about system they have installed it on and problems they may have had, I'd be grateful. FSPtool is currently known to run on: Sparc-1 SunOS 4.1.1 Sun SLC SunOS 4.1.1 Sun 4/690MP SunOS 4.1.3 All development work has been using GCC version 2.4.5, older versions of GCC shouldn't have any problems compiling FSPtool. As for other ANSI C standard compilers, the code is ANSI compliant so they shouldn't have any problems, that said I haven't had access to one to try this is in practise. Coming Next..... ---------------- The next scheduled release -- or the one after -- will have a variety of extra features, mainly: I keep saying this don't I ... 1) Auto untar, unzip, gzip and uncompress on compressed, zipped etc. files that you double-click on. 2) Directory caching to speed things up and reduce data transfer. 3) A batch file get feature, enabling you to select files in directories and add them to a list of files to download. This list can then be either downloaded internally by the program, or it will generate a "sh" or "csh" script using the fsp clients which can download the batch list when run. 4) More intelligent file typing, using magic numbers at the local end once files have been downloaded. 5) As ever, anything else sensible that is suggested ... and for the not so distant future a Motif Version of FSPtool. ----------------------------------------------------------------------------- Copyright (c)1993 Andrew J. Doherty. Permission to use, copy, modify and distribute this software and its documentation for any purpose is hereby granted, provided that the above copyright notice and this permission notice appear in all copies of the software and related documentation. THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -----------------------------------------------------------------------------