home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / DOOG / PRTOUT23.ZIP / PRINTOUT.DOC next >
Text File  |  1990-10-08  |  8KB  |  177 lines
  1.  
  2. Documentation file for PrintOut version 2.3  by Bryce Newall
  3.  
  4.      Sorry, folks.
  5.      A bug creeped in that I didn't catch.  I think I told Turbo C's editor
  6. to move a block instead of copying it, and it killed a section of code,
  7. resulting in the program printing continuous feed even if you told it manual
  8. feed.  This only happened when you told it your file was NOT pre-formatted
  9. with page breaks.
  10.  
  11.  
  12. Version 2.2 Notes:
  13.  
  14.      Well...not a whole lot has changed here.  One bug has been fixed:  If
  15. you told PrintOut not to use the default formatting options, and then told
  16. it to print page numbers, it wouldn't.  That bug has been squashed.
  17.      There's also one new feature:  While a file is printing, or when you
  18. are being prompted to insert another page, you can press "Q" to quit the 
  19. current file and go on to the next one (if there is one).
  20.  
  21. Description of files in PRTOUT23.ZIP:
  22.  
  23.      PRINTOUT.EXE -- PrintOut program
  24.      PRINTOUT.DOC -- This file
  25.  
  26. This program was created using Turbo C 2.0.
  27.  
  28. Command line format:
  29.  
  30.                          PrintOut [filename]
  31.  
  32. where [filename] is an optional (hence the brackets) parameter.  If
  33. [filename] is not specified, PrintOut will ask you to enter the filename.
  34. PrintOut can now accept wildcards, allowing you to print out an entire set
  35. of files (such as *.DOC) without having to run PrintOut for each file.  You
  36. can also have PrintOut skip the files you don't want to print.  If you
  37. supply the [filename] parameter, PrintOut will display the prompt asking for
  38. the filename, but will fill it in for you.  If PrintOut cannot find the
  39. filename entered, you will be given an error message.
  40.  
  41. NOTE:  Due to a bug in the Turbo C fnsplit() function, the filename you
  42.        enter can have either a drive *or* directory, but not both.  If you
  43.        enter both, the drive specifier will take precedence.
  44.  
  45. PrintOut will now tell you it is about to printout the first file matching
  46. the filename you entered.  You will be given the option to skip this file.
  47. Hit Y to skip it, or N or <ENTER> to print it.
  48.  
  49. ** Please note that from here on, values in [square brackets] indicate
  50.    default values/answers, allowing you to simply hit <ENTER> to accept that
  51.    value/answer.
  52.  
  53.  
  54.                                Output Device
  55.  
  56. Next, you will be asked for the output device.  Hit <ENTER> for PRN, or type
  57. in the name of the output device (such as COM1, or even a disk file such as
  58. C:\DOCS\TEXTFILE.PRT).
  59.  
  60.  
  61.                                 Pre-formatted?
  62.  
  63.  
  64. Next question:  Is "[filename]" pre-formatted?"  This means, are there page 
  65. breaks in your file?  (PrintOut will scan the file and tell you if it found 
  66. page breaks.  If it did, it will default to pre-formatted, and you can press 
  67. Y or <ENTER> to select Yes.  You can still press N if you think PrintOut was
  68. wrong.)  If there are, press Y, and PrintOut will do the rest.  You can now
  69. skip down to the "Paper Feed" section.
  70.  
  71.  
  72.                            Default Printing Options
  73.  
  74. If you answer N, or press <ENTER>, you will be asked if you want to use the
  75. default printing options.  They are as follows:
  76.  
  77. Any width printer (PrintOut does not wrap lines to the next line on the
  78.      page; the printer takes care of it)
  79. No left or right margins
  80. 4 row top and bottom margins
  81.  
  82. If you choose not to use the default printing options, you will be asked to
  83. enter them.  (Note:  You will be asked for the number of lines per page
  84. regardless of whether or not you use the default options.)  Type in the
  85. numbers corresponding to the values you wish to use, or press <ENTER> to
  86. accept the default values, as indicated in square brackets.  Note that,
  87. under lines per page, the default value of 66 may not work right with some
  88. laser printers.
  89.  
  90. If you enter any values that are out of the allowable range, PrintOut will
  91. display an error message and ask you to reenter that piece of information.
  92.  
  93.  
  94.                              Lines Per Page
  95.  
  96. If you answered N to the default options question, you have already
  97. completed this section.  Skip down to "Page Numbering".  Otherwise, enter
  98. the number of lines you want printed per page (or hit <ENTER> to accept the
  99. default of 66).  Note that 66 may not work with some laser printers.
  100. PrintOut is really designed for dot matrix and daisy-wheel (letter quality)
  101. type printers.
  102.  
  103.  
  104.                               Page Numbering
  105.  
  106. If you answered N (or hit <ENTER>) when asked if your file was pre-
  107. formatted, you will be asked if you want page numbering.  If you used the
  108. default printing options, there will be enough room for page numbering
  109. (assuming your printer is wide enough).  Otherwise, if you specified a top
  110. margin of less than 2 lines, you won't be able to use page numbering, and
  111. PrintOut will indicate that.  Otherwise, press Y or <ENTER> to use page
  112. numbering, or N not to.
  113.  
  114.  
  115.                             First Page Number
  116.  
  117. Again, if you answered N when asked if your file was pre-formatted, you will
  118. be asked what you want the first page number to be.  Press <ENTER> for 1, or
  119. enter the desired value.  This is useful if you had to stop printing for
  120. some reason (e.g. your printer jammed).  Rather than starting over, you
  121. could edit the file, cut out what was already printed, and start printing
  122. what is left, giving it a new starting page number (such as 10).
  123.  
  124.  
  125.                              Paper Feed
  126.  
  127. Finally, you will be asked if you want to use manual or continuous (fanfold)
  128. feed paper.  Press M or <ENTER> if you are using manual feed, or C if you
  129. are using continuous.  With manual feed, PrintOut will stop after each page
  130. and wait for you to insert a new sheet of paper.
  131.  
  132.  
  133.                              Begin Printing!!
  134.  
  135. By now you thought this time would probably never come, but it's here.
  136. PrintOut will tell you to press any key when the printer is ready.  When the
  137. printer is all set up, hit any key to begin printing.
  138.  
  139. PrintOut is designed so that you can get through most printing jobs by
  140. entering the filename and then hitting <ENTER> until your printer starts
  141. printing (by using strategic default options).
  142.  
  143.  
  144.                             Miscellaneous Info
  145.  
  146. At any time while PrintOut is printing (or waiting for any key to be
  147. pressed), you can press <ESC> to stop PrintOut.  (This also applies during
  148. the entering of 1-character information (e.g. Y/N questions).)  You can also
  149. press "Q" to quit printing the current file and go on to the next file (if
  150. there is one).  However, depending on the size of your printer's buffer, you
  151. may still see data coming out of your printer.  You may have to turn off
  152. your printer to stop it.  Pressing <ESC> or "Q" simply stops PrintOut from
  153. sending more data to the printer.
  154.  
  155. Also at any time during printing, you can press <ENTER> to pause the
  156. printing.  The message "Printing paused; press any key to resume..." will be
  157. displayed.  Press any key to resume printing.  This function will also vary
  158. depending on the size of your printer's buffer.
  159.  
  160. If you want to practice using PrintOut, try using it to print out this file.
  161.  
  162. Please distribute this program to everyone you know, but NOT for $money$.
  163. Thanks!
  164.  
  165. If you like this program, please send a donation ($2 to $5) WITH A RETURN
  166. ADDRESS to:
  167.                                      Bryce Newall
  168.                                      5253 Countryside Drive
  169.                                      San Diego, CA  92115
  170.  
  171. If you send a donation, you will be entitled to future releases of the
  172. program.  If you find any bugs, please call me at (619)582-9811.  If you
  173. send $10 or more, I'll send you a copy of the source code (but PLEASE don't
  174. modify it and re-sell it for $money$).
  175.  
  176. Enjoy!
  177.