home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff277.lzh / WBAssign / WBAssign.doc < prev    next >
Text File  |  1989-11-16  |  5KB  |  121 lines
  1.  
  2.             WBAssign           V1.20           11/01/89
  3.  
  4.              by JDGJr        (aka) John D. Gerlach, Jr
  5.           bix: jgerlachjr          3615 Barcroft View Terr. #104
  6.                                    Falls Church, VA 22041
  7.  
  8.  
  9.     WBAssign is a small WorkBench program that creates AmigaDos assignments
  10.     without having to open a CLI. The assignments are made from entries in
  11.     the program-Icon's ToolType list.
  12.  
  13.     This program is envisioned to have two main purposes:
  14.     1) The WBAssign icon may be placed in any directory, with assignments
  15.         being created when double clicked, and
  16.     2) In WorkBench 1.4, and above, the icon may be dropped into WorkBench's
  17.         'Startup' directory and the assignments will be made automatically.
  18.  
  19.     Assignments may be made by specifying a complete path (as supported by
  20.     the CLI command), or by specifying a path relative to the current
  21.     directory. This allows a program and its assigns to be moved easily. In
  22.     addition, WBAssign can create assigns specified in the .Info files of
  23.     other programs located anywhere in the system.
  24.  
  25.  
  26.     ==================
  27.     ToolType Specification:
  28.  
  29.     syntax:        Operation= String1 [String2]
  30.  
  31.         Operation    : [ WBAABS | WBAREL | WBANXT | WBADOS ]
  32.         =            : required delimiter
  33.         String1      : assign value for WBAABS, WBAREL
  34.                        filename for WBANXT [not including '.Info']
  35.                        Dos command string for WBADOS
  36.         String2      : path for WBAABS, WBAREL
  37.  
  38.     The first three operations are specific to WBAssign, and the last allows
  39.     any AmigaDos command to be executed from the icon. Only ToolType entries
  40.     starting with one of these four strings will be interpreted by WBAssign,
  41.     allowing WBAssign to inspect .info files of other programs (see
  42.     description of WBANXT below).
  43.  
  44.     WBAABS and WBAREL create assigns and need two parameters; the assign, and
  45.     its path. WBAABS assumes that the path given is absolute, and is used as
  46.     specified. WBAREL prepends the current directory onto the specified
  47.     string to create an assign relative to the current location. Note that if
  48.     no path is specified for WBAREL an assign is created to the current
  49.     directory. If no path is specified for WBAABS, the line is ignored.
  50.  
  51.     WBANXT is a safe means of chaining multiple WBAssigns. At any point in
  52.     the ToolType list, a WBANXT may be inserted and the specified file's
  53.     .Info file will be traversed.
  54.             SPECIFY THE PROGRAM NAME WITHOUT THE '.Info'.
  55.     In actuality, the .info file need not be attached to a copy of WBAssign:
  56.     It may be associated with any program. This allows one copy of
  57.     WBAssign to create assigns for any number of applications, AND the
  58.     specific assignments to be kept with their respective programs.
  59.  
  60.  
  61.     ==================
  62.     Example:
  63.  
  64.     Assume the following directory structure:
  65.  
  66.     DH0:
  67.     DH0:test            (contains WBAssign, WBAssign.Info)
  68.     DH0:test/sd1
  69.     DH0:test/sd2/ssd
  70.     DH0:test/sd3
  71.  
  72.     DH1:
  73.     DH1:last            (contains WBAssign.Info)
  74.     DH1:last/sd1
  75.  
  76.     Assume to following ToolTypes:
  77.  
  78.         DH0:test/WBAssign.Info
  79.  
  80.         ToolType:                  Assignment:
  81.     WBAABS=ENV s:env            ENV     DH0:s/env
  82.     WBAREL=Test                 Test    DH0:test
  83.     WBAREL=Tsd1    sd1          Tsd1    DH0:test/sd1
  84.     WBAREL=Tssd    sd2/ssd      Tssd    DH0:test/sd2/ssd
  85.     WBANXT=DH1:last/WBAssign    (checks ToolTypes in this .Info file)
  86.  
  87.         DH1:last/WBAssign.Info
  88.  
  89.     WBAREL=LAST                 LAST    DH1:last
  90.     WBAREL=lsd1    sd1          lsd1    DH1:last/sd1
  91.  
  92.     ==================
  93.     Other stuff
  94.  
  95.     Thanks to Dave Milligan for the icon: it surpasses the original by far.
  96.  
  97.     ==================
  98.     The rest of it ...
  99.  
  100.     WBAssign may be distributed [for non-comercial purposes only] by
  101.     anyone and everyone AS LONG AS the following conditions are met:
  102.  
  103.         1. The executable and documentation remain together and unchanged;
  104.  
  105.         2. The program, and any use thereof, be proclaimed to be independent
  106.         and un-associated with any political, religious, or social assoc-
  107.         iation or organization unless its use is detrimental to the goals
  108.         and intent of that body in general. In clarification, this may be
  109.         used by any computer user for any purpose (the restriction will
  110.         probably be met anyway).
  111.  
  112.  
  113.     I have noticed that writing programs for programmers does not garner
  114.     many rewards: little recognition, and no money. Thus, this one is
  115.     primarily intended for users (close to all of us). WBAssign is not
  116.     a large program, but hopefully quite useful. If you find it so, please
  117.     read the following sentence:
  118.  
  119.     Any Salutations, Congradulations and/or Contributions may be forwarded
  120.     to me at the above address.
  121.