diff options
| author | Kevin Walzer <kw@codebykevin.com> | 2021-07-04 02:16:33 (GMT) |
|---|---|---|
| committer | Kevin Walzer <kw@codebykevin.com> | 2021-07-04 02:16:33 (GMT) |
| commit | acd0a9576f426e1f232cfa9facbfa06b8d6a34af (patch) | |
| tree | 252a200a7956ba1384cf19525fff510a38230dd9 /doc/print.n | |
| parent | aaaabefb7f1a8a99db8d71193bdab14ef4e9836f (diff) | |
| download | tk-acd0a9576f426e1f232cfa9facbfa06b8d6a34af.zip tk-acd0a9576f426e1f232cfa9facbfa06b8d6a34af.tar.gz tk-acd0a9576f426e1f232cfa9facbfa06b8d6a34af.tar.bz2 | |
Update man page
Diffstat (limited to 'doc/print.n')
| -rw-r--r-- | doc/print.n | 21 |
1 files changed, 19 insertions, 2 deletions
diff --git a/doc/print.n b/doc/print.n index d6ec38c..dd0abd6 100644 --- a/doc/print.n +++ b/doc/print.n @@ -10,7 +10,6 @@ .SH NAME print \- Print canvas and text widgets using native API's. .SH SYNOPSIS - \fBtk print\fR \fIcanvas\fR \fIwindow\fR \fBtk print\fR \fItext\fR \fIwindow\fR @@ -20,16 +19,34 @@ print \- Print canvas and text widgets using native API's. The \fBtk print\fR command allows users to print output from the \fBcanvas\fR and \fBtext\fR widgets using platform-native API's and dialogs. -.TP +.PP The \fBcanvas\fR widget has long supported PostScript export and both PostScript and text files can be sent directly to a printer on Unix-like systems using the "lp" or "lpr" commands, and the \fBtk print\fR command does not supersede that functionality; it builds on it. The \fBtk print\fR command is a fuller implementation that uses native dialogs on macOS and Windows, and a Tk-based dialog that provides parallel functionality on X11. .SH PLATFORM NOTES .TP +. +\fBmacOS\fR +.PP +The Mac implementation uses native print dialogs and relies on the +underlying Common Unix Printing System (CUPS) to render text output from +the text widget and PostScript output from the canvas widget to the +printer, to a PDF file, or a PostScript file. +.TP \fBWindows\fR .PP The Windows implementation is based on the GDI (Graphics Device Interface) API. Because there are slight differences in how GDI and Tk's \fBcanvas\fR widget display graphics, printed output from the \fBcanvas\fR on Windows may not be identical to screen rendering. +.TP +\fBX11\fR +.PP +The X11 implementation uses a Tk GUI to configure print jobs for sending +to a printer via the "lpr" or "lp" commands. While these commands have a +large number of parameters for configuring print jobs, printers vary +widely in how they support these parameters. As a result, only printer +selection and number of copies are configured as arguments to the print +command; many aspects of print rendering, such as grayscale or color for +the canvas, are instead configured when PostScript is generated. . .SH KEYWORDS print, output, graphics, text, canvas |