home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / QBAS / QBLIST.ZIP / QBLIST.DOC < prev    next >
Text File  |  1992-01-20  |  7KB  |  124 lines
  1.  
  2.  
  3.             Hello Qbasic or QuickBasic programmer
  4.  
  5.                             First the legal stuff.
  6.                             ----------------------
  7.        The listings and/or programs included in this Zip file are given into
  8. the public domain to be used by anyone as they wish. No Warranty or Guarantee
  9. implied or explicit is given. You are at you own risk. I do not want, nor do
  10. I ask for any money to be sent to me.
  11.  
  12.        NOTE: I do not touch the original files other then to read it. No
  13. fancy screen writes or unusual programming is done so it should work on any
  14. system or monitor. I do use the basic command  COLOR 15,1 in the subroutine
  15. SCREENTITLE as I have a color monitor. I tried this program on a cga yellow
  16. monitor and it didn't seem to affect it in any way.
  17.        NOTE: Set you printer to 12 characters per inch, and 8 lines per inch.
  18. See Special Notes at the end for details on changing the program.
  19.  
  20.                           Contents Of This Zip File
  21.                           -------------------------
  22. QBLIST.EXE -- The exe version of this program
  23. QBLIST.BAS -- The Basic source code listing of this program
  24. QBLIST.LST -- Sample output
  25. QBLIST.DOC -- This Doc file
  26. README.DOC -- For anyone who doesn't want to read this doc file
  27.  
  28.                             What This Program Does
  29.                             ----------------------
  30.        This program will give you a formatted listing of your complete basic
  31. program with headings, or will print individual sections of your program when
  32. you only need to work on a specific subroutine or function.
  33.        This program will read a Qbasic or QuickBasic program, which must be
  34. saved in ASCII format, and print it to a disk file with the same name as the
  35. original, but with the extension of LST instead of BAS. It should look like
  36. the same way you wrote it with the changes as described below. It will print
  37. a two line heading with the first line being program name, date, time, and
  38. page number. The second heading line will consist of one of three possible
  39. headings. One (1) the Main Module which is usually the beginning of a
  40. program. This will be the same name as the program.  Two (2) SubRoutine name.
  41. Three (3) Function name. In each case you will see in parenthesis what you
  42. are looking at. Also there is an individual page number for all each routine.
  43. The program will start a new page for every Subroutine or Function. Any line
  44. that is longer than eighty (80) characters is split into two (2) line, the
  45. second line will have <<*>> before to show that it was split. I assume no
  46. line will be greater than one hundred and sixty characters (160).
  47.  
  48.                             How This Program Work
  49.                             ---------------------
  50.        Copy QBLIST.EXE to the directory where you keep your basic programs.
  51. the program will only write to the same directory that it is in. Type QBLIST
  52. then press return. A menu will ask you what program you want to list. type in
  53. the name with out the Bas extension. The next menu will give you five (5)
  54. options. 
  55. Option One (1) Complete -- This will print a complete list of your program.
  56. Option Two (2) Main Module -- This will print the only the beginning of your
  57.                                program.
  58. Option Three (3) SubRoutine -- This will print any SubRoutine that you want.
  59.                                Another screen will ask you for the name of  
  60.                                the SubRoutine or you can key in L or the    
  61.                                whole word List and you will be given a list 
  62.                                of all the SubRoutines in the program.
  63. Option Four (4) Function -- This works the same as Option 3 but for Functions
  64.  
  65. Option Five (5) Quit -- This will end the program.
  66.  
  67. In all cases please key in the number of an option. Every time your run this
  68. program it will overwrite the previous file with the same name. Therefore
  69. after you run this program use the command COPY FILENAME.LST LPT1, this will
  70. then print your listing. I did it this way so that you can look at the
  71. program with a ascii viewer or print it from the disk instead of waiting for
  72. the printer.
  73. See special notes below for modification that you can make. 
  74.  
  75.                        Special Notes About The Program
  76.                        -------------------------------
  77.        I don't have a laser printer so I don't know how this program will
  78. work with one.
  79.        This program assumes that you can manually change you printer to 12
  80. characters per inch at 8 lines per inch. I've done this because this gives me
  81. ten spaces to the left of the listing for my hole puncher so that I can put
  82. the listing in a standard size 3 hole binder. For any lines that are greater
  83. than eighty (80) characters it is easy to see the <<*>> notation. Also my dot
  84. matrix printer prints nicely this way. And since every printer works
  85. differently I don't have to worry about special print codes.
  86.        To change this take out the (3) three TAB(10) instructions from the
  87. WriteLine subroutine.
  88.        If you don't like the 8 lines per inch change 82 to 62 in the
  89. WriteLine subroutine.
  90.        If want to print directly to the printer change all the PRINT statements
  91. to LPRINT in the Following SubRoutines: WriteLine, ProgramTitle, SubTitle 
  92.  
  93.        The program checks each line to see if it is greater than eighty (80)
  94. characters. If it is looks for the last blank space on the line and prints
  95. the second line from that point on. I have noticed that some DATA statements
  96. have spaces after each comma in that case there is no problem. If there are
  97. no spaces you will note that the word DATA goes on one line and the rest goes
  98. on another. This is because the only space is after the word DATA.
  99.    
  100.        The one major flaw to this program is, when there are REMARK line
  101. before a Subroutine or Function. I don't how Qbasic or QuickBasic keeps track
  102. of each subroutine or function. Some programmers put remark or defint or any
  103. other statements before a subroutine or function. This is fine when you are
  104. using Qbasic or Quickbasic. The flaw in this program is that I look for the
  105. word SUB or FUNCTION to start a new page. Therefore anything that precedes a
  106. subroutine or function will show up on the previous page when you as for a
  107. complete listing of the program, and will not show up if you request a
  108. partial listing. If anyone has any ideas to get around this please contact
  109. me.
  110.  
  111.                                   Contact Me
  112.                                   ----------
  113.        I would greatly appreciate any comments, suggestions, or problems that
  114. you encounter with this program.                                   
  115.        I can be contacted on the INVENTION FACTORY BBS at (212) 431-1194.
  116. Leave me a message. Or you can write to me directly at the address below.
  117.  
  118.  
  119.                                SOLOMON EINHORN
  120.                                901 AVE H   APT. 3J
  121.                                BROOKLYN, NY 11230                           
  122.          
  123.  
  124.