1 ;;; printing.el --- printing utilities
3 ;; Copyright (C) 2000, 2001, 2003, 2004, 2005,
4 ;; 2006 Free Software Foundation, Inc.
6 ;; Author: Vinicius Jose Latorre <viniciusjl@ig.com.br>
7 ;; Maintainer: Vinicius Jose Latorre <viniciusjl@ig.com.br>
8 ;; Time-stamp: <2006/09/15 18:53:14 vinicius>
9 ;; Keywords: wp, print, PostScript
11 ;; X-URL: http://www.emacswiki.org/cgi-bin/wiki/ViniciusJoseLatorre
13 (defconst pr-version "6.8.4"
14 "printing.el, v 6.8.4 <2005/06/11 vinicius>
16 Please send all bug fixes and enhancements to
17 Vinicius Jose Latorre <viniciusjl@ig.com.br>
20 ;; This file is part of GNU Emacs.
22 ;; GNU Emacs is free software; you can redistribute it and/or modify it under
23 ;; the terms of the GNU General Public License as published by the Free
24 ;; Software Foundation; either version 2, or (at your option) any later
27 ;; GNU Emacs is distributed in the hope that it will be useful, but WITHOUT ANY
28 ;; WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
29 ;; FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
32 ;; You should have received a copy of the GNU General Public License along with
33 ;; GNU Emacs; see the file COPYING. If not, write to the Free Software
34 ;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
38 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
43 ;; With `printing' you can preview or print a PostScript file. You can also
44 ;; print a text file using PostScript, and preview or print buffers that use
45 ;; certain special modes like mh-folder-mode, rmail-summary-mode,
46 ;; gnus-summary-mode, etc. This package also includes a PostScript/text
49 ;; There are two user interfaces:
52 ;; The `printing' menu replaces the usual print options in the menu bar.
53 ;; This is the default user interface.
55 ;; * Buffer interface:
56 ;; You can use a buffer interface instead of menus. It looks like a
57 ;; customization buffer. Basically, it has the same options found in the
58 ;; menu and some extra options, all this on a buffer.
60 ;; `printing' is prepared to run on GNU, Unix and NT systems.
61 ;; On GNU or Unix system, `printing' depends on gs and gv utilities.
62 ;; On NT system, `printing' depends on gstools (gswin32.exe and gsview32.exe).
63 ;; To obtain ghostscript, ghostview and GSview see the URL
64 ;; `http://www.gnu.org/software/ghostscript/ghostscript.html'.
66 ;; `printing' depends on ps-print package to generate PostScript files, to
67 ;; spool and to despool PostScript buffer. So, `printing' provides an
68 ;; interface to ps-print package and it also provides some extra stuff.
70 ;; To download the latest ps-print package see
71 ;; `http://www.cpqd.com.br/~vinicius/emacs/ps-print.tar.gz'.
72 ;; Please, see README file for ps-print installation instructions.
74 ;; `printing' was inspired on:
76 ;; print-nt.el Frederic Corne <frederic.corne@erli.fr>
77 ;; Special printing functions for Windows NT
79 ;; mh-e-init.el Tom Vogels <tov@ece.cmu.edu>
80 ;; PS-print for mail messages
82 ;; win32-ps-print.el Matthew O. Persico <mpersico@erols.com>
83 ;; PostScript printing with ghostscript
85 ;; ps-print-interface.el Volker Franz <volker.franz@tuebingen.mpg.de>
86 ;; Graphical front end for ps-print and previewing
92 ;; The buffer *Printing Command Output* is where the `printing' log messages
93 ;; are inserted. All program called by `printing' has a log entry in the
94 ;; buffer *Printing Command Output*. A log entry has the following form:
101 ;; PROGRAM is the program activated by `printing',
102 ;; ARG is an argument passed to PROGRAM (it can have more than one argument),
103 ;; MESSAGE is an error message returned by PROGRAM (it can have no message, if
104 ;; PROGRAM is successful),
105 ;; and CODE is a numeric exit status or a signal description string.
107 ;; For example, after previewing a PostScript file, *Printing Command Output*
108 ;; will have the following entry:
110 ;; /usr/X11R6/bin/gv ("/home/user/example/file.ps")
113 ;; In the example above, the previewing was successful. If during previewing,
114 ;; you quit gv execution (by typing C-g during Emacs session), the log entry
117 ;; /usr/X11R6/bin/gv ("/home/user/example/file.ps")
120 ;; So, if something goes wrong, a good place to take a look is the buffer
121 ;; *Printing Command Output*. Don't forget to see also the buffer *Messages*,
125 ;; Novices (First Users)
126 ;; ---------------------
128 ;; First of all, see printing documentation only to get an idea of what
129 ;; `printing' is capable.
131 ;; Then try to set the variables: `pr-ps-name', `pr-ps-printer-alist',
132 ;; `pr-txt-name', `pr-txt-printer-alist' and `pr-path-alist'. These variables
133 ;; are the main variables for printing processing.
135 ;; Now, please, see these variables documentation deeper. You can do this by
136 ;; typing C-h v pr-ps-name RET (for example) if you already loaded printing
137 ;; package, or by browsing printing.el source file.
139 ;; If the documentation isn't clear or if you find a way to improve the
140 ;; documentation, please, send an email to maintainer. All printing users
143 ;; One way to set variables is by calling `pr-customize', customize all
144 ;; variables and save the customization by future sessions (see Options
145 ;; section). Other way is by coding your settings on Emacs init file (that is,
146 ;; ~/.emacs file), see below for a first setting template that it should be
147 ;; inserted on your ~/.emacs file (or c:/_emacs, if you're using Windows 9x/NT
150 ;; * Example of setting for Windows system:
152 ;; (require 'printing) ; load printing package
153 ;; (setq pr-path-alist
154 ;; '((windows "c:/applications/executables" PATH ghostview mpage)
155 ;; (ghostview "c:/gs/gsview-dir")
156 ;; (mpage "c:/mpage-dir")
158 ;; (setq pr-txt-name 'prt_06a)
159 ;; (setq pr-txt-printer-alist
160 ;; '((prt_06a "print" nil "/D:\\\\printers\\prt_06a")
161 ;; (prt_07c nil nil "/D:\\\\printers\\prt_07c")
162 ;; (PRN "" nil "PRN")
163 ;; (standard "redpr.exe" nil "")
165 ;; (setq pr-ps-name 'lps_06b)
166 ;; (setq pr-ps-printer-alist
167 ;; '((lps_06a "print" nil "/D:" "\\\\printers\\lps_06a")
168 ;; (lps_06b "print" nil nil "\\\\printers\\lps_06b")
169 ;; (lps_07c "print" nil "" "/D:\\\\printers\\lps_07c")
170 ;; (lps_08c nil nil nil "\\\\printers\\lps_08c")
171 ;; (LPT1 "" nil "" "LPT1:")
172 ;; (PRN "" nil "" "PRN")
173 ;; (standard "redpr.exe" nil "" "")
175 ;; (pr-update-menus t) ; update now printer and utility menus
177 ;; * Example of setting for GNU or Unix system:
179 ;; (require 'printing) ; load printing package
180 ;; (setq pr-path-alist
181 ;; '((unix "." "~/bin" ghostview mpage PATH)
182 ;; (ghostview "$HOME/bin/gsview-dir")
183 ;; (mpage "$HOME/bin/mpage-dir")
185 ;; (setq pr-txt-name 'prt_06a)
186 ;; (setq pr-txt-printer-alist
187 ;; '((prt_06a "lpr" nil "prt_06a")
188 ;; (prt_07c nil nil "prt_07c")
190 ;; (setq pr-ps-name 'lps_06b)
191 ;; (setq pr-ps-printer-alist
192 ;; '((lps_06b "lpr" nil "-P" "lps_06b")
193 ;; (lps_07c "lpr" nil nil "lps_07c")
194 ;; (lps_08c nil nil nil "lps_08c")
196 ;; (pr-update-menus t) ; update now printer and utility menus
199 ;; NOTE 1: Don't forget to download and install ghostscript utilities (see
200 ;; Utilities section).
202 ;; NOTE 2: The `printer-name' and `ps-printer-name' variables don't need to be
203 ;; set, as they are implicit set by `pr-ps-printer-alist' and
204 ;; `pr-txt-printer-alist'.
206 ;; NOTE 3: The duplex feature will only work on PostScript printers that
207 ;; support this feature.
208 ;; You can check if your PostScript printer supports duplex feature
209 ;; by checking the printer manual. Or you can try these steps:
210 ;; 1. Open a buffer (or use the *scratch* buffer).
212 ;; First line (on first page)
214 ;; Second line (on second page)
215 ;; 3. Print this buffer with duplex turned on.
216 ;; If it's printed 2 (two) sheets of paper, then your PostScript
217 ;; printer doesn't have duplex feature; otherwise, it's ok, your
218 ;; printer does have duplex feature.
220 ;; NOTE 4: See Tips section.
226 ;; 1. If you have a local printer, that is, a printer which is connected
227 ;; directly to your computer, don't forget to connect the printer to your
228 ;; computer before printing.
230 ;; 2. If you try to print a file and it seems that the file was printed, but
231 ;; there is no paper in the printer, then try to set `pr-delete-temp-file'
232 ;; to nil. Probably `printing' is deleting the temporary file before your
233 ;; local system can get it to send to the printer.
235 ;; 3. Don't try to print a dynamic buffer, that is, a buffer which is
236 ;; modifying while `printing' tries to print. Eventually you got an error
237 ;; message. Instead, save the dynamic buffer to a file or copy it in
238 ;; another buffer and, then, print the file or the new static buffer.
239 ;; An example of dynamic buffer is the *Messages* buffer.
241 ;; 4. When running Emacs on Windows (with or without cygwin), check if your
242 ;; printer is a text printer or not by typing in a DOS window:
244 ;; print /D:\\host\printer somefile.txt
246 ;; Where, `host' is the machine where the printer is directly connected,
247 ;; `printer' is the printer name and `somefile.txt' is a text file.
249 ;; If the printer `\\host\printer' doesn't print the content of
250 ;; `somefile.txt' or, instead, it returns the following message:
252 ;; PostScript Error Handler
253 ;; Offending Command = CCC
256 ;; Where `CCC' is whatever is at the beginning of the text to be printed.
258 ;; Therefore, the printer `\\host\printer' is not a text printer, but a
259 ;; PostScript printer. So, please, don't include this printer in
260 ;; `pr-txt-printer-alist' (which see).
262 ;; 5. You can use gsprint instead of ghostscript to print monochrome PostScript
263 ;; files in Windows. The gsprint utility documentation says that it is more
264 ;; efficient than ghostscript to print monochrome PostScript.
266 ;; To print non-monochrome PostScript file, the efficiency of ghostscript
267 ;; is similar to gsprint.
269 ;; Also the gsprint utility comes together with gsview distribution.
271 ;; For more information about gsprint see
272 ;; `http://www.cs.wisc.edu/~ghost/gsview/gsprint.htm'.
274 ;; As an example of gsprint declaration:
276 ;; (setq pr-ps-printer-alist
277 ;; '((A "gsprint" ("-all" "-twoup") "-printer " "my-b/w-printer-name")
278 ;; (B "gsprint" ("-all" "-twoup") nil "-printer my-b/w-printer-name")
279 ;; ;; some other printer declaration
282 ;; The example above declares that printer A prints all pages (-all) and two
283 ;; pages per sheet (-twoup). The printer B declaration does the same as the
284 ;; printer A declaration, the only difference is the printer name selection.
286 ;; There are other command line options like:
288 ;; -mono Render in monochrome as 1bit/pixel (only black and white).
289 ;; -grey Render in greyscale as 8bits/pixel.
290 ;; -color Render in color as 24bits/pixel.
292 ;; The default is `-mono'. So, printer A and B in the example above are
293 ;; using implicitly the `-mono' option. Note that in `-mono' no gray tone
294 ;; or color is printed, this includes the zebra stripes, that is, in `-mono'
295 ;; the zebra stripes are not printed.
297 ;; See also documentation for `pr-ps-printer-alist'.
303 ;; To use `printing' insert in your ~/.emacs file (or c:/_emacs, if you're
304 ;; using Windows 9x/NT or MS-DOS):
306 ;; (require 'printing)
307 ;; ;; ...some user settings...
308 ;; (pr-update-menus t)
310 ;; During `pr-update-menus' evaluation:
312 ;; it replaces the Tools/Print menu by Tools/Printing menu.
314 ;; it replaces the File/Print* menu entries by File/Print menu.
315 ;; Please, see section Menu Layout below for menu explanation.
317 ;; To use `printing' utilities you can use the Printing menu options, type M-x
318 ;; followed by one of the commands below, or type a key associated with the
319 ;; command you want (if there is a key binding).
321 ;; `printing' has the following commands:
324 ;; pr-ps-directory-preview
325 ;; pr-ps-directory-using-ghostscript
326 ;; pr-ps-directory-print
327 ;; pr-ps-directory-ps-print
328 ;; pr-ps-buffer-preview
329 ;; pr-ps-buffer-using-ghostscript
330 ;; pr-ps-buffer-print
331 ;; pr-ps-buffer-ps-print
332 ;; pr-ps-region-preview
333 ;; pr-ps-region-using-ghostscript
334 ;; pr-ps-region-print
335 ;; pr-ps-region-ps-print
336 ;; pr-ps-mode-preview
337 ;; pr-ps-mode-using-ghostscript
339 ;; pr-ps-mode-ps-print
340 ;; pr-ps-file-preview
341 ;; pr-ps-file-up-preview
342 ;; pr-ps-file-using-ghostscript
344 ;; pr-ps-file-ps-print
345 ;; pr-ps-file-up-ps-print
347 ;; pr-despool-preview
348 ;; pr-despool-using-ghostscript
350 ;; pr-despool-ps-print
351 ;; pr-printify-directory
352 ;; pr-printify-buffer
353 ;; pr-printify-region
359 ;; pr-toggle-file-duplex
360 ;; pr-toggle-file-tumble
361 ;; pr-toggle-file-landscape
362 ;; pr-toggle-ghostscript
367 ;; pr-toggle-landscape
368 ;; pr-toggle-upside-down
385 ;; The general meanings of above commands are:
388 ;; `pr-interface' buffer interface for printing package.
389 ;; `pr-help' help for printing package.
390 ;; `pr-ps-name' interactively select a PostScript printer.
391 ;; `pr-txt-name' interactively select a text printer.
392 ;; `pr-ps-utility' interactively select a PostScript utility.
393 ;; `pr-show-*-setup' show current settings.
394 ;; `pr-ps-*' deal with PostScript code generation.
395 ;; `pr-txt-*' deal with text generation.
396 ;; `pr-toggle-*' toggle on/off some boolean variable.
397 ;; `pr-despool-*' despool the PostScript spooling buffer.
398 ;; `pr-printify-*' replace nonprintable ASCII by printable ASCII
402 ;; `*-customize' customization.
403 ;; `*-preview' preview a PostScript file.
404 ;; `*-using-ghostscript' use ghostscript to print.
405 ;; `*-fast-fire' fast fire command (see it for documentation).
406 ;; `*-print' send PostScript directly to printer.
407 ;; `*-ps-print' send PostScript directly to printer or use
408 ;; ghostscript to print. It depends on
409 ;; `pr-print-using-ghostscript' option.
412 ;; `*-directory*' process a directory.
413 ;; `*-buffer*' process a buffer.
414 ;; `*-region*' process a region.
415 ;; `*-mode*' process a major mode (see explanation below).
416 ;; `*-file-*' process a PostScript file.
417 ;; `*-file-up-*' process a PostScript file using a filter utility.
419 ;; Here are some examples:
421 ;; `pr-ps-buffer-using-ghostscript'
422 ;; Use ghostscript to print a buffer.
424 ;; `pr-ps-file-print'
425 ;; Print a PostScript file.
428 ;; Toggle spooling buffer.
430 ;; So you can preview through ghostview, use ghostscript to print (if you don't
431 ;; have a PostScript printer) or send directly to printer a PostScript code
432 ;; generated by `ps-print' package.
434 ;; Besides operating one buffer or region each time, you also can postpone
435 ;; previewing or printing by saving the PostScript code generated in a
436 ;; temporary Emacs buffer. This way you can save banner pages between
437 ;; successive printing. You can toggle on/off spooling by invoking
438 ;; `pr-toggle-spool' interactively or through menu bar.
440 ;; If you type, for example:
442 ;; C-u M-x pr-ps-buffer-print RET
444 ;; The `pr-ps-buffer-print' command prompts you for a n-up printing number and
445 ;; a file name, and save the PostScript code generated to the file name instead
446 ;; of sending to printer.
448 ;; This behavior is similar with the commands that deal with PostScript code
449 ;; generation, that is, with `pr-ps-*' and `pr-despool-*' commands. If
450 ;; spooling is on, only `pr-despool-*' commands prompt for a file name and save
451 ;; the PostScript code spooled in this file.
453 ;; Besides the behavior described above, the `*-directory*' commands also
454 ;; prompt for a directory and a file name regexp. So, it's possible to process
455 ;; all or certain files on a directory at once (see also documentation for
456 ;; `pr-list-directory').
458 ;; `printing' has also a special way to handle some major mode through
459 ;; `*-mode*' commands. So it's possible to customize a major mode printing,
460 ;; it's only needed to declare the customization in `pr-mode-alist' (see
461 ;; section Options) and invoke some of `*-mode*' commands. An example for
462 ;; major mode usage is when you're using gnus (or mh, or rmail, etc.) and
463 ;; you're in the *Summary* buffer, if you forget to switch to the *Article*
464 ;; buffer before printing, you'll get a nicely formatted list of article
465 ;; subjects shows up at the printer. With major mode printing you don't need
466 ;; to switch from gnus *Summary* buffer first.
468 ;; Current global keyboard mapping for GNU Emacs is:
470 ;; (global-set-key [print] 'pr-ps-fast-fire)
471 ;; (global-set-key [M-print] 'pr-ps-mode-using-ghostscript)
472 ;; (global-set-key [S-print] 'pr-ps-mode-using-ghostscript)
473 ;; (global-set-key [C-print] 'pr-txt-fast-fire)
474 ;; (global-set-key [C-M-print] 'pr-txt-fast-fire)
476 ;; And for XEmacs is:
478 ;; (global-set-key 'f22 'pr-ps-fast-fire)
479 ;; (global-set-key '(meta f22) 'pr-ps-mode-using-ghostscript)
480 ;; (global-set-key '(shift f22) 'pr-ps-mode-using-ghostscript)
481 ;; (global-set-key '(control f22) 'pr-txt-fast-fire)
482 ;; (global-set-key '(control meta f22) 'pr-txt-fast-fire)
484 ;; As a suggestion of global keyboard mapping for some `printing' commands:
486 ;; (global-set-key "\C-ci" 'pr-interface)
487 ;; (global-set-key "\C-cbp" 'pr-ps-buffer-print)
488 ;; (global-set-key "\C-cbx" 'pr-ps-buffer-preview)
489 ;; (global-set-key "\C-cbb" 'pr-ps-buffer-using-ghostscript)
490 ;; (global-set-key "\C-crp" 'pr-ps-region-print)
491 ;; (global-set-key "\C-crx" 'pr-ps-region-preview)
492 ;; (global-set-key "\C-crr" 'pr-ps-region-using-ghostscript)
498 ;; Below it's shown a brief description of `printing' options, please, see the
499 ;; options declaration in the code for a long documentation.
501 ;; `pr-path-style' Specify which path style to use for external
504 ;; `pr-path-alist' Specify an alist for command paths.
506 ;; `pr-txt-name' Specify a printer for printing a text file.
508 ;; `pr-txt-printer-alist' Specify an alist of all text printers.
510 ;; `pr-ps-name' Specify a printer for printing a PostScript
513 ;; `pr-ps-printer-alist' Specify an alist for all PostScript printers.
515 ;; `pr-temp-dir' Specify a directory for temporary files during
518 ;; `pr-ps-temp-file' Specify PostScript temporary file name prefix.
520 ;; `pr-file-modes' Specify the file permission bits for newly
523 ;; `pr-gv-command' Specify path and name of the gsview/gv
526 ;; `pr-gs-command' Specify path and name of the ghostscript
529 ;; `pr-gs-switches' Specify ghostscript switches.
531 ;; `pr-gs-device' Specify ghostscript device switch value.
533 ;; `pr-gs-resolution' Specify ghostscript resolution switch value.
535 ;; `pr-print-using-ghostscript' Non-nil means print using ghostscript.
537 ;; `pr-faces-p' Non-nil means print with face attributes.
539 ;; `pr-spool-p' Non-nil means spool printing in a buffer.
541 ;; `pr-file-landscape' Non-nil means print PostScript file in
542 ;; landscape orientation.
544 ;; `pr-file-duplex' Non-nil means print PostScript file in duplex
547 ;; `pr-file-tumble' Non-nil means print PostScript file in tumble
550 ;; `pr-auto-region' Non-nil means region is automagically detected.
552 ;; `pr-auto-mode' Non-nil means major-mode specific printing is
553 ;; prefered over normal printing.
555 ;; `pr-mode-alist' Specify an alist for a major-mode and printing
558 ;; `pr-ps-utility' Specify PostScript utility processing.
560 ;; `pr-ps-utility-alist' Specify an alist for PostScript utility
563 ;; `pr-menu-lock' Non-nil means menu is locked while selecting
566 ;; `pr-menu-char-height' Specify menu char height in pixels.
568 ;; `pr-menu-char-width' Specify menu char width in pixels.
570 ;; `pr-setting-database' Specify an alist for settings in general.
572 ;; `pr-visible-entry-list' Specify a list of Printing menu visible
575 ;; `pr-delete-temp-file' Non-nil means delete temporary files.
577 ;; `pr-list-directory' Non-nil means list directory when processing a
580 ;; `pr-buffer-name' Specify the name of the buffer interface for
583 ;; `pr-buffer-name-ignore' Specify a regexp list for buffer names to be
584 ;; ignored in interface buffer.
586 ;; `pr-buffer-verbose' Non-nil means to be verbose when editing a
587 ;; field in interface buffer.
589 ;; To set the above options you may:
591 ;; a) insert the code in your ~/.emacs, like:
593 ;; (setq pr-faces-p t)
595 ;; This way always keep your default settings when you enter a new Emacs
598 ;; b) or use `set-variable' in your Emacs session, like:
600 ;; M-x set-variable RET pr-faces-p RET t RET
602 ;; This way keep your settings only during the current Emacs session.
604 ;; c) or use customization, for example:
605 ;; click on menu-bar *Help* option,
606 ;; then click on *Customize*,
607 ;; then click on *Browse Customization Groups*,
608 ;; expand *PostScript* group,
609 ;; expand *Printing* group
610 ;; and then customize `printing' options.
611 ;; Through this way, you may choose if the settings are kept or not when
612 ;; you leave out the current Emacs session.
614 ;; d) or see the option value:
616 ;; C-h v pr-faces-p RET
618 ;; and click the *customize* hypertext button.
619 ;; Through this way, you may choose if the settings are kept or not when
620 ;; you leave out the current Emacs session.
624 ;; M-x pr-customize RET
626 ;; and then customize `printing' options.
627 ;; Through this way, you may choose if the settings are kept or not when
628 ;; you leave out the current Emacs session.
630 ;; f) or use menu bar, for example:
631 ;; click on menu-bar *File* option,
632 ;; then click on *Printing*,
633 ;; then click on *Customize*,
634 ;; then click on *printing*
635 ;; and then customize `printing' options.
636 ;; Through this way, you may choose if the settings are kept or not when
637 ;; you leave out the current Emacs session.
643 ;; The `printing' menu (Tools/Printing or File/Print) has the following layout:
645 ;; +-----------------------------+
646 ;; A 0 | Printing Interface |
647 ;; +-----------------------------+ +-A---------+ +-B------+
648 ;; I 1 | PostScript Preview >|-------|Directory >|-----|1-up |
649 ;; 2 | PostScript Print >|---- A |Buffer >|-- B |2-up |
650 ;; 3 | PostScript Printer: name >|---- C |Region >|-- B |4-up |
651 ;; +-----------------------------+ |Mode >|-- B |Other...|
652 ;; II 4 | Printify >|-----\ |File >|--\ +--------+
653 ;; 5 | Print >|---\ | |Despool... | |
654 ;; 6 | Text Printer: name >|-\ | | +-----------+ |
655 ;; +-----------------------------+ | | | +---------+ +------------+
656 ;; III 7 |[ ]Landscape | | | \-|Directory| | No Prep... | Ia
657 ;; 8 |[ ]Print Header | | | |Buffer | +------------+ Ib
658 ;; 9 |[ ]Print Header Frame | | | |Region | | name >|- C
659 ;; 10 |[ ]Line Number | | | +---------+ +------------+
660 ;; 11 |[ ]Zebra Stripes | | | +---------+ | 1-up... | Ic
661 ;; 12 |[ ]Duplex | | \---|Directory| | 2-up... |
662 ;; 13 |[ ]Tumble | \--\ |Buffer | | 4-up... |
663 ;; 14 |[ ]Upside-Down | | |Region | | Other... |
664 ;; 15 | Print All Pages >|--\ | |Mode | +------------+
665 ;; +-----------------------------+ | | +---------+ |[ ]Landscape| Id
666 ;; IV 16 |[ ]Spool Buffer | | | +-C-------+ |[ ]Duplex | Ie
667 ;; 17 |[ ]Print with faces | | \--|( )name A| |[ ]Tumble | If
668 ;; 18 |[ ]Print via Ghostscript | | |( )name B| +------------+
669 ;; +-----------------------------+ | |... |
670 ;; V 19 |[ ]Auto Region | | |(*)name |
671 ;; 20 |[ ]Auto Mode | | |... |
672 ;; 21 |[ ]Menu Lock | | +---------+ +--------------+
673 ;; +-----------------------------+ \------------------|(*)All Pages |
674 ;; VI 22 | Customize >|--- D +-D------+ |( )Even Pages |
675 ;; 23 | Show Settings >|-------|printing| |( )Odd Pages |
676 ;; 24 | Help | |ps-print| |( )Even Sheets|
677 ;; +-----------------------------+ |lpr | |( )Odd Sheets |
678 ;; +--------+ +--------------+
680 ;; See `pr-visible-entry-list' for hiding some parts of the menu.
682 ;; The menu has the following sections:
686 ;; 0. You can use a buffer interface instead of menus. It looks like the
687 ;; customization buffer. Basically, it has the same options found in the
688 ;; menu and some extra options, all this on a buffer.
690 ;; I. PostScript printing:
692 ;; 1. You can generate a PostScript file (if you type C-u before activating
693 ;; menu) or PostScript temporary file for a directory, a buffer, a region
694 ;; or a major mode, choosing 1-up, 2-up, 4-up or any other n-up printing;
695 ;; after file generation, ghostview is activated using the file generated
696 ;; as argument. This option is disabled if spooling is on (option 16).
697 ;; Also, if you already have a PostScript file you can preview it.
698 ;; Instead of previewing each buffer, region or major mode at once, you
699 ;; can save temporarily the PostScript code generated in a buffer and
700 ;; preview it later. The option `Despool...' despools the PostScript
701 ;; spooling buffer in a temporary file and uses ghostview to preview it.
702 ;; If you type C-u before choosing this option, the PostScript code
703 ;; generated is saved in a file instead of saving in a temporary file.
704 ;; To spool the PostScript code generated you need to turn on the option
705 ;; 16. The option `Despool...' is enabled if spooling is on (option
708 ;; NOTE 1: It's possible to customize a major mode printing, just declare
709 ;; the customization in `pr-mode-alist' and invoke some of
710 ;; `*-mode*' commands or select Mode option in Printing menu. An
711 ;; example for major mode usage is when you're using gnus (or mh,
712 ;; or rmail, etc.) and you're in the *Summary* buffer, if you
713 ;; forget to switch to the *Article* buffer before printing,
714 ;; you'll get a nicely formatted list of article subjects shows
715 ;; up at the printer. With major mode printing you don't need to
716 ;; switch from gnus *Summary* buffer first.
718 ;; NOTE 2: There are the following options for PostScript file
720 ;; Ia. Print the file *No Preprocessing*, that is, send it
721 ;; directly to PostScript printer.
722 ;; Ib. PostScript utility processing selection.
723 ;; See `pr-ps-utility-alist' and `pr-setting-database' for
725 ;; Ic. Do n-up processing before printing.
726 ;; Id. Toggle on/off landscape for PostScript file processing.
727 ;; Ie. Toggle on/off duplex for PostScript file processing.
728 ;; If. Toggle on/off tumble for PostScript file processing.
730 ;; NOTE 3: Don't forget to download and install the utilities declared on
731 ;; `pr-ps-utility-alist'.
733 ;; 2. Operate the same way as option 1, but it sends directly the PostScript
734 ;; code (or put in a file, if you've typed C-u) or it uses ghostscript to
735 ;; print the PostScript file generated. It depends on option 18, if it's
736 ;; turned on, it uses ghostscript; otherwise, it sends directly to
737 ;; printer. If spooling is on (option 16), the PostScript code is saved
738 ;; temporarily in a buffer instead of printing it or saving it in a file.
739 ;; Also, if you already have a PostScript file you can print it. Instead
740 ;; of printing each buffer, region or major mode at once, you can save
741 ;; temporarily the PostScript code generated in a buffer and print it
742 ;; later. The option `Despool...' despools the PostScript spooling
743 ;; buffer directly on a printer. If you type C-u before choosing this
744 ;; option, the PostScript code generated is saved in a file instead of
745 ;; sending to printer. To spool the PostScript code generated you need
746 ;; to turn on the option 16. This option is enabled if spooling is on
747 ;; (option 16). See also the NOTE 1, NOTE 2 and NOTE 3 on option 1.
749 ;; 3. You can select a new PostScript printer to send PostScript code
750 ;; generated. For selection it's used all PostScript printers defined
751 ;; in `pr-ps-printer-alist' variable (see it for documentation).
752 ;; See also `pr-setting-database'.
754 ;; II. Text printing:
756 ;; 4. If you have control characters (character code from \000 to \037) in a
757 ;; buffer and you want to print them in a text printer, select this
758 ;; option. All control characters in your buffer or region will be
759 ;; replaced by a printable representation. The printable representations
760 ;; use ^ (for ASCII control characters) or hex. The characters tab,
761 ;; linefeed, space, return and formfeed are not affected. You don't need
762 ;; to select this option if you use any option of section I, the
763 ;; PostScript engine treats control characters properly.
765 ;; 5. If you want to print a directory, buffer, region or major mode in a
766 ;; text printer, select this option. See also the NOTE 1 on option 1.
768 ;; 6. You can select a new text printer to send text generated. For
769 ;; selection it's used all text printers defined in
770 ;; `pr-txt-printer-alist' variable (see it for documentation).
771 ;; See also `pr-setting-database'.
773 ;; III. PostScript page toggle options:
775 ;; 7. If you want a PostScript landscape printing, turn on this option.
777 ;; 8. If you want to have a header in each page in your PostScript code,
778 ;; turn on this option.
780 ;; 9. If you want to draw a gaudy frame around the header, turn on this
781 ;; option. This option is enabled if print header is on (option 8).
783 ;; 10. If you want that the line number is printed in your PostScript code,
784 ;; turn on this option.
786 ;; 11. If you want background zebra stripes in your PostScript code, turn on
789 ;; 12. If you want a duplex printing and your PostScript printer has this
790 ;; feature, turn on this option.
792 ;; 13. If you turned on duplex printing, you can choose if you want to have
793 ;; a printing suitable for binding on the left or right (tumble off), or
794 ;; to have a printing suitable for binding at top or bottom (tumble on).
795 ;; This option is enabled if duplex is on (option 12).
797 ;; 14. If you want a PostScript upside-down printing, turn on this option.
799 ;; 15. With this option, you can choose if you want to print all pages, odd
800 ;; pages, even pages, odd sheets or even sheets.
801 ;; See also `ps-even-or-odd-pages'.
803 ;; IV. PostScript processing toggle options:
805 ;; 16. If you want to spool the PostScript code generated, turn on this
806 ;; option. To spool the PostScript code generated use option 2. You
807 ;; can despool later by choosing option 1 or 2, sub-option `Despool...'.
809 ;; 17. If you use colors in your buffers and want to see these colors on
810 ;; your PostScript code generated, turn on this option. If you have a
811 ;; black/white PostScript printer, these colors are displayed in gray
812 ;; scale by PostScript printer interpreter.
814 ;; 18. If you don't have a PostScript printer to send PostScript files, turn
815 ;; on this option. When this option is on, the ghostscript is used to
816 ;; print PostScript files. In GNU or Unix system, if ghostscript is set
817 ;; as a PostScript filter, you don't need to turn on this option.
819 ;; V. Printing customization:
821 ;; 19. If you want that region is automagically detected, turn on this
822 ;; option. Note that this will only work if you're using transient mark
823 ;; mode. When this option is on, the `*-buffer*' commands will behave
824 ;; like `*-region*' commands, that is, `*-buffer*' commands will print
825 ;; only the region marked instead of all buffer.
827 ;; 20. Turn this option on if you want that when current major-mode is
828 ;; declared in `pr-mode-alist', the `*-buffer*' and `*-region*' commands
829 ;; behave like `*-mode*' commands.
831 ;; 21. If you want that Printing menu stays open while you are setting
832 ;; toggle options, turn on this option. The variables
833 ;; `pr-menu-char-height' and `pr-menu-char-width' are used to guess the
834 ;; menu position, so don't forget to adjust these variables if menu
835 ;; position is not ok.
837 ;; VI. Customization:
839 ;; 22. Besides all options in section III, IV and V, you can customize much
840 ;; more PostScript options in `ps-print' option. Or you can customize
841 ;; some `lpr' options for text printing. Or customize `printing'
844 ;; 23. Show current settings for `printing', `ps-print' or `lpr'.
846 ;; 24. Quick help for printing menu layout.
852 ;; Below it's shown only the main options that affect all `printing' package.
853 ;; Check all the settings below *BEFORE* running `printing' commands.
855 ;; * Example of setting for GNU or Unix system:
857 ;; (require 'printing)
858 ;; (setq pr-path-alist
859 ;; '((unix "." "~/bin" ghostview mpage PATH)
860 ;; (ghostview "$HOME/bin/gsview-dir")
861 ;; (mpage "$HOME/bin/mpage-dir")
863 ;; (setq pr-txt-name 'prt_06a)
864 ;; (setq pr-txt-printer-alist
865 ;; '((prt_06a "lpr" nil "prt_06a")
866 ;; (prt_07c nil nil "prt_07c")
868 ;; (setq pr-ps-name 'lps_06b)
869 ;; (setq pr-ps-printer-alist
870 ;; '((lps_06b "lpr" nil "-P" "lps_06b")
871 ;; (lps_07c "lpr" nil nil "lps_07c")
872 ;; (lps_08c nil nil nil "lps_08c")
874 ;; (setq pr-temp-dir "/tmp/")
875 ;; (setq pr-gv-command "gv")
876 ;; (setq pr-gs-command "gs")
877 ;; (setq pr-gs-switches '("-q -dNOPAUSE -I/usr/share/ghostscript/5.10"))
878 ;; (setq pr-gs-device "uniprint")
879 ;; (setq pr-gs-resolution 300)
880 ;; (setq pr-ps-utility 'mpage)
881 ;; (setq pr-ps-utility-alist
882 ;; '((mpage "mpage" nil "-b%s" "-%d" "-l" "-t" "-T" ">" nil)
883 ;; (psnup "psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
884 ;; (inherits-from: . no-duplex))
886 ;; (setq pr-setting-database
889 ;; (pr-file-duplex . nil)
890 ;; (pr-file-tumble . nil))
892 ;; (pr-update-menus t) ; update now printer and utility menus
894 ;; * Example of setting for Windows system:
896 ;; (require 'printing)
897 ;; (setq pr-path-alist
898 ;; '((windows "c:/applications/executables" PATH ghostview mpage)
899 ;; (ghostview "c:/gs/gsview-dir")
900 ;; (mpage "c:/mpage-dir")
902 ;; (setq pr-txt-name 'prt_06a)
903 ;; (setq pr-txt-printer-alist
904 ;; '((prt_06a "print" nil "/D:\\\\printers\\prt_06a")
905 ;; (prt_07c nil nil "/D:\\\\printers\\prt_07c")
906 ;; (PRN "" nil "PRN")
907 ;; (standard "redpr.exe" nil "")
909 ;; (setq pr-ps-name 'lps_06b)
910 ;; (setq pr-ps-printer-alist
911 ;; '((lps_06a "print" nil "/D:" "\\\\printers\\lps_06a")
912 ;; (lps_06b "print" nil nil "\\\\printers\\lps_06b")
913 ;; (lps_07c "print" nil "" "/D:\\\\printers\\lps_07c")
914 ;; (lps_08c nil nil nil "\\\\printers\\lps_08c")
915 ;; (b/w "gsprint" ("-all" "-twoup") "-printer " "b/w-pr-name")
916 ;; (LPT1 "" nil "" "LPT1:")
917 ;; (PRN "" nil "" "PRN")
918 ;; (standard "redpr.exe" nil "" "")
920 ;; (setq pr-temp-dir "C:/WINDOWS/TEMP/")
921 ;; (setq pr-gv-command "c:/gs/gsview/gsview32.exe")
922 ;; (setq pr-gs-command "c:/gs/gswin32.exe")
923 ;; (setq pr-gs-switches '("-q -dNOPAUSE -Ic:/gs/gs5.50;c:/gs/gs5.50/fonts"))
924 ;; (setq pr-gs-device "mswinpr2")
925 ;; (setq pr-gs-resolution 300)
926 ;; (setq pr-ps-utility 'psnup)
927 ;; (setq pr-ps-utility-alist
928 ;; '((psnup "c:/psutils/psnup" ("-q") "-P%s" "-%d" "-l" nil nil " "
929 ;; nil (inherits-from: . no-duplex))
931 ;; (setq pr-setting-database
934 ;; (pr-file-duplex . nil)
935 ;; (pr-file-tumble . nil))
937 ;; (pr-update-menus t) ; update now printer and utility menus
939 ;; NOTE: Don't forget to download and install the utilities declared on
940 ;; `pr-ps-utility-alist'.
946 ;; `printing' package has the following utilities:
948 ;; `pr-setup' Return the current `printing' setup.
950 ;; `lpr-setup' Return the current `lpr' setup.
952 ;; `pr-update-menus' Update utility, PostScript and text printer menus.
954 ;; `pr-menu-bind' Install `printing' menu in the menubar.
957 ;; Below are some URL where you can find good utilities.
959 ;; * For `printing' package:
961 ;; printing `http://www.cpqd.com.br/~vinicius/emacs/printing.el.gz'
962 ;; ps-print `http://www.cpqd.com.br/~vinicius/emacs/ps-print.tar.gz'
964 ;; * For GNU or Unix system:
966 ;; gs, gv `http://www.gnu.org/software/ghostscript/ghostscript.html'
967 ;; enscript `http://people.ssh.fi/mtr/genscript/'
968 ;; psnup `http://www.knackered.org/angus/psutils/'
969 ;; mpage `http://www.mesa.nl/pub/mpage/'
971 ;; * For Windows system:
974 ;; `http://www.gnu.org/software/ghostscript/ghostscript.html'
975 ;; gsprint `http://www.cs.wisc.edu/~ghost/gsview/gsprint.htm'.
976 ;; enscript `http://people.ssh.fi/mtr/genscript/'
977 ;; psnup `http://gnuwin32.sourceforge.net/packages/psutils.htm'
978 ;; redmon `http://www.cs.wisc.edu/~ghost/redmon/'
984 ;; Thanks to Stefan Monnier <monnier@iro.umontreal.ca> for GNU Emacs and XEmacs
985 ;; printing menu (in `pr-menu-spec') merging suggestion.
987 ;; Thanks to Lennart Borgman <lennart.borgman.073@student.lu.se> for gsprint
988 ;; suggestion (see tip 5 in section Tips).
990 ;; Thanks to Drew Adams <drew.adams@oracle.com> for suggestions:
991 ;; - directory processing.
992 ;; - `pr-path-alist' variable.
994 ;; - a lot of tests on Windows.
996 ;; Thanks to Fred Labrosse <f.labrosse@maths.bath.ac.uk> for XEmacs tests.
998 ;; Thanks to Klaus Berndl <klaus.berndl@sdm.de> for invaluable help/debugging
999 ;; and for suggestions:
1000 ;; - even/odd pages printing.
1001 ;; - ghostscript parameters for `pr-ps-printer-alist'.
1002 ;; - default printer name.
1003 ;; - completion functions.
1004 ;; - automagic region detection.
1005 ;; - menu entry hiding.
1006 ;; - fast fire PostScript printing command.
1007 ;; - `pr-path-style' variable.
1009 ;; Thanks to Kim F. Storm <storm@filanet.dk> for beta-test and for suggestions:
1010 ;; - PostScript Print and PostScript Print Preview merge.
1011 ;; - Tools/Printing menu.
1012 ;; - replace *-using-preview by *-using-ghostscript.
1013 ;; - printer selection.
1014 ;; - extra parameters for `pr-ps-printer-alist'.
1017 ;; Frederic Corne <frederic.corne@erli.fr> print-nt.el
1018 ;; Tom Vogels <tov@ece.cmu.edu> mh-e-init.el
1019 ;; Matthew O. Persico <mpersico@erols.com> win32-ps-print.el
1020 ;; Volker Franz <volker.franz@tuebingen.mpg.de> ps-print-interface.el
1021 ;; And to all people who contributed with them.
1024 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1033 (and (string< ps-print-version "6.6.4")
1034 (error "`printing' requires `ps-print' package version 6.6.4 or later"))
1037 (defconst pr-cygwin-system
1038 (and ps-windows-system (getenv "OSTYPE")
1039 (string-match "cygwin" (getenv "OSTYPE"))))
1042 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1043 ;; To avoid compilation gripes
1046 (or (fboundp 'subst-char-in-string) ; hacked from subr.el
1047 (defun subst-char-in-string (fromchar tochar string &optional inplace)
1048 "Replace FROMCHAR with TOCHAR in STRING each time it occurs.
1049 Unless optional argument INPLACE is non-nil, return a new string."
1050 (let ((i (length string))
1051 (newstr (if inplace string (copy-sequence string))))
1052 (while (> (setq i (1- i)) 0)
1053 (if (eq (aref newstr i) fromchar)
1054 (aset newstr i tochar)))
1058 (or (fboundp 'make-temp-file) ; hacked from subr.el
1059 (defun make-temp-file (prefix &optional dir-flag suffix)
1060 "Create a temporary file.
1061 The returned file name (created by appending some random characters at the end
1062 of PREFIX, and expanding against `temporary-file-directory' if necessary),
1063 is guaranteed to point to a newly created empty file.
1064 You can then use `write-region' to write new data into the file.
1066 If DIR-FLAG is non-nil, create a new empty directory instead of a file.
1068 If SUFFIX is non-nil, add that at the end of the file name."
1069 (let ((umask (default-file-modes))
1073 ;; Create temp files with strict access rights. It's easy to
1074 ;; loosen them later, whereas it's impossible to close the
1075 ;; time-window of loose permissions otherwise.
1076 (set-default-file-modes ?\700)
1077 (while (condition-case ()
1081 (expand-file-name prefix temporary-file-directory)))
1083 (setq file (concat file suffix)))
1085 (make-directory file)
1086 (write-region "" nil file nil 'silent nil 'excl))
1088 (file-already-exists t))
1089 ;; the file was somehow created by someone else between
1090 ;; `make-temp-name' and `write-region', let's try again.
1094 (set-default-file-modes umask)))))
1098 (defalias 'pr-e-frame-char-height 'frame-char-height)
1099 (defalias 'pr-e-frame-char-width 'frame-char-width)
1100 (defalias 'pr-e-mouse-pixel-position 'mouse-pixel-position)
1102 (defalias 'pr-x-add-submenu 'add-submenu)
1103 (defalias 'pr-x-event-function 'event-function)
1104 (defalias 'pr-x-event-object 'event-object)
1105 (defalias 'pr-x-find-menu-item 'find-menu-item)
1106 (defalias 'pr-x-font-height 'font-height)
1107 (defalias 'pr-x-font-width 'font-width)
1108 (defalias 'pr-x-get-popup-menu-response 'get-popup-menu-response)
1109 (defalias 'pr-x-make-event 'make-event)
1110 (defalias 'pr-x-misc-user-event-p 'misc-user-event-p)
1111 (defalias 'pr-x-relabel-menu-item 'relabel-menu-item)
1112 (defalias 'pr-x-event-x-pixel 'event-x-pixel)
1113 (defalias 'pr-x-event-y-pixel 'event-y-pixel)
1116 ((featurep 'xemacs) ; XEmacs
1117 (defvar current-menubar nil)
1118 (defvar current-mouse-event nil)
1119 (defvar zmacs-region-stays nil)
1120 (defalias 'pr-f-set-keymap-parents 'set-keymap-parents)
1121 (defalias 'pr-f-set-keymap-name 'set-keymap-name)
1122 (defun pr-f-read-string (prompt initial history default)
1123 (let ((str (read-string prompt initial)))
1124 (if (and str (not (string= str "")))
1127 (defun pr-keep-region-active ()
1128 (setq zmacs-region-stays t)))
1131 (defvar deactivate-mark nil)
1132 (defalias 'pr-f-set-keymap-parents 'set-keymap-parent)
1133 (defalias 'pr-f-set-keymap-name 'ignore)
1134 (defalias 'pr-f-read-string 'read-string)
1135 (defun pr-keep-region-active ()
1136 (setq deactivate-mark nil))))
1139 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1140 ;; Customization Functions
1143 (defun pr-alist-custom-set (symbol value)
1144 "Set the value of custom variables for printer & utility selection."
1146 (and (featurep 'printing) ; update only after printing is loaded
1147 (not pr-menu-print-item)
1148 (pr-update-menus t)))
1151 (defun pr-ps-utility-custom-set (symbol value)
1152 "Update utility menu entry."
1154 (and (featurep 'printing) ; update only after printing is loaded
1155 (not pr-menu-print-item)
1156 (pr-menu-set-utility-title value)))
1159 (defun pr-ps-name-custom-set (symbol value)
1160 "Update `PostScript Printer:' menu entry."
1162 (and (featurep 'printing) ; update only after printing is loaded
1163 (not pr-menu-print-item)
1164 (pr-menu-set-ps-title value)))
1167 (defun pr-txt-name-custom-set (symbol value)
1168 "Update `Text Printer:' menu entry."
1170 (and (featurep 'printing) ; update only after printing is loaded
1171 (not pr-menu-print-item)
1172 (pr-menu-set-txt-title value)))
1175 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1176 ;; User Interface (I)
1179 (defgroup printing nil
1180 "Printing Utilities group."
1181 :tag "Printing Utilities"
1182 :link '(emacs-library-link :tag "Source Lisp File" "printing.el")
1189 (defcustom pr-path-style
1190 (if (and (not pr-cygwin-system)
1194 "*Specify which path style to use for external commands.
1198 windows Windows 9x/NT style (\\)
1200 unix Unix style (/)"
1201 :type '(choice :tag "Path style"
1202 (const :tag "Windows 9x/NT Style (\\)" :value windows)
1203 (const :tag "Unix Style (/)" :value unix))
1208 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1209 ;; Internal Functions (I)
1212 (defun pr-dosify-file-name (path)
1213 "Replace unix-style directory separator character with dos/windows one."
1214 (interactive "sPath: ")
1215 (if (eq pr-path-style 'windows)
1216 (subst-char-in-string ?/ ?\\ path)
1220 (defun pr-unixify-file-name (path)
1221 "Replace dos/windows-style directory separator character with unix one."
1222 (interactive "sPath: ")
1223 (if (eq pr-path-style 'windows)
1224 (subst-char-in-string ?\\ ?/ path)
1228 (defun pr-standard-file-name (path)
1229 "Ensure the proper directory separator depending on the OS.
1230 That is, if Emacs is running on DOS/Windows, ensure dos/windows-style directory
1231 separator; otherwise, ensure unix-style directory separator."
1232 (if (or pr-cygwin-system ps-windows-system)
1233 (subst-char-in-string ?/ ?\\ path)
1234 (subst-char-in-string ?\\ ?/ path)))
1237 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1238 ;; User Interface (II)
1241 (defcustom pr-path-alist
1245 "*Specify an alist for command paths.
1247 It's used to find commands used for printing package, like gv, gs, gsview.exe,
1248 mpage, print.exe, etc. See also `pr-command' function.
1250 Each element has the form:
1252 (ENTRY DIRECTORY...)
1256 ENTRY It's a symbol, used to identify this entry.
1257 There must exist at least one of the following entries:
1259 unix this entry is used when Emacs is running on GNU or
1262 cygwin this entry is used when Emacs is running on Windows
1263 95/98/NT/2000 with Cygwin.
1265 windows this entry is used when Emacs is running on Windows
1268 DIRECTORY It should be a string or a symbol. If it's a symbol, it should
1269 exist an equal entry in `pr-path-alist'. If it's a string,
1270 it's considered a directory specification.
1272 The directory specification may contain:
1273 $var environment variable expansion
1275 ./ current directory
1276 ../ previous directory
1278 For example, let's say the home directory is /home/my and the
1279 current directory is /home/my/dir, so:
1281 THE ENTRY IS EXPANDED TO
1282 ~/entry /home/my/entry
1283 ./entry /home/my/dir/entry
1284 ../entry /home/my/entry
1285 $HOME/entry /home/my/entry
1286 $HOME/~/other/../my/entry /home/my/entry
1288 SPECIAL SYMBOL: If the symbol `PATH' is used in the directory
1289 list and there isn't a `PATH' entry in `pr-path-alist' or the
1290 `PATH' entry has a null directory list, the PATH environment
1295 * On GNU or Unix system:
1297 '((unix \".\" \"~/bin\" ghostview mpage PATH)
1298 (ghostview \"$HOME/bin/gsview-dir\")
1299 (mpage \"$HOME/bin/mpage-dir\")
1302 * On Windows system:
1304 '((windows \"c:/applications/executables\" PATH ghostview mpage)
1305 (ghostview \"c:/gs/gsview-dir\")
1306 (mpage \"c:/mpage-dir\")
1310 (symbol :tag "Identifier ")
1311 (repeat :tag "Directory List"
1312 (choice :menu-tag "Directory"
1315 (symbol :value symbol)))))
1320 (defcustom pr-txt-name 'default
1321 "*Specify a printer for printing a text file.
1323 The printer name symbol should be defined on `pr-txt-printer-alist' (see it for
1326 This variable should be modified by customization engine. If this variable is
1327 modified by other means (for example, a lisp function), use `pr-update-menus'
1328 function (see it for documentation) to update text printer menu."
1330 :set 'pr-txt-name-custom-set
1335 (defcustom pr-txt-printer-alist
1336 (list (list 'default lpr-command nil
1337 (cond ((boundp 'printer-name) printer-name)
1338 (ps-windows-system "PRN")
1342 ;; * On GNU or Unix system:
1343 ;; '((prt_06a "lpr" nil "prt_06a")
1344 ;; (prt_07c nil nil "prt_07c")
1346 ;; * On Windows system:
1347 ;; '((prt_06a "print" nil "/D:\\\\printers\\prt_06a")
1348 ;; (prt_07c nil nil "/D:\\\\printers\\prt_07c")
1349 ;; (PRN "" nil "PRN")
1350 ;; (standard "redpr.exe" nil "")
1352 "*Specify an alist of all text printers (text printer database).
1354 The alist element has the form:
1356 (SYMBOL COMMAND SWITCHES NAME)
1360 SYMBOL It's a symbol to identify a text printer. It's for
1361 `pr-txt-name' variable setting and for menu selection.
1366 COMMAND Name of the program for printing a text file. On MS-DOS and
1367 MS-Windows systems, if the value is an empty string, then Emacs
1368 will write directly to the printer port given by NAME (see text
1369 below), that is, the NAME should be something like \"PRN\" or
1371 If NAME is something like \"\\\\\\\\host\\\\share-name\" then
1372 COMMAND shouldn't be an empty string.
1373 The programs `print' and `nprint' (the standard print programs
1374 on Windows NT and Novell Netware respectively) are handled
1375 specially, using NAME as the destination for output; any other
1376 program is treated like `lpr' except that an explicit filename
1377 is given as the last argument.
1378 If COMMAND is nil, it's used the default printing program:
1379 `print' for Windows system, `lp' for lp system and `lpr' for
1380 all other systems. See also `pr-path-alist'.
1386 SWITCHES List of sexp's to pass as extra options for text printer
1387 program. It is recommended to set NAME (see text below)
1388 instead of including an explicit switch on this list.
1394 NAME A string that specifies a text printer name.
1395 On Unix-like systems, a string value should be a name
1396 understood by lpr's -P option (or lp's -d option).
1397 On MS-DOS and MS-Windows systems, it is the name of a printer
1398 device or port. Typical non-default settings would be \"LPT1:\"
1399 to \"LPT3:\" for parallel printers, or \"COM1\" to \"COM4\" or
1400 \"AUX\" for serial printers, or \"\\\\\\\\hostname\\\\printer\"
1401 (or \"/D:\\\\\\\\hostname\\\\printer\") for a shared network
1402 printer. You can also set it to a name of a file, in which
1403 case the output gets appended to that file. If you want to
1404 discard the printed output, set this to \"NUL\".
1407 \"/D:\\\\\\\\host\\\\share-name\"
1414 This variable should be modified by customization engine. If this variable is
1415 modified by other means (for example, a lisp function), use `pr-update-menus'
1416 function (see it for documentation) to update text printer menu.
1420 * On GNU or Unix system:
1422 '((prt_06a \"lpr\" nil \"prt_06a\")
1423 (prt_07c nil nil \"prt_07c\")
1426 * On Windows system:
1428 '((prt_06a \"print\" nil \"/D:\\\\\\\\printers\\\\prt_06a\")
1429 (prt_07c nil nil \"/D:\\\\\\\\printers\\\\prt_07c\")
1430 (PRN \"\" nil \"PRN\")
1431 (standard \"redpr.exe\" nil \"\")
1436 * Information about the print command (print.exe)
1437 `http://www.computerhope.com/printhlp.htm'
1439 * RedMon - Redirection Port Monitor (redpr.exe)
1440 `http://www.cs.wisc.edu/~ghost/redmon/index.htm'
1442 * Redirection Port Monitor (redpr.exe on-line help)
1443 `http://www.cs.wisc.edu/~ghost/redmon/en/redmon.htm'
1445 * UNIX man pages: lpr (or type `man lpr')
1446 `http://bama.ua.edu/cgi-bin/man-cgi?lpr'
1447 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lpr'
1449 * UNIX man pages: lp (or type `man lp')
1450 `http://bama.ua.edu/cgi-bin/man-cgi?lp'
1451 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lp'
1454 (list :tag "Text Printer"
1455 (symbol :tag "Printer Symbol Name")
1456 (string :tag "Printer Command")
1457 (repeat :tag "Printer Switches"
1458 (sexp :tag "Switch" :value ""))
1459 (choice :menu-tag "Printer Name"
1461 (const :tag "None" nil)
1463 :set 'pr-alist-custom-set
1468 (defcustom pr-ps-name 'default
1469 "*Specify a printer for printing a PostScript file.
1471 This printer name symbol should be defined on `pr-ps-printer-alist' (see it for
1474 This variable should be modified by customization engine. If this variable is
1475 modified by other means (for example, a lisp function), use `pr-update-menus'
1476 function (see it for documentation) to update PostScript printer menu."
1478 :set 'pr-ps-name-custom-set
1483 (defcustom pr-ps-printer-alist
1484 (list (list 'default lpr-command nil
1485 (cond (ps-windows-system nil)
1488 (or (getenv "PRINTER") (getenv "LPDEST") ps-printer-name)))
1490 ;; * On GNU or Unix system:
1491 ;; '((lps_06b "lpr" nil "-P" "lps_06b")
1492 ;; (lps_07c "lpr" nil nil "lps_07c")
1493 ;; (lps_08c nil nil nil "lps_08c")
1495 ;; * On Windows system:
1496 ;; '((lps_06a "print" nil "/D:" "\\\\printers\\lps_06a")
1497 ;; (lps_06b "print" nil nil "\\\\printers\\lps_06b")
1498 ;; (lps_07c "print" nil "" "/D:\\\\printers\\lps_07c")
1499 ;; (lps_08c nil nil nil "\\\\printers\\lps_08c")
1500 ;; (b/w "gsprint" ("-all" "-twoup") "-printer " "b/w-pr-name")
1501 ;; (LPT1 "" nil "" "LPT1:")
1502 ;; (PRN "" nil "" "PRN")
1503 ;; (standard "redpr.exe" nil "" "")
1505 "*Specify an alist for all PostScript printers (PostScript printer database).
1507 The alist element has the form:
1509 (SYMBOL COMMAND SWITCHES PRINTER-SWITCH NAME DEFAULT...)
1513 SYMBOL It's a symbol to identify a PostScript printer. It's for
1514 `pr-ps-name' variable setting and for menu selection.
1519 COMMAND Name of the program for printing a PostScript file. On MS-DOS
1520 and MS-Windows systems, if the value is an empty string then
1521 Emacs will write directly to the printer port given by NAME
1522 (see text below), that is, the NAME should be something like
1523 \"PRN\" or \"LPT1:\".
1524 If NAME is something like \"\\\\\\\\host\\\\share-name\" then
1525 COMMAND shouldn't be an empty string.
1526 The programs `print' and `nprint' (the standard print programs
1527 on Windows NT and Novell Netware respectively) are handled
1528 specially, using NAME as the destination for output; any other
1529 program is treated like `lpr' except that an explicit filename
1530 is given as the last argument.
1531 If COMMAND is nil, it's used the default printing program:
1532 `print' for Windows system, `lp' for lp system and `lpr' for
1533 all other systems. See also `pr-path-alist'.
1541 SWITCHES List of sexp's to pass as extra options for PostScript printer
1542 program. It is recommended to set NAME (see text below)
1543 instead of including an explicit switch on this list.
1550 '(\"-all\" \"-twoup\")
1552 PRINTER-SWITCH A string that specifies PostScript printer name switch. If
1553 it's necessary to have a space between PRINTER-SWITCH and NAME,
1554 it should be inserted at the end of PRINTER-SWITCH string.
1555 If PRINTER-SWITCH is nil, it's used the default printer name
1556 switch: `/D:' for Windows system, `-d' for lp system and `-P'
1557 for all other systems.
1571 NAME A string that specifies a PostScript printer name.
1572 On Unix-like systems, a string value should be a name
1573 understood by lpr's -P option (or lp's -d option).
1574 On MS-DOS and MS-Windows systems, it is the name of a printer
1575 device or port. Typical non-default settings would be \"LPT1:\"
1576 to \"LPT3:\" for parallel printers, or \"COM1\" to \"COM4\" or
1577 \"AUX\" for serial printers, or \"\\\\\\\\hostname\\\\printer\"
1578 (or \"/D:\\\\\\\\hostname\\\\printer\") for a shared network
1579 printer. You can also set it to a name of a file, in which
1580 case the output gets appended to that file. If you want to
1581 discard the printed output, set this to \"NUL\".
1584 \"\\\\\\\\host\\\\share-name\"
1586 . for print.exe or gsprint.exe
1587 \"/D:\\\\\\\\host\\\\share-name\"
1588 \"\\\\\\\\host\\\\share-name\"
1595 DEFAULT It's a way to set default values when this entry is selected.
1600 That associates VARIABLE with VALUE. when this entry is
1601 selected, it's executed the following command:
1603 (set VARIABLE (eval VALUE))
1605 Note that VALUE can be any valid lisp expression. So, don't
1606 forget to quote symbols and constant lists.
1607 If VARIABLE is the special keyword `inherits-from:', VALUE must
1608 be a symbol name setting defined in `pr-setting-database' from
1609 which the current setting inherits the context. Take care with
1610 circular inheritance.
1612 '(ps-landscape-mode . nil)
1613 '(ps-spool-duplex . t)
1614 '(pr-gs-device . (my-gs-device t))
1616 This variable should be modified by customization engine. If this variable is
1617 modified by other means (for example, a lisp function), use `pr-update-menus'
1618 function (see it for documentation) to update PostScript printer menu.
1622 * On GNU or Unix system:
1624 '((lps_06b \"lpr\" nil \"-P\" \"lps_06b\")
1625 (lps_07c \"lpr\" nil nil \"lps_07c\")
1626 (lps_08c nil nil nil \"lps_08c\")
1629 * On Windows system:
1631 '((lps_06a \"print\" nil \"/D:\" \"\\\\\\\\printers\\\\lps_06a\")
1632 (lps_06b \"print\" nil nil \"\\\\\\\\printers\\\\lps_06b\")
1633 (lps_07c \"print\" nil \"\" \"/D:\\\\\\\\printers\\\\lps_07c\")
1634 (lps_08c nil nil nil \"\\\\\\\\printers\\\\lps_08c\")
1635 (b/w1 \"gsprint\" (\"-all\" \"-twoup\") \"-printer \" \"b/w-pr-name\")
1636 (b/w2 \"gsprint\" (\"-all\" \"-twoup\") nil \"-printer \\\\\\\\printers\\\\lps_06a\")
1637 (LPT1 \"\" nil \"\" \"LPT1:\")
1638 (PRN \"\" nil \"\" \"PRN\")
1639 (standard \"redpr.exe\" nil \"\" \"\")
1645 You can use gsprint instead of ghostscript to print monochrome PostScript files
1646 in Windows. The gsprint utility documentation says that it is more efficient
1647 than ghostscript to print monochrome PostScript.
1649 To print non-monochrome PostScript file, the efficiency of ghostscript is
1652 Also the gsprint utility comes together with gsview distribution.
1654 As an example of gsprint declaration:
1656 (setq pr-ps-printer-alist
1657 '((A \"gsprint\" (\"-all\" \"-twoup\") \"-printer \" \"lps_015\")
1658 (B \"gsprint\" (\"-all\" \"-twoup\") nil \"-printer lps_015\")
1659 ;; some other printer declaration
1662 The example above declares that printer A prints all pages (-all) and two pages
1663 per sheet (-twoup). The printer B declaration does the same as the printer A
1664 declaration, the only difference is the printer name selection.
1666 There are other command line options like:
1668 -mono Render in monochrome as 1bit/pixel (only black and white).
1669 -grey Render in greyscale as 8bits/pixel.
1670 -color Render in color as 24bits/pixel.
1672 The default is `-mono'. So, printer A and B in the example above are using
1673 implicitly the `-mono' option. Note that in `-mono' no gray tone or color is
1674 printed, this includes the zebra stripes, that is, in `-mono' the zebra stripes
1680 * GSPRINT - Ghostscript print to Windows printer
1681 `http://www.cs.wisc.edu/~ghost/gsview/gsprint.htm'
1683 * Introduction to Ghostscript
1684 `http://www.cs.wisc.edu/~ghost/doc/intro.htm'
1686 * How to use Ghostscript
1687 `http://www.cs.wisc.edu/~ghost/doc/cvs/Use.htm'
1689 * Information about the print command (print.exe)
1690 `http://www.computerhope.com/printhlp.htm'
1692 * RedMon - Redirection Port Monitor (redpr.exe)
1693 `http://www.cs.wisc.edu/~ghost/redmon/index.htm'
1695 * Redirection Port Monitor (redpr.exe on-line help)
1696 `http://www.cs.wisc.edu/~ghost/redmon/en/redmon.htm'
1698 * UNIX man pages: lpr (or type `man lpr')
1699 `http://bama.ua.edu/cgi-bin/man-cgi?lpr'
1700 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lpr'
1702 * UNIX man pages: lp (or type `man lp')
1703 `http://bama.ua.edu/cgi-bin/man-cgi?lp'
1704 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lp'
1706 * GNU utilities for Win32 (cp.exe)
1707 `http://unxutils.sourceforge.net/'
1711 :tag "PostScript Printer"
1712 (symbol :tag "Printer Symbol Name")
1713 (string :tag "Printer Command")
1714 (repeat :tag "Printer Switches"
1715 (sexp :tag "Switch" :value ""))
1716 (choice :menu-tag "Printer Name Switch"
1717 :tag "Printer Name Switch"
1718 (const :tag "None" nil)
1720 (choice :menu-tag "Printer Name"
1722 (const :tag "None" nil)
1725 :tag "Default Value List"
1730 :menu-tag "Variable"
1732 (const :tag "Landscape" ps-landscape-mode)
1733 (const :tag "Print Header" ps-print-header)
1734 (const :tag "Print Header Frame" ps-print-header-frame)
1735 (const :tag "Line Number" ps-line-number)
1736 (const :tag "Zebra Stripes" ps-zebra-stripes)
1737 (const :tag "Duplex" ps-spool-duplex)
1738 (const :tag "Tumble" ps-spool-tumble)
1739 (const :tag "Upside-Down" ps-print-upside-down)
1740 (const :tag "PS File Landscape" pr-file-landscape)
1741 (const :tag "PS File Duplex" pr-file-duplex)
1742 (const :tag "PS File Tumble" pr-file-tumble)
1743 (const :tag "Auto Region" pr-auto-region)
1744 (const :tag "Auto Mode" pr-auto-mode)
1745 (const :tag "Ghostscript Device" pr-gs-device)
1746 (const :tag "Ghostscript Resolution" pr-gs-resolution)
1747 (const :tag "inherits-from:" inherits-from:)
1748 (variable :tag "Other"))
1749 (sexp :tag "Value")))
1751 :set 'pr-alist-custom-set
1756 (defcustom pr-temp-dir
1757 (pr-dosify-file-name
1758 (if (boundp 'temporary-file-directory)
1759 (symbol-value 'temporary-file-directory)
1760 ;; hacked from `temporary-file-directory' variable in files.el
1761 (file-name-as-directory
1762 (or (getenv "TMPDIR") (getenv "TMP") (getenv "TEMP")
1763 (cond (ps-windows-system "c:/temp")
1764 ((memq system-type '(vax-vms axp-vms)) "SYS$SCRATCH:")
1767 "*Specify a directory for temporary files during printing.
1769 See also `pr-ps-temp-file' and `pr-file-modes'."
1770 :type '(directory :tag "Temporary Directory")
1775 (defcustom pr-ps-temp-file "prspool-"
1776 "*Specify PostScript temporary file name prefix.
1778 See also `pr-temp-dir' and `pr-file-modes'."
1779 :type '(file :tag "PostScript Temporary File Name")
1784 ;; It uses 0600 as default instead of (default-file-modes).
1785 ;; So, by default, only the session owner have permission to deal with files
1786 ;; generated by `printing'.
1787 (defcustom pr-file-modes ?\600
1788 "*Specify the file permission bits for newly created files.
1790 It should be an integer; only the low 9 bits are used.
1792 See also `pr-temp-dir' and `pr-ps-temp-file'."
1793 :type '(integer :tag "File Permission Bits")
1798 (defcustom pr-gv-command
1799 (if ps-windows-system
1802 "*Specify path and name of the gsview/gv utility.
1804 See also `pr-path-alist'.
1809 `http://www.gnu.org/software/gv/manual/gv.html'
1812 `http://www.cs.wisc.edu/~ghost/gsview/gsviewen.htm'
1814 * GSview Help - Common Problems
1815 `http://www.cs.wisc.edu/~ghost/gsview/gsviewen.htm#Common_Problems'
1817 * GSview Readme (compilation & installation)
1818 `http://www.cs.wisc.edu/~ghost/gsview/Readme.htm'
1820 * GSview (main site)
1821 `http://www.cs.wisc.edu/~ghost/gsview/index.htm'
1823 * Ghostscript, Ghostview and GSview
1824 `http://www.cs.wisc.edu/~ghost/'
1827 `http://www.cs.wisc.edu/~ghost/gv/index.htm'
1830 `http://www.cs.wisc.edu/~ghost/gv/gv_doc/gv.html'
1833 `http://www.cs.wisc.edu/~ghost/macos/index.htm'
1835 :type '(string :tag "Ghostview Utility")
1840 (defcustom pr-gs-command
1841 (if ps-windows-system
1844 "*Specify path and name of the ghostscript utility.
1846 See also `pr-path-alist'.
1850 * Ghostscript, Ghostview and GSview
1851 `http://www.cs.wisc.edu/~ghost/'
1853 * Introduction to Ghostscript
1854 `http://www.cs.wisc.edu/~ghost/doc/intro.htm'
1856 * How to use Ghostscript
1857 `http://www.cs.wisc.edu/~ghost/doc/cvs/Use.htm'
1859 * Printer compatibility
1860 `http://www.cs.wisc.edu/~ghost/doc/printer.htm'
1862 :type '(string :tag "Ghostscript Utility")
1867 (defcustom pr-gs-switches
1868 (if ps-windows-system
1869 '("-q -dNOPAUSE -Ic:/gs/gs5.50;c:/gs/gs5.50/fonts")
1870 '("-q -dNOPAUSE -I/usr/share/ghostscript/5.10"))
1871 "*Specify ghostscript switches. See the documentation on GS for more info.
1873 It's a list of strings, where each string is one or more ghostscript switches.
1875 A note on the gs switches:
1878 -dNOPAUSE don't wait for user intervention
1879 -Ic:/gs/gs5.50;c:/gs/gs5.50/fonts the directories needed for gs
1880 -c quit it's added at the end to terminate gs
1882 To see ghostscript documentation for more information:
1884 * On GNU or Unix system:
1885 - for full documentation, type: man gs
1886 - for brief documentation, type: gs -h
1888 * On Windows system:
1889 - for full documentation, see in a browser the file
1890 c:/gstools/gs5.50/index.html, that is, the file index.html which is
1891 located in the same directory as gswin32.exe.
1892 - for brief documentation, type: gswin32.exe -h
1896 * Introduction to Ghostscript
1897 `http://www.cs.wisc.edu/~ghost/doc/intro.htm'
1899 * How to use Ghostscript
1900 `http://www.cs.wisc.edu/~ghost/doc/cvs/Use.htm'
1902 * Printer compatibility
1903 `http://www.cs.wisc.edu/~ghost/doc/printer.htm'
1905 :type '(repeat (string :tag "Ghostscript Switch"))
1910 (defcustom pr-gs-device
1911 (if ps-windows-system
1914 "*Specify the ghostscript device switch value (-sDEVICE=).
1916 A note on the gs switches:
1918 -sDEVICE=djet500 the printer - works with HP DeskJet 540
1920 See `pr-gs-switches' for documentation.
1921 See also `pr-ps-printer-alist'."
1922 :type '(string :tag "Ghostscript Device")
1927 (defcustom pr-gs-resolution 300
1928 "*Specify ghostscript resolution switch value (-r).
1930 A note on the gs switches:
1932 -r300 resolution 300x300
1934 See `pr-gs-switches' for documentation.
1935 See also `pr-ps-printer-alist'."
1936 :type '(integer :tag "Ghostscript Resolution")
1941 (defcustom pr-print-using-ghostscript nil
1942 "*Non-nil means print using ghostscript.
1944 This is useful if you don't have a PostScript printer, so you could use the
1945 ghostscript to print a PostScript file.
1947 In GNU or Unix system, if ghostscript is set as a PostScript filter, this
1948 variable should be nil."
1954 (defcustom pr-faces-p nil
1955 "*Non-nil means print with face attributes."
1961 (defcustom pr-spool-p nil
1962 "*Non-nil means spool printing in a buffer."
1968 (defcustom pr-file-landscape nil
1969 "*Non-nil means print PostScript file in landscape orientation."
1975 (defcustom pr-file-duplex nil
1976 "*Non-nil means print PostScript file in duplex mode."
1982 (defcustom pr-file-tumble nil
1983 "*Non-nil means print PostScript file in tumble mode.
1985 If tumble is off, produces a printing suitable for binding on the left or
1987 If tumble is on, produces a printing suitable for binding at the top or
1994 (defcustom pr-auto-region t
1995 "*Non-nil means region is automagically detected.
1997 Note that this will only work if you're using transient mark mode.
1999 When this variable is non-nil, the `*-buffer*' commands will behave like
2000 `*-region*' commands, that is, `*-buffer*' commands will print only the region
2001 marked instead of all buffer."
2007 (defcustom pr-auto-mode t
2008 "*Non-nil means major-mode specific printing is prefered over normal printing.
2010 That is, if current major-mode is declared in `pr-mode-alist', the `*-buffer*'
2011 and `*-region*' commands will behave like `*-mode*' commands; otherwise,
2012 `*-buffer*' commands will print the current buffer and `*-region*' commands
2013 will print the current region."
2019 (defcustom pr-mode-alist
2020 '((mh-folder-mode ; mh summary buffer
2021 pr-mh-lpr-1 pr-mh-print-1
2023 (ps-article-author ps-article-subject)
2024 ("/pagenumberstring load" pr-article-date)
2027 (mh-letter-mode ; mh letter buffer
2028 pr-mh-lpr-2 pr-mh-print-2
2030 (ps-article-author ps-article-subject)
2031 ("/pagenumberstring load" pr-article-date)
2034 (rmail-summary-mode ; rmail summary buffer
2035 pr-rmail-lpr pr-rmail-print
2037 (ps-article-subject ps-article-author buffer-name)
2041 (rmail-mode ; rmail buffer
2042 pr-rmail-lpr pr-rmail-print
2044 (ps-article-subject ps-article-author buffer-name)
2048 (gnus-summary-mode ; gnus summary buffer
2049 pr-gnus-lpr pr-gnus-print
2051 (ps-article-subject ps-article-author gnus-newsgroup-name)
2055 (gnus-article-mode ; gnus article buffer
2056 pr-gnus-lpr pr-gnus-print
2058 (ps-article-subject ps-article-author gnus-newsgroup-name)
2062 (Info-mode ; Info buffer
2063 pr-mode-lpr pr-mode-print
2065 (ps-info-node ps-info-file)
2070 pr-vm-lpr pr-vm-print
2072 (ps-article-subject ps-article-author buffer-name)
2077 "*Specify an alist for a major-mode and printing functions.
2079 To customize a major mode printing, just declare the customization in
2080 `pr-mode-alist' and invoke some of `*-mode*' commands. An example for major
2081 mode usage is when you're using gnus (or mh, or rmail, etc.) and you're in the
2082 *Summary* buffer, if you forget to switch to the *Article* buffer before
2083 printing, you'll get a nicely formatted list of article subjects shows up at
2084 the printer. With major mode printing you don't need to switch from gnus
2085 *Summary* buffer first.
2087 The elements have the following form:
2099 MAJOR-MODE It's the major mode symbol.
2101 LPR-PRINT It's a symbol function for text printing. It's invoked with
2103 (HEADER-LINES LEFT-HEADER RIGHT-HEADER DEFAULT...).
2105 Usually LPR-PRINT function prepares the environment or buffer
2106 and then call the function `pr-mode-lpr' which it's used to
2107 process the buffer and send it to text printer.
2109 The `pr-mode-lpr' definition is:
2111 (pr-mode-lpr HEADER-LIST &optional FROM TO)
2113 Where HEADER-LIST is like the argument passed to LPR-PRINT.
2114 FROM and TO are the beginning and end markers, respectively,
2115 for a region. If FROM is nil, it's used (point-min); if TO is
2116 nil, it's used (point-max).
2118 PS-PRINT It's a symbol function for PostScript printing. It's invoked
2119 with 3 arguments: n-up printing, file name and the list:
2120 (HEADER-LINES LEFT-HEADER RIGHT-HEADER DEFAULT...).
2122 Usually PS-PRINT function prepares the environment or buffer
2123 and then call the function `pr-mode-print' which it's used to
2124 process the buffer and send it to PostScript printer.
2126 The `pr-mode-print' definition is:
2128 (pr-mode-print N-UP FILENAME HEADER-LIST &optional FROM TO)
2130 Where N-UP, FILENAME and HEADER-LIST are like the arguments
2131 passed to PS-PRINT. FROM and TO are the beginning and end
2132 markers, respectively, for a region. If TO is nil, it's used
2135 HEADER-LINES It's the number of header lines; if is nil, it uses
2136 `ps-header-lines' value.
2138 LEFT-HEADER It's the left header part, it's a list of string, variable
2139 symbol or function symbol (with no argument); if is nil, it
2140 uses `ps-left-header' value.
2142 RIGHT-HEADER It's the right header part, it's a list of string, variable
2143 symbol or function symbol (with no argument); if is nil, it
2144 uses `ps-right-header' value.
2147 Non-nil means to kill all buffer local variable declared in
2148 DEFAULT (see below).
2150 DEFAULT It's a way to set default values when this entry is selected.
2153 (VARIABLE-SYM . VALUE)
2155 That associates VARIABLE-SYM with VALUE. when this entry is
2156 selected, it's executed the following command:
2158 (set (make-local-variable VARIABLE-SYM) (eval VALUE))
2160 Note that VALUE can be any valid lisp expression. So, don't
2161 forget to quote symbols and constant lists.
2162 If VARIABLE is the special keyword `inherits-from:', VALUE must
2163 be a symbol name setting defined in `pr-setting-database' from
2164 which the current setting inherits the context. Take care with
2165 circular inheritance.
2167 '(ps-landscape-mode . nil)
2168 '(ps-spool-duplex . t)
2169 '(pr-gs-device . (my-gs-device t))"
2173 (symbol :tag "Major Mode")
2174 (function :tag "Text Printing Function")
2175 (function :tag "PS Printing Function")
2176 (choice :menu-tag "Number of Header Lines"
2177 :tag "Number of Header Lines"
2178 (integer :tag "Number")
2179 (const :tag "Default Number" nil))
2180 (repeat :tag "Left Header List"
2181 (choice :menu-tag "Left Header"
2184 (repeat :tag "Right Header List"
2185 (choice :menu-tag "Right Header"
2188 (boolean :tag "Kill Local Variable At End")
2190 :tag "Default Value List"
2195 :menu-tag "Variable"
2197 (const :tag "Landscape" ps-landscape-mode)
2198 (const :tag "Print Header" ps-print-header)
2199 (const :tag "Print Header Frame" ps-print-header-frame)
2200 (const :tag "Line Number" ps-line-number)
2201 (const :tag "Zebra Stripes" ps-zebra-stripes)
2202 (const :tag "Duplex" ps-spool-duplex)
2203 (const :tag "Tumble" ps-spool-tumble)
2204 (const :tag "Upside-Down" ps-print-upside-down)
2205 (const :tag "PS File Landscape" pr-file-landscape)
2206 (const :tag "PS File Duplex" pr-file-duplex)
2207 (const :tag "PS File Tumble" pr-file-tumble)
2208 (const :tag "Auto Region" pr-auto-region)
2209 (const :tag "Auto Mode" pr-auto-mode)
2210 (const :tag "Ghostscript Device" pr-gs-device)
2211 (const :tag "Ghostscript Resolution" pr-gs-resolution)
2212 (const :tag "inherits-from:" inherits-from:)
2213 (variable :tag "Other"))
2214 (sexp :tag "Value")))
2220 (defcustom pr-ps-utility 'mpage
2221 "*Specify PostScript utility symbol.
2223 This utility symbol should be defined on `pr-ps-utility-alist' (see it for
2226 This variable should be modified by customization engine. If this variable is
2227 modified by other means (for example, a lisp function), use `pr-update-menus'
2228 function (see it for documentation) to update PostScript utility menu.
2230 NOTE: Don't forget to download and install the utilities declared on
2231 `pr-ps-utility-alist'."
2232 :type '(symbol :tag "PS File Utility")
2233 :set 'pr-ps-utility-custom-set
2238 (defcustom pr-ps-utility-alist
2239 '((mpage "mpage" nil "-b%s" "-%d" "-l" "-t" "-T" ">" nil)
2240 (psnup "psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
2241 (inherits-from: . no-duplex))
2244 ;; * On GNU or Unix system:
2245 ;; '((mpage "mpage" nil "-b%s" "-%d" "-l" "-t" "-T" ">" nil)
2246 ;; (psnup "psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
2247 ;; (pr-file-duplex . nil) (pr-file-tumble . nil))
2249 ;; * On Windows system:
2250 ;; '((psnup "c:/psutils/psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
2251 ;; (pr-file-duplex . nil) (pr-file-tumble . nil))
2253 "*Specify an alist for PostScript utility processing (PS utility database).
2255 The alist element has the form:
2257 (SYMBOL UTILITY MUST-SWITCHES PAPERSIZE N-UP LANDSCAPE DUPLEX TUMBLE OUTPUT
2258 SWITCHES DEFAULT...)
2262 SYMBOL It's a symbol to identify a PostScript utility. It's for
2263 `pr-ps-utility' variable setting and for menu selection.
2268 UTILITY Name of utility for processing a PostScript file.
2269 See also `pr-path-alist'.
2271 . for GNU or Unix system:
2275 . for Windows system:
2276 \"c:/psutils/psnup -q\"
2278 MUST-SWITCHES List of sexp's to pass as options to the PostScript utility
2279 program. These options are necessary to process the utility
2280 program and must be placed before any other switches.
2285 PAPERSIZE It's a format string to specify paper size switch.
2290 N-UP It's a format string to specify n-up switch.
2295 LANDSCAPE It's a string to specify landscape switch. If the utility
2296 doesn't have landscape switch, set to nil.
2301 DUPLEX It's a string to specify duplex switch. If the utility doesn't
2302 have duplex switch, set to nil.
2307 TUMBLE It's a string to specify tumble switch. If the utility doesn't
2308 have tumble switch, set to nil.
2313 OUTPUT It's a string to specify how to generate an output file. Some
2314 utilities accept an output file option, but some others need
2315 output redirection or some other way to specify an output file.
2318 \" \" ; psnup ... input output
2321 \">\" ; mpage ... input > output
2323 SWITCHES List of sexp's to pass as extra options to the PostScript utility
2330 DEFAULT It's a way to set default values when this entry is selected.
2335 That associates VARIABLE with VALUE. when this entry is
2336 selected, it's executed the following command:
2338 (set VARIABLE (eval VALUE))
2340 Note that VALUE can be any valid lisp expression. So, don't
2341 forget to quote symbols and constant lists.
2342 If VARIABLE is the special keyword `inherits-from:', VALUE must
2343 be a symbol name setting defined in `pr-setting-database' from
2344 which the current setting inherits the context. Take care with
2345 circular inheritance.
2347 '(pr-file-landscape . nil)
2348 '(pr-file-duplex . t)
2349 '(pr-gs-device . (my-gs-device t))
2351 This variable should be modified by customization engine. If this variable is
2352 modified by other means (for example, a lisp function), use `pr-update-menus'
2353 function (see it for documentation) to update PostScript utility menu.
2355 NOTE: Don't forget to download and install the utilities declared on
2356 `pr-ps-utility-alist'.
2360 * On GNU or Unix system:
2362 '((mpage \"mpage\" nil \"-b%s\" \"-%d\" \"-l\" \"-t\" \"-T\" \">\" nil)
2363 (psnup \"psnup\" (\"-q\") \"-P%s\" \"-%d\" \"-l\" nil nil \" \" nil
2364 (pr-file-duplex . nil) (pr-file-tumble . nil))
2367 * On Windows system:
2369 '((psnup \"c:/psutils/psnup\" (\"-q\") \"-P%s\" \"-%d\" \"-l\" nil nil \" \"
2370 nil (pr-file-duplex . nil) (pr-file-tumble . nil))
2375 * mpage download (GNU or Unix)
2376 `http://www.mesa.nl/pub/mpage/'
2378 * mpage documentation (GNU or Unix - or type `man mpage')
2379 `http://www.cs.umd.edu/faq/guides/manual_unix/node48.html'
2380 `http://www.rt.com/man/mpage.1.html'
2382 * psnup (Windows, GNU or Unix)
2383 `http://www.knackered.org/angus/psutils/'
2384 `http://gershwin.ens.fr/vdaniel/Doc-Locale/Outils-Gnu-Linux/PsUtils/'
2386 * psnup (PsUtils for Windows)
2387 `http://gnuwin32.sourceforge.net/packages/psutils.htm'
2389 * psnup documentation (GNU or Unix - or type `man psnup')
2390 `http://linux.about.com/library/cmd/blcmdl1_psnup.htm'
2391 `http://amath.colorado.edu/computing/software/man/psnup.html'
2393 * GNU Enscript (Windows, GNU or Unix)
2394 `http://people.ssh.com/mtr/genscript/'
2396 * GNU Enscript documentation (Windows, GNU or Unix)
2397 `http://people.ssh.com/mtr/genscript/enscript.man.html'
2398 (on GNU or Unix, type `man enscript')
2401 (list :tag "PS File Utility"
2402 (symbol :tag "Utility Symbol")
2403 (string :tag "Utility Name")
2404 (repeat :tag "Must Utility Switches"
2405 (sexp :tag "Switch" :value ""))
2406 (choice :menu-tag "Paper Size"
2408 (const :tag "No Paper Size" nil)
2409 (string :tag "Paper Size Format"))
2410 (choice :menu-tag "N-Up"
2412 (const :tag "No N-Up" nil)
2413 (string :tag "N-Up Format"))
2414 (choice :menu-tag "Landscape"
2416 (const :tag "No Landscape" nil)
2417 (string :tag "Landscape Switch"))
2418 (choice :menu-tag "Duplex"
2420 (const :tag "No Duplex" nil)
2421 (string :tag "Duplex Switch"))
2422 (choice :menu-tag "Tumble"
2424 (const :tag "No Tumble" nil)
2425 (string :tag "Tumble Switch"))
2426 (string :tag "Output Separator")
2427 (repeat :tag "Utility Switches"
2428 (sexp :tag "Switch" :value ""))
2430 :tag "Default Value List"
2435 :menu-tag "Variable"
2437 (const :tag "PS File Landscape" pr-file-landscape)
2438 (const :tag "PS File Duplex" pr-file-duplex)
2439 (const :tag "PS File Tumble" pr-file-tumble)
2440 (const :tag "Ghostscript Device" pr-gs-device)
2441 (const :tag "Ghostscript Resolution" pr-gs-resolution)
2442 (const :tag "inherits-from:" inherits-from:)
2443 (variable :tag "Other"))
2444 (sexp :tag "Value")))
2446 :set 'pr-alist-custom-set
2451 (defcustom pr-menu-lock t
2452 "*Non-nil means menu is locked while selecting toggle options.
2454 See also `pr-menu-char-height' and `pr-menu-char-width'."
2460 (defcustom pr-menu-char-height
2461 (cond ((featurep 'xemacs) ; XEmacs
2462 (pr-x-font-height (face-font 'default)))
2464 (pr-e-frame-char-height)))
2465 "*Specify menu char height in pixels.
2467 This variable is used to guess which vertical position should be locked the
2468 menu, so don't forget to adjust it if menu position is not ok.
2470 See also `pr-menu-lock' and `pr-menu-char-width'."
2476 (defcustom pr-menu-char-width
2477 (cond ((featurep 'xemacs) ; XEmacs
2478 (pr-x-font-width (face-font 'default)))
2480 (pr-e-frame-char-width)))
2481 "*Specify menu char width in pixels.
2483 This variable is used to guess which horizontal position should be locked the
2484 menu, so don't forget to adjust it if menu position is not ok.
2486 See also `pr-menu-lock' and `pr-menu-char-height'."
2492 (defcustom pr-setting-database
2493 '((no-duplex ; setting symbol name
2494 nil nil nil ; inherits local kill-local
2495 (pr-file-duplex . nil) ; settings
2496 (pr-file-tumble . nil))
2498 "*Specify an alist for settings in general.
2500 The elements have the following form:
2502 (SYMBOL INHERITS LOCAL KILL-LOCAL SETTING...)
2506 SYMBOL It's a symbol to identify the setting group.
2508 INHERITS Specify the inheritance for SYMBOL group. It's a symbol name
2509 setting from which the current setting inherits the context.
2510 If INHERITS is nil, means that there is no inheritance.
2511 This is a simple inheritance mechanism.
2513 Let's see an example to illustrate the inheritance mechanism:
2515 (setq pr-setting-database
2516 '((no-duplex ; setting symbol name
2518 nil nil ; local kill-local
2519 (pr-file-duplex . nil) ; settings
2520 (pr-file-tumble . nil)
2522 (no-duplex-and-landscape ; setting symbol name
2523 no-duplex ; inherits
2524 nil nil ; local kill-local
2525 (pr-file-landscape . nil) ; settings
2528 The example above has two setting groups: no-duplex and
2529 no-duplex-and-landscape. When setting no-duplex is activated
2530 through `inherits-from:' (see `pr-ps-utility', `pr-mode-alist'
2531 and `pr-ps-printer-alist'), the variables pr-file-duplex and
2532 pr-file-tumble are both set to nil.
2534 Now when setting no-duplex-and-landscape is activated through
2535 `inherits-from:', the variable pr-file-landscape is set to nil
2536 and also the settings for no-duplex are done, because
2537 no-duplex-and-landscape inherits settings from no-duplex.
2539 Take care with circular inheritance. It's an error if circular
2540 inheritance happens.
2542 LOCAL Non-nil means that all settings for SYMBOL group will be
2543 declared local buffer.
2545 KILL-LOCAL Non-nil means that all settings for SYMBOL group will be
2546 killed at end. It has effect only when LOCAL is non-nil.
2548 SETTING It's a cons like:
2552 That associates VARIABLE with VALUE. when this entry is
2553 selected, it's executed the following command:
2555 * If LOCAL is non-nil:
2556 (set (make-local-variable VARIABLE) (eval VALUE))
2559 (set VARIABLE (eval VALUE))
2561 Note that VALUE can be any valid lisp expression. So, don't
2562 forget to quote symbols and constant lists.
2563 This setting is ignored if VARIABLE is equal to keyword
2566 '(ps-landscape-mode . nil)
2567 '(ps-spool-duplex . t)
2568 '(pr-gs-device . (my-gs-device t))"
2572 (symbol :tag "Setting Name")
2573 (choice :menu-tag "Inheritance"
2575 (const :tag "No Inheritance" nil)
2576 (symbol :tag "Inherits From"))
2577 (boolean :tag "Local Buffer Setting")
2578 (boolean :tag "Kill Local Variable At End")
2585 :menu-tag "Variable"
2587 (const :tag "Landscape" ps-landscape-mode)
2588 (const :tag "Print Header" ps-print-header)
2589 (const :tag "Print Header Frame" ps-print-header-frame)
2590 (const :tag "Line Number" ps-line-number)
2591 (const :tag "Zebra Stripes" ps-zebra-stripes)
2592 (const :tag "Duplex" ps-spool-duplex)
2593 (const :tag "Tumble" ps-spool-tumble)
2594 (const :tag "Upside-Down" ps-print-upside-down)
2595 (const :tag "PS File Landscape" pr-file-landscape)
2596 (const :tag "PS File Duplex" pr-file-duplex)
2597 (const :tag "PS File Tumble" pr-file-tumble)
2598 (const :tag "Auto Region" pr-auto-region)
2599 (const :tag "Auto Mode" pr-auto-mode)
2600 (const :tag "Ghostscript Device" pr-gs-device)
2601 (const :tag "Ghostscript Resolution" pr-gs-resolution)
2602 (variable :tag "Other"))
2603 (sexp :tag "Value")))
2609 (defcustom pr-visible-entry-list
2610 '(postscript text postscript-options postscript-process printing help)
2611 "*Specify a list of Printing menu visible entries.
2613 Valid values with the corresponding menu parts are:
2615 +------------------------------+
2616 | Printing Interface |
2617 +------------------------------+
2618 `postscript' | PostScript Preview >|
2619 | PostScript Print >|
2620 | PostScript Printer: name >|
2621 +------------------------------+
2622 `text' | Printify >|
2624 | Text Printer: name >|
2625 +------------------------------+
2626 `postscript-options' |[ ] Landscape |
2628 |[ ] Print Header Frame |
2630 |[ ] Zebra Stripes |
2634 | Print All Pages >|
2635 +------------------------------+
2636 `postscript-process' |[ ] Spool Buffer |
2637 |[ ] Print with faces |
2638 |[ ] Print via Ghostscript |
2639 +------------------------------+
2640 `printing' |[ ] Auto Region |
2643 +------------------------------+
2644 `help' | Customize >|
2647 +------------------------------+
2649 Any other value is ignored."
2650 :type '(repeat :tag "Menu Visible Part"
2651 (choice :menu-tag "Menu Part"
2655 (const postscript-options)
2656 (const postscript-process)
2663 (defcustom pr-delete-temp-file t
2664 "*Non-nil means delete temporary files.
2666 Set `pr-delete-temp-file' to nil, if the following message (or a similar)
2667 happens when printing:
2669 Error: could not open \"c:\\temp\\prspool.ps\" for reading."
2675 (defcustom pr-list-directory nil
2676 "*Non-nil means list directory when processing a directory.
2678 That is, any subdirectories (and the superdirectory) of the directory (given as
2679 argument of functions below) are also printed (as dired-mode listings).
2681 It's used by `pr-ps-directory-preview', `pr-ps-directory-using-ghostscript',
2682 `pr-ps-directory-print', `pr-ps-directory-ps-print', `pr-printify-directory'
2683 and `pr-txt-directory'."
2689 (defcustom pr-buffer-name "*Printing Interface*"
2690 "*Specify the name of the buffer interface for printing package.
2692 It's used by `pr-interface'."
2698 (defcustom pr-buffer-name-ignore
2699 (list (regexp-quote pr-buffer-name) ; ignore printing interface buffer
2700 "^ .*$") ; ignore invisible buffers
2701 "*Specify a regexp list for buffer names to be ignored in interface buffer.
2703 NOTE: Case is important for matching, that is, `case-fold-search' is always
2706 It's used by `pr-interface'."
2707 :type '(repeat (regexp :tag "Buffer Name Regexp"))
2712 (defcustom pr-buffer-verbose t
2713 "*Non-nil means to be verbose when editing a field in interface buffer.
2715 It's used by `pr-interface'."
2721 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2722 ;; Internal Variables
2725 (defvar pr-txt-command nil
2726 "Name of program for printing a text file.
2727 See `pr-txt-printer-alist'.")
2730 (defvar pr-txt-switches nil
2731 "List of sexp's to pass as extra options to the text printer program.
2732 See `pr-txt-printer-alist'.")
2735 (defvar pr-txt-printer nil
2736 "Specify text printer name.
2737 See `pr-txt-printer-alist'.")
2740 (defvar pr-ps-command nil
2741 "Name of program for printing a PostScript file.
2742 See `pr-ps-printer-alist'.")
2745 (defvar pr-ps-switches nil
2746 "List of sexp's to pass as extra options to the PostScript printer program.
2747 See `pr-ps-printer-alist'.")
2750 (defvar pr-ps-printer-switch nil
2751 "Specify PostScript printer name switch.
2752 See `pr-ps-printer-alist'.")
2755 (defvar pr-ps-printer nil
2756 "Specify PostScript printer name.
2757 See `pr-ps-printer-alist'.")
2760 (defvar pr-menu-bar nil
2761 "Specify Printing menu-bar entry.")
2764 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2768 (defmacro pr-save-file-modes (&rest body)
2769 "Set temporally file modes to `pr-file-modes'."
2770 `(let ((pr--default-file-modes (default-file-modes))) ; save default
2771 (set-default-file-modes pr-file-modes)
2773 (set-default-file-modes pr--default-file-modes))) ; restore default
2776 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2780 (defmacro pr-xemacs-global-menubar (&rest body)
2782 (let ((temp (get-buffer-create (make-temp-name " *Temp"))))
2783 ;; be sure to access global menubar
2786 (kill-buffer temp))))
2789 (defsubst pr-visible-p (key)
2790 (memq key pr-visible-entry-list))
2793 (defsubst pr-mode-alist-p ()
2794 (cdr (assq major-mode pr-mode-alist)))
2797 (defsubst pr-auto-mode-p ()
2798 (and pr-auto-mode (pr-mode-alist-p)))
2801 (defsubst pr-using-ghostscript-p ()
2802 (and pr-print-using-ghostscript (not pr-spool-p)))
2805 (defalias 'pr-get-symbol
2806 (if (fboundp 'easy-menu-intern) ; hacked from easymenu.el
2808 (lambda (s) (if (stringp s) (intern s) s))))
2811 ((featurep 'xemacs) ; XEmacs
2812 (defvar zmacs-region-stays nil) ; to avoid compilation gripes
2813 (defun pr-region-active-p ()
2814 (and pr-auto-region (not zmacs-region-stays) (ps-mark-active-p))))
2817 (defun pr-region-active-p ()
2818 (and pr-auto-region transient-mark-mode mark-active))))
2821 (defconst pr-menu-spec
2823 ;; unfortunately XEmacs doesn't support :active for submenus,
2825 ;; So, it uses :included instead of :active.
2826 ;; Also, XEmacs doesn't support :help tag.
2827 (let ((pr-:active (if (featurep 'xemacs)
2829 :active)) ; GNU Emacs
2830 (pr-:help (if (featurep 'xemacs)
2832 #'(lambda (text) (list :help text))))) ; GNU Emacs
2834 ["Printing Interface" pr-interface
2836 pr-:help "Use buffer interface instead of menu interface")]
2838 ("PostScript Preview" :included (pr-visible-p 'postscript)
2840 pr-:help "Preview PostScript instead of sending to printer")
2841 ("Directory" ,pr-:active (not pr-spool-p)
2842 ["1-up" (pr-ps-directory-preview 1 nil nil t) t]
2843 ["2-up" (pr-ps-directory-preview 2 nil nil t) t]
2844 ["4-up" (pr-ps-directory-preview 4 nil nil t) t]
2845 ["Other..." (pr-ps-directory-preview nil nil nil t)
2846 :keys "\\[pr-ps-buffer-preview]"])
2847 ("Buffer" ,pr-:active (not pr-spool-p)
2848 ["1-up" (pr-ps-buffer-preview 1 t) t]
2849 ["2-up" (pr-ps-buffer-preview 2 t) t]
2850 ["4-up" (pr-ps-buffer-preview 4 t) t]
2851 ["Other..." (pr-ps-buffer-preview nil t)
2852 :keys "\\[pr-ps-buffer-preview]"])
2853 ("Region" ,pr-:active (and (not pr-spool-p) (ps-mark-active-p))
2854 ["1-up" (pr-ps-region-preview 1 t) t]
2855 ["2-up" (pr-ps-region-preview 2 t) t]
2856 ["4-up" (pr-ps-region-preview 4 t) t]
2857 ["Other..." (pr-ps-region-preview nil t)
2858 :keys "\\[pr-ps-region-preview]"])
2859 ("Mode" ,pr-:active (and (not pr-spool-p) (pr-mode-alist-p))
2860 ["1-up" (pr-ps-mode-preview 1 t) t]
2861 ["2-up" (pr-ps-mode-preview 2 t) t]
2862 ["4-up" (pr-ps-mode-preview 4 t) t]
2863 ["Other..." (pr-ps-mode-preview nil t)
2864 :keys "\\[pr-ps-mode-preview]"])
2866 ["No Preprocessing..." (call-interactively 'pr-ps-file-preview)
2867 :keys "\\[pr-ps-file-preview]"
2869 pr-:help "Preview PostScript file")]
2871 ["PostScript Utility" pr-update-menus :active pr-ps-utility-alist
2873 pr-:help "Select PostScript utility")]
2875 ["1-up..." (pr-ps-file-up-preview 1 t t) pr-ps-utility-alist]
2876 ["2-up..." (pr-ps-file-up-preview 2 t t) pr-ps-utility-alist]
2877 ["4-up..." (pr-ps-file-up-preview 4 t t) pr-ps-utility-alist]
2878 ["Other..." (pr-ps-file-up-preview nil t t)
2879 :keys "\\[pr-ps-file-up-preview]" :active pr-ps-utility-alist]
2881 ["Landscape" pr-toggle-file-landscape-menu
2882 :style toggle :selected pr-file-landscape
2884 pr-:help "Toggle landscape for PostScript file")
2885 :active pr-ps-utility-alist]
2886 ["Duplex" pr-toggle-file-duplex-menu
2887 :style toggle :selected pr-file-duplex
2889 pr-:help "Toggle duplex for PostScript file")
2890 :active pr-ps-utility-alist]
2891 ["Tumble" pr-toggle-file-tumble-menu
2892 :style toggle :selected pr-file-tumble
2894 pr-:help "Toggle tumble for PostScript file")
2895 :active (and pr-file-duplex pr-ps-utility-alist)])
2896 ["Despool..." (call-interactively 'pr-despool-preview)
2897 :active pr-spool-p :keys "\\[pr-despool-preview]"
2899 pr-:help "Despool PostScript buffer to printer or file (C-u)")])
2900 ("PostScript Print" :included (pr-visible-p 'postscript)
2902 pr-:help "Send PostScript to printer or file (C-u)")
2904 ["1-up" (pr-ps-directory-ps-print 1 nil nil t) t]
2905 ["2-up" (pr-ps-directory-ps-print 2 nil nil t) t]
2906 ["4-up" (pr-ps-directory-ps-print 4 nil nil t) t]
2907 ["Other..." (pr-ps-directory-ps-print nil nil nil t)
2908 :keys "\\[pr-ps-buffer-ps-print]"])
2910 ["1-up" (pr-ps-buffer-ps-print 1 t) t]
2911 ["2-up" (pr-ps-buffer-ps-print 2 t) t]
2912 ["4-up" (pr-ps-buffer-ps-print 4 t) t]
2913 ["Other..." (pr-ps-buffer-ps-print nil t)
2914 :keys "\\[pr-ps-buffer-ps-print]"])
2915 ("Region" ,pr-:active (ps-mark-active-p)
2916 ["1-up" (pr-ps-region-ps-print 1 t) t]
2917 ["2-up" (pr-ps-region-ps-print 2 t) t]
2918 ["4-up" (pr-ps-region-ps-print 4 t) t]
2919 ["Other..." (pr-ps-region-ps-print nil t)
2920 :keys "\\[pr-ps-region-ps-print]"])
2921 ("Mode" ,pr-:active (pr-mode-alist-p)
2922 ["1-up" (pr-ps-mode-ps-print 1 t) t]
2923 ["2-up" (pr-ps-mode-ps-print 2 t) t]
2924 ["4-up" (pr-ps-mode-ps-print 4 t) t]
2925 ["Other..." (pr-ps-mode-ps-print nil t)
2926 :keys "\\[pr-ps-mode-ps-print]"])
2928 ["No Preprocessing..." (call-interactively 'pr-ps-file-ps-print)
2929 :keys "\\[pr-ps-file-ps-print]"
2931 pr-:help "Send PostScript file to printer")]
2933 ["PostScript Utility" pr-update-menus :active pr-ps-utility-alist
2935 pr-:help "Select PostScript utility")]
2937 ["1-up..." (pr-ps-file-up-ps-print 1 t t) pr-ps-utility-alist]
2938 ["2-up..." (pr-ps-file-up-ps-print 2 t t) pr-ps-utility-alist]
2939 ["4-up..." (pr-ps-file-up-ps-print 4 t t) pr-ps-utility-alist]
2940 ["Other..." (pr-ps-file-up-ps-print nil t t)
2941 :keys "\\[pr-ps-file-up-ps-print]" :active pr-ps-utility-alist]
2943 ["Landscape" pr-toggle-file-landscape-menu
2944 :style toggle :selected pr-file-landscape
2946 pr-:help "Toggle landscape for PostScript file")
2947 :active pr-ps-utility-alist]
2948 ["Duplex" pr-toggle-file-duplex-menu
2949 :style toggle :selected pr-file-duplex
2951 pr-:help "Toggle duplex for PostScript file")
2952 :active pr-ps-utility-alist]
2953 ["Tumble" pr-toggle-file-tumble-menu
2954 :style toggle :selected pr-file-tumble
2956 pr-:help "Toggle tumble for PostScript file")
2957 :active (and pr-file-duplex pr-ps-utility-alist)])
2958 ["Despool..." (call-interactively 'pr-despool-ps-print)
2959 :active pr-spool-p :keys "\\[pr-despool-ps-print]"
2961 pr-:help "Despool PostScript buffer to printer or file (C-u)")])
2962 ["PostScript Printers" pr-update-menus
2963 :active pr-ps-printer-alist :included (pr-visible-p 'postscript)
2965 pr-:help "Select PostScript printer")]
2967 ("Printify" :included (pr-visible-p 'text)
2970 "Replace non-printing chars with printable representations.")
2971 ["Directory" pr-printify-directory t]
2972 ["Buffer" pr-printify-buffer t]
2973 ["Region" pr-printify-region (ps-mark-active-p)])
2974 ("Print" :included (pr-visible-p 'text)
2976 pr-:help "Send text to printer")
2977 ["Directory" pr-txt-directory t]
2978 ["Buffer" pr-txt-buffer t]
2979 ["Region" pr-txt-region (ps-mark-active-p)]
2980 ["Mode" pr-txt-mode (pr-mode-alist-p)])
2981 ["Text Printers" pr-update-menus
2982 :active pr-txt-printer-alist :included (pr-visible-p 'text)
2984 pr-:help "Select text printer")]
2986 ["Landscape" pr-toggle-landscape-menu
2987 :style toggle :selected ps-landscape-mode
2988 :included (pr-visible-p 'postscript-options)]
2989 ["Print Header" pr-toggle-header-menu
2990 :style toggle :selected ps-print-header
2991 :included (pr-visible-p 'postscript-options)]
2992 ["Print Header Frame" pr-toggle-header-frame-menu
2993 :style toggle :selected ps-print-header-frame :active ps-print-header
2994 :included (pr-visible-p 'postscript-options)]
2995 ["Line Number" pr-toggle-line-menu
2996 :style toggle :selected ps-line-number
2997 :included (pr-visible-p 'postscript-options)]
2998 ["Zebra Stripes" pr-toggle-zebra-menu
2999 :style toggle :selected ps-zebra-stripes
3000 :included (pr-visible-p 'postscript-options)]
3001 ["Duplex" pr-toggle-duplex-menu
3002 :style toggle :selected ps-spool-duplex
3003 :included (pr-visible-p 'postscript-options)]
3004 ["Tumble" pr-toggle-tumble-menu
3005 :style toggle :selected ps-spool-tumble :active ps-spool-duplex
3006 :included (pr-visible-p 'postscript-options)]
3007 ["Upside-Down" pr-toggle-upside-down-menu
3008 :style toggle :selected ps-print-upside-down
3009 :included (pr-visible-p 'postscript-options)]
3010 ("Print All Pages" :included (pr-visible-p 'postscript-options)
3012 pr-:help "Select odd/even pages/sheets to print")
3013 ["All Pages" (pr-even-or-odd-pages nil)
3014 :style radio :selected (eq ps-even-or-odd-pages nil)]
3015 ["Even Pages" (pr-even-or-odd-pages 'even-page)
3016 :style radio :selected (eq ps-even-or-odd-pages 'even-page)]
3017 ["Odd Pages" (pr-even-or-odd-pages 'odd-page)
3018 :style radio :selected (eq ps-even-or-odd-pages 'odd-page)]
3019 ["Even Sheets" (pr-even-or-odd-pages 'even-sheet)
3020 :style radio :selected (eq ps-even-or-odd-pages 'even-sheet)]
3021 ["Odd Sheets" (pr-even-or-odd-pages 'odd-sheet)
3022 :style radio :selected (eq ps-even-or-odd-pages 'odd-sheet)])
3024 ["Spool Buffer" pr-toggle-spool-menu
3025 :style toggle :selected pr-spool-p
3026 :included (pr-visible-p 'postscript-process)
3028 pr-:help "Toggle PostScript spooling")]
3029 ["Print with faces" pr-toggle-faces-menu
3030 :style toggle :selected pr-faces-p
3031 :included (pr-visible-p 'postscript-process)
3033 pr-:help "Toggle PostScript printing with faces")]
3034 ["Print via Ghostscript" pr-toggle-ghostscript-menu
3035 :style toggle :selected pr-print-using-ghostscript
3036 :included (pr-visible-p 'postscript-process)
3038 pr-:help "Toggle PostScript generation using ghostscript")]
3040 ["Auto Region" pr-toggle-region-menu
3041 :style toggle :selected pr-auto-region
3042 :included (pr-visible-p 'printing)]
3043 ["Auto Mode" pr-toggle-mode-menu
3044 :style toggle :selected pr-auto-mode
3045 :included (pr-visible-p 'printing)]
3046 ["Menu Lock" pr-toggle-lock-menu
3047 :style toggle :selected pr-menu-lock
3048 :included (pr-visible-p 'printing)]
3050 ("Customize" :included (pr-visible-p 'help)
3051 ["printing" pr-customize t]
3052 ["ps-print" ps-print-customize t]
3053 ["lpr" lpr-customize t])
3054 ("Show Settings" :included (pr-visible-p 'help)
3055 ["printing" pr-show-pr-setup t]
3056 ["ps-print" pr-show-ps-setup t]
3057 ["lpr" pr-show-lpr-setup t])
3058 ["Help" pr-help :active t :included (pr-visible-p 'help)]
3062 (defvar pr-menu-print-item "print"
3063 "Non-nil means that menu binding was not done.
3065 Used by `pr-menu-bind' and `pr-update-menus'.")
3068 (defun pr-menu-bind ()
3069 "Install `printing' menu in the menubar.
3071 On Emacs 20, it replaces the Tools/Print menu by Tools/Printing menu.
3073 On Emacs 21 and 22, it replaces the File/Print* menu entries by File/Print
3076 Calls `pr-update-menus' to adjust menus."
3079 ((featurep 'xemacs) ; XEmacs
3081 (pr-xemacs-global-menubar
3082 (pr-x-add-submenu nil (cons "Printing" pr-menu-spec) "Apps"))
3083 (setq pr-menu-print-item nil))
3089 ;; Replace existing "print" item by "Printing" item.
3090 ;; If you're changing this file, you'll load it a second,
3091 ;; third... time, but "print" item exists only in the first load.
3094 ((string< emacs-version "21.")
3095 (easy-menu-change '("tools") "Printing" pr-menu-spec pr-menu-print-item)
3096 (when pr-menu-print-item
3097 (easy-menu-remove-item nil '("tools") pr-menu-print-item)
3098 (setq pr-menu-print-item nil
3099 pr-menu-bar (vector 'menu-bar 'tools
3100 (pr-get-symbol "Printing")))))
3105 (easy-menu-add-item menu-bar-file-menu nil
3106 (easy-menu-create-menu "Print" pr-menu-spec)
3108 (dolist (item '("print-buffer" "print-region"
3109 "ps-print-buffer-faces" "ps-print-region-faces"
3110 "ps-print-buffer" "ps-print-region"))
3111 (easy-menu-remove-item menu-bar-file-menu nil item))
3112 (setq pr-menu-print-item nil
3113 pr-menu-bar (vector 'menu-bar
3115 (pr-get-symbol "Print"))))
3117 (easy-menu-change '("file") "Print" pr-menu-spec)))))))
3118 (pr-update-menus t))
3122 (let ((pr-print-key (if (featurep 'xemacs)
3124 'print))) ; GNU Emacs
3125 (global-set-key `[,pr-print-key] 'pr-ps-fast-fire)
3126 ;; Well, M-print and S-print are used because in my keyboard S-print works
3127 ;; and M-print doesn't. But M-print can work in other keyboard.
3128 (global-set-key `[(meta ,pr-print-key)] 'pr-ps-mode-using-ghostscript)
3129 (global-set-key `[(shift ,pr-print-key)] 'pr-ps-mode-using-ghostscript)
3130 ;; Well, C-print and C-M-print are used because in my keyboard C-M-print works
3131 ;; and C-print doesn't. But C-print can work in other keyboard.
3132 (global-set-key `[(control ,pr-print-key)] 'pr-txt-fast-fire)
3133 (global-set-key `[(control meta ,pr-print-key)] 'pr-txt-fast-fire))
3136 ;;; You can also use something like:
3137 ;;;(global-set-key "\C-ci" 'pr-interface)
3138 ;;;(global-set-key "\C-cbp" 'pr-ps-buffer-print)
3139 ;;;(global-set-key "\C-cbx" 'pr-ps-buffer-preview)
3140 ;;;(global-set-key "\C-cbb" 'pr-ps-buffer-using-ghostscript)
3141 ;;;(global-set-key "\C-crp" 'pr-ps-region-print)
3142 ;;;(global-set-key "\C-crx" 'pr-ps-region-preview)
3143 ;;;(global-set-key "\C-crr" 'pr-ps-region-using-ghostscript)
3146 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3150 (defconst pr-help-message
3151 (concat "printing.el version " pr-version
3152 " ps-print.el version " ps-print-version
3157 The `printing' menu (Tools/Printing or File/Print) has the following layout:
3159 +-----------------------------+
3160 A 0 | Printing Interface |
3161 +-----------------------------+ +-A---------+ +-B------+
3162 I 1 | PostScript Preview >|-------|Directory >|-----|1-up |
3163 2 | PostScript Print >|---- A |Buffer >|-- B |2-up |
3164 3 | PostScript Printer: name >|---- C |Region >|-- B |4-up |
3165 +-----------------------------+ |Mode >|-- B |Other...|
3166 II 4 | Printify >|-----\\ |File >|--\\ +--------+
3167 5 | Print >|---\\ | |Despool... | |
3168 6 | Text Printer: name >|-\\ | | +-----------+ |
3169 +-----------------------------+ | | | +---------+ +------------+
3170 III 7 |[ ]Landscape | | | \\-|Directory| | No Prep... | Ia
3171 8 |[ ]Print Header | | | |Buffer | +------------+ Ib
3172 9 |[ ]Print Header Frame | | | |Region | | name >|- C
3173 10 |[ ]Line Number | | | +---------+ +------------+
3174 11 |[ ]Zebra Stripes | | | +---------+ | 1-up... | Ic
3175 12 |[ ]Duplex | | \\---|Directory| | 2-up... |
3176 13 |[ ]Tumble | \\--\\ |Buffer | | 4-up... |
3177 14 |[ ]Upside-Down | | |Region | | Other... |
3178 15 | Print All Pages >|--\\ | |Mode | +------------+
3179 +-----------------------------+ | | +---------+ |[ ]Landscape| Id
3180 IV 16 |[ ]Spool Buffer | | | +-C-------+ |[ ]Duplex | Ie
3181 17 |[ ]Print with faces | | \\--|( )name A| |[ ]Tumble | If
3182 18 |[ ]Print via Ghostscript | | |( )name B| +------------+
3183 +-----------------------------+ | |... |
3184 V 19 |[ ]Auto Region | | |(*)name |
3185 20 |[ ]Auto Mode | | |... |
3186 21 |[ ]Menu Lock | | +---------+ +--------------+
3187 +-----------------------------+ \\------------------|(*)All Pages |
3188 VI 22 | Customize >|--- D +-D------+ |( )Even Pages |
3189 23 | Show Settings >|-------|printing| |( )Odd Pages |
3190 24 | Help | |ps-print| |( )Even Sheets|
3191 +-----------------------------+ |lpr | |( )Odd Sheets |
3192 +--------+ +--------------+
3194 See `pr-visible-entry-list' for hiding some parts of the menu.
3196 The menu has the following sections:
3200 0. You can use a buffer interface instead of menus. It looks like the
3201 customization buffer. Basically, it has the same options found in the
3202 menu and some extra options, all this on a buffer.
3204 I. PostScript printing:
3206 1. You can generate a PostScript file (if you type C-u before activating
3207 menu) or PostScript temporary file for a directory, a buffer, a region
3208 or a major mode, choosing 1-up, 2-up, 4-up or any other n-up printing;
3209 after file generation, ghostview is activated using the file generated
3210 as argument. This option is disabled if spooling is on (option 16).
3211 Also, if you already have a PostScript file you can preview it.
3212 Instead of previewing each buffer, region or major mode at once, you
3213 can save temporarily the PostScript code generated in a buffer and
3214 preview it later. The option `Despool...' despools the PostScript
3215 spooling buffer in a temporary file and uses ghostview to preview it.
3216 If you type C-u before choosing this option, the PostScript code
3217 generated is saved in a file instead of saving in a temporary file. To
3218 spool the PostScript code generated you need to turn on the option 16.
3219 The option `Despool...' is enabled if spooling is on (option 16).
3221 NOTE 1: It's possible to customize a major mode printing, just declare
3222 the customization in `pr-mode-alist' and invoke some of
3223 `*-mode*' commands or select Mode option in Printing menu. An
3224 example for major mode usage is when you're using gnus (or mh,
3225 or rmail, etc.) and you're in the *Summary* buffer, if you
3226 forget to switch to the *Article* buffer before printing,
3227 you'll get a nicely formatted list of article subjects shows
3228 up at the printer. With major mode printing you don't need to
3229 switch from gnus *Summary* buffer first.
3231 NOTE 2: There are the following options for PostScript file processing:
3232 Ia. Print the file *No Preprocessing*, that is, send it
3233 directly to PostScript printer.
3234 Ib. PostScript utility processing selection.
3235 See `pr-ps-utility-alist' and `pr-setting-database' for
3237 Ic. Do n-up processing before printing.
3238 Id. Toggle on/off landscape for PostScript file processing.
3239 Ie. Toggle on/off duplex for PostScript file processing.
3240 If. Toggle on/off tumble for PostScript file processing.
3242 NOTE 3: Don't forget to download and install the utilities declared on
3243 `pr-ps-utility-alist'.
3245 2. Operate the same way as option 1, but it sends directly the PostScript
3246 code (or put in a file, if you've typed C-u) or it uses ghostscript to
3247 print the PostScript file generated. It depends on option 18, if it's
3248 turned on, it uses ghostscript; otherwise, it sends directly to
3249 printer. If spooling is on (option 16), the PostScript code is saved
3250 temporarily in a buffer instead of printing it or saving it in a file.
3251 Also, if you already have a PostScript file you can print it.
3252 Instead of printing each buffer, region or major mode at once, you can
3253 save temporarily the PostScript code generated in a buffer and print it
3254 later. The option `Despool...' despools the PostScript spooling buffer
3255 directly on a printer. If you type C-u before choosing this option,
3256 the PostScript code generated is saved in a file instead of sending it to
3257 the printer. To spool the PostScript code generated you need to turn on
3258 option 16. This option is enabled if spooling is on (option 16).
3259 See also the NOTE 1, NOTE 2 and NOTE 3 on option 1.
3261 3. You can select a new PostScript printer to send PostScript code
3262 generated. For selection it's used all PostScript printers defined
3263 in `pr-ps-printer-alist' variable (see it for documentation).
3264 See also `pr-setting-database'.
3268 4. If you have control characters (character code from \\000 to \\037) in a
3269 buffer and you want to print them in a text printer, select this
3270 option. All control characters in your buffer or region will be
3271 replaced by a printable representation. The printable representations
3272 use ^ (for ASCII control characters) or hex. The characters tab,
3273 linefeed, space, return and formfeed are not affected.
3274 You don't need to select this option if you use any option of section
3275 I, the PostScript engine treats control characters properly.
3277 5. If you want to print a directory, buffer, region or major mode in a
3278 text printer, select this option. See also the NOTE 1 on option 1.
3280 6. You can select a new text printer to send text generated. For
3281 selection it's used all text printers defined in `pr-txt-printer-alist'
3282 variable (see it for documentation).
3283 See also `pr-setting-database'.
3285 III. PostScript page toggle options:
3287 7. If you want a PostScript landscape printing, turn on this option.
3289 8. If you want to have a header in each page in your PostScript code,
3290 turn on this option.
3292 9. If you want to draw a gaudy frame around the header, turn on this
3293 option. This option is enabled if print header is on (option 8).
3295 10. If you want that the line number is printed in your PostScript code,
3296 turn on this option.
3298 11. If you want background zebra stripes in your PostScript code, turn on
3301 12. If you want a duplex printing and your PostScript printer has this
3302 feature, turn on this option.
3304 13. If you turned on duplex printing, you can choose if you want to have a
3305 printing suitable for binding on the left or right (tumble off), or to
3306 have a printing suitable for binding at top or bottom (tumble on).
3307 This option is enabled if duplex is on (option 12).
3309 14. If you want a PostScript upside-down printing, turn on this option.
3311 15. With this option, you can choose if you want to print all pages, odd
3312 pages, even pages, odd sheets or even sheets.
3313 See also `ps-even-or-odd-pages'.
3315 IV. PostScript processing toggle options:
3317 16. If you want to spool the PostScript code generated, turn on this
3318 option. To spool the PostScript code generated use option 2. You can
3319 despool later by choosing option 1 or 2, sub-option `Despool...'.
3321 17. If you use colors in your buffers and want to see these colors on your
3322 PostScript code generated, turn on this option. If you have a
3323 black/white PostScript printer, these colors are displayed in gray
3324 scale by PostScript printer interpreter.
3326 18. If you don't have a PostScript printer to send PostScript files, turn
3327 on this option. When this option is on, the ghostscript is used to
3328 print PostScript files. In GNU or Unix system, if ghostscript is set
3329 as a PostScript filter, you don't need to turn on this option.
3331 V. Printing customization:
3333 19. If you want that region is automagically detected, turn on this
3334 option. Note that this will only work if you're using transient mark
3335 mode. When this option is on, the `*-buffer*' commands will behave
3336 like `*-region*' commands, that is, `*-buffer*' commands will print
3337 only the region marked instead of all buffer.
3339 20. Turn this option on if you want that when current major-mode is
3340 declared in `pr-mode-alist', the `*-buffer*' and `*-region*' commands
3341 behave like `*-mode*' commands.
3343 21. If you want that Printing menu stays open while you are setting
3344 toggle options, turn on this option. The variables
3345 `pr-menu-char-height' and `pr-menu-char-width' are used to guess the
3346 menu position, so don't forget to adjust these variables if menu
3351 22. Besides all options in section III, IV and V, you can customize much
3352 more PostScript options in `ps-print' option. Or you can customize
3353 some `lpr' options for text printing. Or customize `printing'
3356 23. Show current settings for `printing', `ps-print' or `lpr'.
3358 24. Quick help for printing menu layout.
3360 "Printing help message.")
3363 (defconst pr-interface-help-message
3364 (concat "printing.el version " pr-version
3365 " ps-print.el version " ps-print-version
3367 The printing interface buffer has the same functionality as the printing menu.
3368 The major difference is that the states (like sending PostScript generated to a
3369 file, n-up printing, etc.) are set and saved between priting buffer
3370 activation. Also, the landscape, duplex and tumble values are the same for
3371 PostScript file and directory/buffer/region/mode processing; using menu, there
3372 are different value sets for PostScript file and directory/buffer/region/mode
3375 The printing interface buffer has the following sections:
3379 Here you can choose to print/preview a buffer, a directory or a PostScript
3385 Select a buffer from the current buffer list.
3388 If it's on, this means that the selected buffer has an active region,
3389 so you can turn on/off, as you wish.
3390 If it's off when a buffer is selected, this means that the selected
3391 buffer has no active region, so it'll not be possible to turn it on.
3392 If you want to process the region, let this option on.
3393 If you want to process the whole buffer, let this option off.
3396 If it's on, this means that the selected buffer major mode is declared
3397 for major mode processing, so you can turn on/off, as you wish.
3398 If it's off when a buffer is selected, this means that the selected
3399 buffer major mode isn't declared for major mode processing, so it'll
3400 not be possible to turn it on.
3401 If you want the major mode processing, let this option on.
3402 If you don't want the major mode processing, let this option off.
3404 NOTE 1: It's possible to customize a major mode printing, just declare
3405 the customization in `pr-mode-alist' and invoke some of
3406 `*-mode*' commands or select Mode option in Printing menu. An
3407 example for major mode usage is when you're using gnus (or mh,
3408 or rmail, etc.) and you're in the *Summary* buffer, if you
3409 forget to switch to the *Article* buffer before printing,
3410 you'll get a nicely formatted list of article subjects shows
3411 up at the printer. With major mode printing you don't need to
3412 switch from gnus *Summary* buffer first.
3417 Specify a valid directory path.
3420 Specify a file name regexp. All file names in the directory that
3421 match with regexp will be printed/previewed. An empty file name
3422 regexp means to print/preview all files in the directory.
3424 * List Directory Entry:
3425 If it's turned on, list directory entries besides file entries.
3427 1c. PostScript file:
3430 Specify an existent PostScript file to print/preview.
3432 * PostScript Utility:
3433 Select a PostScript utility.
3434 See `pr-ps-utility-alist' and `pr-setting-database' for documentation.
3436 NOTE 2: Don't forget to download and install the utilities declared on
3437 `pr-ps-utility-alist'.
3440 If it's turned on, don't use the PostScript utility to preprocess the
3441 PostScript file before printing/previewing.
3443 2. PostScript printer:
3445 * PostScript Printer:
3446 You can select a new PostScript printer to send PostScript code
3447 generated. For selection it's used all PostScript printers defined
3448 in `pr-ps-printer-alist' variable (see it for documentation).
3449 See also `pr-setting-database'.
3452 If spooling is on, you can turn it on/off, as you wish.
3453 If spooling is off, it'll not be possible to turn it on.
3454 If it's turned on, specify to despools the PostScript spooling buffer in
3455 a temporary file or in the selected PostScript file when
3456 printing/previewing.
3459 Preview the PostScript generated.
3462 Print the PostScript generated.
3465 Quit from printing interface buffer.
3467 * Send to Printer/Temporary File:
3468 If it's turned on, the PostScript generated is sent directly to
3469 PostScript printer or, for previewing, to a temporary file.
3472 Specify a file name to send the PostScript generated.
3475 Specify n-up printing.
3480 Select a new text printer to send text generated. For selection it's used
3481 all text printers defined in `pr-txt-printer-alist' variable (see it for
3482 documentation). See also `pr-setting-database'.
3485 If you have control characters (character code from \\000 to \\037) in a
3486 buffer and you want to print them in a text printer, select this
3487 option. All control characters in your buffer or region will be
3488 replaced by a printable representation. The printable representations
3489 use ^ (for ASCII control characters) or hex. The characters tab,
3490 linefeed, space, return and formfeed are not affected.
3491 You don't need to select this option if you use any option of section
3492 I, the PostScript engine treats control characters properly.
3495 To print a directory, buffer, region or major mode in a
3496 text printer, select this option. See also the NOTE 1 on section 1.
3499 Quit from printing interface buffer.
3503 There are 3 setting columns:
3505 4a. First column (left column):
3508 PostScript landscape printing.
3511 To have a header in each page in your PostScript code.
3513 * Print Header Frame:
3514 To draw a gaudy frame around the header.
3517 The line number is printed in your PostScript code.
3520 Background zebra stripes in your PostScript code.
3523 Duplex printing (if your PostScript printer has this feature).
3526 If duplex printing is on, you can choose if you want to have a
3527 printing suitable for binding on the left or right (tumble off), or to
3528 have a printing suitable for binding at top or bottom (tumble on).
3531 PostScript upside-down printing.
3533 4b. Second column (middle column):
3536 If you want that region is automagically detected, turn on this
3537 option. Note that this will only work if you're using transient mark
3538 mode. When this option is on, the `*-buffer*' commands will behave
3539 like `*-region*' commands, that is, `*-buffer*' commands will print
3540 only the region marked instead of all buffer.
3543 Turn this option on if you want that when current major-mode is
3544 declared in `pr-mode-alist', the `*-buffer*' and `*-region*' commands
3545 behave like `*-mode*' commands.
3548 If you want that Printing menu stays open while you are setting
3549 toggle options, turn on this option. The variables
3550 `pr-menu-char-height' and `pr-menu-char-width' are used to guess the
3551 menu position, so don't forget to adjust these variables if menu
3555 To spool the PostScript code generated. You can despool later by
3556 setting Despool option on PostScript printer section.
3559 If you use colors in your buffers and want to see these colors on your
3560 PostScript code generated, turn on this option. If you have a
3561 black/white PostScript printer, these colors are displayed in gray
3562 scale by PostScript printer interpreter.
3564 * Print via Ghostscript:
3565 If you don't have a PostScript printer to send PostScript files, turn
3566 on this option. When this option is on, the ghostscript is used to
3567 print PostScript files. In GNU or Unix system, if ghostscript is set
3568 as a PostScript filter, you don't need to turn on this option.
3571 To print all pages, odd pages, even pages, odd sheets or even sheets.
3572 See also `ps-even-or-odd-pages'.
3574 4c. Third column (right column):
3577 That is, to be verbose when editing a field in interface buffer.
3581 Besides all options in section 4, you can customize much more PostScript
3582 options in `ps-print' option. Or you can customize some `lpr' options for
3583 text printing. Or customize `printing' options.
3587 Show current settings for `printing', `ps-print' or `lpr'.
3591 Quick help for printing interface buffer and printing menu layout. You can
3592 also quit the printing interface buffer or kill all printing help buffer.
3594 "Printing buffer interface help message.")
3597 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3602 (defun pr-interface (&optional buffer)
3603 "Activate the printing interface buffer.
3605 If BUFFER is nil, the current buffer is used for printing.
3607 For more information, type \\[pr-interface-help]."
3610 (set-buffer (or buffer (current-buffer)))
3611 (pr-create-interface)))
3615 (defun pr-ps-directory-preview (n-up dir file-regexp &optional filename)
3616 "Preview directory using ghostview.
3618 Interactively, the command prompts for N-UP printing number, a directory, a
3619 file name regexp for matching and, when you use a prefix argument (C-u), the
3620 command prompts the user for a file name, and saves the PostScript image in
3621 that file instead of saving it in a temporary file.
3623 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
3624 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
3625 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
3626 save the image in a temporary file. If FILENAME is a string, save the
3627 PostScript image in a file with that name. If FILENAME is t, prompts for a
3630 See also documentation for `pr-list-directory'."
3631 (interactive (pr-interactive-ps-dir-args (pr-prompt "PS preview dir")))
3632 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
3633 (pr-prompt "PS preview dir"))
3634 (setq filename (pr-ps-file filename))
3635 (pr-ps-file-list n-up dir file-regexp filename)
3637 (pr-ps-file-preview filename)))
3641 (defun pr-ps-directory-using-ghostscript (n-up dir file-regexp &optional filename)
3642 "Print directory using PostScript through ghostscript.
3644 Interactively, the command prompts for N-UP printing number, a directory, a
3645 file name regexp for matching and, when you use a prefix argument (C-u), the
3646 command prompts the user for a file name, and saves the PostScript image in
3647 that file instead of saving it in a temporary file.
3649 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
3650 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
3651 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
3652 save the image in a temporary file. If FILENAME is a string, save the
3653 PostScript image in a file with that name. If FILENAME is t, prompts for a
3656 See also documentation for `pr-list-directory'."
3657 (interactive (pr-interactive-ps-dir-args (pr-prompt "PS print dir GS")))
3658 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
3659 (pr-prompt "PS print dir GS"))
3660 (let ((file (pr-ps-file filename)))
3661 (pr-ps-file-list n-up dir file-regexp file)
3662 (pr-ps-file-using-ghostscript file)
3663 (or filename (pr-delete-file file))))
3667 (defun pr-ps-directory-print (n-up dir file-regexp &optional filename)
3668 "Print directory using PostScript printer.
3670 Interactively, the command prompts for N-UP printing number, a directory, a
3671 file name regexp for matching and, when you use a prefix argument (C-u), the
3672 command prompts the user for a file name, and saves the PostScript image in
3673 that file instead of saving it in a temporary file.
3675 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
3676 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
3677 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
3678 save the image in a temporary file. If FILENAME is a string, save the
3679 PostScript image in a file with that name. If FILENAME is t, prompts for a
3682 See also documentation for `pr-list-directory'."
3683 (interactive (pr-interactive-ps-dir-args (pr-prompt "PS print dir")))
3684 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
3685 (pr-prompt "PS print dir"))
3686 (let ((file (pr-ps-file filename)))
3687 (pr-ps-file-list n-up dir file-regexp file)
3688 (pr-ps-file-print file)
3689 (or filename (pr-delete-file file))))
3693 (defun pr-ps-directory-ps-print (n-up dir file-regexp &optional filename)
3694 "Print directory using PostScript printer or through ghostscript.
3696 It depends on `pr-print-using-ghostscript'.
3698 Interactively, the command prompts for N-UP printing number, a directory, a
3699 file name regexp for matching and, when you use a prefix argument (C-u), the
3700 command prompts the user for a file name, and saves the PostScript image in
3701 that file instead of saving it in a temporary file.
3703 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
3704 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
3705 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
3706 save the image in a temporary file. If FILENAME is a string, save the
3707 PostScript image in a file with that name. If FILENAME is t, prompts for a
3710 See also documentation for `pr-list-directory'."
3711 (interactive (pr-interactive-ps-dir-args
3712 (pr-prompt (pr-prompt-gs "PS print dir"))))
3713 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
3714 (pr-prompt (pr-prompt-gs "PS print dir")))
3715 (if (pr-using-ghostscript-p)
3716 (pr-ps-directory-using-ghostscript n-up dir file-regexp filename)
3717 (pr-ps-directory-print n-up dir file-regexp filename)))
3721 (defun pr-ps-buffer-preview (n-up &optional filename)
3722 "Preview buffer using ghostview.
3724 Interactively, the command prompts for N-UP printing number and, when you use a
3725 prefix argument (C-u), the command prompts the user for a file name, and saves
3726 the PostScript image in that file instead of saving it in a temporary file.
3728 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
3729 argument FILENAME is treated as follows: if it's nil, save the image in a
3730 temporary file. If FILENAME is a string, save the PostScript image in a file
3731 with that name. If FILENAME is t, prompts for a file name."
3732 (interactive (pr-interactive-n-up-file (pr-prompt "PS preview")))
3733 (if (pr-auto-mode-p)
3734 (pr-ps-mode-preview n-up filename)
3735 (pr-ps-preview (pr-region-active-symbol) n-up filename
3736 (pr-region-active-string "PS preview"))))
3740 (defun pr-ps-buffer-using-ghostscript (n-up &optional filename)
3741 "Print buffer using PostScript through ghostscript.
3743 Interactively, the command prompts for N-UP printing number and, when you use a
3744 prefix argument (C-u), the command prompts the user for a file name, and saves
3745 the PostScript image in that file instead of sending it to the printer.
3747 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
3748 argument FILENAME is treated as follows: if it's nil, send the image to the
3749 printer. If FILENAME is a string, save the PostScript image in a file with
3750 that name. If FILENAME is t, prompts for a file name."
3751 (interactive (pr-interactive-n-up-file (pr-prompt "PS print GS")))
3752 (if (pr-auto-mode-p)
3753 (pr-ps-mode-using-ghostscript n-up filename)
3754 (pr-ps-using-ghostscript (pr-region-active-symbol) n-up filename
3755 (pr-region-active-string "PS print GS"))))
3759 (defun pr-ps-buffer-print (n-up &optional filename)
3760 "Print buffer using PostScript printer.
3762 Interactively, the command prompts for N-UP printing number and, when you use a
3763 prefix argument (C-u), the command prompts the user for a file name, and saves
3764 the PostScript image in that file instead of sending it to the printer.
3766 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
3767 argument FILENAME is treated as follows: if it's nil, send the image to the
3768 printer. If FILENAME is a string, save the PostScript image in a file with
3769 that name. If FILENAME is t, prompts for a file name."
3770 (interactive (pr-interactive-n-up-file (pr-prompt "PS print")))
3771 (if (pr-auto-mode-p)
3772 (pr-ps-mode-print n-up filename)
3773 (pr-ps-print (pr-region-active-symbol) n-up filename
3774 (pr-region-active-string "PS print"))))
3778 (defun pr-ps-buffer-ps-print (n-up &optional filename)
3779 "Print buffer using PostScript printer or through ghostscript.
3781 It depends on `pr-print-using-ghostscript'.
3783 Interactively, the command prompts for N-UP printing number and, when you use a
3784 prefix argument (C-u), the command prompts the user for a file name, and saves
3785 the PostScript image in that file instead of sending it to the printer.
3787 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
3788 argument FILENAME is treated as follows: if it's nil, send the image to the
3789 printer. If FILENAME is a string, save the PostScript image in a file with
3790 that name. If FILENAME is t, prompts for a file name."
3791 (interactive (pr-interactive-n-up-file
3792 (pr-prompt (pr-prompt-gs "PS print"))))
3793 (cond ((pr-auto-mode-p)
3794 (pr-ps-mode-ps-print n-up filename))
3795 ((pr-using-ghostscript-p)
3796 (pr-ps-using-ghostscript (pr-region-active-symbol) n-up filename
3797 (pr-region-active-string "PS print GS")))
3799 (pr-ps-print (pr-region-active-symbol) n-up filename
3800 (pr-region-active-string "PS print")))))
3804 (defun pr-ps-region-preview (n-up &optional filename)
3805 "Preview region using ghostview.
3807 See also `pr-ps-buffer-preview'."
3808 (interactive (pr-interactive-n-up-file (pr-prompt-region "PS preview")))
3809 (if (pr-auto-mode-p)
3810 (let ((pr-auto-region t))
3811 (pr-ps-mode-preview n-up filename))
3812 (pr-ps-preview 'region n-up filename "PS preview region")))
3816 (defun pr-ps-region-using-ghostscript (n-up &optional filename)
3817 "Print region using PostScript through ghostscript.
3819 See also `pr-ps-buffer-using-ghostscript'."
3820 (interactive (pr-interactive-n-up-file (pr-prompt-region "PS print GS")))
3821 (if (pr-auto-mode-p)
3822 (let ((pr-auto-region t))
3823 (pr-ps-mode-using-ghostscript n-up filename))
3824 (pr-ps-using-ghostscript 'region n-up filename "PS print GS region")))
3828 (defun pr-ps-region-print (n-up &optional filename)
3829 "Print region using PostScript printer.
3831 See also `pr-ps-buffer-print'."
3832 (interactive (pr-interactive-n-up-file (pr-prompt-region "PS print")))
3833 (if (pr-auto-mode-p)
3834 (let ((pr-auto-region t))
3835 (pr-ps-mode-print n-up filename))
3836 (pr-ps-print 'region n-up filename "PS print region")))
3840 (defun pr-ps-region-ps-print (n-up &optional filename)
3841 "Print region using PostScript printer or through ghostscript.
3843 See also `pr-ps-buffer-ps-print'."
3844 (interactive (pr-interactive-n-up-file
3845 (pr-prompt-region (pr-prompt-gs "PS print"))))
3846 (cond ((pr-auto-mode-p)
3847 (let ((pr-auto-region t))
3848 (pr-ps-mode-ps-print n-up filename)))
3849 ((pr-using-ghostscript-p)
3850 (pr-ps-using-ghostscript 'region n-up filename "PS print GS region"))
3852 (pr-ps-print 'region n-up filename "PS print region"))))
3856 (defun pr-ps-mode-preview (n-up &optional filename)
3857 "Preview major mode using ghostview.
3859 See also `pr-ps-buffer-preview'."
3860 (interactive (pr-interactive-n-up-file "PS preview mode"))
3861 (pr-set-n-up-and-filename 'n-up 'filename "PS preview mode")
3862 (let ((file (pr-ps-file filename)))
3863 (and (pr-ps-mode n-up file)
3865 (pr-ps-file-preview file))))
3869 (defun pr-ps-mode-using-ghostscript (n-up &optional filename)
3870 "Print major mode using PostScript through ghostscript.
3872 See also `pr-ps-buffer-using-ghostscript'."
3873 (interactive (pr-interactive-n-up-file "PS print GS mode"))
3874 (pr-set-n-up-and-filename 'n-up 'filename "PS print GS mode")
3875 (let ((file (pr-ps-file filename)))
3876 (when (and (pr-ps-mode n-up file)
3878 (pr-ps-file-using-ghostscript file)
3879 (or filename (pr-delete-file file)))))
3883 (defun pr-ps-mode-print (n-up &optional filename)
3884 "Print major mode using PostScript printer.
3886 See also `pr-ps-buffer-print'."
3887 (interactive (pr-interactive-n-up-file "PS print mode"))
3888 (pr-set-n-up-and-filename 'n-up 'filename "PS print mode")
3889 (pr-ps-mode n-up filename))
3893 (defun pr-ps-mode-ps-print (n-up &optional filename)
3894 "Print major mode using PostScript or through ghostscript.
3896 See also `pr-ps-buffer-ps-print'."
3897 (interactive (pr-interactive-n-up-file (pr-prompt-gs "PS print mode")))
3898 (if (pr-using-ghostscript-p)
3899 (pr-ps-mode-using-ghostscript n-up filename)
3900 (pr-ps-mode-print n-up filename)))
3904 (defun pr-printify-directory (&optional dir file-regexp)
3905 "Replace nonprinting characters in directory with printable representations.
3906 The printable representations use ^ (for ASCII control characters) or hex.
3907 The characters tab, linefeed, space, return and formfeed are not affected.
3909 Interactively, the command prompts for a directory and a file name regexp for
3912 Noninteractively, if DIR is nil, prompts for DIRectory. If FILE-REGEXP is nil,
3913 prompts for FILE(name)-REGEXP.
3915 See also documentation for `pr-list-directory'."
3916 (interactive (pr-interactive-dir-args "Printify dir"))
3917 (pr-set-dir-args 'dir 'file-regexp "Printify dir")
3918 (pr-file-list dir file-regexp 'pr-printify-buffer))
3922 (defun pr-printify-buffer ()
3923 "Replace nonprinting characters in buffer with printable representations.
3924 The printable representations use ^ (for ASCII control characters) or hex.
3925 The characters tab, linefeed, space, return and formfeed are not affected."
3927 (if (pr-region-active-p)
3928 (pr-printify-region)
3929 (printify-region (point-min) (point-max))))
3933 (defun pr-printify-region ()
3934 "Replace nonprinting characters in region with printable representations.
3935 The printable representations use ^ (for ASCII control characters) or hex.
3936 The characters tab, linefeed, space, return and formfeed are not affected."
3938 (printify-region (point) (mark)))
3942 (defun pr-txt-directory (&optional dir file-regexp)
3943 "Print directory using text printer.
3945 Interactively, the command prompts for a directory and a file name regexp for
3948 Noninteractively, if DIR is nil, prompts for DIRectory. If FILE-REGEXP is nil,
3949 prompts for FILE(name)-REGEXP.
3951 See also documentation for `pr-list-directory'."
3952 (interactive (pr-interactive-dir-args "Print dir"))
3953 (pr-set-dir-args 'dir 'file-regexp "Print dir")
3954 (pr-file-list dir file-regexp 'pr-txt-buffer))
3958 (defun pr-txt-buffer ()
3959 "Print buffer using text printer."
3961 (cond ((pr-auto-mode-p)
3963 ((pr-region-active-p)
3966 (pr-txt-print (point-min) (point-max)))))
3970 (defun pr-txt-region ()
3971 "Print region using text printer."
3973 (if (pr-auto-mode-p)
3974 (let ((pr-auto-region t))
3976 (pr-txt-print (point) (mark))))
3980 (defun pr-txt-mode ()
3981 "Print major mode using text printer."
3983 (let ((args (pr-mode-alist-p)))
3985 (funcall (car args) (nthcdr 2 args))
3987 (message "`%s' major mode not declared." major-mode))))
3991 (defun pr-despool-preview (&optional filename)
3992 "Preview spooled PostScript.
3994 Interactively, when you use a prefix argument (C-u), the command prompts the
3995 user for a file name, and saves the spooled PostScript image in that file
3996 instead of saving it in a temporary file.
3998 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
3999 save the image in a temporary file. If FILENAME is a string, save the
4000 PostScript image in a file with that name."
4001 (interactive (list (ps-print-preprint current-prefix-arg)))
4002 (let ((file (pr-ps-file filename)))
4003 (when (stringp file)
4004 (pr-despool-print file)
4005 (pr-ps-file-preview file))))
4009 (defun pr-despool-using-ghostscript (&optional filename)
4010 "Print spooled PostScript using ghostscript.
4012 Interactively, when you use a prefix argument (C-u), the command prompts the
4013 user for a file name, and saves the spooled PostScript image in that file
4014 instead of sending it to the printer.
4016 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4017 send the image to the printer. If FILENAME is a string, save the PostScript
4018 image in a file with that name."
4019 (interactive (list (ps-print-preprint current-prefix-arg)))
4020 (let ((file (pr-ps-file filename)))
4021 (when (stringp file)
4022 (pr-despool-print file)
4023 (pr-ps-file-using-ghostscript file)
4024 (or filename (pr-delete-file file)))))
4028 (defun pr-despool-print (&optional filename)
4029 "Send the spooled PostScript to the printer.
4031 Interactively, when you use a prefix argument (C-u), the command prompts the
4032 user for a file name, and saves the spooled PostScript image in that file
4033 instead of sending it to the printer.
4035 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4036 send the image to the printer. If FILENAME is a string, save the PostScript
4037 image in a file with that name."
4038 (interactive (list (ps-print-preprint current-prefix-arg)))
4040 (let ((ps-lpr-command (pr-command pr-ps-command))
4041 (ps-lpr-switches pr-ps-switches)
4042 (ps-printer-name-option pr-ps-printer-switch)
4043 (ps-printer-name pr-ps-printer))
4044 (ps-despool filename))))
4048 (defun pr-despool-ps-print (&optional filename)
4049 "Send the spooled PostScript to the printer or use ghostscript to print it.
4051 Interactively, when you use a prefix argument (C-u), the command prompts the
4052 user for a file name, and saves the spooled PostScript image in that file
4053 instead of sending it to the printer.
4055 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4056 send the image to the printer. If FILENAME is a string, save the PostScript
4057 image in a file with that name."
4058 (interactive (list (ps-print-preprint current-prefix-arg)))
4059 (if pr-print-using-ghostscript
4060 (pr-despool-using-ghostscript filename)
4061 (pr-despool-print filename)))
4065 (defun pr-ps-file-preview (filename)
4066 "Preview PostScript file FILENAME."
4067 (interactive (list (pr-ps-infile-preprint "Preview ")))
4068 (and (stringp filename) (file-exists-p filename)
4069 (pr-call-process pr-gv-command filename)))
4073 (defun pr-ps-file-up-preview (n-up ifilename &optional ofilename)
4074 "Preview PostScript file FILENAME."
4075 (interactive (pr-interactive-n-up-inout "PS preview"))
4076 (let ((outfile (pr-ps-utility-args 'n-up 'ifilename 'ofilename
4078 (pr-ps-utility-process n-up ifilename outfile)
4079 (pr-ps-file-preview outfile)))
4083 (defun pr-ps-file-using-ghostscript (filename)
4084 "Print PostScript file FILENAME using ghostscript."
4085 (interactive (list (pr-ps-infile-preprint "Print preview ")))
4086 (and (stringp filename) (file-exists-p filename)
4087 (let* ((file (pr-expand-file-name filename))
4088 (tempfile (pr-dosify-file-name (make-temp-file file))))
4090 (pr-call-process pr-gs-command
4091 (format "-sDEVICE=%s" pr-gs-device)
4092 (format "-r%d" pr-gs-resolution)
4093 (pr-switches-string pr-gs-switches "pr-gs-switches")
4094 (format "-sOutputFile=\"%s\"" tempfile)
4098 (pr-ps-file-print tempfile)
4100 (pr-delete-file tempfile))))
4104 (defun pr-ps-file-print (filename)
4105 "Print PostScript file FILENAME."
4106 (interactive (list (pr-ps-infile-preprint "Print ")))
4107 (and (stringp filename) (file-exists-p filename)
4109 (let ((file (pr-expand-file-name filename)))
4110 (if (string= pr-ps-command "")
4112 (let ((ps-spool-buffer (get-buffer-create ps-spool-buffer-name)))
4114 (set-buffer ps-spool-buffer)
4116 (insert-file-contents-literally file))
4118 ;; use `pr-ps-command' to print
4119 (apply 'pr-call-process
4121 (pr-switches-string pr-ps-switches "pr-ps-switches")
4122 (if (string-match "cp" pr-ps-command)
4123 ;; for "cp" (cmd in out)
4125 (concat pr-ps-printer-switch pr-ps-printer))
4126 ;; else, for others (cmd out in)
4127 (list (concat pr-ps-printer-switch pr-ps-printer)
4132 (defun pr-ps-file-ps-print (filename)
4133 "Send PostScript file FILENAME to printer or use ghostscript to print it."
4134 (interactive (list (pr-ps-infile-preprint
4135 (if pr-print-using-ghostscript
4138 (if pr-print-using-ghostscript
4139 (pr-ps-file-using-ghostscript filename)
4140 (pr-ps-file-print filename)))
4144 (defun pr-ps-file-up-ps-print (n-up ifilename &optional ofilename)
4145 "Process a PostScript file IFILENAME and send it to printer.
4147 Interactively, the command prompts for N-UP printing number, for an input
4148 PostScript file IFILENAME and, when you use a prefix argument (C-u), the
4149 command prompts the user for an output PostScript file name OFILENAME, and
4150 saves the PostScript image in that file instead of sending it to the printer.
4152 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
4153 argument IFILENAME is treated as follows: if it's t, prompts for an input
4154 PostScript file name; otherwise, it *must* be a string that it's an input
4155 PostScript file name. The argument OFILENAME is treated as follows: if it's
4156 nil, send the image to the printer. If OFILENAME is a string, save the
4157 PostScript image in a file with that name. If OFILENAME is t, prompts for a
4159 (interactive (pr-interactive-n-up-inout
4160 (if pr-print-using-ghostscript
4163 (let ((outfile (pr-ps-utility-args 'n-up 'ifilename 'ofilename
4164 (if pr-print-using-ghostscript
4167 (pr-ps-utility-process n-up ifilename outfile)
4169 (pr-ps-file-ps-print outfile)
4170 (pr-delete-file outfile))))
4174 (defun pr-toggle-file-duplex ()
4175 "Toggle duplex for PostScript file."
4177 (pr-toggle-file-duplex-menu t))
4181 (defun pr-toggle-file-tumble ()
4182 "Toggle tumble for PostScript file.
4184 If tumble is off, produces a printing suitable for binding on the left or
4186 If tumble is on, produces a printing suitable for binding at the top or
4189 (pr-toggle-file-tumble-menu t))
4193 (defun pr-toggle-file-landscape ()
4194 "Toggle landscape for PostScript file."
4196 (pr-toggle-file-landscape-menu t))
4200 (defun pr-toggle-ghostscript ()
4201 "Toggle printing using ghostscript."
4203 (pr-toggle-ghostscript-menu t))
4207 (defun pr-toggle-faces ()
4208 "Toggle printing with faces."
4210 (pr-toggle-faces-menu t))
4214 (defun pr-toggle-spool ()
4217 (pr-toggle-spool-menu t))
4221 (defun pr-toggle-duplex ()
4224 (pr-toggle-duplex-menu t))
4228 (defun pr-toggle-tumble ()
4231 If tumble is off, produces a printing suitable for binding on the left or
4233 If tumble is on, produces a printing suitable for binding at the top or
4236 (pr-toggle-tumble-menu t))
4240 (defun pr-toggle-landscape ()
4243 (pr-toggle-landscape-menu t))
4247 (defun pr-toggle-upside-down ()
4248 "Toggle upside-down."
4250 (pr-toggle-upside-down-menu t))
4254 (defun pr-toggle-line ()
4255 "Toggle line number."
4257 (pr-toggle-line-menu t))
4261 (defun pr-toggle-zebra ()
4262 "Toggle zebra stripes."
4264 (pr-toggle-zebra-menu t))
4268 (defun pr-toggle-header ()
4269 "Toggle printing header."
4271 (pr-toggle-header-menu t))
4275 (defun pr-toggle-header-frame ()
4276 "Toggle printing header frame."
4278 (pr-toggle-header-frame-menu t))
4282 (defun pr-toggle-lock ()
4285 (pr-toggle-lock-menu t))
4289 (defun pr-toggle-region ()
4290 "Toggle auto region."
4292 (pr-toggle-region-menu t))
4296 (defun pr-toggle-mode ()
4299 (pr-toggle-mode-menu t))
4303 (defun pr-customize (&rest ignore)
4304 "Customization of the `printing' group."
4306 (customize-group 'printing))
4310 (defun lpr-customize (&rest ignore)
4311 "Customization of the `lpr' group."
4313 (customize-group 'lpr))
4317 (defun pr-help (&rest ignore)
4318 "Help for the printing package."
4320 (pr-show-setup pr-help-message "*Printing Help*"))
4324 (defun pr-ps-name ()
4325 "Interactively select a PostScript printer."
4327 (pr-menu-set-ps-title
4328 (pr-complete-alist "PostScript printer"
4329 pr-ps-printer-alist pr-ps-name)))
4333 (defun pr-txt-name ()
4334 "Interactively select a text printer."
4336 (pr-menu-set-txt-title
4337 (pr-complete-alist "Text printer"
4338 pr-txt-printer-alist pr-txt-name)))
4342 (defun pr-ps-utility ()
4343 "Interactively select a PostScript utility."
4345 (pr-menu-set-utility-title
4346 (pr-complete-alist "Postscript utility"
4347 pr-ps-utility-alist pr-ps-utility)))
4351 (defun pr-show-ps-setup (&rest ignore)
4352 "Show current ps-print settings."
4354 (pr-show-setup (ps-setup) "*PS Setup*"))
4358 (defun pr-show-pr-setup (&rest ignore)
4359 "Show current printing settings."
4361 (pr-show-setup (pr-setup) "*PR Setup*"))
4365 (defun pr-show-lpr-setup (&rest ignore)
4366 "Show current lpr settings."
4368 (pr-show-setup (lpr-setup) "*LPR Setup*"))
4371 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4376 (defun pr-ps-fast-fire (n-up &optional select)
4377 "Fast fire function for PostScript printing.
4379 If a region is active, the region will be printed instead of the whole buffer.
4380 Also if the current major-mode is defined in `pr-mode-alist', the settings in
4381 `pr-mode-alist' will be used, that is, the current buffer or region will be
4382 printed using `pr-ps-mode-ps-print'.
4385 Interactively, you have the following situations:
4387 M-x pr-ps-fast-fire RET
4388 The command prompts the user for a N-UP value and printing will
4389 immediatelly be done using the current active printer.
4391 C-u M-x pr-ps-fast-fire RET
4392 C-u 0 M-x pr-ps-fast-fire RET
4393 The command prompts the user for a N-UP value and also for a current
4394 PostScript printer, then printing will immediatelly be done using the new
4395 current active printer.
4397 C-u 1 M-x pr-ps-fast-fire RET
4398 The command prompts the user for a N-UP value and also for a file name,
4399 and saves the PostScript image in that file instead of sending it to the
4402 C-u 2 M-x pr-ps-fast-fire RET
4403 The command prompts the user for a N-UP value, then for a current
4404 PostScript printer and, finally, for a file name. Then change the active
4405 printer to that choosen by user and saves the PostScript image in
4406 that file instead of sending it to the printer.
4409 Noninteractively, the argument N-UP should be a positive integer greater than
4410 zero and the argument SELECT is treated as follows:
4412 If it's nil, send the image to the printer.
4414 If it's a list or an integer lesser or equal to zero, the command prompts
4415 the user for a current PostScript printer, then printing will immediatelly
4416 be done using the new current active printer.
4418 If it's an integer equal to 1, the command prompts the user for a file name
4419 and saves the PostScript image in that file instead of sending it to the
4422 If it's an integer greater or equal to 2, the command prompts the user for a
4423 current PostScript printer and for a file name. Then change the active
4424 printer to that choosen by user and saves the PostScript image in that file
4425 instead of sending it to the printer.
4427 If it's a symbol which it's defined in `pr-ps-printer-alist', it's the new
4428 active printer and printing will immediatelly be done using the new active
4431 Otherwise, send the image to the printer.
4434 Note that this command always behaves as if `pr-auto-region' and `pr-auto-mode'
4436 (interactive (list (pr-interactive-n-up (pr-prompt-gs "PS print fast"))
4437 current-prefix-arg))
4438 (let ((pr-auto-region t)
4441 (cond ((null select))
4444 ((and (symbolp select)
4445 (assq select pr-ps-printer-alist))
4446 (pr-menu-set-ps-title select))
4450 (and (>= select 1) (not pr-spool-p)
4451 (setq filename (pr-ps-outfile-preprint
4452 (if pr-print-using-ghostscript
4455 (pr-ps-buffer-ps-print
4457 (min (max n-up 1) 100)
4458 (error "n-up must be an integer greater than zero"))
4463 (defun pr-txt-fast-fire (&optional select-printer)
4464 "Fast fire function for text printing.
4466 If a region is active, the region will be printed instead of the whole buffer.
4467 Also if the current major-mode is defined in `pr-mode-alist', the settings in
4468 `pr-mode-alist' will be used, that is, the current buffer or region will be
4469 printed using `pr-txt-mode'.
4471 Interactively, when you use a prefix argument (C-u), the command prompts the
4472 user for a new active text printer.
4474 Noninteractively, the argument SELECT-PRINTER is treated as follows:
4476 If it's nil, the printing is sent to the current active text printer.
4478 If it's a symbol which it's defined in `pr-txt-printer-alist', it's the new
4479 active printer and printing will immediatelly be done using the new active
4482 If it's non-nil, the command prompts the user for a new active text printer.
4484 Note that this command always behaves as if `pr-auto-region' and `pr-auto-mode'
4486 (interactive (list current-prefix-arg))
4487 (cond ((null select-printer))
4488 ((and (symbolp select-printer)
4489 (assq select-printer pr-txt-printer-alist))
4490 (pr-menu-set-txt-title select-printer))
4493 (let ((pr-auto-region t)
4498 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4503 "Return the current `printing' setup.
4505 This is *not* an interactive command.
4506 One way to see `printing' setup is to switch to a *Scratch* buffer and type:
4508 M-: (insert (pr-setup)) RET
4510 Or choose the menu option Printing/Show Settings/printing."
4511 (let (ps-prefix-quote)
4515 (concat "\n;;; printing.el version " pr-version "\n")
4517 (ps-comment-string "emacs-version " emacs-version)
4518 (ps-comment-string "pr-txt-command " pr-txt-command)
4519 (ps-comment-string "pr-txt-switches "
4520 (pr-switches-string pr-txt-switches "pr-txt-switches"))
4521 (ps-comment-string "pr-txt-printer " pr-txt-printer)
4522 (ps-comment-string "pr-ps-command " pr-ps-command)
4523 (ps-comment-string "pr-ps-switches "
4524 (pr-switches-string pr-ps-switches "pr-ps-switches"))
4525 (ps-comment-string "pr-ps-printer-switch" pr-ps-printer-switch)
4526 (ps-comment-string "pr-ps-printer " pr-ps-printer)
4527 (ps-comment-string "pr-cygwin-system " pr-cygwin-system)
4528 (ps-comment-string "ps-windows-system " ps-windows-system)
4529 (ps-comment-string "ps-lp-system " ps-lp-system)
4531 '(14 . pr-path-style)
4532 '(14 . pr-path-alist)
4535 '(21 . pr-txt-printer-alist)
4538 '(20 . pr-ps-printer-alist)
4541 '(20 . pr-ps-temp-file)
4542 '(20 . pr-file-modes)
4543 '(20 . pr-delete-temp-file)
4544 '(20 . pr-list-directory)
4546 '(17 . pr-gv-command)
4547 '(17 . pr-gs-command)
4548 '(17 . pr-gs-switches)
4549 '(17 . pr-gs-device)
4550 '(17 . pr-gs-resolution)
4552 '(27 . pr-print-using-ghostscript)
4555 '(27 . pr-file-landscape)
4556 '(27 . pr-file-duplex)
4557 '(27 . pr-file-tumble)
4558 '(27 . pr-auto-region)
4559 '(27 . pr-auto-mode)
4561 '(20 . pr-ps-utility)
4562 '(20 . pr-ps-utility-alist)
4564 '(14 . pr-mode-alist)
4566 '(20 . pr-menu-lock)
4567 '(20 . pr-menu-char-height)
4568 '(20 . pr-menu-char-width)
4570 '(20 . pr-setting-database)
4572 '(22 . pr-visible-entry-list)
4574 '(22 . pr-buffer-verbose)
4575 '(22 . pr-buffer-name)
4576 '(22 . pr-buffer-name-ignore)
4577 ")\n\n;;; printing.el - end of settings\n")
4582 "Return the current `lpr' setup.
4584 This is *not* an interactive command.
4585 One way to see `lpr' setup is to switch to a *Scratch* buffer and type:
4587 M-: (insert (lpr-setup)) RET
4589 Or choose the menu option Printing/Show Settings/lpr."
4590 (let (ps-prefix-quote)
4594 "\n;;; lpr.el settings\n"
4595 (ps-comment-string "emacs-version" emacs-version)
4597 '(25 . printer-name)
4598 '(25 . lpr-switches)
4599 '(25 . lpr-add-switches)
4601 '(25 . lpr-headers-switches)
4602 '(25 . print-region-function)
4603 '(25 . lpr-page-header-program)
4604 '(25 . lpr-page-header-switches)
4605 ")\n\n;;; lpr.el - end of settings\n")
4609 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4610 ;; mh-e (adapted from mh-e-init.el -- Tom Vogels <tov@ece.cmu.edu>)
4613 (defalias 'pr-mh-get-msg-num 'mh-get-msg-num)
4614 (defalias 'pr-mh-show 'mh-show)
4615 (defalias 'pr-mh-start-of-uncleaned-message 'mh-start-of-uncleaned-message)
4616 (defvar mh-show-buffer nil)
4619 (defun pr-article-date ()
4620 "Find the date of an article or mail message in current buffer.
4621 Return only the dayname, if present, weekday, month, and year."
4623 (goto-char (point-min))
4624 (if (re-search-forward
4625 "^Date:[ \t]+\\(\\([A-Za-z]+, \\)?[0-9]+ [A-Za-z]+ [0-9]+\\)" nil t)
4626 (buffer-substring (match-beginning 1) (match-end 1))
4627 (format-time-string "%Y/%m/%d"))))
4630 (defun pr-mh-current-message ()
4631 "Go to mh-inbox current message."
4632 (let ((msg (or (pr-mh-get-msg-num nil) 0)))
4634 (set-buffer mh-show-buffer)
4635 (goto-char (point-min))
4636 (pr-mh-start-of-uncleaned-message)
4637 (message "Printing message %d" msg)))
4640 (defun pr-mh-print-1 (n-up filename header-list)
4641 "Print mh-inbox current message in PostScript."
4643 (save-window-excursion
4644 (pr-mh-current-message)
4645 (pr-mode-print n-up filename header-list (point)))))
4648 (defun pr-mh-lpr-1 (header-list)
4649 "Print mh-inbox current message in text printer."
4651 (save-window-excursion
4652 (pr-mh-current-message)
4653 (pr-mode-lpr header-list (point)))))
4656 (defalias 'pr-mh-print-2 'pr-mode-print)
4659 (defalias 'pr-mh-lpr-2 'pr-mode-lpr)
4662 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4663 ;; rmail (hacked from ps-print.el)
4666 (defun pr-rmail-lpr (header-list)
4667 "Print RMAIL current message in text printer."
4668 (pr-lpr-message-from-summary header-list
4669 'rmail-buffer 'rmail-summary-buffer))
4672 (defun pr-rmail-print (n-up filename header-list)
4673 "Print RMAIL current message in PostScript."
4674 (pr-ps-message-from-summary n-up filename header-list
4675 'rmail-buffer 'rmail-summary-buffer))
4678 (defun pr-ps-message-from-summary (n-up filename header-list
4679 summary-buffer summary-default)
4680 "Print current message in PostScript."
4681 (let ((buf (or (and (boundp summary-buffer)
4682 (symbol-value summary-buffer))
4683 (symbol-value summary-default))))
4684 (and (get-buffer buf)
4687 (pr-mode-print n-up filename header-list)))))
4690 (defun pr-lpr-message-from-summary (header-list summary-buffer summary-default)
4691 "Print current message in text printer."
4692 (let ((buf (or (and (boundp summary-buffer)
4693 (symbol-value summary-buffer))
4694 (symbol-value summary-default))))
4695 (and (get-buffer buf)
4698 (pr-mode-lpr header-list)))))
4701 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4702 ;; gnus (hacked from ps-print.el)
4705 (defvar pr-gnus-article "*Article*")
4708 (defun pr-gnus-print (n-up filename header-list)
4709 "Print *Article* current message in PostScript."
4710 (pr-ps-message-from-summary n-up filename header-list
4711 'gnus-article-buffer 'pr-gnus-article))
4714 (defun pr-gnus-lpr (header-list)
4715 "Print *Article* current message in text printer."
4716 (pr-lpr-message-from-summary header-list
4717 'gnus-article-buffer 'pr-gnus-article))
4720 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4721 ;; vm (hacked from ps-print.el)
4724 (defvar pr-vm-summary "")
4727 (defun pr-vm-print (n-up filename header-list)
4728 "Print current vm message in PostScript."
4729 (pr-ps-message-from-summary n-up filename header-list
4730 'vm-mail-buffer 'pr-vm-summary))
4733 (defun pr-vm-lpr (header-list)
4734 "Print current vm message in text printer."
4735 (pr-lpr-message-from-summary header-list
4736 'vm-mail-buffer 'pr-vm-summary))
4739 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4743 (defun pr-ps-mode (n-up filename)
4744 "If current major mode is declared, print it in PostScript."
4745 (let ((args (pr-mode-alist-p)))
4747 (let ((fun (cdr args)))
4748 (funcall (car fun) n-up filename (cdr fun))
4751 (message "`%s' major mode not declared." major-mode)
4755 (defmacro pr-local-variable (header-list &rest body)
4757 (let ((ps-header-lines (or (nth 0 ,header-list) ps-header-lines))
4758 (ps-left-header (or (nth 1 ,header-list) ps-left-header))
4759 (ps-right-header (or (nth 2 ,header-list) ps-right-header))
4761 (let ((local-var-list (pr-eval-local-alist (nthcdr 4 ,header-list))))
4763 (and (nth 3 ,header-list)
4764 (pr-kill-local-variable local-var-list))))))
4767 (defun pr-mode-print (n-up filename header-list &optional from to)
4768 "Print current major mode in PostScript."
4771 (let ((file (pr-ps-file filename))
4773 ((pr-region-active-p) (region-beginning))
4776 (pr-text2ps (pr-region-active-symbol start) n-up file start
4778 ((pr-region-active-p) (region-end))
4781 (unless (or pr-spool-p filename)
4782 (pr-ps-file-print file)
4783 (pr-delete-file file)))))
4786 (defun pr-mode-lpr (header-list &optional from to)
4787 "Print current major mode in text printer."
4790 (pr-txt-print (cond (from)
4791 ((pr-region-active-p) (region-beginning))
4794 ((pr-region-active-p) (region-end))
4798 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4802 (defconst pr-menu-entry-alist
4805 (postscript-options . 9)
4806 (postscript-process . 3)
4810 "Alist that associates menu part with number of items per part.
4812 It's used by `pr-menu-index'.
4814 Each element has the form:
4816 (MENU-PART . NUMBER-OF-ITEMS)
4818 See `pr-visible-entry-alist'.")
4821 (defun pr-menu-index (entry index)
4823 (cond ((eq entry 'text)
4825 ((eq entry 'postscript-options)
4827 ((eq entry 'postscript-process)
4828 '(postscript text postscript-options))
4829 ((eq entry 'printing)
4830 '(postscript text postscript-options postscript-process))
4836 (setq key (car base-list)
4837 base-list (cdr base-list))
4838 (and (pr-visible-p key)
4839 (setq index (+ index
4840 (cdr (assq key pr-menu-entry-alist)))))))
4844 (defvar pr-menu-position nil)
4845 (defvar pr-menu-state nil)
4851 (defvar current-mouse-event nil) ; to avoid compilation gripes
4852 (defun pr-menu-position (entry index horizontal)
4856 'x (- (pr-x-event-x-pixel current-mouse-event) ; X
4857 (* horizontal pr-menu-char-width))
4858 'y (- (pr-x-event-y-pixel current-mouse-event) ; Y
4859 (* (pr-menu-index entry index) pr-menu-char-height)))))
4862 ;; GNU Emacs for Windows 9x/NT
4863 (defun pr-menu-position (entry index horizontal)
4864 (let ((pos (cdr (pr-e-mouse-pixel-position))))
4866 (list (or (car pos) 0) ; X
4867 (- (or (cdr pos) 0) ; Y
4868 (* (pr-menu-index entry index) pr-menu-char-height)))
4869 (selected-frame)))) ; frame
4873 (defun pr-menu-position (entry index horizontal)
4874 (let ((pos (cdr (pr-e-mouse-pixel-position))))
4876 (list (- (or (car pos) 0) ; X
4877 (* horizontal pr-menu-char-width))
4878 (- (or (cdr pos) 0) ; Y
4879 (* (pr-menu-index entry index) pr-menu-char-height)))
4880 (selected-frame)))) ; frame
4886 (defvar current-menubar nil) ; to avoid compilation gripes
4887 (defun pr-menu-lookup (path)
4888 (car (pr-x-find-menu-item current-menubar (cons "Printing" path))))
4891 (defun pr-menu-lock (entry index horizontal state path)
4893 (or (and pr-menu-position (eq state pr-menu-state))
4894 (setq pr-menu-position (pr-menu-position entry index horizontal)
4895 pr-menu-state state))
4896 (let* ((menu (pr-menu-lookup path))
4897 (result (pr-x-get-popup-menu-response menu pr-menu-position)))
4898 (and (pr-x-misc-user-event-p result)
4899 (funcall (pr-x-event-function result)
4900 (pr-x-event-object result))))
4901 (setq pr-menu-position nil))))
4906 (defun pr-menu-lookup (path)
4907 (lookup-key global-map
4909 (vconcat pr-menu-bar
4910 (mapcar 'pr-get-symbol
4917 (defun pr-menu-lock (entry index horizontal state path)
4919 (or (and pr-menu-position (eq state pr-menu-state))
4920 (setq pr-menu-position (pr-menu-position entry index horizontal)
4921 pr-menu-state state))
4922 (let* ((menu (pr-menu-lookup path))
4923 (result (x-popup-menu pr-menu-position menu)))
4925 (let ((command (lookup-key menu (vconcat result))))
4926 (if (fboundp command)
4929 (setq pr-menu-position nil)))))
4932 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4933 ;; Printer & Utility Selection
4936 (defun pr-update-var (var-sym alist)
4937 (or (assq (symbol-value var-sym) alist)
4938 (set var-sym (car (car alist)))))
4941 (defun pr-update-menus (&optional force)
4942 "Update utility, PostScript and text printer menus.
4944 If FORCE is non-nil, update menus doesn't matter if `pr-ps-printer-alist',
4945 `pr-txt-printer-alist' or `pr-ps-utility-alist' were modified or not;
4946 otherwise, update PostScript printer menu iff `pr-ps-printer-menu-modified' is
4947 non-nil, update text printer menu iff `pr-txt-printer-menu-modified' is
4948 non-nil, and update PostScript File menus iff `pr-ps-utility-menu-modified' is
4951 If menu binding was not done, calls `pr-menu-bind'."
4953 (if pr-menu-print-item ; since v6.8.4
4954 ;; There was no menu binding yet, so do it now!
4955 ;; This is a hack to be compatible with old versions of printing.
4956 ;; So, user does not need to change printing calling in init files.
4958 ;; Here menu binding is ok.
4959 (pr-update-var 'pr-ps-name pr-ps-printer-alist)
4960 (pr-update-var 'pr-txt-name pr-txt-printer-alist)
4961 (pr-update-var 'pr-ps-utility pr-ps-utility-alist)
4962 (pr-do-update-menus force)))
4965 (defvar pr-ps-printer-menu-modified t
4966 "Non-nil means `pr-ps-printer-alist' was modified and we need to update menu.")
4967 (defvar pr-txt-printer-menu-modified t
4968 "Non-nil means `pr-txt-printer-alist' was modified and we need to update menu.")
4969 (defvar pr-ps-utility-menu-modified t
4970 "Non-nil means `pr-ps-utility-alist' was modified and we need to update menu.")
4973 (defconst pr-even-or-odd-alist
4974 '((nil . "Print All Pages")
4975 (even-page . "Print Even Pages")
4976 (odd-page . "Print Odd Pages")
4977 (even-sheet . "Print Even Sheets")
4978 (odd-sheet . "Print Odd Sheets")))
4981 (defun pr-menu-create (name alist var-sym fun entry index)
4985 (let ((sym (car elt)))
4988 (list fun (list 'quote sym) nil (list 'quote entry) index)
4990 :selected (list 'eq var-sym (list 'quote sym)))))
4997 (defalias 'pr-update-mode-line 'set-menubar-dirty-flag)
5000 (defvar pr-ps-name-old "PostScript Printers")
5001 (defvar pr-txt-name-old "Text Printers")
5002 (defvar pr-ps-utility-old "PostScript Utility")
5003 (defvar pr-even-or-odd-old "Print All Pages")
5006 (defun pr-do-update-menus (&optional force)
5007 (pr-menu-alist pr-ps-printer-alist
5009 'pr-menu-set-ps-title
5011 'pr-ps-printer-menu-modified
5015 (pr-menu-alist pr-txt-printer-alist
5017 'pr-menu-set-txt-title
5019 'pr-txt-printer-menu-modified
5023 (let ((save-var pr-ps-utility-menu-modified))
5024 (pr-menu-alist pr-ps-utility-alist
5026 'pr-menu-set-utility-title
5027 '("Printing" "PostScript Print" "File")
5032 (pr-menu-alist pr-ps-utility-alist
5034 'pr-menu-set-utility-title
5035 '("Printing" "PostScript Preview" "File")
5036 'pr-ps-utility-menu-modified
5040 (pr-even-or-odd-pages ps-even-or-odd-pages force))
5043 (defun pr-menu-alist (alist var-sym fun menu-path modified-sym force name
5045 (when (and alist (or force (symbol-value modified-sym)))
5046 (pr-xemacs-global-menubar
5047 (pr-x-add-submenu menu-path
5048 (pr-menu-create name alist var-sym
5050 (funcall fun (symbol-value var-sym))
5051 (set modified-sym nil)))
5054 (defun pr-relabel-menu-item (newname var-sym)
5055 (pr-xemacs-global-menubar
5056 (pr-x-relabel-menu-item
5057 (list "Printing" (symbol-value var-sym))
5059 (set var-sym newname)))
5062 (defun pr-menu-set-ps-title (value &optional item entry index)
5063 (pr-relabel-menu-item (format "PostScript Printer: %s" value)
5065 (pr-ps-set-printer value)
5067 (pr-menu-lock entry index 12 'toggle nil)))
5070 (defun pr-menu-set-txt-title (value &optional item entry index)
5071 (pr-relabel-menu-item (format "Text Printer: %s" value)
5073 (pr-txt-set-printer value)
5075 (pr-menu-lock entry index 12 'toggle nil)))
5078 (defun pr-menu-set-utility-title (value &optional item entry index)
5079 (pr-xemacs-global-menubar
5080 (let ((newname (format "%s" value)))
5081 (pr-x-relabel-menu-item
5082 (list "Printing" "PostScript Print" "File" pr-ps-utility-old)
5084 (pr-x-relabel-menu-item
5085 (list "Printing" "PostScript Preview" "File" pr-ps-utility-old)
5087 (setq pr-ps-utility-old newname)))
5088 (pr-ps-set-utility value)
5090 (pr-menu-lock entry index 5 nil '("PostScript Print" "File"))))
5093 (defun pr-even-or-odd-pages (value &optional no-lock)
5094 (pr-relabel-menu-item (cdr (assq value pr-even-or-odd-alist))
5095 'pr-even-or-odd-old)
5096 (setq ps-even-or-odd-pages value)
5098 (pr-menu-lock 'postscript-options 8 12 'toggle nil))))
5103 (defalias 'pr-update-mode-line 'force-mode-line-update)
5106 (defun pr-do-update-menus (&optional force)
5107 (pr-menu-alist pr-ps-printer-alist
5109 'pr-menu-set-ps-title
5110 "PostScript Printers"
5111 'pr-ps-printer-menu-modified
5113 "PostScript Printers"
5115 (pr-menu-alist pr-txt-printer-alist
5117 'pr-menu-set-txt-title
5119 'pr-txt-printer-menu-modified
5123 (let ((save-var pr-ps-utility-menu-modified))
5124 (pr-menu-alist pr-ps-utility-alist
5126 'pr-menu-set-utility-title
5127 '("PostScript Print" "File" "PostScript Utility")
5130 "PostScript Utility"
5132 (pr-menu-alist pr-ps-utility-alist
5134 'pr-menu-set-utility-title
5135 '("PostScript Preview" "File" "PostScript Utility")
5136 'pr-ps-utility-menu-modified
5138 "PostScript Utility"
5140 (pr-even-or-odd-pages ps-even-or-odd-pages force))
5143 (defun pr-menu-get-item (name-list)
5144 ;; NAME-LIST is a string or a list of strings.
5145 (or (listp name-list)
5146 (setq name-list (list name-list)))
5148 (let* ((reversed (reverse name-list))
5149 (name (pr-get-symbol (car reversed)))
5150 (path (nreverse (cdr reversed)))
5153 (vconcat pr-menu-bar
5154 (mapcar 'pr-get-symbol path)))))
5155 (assq name (nthcdr 2 menu)))))
5158 (defvar pr-temp-menu nil)
5161 (defun pr-menu-alist (alist var-sym fun menu-path modified-sym force name
5163 (when (and alist (or force (symbol-value modified-sym)))
5164 (easy-menu-define pr-temp-menu nil ""
5165 (pr-menu-create name alist var-sym fun entry index))
5166 (let ((item (pr-menu-get-item menu-path)))
5168 (let* ((binding (nthcdr 3 item))
5169 (key-binding (cdr binding)))
5170 (setcar binding pr-temp-menu)
5171 (and key-binding (listp (car key-binding))
5172 (setcdr binding (cdr key-binding))) ; skip KEY-BINDING
5173 (funcall fun (symbol-value var-sym) item))))
5174 (set modified-sym nil)))
5177 (defun pr-menu-set-item-name (item name)
5179 (setcar (nthcdr 2 item) name))) ; ITEM-NAME
5182 (defun pr-menu-set-ps-title (value &optional item entry index)
5183 (pr-menu-set-item-name (or item
5184 (pr-menu-get-item "PostScript Printers"))
5185 (format "PostScript Printer: %s" value))
5186 (pr-ps-set-printer value)
5188 (pr-menu-lock entry index 12 'toggle nil)))
5191 (defun pr-menu-set-txt-title (value &optional item entry index)
5192 (pr-menu-set-item-name (or item
5193 (pr-menu-get-item "Text Printers"))
5194 (format "Text Printer: %s" value))
5195 (pr-txt-set-printer value)
5197 (pr-menu-lock entry index 12 'toggle nil)))
5200 (defun pr-menu-set-utility-title (value &optional item entry index)
5201 (let ((name (symbol-name value)))
5203 (pr-menu-set-item-name item name)
5204 (pr-menu-set-item-name
5206 '("PostScript Print" "File" "PostScript Utility"))
5208 (pr-menu-set-item-name
5210 '("PostScript Preview" "File" "PostScript Utility"))
5212 (pr-ps-set-utility value)
5214 (pr-menu-lock entry index 5 nil '("PostScript Print" "File"))))
5217 (defun pr-even-or-odd-pages (value &optional no-lock)
5218 (pr-menu-set-item-name (pr-menu-get-item "Print All Pages")
5219 (cdr (assq value pr-even-or-odd-alist)))
5220 (setq ps-even-or-odd-pages value)
5222 (pr-menu-lock 'postscript-options 8 12 'toggle nil)))))
5225 (defun pr-ps-set-utility (value)
5226 (let ((item (cdr (assq value pr-ps-utility-alist))))
5229 "Invalid PostScript utility name `%s' for variable `pr-ps-utility'"
5231 (setq pr-ps-utility value)
5232 (pr-eval-alist (nthcdr 9 item)))
5233 (pr-update-mode-line))
5236 (defun pr-ps-set-printer (value)
5237 (let ((ps (cdr (assq value pr-ps-printer-alist))))
5240 "Invalid PostScript printer name `%s' for variable `pr-ps-name'"
5242 (setq pr-ps-name value
5243 pr-ps-command (pr-dosify-file-name (nth 0 ps))
5244 pr-ps-switches (nth 1 ps)
5245 pr-ps-printer-switch (nth 2 ps)
5246 pr-ps-printer (nth 3 ps))
5247 (or (stringp pr-ps-command)
5249 (cond (ps-windows-system "print")
5253 (or (stringp pr-ps-printer-switch)
5254 (setq pr-ps-printer-switch
5255 (cond (ps-windows-system "/D:")
5259 (pr-eval-alist (nthcdr 4 ps)))
5260 (pr-update-mode-line))
5263 (defun pr-txt-set-printer (value)
5264 (let ((txt (cdr (assq value pr-txt-printer-alist))))
5266 (error "Invalid text printer name `%s' for variable `pr-txt-name'"
5268 (setq pr-txt-name value
5269 pr-txt-command (pr-dosify-file-name (nth 0 txt))
5270 pr-txt-switches (nth 1 txt)
5271 pr-txt-printer (nth 2 txt)))
5272 (or (stringp pr-txt-command)
5273 (setq pr-txt-command
5274 (cond (ps-windows-system "print")
5278 (pr-update-mode-line))
5281 (defun pr-eval-alist (alist)
5282 (mapcar #'(lambda (option)
5283 (let ((var-sym (car option))
5284 (value (cdr option)))
5285 (if (eq var-sym 'inherits-from:)
5286 (pr-eval-setting-alist value 'global)
5287 (set var-sym (eval value)))))
5291 (defun pr-eval-local-alist (alist)
5293 (mapcar #'(lambda (option)
5294 (let ((var-sym (car option))
5295 (value (cdr option)))
5297 (if (eq var-sym 'inherits-from:)
5298 (nconc (pr-eval-setting-alist value) local-list)
5299 (set (make-local-variable var-sym) (eval value))
5300 (cons var-sym local-list)))))
5305 (defun pr-eval-setting-alist (key &optional global old)
5306 (let ((setting (cdr (assq key pr-setting-database))))
5308 (let ((inherits (nth 0 setting))
5309 (local (nth 1 setting))
5310 (kill (nth 2 setting))
5315 (message "There are local buffer settings for `%S'." key)
5318 (if (memq inherits old)
5319 (error "Circular inheritance for `%S'" inherits)
5321 (pr-eval-setting-alist inherits global
5322 (cons inherits old)))))
5324 (cond ((not local) ; global settings
5326 (let ((var-sym (car option)))
5327 (or (eq var-sym 'inherits-from:)
5328 (set var-sym (eval (cdr option)))))))
5329 (kill ; local settings with killing
5331 (let ((var-sym (car option)))
5332 (unless (eq var-sym 'inherits-from:)
5333 (setq local-list (cons var-sym local-list))
5334 (set (make-local-variable var-sym)
5335 (eval (cdr option)))))))
5336 (t ; local settings without killing
5338 (let ((var-sym (car option)))
5339 (or (eq var-sym 'inherits-from:)
5340 (set (make-local-variable var-sym)
5341 (eval (cdr option))))))))
5346 (defun pr-kill-local-variable (local-var-list)
5347 (mapcar 'kill-local-variable local-var-list))
5350 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5351 ;; Internal Functions (II)
5354 (defun pr-toggle (var-sym mess entry index horizontal state
5355 &optional path no-menu)
5356 (set var-sym (not (symbol-value var-sym)))
5357 (message "%s is %s" mess (if (symbol-value var-sym) "on" "off"))
5359 (pr-menu-lock entry index horizontal state path)))
5362 (defun pr-toggle-file-duplex-menu (&optional no-menu)
5364 (pr-toggle 'pr-file-duplex "PS file duplex" nil 7 5 nil
5365 '("PostScript Print" "File") no-menu))
5368 (defun pr-toggle-file-tumble-menu (&optional no-menu)
5370 (pr-toggle 'pr-file-tumble "PS file tumble" nil 8 5 nil
5371 '("PostScript Print" "File") no-menu))
5374 (defun pr-toggle-file-landscape-menu (&optional no-menu)
5376 (pr-toggle 'pr-file-landscape "PS file landscape" nil 6 5 nil
5377 '("PostScript Print" "File") no-menu))
5380 (defun pr-toggle-ghostscript-menu (&optional no-menu)
5382 (pr-toggle 'pr-print-using-ghostscript "Printing using ghostscript"
5383 'postscript-process 2 12 'toggle nil no-menu))
5386 (defun pr-toggle-faces-menu (&optional no-menu)
5388 (pr-toggle 'pr-faces-p "Printing with faces"
5389 'postscript-process 1 12 'toggle nil no-menu))
5392 (defun pr-toggle-spool-menu (&optional no-menu)
5394 (pr-toggle 'pr-spool-p "Spooling printing"
5395 'postscript-process 0 12 'toggle nil no-menu))
5398 (defun pr-toggle-duplex-menu (&optional no-menu)
5400 (pr-toggle 'ps-spool-duplex "Printing duplex"
5401 'postscript-options 5 12 'toggle nil no-menu))
5404 (defun pr-toggle-tumble-menu (&optional no-menu)
5406 (pr-toggle 'ps-spool-tumble "Tumble"
5407 'postscript-options 6 12 'toggle nil no-menu))
5410 (defun pr-toggle-landscape-menu (&optional no-menu)
5412 (pr-toggle 'ps-landscape-mode "Landscape"
5413 'postscript-options 0 12 'toggle nil no-menu))
5416 (defun pr-toggle-upside-down-menu (&optional no-menu)
5418 (pr-toggle 'ps-print-upside-down "Upside-Down"
5419 'postscript-options 7 12 'toggle nil no-menu))
5422 (defun pr-toggle-line-menu (&optional no-menu)
5424 (pr-toggle 'ps-line-number "Line number"
5425 'postscript-options 3 12 'toggle nil no-menu))
5428 (defun pr-toggle-zebra-menu (&optional no-menu)
5430 (pr-toggle 'ps-zebra-stripes "Zebra stripe"
5431 'postscript-options 4 12 'toggle nil no-menu))
5434 (defun pr-toggle-header-menu (&optional no-menu)
5436 (pr-toggle 'ps-print-header "Print header"
5437 'postscript-options 1 12 'toggle nil no-menu))
5440 (defun pr-toggle-header-frame-menu (&optional no-menu)
5442 (pr-toggle 'ps-print-header-frame "Print header frame"
5443 'postscript-options 2 12 'toggle nil no-menu))
5446 (defun pr-toggle-lock-menu (&optional no-menu)
5448 (pr-toggle 'pr-menu-lock "Menu lock"
5449 'printing 2 12 'toggle nil no-menu))
5452 (defun pr-toggle-region-menu (&optional no-menu)
5454 (pr-toggle 'pr-auto-region "Auto region"
5455 'printing 0 12 'toggle nil no-menu))
5458 (defun pr-toggle-mode-menu (&optional no-menu)
5460 (pr-toggle 'pr-auto-mode "Auto mode"
5461 'printing 1 12 'toggle nil no-menu))
5464 (defun pr-prompt (str)
5465 (if (pr-auto-mode-p)
5466 (concat str " mode")
5467 (pr-region-active-string str)))
5470 (defun pr-prompt-region (str)
5471 (concat str (if (pr-auto-mode-p)
5476 (defun pr-prompt-gs (str)
5477 (if (pr-using-ghostscript-p)
5482 (defun pr-region-active-symbol (&optional region-p)
5483 (if (or region-p (pr-region-active-p))
5488 (defun pr-region-active-string (prefix)
5490 (if (pr-region-active-p)
5495 (defun pr-show-setup (settings buffer-name)
5496 (with-output-to-temp-buffer buffer-name
5498 (print-help-return-message)))
5501 (defun pr-complete-alist (prompt alist default)
5502 (let ((collection (mapcar #'(lambda (elt)
5503 (setq elt (car elt))
5504 (cons (symbol-name elt) elt))
5506 (cdr (assoc (completing-read (concat prompt ": ")
5508 (symbol-name default) nil
5509 (symbol-name default))
5513 (defun pr-delete-file (file)
5514 (and pr-delete-temp-file (file-exists-p file)
5515 (delete-file file)))
5518 (defun pr-expand-file-name (filename)
5519 (pr-dosify-file-name (expand-file-name filename)))
5522 (defun pr-ps-outfile-preprint (&optional mess)
5523 (let* ((prompt (format "%soutput PostScript file name: " (or mess "")))
5524 (res (read-file-name prompt default-directory "" nil)))
5525 (while (cond ((not (file-writable-p res))
5527 (setq prompt "is unwritable"))
5528 ((file-directory-p res)
5530 (setq prompt "is a directory"))
5531 ((file-exists-p res)
5533 (setq prompt "exists")
5534 (not (y-or-n-p (format "File `%s' exists; overwrite? "
5537 (setq res (read-file-name
5538 (format "File %s; PostScript file: " prompt)
5539 (file-name-directory res) nil nil
5540 (file-name-nondirectory res))))
5541 (pr-expand-file-name res)))
5544 (defun pr-ps-infile-preprint (&optional mess)
5545 (let* ((prompt (format "%sinput PostScript file name: " (or mess "")))
5546 (res (read-file-name prompt default-directory "" nil)))
5547 (while (cond ((not (file-exists-p res))
5549 (setq prompt "doesn't exist"))
5550 ((not (file-readable-p res))
5552 (setq prompt "is unreadable"))
5553 ((file-directory-p res)
5555 (setq prompt "is a directory"))
5557 (setq res (read-file-name
5558 (format "File %s; PostScript file: " prompt)
5559 (file-name-directory res) nil nil
5560 (file-name-nondirectory res))))
5561 (pr-expand-file-name res)))
5564 (defun pr-ps-utility-args (n-up-sym infile-sym outfile-sym prompt)
5565 ;; check arguments for PostScript file processing.
5567 (or (symbol-value n-up-sym)
5568 (set n-up-sym (pr-interactive-n-up prompt)))
5570 (and (eq (symbol-value infile-sym) t)
5571 (set infile-sym (pr-ps-infile-preprint prompt)))
5572 (or (symbol-value infile-sym)
5573 (error "%s: input PostScript file name is missing" prompt))
5574 (set infile-sym (pr-dosify-file-name (symbol-value infile-sym)))
5576 (and (eq (symbol-value outfile-sym) t)
5577 (set outfile-sym (and current-prefix-arg
5578 (pr-ps-outfile-preprint prompt))))
5579 (and (symbol-value outfile-sym)
5580 (set outfile-sym (pr-dosify-file-name (symbol-value outfile-sym))))
5581 (pr-ps-file (symbol-value outfile-sym)))
5584 (defun pr-ps-utility-process (n-up infile outfile)
5585 ;; activate utility to process a PostScript file.
5587 (and (stringp infile) (file-exists-p infile)
5588 (setq item (cdr (assq pr-ps-utility pr-ps-utility-alist)))
5589 (pr-call-process (nth 0 item)
5590 (pr-switches-string (nth 1 item)
5591 "pr-ps-utility-alist entry")
5592 (pr-switches-string (nth 8 item)
5593 "pr-ps-utility-alist entry")
5595 (format (nth 2 item) ps-paper-type))
5596 (format (nth 3 item) n-up)
5597 (and pr-file-landscape (nth 4 item))
5598 (and pr-file-duplex (nth 5 item))
5599 (and pr-file-tumble (nth 6 item))
5600 (pr-expand-file-name infile)
5602 (pr-expand-file-name outfile)))))
5605 (defun pr-remove-nil-from-list (lst)
5606 (while (and lst (null (car lst)))
5607 (setq lst (cdr lst)))
5619 (defun pr-call-process (command &rest args)
5620 (let ((buffer (get-buffer-create "*Printing Command Output*"))
5621 (cmd (pr-command command))
5623 (setq args (pr-remove-nil-from-list args))
5624 ;; *Printing Command Output* == show command & args
5627 (goto-char (point-max))
5628 (insert (format "%s %S\n" cmd args)))
5629 ;; *Printing Command Output* == show any return message from command
5632 (condition-case data
5633 (apply 'call-process cmd nil buffer nil args)
5635 (error-message-string data)))))
5636 ;; *Printing Command Output* == show exit status
5639 (goto-char (point-max))
5640 (insert (format "Exit status: %s\n\n" status)))
5641 ;; message if error status
5642 (if (or (stringp status)
5643 (and (integerp status) (/= status 0)))
5645 "Printing error status: %s (see *Printing Command Output* buffer)"
5649 (defun pr-txt-print (from to)
5650 (let ((lpr-command (pr-standard-file-name (pr-command pr-txt-command)))
5651 (lpr-switches (pr-switches pr-txt-switches "pr-txt-switches"))
5652 (printer-name pr-txt-printer))
5653 (lpr-region from to)))
5656 (defun pr-switches-string (switches mess)
5657 ;; If SWITCHES is nil, return nil.
5658 ;; Otherwise, return the list of string in a string.
5660 (mapconcat 'identity (pr-switches switches mess) " ")))
5663 (defun pr-switches (switches mess)
5664 (or (listp switches)
5665 (error "%S should have a list of strings" mess))
5666 (ps-flatten-list ; dynamic evaluation
5667 (mapcar 'ps-eval-switch switches)))
5670 (defun pr-ps-preview (kind n-up filename mess)
5671 (pr-set-n-up-and-filename 'n-up 'filename mess)
5672 (let ((file (pr-ps-file filename)))
5673 (pr-text2ps kind n-up file)
5674 (or pr-spool-p (pr-ps-file-preview file))))
5677 (defun pr-ps-using-ghostscript (kind n-up filename mess)
5678 (pr-set-n-up-and-filename 'n-up 'filename mess)
5679 (let ((file (pr-ps-file filename)))
5680 (pr-text2ps kind n-up file)
5681 (unless (or pr-spool-p filename)
5682 (pr-ps-file-using-ghostscript file)
5683 (pr-delete-file file))))
5686 (defun pr-ps-print (kind n-up filename mess)
5687 (pr-set-n-up-and-filename 'n-up 'filename mess)
5688 (let ((file (pr-ps-file filename)))
5689 (pr-text2ps kind n-up file)
5690 (unless (or pr-spool-p filename)
5691 (pr-ps-file-print file)
5692 (pr-delete-file file))))
5695 (defun pr-ps-file (&optional filename)
5696 (pr-dosify-file-name (or filename
5698 (convert-standard-filename
5699 (expand-file-name pr-ps-temp-file pr-temp-dir))
5703 (defun pr-interactive-n-up (mess)
5704 (or (stringp mess) (setq mess "*"))
5706 (let* ((fmt-prompt "%s[%s] N-up printing (default 1): ")
5708 (str (pr-f-read-string (format fmt-prompt prompt mess) "1" nil "1"))
5710 (while (if (string-match "^\\s *[0-9]+$" str)
5711 (setq int (string-to-number str)
5712 prompt (cond ((< int 1) "Integer below 1; ")
5713 ((> int 100) "Integer above 100; ")
5715 (setq prompt "Invalid integer syntax; "))
5718 (pr-f-read-string (format fmt-prompt prompt mess) str nil "1")))
5722 (defun pr-interactive-dir (mess)
5723 (let* ((dir-name (file-name-directory (or (buffer-file-name)
5724 default-directory)))
5725 (fmt-prompt (concat "%s[" mess "] Directory to print: "))
5726 (dir (read-file-name (format fmt-prompt "")
5727 "" dir-name nil dir-name))
5729 (while (cond ((not (file-directory-p dir))
5731 (setq prompt "It's not a directory! "))
5732 ((not (file-readable-p dir))
5734 (setq prompt "Directory is unreadable! "))
5736 (setq dir-name (file-name-directory dir)
5737 dir (read-file-name (format fmt-prompt prompt)
5738 "" dir-name nil dir-name)))
5739 (file-name-as-directory dir)))
5742 (defun pr-interactive-regexp (mess)
5743 (pr-f-read-string (format "[%s] File regexp to print: " mess) "" nil ""))
5746 (defun pr-interactive-dir-args (mess)
5748 ;; get directory argument
5749 (pr-interactive-dir mess)
5750 ;; get file name regexp
5751 (pr-interactive-regexp mess)))
5754 (defun pr-interactive-ps-dir-args (mess)
5756 ;; get n-up argument
5757 (pr-interactive-n-up mess)
5758 ;; get directory argument
5759 (pr-interactive-dir mess)
5760 ;; get file name regexp
5761 (pr-interactive-regexp mess)
5762 ;; get output file name
5763 (and (not pr-spool-p)
5764 (ps-print-preprint current-prefix-arg))))
5767 (defun pr-interactive-n-up-file (mess)
5769 ;; get n-up argument
5770 (pr-interactive-n-up mess)
5771 ;; get output file name
5772 (and (not pr-spool-p)
5773 (ps-print-preprint current-prefix-arg))))
5776 (defun pr-interactive-n-up-inout (mess)
5778 ;; get n-up argument
5779 (pr-interactive-n-up mess)
5780 ;; get input file name
5781 (pr-ps-infile-preprint (concat mess " "))
5782 ;; get output file name
5783 (ps-print-preprint current-prefix-arg)))
5786 (defun pr-set-outfilename (filename-sym)
5787 (and (not pr-spool-p)
5788 (eq (symbol-value filename-sym) t)
5789 (set filename-sym (and current-prefix-arg
5790 (ps-print-preprint current-prefix-arg))))
5791 (and (symbol-value filename-sym)
5792 (set filename-sym (pr-dosify-file-name (symbol-value filename-sym)))))
5795 (defun pr-set-n-up-and-filename (n-up-sym filename-sym mess)
5797 (or (symbol-value n-up-sym)
5798 (set n-up-sym (pr-interactive-n-up mess)))
5800 (pr-set-outfilename filename-sym))
5803 (defun pr-set-dir-args (dir-sym regexp-sym mess)
5805 (or (symbol-value dir-sym)
5806 (set dir-sym (pr-interactive-dir mess)))
5808 (or (symbol-value regexp-sym)
5809 (set regexp-sym (pr-interactive-regexp mess))))
5812 (defun pr-set-ps-dir-args (n-up-sym dir-sym regexp-sym filename-sym mess)
5814 (or (symbol-value n-up-sym)
5815 (set n-up-sym (pr-interactive-n-up mess)))
5816 ;; directory & file name regexp
5817 (pr-set-dir-args dir-sym regexp-sym mess)
5819 (pr-set-outfilename filename-sym))
5822 (defun pr-find-buffer-visiting (file)
5823 (if (not (file-directory-p file))
5824 (find-buffer-visiting (if ps-windows-system
5827 (let ((truename (file-truename file))
5828 (blist (buffer-list))
5830 (while (and (not found) blist)
5832 (set-buffer (car blist))
5833 (and (eq major-mode 'dired-mode)
5835 (goto-char (point-min))
5836 (string= (buffer-substring-no-properties
5842 (setq found (car blist))))
5843 (setq blist (cdr blist)))
5847 (defun pr-file-list (dir file-regexp fun)
5848 (mapcar #'(lambda (file)
5849 (and (or pr-list-directory
5850 (not (file-directory-p file)))
5851 (let ((buffer (pr-find-buffer-visiting file))
5855 (file-readable-p file))
5857 (set-buffer (or buffer
5858 (find-file-noselect file)))
5861 (kill-buffer (current-buffer))))))))
5862 (directory-files dir t file-regexp)))
5865 (defun pr-delete-file-if-exists (filename)
5866 (and (not pr-spool-p) (stringp filename) (file-exists-p filename)
5867 (delete-file filename)))
5870 (defun pr-ps-file-list (n-up dir file-regexp filename)
5871 (pr-delete-file-if-exists (setq filename (pr-expand-file-name filename)))
5872 (let ((pr-spool-p t))
5873 (pr-file-list dir file-regexp
5875 (if (pr-auto-mode-p)
5876 (pr-ps-mode n-up filename)
5877 (pr-text2ps 'buffer n-up filename)))))
5879 (pr-despool-print filename)))
5882 (defun pr-text2ps (kind n-up filename &optional from to)
5884 (let ((ps-n-up-printing n-up)
5885 (ps-spool-config (and (eq ps-spool-config 'setpagedevice)
5887 (pr-delete-file-if-exists filename)
5890 ;; pr-faces-p and pr-spool-p
5891 ;; here FILENAME arg is ignored
5892 (cond ((eq kind 'buffer)
5893 (ps-spool-buffer-with-faces))
5895 (ps-spool-region-with-faces (or from (point))
5898 ;; pr-faces-p and not pr-spool-p
5900 (ps-print-buffer-with-faces filename))
5902 (ps-print-region-with-faces (or from (point))
5903 (or to (mark)) filename))
5906 ;; not pr-faces-p and pr-spool-p
5907 ;; here FILENAME arg is ignored
5908 (cond ((eq kind 'buffer)
5911 (ps-spool-region (or from (point)) (or to (mark))))
5913 ;; not pr-faces-p and not pr-spool-p
5915 (ps-print-buffer filename))
5917 (ps-print-region (or from (point)) (or to (mark)) filename))
5921 (defun pr-command (command)
5922 "Return absolute file name specification for COMMAND.
5924 If COMMAND is an empty string, return it.
5926 If COMMAND is already an absolute file name specification, return it.
5927 Else it uses `pr-path-alist' to find COMMAND, if find it then return it;
5928 otherwise, gives an error.
5930 When using `pr-path-alist' to find COMMAND, the entries `cygwin', `windows' and
5931 `unix' are used (see `pr-path-alist' for documentation).
5933 If Emacs is running on Windows 95/98/NT/2000, tries to find COMMAND,
5934 COMMAND.exe, COMMAND.bat and COMMAND.com in this order."
5935 (if (string= command "")
5937 (pr-dosify-file-name
5938 (or (pr-find-command command)
5939 (pr-path-command (cond (pr-cygwin-system 'cygwin)
5940 (ps-windows-system 'windows)
5942 (file-name-nondirectory command)
5944 (error "Command not found: %s"
5945 (file-name-nondirectory command))))))
5948 (defun pr-path-command (symbol command sym-list)
5949 (let ((lpath (cdr (assq symbol pr-path-alist)))
5952 (and (eq symbol 'PATH) (null lpath)
5953 (setq lpath (parse-colon-path (getenv "PATH"))))
5957 (let ((path (car lpath)))
5961 (and (not (memq path sym-list))
5962 (pr-path-command path command
5963 (cons path sym-list))))
5968 (substitute-in-file-name
5969 (concat (file-name-as-directory path)
5972 (setq lpath (cdr lpath)))
5976 (defun pr-find-command (cmd)
5977 (if ps-windows-system
5979 (let ((ext (cons (file-name-extension cmd t)
5980 (list ".exe" ".bat" ".com")))
5982 (setq cmd (file-name-sans-extension cmd))
5984 (setq found (concat cmd (car ext)))
5985 (not (and (file-regular-p found)
5986 (file-executable-p found))))
5990 ;; non-windows systems
5991 (and (file-regular-p cmd)
5992 (file-executable-p cmd)
5996 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5997 ;; Printing Interface (inspired on ps-print-interface.el)
6005 (defvar pr-i-window-configuration nil)
6007 (defvar pr-i-buffer nil)
6008 (defvar pr-i-region nil)
6009 (defvar pr-i-mode nil)
6010 (defvar pr-i-despool nil)
6011 (defvar pr-i-ps-as-is t)
6012 (defvar pr-i-n-up 1)
6013 (defvar pr-i-directory "./")
6014 (defvar pr-i-regexp "")
6015 (defvar pr-i-ps-file "")
6016 (defvar pr-i-out-file "")
6017 (defvar pr-i-answer-yes nil)
6018 (defvar pr-i-process 'buffer)
6019 (defvar pr-i-ps-send 'printer)
6022 (defvar pr-interface-map nil
6023 "Keymap for pr-interface.")
6025 (unless pr-interface-map
6026 (setq pr-interface-map (make-sparse-keymap))
6027 (cond ((featurep 'xemacs) ; XEmacs
6028 (pr-f-set-keymap-parents pr-interface-map (list widget-keymap))
6029 (pr-f-set-keymap-name pr-interface-map 'pr-interface-map))
6031 (pr-f-set-keymap-parents pr-interface-map widget-keymap)))
6032 (define-key pr-interface-map "q" 'pr-interface-quit)
6033 (define-key pr-interface-map "?" 'pr-interface-help))
6036 (defmacro pr-interface-save (&rest body)
6038 (set-buffer pr-i-buffer)
6042 (defun pr-create-interface ()
6043 "Create the front end for printing package."
6044 (setq pr-i-buffer (buffer-name (current-buffer))
6045 pr-i-region (ps-mark-active-p)
6046 pr-i-mode (pr-mode-alist-p)
6047 pr-i-window-configuration (current-window-configuration))
6049 (put 'pr-i-process 'pr-widget-list nil)
6050 (put 'pr-i-ps-send 'pr-widget-list nil)
6052 (delete-other-windows)
6053 (kill-buffer (get-buffer-create pr-buffer-name))
6054 (switch-to-buffer (get-buffer-create pr-buffer-name))
6057 (let ((versions (concat "printing v" pr-version
6058 " ps-print v" ps-print-version)))
6059 (widget-insert (make-string (- 79 (length versions)) ?\s) versions))
6060 (pr-insert-italic "\nCurrent Directory : " 1)
6061 (pr-insert-italic default-directory)
6063 (pr-insert-section-1) ; 1. Print
6064 (pr-insert-section-2) ; 2. PostScript Printer
6065 (pr-insert-section-3) ; 3. Text Printer
6068 (widget-insert "\n\n " (make-string 77 ?-))
6070 (pr-insert-section-4) ; 4. Settings
6071 (pr-insert-section-5) ; 5. Customize
6072 (pr-insert-section-6) ; 6. Show Settings
6073 (pr-insert-section-7) ; 7. Help
6075 (use-local-map pr-interface-map)
6077 (goto-char (point-min))
6079 (and pr-i-region ; let region activated
6080 (pr-keep-region-active)))
6083 (defun pr-insert-section-1 ()
6085 (pr-insert-italic "\nPrint :" 1)
6088 ;; 1a. Buffer: Buffer List
6089 (pr-insert-radio-button 'pr-i-process 'buffer)
6090 (pr-insert-menu "Buffer List" 'pr-i-buffer
6091 (let ((blist (buffer-list))
6092 case-fold-search choices)
6094 (let ((name (buffer-name (car blist)))
6095 (ignore pr-buffer-name-ignore)
6097 (setq blist (cdr blist))
6098 (while (and ignore (not found))
6099 (setq found (string-match (car ignore) name)
6100 ignore (cdr ignore)))
6112 (setq pr-i-region (ps-mark-active-p)
6113 pr-i-mode (pr-mode-alist-p)))
6114 (pr-update-checkbox 'pr-i-region)
6115 (pr-update-checkbox 'pr-i-mode)))
6116 ;; 1a. Buffer: Region
6117 (put 'pr-i-region 'pr-widget
6121 #'(lambda (widget &rest ignore)
6122 (let ((region-p (pr-interface-save
6123 (ps-mark-active-p))))
6124 (cond ((null (widget-value widget)) ; widget is nil
6125 (setq pr-i-region nil))
6126 (region-p ; widget is true and there is a region
6127 (setq pr-i-region t)
6128 (widget-value-set widget t)
6129 (widget-setup)) ; MUST be called after widget-value-set
6130 (t ; widget is true and there is no region
6132 (message "There is no region active")
6133 (setq pr-i-region nil)
6134 (widget-value-set widget nil)
6135 (widget-setup))))) ; MUST be called after widget-value-set
6138 (put 'pr-i-mode 'pr-widget
6142 #'(lambda (widget &rest ignore)
6143 (let ((mode-p (pr-interface-save
6144 (pr-mode-alist-p))))
6146 ((null (widget-value widget)) ; widget is nil
6147 (setq pr-i-mode nil))
6148 (mode-p ; widget is true and there is a `mode'
6150 (widget-value-set widget t)
6151 (widget-setup)) ; MUST be called after widget-value-set
6152 (t ; widget is true and there is no `mode'
6155 "This buffer isn't in a mode that printing treats specially.")
6156 (setq pr-i-mode nil)
6157 (widget-value-set widget nil)
6158 (widget-setup))))) ; MUST be called after widget-value-set
6162 (pr-insert-radio-button 'pr-i-process 'directory)
6166 :format " Directory : %v"
6167 :notify 'pr-interface-directory
6168 :action (lambda (widget &optional event)
6169 (if (pr-interface-directory widget)
6170 (pr-widget-field-action widget event)
6172 (message "Please specify a readable directory")))
6174 ;; 1b. Directory: File Regexp
6175 (widget-create 'regexp
6177 :format "\n File Regexp : %v\n"
6178 :notify (lambda (widget &rest ignore)
6179 (setq pr-i-regexp (widget-value widget)))
6181 ;; 1b. Directory: List Directory Entry
6183 (pr-insert-toggle 'pr-list-directory " List Directory Entry\n")
6185 ;; 1c. PostScript File:
6186 (pr-insert-radio-button 'pr-i-process 'file)
6190 :format " PostScript File : %v"
6191 :notify 'pr-interface-infile
6192 :action (lambda (widget &rest event)
6193 (if (pr-interface-infile widget)
6194 (pr-widget-field-action widget event)
6196 (message "Please specify a readable PostScript file")))
6198 ;; 1c. PostScript File: PostScript Utility
6199 (pr-insert-menu "PostScript Utility" 'pr-ps-utility
6200 (pr-choice-alist pr-ps-utility-alist)
6201 "\n PostScript Utility : "
6203 ;; 1c. PostScript File: No Preprocessing
6204 (pr-insert-toggle 'pr-i-ps-as-is " No Preprocessing"))
6207 (defun pr-insert-section-2 ()
6208 ;; 2. PostScript Printer:
6209 ;; 2. PostScript Printer: PostScript Printer List
6210 (pr-insert-italic "\n\nPostScript Printer : " 2 20)
6211 (pr-insert-menu "PostScript Printer" 'pr-ps-name
6212 (pr-choice-alist pr-ps-printer-alist))
6213 ;; 2. PostScript Printer: Despool
6214 (put 'pr-i-despool 'pr-widget
6218 #'(lambda (widget &rest ignore)
6220 (setq pr-i-despool (not pr-i-despool))
6222 (message "Can despool only when spooling is actually selected")
6223 (setq pr-i-despool nil))
6224 (widget-value-set widget pr-i-despool)
6225 (widget-setup)) ; MUST be called after widget-value-set
6227 ;; 2. PostScript Printer: Preview Print Quit
6228 (pr-insert-button 'pr-interface-preview "Preview" " ")
6229 (pr-insert-button 'pr-interface-ps-print "Print" " ")
6230 (pr-insert-button 'pr-interface-quit "Quit")
6231 ;; 2. PostScript Printer: Send to Printer/Temporary File
6232 (pr-insert-radio-button 'pr-i-ps-send 'printer)
6233 (widget-insert " Send to Printer/Temporary File")
6234 ;; 2. PostScript Printer: Send to File
6235 (pr-insert-radio-button 'pr-i-ps-send 'file)
6239 :format " Send to File : %v"
6240 :notify 'pr-interface-outfile
6241 :action (lambda (widget &rest event)
6242 (if (and (pr-interface-outfile widget)
6243 (or (not (file-exists-p pr-i-out-file))
6244 (setq pr-i-answer-yes
6245 (y-or-n-p "File exists; overwrite? "))))
6246 (pr-widget-field-action widget event)
6248 (message "Please specify a writable PostScript file")))
6250 ;; 2. PostScript Printer: N-Up
6254 :format "\n N-Up : %v"
6255 :notify (lambda (widget &rest ignore)
6256 (let ((value (if (string= (widget-apply widget :value-get) "")
6258 (widget-value widget))))
6259 (if (and (integerp value)
6260 (<= 1 value) (<= value 100))
6263 (setq pr-i-n-up value))
6265 (message "Please specify an integer between 1 and 100"))))
6269 (defun pr-insert-section-3 ()
6271 (pr-insert-italic "\n\nText Printer : " 2 14)
6272 (pr-insert-menu "Text Printer" 'pr-txt-name
6273 (pr-choice-alist pr-txt-printer-alist)
6275 (pr-insert-button 'pr-interface-printify "Printify" " ")
6276 (pr-insert-button 'pr-interface-txt-print "Print" " ")
6277 (pr-insert-button 'pr-interface-quit "Quit"))
6280 (defun pr-insert-section-4 ()
6282 ;; 4. Settings: Landscape Auto Region Verbose
6283 (pr-insert-checkbox "\n\n " 'ps-landscape-mode
6284 #'(lambda (&rest ignore)
6285 (setq ps-landscape-mode (not ps-landscape-mode)
6286 pr-file-landscape ps-landscape-mode))
6288 (pr-insert-toggle 'pr-auto-region " Auto Region ")
6289 (pr-insert-toggle 'pr-buffer-verbose " Verbose\n ")
6291 ;; 4. Settings: Print Header Auto Mode
6292 (pr-insert-toggle 'ps-print-header " Print Header ")
6293 (pr-insert-toggle 'pr-auto-mode " Auto Mode\n ")
6295 ;; 4. Settings: Print Header Frame Menu Lock
6296 (pr-insert-toggle 'ps-print-header-frame " Print Header Frame ")
6297 (pr-insert-toggle 'pr-menu-lock " Menu Lock\n ")
6299 ;; 4. Settings: Line Number
6300 (pr-insert-toggle 'ps-line-number " Line Number\n ")
6302 ;; 4. Settings: Zebra Stripes Spool Buffer
6303 (pr-insert-toggle 'ps-zebra-stripes " Zebra Stripes")
6304 (pr-insert-checkbox " "
6306 #'(lambda (&rest ignore)
6307 (setq pr-spool-p (not pr-spool-p))
6309 (setq pr-i-despool nil)
6310 (pr-update-checkbox 'pr-i-despool)))
6313 ;; 4. Settings: Duplex Print with faces
6314 (pr-insert-checkbox "\n "
6316 #'(lambda (&rest ignore)
6317 (setq ps-spool-duplex (not ps-spool-duplex)
6318 pr-file-duplex ps-spool-duplex))
6320 (pr-insert-toggle 'pr-faces-p " Print with faces")
6322 ;; 4. Settings: Tumble Print via Ghostscript
6323 (pr-insert-checkbox "\n "
6325 #'(lambda (&rest ignore)
6326 (setq ps-spool-tumble (not ps-spool-tumble)
6327 pr-file-tumble ps-spool-tumble))
6329 (pr-insert-toggle 'pr-print-using-ghostscript " Print via Ghostscript\n ")
6331 ;; 4. Settings: Upside-Down Page Parity
6332 (pr-insert-toggle 'ps-print-upside-down " Upside-Down")
6333 (pr-insert-italic "\n\nSelect Pages : " 2 14)
6334 (pr-insert-menu "Page Parity" 'ps-even-or-odd-pages
6335 (mapcar #'(lambda (alist)
6340 :value (car alist))))
6341 pr-even-or-odd-alist)))
6344 (defun pr-insert-section-5 ()
6346 (pr-insert-italic "\n\nCustomize : " 2 11)
6347 (pr-insert-button 'pr-customize "printing" " ")
6348 (pr-insert-button #'(lambda (&rest ignore) (ps-print-customize))
6350 (pr-insert-button 'lpr-customize "lpr"))
6353 (defun pr-insert-section-6 ()
6354 ;; 6. Show Settings:
6355 (pr-insert-italic "\nShow Settings : " 1 14)
6356 (pr-insert-button 'pr-show-pr-setup "printing" " ")
6357 (pr-insert-button 'pr-show-ps-setup "ps-print" " ")
6358 (pr-insert-button 'pr-show-lpr-setup "lpr"))
6361 (defun pr-insert-section-7 ()
6363 (pr-insert-italic "\nHelp : " 1 5)
6364 (pr-insert-button 'pr-interface-help "Interface Help" " ")
6365 (pr-insert-button 'pr-help "Menu Help" " ")
6366 (pr-insert-button 'pr-interface-quit "Quit" "\n ")
6367 (pr-insert-button 'pr-kill-help "Kill All Printing Help Buffer"))
6370 (defun pr-kill-help (&rest ignore)
6371 "Kill all printing help buffer."
6373 (let ((help '("*Printing Interface Help*" "*Printing Help*"
6374 "*LPR Setup*" "*PR Setup*" "*PS Setup*")))
6376 (let ((buffer (get-buffer (car help))))
6377 (setq help (cdr help))
6379 (delete-windows-on buffer)
6380 (kill-buffer buffer)))))
6381 (recenter (- (window-height) 2)))
6384 (defun pr-interface-quit (&rest ignore)
6385 "Kill the printing buffer interface and quit."
6387 (kill-buffer pr-buffer-name)
6388 (set-window-configuration pr-i-window-configuration))
6391 (defun pr-interface-help (&rest ignore)
6392 "printing buffer interface help."
6394 (pr-show-setup pr-interface-help-message "*Printing Interface Help*"))
6397 (defun pr-interface-txt-print (&rest ignore)
6398 "Print using lpr package."
6400 (condition-case data
6402 ((eq pr-i-process 'directory)
6405 (pr-txt-directory pr-i-directory pr-i-regexp)))
6406 ((eq pr-i-process 'buffer)
6409 (let ((pr-auto-mode pr-i-mode))
6412 (let (pr-auto-region)
6415 (let (pr-auto-mode pr-auto-region)
6418 ((eq pr-i-process 'file)
6419 (error "Please specify a text file"))
6421 (error "Internal error: `pr-i-process' = %S" pr-i-process))
6426 (message "%s" (error-message-string data)))))
6429 (defun pr-interface-printify (&rest ignore)
6430 "Printify a buffer."
6432 (condition-case data
6434 ((eq pr-i-process 'directory)
6437 (pr-printify-directory pr-i-directory pr-i-regexp)))
6438 ((eq pr-i-process 'buffer)
6441 (pr-printify-region)
6442 (pr-printify-buffer))))
6443 ((eq pr-i-process 'file)
6444 (error "Cannot printify a PostScript file"))
6446 (error "Internal error: `pr-i-process' = %S" pr-i-process))
6451 (message "%s" (error-message-string data)))))
6454 (defun pr-interface-ps-print (&rest ignore)
6455 "Print using ps-print package."
6457 (pr-interface-ps 'pr-despool-ps-print 'pr-ps-directory-ps-print
6458 'pr-ps-file-ps-print 'pr-ps-file-up-ps-print
6459 'pr-ps-region-ps-print 'pr-ps-mode-ps-print
6460 'pr-ps-buffer-ps-print))
6463 (defun pr-interface-preview (&rest ignore)
6464 "Preview a PostScript file."
6466 (pr-interface-ps 'pr-despool-preview 'pr-ps-directory-preview
6467 'pr-ps-file-preview 'pr-ps-file-up-preview
6468 'pr-ps-region-preview 'pr-ps-mode-preview
6469 'pr-ps-buffer-preview))
6472 (defun pr-interface-ps (ps-despool ps-directory ps-file ps-file-up ps-region
6474 (condition-case data
6475 (let ((outfile (or (and (eq pr-i-process 'file) pr-i-ps-as-is)
6478 ((and pr-i-despool pr-spool-p)
6480 (funcall ps-despool outfile))
6481 (setq pr-i-despool nil)
6482 (pr-update-checkbox 'pr-i-despool))
6483 ((eq pr-i-process 'directory)
6486 (funcall ps-directory
6487 pr-i-n-up pr-i-directory pr-i-regexp outfile)))
6488 ((eq pr-i-process 'file)
6489 (cond ((or (file-directory-p pr-i-ps-file)
6490 (not (file-readable-p pr-i-ps-file)))
6491 (error "Please specify a readable PostScript file"))
6494 (funcall ps-file pr-i-ps-file)))
6497 (funcall ps-file-up pr-i-n-up pr-i-ps-file outfile)))
6499 ((eq pr-i-process 'buffer)
6502 (let ((pr-auto-mode pr-i-mode))
6503 (funcall ps-region pr-i-n-up outfile)))
6505 (let (pr-auto-region)
6506 (funcall ps-mode pr-i-n-up outfile)))
6508 (let (pr-auto-mode pr-auto-region)
6509 (funcall ps-buffer pr-i-n-up outfile)))
6512 (error "Internal error: `pr-i-process' = %S" pr-i-process))
6517 (message "%s" (error-message-string data)))))
6520 (defun pr-i-ps-send ()
6521 (cond ((eq pr-i-ps-send 'printer)
6523 ((not (eq pr-i-ps-send 'file))
6524 (error "Internal error: `pr-i-ps-send' = %S" pr-i-ps-send))
6525 ((or (file-directory-p pr-i-out-file)
6526 (not (file-writable-p pr-i-out-file)))
6527 (error "Please specify a writable PostScript file"))
6528 ((or (not (file-exists-p pr-i-out-file))
6530 (setq pr-i-answer-yes
6531 (y-or-n-p (format "File `%s' exists; overwrite? "
6535 (error "File already exists"))))
6538 (defun pr-i-directory ()
6539 (or (and (file-directory-p pr-i-directory)
6540 (file-readable-p pr-i-directory))
6541 (error "Please specify be a readable directory")))
6544 (defun pr-interface-directory (widget &rest ignore)
6545 (and pr-buffer-verbose
6546 (message "You can use M-TAB or ESC TAB for file completion"))
6547 (let ((dir (widget-value widget)))
6548 (and (file-directory-p dir)
6549 (file-readable-p dir)
6550 (setq pr-i-directory dir))))
6553 (defun pr-interface-infile (widget &rest ignore)
6554 (and pr-buffer-verbose
6555 (message "You can use M-TAB or ESC TAB for file completion"))
6556 (let ((file (widget-value widget)))
6557 (and (not (file-directory-p file))
6558 (file-readable-p file)
6559 (setq pr-i-ps-file file))))
6562 (defun pr-interface-outfile (widget &rest ignore)
6563 (setq pr-i-answer-yes nil)
6564 (and pr-buffer-verbose
6565 (message "You can use M-TAB or ESC TAB for file completion"))
6566 (let ((file (widget-value widget)))
6567 (and (not (file-directory-p file))
6568 (file-writable-p file)
6569 (setq pr-i-out-file file))))
6572 (defun pr-widget-field-action (widget event)
6573 (and (get-buffer "*Completions*") ; clean frame window
6574 (delete-windows-on "*Completions*"))
6575 (message " ") ; clean echo area
6576 (widget-field-action widget event))
6579 (defun pr-insert-italic (str &optional from to)
6580 (let ((len (length str)))
6581 (put-text-property (if from (max from 0) 0)
6582 (if to (max to len) len)
6584 (widget-insert str)))
6587 (defun pr-insert-checkbox (before var-sym fun label)
6588 (widget-insert before)
6590 (widget-create 'checkbox
6592 (symbol-value var-sym))
6593 (widget-insert label)))
6596 (defun pr-insert-toggle (var-sym label)
6597 (widget-create 'checkbox
6598 :notify `(lambda (&rest ignore)
6599 (setq ,var-sym (not ,var-sym)))
6600 (symbol-value var-sym))
6601 (widget-insert label))
6604 (defun pr-insert-button (fun label &optional separator)
6605 (widget-create 'push-button
6609 (widget-insert separator)))
6612 (defun pr-insert-menu (tag var-sym choices &optional before after &rest body)
6613 (and before (widget-insert before))
6614 (eval `(widget-create 'menu-choice
6619 :notify (lambda (widget &rest ignore)
6620 (setq ,var-sym (widget-value widget))
6622 :void '(choice-item :format "%[%t%]"
6623 :tag "Can not display value!")
6625 (and after (widget-insert after)))
6628 (defun pr-insert-radio-button (var-sym sym)
6629 (widget-insert "\n")
6630 (let ((wid-list (get var-sym 'pr-widget-list))
6631 (wid (eval `(widget-create
6634 :value (eq ,var-sym (quote ,sym))
6635 :notify (lambda (&rest ignore)
6636 (setq ,var-sym (quote ,sym))
6637 (pr-update-radio-button (quote ,var-sym)))))))
6638 (put var-sym 'pr-widget-list (cons (cons wid sym) wid-list))))
6641 (defun pr-update-radio-button (var-sym)
6642 (let ((wid-list (get var-sym 'pr-widget-list)))
6644 (let ((wid (car (car wid-list)))
6645 (value (cdr (car wid-list))))
6646 (setq wid-list (cdr wid-list))
6647 (widget-value-set wid (eq (symbol-value var-sym) value))))
6651 (defun pr-update-checkbox (var-sym)
6652 (let ((wid (get var-sym 'pr-widget)))
6654 (widget-value-set wid (symbol-value var-sym))
6658 (defun pr-choice-alist (alist)
6659 (let ((max (apply 'max (mapcar #'(lambda (alist)
6660 (length (symbol-name (car alist))))
6662 (mapcar #'(lambda (alist)
6663 (let* ((sym (car alist))
6664 (name (symbol-name sym)))
6671 (make-string (- max (length name)) ?_))
6676 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
6682 ;; arch-tag: 9ce9ac3f-0f60-4370-900b-1943215d9d18
6683 ;;; printing.el ends here