home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / 2col53.zip / 2COL.DOC < prev    next >
Text File  |  1994-07-19  |  45KB  |  1,062 lines
  1.                                  2col
  2.  
  3.                          Shareware Version 5.3b
  4.  
  5.                       A Compressed Print Utility
  6.  
  7.                           Copyright 1990-1993
  8.                                   by
  9.  
  10.                           ARCaine Technology
  11.                             960 Neilson St
  12.                            Albany, CA 94706
  13.                             (510) 527-9859
  14.  
  15.                           All Rights Reserved
  16.  
  17.  
  18.  
  19.  
  20.   DISCLAIMER
  21.  
  22.   This software and manual are sold "as is" and without warranties
  23.   as to performance or merchantability or any other warranties
  24.   whether expressed or implied. Because of the various hardware and
  25.   software environments into which this program may be put, no
  26.   warranty of fitness for a particular purpose is offered. We will
  27.   not be liable for any special, incidental, consequential, indirect
  28.   or similar damages due to loss of data, inability to use this
  29.   program, or any other reason, even if we or our agent have been
  30.   advised of the possibility of such damages.
  31.  
  32.   Be warned that not all data may print correctly when using this
  33.   program with unconverted wordprocessor files.
  34.  
  35.   The user must assume the entire risk of using and evaluating this
  36.   program. Any liability of Tony Caine or ARCaine Technology will be
  37.   limited exclusively to product replacement or refund of purchase
  38.   price. If you find these terms unacceptable, do not use this
  39.   product.
  40.  
  41.   On every matter relating to this program the user consents to the
  42.   exclusive jurisdiction of the state and federal courts residing
  43.   respectively in Alameda and San Francisco Counties in the state of
  44.   California.
  45.  
  46.  
  47. Introduction
  48.  
  49.   2col prints an ASCII text file in two columns,each up to 80
  50.   characters wide, on standard width paper. It eliminates
  51.   consecutive blank lines and prints at 20 characters/inch.
  52.  
  53.   2col will now optionally print from 1 to 6 columns across the page
  54.   using columns up to 160 characters wide. The maximum number of
  55.   characters which will print across the page is usually limited by
  56.   your printer hardware to 160 or 137 in portrait mode. Wide
  57.   carriage printers and landscape mode printing allow more.
  58.  
  59.   2col now supports Deskjet printers as well as dot matrix printers.
  60.   2col can also print in landscape mode directly on Deskjets and
  61.   with the use of a sideways printing program on other printers. See
  62.   section below on landscape printing. See the insructions for using
  63.   the -J option when running on a Deskjet printer. You must always
  64.   use the -J option with a Deskjet. The registered version of JETCOL
  65.   also supports DJs with added features like variable font pitch.
  66.  
  67.   Bubblejet and inkjet printers are supported in their Epson LQ
  68.   emulation mode. Treat them like a 24 pin dot matrix printer and
  69.   use -Q.
  70.  
  71.   If you have a laser printer, get the companion program, JETCOL.
  72.  
  73.   2col can now print rough drafts of some wordprocessor formats
  74.   including .WRI, Word, Wordstar, and WP-Generic files. See details
  75.   and, particularly, limitations under the Wordwrap option.
  76.  
  77.   2col is designed to be extremely easy to use. The default settings
  78.   will accommodate most printing needs. On most  9-pin printers
  79.   you can print a document by simply typing: 2COL [filename] <enter>
  80.   For example, to print this manual type:2COL 2COL.DOC <enter>
  81.  
  82.   With 24-pin printers you must also include -Q on the command line.
  83.  
  84.   To see an 8 page demonstration of 2COL's many print modes you can
  85.   type: DEMO2COL [9, 24, or J] <enter>. If your printer cannot print
  86.   20 char/in you should include -W68 on the command line. All IBM
  87.   mode printers are 17 cpi and require -W68.
  88.  
  89.   2col is intended to greatly reduce the huge volume of paper that
  90.   results from printing reference manuals and text files. Regular
  91.   use of this program should cut your paper bill by 60 to 70
  92.   percent. It provides excellent readability (unlike other
  93.   compressed print programs) while compressing an average of
  94.   four pages of source material onto one side of a sheet of
  95.   paper. By using its even/odd alternate side print feature eight
  96.   pages of text can be printed using both sides of a page. Since the
  97.   normal draft mode of printing can be used, it is also much faster
  98.   than those programs which rely on nonstandard print modes.
  99.  
  100.   By reducing the volume of paper, 2col also reduces storage
  101.   requirements and the bulk one has to carry around when traveling.
  102.   It can also save you money when faxing or mailing documents.
  103.  
  104.   As a side benefit, many 2col users actually find it easier and
  105.   faster to read the compressed versions than the originals because
  106.   they can take in more words at one time without having to scan
  107.   across the page.
  108.  
  109.   2col will optionally print in subscript mode - doubling the amount
  110.   of text contained on a single sheet to a total of sixteen pages -
  111.   with a significant loss in legibility and printing speed. This
  112.   mode is intended mainly for archival use not for documents that
  113.   will be read frequently.
  114.  
  115.   This program will work on most Epson-compatible dot-matrix
  116.   printers which provide 17 characters/inch compressed printing but
  117.   is especially intended for newer printers which have a
  118.   compressed/elite mode (20 char/in) allowing two complete 80
  119.   character lines to be printed across the page. Printers which
  120.   support 20 char/inch include:KXP1180, KXP1124, FX86, 200GX,
  121.   LQ-series (except LQ1500), etc. If you have a 17 char/inch printer
  122.   you will probably need to use 2COL in word wrap or reformat mode.
  123.  
  124.   Since most printers do not show the 20 char/inch mode on the front
  125.   panel, you should check the manual or just try printing with 2col.
  126.   If your printer supports 20 char/in but does not operate properly
  127.   with 2col, contact me, and I will let you know if it is possible
  128.   to provide you with an updated version that is compatible with
  129.   your printer.
  130.  
  131.   2COL will now work in a limited way with many other printers. See
  132.   the documentation for the -J-2 command. This is a registered
  133.   feature but you can test it using the -K option.
  134.  
  135.   A macro for using 2COL with David Hamel's BOXER text editor is
  136.   now provided.
  137.  
  138.   Malcolm Drury's VIEW which lets you view and print ASCII, WP, WFW,
  139.   AmiPro and WFD files, now has a 2COL interface. See "Registration"
  140.   section below to obtain a copy.
  141.  
  142.   A MS-Windows menu interface is also available. See PRODUCTS.DOC.
  143.  
  144.  
  145. IMPORTANT!
  146.  
  147.   NEVER SELECT A PROPORTIONAL FONT FOR 2COL PRINTING. These fonts
  148.   will cause your columns to become misaligned.
  149.  
  150.   DOT MATRIX:
  151.   The 20 char/in mode on many printers cannot be accessed by
  152.   software if the DIP switches inside the printer are set for IBM
  153.   mode. The printer MUST be set for the Epson/Standard mode. 2col
  154.   will optionally supply the control characters to cause the full
  155.   IBM character set to print. Also, your printer should have the
  156.   auto linefeed switch turned off. If your printer has a front panel
  157.   pitch control, it should be set to program mode. On most printers
  158.   it is okay to set a specific font from the front panel as long as
  159.   the pitch is left in program mode.
  160.  
  161.   Also, be sure that your paper is correctly lined up with your
  162.   printer's top of form according to your printer manual. If your
  163.   paper is misaligned, every page after the first will begin in the
  164.   middle of the sheet when printing with 2COL.
  165.  
  166.   DESKJET:
  167.   If you have previously been printing standard size characters with
  168.   perf skip on, you must push the reset button on your printer
  169.   immediately before printing with 2COL or use the -J1 option.
  170.   Otherwise, the first page will not print correctly. Also, -W68 and
  171.   -W67 may truncate lines on the Deskjet because of its 16.67
  172.   cpi font pitch.
  173.  
  174.  
  175. Hints
  176.  
  177.   Since 24-pin printers tend to print a taller font than 9-pin
  178.   printers, both in subscript mode and standard, it is advisable to
  179.   use fewer lines/page with 24-pin printers to get optimum
  180.   readablity and appearance. The lower the -L value you choose, the
  181.   larger the space between lines.
  182.  
  183.   Since 2COL does not issue any font selection commands, the last
  184.   font selected for your printer will be the one used. Fonts may be
  185.   selected via the printer control panel or by a printer control
  186.   program. At 20 characters/inch the most readable font (and the
  187.   fastest) is usually the standard draft font. Letter quality fonts
  188.   tend to be too "busy" for good compressed printing. Registered
  189.   users can use the -# option to select fonts.
  190.  
  191.   2COL does issue a printer reset when it finishes and if the font
  192.   you selected is not your default font, it may need to be
  193.   reselected before printing again.
  194.  
  195.   You will find it most convenient to use 2COL if you install it in
  196.   a directory which is located in your PATH statement. See your DOS
  197.   manual for more information.
  198.  
  199.   When using a Deskjet you will probably want to use a top margin of
  200.   -F4. Also, try selecting the draft mode on the printer's control
  201.   panel. You may find it adequate for 2COL printing.
  202.  
  203. Registration
  204.  
  205.   This is not freeware or public domain. Shareware is simply a means
  206.   of marketing commercial software. You are required to register if
  207.   you use this program after a 30 day trial period.
  208.  
  209.   I will keep improving the program if I know enough people are
  210.   finding it useful.
  211.  
  212.   My registration policy is very flexible. The nominal fee is $22.95
  213.   US If you don't feel you will get $22.95 worth of use out of 2COL,
  214.   send whatever it is worth to you.
  215.  
  216.   Registered users of older versions of 2COL may upgrade for $10.
  217.   Add $5 more if you want the update disk described below. If you
  218.   did not pay at least $20 originally, include an additional $5 to
  219.   upgrade.
  220.  
  221.   When registering, please tell me the version number you have, your
  222.   printer model, and where you obtained your copy of 2col. This is
  223.   particularly important if you pay less than the full registration
  224.   because the registration code you receive will only cover your
  225.   current version.
  226.  
  227.   Foreign checks are OK. See REGISTER.DOC for details.
  228.  
  229.   2col should be registered for the maximum number of computers that
  230.   will run 2COL at your site. Site fees for commercial users can be
  231.   negotiated.
  232.  
  233.   If you register for the full $22.95 fee,and enclose a Shipping and
  234.   Handling fee of $5 I will send you the latest versions of 2COL and
  235.   JETCOL (for lasers). JETCOL requires a separate registration fee
  236.   if you decide to use it after a trial period. I will also send
  237.   other printing related shareware programs including a word wrap
  238.   program (by another author) which can be used to expand or
  239.   contract the column width of documents before printing. This
  240.   program has more options than 2COL's reformatting. This is
  241.   particularly useful for those with 17 char/inch printers which
  242.   cannot print two full 80 character columns. Also included is VIEW,
  243.   which will let you view and print (with 2COL) ASCII, Ami Pro, WP,
  244.   WFW, and WFD files.
  245.  
  246.   Registering for the full $27.95 also gets you a registration code
  247.   which is guaranteed to work on all new versions of 2COL which are
  248.   released over the next 15 months. A lesser registration provides a
  249.   code only good for the most current version.
  250.  
  251.   If you are a Wordperfect user, for an additional $3 I can supply a
  252.   macro which will print your current document with 2COL without
  253.   leaving WP. A similar macro for WFW is also available.
  254.  
  255.   A "professional" version of 2COL is now available for $55 which
  256.   numbers each line and produces an alphabetized index of words in
  257.   the document, and prints footers. If you don't need indexing, you
  258.   can add $10 to the standard version price to just get line
  259.   numbering and footers. Just specify this on your registration
  260.   form.
  261.  
  262.  
  263. Registered version features
  264.  
  265. * Custom default settings
  266.  
  267.    2COL's default settings can be modified by the user. This
  268.    eliminates the need for the user to enter a string of options
  269.    whenever they run the program. They need only enter the filename.
  270.  
  271.  
  272. * Automargin
  273.  
  274.    The automargin option is extremely useful for those who need to
  275.    punch holes for binding. 2col scans the entire document before
  276.    printing and, in effect, moves all the available "white space"
  277.    from the center (and, if necessary,from the right margin) of the
  278.    document to the left margin. Automargin also automatically
  279.    activates the wordwrap (-&) feature if any line in the document
  280.    is greater than the specified columnwidth (-W).
  281.  
  282.    To get an idea of how Automargin operates, type: 2COL 2COL.DOC
  283.    <enter>. This will print with the default settings of 2col. Then
  284.    type: 2COL 2COL.DOC -K -U8 <enter>. This will print a one page
  285.    demo using automargin.
  286.  
  287.  
  288. * Multiple document names
  289.  
  290.    Multiple document names and wildcards can be entered on the
  291.    command line.
  292.  
  293.  
  294. * Append
  295.  
  296.    When specifying multiple documents to print, registered users
  297.    have the choice of starting each file at the beginning of a page
  298.    or treating all documents as one continuous file without breaks.
  299.  
  300.  
  301. * Redirection of output
  302.  
  303.    Registered users can choose to send the output to a disk file for
  304.    later printing in background (while running other programs) or
  305.    they can send to LPT2, COM1, COM2, etc.
  306.  
  307.  
  308. * Pagefix
  309.  
  310.    Prints a specified number of pages per column retaining original
  311.    line spacing and page breaks.
  312.  
  313.  
  314. * Pagelength adjustment for different paper sizes: A4, legal, etc.
  315.  
  316.  
  317. * Elimination of printer control commands for operation with non-
  318.   standard printers.
  319.  
  320. * User specified printer initialization strings.
  321.  
  322. * Document reformatting
  323.  
  324.   Expand or contract the line width of your document for better
  325.   readablity or more efficient use of page space. Particularly
  326.   useful if you have a 17cpi printer or have trouble reading 20 cpi.
  327.  
  328.  
  329. * The registration screen is eliminated, of course.
  330.  
  331.  
  332.  
  333. Terminology
  334.  
  335.   Since several pages from the original source file are combined
  336.   onto a single page of printer output, there may be some confusion
  337.   about the word "page." We will always refer to the original
  338.   document pages as "source pages." What is actually printed will
  339.   simply be called "pages."
  340.  
  341.  
  342.  
  343. Usage:
  344.  
  345.   2col  [options] path\filename [options] [path\filename]...
  346.  
  347.  
  348.   Options (except -Yx) may be specified in any order before and/or
  349.   after the file name(s). Options MUST be separated from each other
  350.   by spaces and preceded by a "-". Upper and lower case are
  351.   interchangeable.
  352.  
  353.  
  354.  
  355.  
  356.   Options are defined as follows:
  357.  
  358.    -Lxx = Each column will be xx lines long
  359.    -Cxx = No more than xx consecutive blank lines will be printed
  360.    -Sxx = Skip xx pages before starting to print
  361.    -O   = Print only odd # pages
  362.    -E   = Print only even # pages
  363.    -Wxx = column width (number of characters in each column)
  364.    -P   = Pause before printing each page.
  365.    -N   = Prints filename and page # at lower left corner
  366.    -Dxx = Delimit each (source) page with a line and page #
  367.    -T   = Truncate long lines instead of wrap.
  368.    -G   = Enable full IBM character set.(dot matrix only)
  369.    -Fx  = Put a margin of x blank lines at the top of each page.
  370.    -K   = Print a one page demo to test registered options.
  371.  * -Mx  = Set left margin.(CAUTION:READ INSTRUCTIONS BEFORE USING)*
  372.    -?   = 2COL will ask for filenames to print.
  373.    -Q   = 24-pin printer line spacing
  374.    -Jx  = Deskjet mode
  375.    -V   = Report # pages to print.Modify spacing to fill last page
  376.    -&xx = Wordwrap long lines. (useful for .WRI and similar files)
  377.    ?    = (no dash) Displays help screen. Must be the only option.
  378.    -@x  = Print All, Even, or Odd in reversed order.
  379.    -$x  = Number of columns to print (1-6)
  380.  
  381.                 *Options for registered users only*
  382.  
  383.    -A   = Append multiple files.
  384.    -Bxx = Force a different font size.
  385.    -Z   = Route output to disk or port.
  386.    -Ux  = Scans file before printing and sets margins automatically.
  387.    -Xx  = Print x pages/column preserving page breaks & format
  388.    -Yx  = Customize 2COL default settings.
  389.    -!xx = Modify line spacing to adjust for pagefill or pagelength.
  390.    -J-2 = Eliminate printer control commands
  391.    -&Rxx= Reformat document to width of xx characters
  392.    -#   = User specified printer init string (fonts,landscape,etc)
  393.  
  394.   When more than 102 lines/page requested,shifts to subscript
  395.   (half-height) mode. When columns*width is less than 137 chars,uses
  396.   compressed mode (17 char/in.) When columns*width is greater than
  397.   136 uses compressed/elite (20 char/in.)
  398.  
  399.   Defaults: 80 characters/column;88 lines/page;1 consecutive blank
  400.            line; no pause before printing page; do not number pages;
  401.            wrap (not truncate) long lines;0 blank lines at top of
  402.            page.
  403.  
  404.  
  405. Description of options
  406.  
  407.     ?
  408.  
  409.       2COL ? <enter> or 2COL <enter> will display a help screen.
  410.  
  411.  
  412.    -K
  413.  
  414.       Putting -K on the command line activates any registered
  415.       feature (except multiple files printing) for a one page demo.
  416.  
  417.  
  418.    -Lxxx
  419.  
  420.       Each column will contain xxx lines of data. Line spacing will
  421.       be automatically adjusted to approximately fill the page.
  422.       Characters will be normal (pica) height until more than 102
  423.       lines/column are specified; printer will then shift to
  424.       subscript mode allowing up to 220 lines/column. Default value
  425.       is 88. A lower -L value gives more white space between lines.
  426.  
  427.  
  428.     -Cxx
  429.  
  430.       Pages of text frequently contain many blank lines of data.
  431.       Experience has shown that most of these can be discarded
  432.       without sacrificing readability. This option specifies that
  433.       when there are more than xx consecutive blank lines, the
  434.       excess will be discarded. If you set xx=66, 2col will print
  435.       each page in its original format without discarding any blank
  436.       lines. The default value is 1.
  437.  
  438.  
  439.     -Sxx
  440.  
  441.       This feature is useful if you have a paper jam or decide to
  442.       print part now and part later. Using this option will cause xx
  443.       pages to be skipped before printing begins. For example,
  444.       specifying "-S2" will cause printing to begin with page 3.
  445.       When using the -O or -E option remember to count all pages -
  446.       odd and even.
  447.  
  448.  
  449.     -O
  450.  
  451.       This and the -E option allow you to print on both sides of
  452.       each sheet of paper. By specifying "-O", only the odd numbered
  453.       pages will be printed. When printing is complete,reload the
  454.       first page back into the printer with the blank side facing
  455.       the print head and rerun 2col using the -E option.
  456.  
  457.       Alternatively, 2COL will ask you whether you want to print the
  458.       even pages after it has finished printing the odd. Respond "Y"
  459.       after the paper has been reloaded or type "N" to terminate.
  460.  
  461.     -E
  462.  
  463.       Prints only even numbered pages. When using this option after
  464.       the -O option be sure to shift the paper about 1/2 inch to the
  465.       right before starting to print, to allow space for hole
  466.       punching or other binding requirements.
  467.  
  468.       2COL will ask you if you want to print the odd pages after you
  469.       have printed the even pages.
  470.  
  471.     -Wxx
  472.  
  473.       This option specifies how wide each column will be. Wrapping
  474.       or truncating will begin at this position. Unless the wordwrap
  475.       option (-&xx) is chosen, wrapping will occur in mid-word. It
  476.       also determines the print density. If xx * columns is 136 or
  477.       less, the printer will use compressed mode (137 characters
  478.       across the page). If xx * columns is greater than 136 the
  479.       printer will use compressed/elite (160 characters/line). If
  480.       your printer does not support compressed/elite and you try to
  481.       use it, you will end up with a mess. You should then specify
  482.       xx as 68 and decide whether you want to truncate long lines or
  483.       wrap them. You might want to reformat the document with a
  484.       shareware word wrapping program.I can supply one when you
  485.       register. See the "registration" section of this document for
  486.       details.
  487.  
  488.       Due to printer limitations there is no space between columns
  489.       when a column width of 80 is specified. When a width less than
  490.       80 is requested, one space is inserted between columns.
  491.  
  492.     -P
  493.  
  494.       Program will pause before printing each page. Hit any key to
  495.       print a page. This option is useful if you are feeding single
  496.       sheets to the printer.
  497.  
  498.  
  499.     -Nx
  500.  
  501.       This will cause the filename,page and/or date to be printed in
  502.       the lower left-hand corner of each sheet. To avoid confusion
  503.       when using the -S, -O and -E options the page numbering is not
  504.       reset for each document when multiple documents are specified
  505.       on the command line(registered version only).
  506.  
  507.       If x=blank the filename and page number will print
  508.       If x=1 the page number will print.
  509.       If x=2 the current date will print.
  510.       If x=64 the filename will print.
  511.  
  512.       These x values may be added together to achieve any
  513.       combination of the above. For example if x=67 all three
  514.       options (page number, filename, and date) will print
  515.  
  516.  
  517.     -Dxx
  518.  
  519.       If you need to keep track of each source page, this option
  520.       will print a dashed line with a page number in the middle
  521.       whenever a form feed is encountered or after xx lines of data.
  522.       If no xx value is specified 66 lines/page is assumed. Thus
  523.       -D66 is the same as -D. Experience has shown that this option
  524.       will be rarely used because most documents either number their
  525.       own pages or it is just not important to keep track of
  526.       original page breaks.
  527.  
  528.  
  529.     -T
  530.  
  531.       Normally when lines longer than the specified column width are
  532.       encountered, 2col will wrap the data to the next line. If you
  533.       prefer to truncate or discard excess characters on a line, you
  534.       should invoke this option.
  535.  
  536.  
  537.  
  538.     -G
  539.  
  540.       Sends control codes to enable full IBM graphics set (ASCII
  541.       128-255). The graphics set includes line drawing characters
  542.       and foreign alphabets. This function is not for DeskJet.
  543.  
  544.  
  545.  
  546.  
  547.     -Fx
  548.  
  549.       2col will insert x blank lines at the top of each page before
  550.       printing. The default is 0.
  551.  
  552.  
  553.     -Mx
  554.  
  555.       CAUTION: IMPROPER USE OF THIS OPTION WILL CAUSE YOUR PRINTER
  556.       TO PRINT PAST THE BOTTOM OF THE PAGE.
  557.  
  558.       This command sets the left margin x spaces from the edge of
  559.       the page. Default is 0. Use this option with caution! Most
  560.       standard width printers only have 160 print positions across
  561.       the page. If you insert spaces with a margin command, the
  562.       printer will wrap characters that go past the 160th print
  563.       position to the left side of the page, causing  extra lines
  564.       to be inserted. If you use a left margin of 5, for example,
  565.       you might have to set the column width to -W77 to prevent
  566.       wraparound (this is only necessary if printable characters
  567.       would be pushed past the 160th column- blanks don't matter).
  568.  
  569.       The easiest way to achieve a left margin without having to
  570.       worry about characters wrapping is to use the Automargin
  571.       option (-Ux) described below.
  572.  
  573.       Given the limitations of standard width printers, it is
  574.       suggested that you permanently shift your paper several spaces
  575.       to the left. You can adjust your word processor margin
  576.       settings to compensate, so that normal printing will be
  577.       unaffected.
  578.  
  579.  
  580.     -K
  581.  
  582.       Including this option on the command line allows any
  583.       registered option listed below to be used, but only for a
  584.       one page demo. This option allows you to explore the
  585.       options available to registered users.
  586.  
  587.  
  588.     -?
  589.  
  590.       Instructs 2COL to ask for files to print once it is running.
  591.       You can specify files both on the command line and when 2COL
  592.       asks for filenames. Separate the file names with spaces. This
  593.       option is useful when 2COL is run from a menu or a Windows
  594.       icon.
  595.  
  596.  
  597.     -Q
  598.  
  599.       Adjusts line spacing for 24-pin printers. If you have a 24-pin
  600.       printer and do not use this option, pages will print too long.
  601.  
  602.     -Jx
  603.  
  604.       Use this option whenever you are using a Deskjet printer.
  605.  
  606.       If x=0 or blank, 2col will not eject a page before printing.
  607.       You can use this option if you have just printed with 2COL or
  608.       if perf skip was not activated. If you have previously been
  609.       printing with perf skip on, you must either push the reset
  610.       button on the printer before running 2col or use -J1.
  611.  
  612.       See discussion for the "-@" option below for deskjet printing.
  613.  
  614.       The switch point for a wider font is 132 characters across the
  615.       page not 137 because the deskjet uses a 16.67 font pitch
  616.       instead of the standard 17 cpi.
  617.  
  618.     -V
  619.  
  620.       This option prescans the document and tells you how many pages
  621.       (odd+even) will print. If you are printing only odd or even,
  622.       you must divide by two.
  623.  
  624.       If the last page is only partially filled you will be given
  625.       the option to compress the line spacing to eliminate the
  626.       partial page or increase the spacing to fill it. "C"
  627.       compresses the lines. "E" expands the lines. "N" preserves
  628.       the original spacing.
  629.  
  630.       If you are printing multiple documents without the Append (-A)
  631.       option or using the fiXpage (-X) option, you will not be able
  632.       to modify the line spacing.
  633.  
  634.       You can also enter a percentage value with the -V option. For
  635.       example, entering -V35 will cause final pages which are more
  636.       than 35% filled to be Expanded to fill the page and final
  637.       pages less than 35% filled to be Compressed to eliminate the
  638.       page. You can specify from -V1 to -V99. All prompts are
  639.       bypassed in this mode.
  640.  
  641.       Note: It is impossible to always adjust the spacing to exactly
  642.             fill the page. 2COL will come as close as possible.
  643.  
  644.     -&xx
  645.  
  646.       Wordwrap lines to a maximum of xx characters. When this option
  647.       is off (default) 2COL will wrap in mid word.
  648.  
  649.       This wordwrap feature is intended for printing some word
  650.       processor documents (such as .WRI,and WP Generic) where
  651.       carriage return/ linefeeds occur only at the end of
  652.       paragraphs. The current implementation is not intended to
  653.       reformat a document to increase the length of lines which have
  654.       CR/LFs at the end. When in filter mode (see below), wordwrap
  655.       will also print Wordstar documents.
  656.  
  657.       Some wordprocessor programs imbed non-ASCII graphics and other
  658.       control information in their files. The wordwrap feature
  659.       normally eliminates ASCII characters outside of the range
  660.       32-126. This will greatly reduce but not eliminate "garbage"
  661.       when printing these files. WRI files, for example, have
  662.       graphics at the end and you will almost always see at least a
  663.       few lines of garbage when printing unconverted .WRI files. If
  664.       the -G (graphics) option is invoked on the command line ALL
  665.       FILTERING WILL BE DISABLED and all characters ASCII 1-255 will
  666.       be passed to the printer. Filter mode also deletes any line
  667.       beginning with a period ".". This is for printing Wordstar
  668.       documents.
  669.  
  670.       Automargin will automatically activate wordwrap when it sees
  671.       long lines. Since Wordwrap filters out IBM graphics characters
  672.       unless the -G option is specified, it is not advisable to
  673.       leave it enabled all the time as a command line option. Invoke
  674.       it when you need it or let automargin handle it. You can
  675.       prevent Automargin from activating wordwrap by including -&-
  676.       on the command line.
  677.  
  678.       IMPORTANT: Information which has been encoded in non-ASCII
  679.       graphics format will not print in any readable form and will
  680.       be lost. If an EOF (Control-Z) is embedded in the data,
  681.       printing will stop at this point.Further data past an EOF will
  682.       not print.
  683.  
  684.       Wordwrap is intended mainly as a convenience to provide an
  685.       approximation of word processor documents. If you require
  686.       perfect reproduction of the original document, you MUST first
  687.       convert the document to pure ASCII before printing with 2COL.
  688.  
  689.     -@x
  690.  
  691.       This option causes pages to print in reverse order. -@A causes
  692.       all pages to print in reverse. -@E causes even pages only to
  693.       print in reverse. -@O causes only odd pages to be reversed.
  694.  
  695.       The purpose of this option is to eliminate paper shuffling
  696.       with Deskjets,Inkjets or other printers with cut sheet
  697.       feeders. Each printer model has its own paperfeed
  698.       characteristics and you will need to experiment for the
  699.       correct combination of -O, -E and -@ options that work best
  700.       for you.
  701.  
  702.       When printing one-sided on a Deskjet use "-@A" to have the
  703.       pages come out in normal reading order. For two-sided printing
  704.       with a DJ use options "-e" and "-@o" together on the command
  705.       line. When the even pages have been printed take all the pages
  706.       that come out and put them printed side up back into the
  707.       hopper and press "Y" to print the odd pages. The resulting
  708.       stack will have page one on top when printing is complete.
  709.  
  710.       When you are printing even pages in reverse with a document
  711.       which has an odd number of pages 2COL will eject a blank page
  712.       to compensate for the blank end page. You must include this
  713.       blank sheet when feeding pages back into the printer to
  714.       print the reverse side.
  715.  
  716.       The maximum number of reversed pages for one print job is
  717.       limited to 300 or the maximum free disk space, whichever is
  718.       smaller.
  719.  
  720.     -$x
  721.  
  722.       This option selects the number of columns to print across the
  723.       page. You can specify from 1 to 6. When you select multiple
  724.       columns be sure that the number of columns times the column
  725.       width does not exceed your printer's capability for maximum
  726.       number of characters which can print across one line. When
  727.       calculating, remember that 2COL inserts a blank between
  728.       columns except when a column width of 80 is selected. For
  729.       example, if you choose three column printing -$3, you should
  730.       also specify -W52 when printing 20cpi on standard paper.
  731.  
  732.       This option is useful when printing lists of names or labels.
  733.       It is also useful for landscape mode printing and wide
  734.       carriage printers. Registered users should try combining this
  735.       option with the text width reformatting feature -&Rxx.
  736.  
  737.       When combined with the -Z and -J-2 options 2COL can be used to
  738.       format single column ASCII files into multi-column lists.
  739.  
  740.  
  741.       ***Options below are only in the registered version of 2col***
  742.                 (Use the -K option to test these features)
  743.  
  744.  
  745.     -Yx
  746.  
  747.       The -Y option allows you to modify 2COL's default settings.
  748.       This MUST always be the first option on the command line
  749.       whenever you use it.
  750.  
  751.       Typing "2COL -Y1 <enter>" will cause 2COL to display all
  752.       current default settings.
  753.  
  754.       Typing "2COL -Y2 [options....] <enter>" will cause 2COL to
  755.       permanently remember those options by modifying the 2COL.EXE
  756.       program itself. Your personal registration code MUST always be
  757.       one of the options specified whenever you modify the default
  758.       settings. Whenever the -Y2 option is used, any options not
  759.       specified on the command line will be reset to the standard
  760.       defaults. Therefore, even if you change only one of your
  761.       custom options, you must reenter them all at the same time.
  762.       The next time you run 2COL the options you specified will
  763.       automatically be used.
  764.  
  765.       For example, if you want to set the number of lines/page to
  766.       102 and print the page numbers at the bottom, you would type:
  767.       2COL -Y2 -L102 -N registration code# <enter>. The next time
  768.       you type 2COL [filename] <enter> It would be as though you had
  769.       typed: 2COL -L102 -N registration code [filename].
  770.  
  771.       If there are several different option profiles you wish to
  772.       use, you can create different copies of 2COL.EXE with
  773.       different names, such as 2COL1.EXE, 2COL2.EXE, etc. The -Y2
  774.       option only modifies the EXE file having the same name and
  775.       path that you type on the command line.
  776.  
  777.       All defaults with an 'x' value can be temporarily overridden
  778.       with a different value on the commmand line. Use an 'x' value
  779.       of 0 to temporarily deactivate Automargin or Pagefix. Any
  780.       option without an 'x' value can be activated by simply putting
  781.       it on the command line. To temporarily deactivate an option
  782.       set as a permanent default, type a minus after the option. For
  783.       example, to temporarily deactivate the N option, you would put
  784.       -N- on the command line: 2COL -N- [filename]
  785.  
  786.       THIS FUNCTION WILL NOT WORK ON .EXE FILES THAT HAVE BEEN
  787.       COMPRESSED WITH PKLITE. You must first decompress, use the -Y2
  788.       option and then recompress.
  789.  
  790.  
  791.     -A
  792.  
  793.       When multiple files are specified on the command line
  794.       (registered version only) you have the option of either
  795.       starting a new page for each file (default) or appending them
  796.       as though they were one continuous file. The -A option causes
  797.       them to be appended.
  798.  
  799.  
  800.     -Bxx
  801.  
  802.       Normally the switch point for font size change is 102
  803.       lines/page. The -B option lets you specify a different value.
  804.  
  805.  
  806.     -Ux
  807.  
  808.       The aUtomargin function allows you to obtain as much margin as
  809.       possible according to the width of the document. 2col scans
  810.       the entire document before printing and adjusts the column
  811.       width to gain as much space on the print line as possible.
  812.       The space obtained is allocated to the left margin until the x
  813.       value you entered is reached. The remaining space, if any, is
  814.       then added to the right margin. If your document has a maximum
  815.       line width of 80 or greater, 2COL will be unable to give you
  816.       any margin at all because of printer limitations.
  817.  
  818.       If you have specified the -E option (to print on the reverse
  819.       side of the page), the first available space is used to create
  820.       a right margin (for binding) rather than a left margin.
  821.  
  822.       Automargin automatically turns on the wordwrap feature (-&)
  823.       whenver lines longer than the columnwidth (-W) are encountered
  824.       in a document and the truncate (-T) option is off. If you do
  825.       NOT want wordwrap activated automatically include -&- on the
  826.       command line. This is safer than truncating lines.
  827.  
  828.       If wordwrap (-&xx) or reformat (-&Rxx) has been specified on
  829.       the command line (or as a default setting) automargin will
  830.       assume a document width equal to the wordwrap value if xx
  831.       is less than the actual document width and will always assume
  832.       a document width equal to the reformat xx value regardless of
  833.       the actual document width.
  834.  
  835.     -Zfilename
  836.  
  837.       Allows output to be routed to a file instead of to the
  838.       printer. The file can then be printed in background while
  839.       running other programs. For example, to send output to a file
  840.       called PRINT.TXT, you should include -ZPRINT.TXT on the
  841.       command line.If PRINT.TXT does not exist, it will be created.
  842.       If PRINT.TXT already exists, 2col output will be appended to
  843.       the end of the file. This command is only active in the
  844.       registered version of 2col. This option can also be used to
  845.       redirect output to LPT2, COM1, COM2, etc.
  846.  
  847.  
  848.     -Xx
  849.  
  850.       Prints exactly x pages in each column preserving original page
  851.       breaks and not suppressing consecutive blank lines. Thus the
  852.       original page formatting is maintained. Allowed range of x
  853.       is 1-3. A page length of 66 is assumed unless modified with
  854.       the -D option.
  855.                        -X option page formats:
  856.  
  857.              x=1                x=2             x=3
  858.  
  859.            111 222            111 333         111 444
  860.            111 222            111 333         111 444
  861.            111 222            111 333
  862.            111 222                            222 555
  863.            111 222                            222 555
  864.            111 222            222 444
  865.            111 222            222 444         333 666
  866.            111 222            222 444         333 666
  867.  
  868.  
  869.     -&Rxx[,tt]
  870.  
  871.       Reformats document to a width of xx and eliminates leading
  872.       blanks. It attempts (but is not always successful) to identify
  873.       tables and headers and avoids reformatting them.
  874.  
  875.       This feature is useful if you have a document which is
  876.       relatively narrow and would like to make more efficient use of
  877.       page space. It can also be used to narrow the columns to allow
  878.       room for a larger left margin. It is also useful if you have a
  879.       document which is too wide to print with a 17cpi printer and
  880.       you wish to reduce it to a width of 68 or less.
  881.  
  882.       A default trigger point of 57 characters is used to determine
  883.       whether a line should be wrapped or left alone. You can modify
  884.       the trigger point to any value you wish by entering the
  885.       optional tt value.
  886.  
  887.       For example, if you want to reformat a document to a width of
  888.       78 characters and use the default trigger you would use -&R78
  889.       on the comand line.If you additionally want to set the trigger
  890.       to wrap lines of width 50 or greater use -&R78,50 on the
  891.       command line.
  892.  
  893.       Unregistered users may test the reformat feature with the -K
  894.       one page demo option.
  895.  
  896.  
  897.  
  898.     -!xx
  899.  
  900.       Modifies line spacing so you can fill non-standard size paper.
  901.       This would include legal or European paper. This option also
  902.       allows you to finetune the pagefill amount of standard paper.
  903.       Entering a positive value expands the spacing between lines. A
  904.       negative value decreases spacing between lines. Although it
  905.       depends on the printer, you should find that values in the
  906.       25-500 range will usually do the job. This option does not
  907.       affect the printer's forms length adjustment. If you change
  908.       paper you must modify the forms length setting before running
  909.       2COL.
  910.  
  911.  
  912.     -J-2
  913.  
  914.      Eliminates printer control commands. If you have a printer
  915.      which has a non-standard command set, you can create your own
  916.      command string to set up your printer,  put it into a batch
  917.      file and run it before running 2COL. 2COL will not send out any
  918.      commands which could interfere with your manual setup. 2COL can
  919.      be made to work with many printers this way, including Diablo
  920.      630, most IBM's, etc. 2COL's margin setting commands will not
  921.      work in this mode. You would need to preset the margin as part
  922.      of your setup string. Unregistered users can test this mode
  923.      by using the demo (-K) option.
  924.  
  925.      You can also use this option to send output to a file for
  926.      printing with sideways (landscape) print programs.
  927.  
  928.      Finally, you can use this option to create a 4 column format.
  929.      Type:2COL Filename -J-2 -ztemp -&39 -w39. Then:2COL temp
  930.  
  931.  
  932.     -#x1,x2,x3,x4....,x29
  933.  
  934.      Allows user to specify a string of up to 29 bytes to be sent to
  935.      the printer before 2COL has sends its commands. This allows the
  936.      user to select draft/LQ printing, a specific font, etc. If the
  937.      -J-2 command above has been invoked, only the user's -#
  938.      specified characters will go to the printer and none generated
  939.      by 2COL. See section below for landscape printing info.
  940.  
  941.      The data is specified as decimal numbers separated by commas.
  942.      For example, if your ribbon is getting weak and you want to
  943.      use emphasized printing with ESC E you would specify -#27,69 on
  944.      the command line. You must not include any spaces within this
  945.      command!
  946.  
  947.      Unpredictable results will occur if you specify commands that
  948.      conflict with 2COL's. Also 2COL does normally send a margin set
  949.      command at the beginning of every page and the user will be
  950.      unable to specify a margin with this option except when using
  951.      -J-2.
  952.  
  953.  
  954. Examples:
  955.  
  956. 2COL 2COL.DOC -L102 <enter>  will print 102 lines/column
  957.  
  958. 2COL 2COL.DOC -L102 -N will print 102 lines/column and number pages.
  959.  
  960. 2COL 2COL.DOC -G -N  will number pages and enable IBM graphics set.
  961.  
  962.  
  963.  
  964.  
  965. Using 2COL with a word processor
  966.  
  967.     The wordwrap feature (-&) provides a convenient, but not always
  968.     perfect,way of printing many wordprocessor files(such as .WRI)
  969.     In those cases where you cannot get a satisfactory printout
  970.     directly from a document in its original form, most word
  971.     processors have what is called an ASCII output or DOS output
  972.     mode which 2COL will work with. If you are given a choice, it is
  973.     usually best to convert without line breaks and use 2COL's
  974.     wordwrap feature.
  975.  
  976.     I can supply WP and WFW macros which will allow you to print
  977.     with 2COL, without leaving WP or WFW. You can print the document
  978.     you are editing, with a single keystroke. See the registration
  979.     section.
  980.  
  981.     I also supply to registered users conversion programs which may
  982.     help you print other word processor formats with 2COL.
  983.  
  984.  
  985. Using 2COL with Microsoft Windows
  986.  
  987.  
  988.     A Windows interface is now available which allows selecting
  989.     files from a menu and editing/excerpting text as well as
  990.     printing from the clipboard. Files to be printed can be dragged
  991.     and dropped from File Manager. It also allows printing in
  992.     background with 2COL. A large selection of custom printing
  993.     option profiles can be maintained. See PRODUCTS.DOC for details.
  994.  
  995. Landscape printing with 2COL
  996.  
  997.     2COL will do landscape printing on printers which have a
  998.     landscape mode. Suggested settings for the Deskjet are:
  999.  
  1000.     2COL path\filename -#27,38,108,49,79 -!-120 -L75 -W100 -J1
  1001.  
  1002.     also try:
  1003.  
  1004.     2COL path\filename -#27,38,108,49,79 -!-120 -L105 -W100 -J1
  1005.  
  1006.     Some of these options are for registered users, but you can
  1007.     test them by adding -K to the command line.
  1008.  
  1009.     Printers which do not have a landscape mode can print in
  1010.     landscape with 2COL by sending output to a file and then
  1011.     printing with a sideways printing program. Use the -J-2 option
  1012.     to eliminate printer control characters from the output file. I
  1013.     will supply a shareware sideways printing program on your
  1014.     registration disk if you request it.
  1015.  
  1016.     If you develop landscape settings for your own model printer,
  1017.     please pass them along to me. Thanks.
  1018.  
  1019.  
  1020. Program Abort
  1021.  
  1022.     Hitting Control-C (or Control-Break) will terminate the program
  1023.     immediately. The printer will not stop printing, however, until
  1024.     its buffer is empty.
  1025.  
  1026.  
  1027. Support
  1028.  
  1029.     I will be glad to answer questions for registered and to a more
  1030.     limited extent for unregistered users. SUPPORT IS ONLY BY
  1031.     TELEPHONE (except for foreign users.) Non-foreign users should
  1032.     send letters only after a telephone discussion indicates that
  1033.     hard copy is needed. It is much faster to work out problems over
  1034.     the phone. Call 510-527-9859 from 9am to 8pm Pacific Time.
  1035.  
  1036.  
  1037. Distribution
  1038.  
  1039.     Permission is hereby given to copy and distribute this program
  1040.     as long as no more than $10 is charged. It must be made clear to
  1041.     the buyer that this is only a handling charge and not a
  1042.     registration fee. You must include all files in their original
  1043.     unmodified form when distributing this program. Catalog, rack
  1044.     and CD-ROM vendors must either read VENDOR.DOC for additional
  1045.     details or contact the author before distributing 2COL.
  1046.  
  1047.     Permission to distribute may be revoked by the author at any
  1048.     time for any reason.
  1049.  
  1050.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  1051.     A REGISTRATION CODE. A program can be unbranded by typing
  1052.     2COL -Y2 <enter>.
  1053.  
  1054.  
  1055. All trademarks used in this document are the property of their
  1056. owners.
  1057.  
  1058.                                                      -Tony Caine-
  1059.  
  1060. Internet:   72614.1451@compuserve.com
  1061. Compuserve: 72614,1451
  1062.