home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -readerstuff- / richard_burke / scripts / readme < prev    next >
Encoding:
Text File  |  1998-05-02  |  5.6 KB  |  116 lines
  1.                                                 14:57:16  Friday 24 Apr 1998
  2.  
  3. I wrote these AmigaDOS scripts primarily to perform repetitive functions that
  4. I was using in the Shell and then decided I might as well get them on an
  5. AFormat CD as a learning aid so others can learn how to write things in
  6. AmigaDOS. The files here aren't the best they could be - there are lots of 
  7. places I could tweak them, add extra functions and so on, but I think this has
  8. been shown to a greater extent in LhA2LZX - this started out as a way to use
  9. requesters instead of unreadable command lines in the Shell (it's easier to
  10. select files from a requester that you want to perform an action or several
  11. on, than to type in the equivalent in the Shell with all the parameters and
  12. keywords, which half the time you have to look up because they're only one
  13. letter switches).  As it progressed, it turned into something more complex -
  14. not only converting from LhA to LZX, but doing such things as checking if
  15. there was enough memory to store the intermediate files if the temporary
  16. storage drawer was in RAM:, checking which type the file was and converting to
  17. the other type, and keeping the smaller file at the end, giving the file size
  18. saving as well.  By keeping these other scripts small you can see how short
  19. and easy it is to write something like this - start off with the basics, then
  20. if you want more, write more.
  21.  
  22.  
  23.  
  24. The scripts provided here are NOT provided with the programs they were made
  25. for - if you haven't got access to the AmiNET, ask AF to try to get them on
  26. a future CD.  These scripts are given as examples of what AmigaDOS can do,
  27. and how easy it is to write them.  The first versions are usually fairly
  28. large with several bugs in, so you can see where I have improved things.  If
  29. I was writing them nowadays, they would be a *lot* shorter, with fewer
  30. places where things could go wrong - UnLZXer is a good example of this, as I
  31. re-wrote it for a friend recently, and I have commented some of the lines so
  32. you can see what's happening.  If you can follow LhA2LZX (which you should
  33. read and understand if you want to learn about AmigaDOS script usage), you
  34. will easily be able to understand these scripts.  LhA2LZX is extensively
  35. commented, and this coupled with the "Program History" page of the
  36. AmigaGuide documentation gives enough information for you to follow it
  37. fairly easily.
  38.  
  39. HappySearch is the only one you can run without using any non-Workbench-
  40. distribution programs, but you can probably run DMSMaker as most people have
  41. the DMS program.
  42.  
  43. Below is a short description of each of the scripts:
  44.  
  45.  
  46. AllowBad - This uses the AllowBad program by Mikolaj Calusinski in 1997.  This
  47.            is a small program which will format disks with hard errors on
  48.            allowing you to use them as normal.  All my script does is let you
  49.            select the bad disk via a requester and let you choose which
  50.            filesystem to format it to (INTL, DIRCACHE etc).
  51.  
  52. DMSMaker - This simply allows you to do all DMS operations via requesters - 
  53.            Crunch, Decrunch, Repack, View, Test.  A small advantage over the
  54.            other programs I have seen that do this is that because my script
  55.            allows you to choose any floppy-type device to crunch/decrunch to,
  56.            you can use virtual floppies (like FF0: or something).  This was
  57.            one of my first scripts, and so there are several improved versions
  58.            of this one.
  59.  
  60. DMSMakerENK - This is the same as DMSMaker, except it allows you to deal with
  61.               password encrypted DMS files.  See if you can spot the extra
  62.               code that deals with this!
  63.  
  64. DSQView - A nifty little script which will tell you the contents of a
  65.           DiskSqueeze archive, if there is a file list in there.
  66.  
  67. FillDisk - This uses Fill, a small program which takes a directory full of files
  68.            and fits them onto destination disks with the minimum amount of
  69.            space left over.
  70.  
  71. HappySearch - This will search selected files for the "Happy New Year 96!"
  72.               virus.
  73.  
  74. LhAMaker - This simply takes a selected drawer and will archive it as an LhA
  75.            archive.
  76.  
  77. UnLZXer - Great name, I know ;^) .  This just takes a selected LZX archive and
  78.           decompresses it to a selected destination.
  79.  
  80.  
  81.  
  82. That's it.  Read the standard disclaimer in the LhA2LZX amigaguide for all the
  83. legal stuff ("I take no responsibilty..." etc).  Bugs/points to note will be
  84. mentioned in the documentation for each script.  I wrote these a while ago (as
  85. you can see from the file dates), and I've learnt a lot since writing them, so
  86. just use them as examples of the basics of AmigaDOS scripts.  Feel free to add
  87. to them, improve them and such for your own use, but remember they are
  88. copyrighted to me, so if you want to release them onto the AmiNET or something
  89. then you need my permission first (and of course, I'd like to see how you
  90. improved my humble scripts...;^)  ).
  91.  
  92. Hope you enjoy reading them, testing them, finding in what situations they
  93. don't work properly and so on.  If you need any help with anything, my e-mail
  94. address is:
  95.  
  96. R.Burke-97@student.lboro.ac.uk
  97.  
  98.  
  99. I'll be glad to help you in any AmigaDOS/ Amiga related thing that I can - and
  100. that even includes HTML if you ask me nicely!
  101.  
  102. I suggest you use the same ideas for loading, reading, understanding (and so
  103. on) these files as documented in the LhA2LZX amigaguide documentation.
  104.  
  105. If you want to try out the files to see how they work you will need the
  106. neccesary program files:
  107. DMS (available almost anywhere)
  108. LZX (util/arc/lzx121r1.lha)
  109. LhA (util/arc/LhA_e138.run)
  110. DSQ (util/arc/DiskSqueeze.lha)
  111. Fill (disk/misc/AFill_20.lha)
  112. Allowbad (disk/misc/AllowBad.lha)
  113. RequestString (util/batch/requeststring.lha)
  114.  
  115.  
  116. Rich B