home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / TEXT / UTILITY / QP201.ZIP / QP.DOC next >
Encoding:
Text File  |  1990-12-29  |  17.6 KB  |  508 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                          Q U I C K P R I N T
  16.  
  17.  
  18.                         An easy  and fun to use
  19.                         text file print utility
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                                Version 2.01
  44.                                                December 29, 1990
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                              DISCLAIMER
  61.  
  62.  
  63.          QuickPrint is provided as is, free of charge. There are no
  64.     warranties written or otherwise implied.  While no problems are
  65.     expected the author assumes no responsibilty for damage to data
  66.     or hardware that arises out of the use of this program.
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                             INTRODUCTION
  119.  
  120.  
  121.  
  122.           QuickPrint is a handy and easy to use ASCII text print
  123.      utility.  Some of the highlights of the program are:
  124.  
  125.           -    It is "human engineered" (ergonomically designed) to
  126.                provide  maximal visual input with a minimum of fuss
  127.                (more on this later).
  128.  
  129.           -    Very few keystrokes are needed to load, view and print a
  130.                file.
  131.  
  132.           -    It tells you how many pages will be printed before
  133.                printing starts ( ALT-C ).
  134.  
  135.           -    It has a progress bar to give you quick input on the
  136.                status of the printing.
  137.  
  138.           -    It tells you which page is currently being sent to
  139.                the printer.
  140.  
  141.           -    View screens are numbered for reference purposes.
  142.  
  143.           -    The picklist is large, easy to read, alphabetically
  144.                sorted, includes the most important file information and
  145.                searches for names alphabetically.
  146.  
  147.           -    Works with color and monochrome monitors.
  148.  
  149.           -    Will automatically provide pagination and footers (page
  150.                numbers) for unformatted files.  If a file is formatted
  151.                with form feeds then QuickPrint will not add formfeeds
  152.                or footers.
  153.  
  154.           -    Files can be tagged for easy printing of multiple files.
  155.  
  156.           -    Can print with or without line numbers.
  157.  
  158.           -    Can change number of lines printed per page ( ALT-N ).
  159.                ( Default is 58 lines not including the footer ).
  160.  
  161.           _    Can add margins to left side of page ( ALT-M ).
  162.  
  163.           The major design philosophy behind QuickPrint's development
  164.      was that it should be a no frills, easy to use print utility that
  165.      will automatically provide pagination and page numbers.
  166.  
  167.           This makes it an excellent tool for printing Readme and
  168.      documentation files provided on disks with programs.  It is also
  169.      ideal for programmers wanting to print hardcopies of their code.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.                         USING QUICKPRINT
  176.  
  177.      A.   THE PICKLIST
  178.  
  179.           QuickPrint has been compiled as QP.EXE.  It can be started by
  180.      typing QP alone or following it with a filename.  If no name is
  181.      provided a picklist will be displayed.  The long horizontal window
  182.      bar on the bottom displays identification and the number of files
  183.      in the directory.  The central picklist window displays the current
  184.      directory's filenames, 21 names per display, sorted alphabetically.
  185.      The highlight bar is placed approximately in the middle of the list
  186.      to provide equal access to the filenames.
  187.  
  188.           The following keys will work to allow navigation through the
  189.      list:
  190.  
  191.           Home - This will put the highlight bar at the top on the very
  192.           first file.
  193.  
  194.           End - This puts the bar at the bottom on the very last
  195.           filename.
  196.  
  197.           PgDn - This pages down through the list displaying 21
  198.           filenames at a time.  The highlight bar will be placed in the
  199.           middle of the list with each key press.
  200.  
  201.           PgUp - Same as PgDn except pages up through the list.
  202.  
  203.           Up Arrow - Scrolls up through the list, one filename at a
  204.           time.
  205.  
  206.           Dn Arrow - Scrolls down through the list.
  207.  
  208.           Alpha Numeric - Any filename starting with a printable ASCII
  209.           character may be searched for by pressing the appropriate key.
  210.           For example, pressing the 'A' key will place the highlight bar
  211.           on the first filename starting with an A.  When possible this
  212.           name will be placed in the middle of the display.  This is not
  213.           case sensitive. Subsequent presses will scroll through the list
  214.           of files starting with that character. If possible, the
  215.           highlighted filename will remain in the middle of the list.
  216.  
  217.           Esc - Pressing the escape key terminates the program and
  218.           places you at the DOS prompt.
  219.  
  220.           Enter - Pressing the <Enter> key starts the main program and
  221.           loads the file currently highlighted. ** NOTE ** If you
  222.           tagged several files for printing pressing <Enter> will
  223.           put you into a large window with the names of the tagged
  224.           files displayed.  The text is NOT viewed in the window
  225.           when printing multiple files like it is when only a single
  226.           ( untagged ) file is selected.  Keeping this in mind you may
  227.           want to view the files individually before tagging them.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.           "+" - The plus key will tag a file for printing. This is used
  234.           to create a list of several files that are to be printed
  235.           consecutively in the order they are selected. When a file is
  236.           tagged an asterick ( * ) will appear next to the name.
  237.  
  238.           "-" - The minus key will untag a file and delete it from
  239.           the list.
  240.  
  241.       B.  VIEWING FILES
  242.  
  243.           Quickprint is meant to print files and is relatively crude at
  244.      displaying them.  This feature is provided so you can quickly scan
  245.      the file to determine if it's worth printing.  The selected file is
  246.      loaded into available memory.  If not enough memory is available,
  247.      only that which will fit into memory will be loaded.  The rest of
  248.      the file will be truncated.   If this occurs, you will see 'TR'
  249.      displayed in the lower window bar just prior to the '<ESC>
  250.      to quit' message.  This has no affect on printing.  Despite
  251.      truncation, the ENTIRE file will be printed.  The file is printed
  252.      from the disc, not from memory.  Individual lines longer than 80
  253.      characters will be truncated to 80 characters on the display but
  254.      again, this does not affect the printed form.
  255.  
  256.           Because QuickPrint has to read the entire document one line at
  257.      a time, and formats each line for display, some longer files may
  258.      take quite a few seconds to be read, especially if on a floppy
  259.      disk.  After this is accomplished however, the file will be in
  260.      memory and no additional disk reads will be needed.  Version 2.00
  261.      has been updated to load files much faster.
  262.  
  263.           THE UPPER BAR WINDOW
  264.  
  265.           The left hand side of the bar displays the filename. To the
  266.      right of the filename is a list of keys operable while viewing
  267.      the file. They are described below.
  268.  
  269.                Alt-P - Pressing the Alt-P combination immediately
  270.                        starts printing.
  271.  
  272.                Alt-L - Will print with line numbers.
  273.  
  274.                Alt-M - Will set left hand margin. Valid margins
  275.                        are from 0 to 70 spaces.
  276.  
  277.                Alt-N - Sets number of lines printed per page.
  278.                        Valid numbers are 1 to 250.
  279.  
  280.                Alt-C - Version 2.0 does not automatically count
  281.                        the number of pages to print. This allows
  282.                        for much quicker loading of the file. You
  283.                        can get a count of the pages by pressing
  284.                        the Alt-C combination. The count will be
  285.                        displayed on the bottom line and will be
  286.                        provided in any case when you start printing
  287.                        since the program needs this information to
  288.                        track the progress of the print job.
  289.  
  290.  
  291.      Navigational keys not dispalyed on the top bar window ...
  292.  
  293.                Home - This puts you at the very beginning of the file.
  294.                Twenty three lines are displayed at a time.
  295.  
  296.                End - This puts you at the very end of the file.  If the
  297.                file was truncated due to memory limitations, the last 23
  298.                lines of the shortened file will be displayed.
  299.  
  300.                Up and Down Arrows - Scroll one line at a time in their
  301.                respective directions.
  302.  
  303.                PgUp and PgDn - Move through the file one screen at
  304.                a time, backward or forward respectively.
  305.  
  306.  
  307.           On the far right is the screen display number. Each screen is
  308.      defined as the 23 lines of text displayed. This is provided for
  309.      reference purposes - to give you an idea of where you are located
  310.      in the file in case you want to return to it. It does not correlate
  311.      with printed page numbers.  This number provides only a relative
  312.      position reference.
  313.  
  314.  
  315.           THE LOWER BAR WINDOW
  316.  
  317.           This is a rather dynamic window.  Most messages and
  318.      pertinent information will be displayed here.  When viewing the
  319.      file the system date and time will be displayed on the left hand
  320.      side.  This is helpful in the wee hours of the morning to remind
  321.      you how much sleep you are not getting!  Next, the amount of print
  322.      pages is given.  This number will appear only if you first press
  323.      Alt-C to get a count of the pages, or if you print the file then
  324.      return to viewing it. This is how many pages the printed document
  325.      will be.  If the document contains formfeeds this number gives a
  326.      count of them.  Otherwise, a printed page contains 58 lines of
  327.      print, not including the margins and footer.  This provides roughly
  328.      a one-half inch margin both at the top and below the footer.
  329.  
  330.      Fifty eight lines printed per page is the default number. This can
  331.      be changed by pressing the ALT-N key combination. The acceptable
  332.      range of lines per page is 1 to 250. Fifty five (or less) is
  333.      recommended for laser printers. A larger number can cause the footer
  334.      to be pushed onto the next page.
  335.  
  336.           On the left hand side the date will be replaced by several
  337.      messages depending on certain conditions.  "Top of File" and
  338.      "End of File"  are displayed when at the very beginning or
  339.      very end of the file.  Anywhere in between these messages will not
  340.      be displayed. Instead you'll always see the date.
  341.  
  342.           To the right of the page count the amount of lines printed
  343.      per page will be diplayed as "Li=58" with the 58 being replaced
  344.      by the proper number should you decide to change the number. If
  345.      you change this number the amount of pages to be printed will be
  346.      adjusted accordingly.
  347.  
  348.  
  349.           Just to the right of this number is the size of the margin.
  350.      The default is 0 ( "M=0" ). If the number is changed it will be
  351.      reflected in this display. For example, "M=5" for a margin of
  352.      5 spaces. The page count is not updated to reflect margin changes.
  353.  
  354.           If you select either Alt-M or Alt-N then decide to leave the
  355.      value as is, pressing enter without inputing any numbers will
  356.      abort the process and the values will remain unchanged.
  357.  
  358.           If the file was too big to fit in memory the letters "TR"
  359.      will appear after the margin number to indicate that the file
  360.      was truncated to fit in memory. Again, this has no effect on the
  361.      final print job.
  362.  
  363.           Finally, the last bit of information is self-explanatory.
  364.      <Esc> will always stop printing or terminate the viewing of a file.
  365.      If viewing a file it will put you back at the file directory.  If
  366.      you tagged files for a list it will put you back at the picklist.
  367.  
  368.      C.   PRINTING  (finally)
  369.  
  370.           At any time you may start printing by pressing the ALT-P key
  371.      combination. Use the ALT - L combination if line numbers are
  372.      desired .   Make sure your printer is on and the paper is
  373.      properly lined up. A formfeed is sent to the printer to clear
  374.      any junk that may be in the print buffer. It's best to start
  375.      printing at about one-half inch from the top.  This gives
  376.      the best appearance of vertically centered text, including
  377.      the footer.  Printing will always start at the beginning of
  378.      the file and will print the ENTIRE file, even if it was truncated.
  379.      While printing you will see several windows.  If you are printing
  380.      only one file ( no files were tagged ) the large central window
  381.      will display the text as it is sent to the printer (or buffer).
  382.      Below this will be displayed a horizontal progress bar that gives
  383.      you percentage of completion.  This is handy in that it allows you
  384.      to easily see the progress of the print job.
  385.  
  386.           If you tagged several files for printing, you will see the
  387.      list of files displayed in the main window rather than the text
  388.      that is printing.  You will however be advised of the status
  389.      of the print job by the progress bar.  The bar starts over for
  390.      each file.  The file that is printing is highlited in the window.
  391.      Files whose printing is complete are diplayed in reverse video.
  392.      The very bottom window will now show on the left, the number
  393.      of total print pages (in case you forgot).  In the central part,
  394.      the page being printed will be shown.  Between this and the progress
  395.      bar you'll have plenty of visual representation of the status of
  396.      your print job.
  397.  
  398.  
  399. **        You can pause printing by pressing <ESC) or the spacebar.
  400.      At this point, any key except <ESC> will resume printing.
  401.      Pressing <ESC> again will terminate the print job and put you back
  402.      in the view mode ( or the file list if files were tagged and
  403.      you are printing from a list).  Therefore, the spacebar can act
  404.      as a toggle to alternately stop and start printing.
  405.  
  406.  
  407.           If the printer is not on or not online, a message will appear
  408.      to alert you of this.  If no formfeeds are detected, QuickPrint will
  409.      add them, along with a footer that provides the name of the file
  410.      and it's date and time on the left and the page number on the right.
  411.  
  412.  
  413.      D. FINAL COMMENTS
  414.  
  415.           Since reading the file is disk intensive, it would be faster
  416.      to use your hard disk if available.  This becomes especially
  417.      important for long files.
  418.  
  419.           QuickPrint stores the file in memory in slightly smaller than
  420.      65K chunks.  It would allow more of the file to fit in memory if
  421.      memory was contiguous and not "chopped up" by other programs.
  422.      Rebooting the computer will give you the largest possible
  423.      contiguous piece of memory.  Any TSR programs, RAM print buffers,
  424.      disk-caches, etc. will decrease available RAM for use by
  425.      QuickPrint.
  426.  
  427.           In order to keep this a simple to use program it is minimally
  428.      configurable.  There are no command line "switches".  If you like
  429.      this program but would like some minor changes made, let me know.
  430.      I'll see what I can do to accommodate you.  If this program causes
  431.      snow on some older CGA monitors, I can provide you with a version
  432.      that will reduce or eliminate the problems.
  433.  
  434.           I am interested in your questions or comments.  Please feel
  435.      free to contact me at the following address or on compuserve.  My
  436.      CompuServe ID number is 71541,743. I may also be contacted on GEnie,
  437.      where my address is J.DEROSE1.  If you like or even dislike this
  438.      program I encourage you to let me know.  Your responses are what
  439.      keeps me motivated to improve the program. All the changes in
  440.      versions 1.5 and 2.0 were the result of user's suggestions.
  441.  
  442.           Enjoy!
  443.  
  444.           Thank you.
  445.  
  446.  
  447.      Joseph L. DeRose
  448.      825 Dora Place
  449.      Bel Air, Maryland 21014
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.      APPENDIX A
  466.  
  467.      Summary of key combinations and examples of the status bars.
  468.  
  469.      ALT-P : Prints the document without line numbers.
  470.      ALT-L : Prints the document with line numbers.
  471.      ALT-N : Changes the number of lines printed per page.
  472.      ALT-M : Adds or changes the margin on the left side.
  473.      ALT-C : Counts the number of pages that will be printed
  474.              taking into account the number of lines printed
  475.              per page.
  476.  
  477.  
  478.      UPPER BAR
  479.  
  480.   <FILENAME.EXT> AltP/L=print AltM=margin AltN=l/p AltC=count  Screen:###
  481.                     ^            ^           ^        ^
  482.                     |            |           |        |
  483.                     |            |           |        Count Pages to Print
  484.                     |            |           Change Num Lines Per Page
  485.                     |            Set Margin
  486.                     Print Document
  487.  
  488.      LOWER BAR
  489.  
  490.  Dec 09, 1990  10:05 p.m.   4 pages    Li= 58  M= 0  TR      <ESC> to Quit
  491.  ^             ^            ^          ^        ^    ^
  492.  |             |            |          |        |    Indicates Truncation
  493.  System Date   System Time  |          |        Margin - left side
  494.  ^                          |          Lines Printed per Page
  495.  |                          Num of Pages to Print
  496.  This will be replaced with TOP of FILE or END of FILE when appropriate.
  497.  
  498.  
  499.  
  500.      LOWER BAR WHEN PRINTING
  501.  
  502.  Pages: 4           Printing: 2        Li= 58  M= 0          <ESC> to Quit
  503.         ^                     ^
  504.         |                     |
  505.         |                     Page Being Printed
  506.         |
  507.         Number of Pages That Will be Printed
  508.