The Print Dialog

When invoked normally, dtlp posts a Print dialog that shows:

File

The name of the file to print (a read-only text label).

Printer

The printer device. The default is the value of the LPDEST environment variable. If LPDEST is unset, then the properly localized string Default appears in the text field.

Copies

The number of copies to print. The default is 1.

Banner Page Title

The title to appear on the printed banner page, and if formatted, in the header of each page.

Print Page Numbers

A checkbox to indicate whether the file should be printed formatted (run through the pr -f command) or printed unformatted.

Print Command Options

Any options to be passed directly to the lp command. For example, some implementations support the -o2 option to lp to enable double-page printing.

When the user presses the Print button, these settings are passed onto the lp subsystem, along with the values of any other environment settings (see the ENVIRONMENT heading in this man page).

Command Line Options and the ENVIRONMENT Setting

The dtlp command is sensitive to some ENVIRONMENT settings. In the case in which both a command line option and a complementary environment setting are specified, the command line option takes precedence.

Command Line Options

-b banner_title

Set the string used in printing the banner on the title page. If the -r option is also specified, then print this same string on the page headers.

-d lpdest

Set the printer destination for the file.

-m print_command

Use this value as the path name of the lp print command. The default is lp.

-n copy_count

Print this many copies. Default is 1.

-o other_options

Pass these options directly through to the print_command, without any interpretation. This setting is intended for users with advanced printing knowledge.

-u user_filename

Use this value as the name of file as it should appear in the Print dialog or print output. Default is print_file. Equivalent to the DTPRINTUSERFILENAME setting under the ENVIRONMENT heading in this man page.

-a

Causes the file to be formatted with the man command. If set, then other formatting specifications (such as -r) are ignored.

-e

Remove the file after printing it. This functionality is intended for temporary files generated by applications that don't need to persist beyond the act of printing. Equivalent to the DTPRINTFILEREMOVE.

-h

Print out a help message.

-r

Format the file before printing it, by running it through the pr -f command.

-s

Print the file silently, without posting the Print dialog. Equivalent to the DTPRINTSILENT setting under the ENVIRONMENT heading in this man page.

-v

Print out verbose messages during the print process.

-w

Causes output to the printer to be sent raw, with no interpretation of tabs, backspaces, formfeeds, and binary characters. Useful for printing PCL and PS files. If set, then other formatting specifications (such as -r) are ignored; however, the -a option will take precedence over this setting.

print_file

Print this file. If print_file is not supplied, standard input is assumed.

Reconciling Options

In the case of conflicting formatting options, dtlp uses the following decisions to reconcile them:

•

If any raw (as with -w), or man (as with -a) options are specified, all other page formatting and numbering options are turned off; otherwise, page printing and formatting are allowed.

•

In a formatted operation: If a banner title is specified (as with -b), it will be used as the page header.

•

If a user filename is specified (as with -u or DTPRINTUSERFILENAME), it will be used as the page header; otherwise, the filename itself will be used as the page header.

Command Line

The following command line causes dtlp to post a Print dialog for file1 with a name displayed of Your File and with the default printer chosen: /usr/local/dt/bin/dtlp -u "Your File" file1 The following command line causes dtlp to silently print two copies of file2 on printer laser3: /usr/local/dt/bin/dtlp -n 2 -d laser3 -s file2

Action Definition

The following Print action would cause a PCL file to be printed using the dtlp command.

ACTION Print
{


        LABEL           Print


        ARG_TYPE        PCL


        TYPE            COMMAND


        WINDOW_TYPE     NO_STDIO


        EXEC_STRING     /usr/local/dt/bin/dtlp -w %Arg_1%
}

The following Print action would cause a man page file to be printed using the dtlp command.

ACTION Print
{


        LABEL           Print


        ARG_TYPE        MAN_PAGE


        TYPE            COMMAND


        WINDOW_TYPE     NO_STDIO


        EXEC_STRING     /usr/local/dt/bin/dtlp -a %Arg_1%
}

By default, these actions will post the Print dialog.