                    Jekyll Shell for STalker, version 1.2
              Written by Tim Seufert, December 1992/January 1993

     Freeware - distribute freely and alter source.  Please try to include 
     a little credit, both the compiled script and the source, and this    
     document file.                                                        


INTRODUCTION:

     Jekyll Shell for STalker (from now on, JSS) is a BackTALK script       
program for STalker version 3.00 or above.  It allows you to run Jekyll,    
the bidirectional file transfer protocol written by Vincent Partington,     
from within STalker with a minimum of pain.  It's not terrifically fancy,   
but I've tried to make it fairly bulletproof.  Since version 1.0, I've      
caught a few bugs, and even added a couple of features in version 1.2.      
(Bet you didn't know you could improve on something this simple!)           
     
INSTALLATION:                                                               

     Just copy JEKLSHEL.BTK (and JEKLSHEL.BTS if you feel like messing with 
the source code) into your STalker BackTALK script directory.  If you want  
JSS to be more handy, install it in STalker's BackTALK menu, or as a script 
chained to a function key (consult your STalker manual if you don't know    
how to do these things).                                                    

     The first time you run JSS, it will ask you to locate JEKYLL.TTP,      
putting up the standard file selector dialog.  Change to whatever directory 
you keep Jekyll in, select JEKYLL.TTP, and click OK.  JSS will then write a 
small ASCII configuration file (named JEKLSHEL.CFG) to STalker's BackTALK   
script directory, and proceed normally.  The next time you run JSS, it will 
load in the configuration file, and you will not be asked to locate         
JEKYLL.TTP.  If you should change the location of JEKYLL.TTP, JSS will not  
be able to find it and will go through the location process again.          


USAGE:

     After it has located JEKYLL.TTP (either by reading its location from   
JEKLSHEL.CFG or by asking you), JSS collects a list of filenames from you   
via the file selector.  Every time you select a file, JSS will first verify 
that it exists, add it to the list if it does exist, and then put up the    
file selector again.  After you've selected all the files you want to give  
to your friendly neighborhood Sysop, click the Cancel button in the file    
selector.  JSS will then create a JEKYLL.FLO file with the list of          
filenames you entered, and attempt to start up Jekyll.  (If you don't       
select any files, JSS will exit without running Jekyll.)  If all goes well, 
JEKYLL.TTP will start up, read in the JEKYLL.FLO file, and begin the        
simultaneous upload and download.                                           

     If you don't want to upload any files, just click the "No UL's" button 
at the initial dialog box.  Jekyll will be started up with no JEKYLL.FLO    
file, so you'll have to select files to upload from within Jekyll itself if 
you change your mind about being a total leech.  <g> Also, if you click OK  
and then just click the Cancel button without selecting files, JSS will ask 
you if you want to quit or start Jekyll without selecting any files.  Both  
of these features are new in version 1.2 - progress on something I thought  
I'd never need to update.                                                   
                                                                            

KNOWN PROBLEMS:

     If you run STalker as an accessory, you must run MiNT, MultiTOS, or    
NeoDesk in order for JSS to be able to automatically start Jekyll.  This is 
not the fault of JSS or STalker, it's a limitation in normal TOS with       
respect to what a desk accessory can and can't do.  DA's just aren't        
allowed to start up external programs.  MiNT and MultiTOS both eliminate    
that particular rule.  Also, if you run STalker as a NeoDesk Accessory      
(naturally, you must be running NeoDesk to do that), it can ask NeoDesk to  
start external programs for it.                                             
     
     For reasons unknown to myself, JSS sometimes seems to bring out a very 
odd bug in STalker 3.02 (STalker being used as an accessory - I don't know  
if this happens when STalker is run as a program).  Sometimes, after        
running JSS, STalker no longer draws the text cursor in the main window,    
and when you click the drop-down menus, STalker erases the menu entries as  
you move the mouse over them instead of highlighting them.                  

     Both times that I have successfully tested JSS, Jekyll has returned    
strange positive error codes after a successful transfer.  Due to this      
problem, JSS will not report a positive return code as an error, even       
though convention is that any return code other than 0 indicates an error.  

     I have fixed a bug from the last version wherein JSS did not write a   
carriage return after each filename in the JEKYLL.FLO file, sometimes       
resulting in Jekyll not detecting all the files.                            
                                                                            

MISCELLANEOUS:
     
     I can be reached at the following BBS:
     
         Sanctuary From The Law BBS running RATSoft ST v.1.6h beta on
         a TT030/2 with 220 megs and a US Robotics Dual Standard HST
                1200-14,400 Baud - (HST/V.42bis/V.32/V.32bis)
         
                 Sanctuary From The Law Network Node Numbers
                            (1:210/41.0 @ FidoNet)
                            (51:3/11.0 @ AtariNet)
                           (100:290/7.0 @ TurboNet)
     

STalker and BackTALK are trademarks of Strata Software.
NeoDesk is a registered trademark of Gribnif Software.

