Club Amiga de Montreal - CAM/CAM_CD_1.iso/files/080.lha/UtilMaster.doc

Text File | 1986-11-20 | 14KB | 303 lines

        UtiliMaster

    Programable buttons!
    ARC Won't hang up on duplicate files!
    Two windows (Source & Destination)!
    Modify "Standard" buttons!
    Icon doubles as configuration file!
    Run from Workbench or CLI!

    The top display window is ALLWAYS the source, the bottom destination.
    The box above each display shows the current directory being displayed.
    The three boxes in the lower right are the Entry ("E") box, the
    source directory Disk or Device name, and the destination
    directory Disk or Device name. Swapping a disk while it's directory
    is being displayed will automatically get the parent directory of
    the new disk in the appropriate window UNLESS the name of the newly
    inserted disk is exactly the same as the one removed.

    Standard buttons:

    "Swap" Will swap the source and destination directories. Files
        may not be selected in the destination window other than
        Double-Clicking sub-directories. If source and destination
        are swapped, selected files are not highlighted in the
        destination window, but will be remembered and highlighted
        in the source window if directories are swapped back.
    "All" Selects all files in source directory.
    "AllDirs" Selects all sub-directories in source directory.
    "Exchange" De-selects all selected and selects all unselected.
    "ExcDirs" Same for directories.
    "Clear" De-selects all selected files.
    "ClrDirs" Same for directories.
    "Copy" Copies all selected files and sub-directories (including
        files in sub-directories) to destination directory.
        Copy also copies file comments, and if NOLOCK=1 has
        not been entered as a tooltype in the icon, protection
        on the copy is set to the same as the orriginal. (If
        protection on the orriginal is "r-e-" then the copy is
        set to "r-e-".)
        If you enter a FileName in the "E" box, and copy
        a file, it will be renamed in the destination directory.
        In this case, copy stops after the first FileName if
        more than one is selected.
    "Rename" Will rename the FIRST selected file or directory to
        the name in the "E"(Entry) box. If no name appears
        in the "E" box, a requester appears requesting the
        new file name.
    "Move" If destination directory is on the same device as source,
            selected files will be moved into destination directory.
            If not on the same device, an error message is displayed.
    "Delete" Will present a requester asking if you are sure. Given an
        affirmative, it will delete selected files. Selected
        directories will be automatically deleted if empty.
        For directories containing files, a second requester appears
        reminding you they are not empty. Given an OK, these
        directories, and all files and sub-directories will be
        deleted.
    "Lock" Changes the protection on selected files/directories to
        "r-e-". They are protected from being written to or
        deleted.
    "UnLock" Changes protection to "rwed".
    "Read" Displays the selected file(s) to the screen. ASCII files
        are displayed in text mode, binary etc. are displayed
        as if "c:type opt h" were used.
    "FileNote" Attaches whatever is in the "E" box (Even a null string!)
        as a comment to each selected file REPLACING any existing
        comment. Using FileNote with the "E" box empty will
        delete any existing comment.
    "GetNote" Displays the comment on selected file(s) in the Status
        box and the Filename in the "E" box. There is a brief delay
        built in so you have a chance to read them if more than
        one file is selected. Note that commented files display
        a c in a circle just to the left of their size in the
        display window.
    "Print" By default, if Utilimaster can find a file named "c:print"
        it will be RUN and passed the filename, if not, an internal
        routine will print the file to PRT:. The default external
        print routine can be changed. See "Setting Defaults", below.
    "Show" By default uses "c:show" to display the selected file(s).
        Show can also be re-defined,
    "Search" By default opens a window and calls "c:search" passing it
        the content of the "E" box as the string to seek, and
        selected file(s) to search.
    "Arc" "DeArc" & "ListArc" by default all use "c:arc".
            "Arc" opens a window and Executes
           "c:Arc a Filename <FileName> <FileName>" for selected
           file(s).
        "DeArc" Opens an interactive window and Executes
           "c:Arc x FileName".  If duplicate files are found,
           this version of UtiliMaster DOES NOT lock up in
           the endless loop most others do!
    "ListArc" Opens a window and Executes
           "c:arc v FileName" The window remains open for reading
           until you close it.
    "Run" Is equivelant to typing "run > nil: FileName" from CLI.
        No window is opened for your file by UtiliMaster.
    "Edit" Defaults to "run e FileName"
    "Execute" Defaults to "Execute FileName"
    "GetDir" Gets the directory in the "E" box, which MUST begin
        with a device name. If the "E" box is empty, the current
        source directory is up-dated. Usefull if you have added
        or deleted a file from some other program.
        To get a sub-directory in the source window, Double-Click
        on that directory's name with the left mouse button. For
        a sub-directory in the destination window, Double-Click
        on it with the RIGHT mouse button. To get the parent
        of any sub-directory, Double-Click on the Directory
        name box at the top of the listing window.
    "MakeDir" Will make a directory with the name in the "E" window.
        If nothing appears in the "E" window, a requester appears.
        If MakeDir was clicked with the LEFT button, the directory
        will be created in the source directory. If the RIGHT
        button was used, the new directory goes in the destination.
    "Info" Displays the number of USABLE bytes free on each device
        in the window where the device name usually appears.
        (Or free memory in the case of the Ram Disk) If any
        files (NOT directories!) are selected, their total bytes
        and number of x-modem blocks is disp[layed in the status
        window.
    "NewCLI" Will start up a new CLI if Utilimaster can find "c:NewCLI".

    There are four more buttons which do not appear unless defined
        by the user as described below.

    All of the "Device" (DF0: DF1: RAM: etc.) buttons may be
         re-programed to get other devices in the following
         manner:

         To change "VD0:" to "VDK:", select (SINGLE-Click) the
         Utilimaster icon on the workbench screen. Select "Info"
         from the workbench menu. Click the "ADD" box next to
         the "ToolTypes" window. Click in the "ToolTypes" box
         and type "VD0:=VDK:" Please note that "VD0:" MUST be
         upper case, but "vdk:" may be lower case if you so
         desire. If you want other text in the button for the
         device, leave a space and enter up to 8 characters.
         EXAMPLE: To change "SYS:" to call your "s:" directory
         with the button lbeled "Scripts" add a tooltype line
         which says "SYS:=s: Scripts"
         EXAMPLE: To change "DH1:" to call up the directory
         "SYS:MyFiles" and the button to display "All Mine"
         add a tooltypes line of "DH1:=sys:myfiles "All Mine"".
         Note that "All Mine" should be entered in the tooltypes
         box in quotes!

    Each time UtiliMaster is started (whether from workbench or CLI!)
        the icon is parsed for these settings as well as those
        described below.

    UtiliMaster defaults to "SYS:" as the source, and "RAM:" as the
        destination directories on startup. You can change this
        by adding a tooltype line that says
         "DEFAULT=Directory Directory". The first directory listed
         will become the default source, the second will become
         the destination.

    UtiliMaster allows you to dictate a command directory other than
        "c:" To do so add a tooltype line
           "COMMAND=DirectoryName". If the directory does not
           exist, Utilimaster will attempt to create it. Utili-
           Master will then attempt to copy "c:run","c:newcli",
           "c:endcli","c:execute",and "c:assign" into this
           directory. It will then attempt to "assign c:
           DirectoryName". (This is due to the fact that the
           DOS Execute() command invokes "c:run" in order to
           function. The manx "exec()" commands don't need
           "c:run", but won't function within a program started
           from WorkBench!. They've got us between a rock and a
           hard place!)
             On exiting UtiliMaster, "c:" will be assigned to
           "SYS:c" unless you specify elswhere by a tooltype
           "REASSIGN=DirectoryName".
             If Utilimaster created a new command directory,
            it will be deleted. If you assigned command to
            an existing directory, it will be left intact on
            exiting UtiliMaster. (Including any files UtiliMaster
            copied into it!)
              Other utilities may be copied into your newly
           created command directory via a tooltype
           "COPYLIST=FileName FileName FileName (etc.)". All
           FileNames should include the Device:.

    USER BUTTONS: (Including changes to Show, Print, Arc, Search, etc.)

    Each of the four user buttons is defined by a tooltype line.
    "USER#=FileName ButtonText [flags] [Perameters] [PromptText]"
    Where FileName is the FULL directory name of the program to invoke.
    ButtonText is the text (up to 8 characters) for the button.
    Flags are desribed below.
    Perameters (up to 8 characters) to pass to function).
    PromptText (up to 30 characters) Is the Text to present in a
      Requester if your program requires user input. (Example: A fileName
    to create). If no promptext is provided, no requester will appear.

    Flags:
      If your program is simply to be run (Example "sys:Clock"), then
    flags=0. (You need not even enter them as no Perameters or Promptext
    are permitted.)
      Otherwise, flags starts as 0.
      To RUN your program with selected FileName(s) passed to your
        program, add 1. The result is as if typing:
            "run >nil: CommandName FileName"
        from CLI for EACH Selected File. If 1 is NOT added the result is
        like typing:
            "CommandName FileName" from CLI for each selected FileName.
      To open a window for your program to output text (It thinks it's
    running from CLI!) add 2.
      To open a window from which your program can accept keyboard input,
    add 4. DO NOT add 2 AND 4!
      To have perameters passed BEFORE the FileName, enter Perameters
    and add 8 to flags.
      To have perameters passed AFTER the FileName, enter perameters
    and add 16 to flags.
      If you use an output only window (you added 2) and want the window
    to close after each FileName has been passed, add 32. Otherwise the
    window will remain open until you close it.
      To exclude selected directories from being passed to your program,
    add 64.
      The number entered for "Flags" should be a total of the above
    depending on what you want to happen.
    EXAMPLES:
      If Flags=0 Then the result of clicking the button will be like
    typing "run > nil: CommandName" from CLI. Hence the tooltype
      "USER1=sys:Clock Clock"  will cause the button for user1 to
    read "Clock". When clicked it will RUN "sys:Clock", passing nothing
    else to the program.
      If Flags=65 your Program will not be invoked for any directories,
    selected FileNames will be passed. Like
        "run >nil: Program FileName" from CLI.

    DEFAULT BUTTAON SETTINGS:
      Each of the buttons listed may be changed by a tooltypes line.
      These examples show what that line would look like to obtain
    exactly what the default setting for that button is.

    PRINT=c:Print Print 65
      "c:Print" is RUN and passed a FileName. No directories are allowed.
      Control is returned to UtiliMaster while "c:Print" runs.
    SHOW=c:Show Show 64
      "c:Show is started and passed a FileName. Directories are not
      allowed. Control IS NOT passed back to Utilimaster until "Show" is done.
      This is to prevent Show from being run simultaniously for several files.
    SEARCH=c:Search 50 all "What text?"
      A window is opened, and the equivelant of typing
        "c:Search FileName <"E" box content> All" takes place. If the "E"
        box is empty, a requester appears whith the prompt "What text?".
        The text then entered is substituted.
    ARC=c:Arc Arc 0 A
        Arc is a special case. Equivelent CLI line:
          "c:Arc A FileName [FileName] [FileName]"
    DEARC=c:Arc De-Arc 0 V
        Arc is a special case. Equivelent CLI line:
          "c:Arc X FileName"
    LISTARC=c:Arc "List Arc" 0 V
        Arc is a special case. Equivelent CLI line:
          "c:Arc V FileName"
    RUN=c:Run Run 64
        Equivelent CLI line: "c:Run FileName"
    EDIT=c:E Edit 1
        Equivelent CLI line: "c:Run c:E FileName"
    EXECUTE=c:Execute Execute 68
        Equivelent CLI line: "c:Ececute FileName"
    NEWCLI=c:NewCli "New CLI"
        Equivelent CLI line: "c:Run c:Newcli"

    Please note that if a new command directory is defined, then
    in each of the above examples, the new directory name will be
    used in place of "c:".

    Also note that any of these may be told to look for the program
    in some other directory. For example, if you keep "Newcli" in
    your "System" directory, you would then use tooltype
      "NEWCLI=System:Newcli "New CLI""
      (Note the quotes around "New CLI" for the button. Utilimaster
      understands quotes and any group of words/letters inside quotes
      is treated as one perameter regardless of spaces.

    Occasionally an error will leave you with what amounts to a
    CLI window opened. You escape this window with "Endcli"

    When run from workbench, Utilimaster opens a background window.
    You may change it's size by tooltype
      "WINDOW=CON:<Left>/<Top>/<Width>/<Height>/"
    If you use this, window MUST be "CON:" and ALL FOUR dimensions
    MUST be given! (Unless you LIKE Guru Errors!)
    There are some programs (The version of "Arc" that I have, for
    example.) which send some of their output to ERROR out instead
    of STANDARD out. This output will go to the background window
    if started from WorkBench or the CLI from which UtiliMaster was
        started. Sorry, I haven't figured out a way around this. You may
        see this output by using the "Window to Front/Back" gadgets.

        Please send comments to:
                John Scheib
                3805 FairWay Circle
                Las Vegas, Nevada 89108
                OR
                People Link: JSCHEIB

    Enjoy UtiliMaster!