home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / disk / volutil2 / vol_util.doc next >
Text File  |  1993-12-05  |  13KB  |  241 lines
  1. manual:               Volume Label Utility                       10.22.93
  2.                       ====================
  3.                        © 1993 Erin Monaco
  4.  
  5. (Verbose narrative version)
  6.  
  7.      Volume Label Utility is ShareWare. Try it for 30 days, if you find
  8. it useful please register. Regardless please feel free to give copies
  9. to friends, relatives, household pets and optionally your dentist or
  10. favorite police officer. To register please send a check or money order
  11. for $5 (US funds) to:
  12.  
  13.      Erin M. Monaco
  14.      35244 Chestnut
  15.      Wayne, MI 48184
  16.  
  17. You may direct comments or suggestions to the above address. I can also
  18. be reached via GEnie @ E.MONACO
  19.  
  20. ****************************
  21. Update: 12.06.93
  22.  
  23. - VOL_UTIL.RSC no longer neccessary as its been embedded in the program.
  24. - Added sequential extension support.
  25.  
  26. New sequential extension support notes:
  27. =======================================
  28.  
  29.   Looking at the main dialog you will notice a few changes; 1) above
  30. your six standard sequence buttons (1E?) you'll find text which shows
  31. this row of buttons belongs to the filename sequence field. 2) you will
  32. see text below that which points to another set of radio buttons... as
  33. the text indicates these buttons are for using a sequence field in the
  34. extension of the volume label. Since there are only three characters
  35. in an extension you are limited to three buttons 1E1, 1E2, 1E3. These
  36. buttons operate exactly like the original sequence buttons, the only
  37. difference being that they affect and use the extension for the sequence
  38. # field. As before blanks and nulls will be changed to '_' (underscores)
  39. so VLU is able to correctly make the label. When setting a Sequence
  40. button for the extension the # Sig display "(? Sig) is updated to reflect
  41. the number of significant chars before the # field for... the extension
  42. only! Selecting "1E1" (under extension) changes ? Sig to 2 Sig which means
  43. you can use the first two characters in the extension for your own
  44. purpose. As you probably guessed the extensions # field is also right
  45. justified. 
  46.  
  47.  
  48. Note:
  49. =====
  50.  
  51.   If you have installed MultiDialog by Helmut Neukirchen you must turn
  52. it off via the accessory. The Volume Label Utility already displays all
  53. dialogs in a window, using MultiDialog causes two windows to be opened,
  54. which also messes up my work around of the AES's inability to do anything
  55. while using the Form_Do() call. That would be the exiting of a form_do
  56. via the GEM icon.
  57.  
  58. ****************************
  59.  
  60.      Volume Label Utility was written in Lattice C version 5.52. It takes
  61. advantage of GEM and as such will not run from the auto folder or with an
  62. extension of .TOS. Volume Label Utility will however, run as an .APP, .PRG
  63. or Desk Accessory. Regardless of your choice of the above methods the user
  64. interface remains consistant. Please ensure that the resource file is in
  65. the same directory as the program file.
  66.  
  67.      Interaction with Volume Label Utility takes place through a series
  68. of dialog boxes. All dialogs are confined to a single window which the
  69. program opens. As such it should be a little more MultiTos friendly. It
  70. is not known at this time whether the program works on any particular
  71. machine, however having used only standard OS calls chances are good
  72. that it will work on all machines. The code however was compiled for
  73. a stock 68000 processor.
  74.  
  75.      Upon running the program or selecting it via a DA slot you are
  76. presented with the credits dialog. Clicking done brings you to the
  77. main dialog. Immediately you'll say to yourself... "what the hey...?"
  78. as well you should, for this is no ORDINARY volume labeler!!!
  79.  
  80.      Thats right folks, it slices, it dices, it chops, grates and... er
  81. ok... so it actually doesn't do all that, in fact it doesn't do any of
  82. that. (To many 30 min. infomercials I suspect). Truth be told it only
  83. does ONE thing... (right) lets you create volume labels.
  84.  
  85.      Being the disk librarian of an Atari users group, and being a
  86. bugger on small details I was a little upset over not having a nice
  87. simple volume labeler. So being the macho-sist that I am I decided
  88. "what the heck, I'll write one myself!" Somehow I suspect that great
  89. nations have fallen due to similar decisions.
  90.  
  91.      So finally, after many years of toil (ok, it was only a month)
  92. the Volume Label Utility was hatched from the abyss of my mind. Like
  93. any true bureaucracy, we software engineers (read programmers) in
  94. addition to having our own little sub-culture (we're weird ok?) are
  95. tasked to no end (and yes I do like Star Trek!) by the mere idea that
  96. a software engineering project ("program") could be simple. WELL! We
  97. software engineers not wanting to have anything what so ever to do
  98. with that, are compelled to take a simple project and transform it.
  99.  
  100. With this in mind your average engineer will sit down with his/her
  101. Coke classic, favorite CD, programming calculator, the equivalent
  102. of the library of congress worth of programming manuals, peril
  103. sensitive sunglasses with UV coating and his/her drug of choice...
  104. my drug of choice being King Dons fed intravenously throughout the
  105. entire project. Ah and last but not least our magic wands of Bill
  106. Gates... with which all real work is accomplished. Yes in short
  107. order your resourceful software engineer will take an otherwise
  108. simple project and transform it into an utterly obese, never
  109. previously encountered intelligent glob of spaghetti code. Code
  110. with an insatiable appetite for RAM. Code making itself right at
  111. home on your hard drive, a happy slob who delights in corrupting
  112. the morals of your favorite word processor. Now where was I...
  113. ah yes... the documentation!
  114.  
  115.      Lets try to forget all those sophisticated and arcane buttons
  116. on our main dialog for just one moment. In essence VLU reads and
  117. writes volume labels. (well thats pretty simple) If your like me
  118. reading them isn't nearly as fun as writing them so this is where
  119. VLU takes a detour from your average labeler. Lets for a second
  120. assume you have two hundred disks all of which perhaps belong to
  121. a single category or library. Now it makes sense to catalog the
  122. disks and their contents for later reference etc. It would then
  123. also make sense to label these disks according to their library
  124. or category. Say we have a software library with 200 utility disks
  125. all of which we wish to label to improve cataloging. We might
  126. choose a lable such as UTILnnnn.DSK with the nnnn being a number
  127. starting at 0000 and incrementing by one for each successive
  128. disk. (Ugh, thats a lot of typing!) Now you have three choices,
  129. 1) start typing. 2) write a program to automate this task which
  130. merely asks you to insert the next disk. (Do you have your wand
  131. of Bill Gates?) or 3) You can use Volume Label Utility! (or as
  132. a last resort you can explain to your kid that its the latest
  133. in interactive computer game technology and dump it on him/her, 
  134. however due to the severity of child labor laws I do not
  135. recommend this.)
  136.  
  137.      WHAT!? still with me? Ok, given the above example all you'd
  138. have to do is edit the current filename field with your initial
  139. label as UTIL0000.DSK, then select the 1E4 button (because you'd
  140. like a number sequence in the range of 0 - 9999. Insert your
  141. first disk and click the SEQ button (stands for sequence) and
  142. viola your label is written to the disk! But thats not all...
  143. now you'll notice the current label has been modified and it now
  144. reads UTIL0001.DSK!!! Hey, your catchin on, thats right, now all
  145. you have to do is insert the next disk and click on SEQ again!
  146. If you reach 9999 you'll flip back to 0000. Pretty nifty huh?
  147.  
  148.      "Okay" you say, "but what if I only have 50 disks, or maybe I
  149. have half a million!" No problem, by selecting one of the 1E? buttons
  150. you can choose a range from 0-99 (1E2) to 0-999999 (1E6). The numbers
  151. will be right justified within the filename portion of the label,
  152. this is the portion to the left of the "." with the portion to the
  153. right of the period being of course the extension. Above the current
  154. label is another editable field in which you can change the current
  155. drive. To the right of the current drive you see something like (5 Sig)
  156. this text tells you how many characters starting from the left of
  157. the filename that you may use (characters that won't be overwritten
  158. by the sequence number). With 1E3 selected you'll have 5 chars before
  159. the number to do with as you please. Something like UTILS will work
  160. fine. If you happen to just type UT and click SEQ, UT will be written
  161. as the volume label to the current drive then the label will be
  162. updated to UT___001. You don't have to start at zero you may start
  163. at any number you like (not negative however). The number will be
  164. incremented by 1 each time you select SEQ, it will roll over to zero
  165. when the maximum number is reached... in the case of 1E3 it would be
  166. 999. And that my friend is about all there is to it.
  167.  
  168.      One other important item to note is the GEM icon. Clicking this
  169. Icon will exit the form handler so you may use the AES. When run as
  170. a .PRG or .APP you don't have access to the menu so this isn't very
  171. useful, however you can still click it then move the window as the
  172. window is centered at the mouse when the program is first run. If
  173. you use it as an Accessory, (by using the extension .ACC) this will
  174. enable you to top other windows or access the menu. If you wish to
  175. access the menu you should top another window if possible... because
  176. if VLU's window is not topped it won't re-enter the form do handler
  177. (this would effectively lock out access to the AES) As you might
  178. now realize if you follow the above suggestion VLU will still be
  179. running. (taking up processor time) its more pratical just to close
  180. the acc by clicking QUIT. Then selecting it again when you need it.
  181. If VLU's window gets buried under another and you can't get to it,
  182. just select Volume Labeler from the menu, this will bring VLU's
  183. window to the top. VLU does have a help button which covers the
  184. options briefly. Oh, VLU should work in any resolution... I prefer
  185. HiRes the low res dialogs look a little obese!
  186.  
  187. Warning! What follows is the required engineers warning message!
  188.  
  189. Warnings and other horrors: (sigh)
  190. ===========================
  191.  
  192.      The Volume Label Utility is provided "As Is". By using this product
  193. whether it has been registered or not, you expressly waive any right to
  194. INCIDENTAL or CONSEQUENTIAL damages caused by the use of The Volume Label
  195. Utility. In no event shall the author (Erin M. Monaco) or DataBasement
  196. Software be liable for any damages whatsoever arising from the use or
  197. misuse of this program.  (blah, blah blah blah, blah)
  198.  
  199.      (Just checking to see if you were still awake!)
  200.  
  201.      In their infinite wisdom, the software techies and miscellaneous
  202. other gurus thought it'd be amusing (read: major pain in the rear for
  203. us software engineers) if they endowed their machines with a fine
  204. Disk and file system! One that CLOSELY resembles a Dinosaur we all
  205. know and love (love to hate that is!) And to further their joy they
  206. developed the concept of disk labels (good idea)... and Guru said
  207. "Let there be L.A.B.E.L.S!!!" (thunder and lightning) So they
  208. developed an easy way to implement this creature called the LABEL.
  209. and they then so named this process "Fcreate" (many ooohhs and aaahhs)
  210. Yes now the common man may create a label!!! But it was no blessing
  211. for as man found out he could create MULTIPLE labels! And in their
  212. infinite wisdom GURU said "Let errors spring forth for any mortal
  213. whose wish would be to "Fdelete" a LABEL!!!" and it was so. Many TOS
  214. later GURU realized this flaw and said "Yea shall Fcreate but ONE
  215. LABEL" But those unfortunate worshippers of yea old TOS were out of
  216. luck! This engineer tried... he cast many a magik such as Frename
  217. and even Fattrib to no avail for cursed LABEL remained unblemished.
  218.  
  219. The moral: Users of older TOS versions may end up with more then
  220. one Volume label, the first found is the one that is displayed. There
  221. is no way to delete a volume label through the OS, it can be done
  222. with a disk editor but shouldn't be attempted by anyone who doesn't
  223. know exactly what they are doing. This shouldn't be a major problem
  224. as most labeling will be on floppies but it could happen. I decided
  225. not to program a routine that would delete extra labels as I'd have
  226. to do it at the sector level... perhaps in the future. In any event
  227. VLU will notify you if it finds more then one label on a disk.
  228.  
  229.      Since VLU uses the AES timer facility, users of old versions
  230. of TOS may experience unexpected lockups when using it as a DA.
  231.  
  232.      And last but not least when using the form_do call as VLU does
  233. keystrokes may "fall through" (be sent to) the current application
  234. when used as an accessory under older versions of Tos. (All this
  235. kinda makes you want a new TOS huh?)
  236.  
  237. I hope you've found this manual to be informative as well as slightly
  238. amusing.  Most fun I've had WRITING a manual! :)
  239.  
  240.                Erin Monaco @DataBasement Software.
  241.