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 <HELP> 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 <HELP> 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 <X11/Xos.h> 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.
-----------------------------------------------------------------------------

