Amiga Survival Kit (Disk 80) (Feb 1988) : wiz12 / WIZARD.DOC

  ___________________________________________________________________________

            ##############################               ********   
            ##                          ##             ************
            ##    MERLIN'S  SOFTWARE    ##            *********  ***
            ##                          ##            **************
            ##         PRESENTS         ##            **************
            ##                          ##             ************
            ##############################               ********
            ##                          ##              @@@@@@@@@@
            ##        CLI WIZARD        ##             @@@@@@@@@@@@
            ##                          ##            @@@@@@@@@@@@@@
            ##############################           @@@@@@@@@@@@@@@@

                Written By  J.L. White          (C)1987  Merlin's Software   

                                     Version  1.2
  ___________________________________________________________________________







                             THE CLI WIZARD
                          Written By J.L. White
                        (C)1987 Merlin's Software
Version 1.2

What's New:
~~~~~~~~~~~
1. DOUBLE WINDOWS. After many requests, CLI-WIZ now has double windows.
   The switch used to swap directories in 1.1 is now used to flip from 
   source to destination. When it is clicked the directory display is
   toggled to the other directory. Which ever directory is displayed
   becomes the source directory. Both are buffered and are updated when
   files are copied from one to the other.
2. Two new gadgets are setup for 2 of Mark Riley's Fabulous Programs:
 A. PAK: can be used like Arc. Click on the files and Pak them!
 B. PLAY: will play Sonix songs. Click on a file, enter the Instrument
    directory and Turn up the Volume!
3. There are now 24 custom file gadgets and 14 directory gadgets. You
   flip between two sets (12 file & 7 directory gadgets).
4. The read command now accepts your favorite type command (more,less,
   etc.). You define this in the data file. If one is not found it will
   use its own read command.
5. The colors have been corrected in the picture file. Just load into any
   paint program and choose your own palette.
6. You can now turn off the sound in the data file. If you do not wish to
   have the sound on startup, just edit the data file to turn it off.
7. Alot of code has been cleaned up.
 
This will be the LAST Shareware version. If you like it and use it send 
$15.00 to:

J.L. White
1304 Four Seasons Blvd.
Tampa, Fla. 33613
(813) 971-4451

REGISTERED USERS will be informed of our latest releases of this and other 
software. You will also receive a copy of the released version at no charge!





Version 1.1

1. The program now runs from Workbench. Icon included.
2. Editing the custom gadgets is much easier. In version 1.0 you had to
   zap the program and edit the picture. Now all you have to do is edit
   a simple text file. Also there are 12 custom gadgets instead of 8.
3. Bug fixed when rapidly clicking the mouse button. In 1.0 this would
   lock up the program. It is no longer a problem.
4. Sound has been added. Beeps for the gadgets and guess what happens
   when you delete a file? You can turn off the sound if you wish.
5. There is no longer a Getdir gadget. All you have to do is click on
   the directory and it automatically reads it. To delete a directory
   simply enter the name in the extention box and click on the Deldir
   gadget.
6. There is now a switch on the screen. This is used to swap the source
   and destination directories. In the next version this will be set up
   like the double window dirutils. It will flip the display from one to
   the other.
7. If you have used a dirutil before and used the arc command to unarc
   a file, you have probably run accross the problem when it finds a
   file with the same name, it gets locked up. Well now it will just
   write over the existing file.
8. Assign has been added to the main gadgets. Now assign and arc have
   a custom output window. Instead of having to flip back to the
   Workbench screen, a window will come up with the output.
9. The gadgets have been moved around to make things a little more
   efficient.
10.It will now read a directory with 400 files. If you have that many
   files in one directory you must be crazy but it works anyway.


Yet another Disk Utility. I decided to write this because I could not find
one that did everything I wanted. One thing I hated was having to resize 
the window all the time to get to icons or other windows, so I put it on a
separate screen. Since I am into graphics so much I added a little Window 
Dressing (HAHA). I liked Greg Cunningham's DiskMan but I HATE Hi res flicker,
and I never did care for the double windows. So Anyway this is my rendition.


First off I would like to thank Athan Kartsatos (A.K.A. Souli). He got the 
main bugs worked out of this thing and got me up and running. Without his
help you probably would not be reading this. Thanks to Greg Cunningham for
helping me with loading the Graphics. To some this might be an easy task but
since this is only my second project in C it was a big problem. Thanks to
Dan James for help with the sound. Also thanks to Chris Nicotra and Nathan 
Barber for getting the ball rolling with the early versions of DirUtil.

12/12/87
*****************************************************************************
*                      Instructions for THE CLI WIZARD                      *
*****************************************************************************

To start program go to cli and type RUN WIZARD. It looks for a file called
Wiz.Pic so CD to the directory first. To run from Workbench, simply click
on the icon.

There are 24 gadgets that you can customize yourself. I will explain these
later. I will now briefly explain each of the gadgets functions.

You will need the following files in your C directory:

Run, Ed, Show, Arc, PAK, Play, Assign.

