home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / b / baslib2 / !Yadfs / !Help < prev    next >
Text File  |  1993-01-16  |  4KB  |  88 lines
  1. @(#)!Yadfs    2.5
  2.  
  3. YADFS: Yet Another DFS copier
  4. =============================
  5. © Copyright 1992,1993 Chris Corbett
  6.  
  7. This application is distributed free of charge and may be used without
  8. restriction as long as the following conditions are adhered to:
  9.  
  10.  i) No charge must be made for re-distribution
  11. ii) All files must be included, especially this !Help file
  12.     with the copyright notice.
  13.  
  14. All helpful suggestions for changes, improvements, bug fixes etc.
  15. gratefully received.
  16.  
  17. ##############################################################################
  18.  
  19. Operation Summary
  20.  
  21. Operation is straightforward(!). Double click on the !Yadfs icon and the
  22. application will install itself on the icon bar. Click select on the floppy
  23. disk icon which appears on the icon bar with a DFS disk inserted in drive 0
  24. and a window will open containing the files on the disk.
  25. !Yadfs tries to automatically determine the disk size and density, the following
  26. alternatives are supported:
  27.     80 track double density
  28.     40 track double density
  29.     80 track single density
  30.     40 track single density
  31. !Yadfs does support an external drive if fitted. For the support of 40 track
  32. disks it is necessary to have an external drive with 40/80 switch. The code
  33. is contained within !Yadfs to perform software double-stepping, unfortunately
  34. the calculations to produce track/sector from disk address within FileCore makes
  35. it impossible to fool the system into believing that track 2 on an 80 track disk
  36. is track 1 on a 40 track. Any ideas anyone?
  37.  
  38. The program will read either Acorn format, 31 files per disk OR Watford DDFS
  39. format disks which can have up to 62 files per disk side.
  40. !Yadfs tries to make the best guess at the equivalent filetype on RISCOS, and
  41. the file icons are set appropriately. Files can be copied just by dragging as
  42. normal. !Yadfs uses RAM transfers to speed up copying. You can copy and
  43. delete (move) by using SHIFT when dragging.
  44.  
  45. !Yadfs will also format DFS disks, again from an option appearing in the
  46. iconbar menu. It will produce either Acorn or Watford (62 file) formats.
  47.  
  48. To change the disk parameters click menu over the DFS icon on the iconbar.
  49. On the menu that appears select follow "Parameters" to the right and a
  50. window will appear which can be used to set the disk drive, number of
  51. tracks, density and side. Set the buttons as required, the configuration is
  52. automatically updated. 
  53.  
  54. In the DFS file window the program attempts to emulate as accurately as
  55. possible all standard RISCOS2 filer functions. So if the mouse MENU button is
  56. pressed then a standard filer menu is produced to allow individual file
  57. operations (renaming, copying, deleting etc.). The following points specific
  58. to DFS should be borne in mind:
  59. 1) On the file access menu, only the locked flag can be changed;
  60. 2) The New Directory option does not create a directory, but selects only.
  61.    Remember that DFS directories have single-letter names only.
  62. 3) !Yadfs is not a filer module, therefore it does not respond to filer
  63.    SWI calls.
  64. 4) Files not in the current DFS directory (e.g.'$'), are copied to ADFS
  65.    filesystems with names of the form (D)/(Filename), where D is the single
  66.    letter representing the DFS directory.
  67. Finally, to access two DFS disks or to access both sides of one disk, run
  68. two copies of !Yadfs.
  69.  
  70.  
  71. This program makes use of a BASIC library of standard functions. This
  72. library can be seen in the directory BasLib inside the !Yadfs application
  73. directory. The !Yadfs program is entirely BASIC and illustrates use of the
  74. library functions. Some library functions are based on published magazine
  75. articles, and these are all acknowledged in general here, and in particular
  76. in the source code. 
  77.  
  78. *| KNOWN BUGS::::::
  79. *| - Many fixed from 2.0 release!
  80. *| - Software double stepping does not work.
  81.  
  82.  
  83.  
  84. (c) Copyright Chris Corbett, 5/01/93
  85. cc@siesoft.co.uk
  86. 49 Crowthorne Road
  87. Sandhurst
  88. Surrey