home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 21B / NPRT_V23.ZIP / NPRINT.MAN < prev    next >
Text File  |  1992-02-09  |  37KB  |  1,348 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                           NPRINT (tm) Version 2.3
  13.                           Copyright (c) 1990-1992
  14.                             All Rights Reserved
  15.  
  16.                             William Ned Miller
  17.                             7504 Saffron Court
  18.                              Hanover MD 21076
  19.                               (410) 766-2365
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                              Reference Manual
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55. Section                                                               Page
  56.  
  57.  
  58. 1.0 Introduction ....................................................  1
  59.    1.1 Document Layout ..............................................  1
  60.  
  61. 2.0 Hardware Requirements ...........................................  2
  62.  
  63. 3.0 Program Introduction ............................................  3
  64.  
  65. 4.0 Program Options .................................................  4
  66.    4.1 Entering Program Options .....................................  4
  67.       4.1.1 Help ....................................................  5
  68.       4.1.2 Program ID ..............................................  5
  69.       4.1.3 Prompt ..................................................  6
  70.       4.1.4 Terminal ................................................  6
  71.       4.1.5 Fly .....................................................  6
  72.       4.1.6 Lower ...................................................  7
  73.       4.1.7 Upper ...................................................  7
  74.       4.1.8 Condense ................................................  7
  75.       4.1.9 Space ...................................................  7
  76.       4.1.10 One ....................................................  7
  77.       4.1.11 Copies .................................................  7
  78.       4.1.12 Lines ..................................................  7
  79.       4.1.13 Paper ..................................................  7
  80.       4.1.14 Sequence ...............................................  8
  81.       4.1.15 Truncate ...............................................  9
  82.       4.1.16 Pause ..................................................  9
  83.       4.1.17 Window .................................................  9
  84.       4.1.18 X ...................................................... 10
  85.       4.1.19 Confirm ................................................ 10
  86.       4.1.20 Delete ................................................. 10
  87.       4.1.21 List ................................................... 10
  88.       4.1.22 Directory .............................................. 10
  89.       4.1.23 Header/NoHeader ........................................ 11
  90.       4.1.24 Since .................................................. 11
  91.       4.1.25 Before ................................................. 11
  92.       4.1.26 Today .................................................. 11
  93.       4.1.27 Real/NoReal ............................................ 11
  94.       4.1.28 User Comment On Fly Page ............................... 12
  95.       4.1.29 Batch Mode ............................................. 13
  96.       4.1.30 Form Feed .............................................. 13
  97.       4.1.31 Page Number ............................................ 13
  98.  
  99. 5.0 Program Execution ............................................... 14
  100.  
  101. 6.0 NPRINT Messages ................................................. 17
  102.    6.1 Message Listing .............................................. 17
  103.  
  104.  
  105.  
  106.  
  107.  
  108.                                - i -
  109. Section                                                               Page
  110.  
  111.  
  112. 7.0 History Of NPRINT ............................................... 18
  113.  
  114. 8.0 Disclaimer ...................................................... 19
  115.  
  116. 9.0 Licensing ....................................................... 20
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.                                - ii -
  163. 1.0 Introduction
  164.  
  165.      This document explains how to use the NPRINT line printer utility.
  166. NPRINT will allow the user to print specified files to the printer connected
  167. to LPT1:.
  168.  
  169.      NPRINT is written in Meridian Ada.  The program was originally written
  170. in Turbo C but I found it challenging to convert the program to Ada.
  171.  
  172. 1.1 Document Layout
  173.  
  174.      The remainder of this document is as follows:
  175.  
  176.      Chapter 2 - Hardware Requirements
  177.  
  178.      Chapter 3 - Program Introduction
  179.  
  180.      Chapter 4 - Program Options
  181.  
  182.      Chapter 5 - Program Execution
  183.  
  184.      Chapter 6 - NPRINT Messages
  185.  
  186.      Chapter 7 - History Of NPRINT
  187.  
  188.      Chapter 8 - Licensing
  189.  
  190.      Chapter 9 - Disclaimer
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.                                - 1 -
  217. 2.0 Hardware Requirements
  218.  
  219.      NPRINT is a line print utility for IBM PCs including XT, AT and PS2
  220. models and other 100% compatible systems.
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.                                - 2 -
  271. 3.0 Program Introduction
  272.  
  273.      With NPRINT, you can print ASCII files to your printer with a wide
  274. variety of options.  NPRINT includes a help option for references to all the
  275. options furnished.  The following is a list of the options available to the
  276. user:
  277.  
  278. 1)  Program Help
  279. 2)  Program's Version, Date & Author
  280. 3)  Prompt User For Specified Options
  281. 4)  Direct Output To Terminal
  282. 5)  Include A Fly Page In Output
  283. 6)  Print All Output In Upper Case
  284. 7)  Print All Output In Lower Case
  285. 8)  Print In Condense Mode
  286. 9)  Prompt User For Each Page Of Output
  287. 10) Include One Blank Line Between Each Output Line
  288. 11) Specify The Number Of Copies To Print Of Each File
  289. 12) Specify The Number Of Lines Per Page
  290. 13) Specify The Paper Size (80 or 132)
  291. 14) Sequence Lines
  292. 15) Truncate Lines
  293. 16) Pause After A Specified Number Of Files Have Been Printed
  294. 17) Print 10 Lines Before And After A Specified Line Number
  295. 18) Print Between Specified Line Numbers
  296. 19) Delete Files After Printing
  297. 20) List Files
  298. 21) List Files And Include Directories
  299. 22) Print Header On Top Line Of Each Output Page
  300. 23) Print Files After A Specified Date
  301. 24) Print Files Before A Specified Date
  302. 25) Print Files Modified Today
  303. 26) Include A Comment On The Fly Page
  304. 27) Print Files In Batch Mode
  305. 28) Real Time Display
  306. 29) Output Single Form Feed
  307. 30) Start With Specified Page Number
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                                - 3 -
  325. 4.0 Program Options
  326.  
  327.      This chapter explains the numerous options included with NPRINT.
  328. Sections 4.1.1 through 4.1.31 will go into to detail about each one.
  329.  
  330.  
  331. 4.1 Entering Program Options
  332.  
  333.      NPRINT has a vast number of options that the user of this utility can
  334. access.  All these option are entered via the command line, which signal
  335. NPRINT of the users desired function.  The options on the command line use
  336. the following syntax:
  337.  
  338.      NPRINT file /option1 /option2 etc
  339.  
  340.      The options can be abbreviated down to the first three characters of the
  341. option except for the ones where three do make the option unique.  For
  342. example, to print the NPRINT.ADA file to the terminal with a fly page and
  343. have the lines sequenced at column 50 the following examples shows user
  344. input:
  345.  
  346.      NPRINT nprint.ada /terminal /fly /sequence=50
  347.  
  348.      NPRINT nprint.ada /ter /fly /sequence=50
  349.  
  350.      NPRINT nprint.ada /terminal /fly /seq=50
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.                                - 4 -
  379. 4.1.1 Help
  380.  
  381.      The HELP option allows the user to get a snap shot of the options
  382. provided by NPRINT.  This option does not provide the specifics about the
  383. options but is only an aid.  The following shows how the help page will look.
  384.  
  385. ******************************************************************
  386. * Line Print Utility - William Ned Miller V2.3 February 5th 1992 *
  387. * Usage: NPRINT [/Options[=]] [~Comment] [@]File [X:xxx:xxx]     *
  388. ******************************************************************
  389.  
  390. /Help      /ID       /Prompt     /Terminal   /Fly         /Dir      /FF
  391. /Upper     /Lower    /Condense   /One        /Space       /[NO]Real
  392. /Confirm   /Delete   /List       /Today      /[NO]Header  /Screen
  393.  
  394. /Copies=xxx      => Copies                        (Default is 1)
  395. /Lines=xx        => Lines Per Page                (Default Is 50)
  396. /Paper=xxx       => Paper Size(80 or 132)         (Default Is 80)
  397. /Sequence=xxx    => Sequence Lines                (Default Is 72 - Max 125)
  398. /Truncate=xxx    => Truncate To Specified Column  (Default is 72)
  399. /Pause=xxx       => Pause Between File Listings
  400. /Page=xxx        => Start With Specified Page Number
  401. /Window=xxx      => Print Window Of 10 Lines
  402. /Since=mm-dd-yy  => Print Files After & Including Specified Date
  403. /Before=mm-dd-yy => Print Files Before Specified Date
  404. /X:xxx:xxx       => Print Specified Lines
  405.  
  406. ~Comment         => Comment Entered On Fly Page
  407. @File            => Execute In Batch Mode
  408.  
  409.  
  410. 4.1.2 Program ID
  411.  
  412.      Program ID outputs to the users terminal the programs version, version
  413. date and author.  The following is the output displayed when this option is
  414. invoked.
  415.  
  416.  
  417. NPRINT -I-  V2.3   February 5th 1992      William Ned Miller
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.                                - 5 -
  433. 4.1.3 Prompt
  434.  
  435.      This option is for the users that would like to be prompted for the
  436. file to print.  Along with being prompted for the file the user is also
  437. prompted for the case to use and also if a fly page is to be included in the
  438. output.  The following example shows the prompts that the user will see when
  439. this option is chosen.
  440.  
  441.  
  442. Please Enter Filename ? _
  443. (L)ower, (U)pper or (N)ormal ? _
  444. Fly Page (Y/N) ? _
  445.  
  446.  
  447. 4.1.4 Terminal
  448.  
  449.      The use of this option allows the user to have the output of the file
  450. directed to the terminal.
  451.  
  452.  
  453. 4.1.5 Fly
  454.  
  455.      This option allows a fly page to be included with the output of the
  456. file.  The following diagram is an example of a fly page for the NPRINT.ADA
  457. file.
  458.  
  459.  
  460. 01234567890123456789          DOS Version 5.00        01234567890123456789
  461. 01234567890123456789            NPRINT V2.3           01234567890123456789
  462. 01234567890123456789 NPRINT.ADA   20:39:20 91/01/19   01234567890123456789
  463.  
  464. N     N PPPPPP  RRRRRRR IIIIIII N     N TTTTTTT
  465. NN    N P     P R     R    I    NN    N    T
  466. N N   N PPPPPP  R     R    I    N N   N    T
  467. N  N  N P       RRRRRRR    I    N  N  N    T
  468. N   N N P       RRR        I    N   N N    T      ...
  469. N    NN P       R  R       I    N    NN    T      ...
  470. N     N P       R    R  IIIIIII N     N    T      ...
  471.  
  472.  AAAAA  DDDDDD   AAAAA
  473. A     A D     D A     A
  474. A     A D     D A     A
  475. AAAAAAA D     D AAAAAAA
  476. A     A D     D A     A
  477. A     A D     D A     A
  478. A     A DDDDDD  A     A
  479.  
  480.  
  481. 01234567890123456789          DOS Version 5.00        01234567890123456789
  482. 01234567890123456789            NPRINT V2.3           01234567890123456789
  483. 01234567890123456789 NPRINT.ADA   20:39:20 91/01/19   01234567890123456789
  484.  
  485.  
  486.                                - 6 -
  487. 4.1.6 Lower
  488.  
  489.      This option will convert all the contents of the file's output to
  490. lower case.
  491.  
  492.  
  493. 4.1.7 Upper
  494.  
  495.      This option will convert all the contents of the file's output to upper
  496. case.
  497.  
  498.  
  499. 4.1.8 Condense
  500.  
  501.      Under this option, the output will be in condense mode.  If the condense
  502. flag is omitted the utility will convert back to normal mode.
  503.  
  504.  
  505. 4.1.9 Space
  506.  
  507.      With this option each line output to the specified device will include
  508. a blank line.  The number of lines specified per page will be cut in half.
  509.  
  510.  
  511. 4.1.10 One
  512.  
  513.      This option will prompt the user for each page to be output.  This
  514. particular option is useful when single sheets of paper have to be inserted
  515. in to the printer.  The user will prompted with the following prompt:
  516.  
  517.         Pausing ... Any Key To Continue - Page Number =  xxx
  518.  
  519.  
  520. 4.1.11 Copies
  521.  
  522.      With this option the user can specify the number of copies of a file
  523. that is to be printed.
  524.  
  525.  
  526. 4.1.12 Lines
  527.  
  528.      This option will allow the user to specify the number of lines that are
  529. to appear on a single page.  The maximum value that can be set is 66.
  530.  
  531.  
  532. 4.1.13 Paper
  533.  
  534.         This option will allow the user to specify the size of paper in the
  535. printer.  This value can be only set to 80 or 132.
  536.  
  537.  
  538.  
  539.  
  540.                                - 7 -
  541. 4.1.14 Sequence
  542.  
  543.      This option allows line number to be included in the output of the file
  544. being printed.  The following is in an example when the user specifies column
  545. 50 as the sequence column.  The sequence column will truncate the line at the
  546. point specified.
  547.  
  548.  
  549.  
  550. STR_.ADA             Saturday  20:55:59  91/01/19                  Page   1
  551. 20:45:32  91/01/17   1157 bytes
  552. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  553. WITH Text_Handler; USE Text_Handler;               0001
  554.                                                    0002
  555. PACKAGE String_Operations IS                       0003
  556.                                                    0004
  557.    FUNCTION  C2I(this  : IN text;                  0005
  558.                  start : INTEGER) RETURN NATURAL;  0006
  559.                                                    0007
  560.    PROCEDURE Special_Char_To_Integer(this : IN tex 0008
  561.                                                    0009
  562.    FUNCTION  First_Space(buffer : IN     STRING) R 0010
  563.                                                    0011
  564.    PROCEDURE To_Upper(buffer : IN OUT STRING;      0012
  565.                       length : IN     NATURAL);    0013
  566.                                                    0014
  567.    PROCEDURE ASCII_To_Integer(Binary_Value         0015
  568.                               Conversion_Number    0016
  569.                               Number_Of_Characters 0017
  570.                               Suppress_Character   0018
  571.                               buffer               0019
  572.                                                    0020
  573.    PROCEDURE ASCII_To_Integer(Binary_Value         0021
  574.                               Conversion_Number    0022
  575.                               Number_Of_Characters 0023
  576.                               Suppress_Character   0024
  577.                               buffer               0025
  578.                                                    0026
  579.    Invalid_Argument : EXCEPTION;                   0027
  580.                                                    0028
  581. END String_Operations;                             0029
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.                                - 8 -
  595. 4.1.15 Truncate
  596.  
  597.      This option allows truncation of lines at the specified column.  The
  598. following is an example when the user specifies column 50 as the truncation
  599. column.
  600.  
  601.  
  602. STR_.ADA           Saturday  20:58:18  91/01/19                    Page   1
  603. 20:45:32  91/01/17   1157 bytes
  604. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  605. WITH Text_Handler; USE Text_Handler;
  606.  
  607. PACKAGE String_Operations IS
  608.  
  609.    FUNCTION  C2I(this  : IN text;
  610.                  start : INTEGER) RETURN NATURAL;
  611.  
  612.    PROCEDURE Special_Char_To_Integer(this : IN tex
  613.  
  614.    FUNCTION  First_Space(buffer : IN     STRING) R
  615.  
  616.    PROCEDURE To_Upper(buffer : IN OUT STRING;
  617.                       length : IN     NATURAL);
  618.  
  619.    PROCEDURE ASCII_To_Integer(Binary_Value
  620.                               Conversion_Number
  621.                               Number_Of_Characters
  622.                               Suppress_Character
  623.                               buffer
  624.  
  625.    PROCEDURE ASCII_To_Integer(Binary_Value
  626.                               Conversion_Number
  627.                               Number_Of_Characters
  628.                               Suppress_Character
  629.                               buffer
  630.  
  631.    Invalid_Argument : EXCEPTION;
  632.  
  633. END String_Operations;
  634.  
  635.  
  636. 4.1.16 Pause
  637.  
  638.      Under this option, the user can pause the output of multiple files for
  639. user verification.
  640.  
  641.  
  642. 4.1.17 Window
  643.  
  644.      This option allows the user to specify a line number in which 10 lines
  645. before and after the specified line will be listed.
  646.  
  647.  
  648.                                - 9 -
  649. 4.1.18 X
  650.  
  651.      This option will allow the user to specify the lines of a file to be
  652. output.
  653.  
  654.  
  655. 4.1.19 Confirm
  656.  
  657.      This option will prompt the user for each file that is to be output to
  658. the selected device.  When this option is used, the following prompt will be
  659. displayed for the users response:
  660.  
  661.         Print - <file>  [Y/N/G/Q] ?
  662.  
  663.         Y - Yes  - Print Specified File, Prompt For Next File
  664.         N - No   - Do Not Print Specified File, Prompt For Next File
  665.         G - Go   - Print Rest Of The Files, No More Prompts
  666.         Q - Quit - Quit Printing And Exit Program
  667.  
  668. 4.1.20 Delete
  669.  
  670.      This option will allow the user to delete the specified file after it
  671. has been printed.  When this option is specified, it does not work with the
  672. /LIST option.
  673.  
  674. 4.1.21 List
  675.  
  676.      This option will allow the user to list specified files to the terminal.
  677. This is good way that the user can determine the files that will be printed
  678. when wildcards are used.  The following example shows the output when NPRINT
  679. *.ADA /LIST is entered:
  680.  
  681. temp1.ADA       7113   02-22-91  19:59
  682. temp2.ADA       1676   02-16-91  15:48
  683. temp3.ADA       5335   02-18-91  19:11
  684.    File(s) found were   3
  685.  
  686.  
  687. 4.1.22 Directory
  688.  
  689.      This option is only valid when used in conjunction with the /LIST
  690. option.  It allows the user to list the directories, when *.* is specified on
  691. the command line.  Directories will be specified by the lack of a file size
  692. and the <D> flag will be inserted at the end of the time field.  The
  693. following show the output:
  694.  
  695. .                      12-15-90  14:24<D>
  696. ..                     12-15-90  14:24<D>
  697. temp1.ada       7113   02-22-91  19:59
  698. temp2.ada       1676   02-16-91  15:48
  699. temp3.ada       5335   02-18-91  19:11
  700.    File(s) found were  5
  701.  
  702.                                - 10 -
  703. 4.1.23 Header/NoHeader
  704.  
  705.       The /HEADER option will allow the user to have a top line inserted on
  706. the top of each output page.  Specifying /NOHEADER will have this line
  707. omitted from the output.  The default is to print the top line.  The example
  708. shown below shows this:
  709.  
  710. STR_.ADA      Saturday  20:58:18  91/01/19                         Page   1
  711. 20:45:32  91/01/17   1157 bytes
  712. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  713.  
  714.  
  715. 4.1.24 Since
  716.  
  717.      This option will allow the user to print or list all specified files
  718. after and including the specified date.  The following is the format for this
  719. option:
  720.  
  721.    NPRINT /since=mm-dd-yy
  722.  
  723.  
  724. 4.1.25 Before
  725.  
  726.      This option will allow the user to print or list all specified files
  727. before the specified date.  The following is the format for this option:
  728.  
  729.    NPRINT /before=mm-dd-yy
  730.  
  731.  
  732. 4.1.26 Today
  733.  
  734.      This option will allow the user to print or list all specified files
  735. modified on the current day.  This option uses the current system date to
  736. determine todays date.  The following is the format for this option:
  737.  
  738.    NPRINT /today
  739.  
  740.  
  741. 4.1.27 Real/NoReal
  742.  
  743.      This option allows the user to have a real time updatable display about
  744. the files being listed to the printer.  If files are listed to the terminal
  745. this options is not available.  The default is to include the real time
  746. display.  The following is the format for this option:
  747.  
  748.    NPRINT /noreal
  749.  
  750. Printing: file1.ada  Line Number=123 Bytes Written=2305 Completed
  751. Printing: file2.ada  Line Number=56 Bytes Written=548 Completed
  752. Printing: file3.ada  Line Number=756 Bytes Written=8456 Completed
  753.  
  754.  
  755.  
  756.                                - 11 -
  757. 4.1.28 User Comment On Fly Page
  758.  
  759.      This option will allow the user to enter a comment on the fly page, if
  760. the /FLY page option was specified.  If the comment is to contain more than
  761. one word then the character '_' should be used to separate them.  The
  762. following illustrates how to specify this option on the command line.  If the
  763. '_' character is used then it will be removed when output to the fly page.
  764.  
  765. NPRINT /fly ~This_Is_A_Comment nprint.ada
  766.  
  767.      This following diagram show the output of the fly page when this option
  768. is specified.
  769.  
  770.  
  771.  
  772. 01234567890123456789          DOS Version 5.00        01234567890123456789
  773. 01234567890123456789            NPRINT V2.3           01234567890123456789
  774. 01234567890123456789 NPRINT.ADA   21:14:38 91/01/19   01234567890123456789
  775.                               This Is A Comment
  776.  
  777.  
  778.  
  779.  
  780. N     N PPPPPP  RRRRRRR IIIIIII N     N TTTTTTT
  781. NN    N P     P R     R    I    NN    N    T
  782. N N   N PPPPPP  R     R    I    N N   N    T
  783. N  N  N P       RRRRRRR    I    N  N  N    T
  784. N   N N P       RRR        I    N   N N    T      ...
  785. N    NN P       R  R       I    N    NN    T      ...
  786. N     N P       R    R  IIIIIII N     N    T      ...
  787.  
  788.  AAAAA  DDDDDD   AAAAA
  789. A     A D     D A     A
  790. A     A D     D A     A
  791. AAAAAAA D     D AAAAAAA
  792. A     A D     D A     A
  793. A     A D     D A     A
  794. A     A DDDDDD  A     A
  795.  
  796.  
  797.  
  798.  
  799.  
  800. 01234567890123456789          DOS Version 5.0         01234567890123456789
  801. 01234567890123456789            NPRINT V2.3           01234567890123456789
  802. 01234567890123456789 NPRINT.ADA   21:14:38 91/01/19   01234567890123456789
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.                                - 12 -
  811. 4.1.29 Batch Mode
  812.  
  813.      This option allows the user to specify a file that contains a list of
  814. file names to be output.  The contents of the batch file can include
  815. wildcards.  The batch file must be preceded by a '@' and all other options
  816. described in chapter 4 are legal.  The following shows an example using a
  817. batch file:
  818.  
  819.  
  820.    NPRINT @p_files /fly
  821.  
  822.  
  823.      This example will output the files listed in the file 'p_files' to the
  824. printer with a fly page for each file.
  825.  
  826.  
  827. 4.1.30 Form Feed
  828.  
  829.      This option will allow the user to output a single form feed to the
  830. printer.
  831.  
  832.  
  833. 4.1.31 Page
  834.  
  835.      This option will allows the output to start on a specified page number.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.                                - 13 -
  865. 5.0 Program Execution
  866.  
  867.      This chapter will illustrate the execution of the NPRINT utility. NPRINT
  868. contains a wide variety of options to meet each users particular needs.  The
  869. execution of NPRINT and all options are entered from the keyboard.  The rest
  870. of this chapter will exemplify the use of NPRINT.
  871.  
  872. Command                                      Results
  873.  
  874. NPRINT /help                                 Output to the users terminal
  875.                                              NPRINT's help page
  876.  
  877. NPRINT /id                                   Output NPRINT's Identification
  878.  
  879. NPRINT nprint.ada                            Output the file nprint.ada
  880.                                              to the printer
  881.  
  882. NPRINT nprint.ada /ter                       Output the file nprint.ada
  883.                                              to the terminal
  884.  
  885. NPRINT nprint.ada /ter /seq=50               Output the file nprint.ada
  886.                                              to the terminal and sequence
  887.                                              the lines at column 50
  888.  
  889. NPRINT nprint.ada /tru                       Output the file nprint.ada
  890.                                              to the printer and truncate
  891.                                              to the default column
  892.  
  893.  
  894. NPRINT nprint.ada /spc                       Output the file nprint.ada
  895.                                              to the printer and put a
  896.                                              space between each line
  897.  
  898. NPRINT nprint.ada /fly                       Output the file nprint.ada
  899.                                              to the printer and include a
  900.                                              FLY page with the output
  901.  
  902. NPRINT nprint.ada /one                       Output the file nprint.ada
  903.                                              to the printer and prompt
  904.                                              the user to continue printing
  905.  
  906. NPRINT nprint.ada /copies=3                  Output 3 three copies of the
  907.                                              file nprint.ada to the printer
  908.  
  909. NPRINT *.ada /pause=5                        Output all files with the file
  910.                                              type 'ada' and pause every
  911.                                              five files for user response
  912.  
  913. NPRINT *.ada /confirm /terminal              Prompt the user if the listed
  914.                                              files is to be printed to the
  915.                                              terminal
  916.  
  917.  
  918.                                - 14 -
  919. Command                                      Results
  920.  
  921. NPRINT nprint.ada /lower                     Output the file nprint.ada
  922.                                              to the printer with all
  923.                                              output in lower case
  924.  
  925. NPRINT nprint.ada /upper                     Output the file nprint.ada
  926.                                              to the printer all
  927.                                              output in upper case
  928.  
  929. NPRINT /prompt                               Prompt the user for the file
  930.                                              to be output to the printer
  931.  
  932. NPRINT nprint.ada /condense                  Output the file nprint.ada
  933.                                              to the printer in condense
  934.                                              mode
  935.  
  936. NPRINT nprint.ada /paper=132                 Output the file nprint.ada
  937.                                              to the printer for paper
  938.                                              size of 132
  939.  
  940. NPRINT nprint.ada /ter /win=100              Output the lines 90 through
  941.                                              110 of the file nprint.ada
  942.                                              to the terminal
  943.  
  944. NPRINT nprint.ada /X:6:54                    Output the lines 6 through
  945.                                              54 of the file nprint.ada
  946.                                              to the printer
  947.  
  948. NPRINT nprint.ada /delete                    Print the file nprint.ada to
  949.                                              the printer and delete the
  950.                                              file after the operation
  951.  
  952. NPRINT *.ada /list                           All of the Ada files in the
  953.                                              current directory will be
  954.                                              listed to the users terminal
  955.  
  956. NPRINT *.* /list /dir                        All of the files and
  957.                                              directories will be listed
  958.                                              to the users terminal
  959.  
  960. NPRINT nprint.ada /noheader                  The file nprint.ada will be
  961.                                              printed to the printer but
  962.                                              no top line will be included
  963.                                              in the output
  964.  
  965. NPRINT *.ada /since=01-01-91                 All Ada files with a file date
  966.                                              later than or equal to January
  967.                                              1st 1991 will be output to
  968.                                              the printer
  969.  
  970.  
  971.  
  972.                                - 15 -
  973. Command                                      Results
  974.  
  975. NPRINT *.ada /before=02-01-91 /list          All Ada files with a file date
  976.                                              before February 1st 1991 will
  977.                                              be listed to the users
  978.  
  979.  
  980. NPRINT *.ada /today /ter                     All Ada files modified on the
  981.                                              current day will be output
  982.                                              to the user on the terminal
  983.  
  984.  
  985.  
  986. NPRINT nprint.ada /fly ~Comment_Line         Output the file nprint.ada
  987.                                              to the printer with a FLY
  988.                                              page and include the comment
  989.                                              line "Comment Line"
  990.  
  991. NPRINT @files /fly                           Output all files listed in
  992.                                              file files to the printer
  993.                                              with a fly page
  994.  
  995. NPRINT /ff                                   Output a single form feed
  996.                                              to the printer
  997.  
  998. NPRINT nprint.ada /page=3                    Output the file nprint.ada
  999.                                              to the printer and start
  1000.                                              the page number at 3
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.                                - 16 -
  1027. 6.0 NPRINT Messages
  1028.  
  1029.      This chapter describes the messages that can be produced by the NPRINT
  1030. program.  There are three types of messages that can be produced by NPRINT.
  1031. The three types are Information, Warning and Fatal.  Information messages are
  1032. of the type that convey general type of information,  Warning messages
  1033. indicate that some is not quiet right but will not abort the program.  Fatal
  1034. messages are of the type that will abort the program at the point that the
  1035. error is encountered.  The following depicts the format for these types of
  1036. messages:
  1037.  
  1038.      1) NPRINT -I-            -> Informational
  1039.      2) NPRINT -W-            -> Warning
  1040.      3) NPRINT -F-            -> Fatal         (Stops Program Execution)
  1041.  
  1042.  
  1043. 6.1 Message Listing
  1044.  
  1045.  
  1046. NPRINT -I- V2.3  February 5th 1992     William Ned Miller
  1047.  
  1048. NPRINT -W- '<Filename>' Not Found
  1049. NPRINT -W- Unable to open File: <Filename>
  1050.  
  1051. NPRINT -F- Illegal Argument
  1052. NPRINT -F- Unrecognized Option:
  1053. NPRINT -F- Invalid Time Parameter
  1054. NPRINT -F- Invalid Syntax For Time
  1055. NPRINT -F- Unable To Open BATCH file: <Filename>
  1056. NPRINT -F- Program Has Been Corrupted
  1057. NPRINT -F- Unknown Error
  1058. NPRINT -F- Printer Off Line OR Turned Off
  1059. NPRINT -F- Printer Is Out Of Paper
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.                                - 17 -
  1081. 7.0 History Of NPRINT
  1082.  
  1083.  
  1084. Revision  Date      Comments
  1085.  
  1086.  1.0      12/15/90  Initial Release.
  1087.  
  1088.  2.0      04/15/91  This version includes a few more options.
  1089.  
  1090.                     /SINCE
  1091.                     /BEFORE
  1092.                     /TODAY
  1093.                     /LIST
  1094.                       /DIR
  1095.                     /DELETE
  1096.                     /CONFIRM
  1097.                     /[NO]HEADER
  1098.                     /[NO]Real
  1099.  
  1100.                     A number of bugs were fixed.
  1101.  
  1102. 2.1                 Increase the length of a line read up to 254 characters.
  1103.  
  1104.                     Check printer status before any output is directed
  1105.                     towards printer.
  1106.  
  1107.                     Fixed Output Of DOS Version On FLY Page
  1108.  
  1109.                     Account For CR and LF in files for Real-Time Updates
  1110.  
  1111. 2.2      15/10/91   Bug Fixes
  1112.  
  1113. 2.3      05/02/92  This version includes a few more options.
  1114.  
  1115.                     /FF
  1116.                     /Page
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.                                - 18 -
  1135. 8.0 Disclaimer
  1136.  
  1137.                           NPRINT (tm) Version 2.3
  1138.                           Copyright (c) 1990-1992
  1139.                             All Rights Reserved
  1140.  
  1141.                             William Ned Miller
  1142.                             7504 Saffron Court
  1143.                              Hanover MD 21076
  1144.                               (410) 766-2365
  1145.  
  1146.  
  1147.      The author disclaims all warranties expressed or implied as to the
  1148. quality or performance of this program.  The author will not be held liable
  1149. for any lost profits, lost savings or any other direct, indirect, incidental
  1150. or consequential damages resulting from the use of this program. Your use of
  1151. this program constitutes your agreement to this disclaimer and your  release
  1152. of the author from any form of liability or litigation.
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.                                - 19 -
  1189. 9.0 Licensing
  1190.  
  1191.                           NPRINT (tm) Version 2.3
  1192.                           Copyright (c) 1990-1992
  1193.                             All Rights Reserved
  1194.  
  1195.                             William Ned Miller
  1196.                             7504 Saffron Court
  1197.                              Hanover MD 21076
  1198.                               (410) 766-2365
  1199.  
  1200.  
  1201.      *  A $5 shareware contribution is requested for using the program.
  1202.      *  The author retains the sole right to sell the program.
  1203.      *  The author grants users the right to copy and distribute
  1204.         the program within the following constraints:
  1205.         - All program files remain unaltered and are distributed
  1206.           together.
  1207.         - No attempt is made to sell the program, or to make
  1208.           money from it or any modified version of it.
  1209.         - The program is not bundled with any other hardware or
  1210.           software transactions without the author's permission.
  1211.      *  Continued use of the program (more than 3 weeks) by any
  1212.         individual, corporation or institution without a single
  1213.         user or site license is prohibited.
  1214.      *  Single user licenses are obtained by sending in the $5
  1215.         shareware contribution.
  1216.      *  Corporations and other institutions (including  government
  1217.         and educational) which desire using the program should
  1218.         refer to the last page of this document for site licensing
  1219.         information.
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.                                - 20 -
  1243.                           NPRINT (tm) Version 2.3
  1244.                           Copyright (c) 1990-1992
  1245.                             All Rights Reserved
  1246.  
  1247.                             William Ned Miller
  1248.                             7504 Saffron Court
  1249.                              Hanover MD 21076
  1250.                               (410) 766-2365
  1251.  
  1252.  
  1253.   Single User Registration Form
  1254.  
  1255.   To register your copy of NPRINT please fill in the following
  1256.   information and send it along with $5 (US) to:
  1257.  
  1258.   William Ned Miller                     { Please only send }
  1259.   7504 Saffron Court                     { checks drawn on  }
  1260.   Hanover MD 20176                       { U.S. banks or    }
  1261.                                          { postal money     }
  1262.                                          { orders.          }
  1263.  
  1264.   Name: ____________________________________________________________
  1265.  
  1266.  
  1267.   Address: _________________________________________________________
  1268.  
  1269.   __________________________________________________________________
  1270.  
  1271.  
  1272.   System Type:       8088/8086______            80x86_______________
  1273.  
  1274.   Disk Type:         5.25___________            3.50________________
  1275.  
  1276.  
  1277.   Phone: (Optional) (     )______-__________________________________
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.                           NPRINT (tm) Version 2.3
  1298.                           Copyright (c) 1990-1992
  1299.                             All Rights Reserved
  1300.  
  1301.                             William Ned Miller
  1302.                             7504 Saffron Court
  1303.                              Hanover MD 21076
  1304.                               (410) 766-2365
  1305.  
  1306.  
  1307.   Site License Agreement Order Form
  1308.  
  1309.   Max # Users          Purchase Price    Cost/Workstation
  1310.     1 -   20 ........... $100.00             $5.00
  1311.    21 -   40 ........... $180.00             $4.50
  1312.    41 -   60 ........... $240.00             $4.00
  1313.    61 -   80 ........... $280.00             $3.50
  1314.    81 -  100 ........... $300.00             $3.00
  1315.  
  1316.   Make check payable to:  {All prices in U.S. dollars}
  1317.  
  1318.     William Ned Miller
  1319.     7504 Saffron Court
  1320.     Hanover MD 21076
  1321.  
  1322.  
  1323.   Site License Provides
  1324.  
  1325.   1. Legal right to use NPRINT on the specified number of workstations.
  1326.   2. Two (2) floppies containing the next release of the program.
  1327.      All additional copies of the program, up to the limit ordered,
  1328.      will be made by the purchaser.
  1329.  
  1330.  
  1331.   Ordering Information
  1332.  
  1333.   Site License desired for a maximum of ______  workstations.
  1334.  
  1335.   To be sent to: ____________________________________________ Please
  1336.                                                               Print
  1337.   ___________________________________________________________ or Type
  1338.                                                               Legibly
  1339.   ___________________________________________________________
  1340.  
  1341.  Point of Contact: __________________________________________
  1342.  
  1343.  System Type:   8088/8086 _____            80x86_____________
  1344.  
  1345.  Disk Type:     5.25___________            3.50______________
  1346.  
  1347.  Phone: (____)_______-__________________
  1348.