home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d535 / icon.lha / Icon / Icon.doc < prev    next >
Text File  |  1991-08-26  |  5KB  |  79 lines
  1. ============================== Icon 1.0 ==============================
  2. ======================================================================
  3. An  icon  program  designed  to  create icons, written by Olaf 'Olsen'
  4. Barthel  of  MXM.   Copyright,  ©  1990 by MXM.  Shareware, all rights
  5. reserved.   No  guarantee  of  any  kind  is  made that the program(s)
  6. described  in  this document are 100% reliable.  You use this material
  7. on your own risk.
  8.  
  9. ============================== Purpose ===============================
  10. ======================================================================
  11. The  new  Workbench  2.0  will  display  `All  Files'  contained  in a
  12. directory  if  told  to do so.  Unfortunately, only two types of icons
  13. will  be  displayed  for standard files:  a tool icon (for those files
  14. which have the `executable' protection bit set and a project icon (for
  15. those  files  which  have the `executable' bit cleared).  This doesn't
  16. make  it  too  easy  to  distinguish  between the different file types
  17. (text, archive files, iff-pictures, etc).  The Amiga isn't a MacIntosh
  18. on which each file has its icon built into the file structure.
  19.    `Icon' is  a more or less easy hack which supplies `fake' icons for
  20. each file that does not have it's own icon.
  21.  
  22. =============================== Usage ================================
  23. ======================================================================
  24. `Icon'  cannot be started from Workbench and should be called from the
  25. s:user-startup  script  (echo  >>s:user-startup  Icon).   41 different
  26. icons  (more  or  less  pretty)  are  supplied and should be copied to
  27. ENVARC:sys  (copy  icons  envarc:sys).   The s:startup-sequence script
  28. will  copy these files to ENV:sys where `Icon' expects them to reside.
  29. If  your hard disk does not have enough space left for all these icons
  30. copy  only those icons you will need, `Icon' is smart enough to notice
  31. which icons are available and which are not.
  32.    The  default  icons  may  be edited and changed in any way (you may
  33. want  to  set  the  default  tools for example) but take care that you
  34. _never_  perform a `Snapshot' on them.  Should this happen, fake icons
  35. created  by  `Icon' will appear to be `nailed' to a specific location.
  36. To  avoid  this  effect,  select the approriate icon in the ENVARC:sys
  37. drawer and `UnSnapshot' it.
  38.  
  39. ============================ How it works ============================
  40. ======================================================================
  41. `Icon' patches a couple of system functions to make Workbench believe
  42. that  there is an icon file for each file which does not have an icon.
  43. I  do not expect the way this is accomplished to work under any future
  44. Workbench  release,  but  as  far  as  I  can  see it works fine under
  45. Kickstart  37.74.  The source code of this program is included to make
  46. it easier to adapt it to future operating system releases.
  47.    `Icon'  determines the type of a file by taking a look at the first
  48. 400 bytes.  A few magic numbers are checked and, if this fails, `Icon'
  49. evaluates  how  many of these 400 bytes are actually ASCII characters.
  50. 75% are the minimum for a plain ASCII text file.  While this method is
  51. not  perfect it has scored a lot of hits.  If you come across a better
  52. method  which does not involve too much time (reading 400 bytes forces
  53. only a single data block to be read) please tell me.
  54.    Since  system  functions  once  patched cannot be safely restored I
  55. suggest  leaving  `Icon' active once it has been activated.  If you're
  56. bold and daring, try calling `Icon' a second time to remove it.
  57.  
  58. =============================== Author ===============================
  59. ======================================================================
  60. This  program was written by Olaf Barthel of MXM.  All files have been
  61. placed in the public domain.  You may freely distribute this material,
  62. even  a  small  copy  fee  is  okay  but  everything  which looks like
  63. commercial distribution is forbidden.  Still you may use this material
  64. for software development without giving credit to the original author.
  65.  
  66. Send   new   program  revisions,  comments,  bug  reports,  donations,
  67. unmarried   sisters,   non-poisoned   candy,  home-grown  palm  trees,
  68. horoscopes, promising capital investments, etc.  to:
  69.  
  70.                           Olaf Barthel, MXM
  71.                           Brabeckstrasse 35
  72.                           D-3000 Hannover 71
  73.  
  74.                      Federal Republic of Germany
  75.  
  76. ============ Revision history (most recent change first) =============
  77. ======================================================================
  78. V1.0    First public release.
  79.