If these files don't exist those gadgets won't work but the rest will.
The files must be named as shown above. 
If you have C assigned to somewhere other than the SYS: disk you must also
have the SYS: assigned to that root directory. (ex. vd0:c assign SYS: to
VD0:).

DF0: DF1: DF2: DH0: DH1: RAM: VD0:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 These gadgets will list the files in the chosen device. These can be changed
like the custom gadgets. (read below).

S:
~~
 This shows the current source directory. Click in here to manually select
a directory. If you press return the directory will be read.

D:
~~
 This shows the current destination directory. Click in here to manually 
select a directory. If you press return the directory will be read. 

E:
~~
 This is used for extentions for files that you Run. Also to rename files or
name arc or pak files. I did not like to use the D box for this because then 
you had to enter the destination directory again to copy the files.

FLIP:
~~~~~
Flips the sets of custom file & directory gadgets.

TOGGLE:
~~~~~~~
Switches the source and destination displays. Which ever one is displayed
is the source and the other becomes the destination.

TIME:
~~~~~
 This displays the current system time. At this time you have to click a 
gadget to see it update.

RAM:
~~~~
 This displays the available memory that you have left. At this time you 
have to click a gadget to see it update.

DELDIR:
~~~~~~~
 Use to delete selected subdirectory. Error will occur if you try to delete
a directory that is not empty. Enter name of directory to delete in the E
box then click the gadget.

MAKEDIR:
~~~~~~~~
 Creates a directory with the name taken from the E box.

ROOT:
~~~~~
 Reads the current root directory.

PARENT:
~~~~~~~
 Reads the current parent directory.

ALL:
~~~~
 Selects all files in directory (including those not seen in window).

CLEAR:
~~~~~~
 De- Selects all files in directory.

BYTE:
~~~~~
 Shows amount of Bytes in all selected files.

SINFO:
~~~~~~
 Shows how much disk space is left on source device.

DINFO:
~~~~~~
 Shows how much disk space is left on destination device.

RUN:
~~~~
 Will run another program. Any output from the program will be directed to
the cli window you ran Wizard from. Select a file then click gadget. It will
also accept an extention from the E box.

COPY:
~~~~~
 Copies selected files from source to destination.

DELETE:
~~~~~~~
 Deletes selected files from source device.

MOVE:
~~~~~
 Moves a file from one directory to another on the same device.

RENAME:
~~~~~~~
 Renames a file or directory to the name in the E box.

LISTARC:
~~~~~~~~
 List the files in an arc file. A custom window will display the output.

PLAY:
~~~~~
 Uses Mark Riley's Play command. It should be in your c directory. Click on
a score and a window opens. Enter the directory for the instruments and it
plays the song. You can also play script files. Click on the file and enter
"P=" in the directory name gadget.

SHOW:
~~~~~
 Displays IFF pictures. Uses any iff reader named SHOW in the C directory.
Click upper left corner to exit picture.

READ:
~~~~~
 Used to read ASCII files (doc files, source code, etc.). Click on files to
read then click gadget. You can use your own read command by editing the
data file. If no command is found it will use it own.

EDIT:
~~~~~
 Used to edit ASCII files. Loads file called ED (ED, TXED, etc.). Click on
file to edit then click gadget.

PRINT:
~~~~~~
 Will print text file to printer.

PAK:
~~~~
 Use to add files to a pak file. Use E box for name of the pak then click on 
files to add. A custom window will display the output.

ARC:
~~~~
 Use to add files to an arc file. Use E box for name of the arc then click on 
files to add. A custom window will display the output.

UNARC:
~~~~~~
 Will extract files from selected arc file.  A custom window will display 
the output. It will write over a file with the same name so Listarc to
check before unarcing.

STATUS:
~~~~~~~
 This is where errors are displayed and also shows what the current function
is.

ASSIGN:
~~~~~~~
 This will show all assigned devices. It displays this in a custom window.
If you wish to reassign some device just enter it in the E box.(ex. C: RAM:C).

EXIT:
~~~~~
 To exit go to the Menu to exit.

SOUND:
~~~~~~
 You can turn this on and off from the menus. It can also be changed in the
data file to determine if it is on or off when the program starts.



CUSTOM GADGETS:
~~~~~~~~~~~~~~~

There are 24 gadgets that can now be customized. These are at the bottom right
hand corner of the screen. The directory gadgets can be edited the same way.
 

EDITING CUSTOM GADGETS:
~~~~~~~~~~~~~~~~~~~~~~~

 The 24 gadgets will accept info from the E box. To edit these files simply
load the text file called Wizard.data into a text editor. Each file name
can be up to 30 characters. The name of the gadgets can be up to 7. You
can also change the drive names. Just be sure to write over the existing
names. Don't add any spaces!

Remember that all except info from the E box so clear this before you run
another program. Also files like format that require you to press return
will not wait for a return. It will go ahead and run. So Beware!

Notice you can tell it where to look for the file by adding that to the name.
I hope this has been clear enough. I plan on many new enhancements in the
future. Let me know what you like and dislike about it...Later....J.L. White