home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 113 / EnigmaAmiga113CD.iso / software / utilities / deficons44 / deficons44.doc < prev    next >
Encoding:
Text File  |  2000-06-05  |  12.6 KB  |  283 lines
  1.                 DefIcons v44
  2.         © 1999-2000 by Stephan Rupprecht
  3.              All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  DefIcons v44 is copyrighted 1999-2000 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the 
  12.  program(s) it describes.
  13.  
  14.  Original idea and program © by Team NewIcons.
  15.  Included brainfile was created in 1997 by <R.MacLean@hw.ac.uk>
  16.  it was updated and bugfixed by Stephan Rupprecht in 1999 :)
  17.  ProcessFile.rexx was written/modified by various authors.
  18.  I hope that no one bothers that I included them into the archive
  19.  without asking for permission ;)
  20.  
  21.  
  22. REQUIREMENTS
  23.  Any Amiga® (compatible) computer with at least OS3.5,
  24.  a deficons.prefs file (included) and some def_xxxx.info files
  25.  (both can be found in the NewIcons package. There're
  26.  also some nice default icons available from other artists).
  27.  
  28.  
  29. DESCRIPTION
  30.  DefIcons turns any faked icon (displayed when you pick the menu
  31.  item Window/Show/All Files) into a more meaningful one. Depending
  32.  on its prefs file, the program can identify different filetypes
  33.  and supply an appropiate icon for each of them. For a complete
  34.  documentation, please take a look at the original DefIcons
  35.  documentation which is a part of NewIcons.
  36.  
  37.  
  38. INSTALLATION
  39.  To install the program and the preferences editor, simply start
  40.  the provided Installer script.
  41.  If you don't have any default icons installed yet, you must copy
  42.  them manually from the NewIcons package to your envarc:sys drawer.
  43.  
  44.  
  45. USAGE
  46.  The program does not take any arguments or tooltypes. It can be
  47.  started either from wb or shell. You can terminate the program
  48.  at any time by pressing/sending ctrl-c (see cli command break) to
  49.  it, or by starting it a second time.
  50.  
  51.  --- Using the preferences editor "DefIconsPrefs" ---
  52.  DefIconsPrefs allows you to change the deficons brainfile in an
  53.  easy and comfortable way. To start the program simply doubleclick
  54.  its icon (The DEFPATH=<path> option needs to be specified, if you 
  55.  don't have the default icons placed in ENVARC:Sys).
  56.  Now you can start editing the brainfile, to add a new filetype
  57.  to the "Filetypes" list, press the "Add" button and enter the name
  58.  of the filetype into the string gadget below the list. DefIcons/
  59.  icon.library will later use this name to find the icon which
  60.  belongs to the filetype. Choose "Information ..." from the "Icon"
  61.  menu or doubleclick the filetype to get information on the icon. 
  62.  To remove an entry press "Remove" (please note: removing a class
  63.  [=filetype] will also remove its children!). The arrow buttons can
  64.  be used to the change the position of the selected filetype(s)/
  65.  class(es) in the list. In order to identify a filetype, DefIcons
  66.  also needs to know how this can be done. Therefore the window
  67.  contains another list which shows all actions (they are the 
  68.  description of the filetype) that have been defined for the 
  69.  selected filetype. To add a new action to the filetype, press the
  70.  "Add" button, hold down the mouse button and select one of the 
  71.  following actions from the popup menu (then release the button:)
  72.  
  73.  MATCH: the file must contain the given string at the given offset
  74.   (relative to the current position). Hexvalues must be entered 
  75.   using the following style, eg. \x0a for 10 or \xff for 255 ...
  76.    
  77.  SEARCH: the file must contain the given string somewhere starting at
  78.   the current position. If you select 'Skip spaces:', only spaces and
  79.   tabs are allowed to precede the given string.
  80.   
  81.   "current position" means that each matching action (SEARCH/MATCH)
  82.   increases the current position within the file. When a description
  83.   doesn't match the next action will start at the beginning of the
  84.   file.
  85.  
  86.  PATTERN: the filename must match the given pattern.
  87.  
  88.  FILESIZE: the file must have the given size.
  89.  
  90.  PROTECTION: the file must have the given protection bits (un)set.
  91.  
  92.  ISASCII: check whether the file is a text file or not (only used by
  93.   'ascii' type).
  94.  
  95.  OR: alternative description follows.
  96.  
  97.  MACROCLASS: this filetype will never become valid. Only its icon
  98.   will be used, if one of the children, which does not have an 
  99.   icon, becomes valid.
  100.   
  101.  New for DefIconsPrefs 44.8: DefIconsPrefs is able to "learn" a
  102.   file format: this is done by pressing the "Learn..." button
  103.   (you need to select/create a filetype first) and selecting at
  104.   least two files of the same format in the filerequester that
  105.   comes up (the more files, the better the result). Please note,
  106.   that this function is very simply and will create only a list
  107.   of MATCHes.
  108.  
  109.  
  110. FREQUENTLY ASKED QUESTIONS (FAQ)
  111.  Q: I have some nice icons for my ram: and pc0: disks installed
  112.     but unlike the original DefIcons, I just get this ugly black
  113.     and white disk icon (or the def_disk.info one). Why ?
  114.  A: wb3.5 and DefIcons44 don't add a "disk" to the icon name. So,
  115.     for an example, your default icon for the Ram Disk should be
  116.     named def_RAM.info and not def_RAMdisk.info. BTW: Please 
  117.     don't ask me to change it, I just use the same naming convention
  118.     wb uses ;)
  119.     
  120.  Q: I made the changes, you mentioned before. But I still get this
  121.     ugly b/w icon :(
  122.  A: Make sure that your default icons for disks are really disk icons.
  123.     If not, please use IconEdit or RAWBInfo to change them.
  124.  
  125.  Q: For MSD0 (crossdos) disks I always get this ugly default icon. Is
  126.     there any way to fix this problem?
  127.  A: Load l:crossdosfilesystem into a hexeditor, look for disk.info
  128.     and replace it with dusk.info.
  129.     
  130.  Q: Made the changes, but I still get the wrong icon. I have MFS
  131.     (MultiFileSystem by N.Salmoria) installed.
  132.  A: The current workbench release (BB#1) uses an own routine to
  133.     get icons for disks. This routine isn't as clever as DefIcons :(
  134.     
  135.  Q: DefIcons doesn't load the right icons for disks. Why?
  136.  A: See previous answer.
  137.  
  138.  Q: For CDDA disks I just get this ugly default icon. Why?
  139.  A: CacheCDFS loads the default icon for CDDA disks from ENV:.
  140.     Type "makelink envarc:cdda.info envarc:sys/def_CDDA.info"
  141.     into a shell to workaround the problem.
  142.     
  143.  Q: When I double-click a "faked" icon which has as default tool
  144.     "c:version" (or any other c: command). I get an "Unexpected
  145.     dos-packet" guru (0x07000004). What's wrong?
  146.  A: The default tool is a shell command and doesn't support to be
  147.     started as a wb application. Your def_whateveritwas.info
  148.     file needs to be updated: Enter your ENVARC:Sys drawer, click
  149.     on the icon in question and select "Information ..." from the
  150.     wb menu. Now click on the "Start from:" cycle gadget 'til it
  151.     shows "Shell". Save the changes :) NOTE: This can be done via
  152.     DefIconsPrefs, too.
  153.     
  154.  Q: My def_lharc icon has "lha x" as default tool. Now when I try
  155.     to unpack a lha file, I get an error message from wb telling
  156.     me that it couldn't find the command. Again, what's wrong?
  157.  A: Workbench treats the "Default tool" field as a path, which
  158.     means that workbench adds quotation marks to it whenever it
  159.     contains spaces (which is the case for "lha x"). This makes
  160.     DOS think that "lha x" is the name of the command to start but
  161.     since this command doesn't exist, DOS will fail to find it.
  162.     That's why you get the error message:) I suggest to use the
  163.     ProcessFile.rexx script to fix this problem: Copy the script to
  164.     your REXX: drawer, make sure it has the S(cript) protection bit
  165.     set and change the "Default tool:" field of the def_lharc 
  166.     icon to "REXX:ProcessFile.rexx". Next select "Start from: Shell"
  167.     and uncheck the "Wait for input" checkbox (also see previous and
  168.     next Q&A). That's all. NOTE: This can be done via DefIconsPrefs,
  169.     too.
  170.   
  171.   Q: Is there any way to get rid-off this "Execute command" window
  172.      when starting a shell command or (arexx) script?
  173.   A: Yes, of course. Your default icon must have the NOPROMPT tool-
  174.      type set ("Wait for input" checkbox unchecked).
  175.      
  176.   Q: Any way to get rid-off the quotation marks wb adds to the 
  177.      "default tool" field?
  178.   A: No, there isn't. Which means that I don't want to write a patch
  179.      for it ;)
  180.      
  181.   Q: DefIcons seems not to work. I also have TweakWB installed.
  182.   A: Make sure you have the "DefIcons" (datatypes hook) function of 
  183.      TweakWB deactivated. The order you start the program is also 
  184.      important: Please start DefIcons AFTER TweakWB.
  185.      
  186.   Q: I copied DefIcons44 to my C: drawer and added the line C:DefIcons44
  187.      to my s:user-startup. Now when my computer boots, it suddenly stopps
  188.      booting when it reaches the mentioned line. Why?
  189.   A: Unlike the original DefIcons, this program needs to be "Run". 
  190.   
  191.   Q: I added a new filetype to my deficons.prefs file but for any
  192.      reasons DefIcons seems to ignore the change.
  193.   A: Go through the filetypes list and look for a similiar filetype. If
  194.      you find one then move the newly added filetype above it.
  195.  
  196.   Q: The "Information..." and "Edit..." items from the "Edit" menu 
  197.      (DefIconsPrefs) don't work.
  198.   A: You probably have your default icons placed in a different drawer
  199.      than ENVARC:Sys. The DEFPATH=<path> options needs to be specified
  200.      in this case.
  201.  
  202.  
  203. HISTORY
  204.  44.0    first public release
  205.  44.1    filetype recognition didn't always work because of two
  206.      minor bugs. misc internal changes. again updated 
  207.      deficons.prefs. added a slightly changed version of
  208.      ProcessFile.rexx which views html documents by using
  209.      OpenURL(.library).
  210.  44.2    added FAQ to the doc. included DefIconsPrefs. case insensitive
  211.      ACT_SEARCH and ACT_MATCH didn't work correctly because of a
  212.      buggy TOLOWER macro.
  213.  44.2a    updated DefIconsPrefs (44.1): added some missing error requesters,
  214.      no longer requires a deficons.prefs file in env: to start, new menu
  215.      item to load iconedit. 
  216.  44.2b    updated DefIconsPrefs (44.2): added a menu item to merge a deficons
  217.      prefs file to the current one. starts IconEdit from wb now. added
  218.      weightbar to the window.
  219.  44.3    in 44.2 I fixed the TOLOWER macro but the fix was somehow useless
  220.      as I forgot to store the return value;) Funny, that the compiler
  221.      didn't complain about the statement. Anyway, I received the original
  222.      DefIcons source today (thanks to Olaf Barthel and Eric Sauvageau)
  223.      and found out that my implementation of ACT_SEARCH and ACT_MATCH
  224.      was wrong: both actions work relative to the current position
  225.      within the file not from the beginning (each matching ACT_SEARCH,
  226.      ACT_MATCH increases the position). changed portname from "DefIcons"
  227.      to "deficons". 
  228.  44.3a    updated DefIconsPrefs (44.3): fixed cosmetical bug when using
  229.      background images <Nils Goers>.
  230.  44.3b    updated DefIconsPrefs (44.4): when adding a new filetype, clicking 
  231.      on a different one and then clicking on the new one changed its name
  232.      <Christopher Kossa>.
  233.  44.4    this is 3rd attempt to fix the tolower stuff and finally it works;)
  234.      updated FAQ. included an alternative prefs file which makes DefIcons
  235.      work a bit faster <Damian Stolarek>.
  236.  44.5   outputs an error message when DefIcons v37 is still installed. removed
  237.      reference to already freed memory on exit. Damian's prefs file has 
  238.      been updated by Elena.
  239.  44.5a    updated DefIconsPrefs (44.5): removing an entry from the filetypes
  240.      list could reveal a hidden previous entry <Damian Stolarek>.
  241.  44.5b    DefIconsPrefs (44.6): the string.gadget below the filetypes list
  242.      didn't work anymore due to some late changes. localized the whole
  243.      programm.
  244.  44.5c  fixed wrong translation in the german catalog.
  245.  44.5d    included spanish catalog by Oscar. updated DefIconsPrefs (44.7):
  246.      added DEFPATH/K option. starting IconEdit via "Edit / IconEdit..."
  247.      could crash the system (wb bug!), the program is started as
  248.      shell program, now. when changing an icon via "Edit / IconEdit..."
  249.      or "Edit / Information..." DefIconsPrefs will update the ENV:Sys
  250.      drawer, now (requires C:Copy).
  251.  44.5e    Elena Novaretti <aaries@libero.it>:
  252.     "once more I've updated the alternative deficons.prefs.
  253.      Now It recognizes ELF files and PATCH files.
  254.      Also I included a def_ELF.info and a def_PATCH.info for those
  255.      people who surely haven't them, as well as a handy PlacePatch.bat
  256.      script to put in S:, allowing def_PATCH to work!"
  257.     NOTE: The installer script does NOT copy the icons and the script
  258.     to your hd!
  259.  44.5f    included italian catalog by Arturo Franzin.
  260.  44.5g    once again an update of the italian files.
  261.  44.5h    included finnish catalog by Joni Halme.
  262.  44.5i    DefIconsPrefs 44.8: implemented a search function for the types list
  263.      and a simple "learn" function for the action one.
  264.  
  265.  
  266. AUTHOR
  267.  
  268.  Please send bug reports and ideas to:
  269.  
  270.     Stephan Rupprecht
  271.     Apfeldweg 1
  272.     D44359 Dortmund
  273.     Germany
  274.  
  275.  Send emails to
  276.  
  277.     stephan.rupprecht@gmx.de or
  278.     stephan.rupprecht@web.de
  279.     
  280.  WWW
  281.  
  282.      http://stephan.2xs.de
  283.