home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / LASER / MW_LASER.ZIP / MW-LASER.DOC next >
Encoding:
Text File  |  1990-09-08  |  14.6 KB  |  420 lines
  1.                                                                         page  1
  2.                                                                      Magic*Ware
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                        MW-LASER Version 2.1
  11.  
  12.        A utility to print files 2-up on an HP LaserJet series II
  13.  
  14.  
  15.                       ┌─────────────────────────┐
  16.                       │       Magic*Ware        │
  17.                       │   by Peter van Sluis    │
  18.                       │                         │
  19.                       │ 1498 So. Blaney Ave.    │
  20.                       │ Suite 301               │
  21.                       │ San Jose, CA 95129-3710 │
  22.                       │ (408) 255-3208          │
  23.                       └─────────────────────────┘
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.          Contents:
  35.  
  36.          Introduction ...................................... 2
  37.          Use ............................................... 3
  38.          Environment variable .............................. 6
  39.          System requirements/Technical information ......... 7
  40.          Legal statement ................................... 8
  41.          Other Magic*Ware utilities ........................ 9
  42.          Shareware note ................................... 10
  43.          Registration form ................................ 11
  44.  
  45.  
  46.  
  47.       Copyright (c) 1990 by Peter van Sluis - All rights Reserved
  48.       Copyright (c) 1990 by Magic*Ware      - All rights Reserved
  49.  
  50.  
  51.                                                                         page  2
  52.                                                                      Magic*Ware
  53.  
  54.    Introduction
  55.    ------------
  56.  
  57.    MW-LASER is a program that allows you to print ASCII text files 2-up
  58.    on an HP LaserJet series II (or any other printer that accepts PCL
  59.    commands and supports line printer font in landscape mode).
  60.  
  61.    Features of this utility are:
  62.  
  63.         - Possible to print multiple files (including wildcards)
  64.         - Wrap or truncate lines longer than 82 characters
  65.         - Indicate whicht lines are wrapped or truncated
  66.         - Display a warning when truncating or wrapping lines
  67.         - Print the file name above each page
  68.         - Print page numbers
  69.         - Print date and time
  70.         - Display percentage printed
  71.         - Print line numbers
  72.         - Print compressed mode
  73.         - Print to a file instead of to the printer
  74.         - Invoke PRINT.COM at the end of the program
  75.         - Use alternative form feed triggers (like '$page')
  76.         - Print a footnote under each page
  77.  
  78.    All these features can be requested or disabled using command line
  79.    switches, and/or an environment variable. Detailed instructions are
  80.    described below.
  81.  
  82.  
  83.                                                                         page  3
  84.                                                                      Magic*Ware
  85.  
  86.    Use
  87.    ---
  88.  
  89.    The format of the command is:
  90.  
  91.          MW-LASER filespec [filespec...] [/switch...]
  92.  
  93.    One or more filespecs can be entered at the command line. When
  94.    wildcards are used, the filespec will be expanded.
  95.    An example:
  96.  
  97.       MW-LASER d:\sub1\*.c demo.asm /a:$page /f:com2 /w+ /d-
  98.  
  99.  
  100.    The switches are (all input is case-independent):
  101.  
  102.  
  103.          /w or /w+     Lines longer than 82 characters will be wrapped.
  104.  
  105.          /w-           Lines longer than 82 characters will be truncated
  106.                        (default).
  107.  
  108.  
  109.          /~ or /~+     Print a tilde in column 83 when lines are wrapped
  110.                        or truncated (default).
  111.  
  112.          /~-           Do not print the tilde.
  113.  
  114.  
  115.          /q or /q+     Quiet mode. Do not display a warning when one or more
  116.                        lines are truncated or wrapped.
  117.  
  118.          /q-           Display the warnings (default).
  119.  
  120.  
  121.          /n or /n+     Print the name of the file above each logical page
  122.                        (default).
  123.  
  124.          /n-           Do not print the name of the file.
  125.  
  126.  
  127.          /p or /p+     Print page numbers (default).
  128.  
  129.                        Note : When you are printing page numbers, and
  130.                        the last logical page is printed on the right
  131.                        column, the word 'last' appears in front of the
  132.                        page number so you are sure that there are no
  133.                        more pages.
  134.  
  135.          /p-           Do not print page numbers.
  136.  
  137.  
  138.          /u or /u+     Print the page numbers underneath each page.
  139.  
  140.          /u-           Print the page numbers above each page (default).
  141.  
  142.  
  143.                                                                         page  4
  144.                                                                      Magic*Ware
  145.  
  146.  
  147.          /d or /d+     Print the date and time above each page (default).
  148.  
  149.                        Note: the time is printed in 24 hour format.
  150.  
  151.          /d-           Do not print the date and time.
  152.  
  153.  
  154.          /% or /%+     Display percentage done (default).
  155.  
  156.          /%-           Do not display percentage done.
  157.  
  158.  
  159.          /i or /i+     Print the index numbers (line numbers in the file
  160.                        that is printed) at the top of each logical page.
  161.                        Only the first line number per page will be printed;
  162.                        this will give an 'index' into the file.
  163.  
  164.          /i-           Do not print the index numbers (default).
  165.  
  166.  
  167.          /c or /c+     Print in compressed mode. Form feeds in the file
  168.                        will not trigger a new logical page, but a
  169.                        horizontal line will indicate a new page.
  170.  
  171.                        Note : Setting this mode on will disable printing
  172.                        the page numbers (/p)
  173.  
  174.          /c-           Do not print compressed (default).
  175.  
  176.  
  177.          /b or /b+     Invoke batch printing. All files will be printed
  178.                        to file MW-LASER.PRN (or the filename as
  179.                        specified with switch /f). At the end of the
  180.                        program PRINT.COM will be called to print that
  181.                        file. Two conditions must exist: You must run
  182.                        under DOS version 3.0 or higher, and PRINT.COM
  183.                        must already be loaded in memory prior to using
  184.                        MW-LASER with switch /b.
  185.  
  186.                        Note : When using switch /b, an extra blank page
  187.                        will be printed at the end of the output.
  188.  
  189.          /b-           Do not invoke batch printing (default).
  190.  
  191.  
  192.          /f:xxx        Print to file xxx (default is device PRN).
  193.  
  194.  
  195.          /a:xxxxx      Use 'xxxxx' as a form feed indicator. By default,
  196.                        MW-LASER starts a new logical page each time
  197.                        character 12 is found. With the /a switch, you can
  198.                        add another form feed trigger (like /a:$page).
  199.  
  200.          /e or /e+     The alternative form feeds string will be printed
  201.                        at the end of each page (default).
  202.  
  203.          /e-           The alternative form feeds string will be printed
  204.                        at the top of the next page.
  205.  
  206.  
  207.                                                                         page  5
  208.                                                                      Magic*Ware
  209.  
  210.  
  211.          /l:xx xxx x   Print string 'xx xxx x' in the centered under each
  212.                        logical page. By default, the word 'Magic*Ware' is
  213.                        printed. Use the switch '/l' without text to print
  214.                        nothing.
  215.  
  216.          /?            Display a help screen.
  217.  
  218.                        Note : When you type MW-LASER ?, the program will
  219.                        use '?' as a wildcard and print all files in the
  220.                        current directory that have a one-letter name.
  221.  
  222.  
  223.  
  224.                                                                         page  6
  225.                                                                      Magic*Ware
  226.  
  227.    Environment variable
  228.    --------------------
  229.  
  230.    Like all other Magic*Ware programs, you can define the switches that you
  231.    use the most in an environment variable.
  232.  
  233.    An example (to put in AUTOEXEC.BAT):
  234.  
  235.    SET MW-LASER=/w+ /n- /f:com2 /l:Name of your company /a:$page
  236.  
  237.    When MW-LASER starts, it will look for this environment variable first.
  238.    Then, it will look for any command line switches, so you can override
  239.    your own defaults at any time.
  240.  
  241.    Note: Make sure that there is no space between 'MW-LASER' and '='.
  242.  
  243.  
  244.  
  245.  
  246.                                                                         page  7
  247.                                                                      Magic*Ware
  248.  
  249.  
  250.    System requirements/Technical information
  251.    -----------------------------------------
  252.  
  253.    MW-LASER requires an IBM compatible computer, and a laser printer
  254.    that accepts PCL commands.
  255.  
  256.    When you want to invoke batch printing, you need MS-DOS version 3.0
  257.    or higher.
  258.  
  259.  
  260.  
  261.    MW-LASER has been written on a Wyse AT system with 1Mb internal memory,
  262.    under MS-DOS 3.3.
  263.    It has also been tested on HP Vectra PC's, MS-DOS 3.3 and 4.0.
  264.  
  265.    The language used is Borland's Turbo C 2.0.
  266.  
  267.  
  268.  
  269.    A lot of time has been put into the development of this program.
  270.    Maybe not so much in the initial setup, but many enhancements have
  271.    been added after it had been used a lot.
  272.  
  273.    I like to thank Ron Morimoto for all his testing of and feedback on
  274.    the program. Many of the features implemented were his idea.
  275.  
  276.    I would like to get comments back from you after using it for a while.
  277.    Good ideas or reported errors are always welcome.
  278.  
  279.  
  280.  
  281.                                                                         page  8
  282.                                                                      Magic*Ware
  283.  
  284.    Legal statement
  285.    ---------------
  286.  
  287.    In no way shall Magic*Ware, or Peter van Sluis be liable for any
  288.    problems occurring from the use or misuse of MW-LASER, or the use of
  289.    any one of the other products or services supplied by Magic*Ware or
  290.    Peter van Sluis.
  291.  
  292.  
  293.                                                                         page  9
  294.                                                                      Magic*Ware
  295.  
  296.    Other Magic*Ware utilities:
  297.    ---------------------------
  298.  
  299.    MW-BU    - A backup program to backup multiple hard drives onto floppies.
  300.               This program is still under development (September 1990).
  301.  
  302.    MW-COUNT - Counts the number of files and bytes in the current
  303.               directory, and cumulative for all subdirectories. File
  304.               sizes are rounded up to cluster boundaries, in order to
  305.               determine how much floppy space is needed.
  306.  
  307.    MW-CRUN  - Conditionally runs programs and/or sets errorlevel.
  308.               Conditions tested are: time, date, run frequency, warm or
  309.               cold boot or user input.
  310.               For example: MW-CRUN /od /bc CHKDSK will run CHKDSK once a
  311.               day after a cold boot only.
  312.  
  313.    MW-KEY   - Redefines the 12 function keys on a 101 keyboard for use
  314.               under DOS.
  315.  
  316.    MW-FONT  - An editor for HP LaserJet series II soft fonts. At the
  317.               time of this document (September 1990), this program is still
  318.               under development.
  319.  
  320.    MW-BU    - A backup program to backup multiple hard drives onto floppies.
  321.               This program is still under development (September 1990).
  322.  
  323.    MW-RDS   - Expected to be released by the end of 1990, this project
  324.               is being developed by Peter van Sluis and Bob Santos. RDS
  325.               stands for Relational Data Structure. The final product
  326.               allows you to define entity-relationship data base
  327.               structures, will have on-line programs to enter and report
  328.               data in the structure, and will also have a library of
  329.               routines that can be used by application developers in
  330.               their programs.
  331.  
  332.    Furthermore, Magic*Ware constantly tries out new techniques and
  333.    applications on IBM/PC-AT compatibles, and gives advice to and builds
  334.    custom applications for other PC users.
  335.  
  336.  
  337.  
  338.                                                                         page 10
  339.                                                                      Magic*Ware
  340.    Shareware note
  341.    --------------
  342.  
  343.    This program is distributed as shareware. This means that you may use
  344.    it for free during a reasonable trial period. If you decide that you
  345.    like the program, and you want to keep using it, you will have to
  346.    register it.
  347.    After registration, you will be informed when new upgrades are
  348.    available, and entitles you to use these upgrades with the same
  349.    registration. You will also be notified of upgrades and new releases
  350.    of other Magic*Ware products.
  351.  
  352.  
  353.    You can use the registration form on the next page to register (keep
  354.    a copy for audit/tax purposes).
  355.  
  356.    The shareware fee is $5 for personal use, and $10 for companies (per
  357.    installation).
  358.  
  359.  
  360.  
  361.                                                                         page 11
  362.                                                                      Magic*Ware
  363.  
  364.    Registration form
  365.    -----------------
  366.  
  367.  
  368.    Please register MW-LASER version 2.1 for:
  369.  
  370.                      ___ personal use (enclose $5)
  371.  
  372.                      ___ company use (enclose $10 per installation)
  373.  
  374.                      (California residents add appropriate sales tax)
  375.  
  376.  
  377.  
  378.    Name     :  _____________________________________________________
  379.  
  380.    Company  :  ___________________________  # of installations : ___
  381.  
  382.    Address  :  _____________________________________________________
  383.  
  384.                _____________________________________________________
  385.  
  386.    City/Zip :  _____________________________________________________
  387.  
  388.    Country  :  _____________________________________________________
  389.  
  390.  
  391.  
  392.    Where did you get your evaluation copy of MW-LASER?
  393.  
  394.    _________________________________________________________________
  395.  
  396.    _________________________________________________________________ 
  397.  
  398.  
  399.    Please write down some comments about MW-LASER
  400.    (problems, enhancements, tips):
  401.  
  402.    _________________________________________________________________
  403.  
  404.    _________________________________________________________________ 
  405.  
  406.  
  407.    What other Magic*Ware products do you use?
  408.  
  409.    _________________________________________________________________
  410.  
  411.    _________________________________________________________________ 
  412.  
  413.  
  414.  
  415.    Send this registration form together with a check or money order to:
  416.  
  417.       Peter van Sluis (Magic*Ware)
  418.       1498 South Blaney Avenue, Suite 301
  419.       San Jose, CA 95129-3710
  420.