home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1359.dms / in.adf / FixIcons / FixIcons.docs < prev    next >
Encoding:
Text File  |  1990-01-31  |  5.0 KB  |  128 lines
  1.  
  2.                             FixIcons version 1.2
  3.  
  4.                   (c) 1989 by Lars R. Clausen (2:230/22.34)
  5.  
  6. What FixIcons is all about:
  7.  
  8.   FixIcons scans through a given volume or directory,  looking  for  Project
  9. icons,  gathering  defaulttools  and changing them according to instructions
  10. given in a define file, normally s:FixIcons.Define.
  11.   It was born after having been irritated too many times by WorkBench asking
  12. for some wierd file, or looking in a wrong place for a tool. With all the PD
  13. going on, I had 13 different ILBM viewers  as  default  tools,  and  a  like
  14. amount of text viewers. So I thought, why not make a program that can change
  15. the  default tools without much inconvenience for the user. After getting to
  16. know that others could use it, too, I sat down and wrote it  in  one  single
  17. day. I didn't know the Amiga's file system was SO easy to use!
  18.  
  19.  
  20. How to use FixIcons:
  21.  
  22.   FixIcons has some command line options, of course, they are as follows:
  23.  
  24.    dir causes FixIcons to use dir as rootdir for its scan, only  looking  in
  25.        directory or volume 'dir' and its subdirs. Default rootdir is dh0:.
  26.  
  27.    -s  causes FixIcons not to scan subdirectories.
  28.  
  29.    -r  means ReadOnly, so FixIcons will not try to change any default tools.
  30.        This is a safe way to get the tools.
  31.  
  32.    -w  is like ReadOnly, except that it will change default tools  according
  33.        to the definefile (syntax explained below). This is the default mode.
  34.  
  35.    -lname looks through the directories, searching for the  tool  name.   No
  36.        changes will be made, and the  tools  will  not  be  written  to  the
  37.        definefile.  Came up after I had some textfiles use  an  ILBM-viewer,
  38.        and didn't want to use workbench to find them.
  39.  
  40.    -v  Verbose mode. A lot of messages will be written, not only errors  and
  41.        tools found with -l option. This argument  should  always  be  placed
  42.        after -r, -w or -l option, if you want verbose mode to work.
  43.  
  44.    -dname  Specify   definefile   as   'name'.   Default    definefile    is
  45.        s:FixIcons.Define.  If the file doesn't exist, you'll have to use the
  46.        -n option to create a new file.
  47.  
  48.    -n  New definefile. With this option, FixIcons won't load any definefile,
  49.        but will write out a freshly updated file at the end.  Note  that  -w
  50.        option is not much use with this mode.
  51.  
  52.   As seen, just  writing  'FixIcons'  will  scan  dh0:  quietly  for  tools,
  53. changing them and writing them to S:FixIcons.define.
  54.   Please note that FixIcons ver 1.1 and upwards is no longer case sensitive.
  55.  
  56.  
  57. Syntax in definefiles:
  58.  
  59.   When FixIcons has been run once, the definefile should look something like:
  60.  
  61. C:More
  62. :less
  63. ViewILBM
  64. DeluxePaintIII:DPaint
  65. showiff
  66. df0:Bin/display
  67. :c/view
  68.  
  69. etc.
  70.  
  71.   To get FixIcons to change the tools, write after each tool a '='  and  the
  72. new  tool you want instead. Whitespaces may be put before and after the '=',
  73. but not in the end or the beginning of the line.
  74.  
  75.   The above example should, if you wanted to use C:More  and  C:Display,  be
  76. changed to:
  77.  
  78. C:More
  79. :less = C:More
  80. ViewILBM = C:Display
  81. DeluxePaintIII:DPaint = C:Display
  82. showiff = C:Display
  83. df0:Bin/display = C:Display
  84. :c/view = C:More
  85.  
  86.   When you have done this, and saved, you should  run  FixIcons  again,  but
  87. with the -w option. If you also use -v option, FixIcons will print out every
  88. dir it look in, and all tools it changes, out.
  89.  
  90. Then, you could use -r and -n to get a fresh list, that should look like
  91.  
  92. C:More
  93. C:Display
  94.  
  95.   It is a matter of taste if you want to do the  last  scan,  for  with  the
  96. whole  list  remaining,  it  should  be  more  simple  to  use the next time
  97. something new comes to you, as most conversions will be  in  the  definefile
  98. already.
  99.   As  there  is  no  way  for the loader to know whether spaces before a '='
  100. belong to the tool or just  is  whitespace,  you  should  avoid  tools  with
  101. trailing  whitespace.  A  tool that is empty may be replaced, but you cannot
  102. replace anything with an empty tool, the next tool on the list will be  used
  103. instead.
  104.   Any line may be used for a comment without any special chars, as  FixIcons
  105. will think the comment is a tool and write it again in the same place.
  106.  
  107. Copyright notice etc.:
  108.  
  109.   This program is copyright 1989 by Lars Clausen, and may be copied as  much
  110. as you like, as long as this documentation is distributed along with it, and
  111. I  get  the  credit  for  making  it. You may not take money for copying it,
  112. except for a reasonable fee for time and disks used.
  113.   You may hack up the code and use it any way you want, as  long  as  I  get
  114. credit for my code.
  115.   I will not be responsible for any damage or dataloss owing to the  use  of
  116. this program, as I have explained fairly precisely how to use it.
  117.   If you like it very much, or find interesting bugs, I'd like you  to  send
  118. bugreports,  ideas,  other  useful  programs, $$$, or whatever you feel like
  119. sending, to:
  120.  
  121.                    Lars R. CLausen
  122.                    Spobjergvej 87-10
  123.                    8220 Brabrand
  124.                    Denmark
  125.  
  126.                    Fidonet address: 2:230/22.34
  127. (Flames are sent to NIL:-)
  128.