home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / utility / grpini / grped13 / grouped.doc next >
Text File  |  1995-12-09  |  6KB  |  144 lines
  1.                                 94.08.01
  2.             Group Editor 1.3
  3.             ----------------
  4.  
  5. Description
  6. -----------
  7.   Group Editor is a Windows 3.1 application to edit Program Manager
  8.   .GRP files.
  9.  
  10. Installation
  11. ------------
  12.   1. Install GROUPED.EXE in the directory of your choice.  That's all.
  13.   2. Run Group Editor directly with Program Manager's "File | Run"
  14.      command or add it to an existing program group with Program
  15.      Manager's "File | New" command and run it by double-clicking
  16.      the icon.
  17.   3. De-install GROUPED.EXE by deleting the file.
  18.  
  19. How to Use Group Editor
  20. -----------------------
  21.   The initial dialog box lists the existing program Manager .grp group 
  22.   files. Select a group to edit.  The next dialog box lists all of the 
  23.   icons in the group and beside the list, one of 4 sets of parameters.
  24.  
  25.   Select a set of parameters to edit and then select 1 or more
  26.   strings in the set to edit.  Enter the 'search string' and the
  27.   'replace string' and press 'Apply Edit'.  To replace just the
  28.   blank entries, select the 'blank' radio button.  If you don't
  29.   care what the current value is and just want to erase it and
  30.   replace it with a new value, select the 'anything' radio button.
  31.  
  32.   You may perform as many edits as you wish.  Nothing is actually
  33.   updated in the .GRP file until you press the 'Update' button.
  34.  
  35.   Note: If the application .EXE file has been moved and you are changing 
  36.     the pathname of the executable, you *MUST* also change the
  37.     pathname of the icon.  Otherwise, when you update, the
  38.     application pathname will be correct, but the icon pathname
  39.     will be incorrect.  Program Manager won't be able to find
  40.     the icon and will substitute a default (ugly) icon.
  41.  
  42.   Note: If more than one icon has the same title, Program Manager
  43.     will modify the first one it finds.  There doesn't seem to
  44.     be any way I can get around this, since the API only allows
  45.     the item to be specified by the 'title'.
  46.  
  47. Why I Wrote Group Editor
  48. ------------------------
  49.   I have a group of ~20 DOS applications that have no file selection
  50.   mechanism or options (they know which files to look for and they know 
  51.   what to do with them so there is little need for interaction).
  52.   Traditionally the user uses 'cd' to go to the appropriate 'working' 
  53.   directory and then executes the programs from the DOS prompt.
  54.   In other words, the 'current' directory is the 'working directory'.  
  55.   To work on a different set of files, just 'cd' to another directory and
  56.   and execute the program.
  57.  
  58.   Obviously, running these programs from Windows requires that the
  59.   'working directory' be changed for the whole suite of programs each
  60.   time the user wants to work on a different set of files in another
  61.   directory.  Group Editor allows the working directory of the entire 
  62.   group of programs to be changed in one single edit.  This is much easier 
  63.   & faster than using Program Manager's "File | Properties" command on 
  64.   every single icon.
  65.  
  66. How it Works
  67. ------------
  68.   Group Editor communicates via DDE with Program Manager to obtain a list
  69.   of all of the program groups.  When a group is selected, another DDE
  70.   exchange obtains information about all of the icons in the selected
  71.   group.  When all edits are complete, it updates the information in the
  72.   .GRP file by another DDE conversation with Program Manager.
  73.  
  74.   Note that Group Editor does not read or write or modify the .GRP files
  75.   directly.  It communicates with Program Manager at a higher level.
  76.   Other applications similar to Group Editor access the .GRP files
  77.   directly, performing their own checksums and relying on less than
  78.   adequate documentation of the format of the .GRP files.  It is hoped
  79.   that Group Editor is a more enduring and portable form of this type
  80.   of application.
  81.  
  82.  
  83. History
  84. -------
  85. Version Date      Comments
  86. -----------------------------------------------------------
  87. 1.0     93.10.24  initial release
  88. 1.1     93.11.18  Fixed bug in displaying groups with a large number 
  89.           of icons (> 40).
  90.           
  91.           The search/replace strings are now preserved
  92.           between group edits (but not when you exit Group
  93.           Editor).  This makes it easy to change the same
  94.           thing in several groups without re-entering the
  95.           strings.
  96.           
  97.           The 'Apply Edit' button is now enabled more readily
  98.           as you enter search/replace strings.
  99.           
  100.           When you press 'Update', each item is highlighted in
  101.           the listbox as it is updated with Program Manager.
  102.           
  103.           Accented characters were not lower-cased correctly.
  104.           I Fixed this by using AnsiLower() instead of strlwr().
  105.  
  106. 1.2     94.08.01  Several users have noted that the group is not always
  107.           updated.  Perhaps this was because I incorrectly 'showed'
  108.           the group before starting the update.  This should be
  109.           ok now.
  110.  
  111.           You can now replace a string with blank.
  112.  
  113.           Added 'Note' (above) to remind users to change both
  114.           the application AND icon pathnames if the application
  115.           .EXE has moved to another directory.  If this is not done, 
  116.           Program Manager will 'lose' the icon.
  117.  
  118.           Added warning that only the first icon 'found' will be
  119.           used if there are 2 icons with the same title.
  120.  
  121. 1.3     95.03.28  Added support for CTL3DV2.DLL to draw '3D' dialog boxes.
  122.           If it exists (in the ...\windows\system directory), it is
  123.           used, otherwise it continues without error.
  124.  
  125.           Most people already have CTL3DV2.DLL on their system so
  126.           it is not distributed with Group Editor.  If you don't
  127.           have it, you can get it from ftp.microsoft.com (file
  128.           /softlib/mslfiles/ctl3d.exe).
  129.  
  130. Cost of Group Editor
  131. --------------------
  132.   Group Editor is a FREE application.  Use and distribute as you wish,
  133.   with my compliments and with absolutely no restrictions.  If you like 
  134.   it, you can buy me a beer the next time you're in Ottawa.
  135.  
  136.                         John A. Grant
  137.                         Geological Survey of Canada
  138.                         Mineral Resources Division
  139.                         Airborne Geophysics Section
  140.                         601 Booth St., Room 591
  141.                         Ottawa, Ontario, K1A 0E8
  142.                         Internet: jagrant@gsc.emr.ca
  143.                         Voice:    (613) 992-1082
  144.