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