------------------------------------------------------------------------------

                    ---++  TRULS Distribution Notes  ++---
                              ( and some hints )

------------------------------------------------------------------------------

The TRULS installation scripts is to be considered as Freeware. If the whole
package is to be distributed under the name TRULS,  then everything must be
kept together, in original unmodified form. The original version can always
be found on Aminet under:  util/wb/TRULS.lha


If you want to include the scripts in your own icon packs, you are allowed
to do this, as long as the following conditions are met:

1. The distribution and main drawer is called something other than TRULS :-)

2. The following files are included:
     Install_Files
     C/IconCopy
     C/ProcessIcon
     C/RequestChoice
     C/RequestFile
     C/KillNewIcon
     Docs/Distribution.txt
     Docs/IconCopy.readme
     Docs/ProcessIcon.readme
     Docs/Third_Party.doc
     Docs/TRULS.readme

3. If your pack is to include System Icons, the following file and drawer
   should be included (otherwise they can be ignored):
     Install_Icons
     Icons/

4. If your pack is to include DefIcons, the following files and directory
   should be included (otherwise they can be ignored):
     Install_DefIcons
     C/DefIcons
     Envarc/deficons.prefs
     Envarc/Sys/

5. Regarding point 4, you can put all def_xxx icons in this dir instead:
     Icons/Prefs/Env-Archive/Sys/


And that's it. The contents of the Extras drawer (and the drawer itself) is
optional, and you can add whatever you like to the package. Another thing is
that all icons can be replaced with the ones you prefer.


------------------------------------------------------------------------------

  Some Hints
  ----------

Below are just some hints for putting together a System icons package:

1. Both Install_Icons and Install_DefIcons will look for a IconSetName file
which can contain the name of of your icon set. The scripts will then use
this name in the requesters. Spaces are allowed, but do not use quotation
marks! The IconSetName file must be in the same dir as the scripts.

2. The drawers in Icons/Devs/ only needs to contain a single icon, and the
ones in Icons/Storage/ can just be empty.  Basically, make sure that the
following icons are present (last one is optional):
     Icons/Devs/DataTypes/DataType.info
     Icons/Devs/DOSDrivers/DOSDriver.info
     Icons/Devs/Keymaps/Keymap.info
     Icons/Devs/Monitors/Monitor.info
     Icons/Devs/Printers/Printer.info
     Icons/Devs/Kickstarts/Kickstart.info

Install_Icons script will then use these as sources for copying icon images
to the destination ones found in the sub-drawers of Devs/ and Storage/ dirs.

3. If you want to include extra alternative icons in your pack (like drawer
& disk icons), it can be a good idea to put them in a Icons/Misc/ dir. This
is especially true if they are in the NewIcons format, since they will then
be included in the process if user chooses to convert them to ColorIcons.

4. Regarding the "Convert NewIcons to ColorIcons" option offered by the two
icon installers, have in mind that a _single_ icon is checked in the Icons/
and Envarc/Sys/ dirs to see if it's a NewIcon. The checked icon is the first
one to appear when using C:List on those dirs.  So in order to preserve the
"Convert Icons" function, ALL icons in the main dirs should be of NewIcons
format (if your package includes any NewIcons that is).

5. Although it's possible to use a Icons/Prefs/Env-Archive/Sys/ dir for the
placement of all DefIcons, the best place might be a Envarc/Sys/ dir instead.
This in case someone just wants to install the main system icons only, while
still keeping all original DefIcons already installed.

6. As mentioned in TRULS.readme, there are two naming methods for disk def-
icons (based upon OS version). To avoid any conflicts, stick to ONE method
only. In other words, don't include both def_CD0.info and def_CD0disk.info

7. AmigaOS 3.9 has by default seven "def_CD?.info" and four "def_DF?.info"
deficons, but you don't have to include that many in your pack. The reason
for this, is because Install_DefIcons has a duplicator function that takes
care of those icons.  You only have to include def_CD0.info & def_DF0.info

8. Please look at the above stuff as mere suggestions only :-)