INTPRINT.COM is a simple formatter for the interrupt list. Use thisprogram to print only a portion of the list, prevent widow lines at thebeginning of a function call, number the pages, boldface key portions,center the printout, or create a summary of the function calls. Afterformatting is complete, the total number of pages is displayed on thescreen.

Usage: intprint [options] intlist [[>|>>]outfile]

where the options are:-b boldface the title lines, Return:, and Notes: by overprinting-B boldface by sending printer control sequences

-d (duplex) print even/odd pages with different margins; suitable for binding the printout.

-e assume printer is in elite mode (96 characters per line), and indent the output eight spaces to center the printout. This is primarily for the default printer, as other printers may force the equivalent or override this option.

-ffilecreate a file containing only the data structures described in the interrupt list. NOTE: you must put the filename immediately after the 'f'; no blanks are allowed.

-Ffilefilter the listing based on include and exclude strings in 'file'. Only entries whose headers match none of the exclude strings and at least one of the include strings will be processed. All others will be skipped. NOTE: you must put the filename immediately after the 'F'; no blanks are allowed.

-H print a heading on each page indicating which interrupts are listed on the page

-iN indent the output N spaces. The output device is assumed to be at least 80+N characters wide. NOTE: you must put the number immediately after the 'i'; no blanks are allowed.

-I assume the printer is capable of producing IBM character graphics. Printers other than "default" may force this option.

-k keep original divider lines instead of replacing them with all dashes.

-lN print N lines per pages, overriding the printer-specific default.Use 0 to omit page breaks (in this case, the reported number of pages and -r page restriction may be incorrect unless you also use -L); this can be useful if you only want to filter the list before processing it further.

-LN assume N lines on a page. If this is more than the number of lines to print on each page, INTPRINT will use line feeds to advance to the next page instead of form feeds.

-m specify that the interrupt list is in multiple parts beginning with the named file. INTPRINT will increment the last character of the name to get the next filename, and continue until it is unable to open the file thus selected.

-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 or hold a complete output file. See the examples below. NOTE: you must put the number immediately after the 'n'; no blanks are allowed.

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

-Pname use control codes for the specified printer (-P? lists the supported printers). The printer name may be given in either case and abbreviated to a unique prefix; use either dashes or underscores in place of blanks in the printer name.

-rN:M print only pages N through M. The entire input is processed for use in -s and -f summaries (see below) even though only a portion is formatted for printing. If filtering is enabled, (see -F), page numbers are based on entries selected by the filter file. NOTE: you must put the page numbers immediately after the 'r'; no blanks are allowed. When using -l0 together with -r, you must specify the appropriate page length with -L so that page numbers can be computed correctly.

-sfilecreate 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. If -p is also given, page numbers will be included in the summary.If -V is also given, byte offsets for use by INTERVUE will be included. NOTE: you must put the filename immediately after the 's'; no blanks are allowed.

-tN select typeface N for the chosen printer (currently supported only for the HP).

-Tfilecreate a one-line-per-table summary and write it to "file" if -n is also given, the summary will be appended to the named file. If -p is also given, page numbers will be included in the summary. If -V is also given, byte offsets for use by INTERVUE will be included. NOTE: you must put the filename immediately after the 'T'; no blanks are allowed.

-V indicate that the summary file is intended for use by INTERVUE. INTPRINT will output byte offsets that allow INTERVUE to jump directly to an entry. Also forces -I.

-wN (widow lines) search N lines from the end of the page for a good place to break. The default is eight lines; the valid range is from 3 to one-half of the page length. NOTE: you must put the number immediately after the 'w'; no blanks are allowed.

-x include Index: lines in formatted listing. These lines are are excluded by default because they are intended primarily for use by hypertext converters.

Options may not be merged; "-ep" is illegal and the "p" will be ignored.Use "-e -p" instead.

The formatted result of the input file is sent to the specified output file,or to standard output if no output file is given. Standard output may beredirected using the usual Unix or MSDOS redirection characters > or >>. Ifyou only want a summary file or data formats file, send or redirect theoutput to the null device ("NUL" under MSDOS, "/dev/null" under Unix).

FILTER FILE:------------

The filter file specified with -F is a simple text file containinginclude lines, exclude lines, and comment lines. Include lines startwith a plus sign (+) in the first column, followed immediately by thedesired string; exclude lines start with a minus sign (-) in the firstcolumn, followed immediately by the desired string. Comment linesstart with a hash mark (#) in the first column and are ignored. Afuture version of INTPRINT will include alternate forms of include andexclude lines which will select based on the classification letter inthe divider lines rather than the contents of title lines.

If a filter file is specified, only entries whose title lines containat least one of the include lines (ignoring uppercase/lowercasedistinctions) and none of the exclude lines are processed. Thus, afilter file must contain at least one include line, or INTPRINT willskip all interrupt entries and print only the non-interrupt text in thefile.

All spaces on include and exclude lines are significant. Thus,+ DOSwill only match entries containing the four-letter sequence " DOS",while+DOSwill match any entries containing the sequence "DOS", whether or not itis preceded by a blank.

INTPRINT.C contains the source code for INTPRINT, for those people whoare using the interrupt list on a machine which does not run MSDOS.This code has been tested with Turbo C v2.0, Borland C++ v3.1, and Mach(BSD 4.3 Unix) "cc" and "gcc".