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