home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / wb / forceicon / forceicon.doc next >
Text File  |  1994-08-19  |  36KB  |  776 lines

  1.    Welcome to ForceIcon v1.6. This is a short description on how to use
  2. the program and how to configure it. ForceIcon is a utility mainly
  3. written for users of CDRom drives or networking software of any kind.
  4.  
  5.    Have you ever tried to Snapshot the disk icon (Disk.info) or tried
  6. to replace the disk icon of a CDRom? Well, if not, do not even try,
  7. CDRom drives are read only media (how come). This is where ForceIcon
  8. comes to use. You may tell ForceIcon which volumes/devices to
  9. snoop/trace for forcing absolute positions or images. Furthermore you
  10. may set the window`s size/position and flags for viewing.
  11.  
  12. ForceIcon is (C) 1993/94 Kai Iske, GiftWare
  13.  
  14.    The Prefs program uses MUI; MUI is (C) Stefan Stuntz
  15.  
  16.    MUI version 2.0 or higher (internal version 7) is required
  17.  
  18.    The drawer and document icons were taken from the MagicWB
  19. distribution.  MagicWB was created by Martin 'XEN' Huttenloher. The
  20. icons are distributed with kind permission by the author. Furthermore
  21. the main program`s and the prefs program`s icons were created by
  22. Martin. Thank`s!
  23.  
  24. Copyright
  25. *********
  26.  
  27.    You are allowed to copy and spread this program but only if you do
  28. not make any commercial profit out of the program itself and all
  29. supported files. The source of ForceIcon is considered teachware and
  30. the author claims the right to be the only one to produce and release
  31. new versions of ForceIcon. Public Domain vendors are not allowed to
  32. sell ForceIcon for more than the price of a regular disk, which should
  33. not be higher than 5 Dollars.
  34.  
  35.    ForceIcon is GiftWare, so if you like it and you you want to express
  36. your feelings, feel free to send me anything you think of being suited.
  37. Postcards, cookies, money, simply anything ;)
  38.  
  39. Guarantee
  40. *********
  41.  
  42.    The author does not give any guarantee that the program ForceIcon
  43. works perfectly.  The program was tested and it is used every day,
  44. anyway nobody is perfect and that is why I can not take the
  45. responsibilty for any damages occured during the usage of ForceIcon.
  46.  
  47. Evolution/Overview
  48. ******************
  49.  
  50.    When I bought my CDRom drive I found out that the Workbench chooses
  51. quite stupid positions for icons with no absolute position (from my
  52. point of view). Furthermore some CDRom publishers do not seem to care
  53. for good looking disk icons (again, from my point of view; if they even
  54. supply one).  Since I could not snapshot the supplied icon, nor replace
  55. it with one of my icons, I thought it would be a good idea to have an
  56. utility which does the "snapshotting" or "replacment". This was when
  57. ForceIcon came to live.
  58.  
  59.    ForceIcon allows the user to select positions for his/her Disk.info
  60. files, either device dependant or volume dependant, ie. ForceIcon will
  61. either monitor all volumes inserted into a device, or just those
  62. specified by the user. It is also possible to override the settings for
  63. a device if you specify the name of a volume, too. Volumes may
  64. 'inherit' specifc settings of the corresponding device entry (as long
  65. as you`ve defined an entry for the device). Furthermore you may set the
  66. root drawer`s window size/position and display modes/flags.
  67.  
  68. Installing ForceIcon
  69. ********************
  70.  
  71.        NOTE: ForceIcon (both programs) must have a stack of 8192
  72. bytes or more (more recommended)
  73.  
  74.    Installing ForceIcon is not that hard. Simply copy the main program
  75. (found in the WBStartUp drawer of this archive) and it`s icon to the
  76. SYS:WBStartUp drawer, or place it somewhere else and start ForceIcon
  77. from within your S:User-StartUp file. I suggest you better start
  78. ForceIcon from within S:User-StartUp, so that ForceIcon may apply all
  79. patches before Workbench is loaded. If you do start it from
  80. S:User-StartUp then you`d better not copy it to
  81. SYS:WBStartUp ;)
  82.  
  83.    When starting from within S:User-StartUp issue the following line :
  84.  
  85.                        Run <NIL: >NIL: ForceIcon
  86.  
  87.    If you want to quit the main program, simply start it again, or
  88. select 'Quit' from the Prefs program.
  89.  
  90.    Using the "SNAPNOTIFY" commandline option/ToolType you may set the
  91. way ForceIcon should notify you on a successful SnapShot. You may issue
  92. three different values for "SNAPNOTIFY", which are "0" for no
  93. notification, "1" for a DisplayBeep()-Style Beep, "2" for a requester.
  94.  
  95.    Now copy the Prefs program and it`s icon to a suitable location
  96. (like SYS:Prefs). The Prefs program may be found in the Prefs
  97. drawer of this archive.
  98.  
  99.    You may configure ForceIcon Prefs using the following
  100. ToolType/Commandline option.
  101.  
  102. FLUSHMEMORY
  103.      Due to the fact that the Prefs program uses MUI to create it`s
  104.      UserInterface, it is quite memory consuming. That`s why I added
  105.      this switch, which will cause the Prefs program to flush memory on
  106.      exit, thus removing all the libraries etc.pp not needed anymore
  107.      resulting in more free memory.
  108.  
  109.    This option may be used within the icon`s ToolType field or on the
  110. Commandline.
  111.  
  112. Using ForceIcon; Preferences program
  113. ************************************
  114.  
  115.        NOTE 1: If you have a disk without any Disk.info file on it,
  116. you have to use an alternative image for the device/volume, if you want
  117. to position the icon or change the window or anything similar. If you
  118. don`t substitute the "image" there won`t be no way for ForceIcon in
  119. doing anything.
  120.  
  121.        NOTE 2 (AmiCDROM): AmiCDROM version < 1.9 had/has severe
  122. problems regarding ACTION_INHIBIT and Assigns. Please don`t pass me a
  123. note that something weird happens when using ForceIcon in conjunction
  124. with AmiCDROM.  It`s a problem with the AmiCDROM handler. More recent
  125. versions than 1.9 of AmiCDROM should solve that problem.
  126.  
  127.    If you have installed the AmigaGuide(C) document you may retrieve
  128. online-help by pressing HELP in one of the windows. The main window is
  129. divided into three sensitive areas. The left ListView part, the right
  130. ListView part and the remaining parts of the window. Pressing help in
  131. either of them will bring up a different page of the document, ie. it`s
  132. a context sensitive HELP facility.
  133.  
  134.    From within the main window you may configure ForceIcon to suit your
  135. needs and disks. The main window is divided into two parts.
  136.  
  137.    The entries within the Listview gadgets show volumes/devices.
  138. Devices will be drawn in black, whilst Volumes will be drawn in white.
  139.  
  140.    The five gadgets at the bottom of the window are to be used as
  141. follows:
  142.  
  143. Save
  144.      Will copy the current settings to ENV:ForceIcon_prefs.iff
  145.      and to ENVARC:ForceIcon_prefs.iff, thus leading to
  146.      permanent storage of your settings. The Prefs program will quit.
  147.  
  148. Use
  149.      Will copy the current settings to ENV:ForceIcon_prefs.iff, thus
  150.      leading to temporary storage. The Prefs program will quit.
  151.  
  152. About
  153.      Displays about notices
  154.  
  155. Hide
  156.      Will close all windows and quit the Prefs program.
  157.  
  158. Quit
  159.      Will close all windows and remove ForceIcon (main program) from
  160.      memory.
  161.  
  162. Left ListView and buttons
  163. =========================
  164.  
  165.    The ListView gadget labeled 'Used volumes/devices' at the left side
  166. of the window shows all devices/volumes ForceIcon will act on. This is
  167. the list of entries you may edit. Double clicking on an entry from the
  168. list will bring up the edit window so you may edit the selected entry
  169. (see EditEntry).
  170.  
  171.    Every time an entry is added to the list, the list will be sorted,
  172. so that volumes are shown first. This is due to the fact, that volumes
  173. have a higher priority over devices, so that you may force a volume`s
  174. icon to an other position than the position specified for the device,
  175. the volume was mounted from.
  176.  
  177.    Below there are three buttons for editing, these are :
  178.  
  179. Edit entry...
  180.      Same as double clicking on an entry from the list. It will bring
  181.      up the edit window with all the data of the selected entry (see
  182.      EditEntry).
  183.  
  184. Copy entry...
  185.      This will let you copy the selected entry with all the settings
  186.      that come with it. The manual input window will pop up asking for
  187.      a new name for the copied entry, so that no doubles will be added
  188.      to the list (see ManualInput). ForceIcon will reject to accept
  189.      doubles.
  190.  
  191. Remove entry
  192.      Simple, I guess. This one will remove the selected entry from the
  193.      list of used devices/volumes. Note: There will be no warning;
  194.      just a delete.
  195.  
  196. Right ListView and buttons
  197. ==========================
  198.  
  199.    This ListView gadget labeled 'Available volumes/devices' keeps a
  200. list of all available volumes/devices currently known to the system. If
  201. a device handler wasn`t launched before the prefs program was launched,
  202. the device won`t show up in this list, ie. if you mount some devices
  203. with 'Mount=0' then the device won`t show up as long as it hasn`t been
  204. accessed. You may double click on an entry in order to copy it to the
  205. 'Used volumes/devices' ListView (see Left part). Again, there are
  206. three gadgets below that ListView, which are :
  207.  
  208. Add entry
  209.      This will act as if you have double clicked on an entry from the
  210.      list. It will copy the selected entry to the 'Used
  211.      volumes/devices' list, as long as it wasn`t added before, ie. you
  212.      may not have more than one instance of an entry in that list.
  213.  
  214. Add manually...
  215.      If a volume/device isn`t mounted yet, you may add it`s name
  216.      manually using the manual input window (see ManualInput).
  217.  
  218. Rescan list
  219.      Will cause ForceIcon to re-scan the list of available
  220.      volumes/devices in order to update the list of the ListView
  221.      gadget. This might be of use, when a volume/device gets mounted
  222.      after you`ve opened the main window.
  223.  
  224. Edit an entry
  225. -------------
  226.  
  227.    This is the window containing all the gadgets to customize an entry.
  228. There are 16 gadgets which will be explained more in detail now.
  229.  
  230.    For 'IconPos', 'Use Icon', 'Use window' and 'Use flags' there are
  231. three modes available. I will explain the meaning of these mode now, so
  232. that nobody misses anything:
  233.  
  234. Ignore
  235.      This is simple. Settings for such a group will be simply ignored.
  236.  
  237. Use
  238.      If a specific group is set to 'Use' the group`s settings will be
  239.      used for the entry.
  240.  
  241. Inherit
  242.      This is a more sophisticated mode. For volume entries it let`s you
  243.      specify that the entry should inherit the settings of the
  244.      corresponding device for that group, ie. you don`t have to
  245.      copy/reset all settings for volumes of a specific device. Simply
  246.      inherit some settings.
  247.  
  248.      Example: Assume you have an entry for the device CD0:. This entry
  249.      will use a different icon position and icon image. Now let`s
  250.      assume you have a CD-Rom you want no icon image substitution for.
  251.      So create a volume entry and set the icon image to 'Ignore' while
  252.      setting the icon position to 'Inherit'. This way the icon position
  253.      of the original Disk.info will be set to what you have specified in
  254.      the device entry, whilst the image won`t be changed; the original
  255.      image will pop up.
  256.  
  257.          NOTE 'Inherit' is only of use for volume entries. Device
  258.      entries will act as if 'Ignore' is set when you specify 'Inherit'.
  259.  
  260.    Now to the gadgets themselves
  261.  
  262. Volume
  263.      This is the String gadget containing the volume`s/device`s name.
  264.      Simply edit it, if you want to change the name of the monitored
  265.      entry. Patterns for the name may be used as well (see WildCards,
  266.      for more).
  267.  
  268. Type
  269.      Allows you to change the type of entry you are editing. You may
  270.      choose between 'Volume' and 'Device'.
  271.  
  272. IconPos
  273.      Using this gadget you may tell ForceIcon to 'patch' the position
  274.      of the entry`s Disk.info file. If selected you may use the
  275.      Position window or the Integer gadgets to determine the position
  276.      of the icon. If not selected, the position of the selected entry`s
  277.      Disk.info file will be set to NO_ICON_POSITION so that Workbench
  278.      may choose a suitable location for it.
  279.  
  280. CurrentX / CurrentY
  281.      These Integer gadgets may be used to manually set the icon`s
  282.      position. They will be updated if you move the position window.
  283.      These gadgets won`t be active as long as you don`t specifiy
  284.      'IconPos'
  285.  
  286. Position
  287.      Using this gadget you may open the position window, a small window
  288.      which may be moved around your Workbench in order to determine the
  289.      position of the icon. This gadget won`t be available as long as
  290.      you don`t specify 'IconPos'
  291.  
  292. Use Icon
  293.      If you want to substitute the Disk.info of an entry, check 'Use
  294.      Icon' and you may select an alternative Icon file.
  295.  
  296. Icon
  297.      Using this String gadget you may set the name of an alternative
  298.      icon which should be used in place of the original Disk.info file.
  299.      This one can only be used as long as 'Use Icon' is active. The
  300.      GetFile gadget at the right of the String gadget may be used to
  301.      select an icon file using a FileRequester.  Any sort of icon may
  302.      be used. You are not restricted to use DRAWER or DISK type icons.
  303.      Anything else will do it. ForceIcon will expand the loaded icon
  304.      accordingly.
  305.  
  306. Use window
  307.      If you don`t like the original position/size of the volume`s
  308.      window, you may check this gadget in order to specify a new
  309.      position and size for the window.
  310.  
  311. Left, Top, Width, Height
  312.      These Integer gadgets specify the position/size of the window to
  313.      use for the entry. The contents of the gadgets will be updated if
  314.      you move/size the 'Drawer window'
  315.  
  316. Window
  317.      Using this Cycle gadget you can open/close the (demo) Drawer
  318.      window, you may move around the screen and resize. This gadget
  319.      won`t be available as long as you don`t set 'Use window'
  320.  
  321. Use flags
  322.      You probably know the 'Show' and 'View by' menu entries from the
  323.      'Window' menu of your Workbench. These flags specify how to
  324.      display the contents of a drawer window. If you check this gadget,
  325.      you may select any possible combination from the 'Flags' gadget,
  326.      which will then be used for the window.  NOTE: This function
  327.      uses undocumented features of the OS. I can not guarantee that
  328.      this function will work with future versions of the OS.
  329.  
  330. Flags
  331.      Select any combination for the 'Show' and 'View by' flags.
  332.  
  333. Manual input
  334. ------------
  335.  
  336.    This window is used to manually add a new name to the list of used
  337. devices/volumes or if you try to copy an entry. A window will pop up
  338. containing a String gadget and a Cycle gadget.
  339.  
  340.    The String gadget may be used to enter the new device`s/volume`s
  341. name.  You may of course enter a pattern for a device`s/volume`s name
  342. here (see WildCards, for more).
  343.  
  344.    To determine the type of entry you are editing, use the Cycle gadget
  345. underneith the String gadget. You may choose between 'Device' and
  346. 'Volume'.  This step is necessary because ForceIcon has to know how to
  347. deal with the entry.
  348.  
  349. Using wildcards
  350. ---------------
  351.  
  352.    For a device`s/volume`s name you may enter a pattern for the ease of
  353. setting up definitions for several drives using a single entry. All
  354. standard AmigaDOS wildcards are supported. Please consult your user`s
  355. manual to find out which they are and how to use them.
  356.  
  357.    Here are some examples:
  358.  
  359.      For setting all volumes/devices which start with "ABC" and end up
  360.      with "XYZ" you`ll enter
  361.  
  362.                                   ABC#?XYZ
  363.  
  364.      If you want all devices/volumes but the ones which end up with XYZ
  365. you`ll enter
  366.  
  367.                                   ~(#?XYZ)
  368.  
  369.      Say you have several devices starting with FF followed by a number
  370. which indicates the unit number (like FF0: for example). You`ll enter
  371.  
  372.                                     FF?
  373.  
  374.      That`s all about it. Simple, isn`t it? This way you won`t have to
  375. add dozens of entries with all the same settings to the list, thus
  376. reducing the size of the list and the time to create it.
  377.  
  378. Using "Snapshot" on Icons
  379. *************************
  380.  
  381.    You may even use "Snapshot" from the "Icons" menu of your workbench
  382. to add entries to the list of monitored entries. Simply select an icon
  383. of the volume you would like to add to the list or the entry you want
  384. to update. Then select "Snapshot".
  385.  
  386.        NOTE 1: You have to enter the Preferences program in order to
  387. save the changes.
  388.  
  389.        NOTE 2: "Snapshot" only works for volumes which either have
  390. been added to the list of entries before, or if the volume/device in
  391. question is write-protected. Otherwise, ForceIcon would intercept all
  392. attempts to capture positions of any Disk.info file written, so you
  393. wouldn`t be able to snapshot "normal" icons anymore. For imported
  394. devices, you have to add the new entry manually.
  395.  
  396. Notes on MagicWB
  397. ****************
  398.  
  399.    As stated above some icons were taken from the MagicWB distribution,
  400. created by Martin 'XEN' Huttenloher. Most of you might already know
  401. MagicWB. If so, you may skip this part. This is only for newbies.
  402.  
  403.    MagicWB is a special set of icons, fonts and patterns for an 8 color
  404. Workbench, which will give a very impressive and professional look to
  405. your Workbench. Due to the fact that MagicWB icons rely on an 8 color
  406. Workbench and a special set of color settings you might have noticed
  407. that the icons look kind of strange on your normal setup.
  408.  
  409.    I strongly recommend that you get hold of MagicWB. It`s simply great.
  410.  
  411. Whom I must say 'thank you'
  412. ***************************
  413.  
  414.    I would like to thank the following people
  415.  
  416. Martin Taillefer
  417.      For answering several questions
  418.  
  419. Olaf 'Olsen' Barthel
  420.      For suggestions and beta-testing
  421.  
  422. Ralph Babel
  423.      For suggestions on how to implement device dependancy and for
  424.      pointing me to a "bug".
  425.  
  426. Henning Schmiedehausen
  427.      Who sent in the diffs for the changes he made on ForceIcon
  428.  
  429. Christopher A. Wichura
  430.      For plenty of suggestions
  431.  
  432. Stefan "stuntzi" Stuntz
  433.      For MUI and the nice 'Nasen' phone calls
  434.  
  435. Martin 'XEN' Huttenloher
  436.      For the special ForceIcon icons and for MagicWB. Furthermore for
  437.      the nice chats (Nase, Bauch)...
  438.  
  439. My girlfriend
  440.      Who accepts what I`m doing
  441.  
  442.      ...and all the others I forgot
  443.  
  444. How to obtain updates
  445. *********************
  446.  
  447.    ForceIcon will be available on ADS, FRAS, FTP, and Fred Fish disks
  448. (CDs) as soon as there is a new release available.
  449.  
  450. How to contact the author
  451. *************************
  452.  
  453.    If you have any questions, suggestions, bug reports or anything else
  454. you want to tell me, you may contact me under one of these addresses.
  455.  
  456.    Either use normal snail mail:
  457.  
  458.      Kai Iske
  459.      Brucknerstrasse 18
  460.      63452 Hanau
  461.      Germany
  462.      Tel.: +49-(0)6181-850181
  463.  
  464.    or reach me using electronical mail
  465.  
  466.      USENET:   kai@iske.adsp.sub.org
  467.      INTERNET: iske@informatik.uni-frankfurt.de
  468.      FIDO:     Kai Iske, 2:244/6302.11
  469.      ZNET:     KAI@SWEET.RHEIN.MAIN.DE
  470.  
  471. We got to do a commercial, now, kids. See you after these messages
  472. ******************************************************************
  473.  
  474.    Well, as you are reading this documentation, I want to point you to
  475. some other programs I wrote:
  476.  
  477. MagicCX 1.0
  478.      MagicCX is the definite commodity/system enhancer for any Amiga
  479.      running OS 2.x or better. It is a very powerful and flexible
  480.      system. It incorporates many, many features known from other
  481.      commodities, while offering new, unseen features. External
  482.      preferences program allows full control over MagicCX. It offers a
  483.      special module design, known from Workbench. You may install/use
  484.      modules/functions by simply dragging them to a Modules directory,
  485.      if not used, move them to a storage directory. Offers
  486.      ModulesManager program for Users of OS 3.x and up. Comes with
  487.      manuals in English and German. Localized under OS 2.1 and up.
  488.      English, German translations available. Utilizes Installer for
  489.      installing MagicCX to your system.  Compact system installation.
  490.      Only a few files will be spread around your system. All others are
  491.      kept in a single directory. Only basic functions (window
  492.      activation and such) are built into the main program.  The
  493.      remaining features were put into external modules.  MagicCX comes
  494.      with 18 (for now) different modules you may choose from. Flexible
  495.      blanker system with two internal blankers and 8 (for now) external
  496.      blanker modules. Utilizes powerful gadget layout library.
  497.  
  498. KCommodity 2.5a
  499.      Multifunctional commodity for OS 2.0 and up.  Includes
  500.      window-activator, time-display in several modes and formats, alarm
  501.      function, KeyStroke-Clicker, time to environment, Window/Screen
  502.      cycling, LeftyMouse, ESC-Key can close Windows, Revision Control
  503.      System, telefone bill calculator, Screen-/Mouse-Blanker, Mapping
  504.      of german "Umlauts", PopUp Shell, AppIcon support, LeftyMouse, user
  505.      definable HotKeys.  Fully controllable via ARexx-Port,Exploding
  506.      Windows, Screen Dimmer, Mouse accelerator.  It incorporates the
  507.      features of several smaller tools in one whole with a "User
  508.      Interface Style Guide" compliant GUI in order to let the user have
  509.      a simple control panel for all the functions. It comes as three
  510.      different programs in order to minimize size. These programs are:
  511.      The main program (running all the time), the Prefs program (for
  512.      setting up KCommodity; only launched on demand, thus reducing
  513.      memory usage), and a special Screen grabber type program which
  514.      will be launched as soon as you hit a specific HotKey.  Using this
  515.      grabber you may copy Screen/Winodow contents to a gfx-capable
  516.      printer or even to an IFF-ILBM file. KCommodity is completely
  517.      localized to nearly every language supported by the system and
  518.      even comes with a new language file for suomi.
  519.  
  520. MUIProCalc 1.4
  521.      MUIProCalc is a MUI-based calculator much like Jimmy Yang`s Calc
  522.      3.0. It still lacks the plotter, but it offers a quite flexible
  523.      history facility for inserting previously entered expressions.
  524.      Different output formats offered and plenty of functions the user
  525.      may choose from. Furthermore the look of the calculator may be
  526.      customized. ARexx Port for ease of calculating from within an
  527.      editor. Some functions are able to return TeX compatible output.
  528.      Results or inputs may be copied to the Clipboard.
  529.  
  530.      MUIProCalc comes with a fancy GUI you may configure to your needs.
  531.      Function gadgets may be flipped through using pages so that they
  532.      don`t eat up too much of space. MUIProCalc supports an
  533.      input/output history you may configure so that you may re-insert
  534.      previously entered expressions/results.  History entries may be
  535.      copied to a userdefiniable clipboard unit. It features various
  536.      display/output bases such as decimal, hexadecimal, octal, and
  537.      binary and of course calculation sizes ranging from 8 Bit to 32
  538.      Bit width. Angles may be displayed as radians or degrees.
  539.      MUIProCalc offers an ARexx port you may use to calc expressions
  540.      externally. These commands are able to return TeX compatible
  541.      output such as "1\\cdot 10^{-5}". It comes with two example
  542.      scripts for use with CED Pro.
  543.  
  544. Move 1.10
  545.      This is not just another Move command it features more: Recursive
  546.      directory movements (including creation of destination dir),
  547.      pattern support, and command line flags like those known from e.g.
  548.      C:Rename...and many, many more
  549.  
  550. Man 1.12
  551.      This is a simple MAN command, known from UNIX systems.  The
  552.      advantage is, that it recognizes .guide files to be AmigaGuide©
  553.      documents. MAN then uses a different viewer in order to display
  554.      the AmigaGuide© document. Furthermore MAN recognizes TeX-DVI
  555.      files as well, using a different viewer to display them. You may
  556.      configure MAN using environment variables.
  557.  
  558. Touch 1.4
  559.      Touch is another Unix style Touch command for the Amiga. For every
  560.      given file (including patterns) it will set the time and date to
  561.      the current system time and date. If a given file does not exist
  562.      it will be created then, just the way Unix Touch handles non
  563.      existent files.
  564.  
  565. BreakName 37.0
  566.      BreakName is an addition to the well known C:Break command. It may
  567.      break CLI processes by issuing either the complete path+filename,
  568.      or simply the filename of the process to break. Useful for
  569.      breaking from within scripts
  570.  
  571.    All these programs may be found on AmiNet or on Fish Disks/CDs.
  572.  
  573. Program history
  574. ***************
  575.  
  576.      Revision V1.6
  577.      --------------
  578.      created on Tuesday, 31.05.94 00:36:05  by  Kai Iske.   LogMessage :
  579.       -*-  changed on Freitag, 19.08.94 00:59:59  by  Kai Iske.   LogMessage :
  580.        - Using ForceIcon you may even "SnapShot" Disk icons now.
  581.          Use SnapShot and then select SAVE from the Prefs program
  582.       -*-  changed on Donnerstag, 18.08.94 19:31:04  by  Kai Iske.   LogMessage :
  583.        - No more quit requesters will be shown
  584.          (Requested by : Bernhard Moellemann)
  585.       -*-  changed on Donnerstag, 18.08.94 19:12:10  by  Kai Iske.   LogMessage :
  586.        - You may now even enter relative coordinates (relative to
  587.          Workbench Screen`s width/height) for the icon`s position.
  588.          This is accomplished through negative values for
  589.          IconX/IconY
  590.          (Requested by : Bernhard Moellemann)
  591.       -*-  changed on Donnerstag, 18.08.94 18:46:52  by  Kai Iske.   LogMessage :
  592.        - IconPosition window is smaller now
  593.          (Requested by : Bernhard Moellemann)
  594.       -*-  created on Tuesday, 31.05.94 00:36:05  by  Kai Iske.   LogMessage :
  595.        - Sort routine could create enforcer hits!
  596.      
  597.      Revision V1.5
  598.      --------------
  599.      created on Wednesday, 13.04.94 15:15:29  by  Kai Iske.   LogMessage :
  600.       -*-  changed on Tuesday, 24.05.94 15:02:04  by  Kai Iske.   LogMessage :
  601.        - Width/Height for Drawer window were handled the
  602.          wrong way. (Swapped)
  603.          (Reported by : Juergen Zeschky)
  604.       -*-  changed on Tuesday, 24.05.94 14:59:44  by  Kai Iske.   LogMessage :
  605.        - The Drawer window wasn`t updated, when one changed the
  606.          Integer gadgets
  607.       -*-  changed on Tuesday, 24.05.94 14:58:44  by  Kai Iske.   LogMessage :
  608.        - When opening the Position window, it`s position was always
  609.          set to the position which was specified when the EditEntry
  610.          window was opened, thus no intermediate changes were
  611.          reflected. Same applied to the Drawer window
  612.          (Reported by : Michael 'Mick' Hohmann)
  613.       -*-  changed on Wednesday, 13.04.94 15:25:11  by  Kai Iske.   LogMessage :
  614.        - Added note about AmiCDROM 1.9 to the docs
  615.          (Suggested by : Manuel Fischer)
  616.       -*-  changed on Wednesday, 13.04.94 15:21:25  by  Kai Iske.   LogMessage :
  617.        - Added note to docs about disks not containing a Disk.info
  618.          file. READ THIS!
  619.       -*-  created on Wednesday, 13.04.94 15:15:29  by  Kai Iske.   LogMessage :
  620.        - Position window wasn`t moved, when user changed the
  621.          contents of the integer gadgets (IconX/IconY)
  622.      
  623.      Revision V1.4
  624.      --------------
  625.      created on Saturday, 19.02.94 01:27:31  by  Kai Iske.   LogMessage :
  626.       -*-  changed on Thursday, 24.03.94 16:43:23  by  Kai Iske.   LogMessage :
  627.        - EditEntry window`s cycle gadgets (IconPos, UseIcon etc..)
  628.          are volume type senstive now, ie Ignore,Use,Inherit will be
  629.          available when Type is set to "Volume",  while Ignore and
  630.          Use are available when editing a device.
  631.          (Suggested by : Christopher A. Wichura)
  632.       -*-  changed on Wednesday, 23.03.94 12:49:17  by  Kai Iske.   LogMessage :
  633.        - Inheritance of device settings is individually controlled
  634.          for every entry through a cycle gadget, so that you may
  635.          tell which items to inherit and which to ignore, or use.
  636.          (Requested by : Christopher A. Wichura)
  637.       -*-  changed on Tuesday, 22.03.94 23:19:46  by  Kai Iske.   LogMessage :
  638.        - You may now force Window size/position and flags
  639.          (display flags)
  640.          (Requested by : Christopher A. Wichura)
  641.       -*-  changed on Tuesday, 22.03.94 18:32:58  by  Kai Iske.   LogMessage :
  642.        - The ListViews will show volumes in white color now, so
  643.          that you may distinguish whether an entry is a Volume or a
  644.          Device
  645.       -*-  changed on Saturday, 19.03.94 17:58:56  by  Kai Iske.   LogMessage :
  646.        - Diskobject for Iconify Gadget will obtained from the
  647.          program`s icon
  648.       -*-  changed on Saturday, 19.03.94 17:52:54  by  Kai Iske.   LogMessage :
  649.        - Added online-help support
  650.       -*-  changed on Saturday, 19.03.94 17:17:15  by  Kai Iske.   LogMessage :
  651.        - Made behaviour of obtaining settings from a device entry
  652.          for a volume entry switchable from ToolTypes/commandline
  653.          options.
  654.       -*-  changed on Saturday, 19.03.94 16:24:58  by  Kai Iske.   LogMessage :
  655.        - ForceIcon will use memory pools for allocations now.
  656.       -*-  changed on Saturday, 19.03.94 16:23:41  by  Kai Iske.   LogMessage :
  657.        - For volumes, for which some flags aren`t set (like IconPos or
  658.          UseIcon) ForceIcon will take the settings of the device
  659.          the volume resides in as long as it is a) defined and b)
  660.          the missing flag is set there.
  661.          (Suggested by : Christopher A. Wichura)
  662.       -*-  changed on Saturday, 19.03.94 15:43:18  by  Kai Iske.   LogMessage :
  663.        - DiskChanges on startup protected by Semaphore
  664.          (Suggested by: Christopher A. Wichura)
  665.       -*-  changed on Saturday, 19.03.94 15:42:06  by  Kai Iske.   LogMessage :
  666.        - LoadPrefs() protected by Semaphore
  667.          (Suggested by: Christopher A. Wichura)
  668.       -*-  changed on Thursday, 17.03.94 18:24:44  by  Kai Iske.   LogMessage :
  669.        - If you quit the EditEntry window using "OK", ForceIcon_Prefs
  670.          will send a disk change to the device in question...
  671.        - Improved semaphore locking mechanism. Chris didn`t like it,
  672.          so I changed it, even though I can`t see his point (for now)
  673.          (Requested by : Christopher A. Wichura)
  674.       -*-  changed on Wednesday, 16.03.94 22:23:30  by  Kai Iske.   LogMessage :
  675.        - Added FlushMemory switch/tooltype
  676.        - Only devices in the list (or their volumes) will get a
  677.          disk change on startup now
  678.          (Requested by : Christopher A. Wichura)
  679.       -*-  changed on Wednesday, 16.03.94 22:22:13  by  Kai Iske.   LogMessage :
  680.        - Added server prefs concept. ForceIcon is a simple program
  681.          now, w/o any GUI. A seperate Prefs Editor has been added
  682.          (using MUI) to configure ForceIcon.
  683.        - Rearrangement of List after editing an entry didn`t work
  684.       -*-  changed on Saturday, 12.03.94 19:32:33  by  Kai Iske.   LogMessage :
  685.        - Again changed the routine for getting the list of available
  686.          volumes/devices
  687.          (Suggestions by : Ralph Babel)
  688.       -*-  changed on Saturday, 12.03.94 19:31:48  by  Kai Iske.   LogMessage :
  689.        - Didn`t convert a string to upper-case before calling
  690.          ParsePatternNoCase(). This has to be done for OS 37
  691.          Systems.
  692.          (Reported by : Christopher A. Wichura)
  693.       -*-  changed on Saturday, 12.03.94 14:23:12  by  Kai Iske.   LogMessage :
  694.        - Added special code to check for block mounted devices.
  695.          (Supplied by : Christopher A. Wichura. Thanks Chris)
  696.       -*-  changed on Thursday, 10.03.94 14:23:11  by  Kai Iske.   LogMessage :
  697.        - When adding a new item to the list, another entry could
  698.          loose the settings for the IconPos gadget. This was due to a
  699.          bug in the sorting routine. Fixed
  700.          (Reported by : Mark 'TheMug' Rose)
  701.       -*-  changed on Thursday, 10.03.94 14:02:35  by  Kai Iske.   LogMessage :
  702.        - Patterns for Volumes and Devices supported now
  703.       -*-  changed on Sunday, 06.03.94 17:38:53  by  Kai Iske.   LogMessage :
  704.        - When launched ForceIcon will now make all connected disks
  705.          disk change, in order to reposition the icons. This way you
  706.          may launch ForceIcon from within your WBStartUp now
  707.          (Requested by : Henning Schmiedehausen)
  708.       -*-  changed on Sunday, 06.03.94 17:20:31  by  Kai Iske.   LogMessage :
  709.        - Enforcer Hit for illegal Locks fixed
  710.          (Changed by : Henning Schmiedehausen)
  711.        - Windows will pop up on default PubScreen now
  712.          (Changed by : Henning Schmiedehausen)
  713.       -*-  changed on Sunday, 27.02.94 17:52:56  by  Kai Iske.   LogMessage :
  714.        - More security checks when removing patches
  715.          (Requested/Changed by : Henning Schmiedehausen)
  716.       -*-  created on Saturday, 19.02.94 01:27:31  by  Kai Iske.   LogMessage :
  717.        - ForceIcon didn`t clone all of the window`s flags
  718.        - For some icon-substitutes, ForceIcon didn`t clone anything
  719.          (Reported by : Michael 'Mick' Hohmann)
  720.      
  721.      Revision V1.3
  722.      --------------
  723.      created on Sunday, 02.01.94 15:31:32  by  Kai Iske.   LogMessage :
  724.        - Code cleanup
  725.        - Partial rewrite of docs
  726.      
  727.      Revision V1.2
  728.      --------------
  729.      created on Tuesday, 07.12.93 18:10:09  by  Kai Iske.   LogMessage :
  730.        - Entries may be copied now
  731.      
  732.      Revision V1.1
  733.      --------------
  734.      created on Tuesday, 02.11.93 23:11:14  by  Kai Iske.   LogMessage :
  735.       -*-  changed on Saturday, 27.11.93 02:12:59  by  Kai Iske.   LogMessage :
  736.        - Recompiled using SAS 6.50
  737.       -*-  changed on Saturday, 20.11.93 18:14:21  by  Kai Iske.   LogMessage :
  738.        - ForceIcon will adopt the orig. window position and size now.
  739.          (Suggested by : Michael 'Mick' Hohmann and me)
  740.       -*-  changed on Saturday, 20.11.93 18:03:08  by  Kai Iske.   LogMessage :
  741.        - Icons weren`t positions as set with the Position window.
  742.          (Reported by : Michael 'Mick' Hohmann)
  743.        - Misleading explanation removed from docs
  744.          (Reported by : Michael 'Mick' Hohmann)
  745.       -*-  changed on Saturday, 20.11.93 17:33:51  by  Kai Iske.   LogMessage :
  746.        - The X/Y coordinates may be set manually, now.
  747.          (Requested by : Michael 'Mick' Hohmann)
  748.       -*-  changed on Saturday, 20.11.93 17:24:20  by  Kai Iske.   LogMessage :
  749.        - Edit Entry window`s gadget used 'I' twice
  750.          (Reported by : Michael 'Mick' Hohmann)
  751.       -*-  changed on Thursday, 11.11.93 18:43:27  by  Kai Iske.   LogMessage :
  752.        - You may now tell ForceIcon not to patch the position, but
  753.          rather let WB chose a good place. (Good when importing
  754.          volumes via network)
  755.       -*-  changed on Tuesday, 02.11.93 23:23:00  by  Kai Iske.   LogMessage :
  756.        - ListView gadgets weren`t adjusted for OS 2.x. - Should check
  757.          for OS 2.x sometime ;)
  758.          (Reported by : Bernhard Moellemann)
  759.        - Changed needed Versions of some libraries from 37 to 36
  760.       -*-  created on Tuesday, 02.11.93 23:11:14  by  Kai Iske.   LogMessage :
  761.        - If there wasn`t a filename for the Icon-File the
  762.          FileRequester sometimes showed a weird Drawer-Name
  763.          (Reported by : Dirk Federlein)
  764.      
  765.      Revision V1.0
  766.      --------------
  767.      created on Wednesday, 20.10.93 17:19:27  by  Kai Iske.   LogMessage :
  768.       -*-  changed on Thursday, 28.10.93 17:35:28  by  Kai Iske.   LogMessage :
  769.        - Suggestions for device dependancy by Ralph Babel
  770.        - Bug "found" by Ralph Babel
  771.        - Pos window used to open on default pubscreen, not on WB.
  772.          (Reported by : Bernhard Moellemann)
  773.       -*-  created on Wednesday, 20.10.93 17:19:27  by  Kai Iske.   LogMessage :
  774.          --- Initial release ---
  775.  
  776.