home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / sbasics.lbr / DRIVER.DZC / DRIVER.DOC
Encoding:
Text File  |  1993-10-25  |  2.9 KB  |  54 lines
  1. File:        DRIVER.DOC
  2. Contents:    Documentation on the DRIVER program.
  3. Author:        Bryan Ashby, 850 Pine Avenue, Pacific Grove, CA 93950
  4. Date:        18-Feb-84
  5.  
  6.                             D R I V E R
  7.                             ~~~~~~~~~~~
  8.  
  9. The DRIVER program creates a menu of the COM files on Drives A & B, 
  10. and executes the selected program.  It was intended to be the main 
  11. program in a menu-driven user interface to CP/M, for people like me 
  12. who are depressed by command-driven systems.  CP/M allows you to do 
  13. only two things from the command line:  execute a COM file or execute 
  14. a built-in command.  This program handles the first, and a second 
  15. program (itself a COM file, so displayed in the DRIVER menu like any 
  16. other program) would handle the built-in commands.
  17.  
  18. The program reads the directory of disk A and lists in one column all 
  19. the COM files that it finds.  (NOTE: If there more COM files than 
  20. will fit in one column, you're out of luck.)  Also, any file starting 
  21. with a hyphen is considered to be the disk "label", so that file name 
  22. is displayed at the top of the column.  A prompt then asks if you 
  23. also want a list of the COM files on Disk B;  if so, those files are 
  24. listed in a second column.  A pointer is placed against the first 
  25. file name;  pressing X will cause that program to be executed; any 
  26. other key will move the pointer to another name.  Most keys move the 
  27. pointer down the list, but an Up Cursor, Left Cursor, Backspace, '<' 
  28. or ',' will move the pointer up the list.  When the cursor is moved 
  29. beyond the bottom of one column, it jumps to the top of the other (or 
  30. to the top of the same column if there is only one).
  31.  
  32. The statement which causes the selected program to be executed does 
  33. not set up an automatic return to DRIVER because it is assumed that 
  34. DRIVER is the name in the CP/M auto-load field.  If that is so, then 
  35. CP/M causes DRIVER to be reinvoked, and you will never see the 
  36. standard CP/M prompt line.
  37.  
  38. DRIVER IS INCOMPLETE: it will execute any COM file you select, but 
  39. will not accept command-line parameters, which many programs (the 
  40. unfriendly ones) require.  I spent a long time trying to do this, 
  41. using the information in the CP/M Interface Guide and the SBasic 
  42. Ap-Note #1, but in vain.  DRIVER cannot fill its intended role until 
  43. this facility is added.  I invite you to add the required code.  I 
  44. have removed my own unsuccessful code so you will not be misled by my 
  45. errors.  (I suggest that when you add code to the program you follow 
  46. my style of capitalization, indenting and commenting because a 
  47. consistent style greatly improves readability.)  I would be very 
  48. interested in seeing your successful code, and any other changes you 
  49. make to the program.
  50.  
  51. ACKNOWLEDGEMENT:  Much of the clever stuff in the code is derived 
  52. from the XAMN program, which is anonymous but was probably written by 
  53. Gilbert Ohnysty.
  54.