home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 93 / af093sub.adf / myformat.LZX / Myformat / MyFormat.doc < prev    next >
Text File  |  1996-11-19  |  9KB  |  197 lines
  1.                                MyFormat v1.0
  2.  
  3.                        © 1995 by Daniel J. Andrea II
  4.  
  5.  
  6. NOTE:  This software is offered as GIFTWARE.  If you like it, then you can
  7. send me something in payment of your choice (other programs, disks, 
  8. computers, cars, etc.) at the address at the end of this document.  No
  9. warranty of any kind is offered with this software or implied, or for
  10. suitability of purpose.  It's use is entirely at your own risk.
  11. No fees can be charged for this software, other than the nominal fees for 
  12. the cost of magnetic media and copying of the software onto that media, 
  13. not to exceed the amount of US $5 for a disk containing this software.
  14. Copies of this software must include this documentation file for 
  15. redistribution through Fred Fish or other similar software collections.
  16.  
  17.  
  18. What is it?
  19. ===========
  20.  
  21. MyFormat is a replacement for the Format command.  I wrote this because of
  22. the original Format that came with both OS2.1 and OS3.1 was severly lacking
  23. several handy features which I found useful from Olaf Barthel & MXM's
  24. Format replacement.  I also found that their program didn't draw the
  25. gadgets properly under OS3.1, thus MyFormat was born.
  26.  
  27. MyFormat works under both OS2.x and OS3.x, allowing certain extras under 
  28. OS3.x.  When operating under OS2.x, both OFS and FFS, with or without 
  29. International mode is available.  Under OS3.x, Directory Caching is
  30. available.  MyFormat does require at least KickStart v37 to run.
  31.  
  32.  
  33. Installation
  34. ============
  35.  
  36. To install, simply copy MyFormat and it's icon to your SYS:System directory.
  37. If you want to replace the original Format command, rename MyFormat to
  38. Format.  MyFormat will work exactly as the original when called from
  39. the Workbench.
  40.  
  41.  
  42. Usage
  43. =====
  44.  
  45. Usage of MyFormat is similar to Format.  All the command line arguments
  46. from Format are supported, along with some extras for the new features.
  47. MyFormat can format disks with or without verifying, and can install a
  48. valid bootblock which will work for both OS2.x and OS3.x.
  49.  
  50. There are two new command line arguments, INSTALL and NOVERIFY.  INSTALL
  51. tells MyFormat to install a valid 2.x/3.x Bootblock to make the disk
  52. bootable.  NOVERIFY tells MyFormat to turn off verification of the tracks
  53. as they are written to the disk.  The rest of the arguments work the same
  54. as the original Format's arguments as listed in the DOS reference manual.
  55.  
  56. If MyFormat is started by double-clicking its icon or from the shell with
  57. no arguments, it will open a window on the Workbench screen with several
  58. gadgets.
  59.  
  60. The Drives gadget shows the available disk drives attached to the system.
  61. Just below it is the Size gadget, which shows the number of tracks and
  62. the size of the drive in megabytes.
  63.  
  64. At the bottom of the window under the Drives gadget is a status window
  65. which shows the current operations of MyFormat.
  66.  
  67. To the right is several checkbox gadgets, and a cycle gadget.  The cycle
  68. gadget selects the FileSystem to use for formatting.  Verify Writes turns
  69. on and off verification.  Install Disk turns on Bootblock installation.
  70. Create Icons creates the disk and Trashcan icons for the disk. 
  71.  
  72. The Auto Start function is used to set a two second delay for 
  73. auto-formatting of a disk inserted into any of the available drives.  This
  74. feature allows almost hands-free operation for multiple disk formatting.
  75. This option is not available from the command line.
  76.  
  77. The last gadgets are the Name, Start, Quick, and Stop gadgets in the bottom
  78. of the window.  The Name gadget is a text gadget into which you can
  79. enter the volume name for the disk to be formatted.  Default name is
  80. "Empty".  The Start gadget starts formatting the whole disk, and the 
  81. Quick gadget starts formatting using the quick-format option.  The format
  82. can be interrupted at any time by pressing the Stop gadget.
  83.  
  84. During formatting operations several of the gadgets are disabled which are
  85. options that cannot be changed.  Those which are not disabled may be
  86. changed at any time during format operations.
  87.  
  88. Note:  The Drive gadget does not show as disabled under OS2.x because
  89.    there is currently no way to disable that type of gadget under OS2.x.
  90.    Any activity in or on that gadget will be ignored by the program
  91.    during format operations.
  92.  
  93.  
  94. Bugs
  95. ====
  96.  
  97. There are no known bugs at this time.  If you find any, please contact me
  98. at the E-Mail address or Snail-Mail address below with bug reports.  Be
  99. sure to include information on what other software was running and what
  100. kind of system you have.  Bug fixes will be incorporated into MyFormat
  101. as soon as possible.
  102.  
  103. Note:  I have received some complaints about the size information not
  104.        being correct for some devices.  There is a program called 
  105.        ReadDevice included in this archive.  It is a Shell only program
  106.        for reading device info from the Dos.library's devicelist in
  107.        memory.  For example, to read info on DF0:, type this:
  108.           
  109.           readdevice df0
  110.           
  111.        or for redirecting the output
  112.        
  113.           readdevice >t:temp df0
  114.           
  115.        this will produce output to the standard output, in this case
  116.        the shell's console.  Redirect the output of the program using
  117.        standard file redirection and include the output of the program
  118.        in an e-mail letter to the address below.  This should help me
  119.        figure out how to correct the problem.  Also, include info about 
  120.        what software is used to run the device, i.e. CrossDOS for PC
  121.        format floppies, etc.
  122.  
  123. History
  124. =======
  125.  
  126.    v1.0  -- Initial release.
  127.    
  128.    v1.01 -- Fixed minor bug in setting of Use_Filesystem gadget during
  129.             startup and selection of drive to format.  Also recompiled 
  130.             with SAS/C v6.55
  131.    
  132.    v1.02 -- Changed operation of Use_Filesystem gadget so that it is
  133.             disabled on disks not using the standard Amiga Filesystem.
  134.             e.g.  PC formatted disks, PFS formatted disks, etc.
  135.    
  136.    v1.03 -- Changed arrangement of gadgets and how MyFormat responds to
  137.             Workbench menu originated formats.
  138.  
  139.    v1.04 -- OOPS!  Bug creeped in during rearrangement of gadgets in 1.03
  140.             regarding Auto Start.  Fixed so that Auto Start defaults to
  141.             whole disk formatting.
  142.  
  143.    v1.05 -- Altered Auto Start code to notify user at end of format
  144.             with a DisplayBeep call.
  145.  
  146.    v1.06 -- Changed disk change sensing method to recognize all diskchanges.
  147.             This change was needed because the A3000's scsi.device didn't
  148.             recognize the command I originally used for sensing disk changes.
  149.             This should now work with all removable media drives.  It works
  150.             fine with my Iomega Zip drive on the A3000 scsi.device as unit 5.
  151.             
  152.    v1.07 -- Found a bug in the disk type and size sensing code for non-Amiga
  153.             formatted disks.  This mainly affected disks greater than 50 megs
  154.             (the OFS size limit).  Now works.  Also has been recompiled with
  155.             SAS/C 6.56.  Also, this is first version to be uploaded to Aminet.
  156.    
  157.    v1.08 -- Fix minor bug in size info calulations which caused some really
  158.             weird size info to be placed in the size gadget.  Bug did not
  159.             affect formatting the disk, just the size reported in the window.
  160.             Thanks to Jon Peterson for help in tracking this down. 
  161.    
  162.          
  163. Author
  164. ======
  165.  
  166. I can be contacted through Internet E-Mail at:
  167.  
  168.       dandrea@mail.tfs.net
  169.  
  170. or through Snail-Mail at:
  171.  
  172.       Daniel J. Andrea II
  173.       1331 Metropolitan St.
  174.       Leavenworth, KS 66048
  175.       U.S.A.
  176.  
  177. MyFormat was developed on an Amiga 500 with a Microbotics VXL*30/RAM*32
  178. accelerator and on a 25 MHz A3000 using SAS/C v6.55 & v6.56.
  179.  
  180.  
  181. Future
  182. ======
  183.  
  184. I am planning to add bad sector allocation as soon as I get further 
  185. documentation on allocating sectors through the filing system.  I have
  186. used BFormat and liked the ability to use disks even if they have bad
  187. sectors.  BFormat, though, would only work on FFS/OFS disks.  Since I
  188. use the Professional Filing System on some of my disks, and BFormat doesn't
  189. work on anything but FFS/OFS, once I figure out how to tell any filing
  190. system how to allocate sectors I'll add this on.  If info on doing this
  191. with any file system cannot be obtained, then I will add this for OFS/FFS
  192. floppies as soon as possible.
  193.  
  194. Note (19-Nov-96):  I am currently working on the bad sector allocation
  195.                    routines.  Expect an archive to be uploaded to Aminet
  196.                    within the next couple of weeks (I hope).
  197.