
 ***************************************************************************
 *                                                                         *
 *   !!  TTTTTTTTTT  WW           WW EEEEEE  DDDDDD  IIIIII  TTTTTTTTTT    *
 *   !!  TT  TT  TT   WW         WW  EE      DD   DD   II    T   TT   T    *
 *   !!      TT        WW   W   WW   EEEE    DD   DD   II        TT        *
 *           TT         WW W W WW    EE      DD   DD   II        TT        *
 *   !!      TT          WW   WW     EEEEEE  DDDDDD  IIIIII      TT        *
 *                                                                         *
 *                        Made by Jens H. Ovesen, 1990                     *
 *                                                                         *
 ***************************************************************************

   The TwEdit utility provides a handy way of editing and changing attribu-
tes of various files. It got 3 basic modes: Edit, Set Type and Stamp. These
modes are selectable from the main menu, accessed by clicking Menu over the
TwEdit icon on the iconbar. The last modes are obvious. You'll find out :-)
   Other features include setting of *Lib and *Dir (the last one automatic
or manually). Standard keys for this is Shift-Print and Print, but this
can be changed, see below.
   Auto *Dir from the Options menu, decides if an automatic *Dir is to be 
done every time a directory is opened. Pressing the Alt key when opening the
directory toggles this feature. 
   TwEdit is fully compatible with the !Help application from the Welcome 
Discs. 
   A Quit from the menu will quit the task, then remove the TwEdit module
from RMA.
   A Quit from TwEdit done from the Taskmanager will only quit the task.
   Save from the Options menu saves the options to disc. Note that this is
done in the module itself, so !RunImage can't be locked for this to work.

   When dragging a file to the TwEdit icon on the iconbar in Edit Mode, 
TWIN will be invoked on all but BASIC-files, in which case ARMBE will be
invoked. A system variable "Path$Dir" will be set to the home directory of
the file. F0 (Print) will be set to the full pathname of the file.
   TwEdit is semi-intelligent: It grabs all application memory for editing,
and if it can't grab enough, it'll change to screen mode 0 and try again
before giving an error.

   In "!Run", the following variables are set:
   -------------------------------------------

   "ArmBE$Start" : Set to whatever CLI-command you prefer to be executed
before ArmBE is invoked. Harddisc users could use 
                                 'Set ArmBE$Start load <TwEdit$Dir>.ArmBE'
You could, on the other hand, also run an obeyfile to set your preferable
F-keys, for instance 'Set ArmBE$Start Run <TwEdit$Dir>.MyKeys'
   "ArmBE$End" : Set to whatever CLI-command you prefer to be executed when
ArmBE has finished. Harddisc users could use 'Set ArmBE$End RmKill 
                                                           ARMBasicEditor'
   "Twin$Start" : As for ArmBE$Start, before twin is invoked. If an obeyfile
is to be used, the last command should be '<some path>.Twin %*0'.
   "Twin132$Start" : Ditto for Twin132, ... '<some path>.Twin132 %*0'.
   "Twin$End"   : As for ArmBE$End, after twin has finished.
   "TwEdit$AppIm" : The file you want to be edited, when dragging an 
application to TwEdit. The file will be searched for in the application
itself.
   "TwEdit$DirK" : Defines which key will perform a *Dir <path>, where
<path> is the file path for the filer window the pointer is currently above.
   "TwEdit$LibK" : Defines which key will perform a *Lib <path>, where
<path> is the file path for the filer window the pointer is currently above.

Revision story of TwEdit:
-------------------------

Version 0.30:
   Hotkey function: Pressing F1 or Shift F1 over a filerwindow will set
current directory or library to that directory.

Version 0.32:
   Double-clicking on a data or text file will load the file into Twin as if
the file was dragged to the TwEdit icon on the iconbar.
   Automatic dir: Current dir set to last directory viewer opened. Alt 
toggles this.

Version 0.35:
   Automatic creation of header in a new BASIC program. Saving of current
BASIC screen mode.

Version 0.37:
   Responds to !Help application (Interactive help).

Version 0.38:
   Options menu added. Note that the Save option requires !RunImage in 
TwEdit to be unlocked!

Version 0.39:
   Fatal bug removed. Used to delete current file on (very) rare occasions, 
believing it was a <Wimp$Scrap>. I don't know how this could happen, I still
have the Wimp suspected for a bug. Anyway, I really make a complete check
now.

Version 0.40: 
   Not released.

Version 0.41:
   Loads !X.<TwEdit$AppIm> if an application !X is dragged to the icon.
Sysop of the Quercus bulletinboard, Thomas Christiansen, suggested this. The
feature used to be on my old !ARMBE and !Twin. I don't know why I didn't
implement it in TwEdit from the very start.
   Added Auto *Dir to options menu. Alt still toggles function.
   Added another hotkey: Shift-F12 enters Gos, returning when a 'Quit' 
command is given.
   Possibility of setting 'TwEdit$DirK' and 'TwEdit$LibK', defining the 
hotkeys for *Dir and *Lib. Defaults to Insert and Shift Insert. These codes
are given in the PRM's p. 1198.
   Possibillity of being in current mode when editing BASIC files added 
(option). 
   Doesn't necessarily change screen mode when editing BASIC files, only 
reserves screen memory for the selected mode (if option ticked) if possible.
If this doesn't succeed, nothing's done about that. If there isn't enough
room, a change to mode 0 is tried.
   Some compatibility problems with Window Manager 2.28 (bug in TwEdit
really) fixed.

Version 0.42:
   BASIC files represented by text is now loaded into Twin. Simple check on
&0D as first byte; don't expect to much!

Version 0.43:
   Does no longer set file attributes on exit.
   Option for Twin132 together with 'Twin132$Start' added. Uses Twin if 
there is not enough room for Twin132.

Version 0.50:
    Added "New Script" in menu :-)
    Put name in header of new obey file.
    Does an "Iconsprites" from program.
    Click with Select on icon edits last file edited.

Version 1.00
    Added Set Type feature.
    Added Stamp feature
    Changed the menu hierachy.
    Select on icon edits last file edited.
    Adjust on icon toggles between Set Type and Edit modes.

Version 1.02
    New menu item in 'Options', 'Twin E Mode', added. This select the E Mode
for Twin. Note that this won't work with Twin132. It was possible to use this
before if you made an upstart file for Twin. Not very friendly, though.


          Written '89-'91 by  Jens Henrik Ovesen
                              Tolderlundsvej 27, 4.tv.
                              DK-5000 Odense C
                              Denmark.             
          Phone:              (+45) 65 91 75 11
          Unix:               jho@imada.ou.dk

Credits:
   I used Richard K. Lloyd's first !Trashcan source as a templet for
starting a module task. Totally rewritten in version 0.1x though.
   Nice TwEdit icon made by Kim Latt. And he came up with the idea of
merging !Twin and !ARMBE. Does this satisfy you, Kim? (I'm not gonna credit
you for anymore than that!)
   The !Help application is made by Joris Roling.


NOTE:
             This program is Puplic Domain (PD) if copied in whole 
          without changes. You are not allowed to make any money 
          out of it! (Though I don't think you can.) 
             You are of course allowed to change !Run to suit
          your own needs.
