[comp.sys.ibm.pc] Interrupt list v89.2, file INTPRINT.DOC

ralf@b.gp.cs.cmu.edu (Ralf Brown) (04/30/89)

INTPRINT.COM is a VERY simple formatter for the interrupt list.  Use
this program to prevent widow or orphan lines at the beginning or end of a
function call, number the pages, center the printout in elite (12 cps) mode,
or create a summary of the function calls.  After formatting is complete, the
total number of pages is displayed on the screen.

Usage:
   intprint [options] [lines_per_page [page_length]] <interrup.lst [>outfile]

where the options are:
        -e    assume printer is in elite mode (96 characters per line), and
              indent the output eight spaces to center the printout.

        -iN   indent the output N spaces.  The output device is assumed to be
              at least 80+N characters wide.

        -E    assume the printer is an Epson FX80 or compatible, and send
              control sequences to place the printer in elite mode and center
              the printout.  This option overrides -e and forces -i8

        -p    print the page number at the bottom center of each page

        -nN   assume N pages have already been printed, and start numbering
              at N+1.  This option allows you to create a properly-numbered
              printout even if there is not enough disk space to concatenate
              the parts of the interrupt list.  See the examples below.
              NOTE: you must put the number immediately after the 'n', no
              blanks are allowed.

        -sfile  create a one-line-per-function summary and write it to "file"
              if -n is also given, the summary will be appended to "file",
              allowing a properly numbered summary file to be created even if
              there is not enough disk space to concatenate the parts of the
              list.  See the examples below.
              NOTE: you must put the filename immediately after the 's', no
              blanks are allowed.

Options may not be combined; "-ep" is illegal and the "p" will be ignored.

Lines_per_page specifies how many lines to print on each page (including the
optional page number), and defaults to 60.

Page_length specifies how many lines are on a printed page.  If this value is
omitted, a form feed is used to skip to the next page.  If specified, line
feeds are used to skip to the next page.

The file to be formatted is read from standard input, and the formatted result
is sent to standard output.  Both may be redirected using the standard Unix or
MSDOS redirection characters < and >.  If you only want a summary file,
redirect the output to the null device ("NUL" under MSDOS, "/dev/null" under
Unix).

EXAMPLES:
---------
        Print the interrupt list with page numbers, and create a summary file,
        without concatenating INTERRUP.A and INTERRUP.B:

                A> intprint -sb:interrup.sum -p <interrup.a >prn
                157 pages.   [screen output from INTPRINT]
                A> intprint -sb:interrup.sum -p -n157 <interrup.b >prn

        Create only a summary file:

                C> intprint -sinterrupt.sum <interrup.lst >nul

        Print the interrupt list on an Epson FX80, using 54 lines per page and
        omitting both page numbers and summary:

                C> intprint -E 54 <interrup.lst >prn

        Print the interrupt list using 120 lines on every 132-line page:

                C> intprint 120 132 <interrup.lst >prn




INTPRINT.C contains the source code for INTPRINT, for those people who are
using the interrupt list on a machine which does not run MSDOS.  This code has
been tested with Turbo C and Mach (BSD 4.3) "cc".

-- 
{harvard,uunet,ucbvax}!b.gp.cs.cmu.edu!ralf -=-=- AT&T: (412)268-3053 (school) 
ARPA: RALF@B.GP.CS.CMU.EDU |"Tolerance means excusing the mistakes others make.
FIDO: Ralf Brown at 129/31 | Tact means not noticing them." --Arthur Schnitzler
BITnet: RALF%B.GP.CS.CMU.EDU@CMUCCVMA -=-=- DISCLAIMER? I claimed something?
--