home *** CD-ROM | disk | FTP | other *** search
/ The California Collection / TheCaliforniaCollection.cdr / his033 / prncol31.arj / PRNCOL.DOC next >
Encoding:
Text File  |  1990-01-03  |  17.2 KB  |  467 lines
  1.  
  2.  
  3.  
  4.  
  5.                                       PRNCOL 3.0 documentation  1
  6. -----------------------------------------------------------------
  7.  
  8.  
  9.             PRNCOL, the paper saving printing utility
  10.             =========================================
  11.  
  12.                             Steve Fox
  13.                         11515 113th Pl NE
  14.                        Kirkland, WA  98033
  15.  
  16. Has your 3-ring binder ever been so full you couldn't close the
  17. rings?  Have you ever said to yourself "that shareware program I
  18. just downloaded is great, but the documentation is so long I'd
  19. rather not print it"?  Do you programmers ever want to see a
  20. longer section of your program at once?  If you answer "yes",
  21. PRNCOL will help you in these and other similar situations.
  22.  
  23.  
  24.  
  25. I. WHAT PRNCOL WILL DO
  26. ----------------------
  27.  
  28. PRNCOL prints your files in multiple columns, using one of your
  29. printer's small fonts.  Each column typically contains one normal
  30. size page of text.  Since each sheet has two, three, or four
  31. columns, multiple pages are condensed on to one sheet.  For
  32. example, this entire 8 page document can be printed on a single
  33. sheet of paper on an Epson FX printer (by printing on two sides
  34. of the paper).
  35.  
  36. PRNCOL has many options, but for most users the default options
  37. are appropriate.  These options include ignoring blank lines,
  38. printing odd or even sheets only, pausing between each sheet, and
  39. a few others.
  40.  
  41. The files you print must be text files, and should not contain
  42. any printer codes.  Printer codes may conflict with PRNCOL.  If
  43. your file was produced by a word processor, spreadsheet, or other
  44. software, be sure to specify a generic printer or an empty
  45. printer setup.
  46.  
  47.  
  48.  
  49.  
  50.  
  51. II. SHAREWARE
  52. -------------
  53.  
  54. PRNCOL is shareware software.  This means it may be freely copied
  55. and distributed, provided that the entire package of files is
  56. included (PRNCOL.EXE, PRNCOL.DOC, and PRNCOLRG.EXE).  If you find
  57. this software useful, please register it with the author.  No fee
  58. may be charged for use of this software, nor for copying and
  59. distributing it, except for a nominal diskette and mailing fee of
  60. less than $10.
  61.  
  62.  
  63.  
  64.                                       PRNCOL 3.0 documentation  2
  65. -----------------------------------------------------------------
  66.  
  67. Support for several Epson FX and HP LaserJet printing options are
  68. built in.  Unregistered users can use all the program's features
  69. including setting up custom printing options, but can't save
  70. them, nor can they save defaults.
  71.  
  72. When you register you will receive a registration number.  Then,
  73. run PRNCOLRG to register your copy of PRNCOL.EXE.
  74.  
  75. Registration costs only $8.  If you send $15, you will receive
  76. the next version of the software when it becomes available.
  77. Please write the current version number of PRNCOL, and where you
  78. obtained it, and send a check or money order to:
  79.  
  80.                             Steve Fox
  81.                         11515 113th Pl NE
  82.                        Kirkland, WA  98033
  83.  
  84. Thank you for your support of the shareware software concept.
  85.  
  86.  
  87.  
  88. III. SIMPLEST USAGE OF PRNCOL
  89. -----------------------------
  90.  
  91. To use the program's defaults, just enter "PRNCOL" and the name
  92. of the file to print at the DOS prompt.  Some examples are:
  93.  
  94.         PRNCOL PRNCOL.DOC
  95.         PRNCOL BIGLIST
  96.         PRNCOL MYPROG.PAS
  97.  
  98. When the main screen is displayed, press F10 (PrintFiles).  After
  99. the file is printed, press F2 (Quit) to return to DOS.  That's
  100. it!
  101.  
  102.  
  103.  
  104. IV. SYNTAX
  105. ----------
  106.  
  107. PRNCOL has two optional arguments.  Many users prefer to enter
  108. "PRNCOL" at the DOS prompt and let the program ask for all the
  109. information.  The full syntax is:
  110.  
  111.         PRNCOL [input-file-name] [output-file-name]
  112.  
  113. where:
  114.  
  115. [input-file-name] is any text file you want to print.  Wildcards
  116.         (i.e., * and ?) can be used to specify multiple files.
  117.         You can specify multiple files by enclosing them in
  118.         quotes.
  119.  
  120.  
  121.  
  122.                                       PRNCOL 3.0 documentation  3
  123. -----------------------------------------------------------------
  124.  
  125. [output-file-name] is the name of the file where PRNCOL will send
  126.         its output.  Normally you wouldn't specify this option,
  127.         so that PRNCOL sends its output directly to your printer.
  128.  
  129. Examples:
  130.  
  131.         PRNCOL
  132.         PRNCOL MANUAL.DOC
  133.         PRNCOL MANUAL.DOC PRINTLAT.ER
  134.         PRNCOL "MAIN.PAS SUB1.PAS SUB2.PAS" PRINT.ME
  135.  
  136.  
  137.  
  138. V. BUILT-IN PRINTING OPTIONS
  139. ----------------------------
  140.  
  141. PRNCOL has 10 printing options, numbered 0 through 9.  There are
  142. five built-in options for the Epson FX printer, and one for the
  143. HP LaserJet printer.  Options 1 and 3 for the Epson FX use very
  144. small characters, which print better with a slightly used ribbon.
  145.  
  146. The built in options are:
  147.  
  148. Opt 0:  Epson FX.  Two pages (66 lines) per sheet.  Uses
  149.         compressed elite font.
  150. Opt 1:  Epson FX.  Four pages (66 lines) per sheet.  Uses
  151.         subscript font.
  152. Opt 2:  Epson FX.  Two columns per sheet, each with 80 lines.
  153.         Uses compressed elite font.
  154. Opt 3:  Epson FX.  Two long columns, each with 160 lines.  Uses
  155.         subscript font.
  156. Opt 4:  Epson FX.  Three narrow columns per sheet, each with 80
  157.         lines.  Uses compressed elite font.
  158. Opt 5:  HP LaserJet.  Two pages (66 lines) per sheet.  Uses
  159.         landscape compressed font.
  160.  
  161. Options 6 through 9 are undefined.  See "CUSTOM PRINTING OPTIONS"
  162.         for more information.
  163.  
  164.  
  165.  
  166. VI. DESCRIPTION OF EACH PRINTING FIELD
  167. --------------------------------------
  168.  
  169. A list of fields is displayed when you enter the program.  (See
  170. the appendix for information on how to use the screens.)  These
  171. fields allow you to change the way your output will print.  A
  172. explanation of each field follows.
  173.  
  174. PRINT:  Enter a list of the files you want to print.  Separate
  175.      each filename with a space.  You can enter wildcards for
  176.      files, such as "*.DOC", or "BOOK??.DOC".  Three lines are
  177.      provided for your list.  Do not split up a filename between
  178.  
  179.  
  180.  
  181.                                       PRNCOL 3.0 documentation  4
  182. -----------------------------------------------------------------
  183.  
  184.      the lines; each file name must be wholly contained on one
  185.      line.
  186.  
  187. SEND TO:  Choose either "Printer" or "File".  "Printer" sends
  188.      your output directly to the printer (defined as the DOS file
  189.      PRN).  "File" sends your output to any DOS file you specify
  190.      in the next field.
  191.  
  192. FILE:  Enter the output filename.  You can also use standard DOS
  193.      filenames such as LPT1, COM1, CON, etc.
  194.  
  195. OVERWRITE:  If the output file exists, you must change this field
  196.      from "No" to "Yes".
  197.  
  198. OPTION:  Choose the printing option.  Each printing option
  199.      consists of a printer and a printing format.  A schematic of
  200.      the printed sheet is displayed to the right.
  201.  
  202. START FILES:  If you specified more than one file to print, you
  203.      have three options on what happens between each file.  You
  204.      can print the files continuously, so that each succeeding
  205.      file continues in the column where the previous file left
  206.      off.  You can start a new column for each file.  Or you can
  207.      start a new sheet for each file.  In each case, all the
  208.      files are printed as one long printout, and sheet numbers
  209.      continue to increase.
  210.  
  211. FORMFEEDS:  "Start new column", the normal choice, starts a new
  212.      column when a formfeed is encountered.  "Ignore" doesn't do
  213.      anything with formfeeds.  You may want to ignore them to
  214.      reduce the printout length.
  215.  
  216. COLUMN DIVIDER:  Several different characters can be selected to
  217.      divide the columns, including just a plain blank space.
  218.  
  219. SPLIT LONG LINES:  "Yes" splits long lines into multiple lines.
  220.      "No" prints only the first portion of a long line, ignoring
  221.      the rest of the line.  You may want to use "No" to maintain
  222.      the document's intended page length.
  223.  
  224. PRINT BLANK LINES:  "Yes" prints blank lines.  "No" ignores blank
  225.      lines.  You may want to use this option to reduce the length
  226.      of the printout.
  227.  
  228. SHEET HEADINGS:  "Yes" prints a heading at the top of each sheet.
  229.      The heading consists of the filename, the date/time it was
  230.      filed, the date/time it was printed, and the sheet number.
  231.      This heading is underlined and right justified.  "No"
  232.      prevents the heading from being printed.  You may want to
  233.      use "No" if your document already has page numbers.
  234.  
  235. PRINT SIDES:  "Odd" prints sheets 1, 3, 5, etc.  "Even" prints
  236.      sheets 2, 4, 6, etc.  "Both" prints sheets 1, 2, 3, etc.
  237.      You may want to print the odd sheets, then turn over your
  238.  
  239.  
  240.  
  241.                                       PRNCOL 3.0 documentation  5
  242. -----------------------------------------------------------------
  243.  
  244.      fanfold paper and print the even sheets on the reverse side.
  245.      This uses only half reduces your printouts to half as much
  246.      paper.
  247.  
  248. FIRST SHEET:  Enter the first sheet to be printed.
  249.  
  250. LAST SHEET:  Enter the last sheet to be printed.
  251.  
  252. PAUSE BETWEEN SHEETS:  "Yes" gives you a chance to feed a sheet
  253.      into your printer before the program starts printing that
  254.      sheet.
  255.  
  256.  
  257.  
  258. VII. CUSTOM PRINTING OPTIONS
  259. ----------------------------
  260.  
  261. To enter the Option Editor, press F6 (EditOption).  There are 10
  262. possible options, numbered 0 through 9.  The option number is
  263. displayed at the top of the screen when you are in the Option
  264. Editor.  Each printing option consists of the following fields.
  265.  
  266. OPTION NAME:  Enter any name you want to give your option.  A
  267.      blank option name disables that option.
  268.  
  269. PRINTER NAME:  Enter the name of your printer, and any other
  270.      information you want displayed above the sheet schematic.
  271.  
  272. PRINTER RESET*:  Enter the codes that reset your printer to its
  273.      power-on settings (refer to your printer manual).  These
  274.      codes are sent twice, once before anything is printed, then
  275.      again once at the end.
  276.  
  277. PRINTER SETUP:  Enter the codes that set the font, margins, line
  278.      spacing, etc (refer to your printer manual).  These codes
  279.      are sent once, just after the reset codes.  You have three
  280.      lines to enter the codes.  PRNCOL will not insert any
  281.      characters between the lines.
  282.  
  283. UNDERSCORE ON:  Enter the codes that start underlining text
  284.      (refer to your printer manual).  These codes are used to
  285.      print the sheet headings.
  286.  
  287. UNDERSCORE OFF:  Enter the codes that stop underlining text
  288.      (refer to your printer manual).  These codes are used in
  289.      printing the sheet headings.
  290. ____________________
  291. *  To enter an ASCII character that you can't type directly from
  292.    the keyboard, use "\xxx", where "xxx" is the 3 digit ASCII
  293.    number.  For example, to send an ASCII 9, use: \009.  This
  294.    format is required for the ASCII characters 3, 9, 10, and 13
  295.    (Ctrl-C, TAB, LF, and CR).  If you need a backslash character,
  296.    type two in a row, i.e. "\\".
  297.  
  298.  
  299.  
  300.                                       PRNCOL 3.0 documentation  6
  301. -----------------------------------------------------------------
  302.  
  303. NO. COLUMNS:  Choose 2, 3, or 4 columns (4 columns are actually
  304.      two double columns).
  305.  
  306. SHEET WIDTH:  Enter the number of characters your printer can
  307.      print on one line.  PRNCOL will calculate the column width
  308.      using this value.  This value depends on what you send to
  309.      the printer in the setup string.
  310.  
  311. SHEET LENGTH:  Enter the number of lines your printer can print
  312.      on one sheet.  PRNCOL will calculate the column length using
  313.      this value.  This value depends on what you send to the
  314.      printer in the setup string.  When printing a sheet heading,
  315.      PRNCOL uses an extra line, so be sure your printer setup
  316.      codes account for this extra line.
  317.  
  318. GUTTER WIDTH:  Enter the number of spaces to be printed between
  319.      columns.  PRNCOL will calculate the column width using this
  320.      value.
  321.  
  322. VERTICAL GAP:  Enter the number of lines to be printed between
  323.      the two double columns (4 column printing only).  PRNCOL
  324.      will calculate the column length using this value.
  325.  
  326.  
  327.  
  328. VIII. APPENDICES
  329. ----------------
  330.  
  331. A. List of function keys, main screen
  332.  
  333.     F1 (Help) displays a short description of the current field.
  334.  
  335.     F2 (Quit) exits PRNCOL, and returns to DOS.
  336.  
  337.     F5 (SaveDefaults) saves the options on the screen in a
  338.         configuration file PRNCOL.CFG.  When you start up PRNCOL
  339.         the next time, these options become the default, instead
  340.         of the program's built-in defaults.  The saved defaults
  341.         include the printing option, start files, formfeed,
  342.         split, print blanks, headings, and column divider
  343.         character.  Unregistered users can't save defaults.
  344.  
  345.     F6 (EditOptions) enters the option editor.
  346.  
  347.     F9 (DOS Shell) places you in a DOS shell.  When you wish to
  348.         return to PRNCOL where you left off, enter EXIT at the
  349.         DOS prompt.
  350.  
  351.     F10 (PrintFiles) prints the files using the options you
  352.         specified.
  353.  
  354.  
  355.  
  356.                                       PRNCOL 3.0 documentation  7
  357. -----------------------------------------------------------------
  358.  
  359.  
  360.  
  361. B. List of function keys, edit options screen
  362.  
  363.     F1 (Help) displays a short description of the current field.
  364.  
  365.     F2 (AbortEdit) quits the option editor, returns to the main
  366.         screen, ignores any changes you made to the printing
  367.         options.
  368.  
  369.     F5 (Previous) changes to the next option number.  Options are
  370.         numbered 0 through 9.
  371.  
  372.     F6 (Next) changes to the next option number.  Options are
  373.         numbered 0 through 9.
  374.  
  375.     F7 (Copy) copies information from a printing option to the
  376.         currently displayed printing option.  Options are
  377.         numbered 0 through 9.  This is useful for making minor
  378.         changes to an existing option.
  379.  
  380.     F9 (DOSshell) places you in a DOS shell.  When you wish to
  381.         return to PRNCOL where you left off, enter EXIT at the
  382.         DOS prompt.
  383.  
  384.     F10 (Save,Return) Saves all the printing options in the file
  385.         PRNCOL.CFG, then returns to the main screen.
  386.         Unregistered users can return to use their new options,
  387.         but can't save them.
  388.  
  389.  
  390.  
  391. C. Using the Input screens
  392.  
  393. Information is displayed on the screen in three ways.
  394. Descriptions of fields, and other areas that you cannot change
  395. directly are displayed using normal text.  User changable fields
  396. are displayed in bright text.  The active field is displayed in
  397. inverse video text.
  398.  
  399. To change to the next field, press the ENTER key.  (You can also
  400. press the TAB or DOWN ARROW keys).  To change to a previous
  401. field, press the UP ARROW key (or Shift-TAB key).
  402.  
  403. There are four types of fields:  string fields (type any
  404. response), integer fields (for numbers), list fields, and yes/no
  405. fields.
  406.  
  407. For string and integer fields, just type in a response.  If the
  408. program doesn't like your response, it will beep and display an
  409. error message at the bottom of the screen.  Use the left and
  410. right arrows, home and end keys to move around within the field.
  411. Use the backspace, insert, and delete keys in their normal
  412. manner.
  413.  
  414.  
  415.  
  416.                                       PRNCOL 3.0 documentation  8
  417. -----------------------------------------------------------------
  418.  
  419. For list fields and yes/no fields, use the left and right arrows
  420. or the plus and minus keys to change the choice.  In addition,
  421. you can press Y or N for the yes/no fields.
  422.  
  423. D. Using the mouse
  424.  
  425. If you have a Microsoft or compatible mouse, it can be used in
  426. the screen fields.  Click any button to change to the field where
  427. the mouse cursor is located.  If you already in that field, a
  428. click has a different effect.  For list and yes/no fields, the
  429. left mouse button changes to the previous choice, and the right
  430. button changes to the next choice.  For string and integer
  431. fields, clicking any key moves the text cursor.  Try it!
  432.  
  433. You can also click the mouse in the function key area to select a
  434. function key.
  435.  
  436. E. Program History
  437.  
  438. PRNCOL was originally written for personal use on a Hewlett-
  439. Packard 9000 Series 200 in 1985.  Version 1 was written for MS-
  440. DOS in 1987, and simply printed two columns on an Epson FX
  441. printer.  Version 2.0 added options for 3 and 4 columns with both
  442. the Epson and LaserJet printers.  Versions 2.1 through 2.3 added
  443. some other minor options.
  444.  
  445. Version 3.0 is a major update.  A new user interface with a full
  446. screen editor, mouse support, and function keys were added.  You
  447. can now create custom printing options.  Several other minor
  448. additions were also added.
  449.  
  450. Version 3.1 corrected a problem for users who don't have a mouse.
  451.  
  452. F. Disclaimer
  453.  
  454. PRNCOL is provided as is without any warranty, expressed or
  455. implied.  This includes without limitation the fitfulness to a
  456. particular purpose or application and any warranties of
  457. merchantability.  Stephen J. Fox shall not be liable for any
  458. damages, whether direct, indirect, special, or consequential
  459. arising from a failure of this program to operate in a manner
  460. desired by the user.  Stephen J. Fox shall not be liable for any
  461. damage to data or property which may be caused directly or
  462. indirectly by use of this program.  In no event will Stephen J.
  463. Fox be liable to you for any damages, including any lost profits,
  464. lost savings or other incidental or consequential damages arising
  465. out of your use or inability to use this program, or for any
  466. claim by any other party.
  467.