Club Amiga de Montreal - CAM/CAM_CD_1.iso/files/104.lha/DU-HERMES.doc

Text File | 1980-07-10 | 11KB | 240 lines

                           DU-HERMES  (Version 2.5)


                              (February 1, 1988)


                              (Shareware Program)


*      TO RUN IT IMMEDIATELY: Make sure you have STACK, ARC and SHOW in     *
* your current c directory.  Place the file MODULE in the same c directory. *
*      Press: RUN DU-HERMES, or CLICK THE DU-HERMES icon from the Wbench.   *
*      TO EXIT THE PROGRAM: Choose QUIT from the menu, or click into the    *
* rectangle at the bottom right of the screen, or press RIGHT_AMIGA-Q.      *

     Here is a new and better version of DU-HERMES.  It now has another
page of gadgets (72 total number of gadgets) that is user-configurable and
allows the user to use PARAMETERS in his commands.
     You can now run it from the Wbench with an icon too!
     In the file HERMES.file, these are the 24 last entries.  Each entry
has a gadget title as before (see below) under which the user can enter
a command with up to 2 parameters.  For example, if you want your own
gadget with the command FIXOBJ in it, just use the title FIXOBJ in the
corresponding position of HERMES.file and under it add "Run Fixobj %s %s"
without the quotes of course.  The symbols %s %s stand for the two para-
meters that Fixobj needs.  The first one is the filename and the second
is the new filename.  The first parameter is the name of the file that
you have clicked in the table of files on the left, and the second is
a filename that you must enter in the C gadget.  For example, to Fixobj
the file "HELLO" with new name "GOODBYE", enter "GOODBYE" in the C gadget,
click the filename "HELLO" in the table of files and then click the
FIXOBJ gadget.  One-parameter commands will contain only one symbol "%s"
and that can be a filename from the table of files or any name in the
C gadget.
     DU-HERMES now has the WBench screen as the background screen and only
4 colors.  This makes the program considerably faster than its previous
versions.
     I have added 3 more gadgets per page and a "TASKS" entry in the menu
to display the current tasks.  The gadgets are: COPYDIR, EXEC-CLI and
NEWCLI (see below).

     EXPLANATION OF BUILT IN GADGETS:

     ALL:        Highlights all files, except directories.

     CLEAR:      Removes the highlighting from all files and directories.

     BYTES:      Displays at the bottom the number of bytes in all the
                 highlighted files (not directories).

     EDIT:       Edits the file that you have highlighted by clicking into
                 its line in the table of files on the left.  Make sure
                 you are not trying to edit a directory.

     READ:       Reads ASCII file you have selected.  This process uses
                 the console device.  It will not work on binary files.

     SHOW:       Shows the pictures you have selected.  You must have the
                 program SHOW in your C directory.  Andry Rachmat's SHOW
                 program is the best for me.

     DELDIR:     Deletes the selected directory.  You must delete all the
                 files inside a directory before you use this function.
                 This function works only on directories.

     PARENT:     Moves up one step in the directory tree.  It will stop
                 moving when it hits a root directory.

     MAKEDIR:    Creates a new directory with the name that you have
                 entered in the C gadget.

     COPY:       Copies all the files that you have selected into the
                 Destination Directory that you have entered in gadget D.
                 Does not work on directories (see COPYDIR below).

     RENAME:     Renames a selected file or directory.  The new name
                 should be entered in the C gadget on the left.

     SWAP:       Toggles between the Source (S) gadget and the Destination
                 (D) gadget.

     DELETE:     Deletes the selected file.  It will not work on directories.

     GETDIR:     Attaches to the selected directory and displays its files.

     PRINT:      Prints the file you have selected to the printer.

     LISTARC:    Lists the files in an archived file you have selected.

     UNARC:      Unarcs the files of an archived file you have selected. Then
                 it re-displays the contents of the current directory with
                 the files extracted.  A re-direction window shows the
                 result of the unarcing.

     ARC:        Arcs the files you have selected into an archived file
                 that has the name you have entered in the C gadget.  You
                 don't have to include the ending .ARC in the C gadget.

     SINFO:      Displays the number of bytes available in the current
                 volume (like VD0:, DF0:, etc) in the Source gadget.

     DINFO:      Displays the number of bytes available in the current
                 volume (like VD0:, DF0:, etc) in the Destination gadget.

     RUN:        Runs any file you have selected.  Make sure it is a
                 runable file.
                 CAUTION: The file you have just run,like FACC or QMouse,
                 might be a resident program that does not close the
                 DU-HERMES WINDOW until it is off.  Remember this remark!

     COPYDIR:    Copies a selected directory into the directory specified
                 in the Destination gadget (D).

     EXEC-CLI:   It executes any CLI command that you enter in your C
                 gadget.  For example, if you enter in the C gadget:
                 "Run DH1:DELPAINT/Dpaint" and then you click into the EXEC-CLI
                 gadget, you are running the program Dpaint residing in the
                 directory DH1:DELPAINT.  Now, remember!  You cannot always
                 do this.  If you say "Run DH1:SONIX/Sonix" and then you
                 click EXEC-CLI, you are not going to be able to run Sonix.
                 This is because the Sonix program looks for its files like
                 Scores, etc.  If it doesn't find them, it does not load!
                 In this case, you should use the MACROS gadgets as I have
                 indicated in the HERMES.file.
                 CAUTION: When you run the program by its icon, you should
                 include the entire pathname for the files you might use in
                 the command in the gadget C.

     NEWCLI:     Opens a new CLI window on top of the DU-HERMES screen.

     PAGE 1:     Activates the built in gadgets.

     PAGE 2:     Activates the MACROS gadgets.

     PAGE 3:     Activates the PARAMETERS gadgets.


     *** DON'T FORGET ***

     YOU CAN RENAME ALL YOUR DRIVES GADGETS EXCEPT THE FIRST GADGET (RAM:).
     JUST ZAP THE DU-HERMES program and change the drive names to whatever
