NAME

printtool - OpenWindows tool for printing files

SYNOPSIS

printtool [ generic-tool-arguments ]

AVAILABILITY

This command is available with the OpenWindows environment.  For information about installing OpenWindows, refer to the OpenWindows Installation and Start-Up Guide . 

DESCRIPTION

printtool is a user interface to the lpr(1), lprm(1), and lpq(1) operating system printing functions. 

printtool is an OpenWindows based XView application that uses the lpr(1) command to print files.  By specifying a filename, printer name, number of copies to be printed and any optional filters, the user can print files, get status on files printed, and remove files from a printer queue. 

You can drag and drop a file from filemgr(1) onto an open printtool or icon, instead of typing a name in the File: text field. 

The printer names are derived from the /etc/printcap file.  By convention, the format of the first line for each printer entry in the /etc/printcap file is:

printer number|logical name|description:

For example:

3|laserbeam|printer near Fred’s office:

The printer name used by printtool is the longest of the first two fields.  This field should not contain blanks. 

OPTIONS

generic-tool-arguments
printtool accepts the generic tool arguments described in xview(1). 

USAGE

printtool is part of the OpenWindows user environment.  For a description of the basic concepts of OpenWindows, see the OpenWindows User’s Guide . 

File: Must specify a filename in the text field. 

Printer:
Must select a printer. It can be from the Printer: options or the default can be left. 

Copies:
Must specify the number of copies to print or leave the default of one.

Filter:
Optional.

None Default and provides no filter. 

Raster File contains a raster image, see rasterfile(5).  The printer must support an appropriate imaging model such as PostScript in order to print the image. 

TeX The files contain  data from tex (DVI format from Stanford). 

Plot The files contain standard plot data as produced by the plot(3X) routines (see also plot(1G) for the filters used by the printer spooler). 

CifPlot The files contain data produced by cifplot. 

troff The files contain troff(1) data. 

pr Prints pages headed with the date, filename and page number. 

control Interprets the first character of each line as a standard FORTRAN carriage control character. 

other Used for printing a file with another command line print method, including pipes.  Will accept the following variables:

$FILE filename from drag and drop operation or name specified in File: text field. 

$PRINTER printer specified in Printer: text field. 

$COPIES number of copies specified in Copies: text field

Print The named file is printed. 

Status
Displays the status of the printer specified in the Printer: text field. 

Stop Printing
Removes a printing job.

Selected Print Job
Stops the printing of the job or jobs you have selected in the scroll window.

All Print Jobs
Stops all of your print jobs that are currently queued. See printcap(5) for more information. 

These filter options offer a standard user interface, and all options may not be available for, nor applicable to, all printers.  The troff filter is provided as part of the standard SunOS installation. 

FILES

/etc/printcap Printer capabilities data base

SEE ALSO

filemgr (1), lpg (1), lpr (1), lprm (1), troff(1), pr (1V), plot (3X), printcap (5), rasterfile (5)

DIAGNOSTICS

See lpr(1) diagnostics. 

printer: unknown printer:
Probably an incorrect entry in the /etc/printcap file. 

The /etc/printcap file must exist with valid printer entries for printtool to work. 

BUGS

See lpr(1) bugs. 
 

Sun Release 4.0  —  Last change: 11 June 1990