home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / wxytr2 / dirttp.doc < prev    next >
Text File  |  1988-05-08  |  7KB  |  184 lines
  1. This is the documentation file to go with DSCTOOL1.ARC 1.00
  2. -----------------------------------------------------------
  3. Contents:
  4.               DIR.TTP         - directory utility
  5.               VERIFY.PRG      - check floppy disc format
  6.               TIME.PRG        - Set clock and optionally run GDOS
  7.  
  8. DIR.TTP v1.11
  9. -------------
  10.      And  now,  for  the utility for your hard disc you've  all  been 
  11. waiting  for  - a way to find out what's on it.  I got so fed  up  of 
  12. waiting for someone else to write one that I did one myself, and here 
  13. it  is.  DIR.TTP  is a simple directory utility (in case  you  hadn't 
  14. guessed  by  now) which is really useful on hard discs.  It  is  also 
  15. really  useful  on  floppy discs,  but they're  normally  less  of  a 
  16. problem.
  17.  
  18.      The  difference between 1.10 and 1.00 is that the  /h  parameter 
  19. has  been added to allow the screen to hold before returning  to  the 
  20. desktop. No bugs were reported in 1.00, so none have been fixed.
  21.  
  22.      Version 1.11 is the same as 1.10, except that it is shorter.
  23.  
  24.      It  can  be run it with or without parameters.  If  you  specify 
  25. none,  it'll  produce a directory for the current DOS  path.  If  you 
  26. specify a different path,  it'll produce a directory of that.  I told 
  27. you it was simple, didn't I? It will list the directory in the form:
  28.  
  29. ----------------------------
  30. Directory for a:\*.*
  31.  
  32. HDX.PRG          38036  00:10:28 am  20 Nov 1985
  33. HDX.RSC           4576  00:10:38 am  20 Nov 1985
  34. README            1896  00:10:42 am  20 Nov 1985
  35. SHIP.PRG          2292  00:10:46 am  20 Nov 1985
  36. WINCAP            1408  00:10:50 am  20 Nov 1985
  37.  
  38. 5 files found
  39.  
  40. Directory for a:\AUTO\*.*
  41.  
  42. AHDI.PRG          3806  00:00:50 am  20 Nov 1985
  43. TIMEDA.PRG        9472  11:48:56 pm  15 Nov 1986
  44.  
  45. 2 files found
  46.  
  47. Total folders    1
  48. Total files      7
  49.  
  50. ----------------------------
  51.  
  52.  
  53. unless you enter '/t' (after path name, if any), in which case it'll
  54. produce something like:
  55.  
  56. ----------------------------
  57. Directory for a:\*.*
  58.  
  59. HDX.PRG       HDX.RSC       README        SHIP.PRG      WINCAP        
  60. 5 files found
  61.  
  62. Directory for a:\AUTO\*.*
  63.  
  64. AHDI.PRG      TIMEDA.PRG
  65. 2 files found
  66.  
  67. Total folders    1
  68. Total files      7
  69.  
  70. ----------------------------
  71.  
  72.      It's  getting a bit less simple now isn't it?  Normally it  puts 
  73. it's  output  onto  the  VDU,   but  if  you  enter  something   like 
  74. '>dir_a.lst' after any new file name, and after any '/t' it will send 
  75. the output to a file (in this case,  one called 'dir_a.lst'). You can 
  76. also  send  it to the printer with '>PRT:' or to  the  keyboard  with 
  77. '>KBD:'   (is   this  really  useful?)  or   wherever.   Good   init? 
  78. '>>dir_a.lst' will add the directory to the end of dir_a.lst  (useful 
  79. to produce catalogue of floppy disc files, for example).
  80.  
  81.      A new feature of 1.10 is the '/h' parameter.  If this is  placed 
  82. in  the command string the program will pause until you press  RETURN 
  83. before returning to the desktop.
  84.  
  85.      One  thing I forgot to mention (saving the best bit to last)  is 
  86. that when it lists a directory, it will also list the CONTENTS of any 
  87. sub-directories in it.
  88.  
  89.      Because this is getting a bit complicated, here are some example 
  90. parameter lists:
  91.  
  92.         a:\*.*                  - everything on drive a:
  93.  
  94.         c:\*.txt >d:\dir.lst    - all .txt files on drive c:. Output
  95.                                   is placed in a file 'dir.lst' on drive
  96.                                   d:
  97.  
  98.         c:\megamax\             - all files in the folder MEGAMAX
  99.                                   and further down (ie. including
  100.                                   '\MEGAMAX\HEADERS\') on c:
  101.  
  102.         \megamax\*.rsc          - all files in the folder MEGAMAX
  103.                                   and further down (ie. including
  104.                                   '\MEGAMAX\HEADERS\') on current drive
  105.                                   ending in '.rsc'
  106.  
  107.         e: /t                   - everything from current folder on e:
  108.                                   and down, in five column mode.
  109.  
  110.         e: /h /t                - everything from current folder on e:
  111.                                   and down, in five column mode with pause
  112.                                   before returning to desktop.
  113.  
  114.         e: /t /h                - same as above
  115.  
  116.         b:\junk\p*.c /t >PRT:   - left as an exercise for the reader.
  117.  
  118.  
  119. VERIFY.PRG
  120. ----------
  121.  
  122.      This  utility  will test a floppy disc for bad  sectors.  If  no 
  123. drive is entered in the command line (ie. A: or B:) the current drive 
  124. will  be tested if it is a floppy,  otherwise drive A:  will get  the 
  125. treatment.
  126.  
  127.      Each track/side is displayed as it is being checked.  A list  of 
  128. errors  will be built up on the screen,  if any are  found.  A  total 
  129. appears at the end.
  130.  
  131.      If  a '/h' parameter appears in the command  line,  the  program 
  132. will pause until RETURN is pressed before terminating.
  133.  
  134.      Verify will automatically test all sectors which are supposed to 
  135. be on the disc (including IBM,  40 track,  10 sector, 83 track et al) 
  136. by  reading.  If a sector is bad,  TOS may still be able to read  and 
  137. write to it,  but it will probably be a bit flaky.  Verify appears to 
  138. spot bad sectors which some other verify programs pass.
  139.  
  140.  
  141. TIME.PRG
  142. --------
  143.  
  144.      Yes,  another  time/date  setter.  It has to claims  to  fame... 
  145. firstly it is a sensible sort of size, and second, it will optionally 
  146. run GDOS.  If a hard disc is connected, it will run GDOS from the top 
  147. level of drive C:,  and fix it so that ASSIGN.SYS,  is read from  C:, 
  148. together with any scratch files,  font files and device  drivers.  It 
  149. also  checks  the  time  and date  as  you  enter  it,  character  by 
  150. character. And all this in less than 1.5K!
  151.  
  152.      If you don't want to set the time or the date, just press return 
  153. to  the question and the old version will remain  intact.  Times  are 
  154. entered in 12 hour clock,  with A or P following.  You don't have  to 
  155. press RETURN to end a line.
  156.  
  157.      These are only Beta test versions of these programs and may well 
  158. contain a few bugs.  I'd like to here your comments or suggestions as 
  159. to how they may be improved.  These programs may be copied and  given 
  160. to Atari software developers,  but not to anyone else. If anyone does 
  161. allow a copy to slip out,  they may find they are visited at midnight 
  162. by a gang of 8 foot tall navvies wielding chain saws,  but this  will 
  163. probably be a coincidence.
  164.  
  165.      If you use these programs, please send 10 dollars to the address 
  166. below.  If you do this,  I'll send you any updated version (I  update 
  167. and add to the collection weekly).
  168.  
  169.      I can be reached on Prestel 01 429 3047 or the OSI Lives! BBS on 
  170. 01-429 3047 ring-back V21 (+44 1 429 3047 outside UK),  or even Telex 
  171. 295  141 quoting (yep,  you guessed it) 'MBX 014293047' somewhere  in 
  172. the first line. Snail mail address (for cheques?) is:
  173.  
  174.         Frank J Leonhardt
  175.         2 Birchmead Ave.
  176.         PINNER
  177.         Middx HA5 2BG
  178.         ENGLAND.
  179.  
  180. End of file.
  181.  
  182.  
  183.