print-setup(3)
[Home]
[Commands]
[Variables]
[Macro-Dev]
[Glossary]
NAME
SYNOPSIS
DESCRIPTION
print-setup provides a dialog interface for configuring MicroEmacs's printing interface. print-setup may be invoked from the main File menu or directly from the command line using
execute-named-command(2).
The print-setup dialog is broken down into three pages of configuration options, on all pages the following buttons are available at the bottom of the dialog:-
Print
Prints the current buffer using the current configuration.
Exit
Quits print-setup, changes made to the configuration will be saved.
The following pages appear in the dialog:-
Printer
The Printer page is used to configure the type, style and location of the printer, the items on this page are defined as follows:-
Driver
Sets the printer type to be used, selecting this item creates a drop down list of available printer drivers. The drivers inform MicroEmacs which fonts and colors are available and how to enable/disable them, these are usually special character sequences. The following special drivers are defined:-
Default Plain Text
This driver does not use any special character sequences so the output it produces is plain text. This should work with most printers, but it does not support any colors or fonts.
HTML
This is a virtual printer driver as no printer uses HTML directly. However the files produced by this driver can be loaded by a web-browser and rendered with full color and font support so provides an efficient way of testing printer schemes. In addition may be used to convert the text rendered in MicroEmacs into HTML content.
Windows
This utilizes MicroEmacs's built-in Windows printer interface (Windows platforms only). When selected MicroEmacs communicates directly to the MS Printer Manager.
Print Scheme
Sets the color and font scheme to be used, selecting this item creates a drop down list of available printer schemes - choose one appropriated for your printer. The Default Plain Text scheme does not use any color or fonts so should work for all drivers. see the next item for scheme creation and editing.
Edit
Opens the
scheme-editor(3) dialog box to edit the currently selected printer scheme, the editor may also be used to create and install new printer schemes.
Destination
Specifies the resultant print output, when selected a drop down menu appears containing the following items:
To buffer only
Creates a "*printer*" buffer and prints to the buffer.
To file only
Creates a new temporary file and prints to it.
To file & print
Prints to a temporary file and then executes the command-line (see next item) to print the resultant file (option not available when using the Windows printer driver).
Direct to printer
Output is sent directly to the printer, option only available when using the Windows driver.
Command-line
Sets the command-line required to print a generated print file (option not available when the Windows driver is selected as printing is done by talking to MS Print Manager directly). The command-line should be a single shell command using "%f" whenever the name of the file to be printed is required, e.g. on UNIX systems lp(1) or lpr(1) can usually be used as follows:-
lp -s %f
On MS-DOS machines this can usually be achieved by copying the file to the PRN device, as follows:
copy %f PRN
Page Size
Displays the currently configured page size in the form:
the field cannot be edited directly, the settings Page Setup affect these values.
Page Setup
Paper Size
Sets the size of the printer paper, selecting this item will produce a pop down menu listing all available paper sizes unless the Windows printer driver is being used in which case this field cannot be selected and the Edit button must be used.
Character Size
Sets the size of a character within the page, expressed in terms of the number of characters which will fit on the paper (widthxheight). When selected a drop down menu lists all available sizes for the current paper size unless the Windows driver is selected in which case this field cannot be selected and the Edit button must be used.
Edit (Windows only)
Opens a Windows printer dialog box allowing the user to specify the windows printer, paper size and character size etc.
No. of Columns and Rows
Sets the number of sub-columns and rows to divide the page into, creating pages within a page.
Line Numbers
When enabled, prints the line number at the left hand edge for each line.
Split Line ID
When enabled the last right hand text column is reserved for a split identifier. Whenever a line is too long to fit on a single line it is split over two or more lines, if this option is enabled the right edge will be set to the split character (usually a '\' char) to clearly indicate that the line is split.
Page Size
As with the Printer Page Size it displays the current page size, the field cannot be edited.
Layout
Margins
Configures the top, bottom, left and right margins in characters.
Header
Sets whether a header should be printed and if so what it should be, the following special strings can be used:
%%
%b
Print the current buffer's name.
%D
Print the current day of the month.
%f
Print the current buffer's file name.
%h
%M
Print the current month of the year.
%m
Print the current minute of the hour.
%p
Print the current page number.
%s
Print the current seconds.
%Y
Print the current year as a 2 digit number.
%y
Print the current year as a 4 digit number.
Footer
Sets whether a footer should be printed and if so what it should be, the same special strings can be used as for the header.
NOTES
user-setup is a macro using
osd(2), defined in printstp.emf.
The list of available printer drivers and print schemes is stored in the macro file printers.emf. Using the Install option of the
scheme-editor(3) automatically adds the new scheme to the print schemes list. To create a new printer driver a new configuration registry file (erf file - see print*.erf for examples) must be created and added to the printer driver lists within printer.emf.
SEE ALSO
(c) Copyright JASSPA 2001
Last Modified: 2001/08/07
Generated On: 2001/08/15