home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 410.lha / ArchEdge / ArchEdge.doc < prev    next >
Text File  |  1990-09-08  |  11KB  |  224 lines
  1.  
  2.                                 (Note: * means an update to V1.2 !!!
  3.                                        ** means an update to V1.5 !!)
  4.  
  5. ArchEdge V1.5 - Robert Lang 10/6/90
  6. ~~~~~~~~~~~~~
  7.     "The Edge in Archiving"
  8.  
  9. Wow!  I've actually written something useful.  Many years of programming
  10. have served ME well, but this is the first time I've actually taken the
  11. plunge and let other people get the benefit from my coding.  Hope you like
  12. it !  Earlier versions are pretty popular around my area, hence the reason
  13. I made it neat and decided to release.  I'm calling my section of the PD
  14. market "Edgeware" and so anything addressed perhaps should be addressed to
  15. me because Edgeware is simply a nickname at the moment...and doesn't really
  16. exist as anything in the legal world.
  17.  
  18. Rules, Disclaimers, and Where to find me:
  19. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  20.  
  21. I'm keeping all rights to this program, but allowing anyone to share it
  22. around in the format in which it was supplied to them, meaning you can't
  23. dissassemble it and change anything, or spread the code, or add your name,
  24. or anything but use it and copy it really !  I don't take any responsibility
  25. for any damage done when using ArchEdge..its PD, and so not guaranteed to
  26. do anything really!  If you like it, then you can send $20 to me, and you'll
  27. receive the latest version and docs on a bootable disk, and be put on my
  28. soon-to-be-formed mailing list for notification of future releases.
  29. Alternatively,  if that's too much, then just send $5 and a disk, and
  30. I'll wack ArchEdge latest version on a disk with docs, and not put you on
  31. the mailing list.  (I can be bribed easily, though, so buzz me and offer
  32. anything at all that's not illegal or immoral [hahahahahaha] )
  33. Also, please feel free to send comments, large unbouncable cheques made
  34. out to me, large amounts of spendable-in-the-20th-century cash,
  35. Porsches (REAL ones...), or anything else to me:
  36.  
  37.             Robert Lang
  38.             (EDGEWARE)
  39.             P.O. Box 127
  40.             CARDIFF NSW 2285
  41.             AUSTRALIA
  42.  
  43. You can also try and ring me for a chat....049-508189....but I'm usually
  44. whizzing around from Uni to home, and so I'm hard to get hold off.  If you
  45. leave a message with my Mum, then don't be assured of getting a return call
  46. if you are long distance...sorry, I just can't afford it.  You can also
  47. netmail me via:
  48.  
  49. Cybertron BBS (Ph: 049-602383 or FidoNet: 3:711/496 or SigNet: 28:2100/104)
  50. (AUSTRALIA)
  51.  
  52. And I would expect that is about the best option.  Please send bug reports!
  53. I will be updating ArchEdge slowly, and would love to make all who use it
  54. happy, so if you find a glitch, then note it and tell me !
  55.  
  56. ABOUT ARCHEDGE and thanks:
  57. ~~~~~~~~~~~~~~~~~~~~~~~~~
  58.  
  59. ArchEdge is written in 68000 Assembly, using the DevPac II Assembler.
  60. I use an Amiga 500 (7 or 14 Mhz switchable) with twin 3.5" drives,
  61. 1 Meg of RAM, a genius mouse, a Bit Blitzer 1234E modem (with GPTERMV4.0 -
  62. another fine Aussie Product), a 1081 monitor and my Amy is pumped through
  63. a 30 watt amplifier for nice ear-bashing sound.
  64.  
  65. Thanks to the writers of the three books, all bearing the ABACUS label:
  66.  
  67.         Amiga Machine Language
  68.         Amiga System Programmers Guide
  69.     and Advanced System Programmers Guide
  70.  
  71. These books are invaluable to me, and so if you haven't got them, then
  72. there's a hint for you !
  73.  
  74. AND a special thanks to Suzanne Day, my girlfriend, who somehow puts up
  75. with me and my computer.  (Falling asleep on a date for example, because
  76. I was up the night before till 4 am programming!). ArchEdge is specifically
  77. dedicated (well, they do it with books, don't they ???) to Suzanne...
  78.  
  79. I could go on with thanks to my parents for making me, and make a real long
  80. Stevie Wonder speech....but I'll save you the hassle.....
  81.  
  82. ARCHEDGE V1.5 DOCS (wow...at last ???)
  83. ~~~~~~~~~~~~~~~~~~
  84.  
  85. Ok.  ArchEdge can be started from the CLI (by entering its name when in the
  86. relevant directory) or the Workbench (by clicking on its icon).  Either
  87. way, at this stage it opens its own CLI output windows when doing DOS
  88. stuff.  If this is a hassle for CLI users, then tell me, and I'll switch
  89. off the CON: windows for the CLI execution case.
  90.  
  91. The first thing to notice is a lot of space which makes it look strange.
  92. Hey ? Why write a program and leave so much space?  Believe me, with the
  93. options I have in mind, that space will be filled quickly, and I'll
  94. probably have to change the size of the window to fit more.....so be
  95. patient and enjoy!
  96.  
  97. ArchEdge now wants you to enter or select a path.  Entering one involves
  98. clicking on the path gadget, the box at the bottom of the file requester
  99. (where the neat title screen is), and entering the pathname you want to
  100. select.  You can select one by clicking on any of the device gadgets at
  101. the bottom right of the window.  These are not disabled if certain devices
  102. aren't available at the moment, they simply copy RAM: or DF2: etc into
  103. the pathname box.
  104.  
  105. The AUTO-DIR gadget allows entry into directories by clicking them in the
  106. file requester if it (the AUTO-DIR gadget) is on.  This is there to support
  107. a later option of archiving whole directories.  For the moment,
  108. a selected directory will produce unexpected results in an archiving
  109. operation, most likely it will not archiver the directory...at least
  110. that's what LHARC does.
  111.  
  112. Directories appear as a separate colour to the files in the file requester,
  113. The file requester doesn't sort the directory into alphabetical order yet,
  114. so what is read is what you see.  I may alphabetize later...but I don't
  115. see a hassle or need at the moment.
  116.  
  117. Archiving is done by simply clicking on the files you wish to archive, and
  118. selecting LHARC, ARC, or ZOO.  You will then be asked to enter the archive
  119. name, so click on the box and change it to the desired name or push return.
  120. Be sure to include full pathname, so ArchEdge knows where to put the
  121. archive.
  122.  
  123. And away it will go !  Creating the archive with the first file, and then
  124. adding each successive file to the archive.  Easy as that.  Very little
  125. error-handling is done at the moment, but in the event that you wish to
  126. stop archiving, click on the close gadget of the ArchEdge Requester and
  127. wait for the current command to finish and ArchEdge will return to its
  128. own window.
  129.  
  130. The procedure is the same for ZOO, ARC, and LHARC.  My suggestion is to
  131. use LHARC, as it is most effective and slowly becoming most popular.
  132.  
  133. ** ArchEdge now doesn't use the UNDO option.  I've added all my own
  134. routines, there may be bugs.  It works the same as before, you simply
  135. give it a path (remember to end with a : or a /) and away it goes.
  136. The routines I've added will allow me to let the user select the undo
  137. command, so that you can use PKAX or UNZOO or something like that, and
  138. that will be a future feature (sounds cool...future feature...)....
  139.  
  140. ArchEdge unarchives by making a directory with the archive name, and
  141. unarchiving into that directory, to ensure that files don't get mixed.
  142. For example, if you choose to unarchive two files "Robert.Arc" and
  143. "Suzanne.LZH" then two directories will be created in the destination
  144. path, Robert and Suzanne, and the relevant archive contents will be in
  145. the separate directories.  Neat, huh?
  146. ** In 1.5 I removed the need for the Makedir command, using inbuilt
  147. creatdir() function!
  148.  
  149. ** ZIP was getting no attention, except problem causing, so its not in
  150. my UNDO routines....complain if you use it and I'll add it back in!
  151.  
  152. Well, that leaves LHWARPing.  Clicking the LHWARP gadget brings up all the
  153. options, and BEGIN starts it....so be warned...have EVERYTHING ready before
  154. you click begin.  Notice that I put a
  155.                     rename FILENAME.LHW to FILENAME.LHW.BAK
  156.                                         command before the LHWARP command,
  157. this is because it locks up if it finds an existing archive of the name
  158. and path you told it to make one, so I rename your old one to protect it.
  159. * Note: In 1.2, I removed the need for the RENAME command when doing this!
  160.  
  161. The options are best explained in the documents....but they are all there.
  162. You select the drive, and the compressing options (quick is quickest, but
  163. worst, and Freeze is best) and the bitmap options (use the bitmap for
  164. most efficient), and enter the name with full path, and away it goes !
  165.  
  166. ArchEdge adds a textfile as a neat little advertisement, and note that it
  167. adds this file to the Archives created with LHARC, ARC, or ZOO as well,
  168. adding it last to work as a PAD file, which allows protection against
  169. something important getting cut off during communications via modem.
  170. * This, of course, is now selectable.  If the AUTO-PAD gadget is on, then
  171. it will add this pad to the archive, but if off it won't !  Note that it
  172. still always adds it to an LHWARP file.....at least let me have that much
  173. advertising !
  174.  
  175. ArchEdge also UNLHWarps, and does this by letting you know if you click
  176. on a file with a .LHW extension!  It is straight forward from there, just
  177. select the output drive and BEGIN, but again BE WARNED!  The process
  178. starts immediately the BEGIN is clicked...so have everything ready.
  179.  
  180. That's all I can think of.  Most things can be cancelled by clicking the
  181. requester close gadget I think, and the program itself can be exited
  182. (why would you wanna do that ?) by clicking its close gadget.
  183.  
  184. I don't know of any bugs existing, but then that's because of what is
  185. classically called "Programmer's Prejudice".  You see, because I wrote
  186. the program, I am less likely to do something "wrong" in the views of the
  187. program than someone who knows zilch about the program.
  188.  
  189. WHAT YOU NEED:
  190. ~~~~~~~~~~~~~
  191.  
  192. In the C: directory, you MUST have RUN, MAKEDIR, and RENAME.
  193. * 1.2 no longer needs RENAME!
  194. ** 1.5 no longer needs MAKEDIR!
  195.  
  196. You also need the relevant archivers you are using, which for a full set
  197. are LHARC, ARC, ZOO, UNZIP, and LHWARP.
  198. ** And of course PAK...
  199.  
  200.  
  201. ** You no longer need the UNDO command.
  202.  
  203. I do this by copying these commands and a few others to a created directory
  204. ram:c and assign c: ram:c so I can use both drives in my archiving work.
  205. If you want to know exactly how to do this, then ask me !
  206.  
  207. THE END!
  208. ~~~~~~~~
  209.  
  210. Well, there it is!  Thanks to Bruce Paine for the actual idea
  211. of ArchEdge, and I hope you like it Bruce !   My intention is for ArchEdge
  212. to become invaluable to modem users, and I know it will with my work for
  213. TOPIK PUBLIC DOMAIN, as I frequently receive piles of archived disks, and
  214. so now I can select a batch unarchive and go and do something else while
  215. the computer works for me.
  216.  
  217. Keep in touch, and have fun with Archedge !
  218.  
  219.      Robert Lang.
  220.  
  221. Programmer for hire :-> Feel free to let me know if you have a good idea
  222. for a PD program, if I like the idea, I'll probably do it !  Also let me
  223. if you would like to pay for a program to be written....I'm open to
  224. reasonable offers.