ICONISER

                        By Michael Saunby

INTRODUCTION

Features
Iconiser generates icons for invisible files so they may be moved, copied, 
duplicated, or discarded from the workbench without executing a single CLI 
command.
Iconiser can discard an icon without discarding the file, making the file 
visible.
Iconiser runs from the Workbench or the CLI.
Iconiser does not enable copies to be made of copy protected disks, indeed 
Iconiser should never be used on any original disk.

Requirements 
Iconiser requires Workbench 1.2. Iconiser accesses the icon library on the
Workbench disk so you may be asked to insert the Workbench disk when you
start Iconiser. This is the only time the Workbench disk is needed so when
the disk lamp goes out it may be removed.

WARNINGS 
Iconiser uses RAM: the ram disk device. If RAM: is not already open 
Iconiser will open it, consequently you may notice a small decrease in 
available memory.
For some programs it will be possible to run them as workbench tools. 
Others such as the CLI commands on the Workbench disk cannot be run in 
this way, though it is usually possible to use a program such as Xicon to 
run them. See the iconiser options section before using Iconiser to 
create icons for programs to be run from the Workbench 

HOW TO USE ICONISER 
Iconiser is simple to use. Click once on Iconiser, press and hold a 
shift key and then click twice on the disk to which you wish to add 
icons. If the disk was already open, close it, then open again to 
reveal any new icons. If the disk was closed, open it to reveal the 
icons.

If you have only one disk drive, Iconiser is easier to use if copied 
to RAM: the ram disk device.

Multiple selection.
Multiple selection may be used with Iconiser. Click once on Iconiser, 
hold a shift key and click once on each drawer or disk to be processed 
except the last. Click twice on the last disk or drawer.

Removing icons with Iconiser.
To remove the icon from a tool or project, click once on Iconiser, hold 
a shift key and click twice on the icon to be removed. A requester will 
appear at the top left corner of the screen; it looks like this:


         --------------------------------------- 
        |System Request ====================[][]|
        |---------------------------------------|
        | Discard icon "myprog"                 |
        | Warning: you cannot get               |
        | back what you discard                 |
        |                                       |
        | ---------------          ------------ |
        |  ok to discard            forget it!  |
        | ---------------          ------------ |
         ---------------------------------------

To remove the icon click on 'ok to discard', to cancel click on 
'forget it!'. Multiple selection can be used when removing icons, the 
requester will appear for each file.
To remove the icon from a drawer requires Iconisers delete mode to be 
switched on. This is done by entering the following text into iconisers 
tool types:
DELMODE=ON

Iconiser options
In addition to DELMODE there are two other modes which can be set. They
are set using the IFFTYPES and TOOLTYPE options.For projects there is 
the IFFTYPES option, this is used to set a default tool for IFF files. 
eg
IFFTYPES=ILBM ILBM=:ShowILBM

Other possible options are SMUS or FTXT or any other ILBM FORM. A vertical
bar should be used to separate types. eg
IFFTYPES=ILBM|FTXT
ILBM=Workbench:ShowILBM 
FTXT=:ShowText 

For tools there is the TOOLTYPE option, this determines whether an icon is 
created for the tool itself or for a script file to be executed by another 
program eg Xicon.
TOOLTYPE=PROJECT   or     TOOLTYPE=TOOL
TOOLNAME=C:XICON
TOOLTEXT=(NAME) argument

The variable (NAME) can be used in the TOOLTEXT argument; (NAME) will be 
replaced by the name of the program. After any substitution has been made 
the text is written to a file with the name of the program with the 
character '-' appended. A project type icon is  created for this file.

Summary of options 
DELMODE=ON  or  DELMODE=OFF  default is OFF
IFFTYPES=ILBM|FTXT  default no IFF types set
ILBM={path1}{prog1}
FTXT={path2}{prog2} 
TOOLTYPE=PROJECT  or  TOOLTYPE=TOOL  default is TOOL
TOOLNAME={path}{prog}  no default, if not set TOOLTYPE defaults to
                                        TOOL 
TOOLTEXT=(NAME) no default, if not set TOOLTYPE defaults to TOOL

nb case is important in tool types entries.

ERROR MESSAGES
Iconiser uses requesters to indicate various errors such as write 
protected disks or incorrect usage. Click on one of the "ok" boxes to 
remove the requester and continue.

CLI USAGE
Iconiser will create icons when used from the CLI, none of the options can
be used. The CLI usage is:
ICONISER dirname
Where dirname is the name of the  directory or drive. An alternative usage 
for single drive machines is:
ICONISER ?
iconiser will prompt with
DIR:
now swap the disk and type df0: or df0:dirname.