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