you want.  For example, if you want VDK: instead of VD0:, ZAP DU-HERMES
using FILEZAP, and change all occurrences of VD0: to VDK:. Trivial!!!

     Read below how you can make DU-HERMES run from your c directory by
putting the HERMES.file in a directory of your choice.


                           DU-HERMES  (Version 2.0)


                              (November 27, 1987)


                              (Shareware Program)

     This is a major revision of the DU-HERMES program.

     NEW FUNCTIONS: (You need the STACK command in your "c" directory)

     MACRO-CONFIGURABLE GADGETS:  The second page in the program is entirely
user-configurable.  Each gadget on that page can be configured so that
when you click on it once it executes a sequence of up to 7 commands.  These
commands reside in the file HERMES.file (see details below).

     A CONTINUOUSLY RUNNING CLOCK:  This clock is in the attached
MODULE file which resides in your current "c" directory.  The clock commu-
nicates with DU-HERMES via a port.  When DU-HERMES is clicked off, it
sends a message to the port.  The clock receives it and closes itself
down.

     RAM:  I have added another little window on top of the screen that
gives you the RAM:.

     MEMORY:  This is another MENU entry that gives you separately the
FAST MEMORY, the CHIP MEMORY and the AVAILABLE MEMORY.

     READ: I have written my own ASCII reading program that uses the
custom window and the console device instead of stdout and WBench.  I
think it is very nice.  I might even expand it to a full-featured editor.

     INFO: This command is in the MENU and gives you the INFO command, but
without the rather disturbibg "Volumes Mounted" at its tail!

     I have deleted the copiers (DISKCOPY & FORMAT) because they are two
slow when done on DirUtils.


OPERATION: USE ONLY FROM CLI.

     1) Put the file MODULE in your current "c" directory.  The file
HERMES.file resides in the current directory along with DU-HERMES.  You
can trivially make this better:

     1a) ZAP DU-HERMES (using FILEZAP) and change the THIRD occurence of
HERMES.file to ANY DIRECTORY you please.  You have 30 spaces to do that.
     For example, if you want HERMES.file in DF0:c, ZAP DU-HERMES, look
for the third occurence of HERMES.file and change that string to:
"DF0:c/HERMES.file".

     If you do 1a), then you can place DU-HERMES in your "c" directory
and run it by pressing: RUN DU-HERMES.

     2) To prepare your own command sequences, remember the following:

     2a) HERMES.file starts always with an empty line and finishes with
an empty line.  Each gadget name contains exaclty 10 characters.  This
includes the quote (") at the end of the name of the gadget.  Center your
custom gadget name as much as possible.  Your gadget name can of course have
up to 9 characters that will appear on the second page of gadgets.

     2b) Right after each custom gadget name you put your own commands.
Eache line will contain ONLY ONE COMMAND.  Do not string them together!
You can afford up to 7 commands under each gadget name.  However, only the
first command can contain the "cd" command in it.  I did it this way, so
that the program does not have to look for "cd" all the time and slow
down.  You can change ALL 21 gadgets of Page 2. At the
end of the sequence of commands under a gadget you MUST HAVE AN EMPTY
LINE.

     THIS IS A SHAREWARE PROGRAM.

     IF YOU USE THE PROGRAM, PLEASE SEND $15.00 TO

                   A. G. Kartsatos
                   8524 Caladesi Island Drive
                   Tampa, FL 33637, USA

    IF YOU SEND YOUR CONTRIBUTION, YOU WILL ALSO RECEIVE THE LAST VERSION OF
HERMES' PALETTA PROGRAM AND HERMES' ARTWORK OF IFF PICTURES DONE BY
*** DOUG'S MATHEMATICAL AQUARIUM ***.

                   A. G. Kartsatos  ("HERMES" on People Link)
                   SYSOP, *MON AMI*
                   (813)-985-7624, Tampa, FL, USA
                   (70 MegaBytes, 1100 Files Online!)