merge emacs-23
[emacs.git] / lisp / printing.el
blob2cbf39f1967e3c94f8aedad39a11fda73b18eeeb
1 ;;; printing.el --- printing utilities
3 ;; Copyright (C) 2000, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
4 ;; Free Software Foundation, Inc.
6 ;; Author: Vinicius Jose Latorre <viniciusjl@ig.com.br>
7 ;; Maintainer: Vinicius Jose Latorre <viniciusjl@ig.com.br>
8 ;; Keywords: wp, print, PostScript
9 ;; Version: 6.9.3
10 ;; X-URL: http://www.emacswiki.org/cgi-bin/wiki/ViniciusJoseLatorre
12 (defconst pr-version "6.9.3"
13 "printing.el, v 6.9.3 <2007/12/09 vinicius>
15 Please send all bug fixes and enhancements to
16 Vinicius Jose Latorre <viniciusjl@ig.com.br>
19 ;; This file is part of GNU Emacs.
21 ;; GNU Emacs is free software: you can redistribute it and/or modify
22 ;; it under the terms of the GNU General Public License as published by
23 ;; the Free Software Foundation, either version 3 of the License, or
24 ;; (at your option) any later version.
26 ;; GNU Emacs is distributed in the hope that it will be useful,
27 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
28 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
29 ;; GNU General Public License for more details.
31 ;; You should have received a copy of the GNU General Public License
32 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
34 ;;; Commentary:
36 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
38 ;; Introduction
39 ;; ------------
41 ;; With `printing' you can preview or print a PostScript file. You can also
42 ;; print a text file using PostScript, and preview or print buffers that use
43 ;; certain special modes like mh-folder-mode, rmail-summary-mode,
44 ;; gnus-summary-mode, etc. This package also includes a PostScript/text
45 ;; printer database.
47 ;; There are two user interfaces:
49 ;; * Menu interface:
50 ;; The `printing' menu replaces the usual print options in the menu bar.
51 ;; This is the default user interface.
53 ;; * Buffer interface:
54 ;; You can use a buffer interface instead of menus. It looks like a
55 ;; customization buffer. Basically, it has the same options found in the
56 ;; menu and some extra options, all this on a buffer.
58 ;; `printing' is prepared to run on GNU, Unix and NT systems.
59 ;; On GNU or Unix system, `printing' depends on gs and gv utilities.
60 ;; On NT system, `printing' depends on gstools (gswin32.exe and gsview32.exe).
61 ;; To obtain ghostscript, ghostview and GSview see the URL
62 ;; `http://www.gnu.org/software/ghostscript/ghostscript.html'.
64 ;; `printing' depends on ps-print package to generate PostScript files, to
65 ;; spool and to despool PostScript buffer. So, `printing' provides an
66 ;; interface to ps-print package and it also provides some extra stuff.
68 ;; To download the latest ps-print package see
69 ;; `http://www.emacswiki.org/cgi-bin/wiki/PsPrintPackage'.
70 ;; Please, see README file for ps-print installation instructions.
72 ;; `printing' was inspired by:
74 ;; print-nt.el Frederic Corne <frederic.corne@erli.fr>
75 ;; Special printing functions for Windows NT
77 ;; mh-e-init.el Tom Vogels <tov@ece.cmu.edu>
78 ;; PS-print for mail messages
80 ;; win32-ps-print.el Matthew O. Persico <mpersico@erols.com>
81 ;; PostScript printing with ghostscript
83 ;; ps-print-interface.el Volker Franz <volker.franz@tuebingen.mpg.de>
84 ;; Graphical front end for ps-print and previewing
87 ;; Log Messages
88 ;; ------------
90 ;; The buffer *Printing Command Output* is where the `printing' log messages
91 ;; are inserted. All program called by `printing' has a log entry in the
92 ;; buffer *Printing Command Output*. A log entry has the following form:
94 ;; PROGRAM (ARG...)
95 ;; MESSAGE
96 ;; Exit status: CODE
98 ;; Where
99 ;; PROGRAM is the program activated by `printing',
100 ;; ARG is an argument passed to PROGRAM (it can have more than one argument),
101 ;; MESSAGE is an error message returned by PROGRAM (it can have no message, if
102 ;; PROGRAM is successful),
103 ;; and CODE is a numeric exit status or a signal description string.
105 ;; For example, after previewing a PostScript file, *Printing Command Output*
106 ;; will have the following entry:
108 ;; /usr/X11R6/bin/gv ("/home/user/example/file.ps")
109 ;; Exit status: 0
111 ;; In the example above, the previewing was successful. If during previewing,
112 ;; you quit gv execution (by typing C-g during Emacs session), the log entry
113 ;; would be:
115 ;; /usr/X11R6/bin/gv ("/home/user/example/file.ps")
116 ;; Exit status: Quit
118 ;; So, if something goes wrong, a good place to take a look is the buffer
119 ;; *Printing Command Output*. Don't forget to see also the buffer *Messages*,
120 ;; it can help.
123 ;; Novices (First Users)
124 ;; ---------------------
126 ;; First of all, see printing documentation only to get an idea of what
127 ;; `printing' is capable.
129 ;; Then try to set the variables: `pr-ps-name', `pr-ps-printer-alist',
130 ;; `pr-txt-name', `pr-txt-printer-alist' and `pr-path-alist'. These variables
131 ;; are the main variables for printing processing.
133 ;; Now, please, see these variables documentation deeper. You can do this by
134 ;; typing C-h v pr-ps-name RET (for example) if you already loaded printing
135 ;; package, or by browsing printing.el source file.
137 ;; If the documentation isn't clear or if you find a way to improve the
138 ;; documentation, please, send an email to maintainer. All printing users
139 ;; will thank you.
141 ;; One way to set variables is by calling `pr-customize', customize all
142 ;; variables and save the customization by future sessions (see Options
143 ;; section). Other way is by coding your settings on Emacs init file (that is,
144 ;; ~/.emacs file), see below for a first setting template that it should be
145 ;; inserted on your ~/.emacs file (or c:/_emacs, if you're using Windows 9x/NT
146 ;; or MS-DOS):
148 ;; * Example of setting for Windows system:
150 ;; (require 'printing) ; load printing package
151 ;; (setq pr-path-alist
152 ;; '((windows "c:/applications/executables" PATH ghostview mpage)
153 ;; (ghostview "c:/gs/gsview-dir")
154 ;; (mpage "c:/mpage-dir")
155 ;; ))
156 ;; (setq pr-txt-name 'prt_06a)
157 ;; (setq pr-txt-printer-alist
158 ;; '((prt_06a "print" nil "/D:\\\\printers\\prt_06a")
159 ;; (prt_07c nil nil "/D:\\\\printers\\prt_07c")
160 ;; (PRN "" nil "PRN")
161 ;; (standard "redpr.exe" nil "")
162 ;; ))
163 ;; (setq pr-ps-name 'lps_06b)
164 ;; (setq pr-ps-printer-alist
165 ;; '((lps_06a "print" nil "/D:" "\\\\printers\\lps_06a")
166 ;; (lps_06b "print" nil nil "\\\\printers\\lps_06b")
167 ;; (lps_07c "print" nil "" "/D:\\\\printers\\lps_07c")
168 ;; (lps_08c nil nil nil "\\\\printers\\lps_08c")
169 ;; (LPT1 "" nil "" "LPT1:")
170 ;; (PRN "" nil "" "PRN")
171 ;; (standard "redpr.exe" nil "" "")
172 ;; ))
173 ;; (pr-update-menus t) ; update now printer and utility menus
175 ;; * Example of setting for GNU or Unix system:
177 ;; (require 'printing) ; load printing package
178 ;; (setq pr-path-alist
179 ;; '((unix "." "~/bin" ghostview mpage PATH)
180 ;; (ghostview "$HOME/bin/gsview-dir")
181 ;; (mpage "$HOME/bin/mpage-dir")
182 ;; ))
183 ;; (setq pr-txt-name 'prt_06a)
184 ;; (setq pr-txt-printer-alist
185 ;; '((prt_06a "lpr" nil "prt_06a")
186 ;; (prt_07c nil nil "prt_07c")
187 ;; ))
188 ;; (setq pr-ps-name 'lps_06b)
189 ;; (setq pr-ps-printer-alist
190 ;; '((lps_06b "lpr" nil "-P" "lps_06b")
191 ;; (lps_07c "lpr" nil nil "lps_07c")
192 ;; (lps_08c nil nil nil "lps_08c")
193 ;; ))
194 ;; (pr-update-menus t) ; update now printer and utility menus
197 ;; NOTE 1: Don't forget to download and install ghostscript utilities (see
198 ;; Utilities section).
200 ;; NOTE 2: The `printer-name' and `ps-printer-name' variables don't need to be
201 ;; set, as they are implicit set by `pr-ps-printer-alist' and
202 ;; `pr-txt-printer-alist'.
204 ;; NOTE 3: The duplex feature will only work on PostScript printers that
205 ;; support this feature.
206 ;; You can check if your PostScript printer supports duplex feature
207 ;; by checking the printer manual. Or you can try these steps:
208 ;; 1. Open a buffer (or use the *scratch* buffer).
209 ;; 2. Type:
210 ;; First line (on first page)
211 ;; ^L
212 ;; Second line (on second page)
213 ;; 3. Print this buffer with duplex turned on.
214 ;; If it's printed 2 (two) sheets of paper, then your PostScript
215 ;; printer doesn't have duplex feature; otherwise, it's ok, your
216 ;; printer does have duplex feature.
218 ;; NOTE 4: See Tips section.
221 ;; Tips
222 ;; ----
224 ;; 1. If you have a local printer, that is, a printer which is connected
225 ;; directly to your computer, don't forget to connect the printer to your
226 ;; computer before printing.
228 ;; 2. If you try to print a file and it seems that the file was printed, but
229 ;; there is no paper in the printer, then try to set `pr-delete-temp-file'
230 ;; to nil. Probably `printing' is deleting the temporary file before your
231 ;; local system can get it to send to the printer.
233 ;; 3. Don't try to print a dynamic buffer, that is, a buffer which is
234 ;; modifying while `printing' tries to print. Eventually you got an error
235 ;; message. Instead, save the dynamic buffer to a file or copy it in
236 ;; another buffer and, then, print the file or the new static buffer.
237 ;; An example of dynamic buffer is the *Messages* buffer.
239 ;; 4. When running Emacs on Windows (with or without cygwin), check if your
240 ;; printer is a text printer or not by typing in a DOS window:
242 ;; print /D:\\host\printer somefile.txt
244 ;; Where, `host' is the machine where the printer is directly connected,
245 ;; `printer' is the printer name and `somefile.txt' is a text file.
247 ;; If the printer `\\host\printer' doesn't print the content of
248 ;; `somefile.txt' or, instead, it returns the following message:
250 ;; PostScript Error Handler
251 ;; Offending Command = CCC
252 ;; Stack =
254 ;; Where `CCC' is whatever is at the beginning of the text to be printed.
256 ;; Therefore, the printer `\\host\printer' is not a text printer, but a
257 ;; PostScript printer. So, please, don't include this printer in
258 ;; `pr-txt-printer-alist' (which see).
260 ;; 5. You can use gsprint instead of ghostscript to print monochrome PostScript
261 ;; files in Windows. The gsprint utility documentation says that it is more
262 ;; efficient than ghostscript to print monochrome PostScript.
264 ;; To print non-monochrome PostScript file, the efficiency of ghostscript
265 ;; is similar to gsprint.
267 ;; Also the gsprint utility comes together with gsview distribution.
269 ;; For more information about gsprint see
270 ;; `http://www.cs.wisc.edu/~ghost/gsview/gsprint.htm'.
272 ;; As an example of gsprint declaration:
274 ;; (setq pr-ps-printer-alist
275 ;; '((A "gsprint" ("-all" "-twoup") "-printer " "my-b/w-printer-name")
276 ;; (B "gsprint" ("-all" "-twoup") nil "-printer my-b/w-printer-name")
277 ;; ;; some other printer declaration
278 ;; ))
280 ;; The example above declares that printer A prints all pages (-all) and two
281 ;; pages per sheet (-twoup). The printer B declaration does the same as the
282 ;; printer A declaration, the only difference is the printer name selection.
284 ;; There are other command line options like:
286 ;; -mono Render in monochrome as 1bit/pixel (only black and white).
287 ;; -grey Render in greyscale as 8bits/pixel.
288 ;; -color Render in color as 24bits/pixel.
290 ;; The default is `-mono'. So, printer A and B in the example above are
291 ;; using implicitly the `-mono' option. Note that in `-mono' no gray tone
292 ;; or color is printed, this includes the zebra stripes, that is, in `-mono'
293 ;; the zebra stripes are not printed.
295 ;; See also documentation for `pr-ps-printer-alist'.
298 ;; Using `printing'
299 ;; ----------------
301 ;; To use `printing' insert in your ~/.emacs file (or c:/_emacs, if you're
302 ;; using Windows 9x/NT or MS-DOS):
304 ;; (require 'printing)
305 ;; ;; ...some user settings...
306 ;; (pr-update-menus t)
308 ;; During `pr-update-menus' evaluation:
309 ;; * On Emacs 20:
310 ;; it replaces the Tools/Print menu by Tools/Printing menu.
311 ;; * On Emacs 21:
312 ;; it replaces the File/Print* menu entries by File/Print menu.
313 ;; Please, see section Menu Layout below for menu explanation.
315 ;; To use `printing' utilities you can use the Printing menu options, type M-x
316 ;; followed by one of the commands below, or type a key associated with the
317 ;; command you want (if there is a key binding).
319 ;; `printing' has the following commands:
321 ;; pr-interface
322 ;; pr-ps-directory-preview
323 ;; pr-ps-directory-using-ghostscript
324 ;; pr-ps-directory-print
325 ;; pr-ps-directory-ps-print
326 ;; pr-ps-buffer-preview
327 ;; pr-ps-buffer-using-ghostscript
328 ;; pr-ps-buffer-print
329 ;; pr-ps-buffer-ps-print
330 ;; pr-ps-region-preview
331 ;; pr-ps-region-using-ghostscript
332 ;; pr-ps-region-print
333 ;; pr-ps-region-ps-print
334 ;; pr-ps-mode-preview
335 ;; pr-ps-mode-using-ghostscript
336 ;; pr-ps-mode-print
337 ;; pr-ps-mode-ps-print
338 ;; pr-ps-file-preview
339 ;; pr-ps-file-up-preview
340 ;; pr-ps-file-using-ghostscript
341 ;; pr-ps-file-print
342 ;; pr-ps-file-ps-print
343 ;; pr-ps-file-up-ps-print
344 ;; pr-ps-fast-fire
345 ;; pr-despool-preview
346 ;; pr-despool-using-ghostscript
347 ;; pr-despool-print
348 ;; pr-despool-ps-print
349 ;; pr-printify-directory
350 ;; pr-printify-buffer
351 ;; pr-printify-region
352 ;; pr-txt-directory
353 ;; pr-txt-buffer
354 ;; pr-txt-region
355 ;; pr-txt-mode
356 ;; pr-txt-fast-fire
357 ;; pr-toggle-file-duplex
358 ;; pr-toggle-file-tumble
359 ;; pr-toggle-file-landscape
360 ;; pr-toggle-ghostscript
361 ;; pr-toggle-faces
362 ;; pr-toggle-spool
363 ;; pr-toggle-duplex
364 ;; pr-toggle-tumble
365 ;; pr-toggle-landscape
366 ;; pr-toggle-upside-down
367 ;; pr-toggle-line
368 ;; pr-toggle-zebra
369 ;; pr-toggle-header
370 ;; pr-toggle-lock
371 ;; pr-toggle-region
372 ;; pr-toggle-mode
373 ;; pr-customize
374 ;; lpr-customize
375 ;; pr-help
376 ;; pr-ps-name
377 ;; pr-txt-name
378 ;; pr-ps-utility
379 ;; pr-show-ps-setup
380 ;; pr-show-pr-setup
381 ;; pr-show-lpr-setup
383 ;; The general meanings of above commands are:
385 ;; PREFIX:
386 ;; `pr-interface' buffer interface for printing package.
387 ;; `pr-help' help for printing package.
388 ;; `pr-ps-name' interactively select a PostScript printer.
389 ;; `pr-txt-name' interactively select a text printer.
390 ;; `pr-ps-utility' interactively select a PostScript utility.
391 ;; `pr-show-*-setup' show current settings.
392 ;; `pr-ps-*' deal with PostScript code generation.
393 ;; `pr-txt-*' deal with text generation.
394 ;; `pr-toggle-*' toggle on/off some boolean variable.
395 ;; `pr-despool-*' despool the PostScript spooling buffer.
396 ;; `pr-printify-*' replace nonprintable ASCII by printable ASCII
397 ;; representation.
399 ;; SUFFIX:
400 ;; `*-customize' customization.
401 ;; `*-preview' preview a PostScript file.
402 ;; `*-using-ghostscript' use ghostscript to print.
403 ;; `*-fast-fire' fast fire command (see it for documentation).
404 ;; `*-print' send PostScript directly to printer.
405 ;; `*-ps-print' send PostScript directly to printer or use
406 ;; ghostscript to print. It depends on
407 ;; `pr-print-using-ghostscript' option.
409 ;; INFIX/SUFFIX:
410 ;; `*-directory*' process a directory.
411 ;; `*-buffer*' process a buffer.
412 ;; `*-region*' process a region.
413 ;; `*-mode*' process a major mode (see explanation below).
414 ;; `*-file-*' process a PostScript file.
415 ;; `*-file-up-*' process a PostScript file using a filter utility.
417 ;; Here are some examples:
419 ;; `pr-ps-buffer-using-ghostscript'
420 ;; Use ghostscript to print a buffer.
422 ;; `pr-ps-file-print'
423 ;; Print a PostScript file.
425 ;; `pr-toggle-spool'
426 ;; Toggle spooling buffer.
428 ;; So you can preview through ghostview, use ghostscript to print (if you don't
429 ;; have a PostScript printer) or send directly to printer a PostScript code
430 ;; generated by `ps-print' package.
432 ;; Besides operating one buffer or region each time, you also can postpone
433 ;; previewing or printing by saving the PostScript code generated in a
434 ;; temporary Emacs buffer. This way you can save banner pages between
435 ;; successive printing. You can toggle on/off spooling by invoking
436 ;; `pr-toggle-spool' interactively or through menu bar.
438 ;; If you type, for example:
440 ;; C-u M-x pr-ps-buffer-print RET
442 ;; The `pr-ps-buffer-print' command prompts you for a n-up printing number and
443 ;; a file name, and save the PostScript code generated to the file name instead
444 ;; of sending to printer.
446 ;; This behavior is similar with the commands that deal with PostScript code
447 ;; generation, that is, with `pr-ps-*' and `pr-despool-*' commands. If
448 ;; spooling is on, only `pr-despool-*' commands prompt for a file name and save
449 ;; the PostScript code spooled in this file.
451 ;; Besides the behavior described above, the `*-directory*' commands also
452 ;; prompt for a directory and a file name regexp. So, it's possible to process
453 ;; all or certain files on a directory at once (see also documentation for
454 ;; `pr-list-directory').
456 ;; `printing' has also a special way to handle some major mode through
457 ;; `*-mode*' commands. So it's possible to customize a major mode printing,
458 ;; it's only needed to declare the customization in `pr-mode-alist' (see
459 ;; section Options) and invoke some of `*-mode*' commands. An example for
460 ;; major mode usage is when you're using gnus (or mh, or rmail, etc.) and
461 ;; you're in the *Summary* buffer, if you forget to switch to the *Article*
462 ;; buffer before printing, you'll get a nicely formatted list of article
463 ;; subjects shows up at the printer. With major mode printing you don't need
464 ;; to switch from gnus *Summary* buffer first.
466 ;; Current global keyboard mapping for GNU Emacs is:
468 ;; (global-set-key [print] 'pr-ps-fast-fire)
469 ;; (global-set-key [M-print] 'pr-ps-mode-using-ghostscript)
470 ;; (global-set-key [S-print] 'pr-ps-mode-using-ghostscript)
471 ;; (global-set-key [C-print] 'pr-txt-fast-fire)
472 ;; (global-set-key [C-M-print] 'pr-txt-fast-fire)
474 ;; And for XEmacs is:
476 ;; (global-set-key 'f22 'pr-ps-fast-fire)
477 ;; (global-set-key '(meta f22) 'pr-ps-mode-using-ghostscript)
478 ;; (global-set-key '(shift f22) 'pr-ps-mode-using-ghostscript)
479 ;; (global-set-key '(control f22) 'pr-txt-fast-fire)
480 ;; (global-set-key '(control meta f22) 'pr-txt-fast-fire)
482 ;; As a suggestion of global keyboard mapping for some `printing' commands:
484 ;; (global-set-key "\C-ci" 'pr-interface)
485 ;; (global-set-key "\C-cbp" 'pr-ps-buffer-print)
486 ;; (global-set-key "\C-cbx" 'pr-ps-buffer-preview)
487 ;; (global-set-key "\C-cbb" 'pr-ps-buffer-using-ghostscript)
488 ;; (global-set-key "\C-crp" 'pr-ps-region-print)
489 ;; (global-set-key "\C-crx" 'pr-ps-region-preview)
490 ;; (global-set-key "\C-crr" 'pr-ps-region-using-ghostscript)
493 ;; Options
494 ;; -------
496 ;; Below it's shown a brief description of `printing' options, please, see the
497 ;; options declaration in the code for a long documentation.
499 ;; `pr-path-style' Specify which path style to use for external
500 ;; commands.
502 ;; `pr-path-alist' Specify an alist for command paths.
504 ;; `pr-txt-name' Specify a printer for printing a text file.
506 ;; `pr-txt-printer-alist' Specify an alist of all text printers.
508 ;; `pr-ps-name' Specify a printer for printing a PostScript
509 ;; file.
511 ;; `pr-ps-printer-alist' Specify an alist for all PostScript printers.
513 ;; `pr-temp-dir' Specify a directory for temporary files during
514 ;; printing.
516 ;; `pr-ps-temp-file' Specify PostScript temporary file name prefix.
518 ;; `pr-file-modes' Specify the file permission bits for newly
519 ;; created files.
521 ;; `pr-gv-command' Specify path and name of the gsview/gv
522 ;; utility.
524 ;; `pr-gs-command' Specify path and name of the ghostscript
525 ;; utility.
527 ;; `pr-gs-switches' Specify ghostscript switches.
529 ;; `pr-gs-device' Specify ghostscript device switch value.
531 ;; `pr-gs-resolution' Specify ghostscript resolution switch value.
533 ;; `pr-print-using-ghostscript' Non-nil means print using ghostscript.
535 ;; `pr-faces-p' Non-nil means print with face attributes.
537 ;; `pr-spool-p' Non-nil means spool printing in a buffer.
539 ;; `pr-file-landscape' Non-nil means print PostScript file in
540 ;; landscape orientation.
542 ;; `pr-file-duplex' Non-nil means print PostScript file in duplex
543 ;; mode.
545 ;; `pr-file-tumble' Non-nil means print PostScript file in tumble
546 ;; mode.
548 ;; `pr-auto-region' Non-nil means region is automagically detected.
550 ;; `pr-auto-mode' Non-nil means major-mode specific printing is
551 ;; prefered over normal printing.
553 ;; `pr-mode-alist' Specify an alist for a major-mode and printing
554 ;; function.
556 ;; `pr-ps-utility' Specify PostScript utility processing.
558 ;; `pr-ps-utility-alist' Specify an alist for PostScript utility
559 ;; processing.
561 ;; `pr-menu-lock' Non-nil means menu is locked while selecting
562 ;; toggle options.
564 ;; `pr-menu-char-height' Specify menu char height in pixels.
566 ;; `pr-menu-char-width' Specify menu char width in pixels.
568 ;; `pr-setting-database' Specify an alist for settings in general.
570 ;; `pr-visible-entry-list' Specify a list of Printing menu visible
571 ;; entries.
573 ;; `pr-delete-temp-file' Non-nil means delete temporary files.
575 ;; `pr-list-directory' Non-nil means list directory when processing a
576 ;; directory.
578 ;; `pr-buffer-name' Specify the name of the buffer interface for
579 ;; printing package.
581 ;; `pr-buffer-name-ignore' Specify a regexp list for buffer names to be
582 ;; ignored in interface buffer.
584 ;; `pr-buffer-verbose' Non-nil means to be verbose when editing a
585 ;; field in interface buffer.
587 ;; To set the above options you may:
589 ;; a) insert the code in your ~/.emacs, like:
591 ;; (setq pr-faces-p t)
593 ;; This way always keep your default settings when you enter a new Emacs
594 ;; session.
596 ;; b) or use `set-variable' in your Emacs session, like:
598 ;; M-x set-variable RET pr-faces-p RET t RET
600 ;; This way keep your settings only during the current Emacs session.
602 ;; c) or use customization, for example:
603 ;; click on menu-bar *Help* option,
604 ;; then click on *Customize*,
605 ;; then click on *Browse Customization Groups*,
606 ;; expand *PostScript* group,
607 ;; expand *Printing* group
608 ;; and then customize `printing' options.
609 ;; Through this way, you may choose if the settings are kept or not when
610 ;; you leave out the current Emacs session.
612 ;; d) or see the option value:
614 ;; C-h v pr-faces-p RET
616 ;; and click the *customize* hypertext button.
617 ;; Through this way, you may choose if the settings are kept or not when
618 ;; you leave out the current Emacs session.
620 ;; e) or invoke:
622 ;; M-x pr-customize RET
624 ;; and then customize `printing' options.
625 ;; Through this way, you may choose if the settings are kept or not when
626 ;; you leave out the current Emacs session.
628 ;; f) or use menu bar, for example:
629 ;; click on menu-bar *File* option,
630 ;; then click on *Printing*,
631 ;; then click on *Customize*,
632 ;; then click on *printing*
633 ;; and then customize `printing' options.
634 ;; Through this way, you may choose if the settings are kept or not when
635 ;; you leave out the current Emacs session.
638 ;; Menu Layout
639 ;; -----------
641 ;; The `printing' menu (Tools/Printing or File/Print) has the following layout:
643 ;; +-----------------------------+
644 ;; A 0 | Printing Interface |
645 ;; +-----------------------------+ +-A---------+ +-B------+
646 ;; I 1 | PostScript Preview >|-------|Directory >|-----|1-up |
647 ;; 2 | PostScript Print >|---- A |Buffer >|-- B |2-up |
648 ;; 3 | PostScript Printer: name >|---- C |Region >|-- B |4-up |
649 ;; +-----------------------------+ |Mode >|-- B |Other...|
650 ;; II 4 | Printify >|-----\ |File >|--\ +--------+
651 ;; 5 | Print >|---\ | |Despool... | |
652 ;; 6 | Text Printer: name >|-\ | | +-----------+ |
653 ;; +-----------------------------+ | | | +---------+ +------------+
654 ;; III 7 |[ ]Landscape | | | \-|Directory| | No Prep... | Ia
655 ;; 8 |[ ]Print Header | | | |Buffer | +------------+ Ib
656 ;; 9 |[ ]Print Header Frame | | | |Region | | name >|- C
657 ;; 10 |[ ]Line Number | | | +---------+ +------------+
658 ;; 11 |[ ]Zebra Stripes | | | +---------+ | 1-up... | Ic
659 ;; 12 |[ ]Duplex | | \---|Directory| | 2-up... |
660 ;; 13 |[ ]Tumble | \--\ |Buffer | | 4-up... |
661 ;; 14 |[ ]Upside-Down | | |Region | | Other... |
662 ;; 15 | Print All Pages >|--\ | |Mode | +------------+
663 ;; +-----------------------------+ | | +---------+ |[ ]Landscape| Id
664 ;; IV 16 |[ ]Spool Buffer | | | +-C-------+ |[ ]Duplex | Ie
665 ;; 17 |[ ]Print with faces | | \--|( )name A| |[ ]Tumble | If
666 ;; 18 |[ ]Print via Ghostscript | | |( )name B| +------------+
667 ;; +-----------------------------+ | |... |
668 ;; V 19 |[ ]Auto Region | | |(*)name |
669 ;; 20 |[ ]Auto Mode | | |... |
670 ;; 21 |[ ]Menu Lock | | +---------+ +--------------+
671 ;; +-----------------------------+ \------------------|(*)All Pages |
672 ;; VI 22 | Customize >|--- D +-D------+ |( )Even Pages |
673 ;; 23 | Show Settings >|-------|printing| |( )Odd Pages |
674 ;; 24 | Help | |ps-print| |( )Even Sheets|
675 ;; +-----------------------------+ |lpr | |( )Odd Sheets |
676 ;; +--------+ +--------------+
678 ;; See `pr-visible-entry-list' for hiding some parts of the menu.
680 ;; The menu has the following sections:
682 ;; A. Interface:
684 ;; 0. You can use a buffer interface instead of menus. It looks like the
685 ;; customization buffer. Basically, it has the same options found in the
686 ;; menu and some extra options, all this on a buffer.
688 ;; I. PostScript printing:
690 ;; 1. You can generate a PostScript file (if you type C-u before activating
691 ;; menu) or PostScript temporary file for a directory, a buffer, a region
692 ;; or a major mode, choosing 1-up, 2-up, 4-up or any other n-up printing;
693 ;; after file generation, ghostview is activated using the file generated
694 ;; as argument. This option is disabled if spooling is on (option 16).
695 ;; Also, if you already have a PostScript file you can preview it.
696 ;; Instead of previewing each buffer, region or major mode at once, you
697 ;; can save temporarily the PostScript code generated in a buffer and
698 ;; preview it later. The option `Despool...' despools the PostScript
699 ;; spooling buffer in a temporary file and uses ghostview to preview it.
700 ;; If you type C-u before choosing this option, the PostScript code
701 ;; generated is saved in a file instead of saving in a temporary file.
702 ;; To spool the PostScript code generated you need to turn on the option
703 ;; 16. The option `Despool...' is enabled if spooling is on (option
704 ;; 16).
706 ;; NOTE 1: It's possible to customize a major mode printing, just declare
707 ;; the customization in `pr-mode-alist' and invoke some of
708 ;; `*-mode*' commands or select Mode option in Printing menu. An
709 ;; example for major mode usage is when you're using gnus (or mh,
710 ;; or rmail, etc.) and you're in the *Summary* buffer, if you
711 ;; forget to switch to the *Article* buffer before printing,
712 ;; you'll get a nicely formatted list of article subjects shows
713 ;; up at the printer. With major mode printing you don't need to
714 ;; switch from gnus *Summary* buffer first.
716 ;; NOTE 2: There are the following options for PostScript file
717 ;; processing:
718 ;; Ia. Print the file *No Preprocessing*, that is, send it
719 ;; directly to PostScript printer.
720 ;; Ib. PostScript utility processing selection.
721 ;; See `pr-ps-utility-alist' and `pr-setting-database' for
722 ;; documentation.
723 ;; Ic. Do n-up processing before printing.
724 ;; Id. Toggle on/off landscape for PostScript file processing.
725 ;; Ie. Toggle on/off duplex for PostScript file processing.
726 ;; If. Toggle on/off tumble for PostScript file processing.
728 ;; NOTE 3: Don't forget to download and install the utilities declared on
729 ;; `pr-ps-utility-alist'.
731 ;; 2. Operate the same way as option 1, but it sends directly the PostScript
732 ;; code (or put in a file, if you've typed C-u) or it uses ghostscript to
733 ;; print the PostScript file generated. It depends on option 18, if it's
734 ;; turned on, it uses ghostscript; otherwise, it sends directly to
735 ;; printer. If spooling is on (option 16), the PostScript code is saved
736 ;; temporarily in a buffer instead of printing it or saving it in a file.
737 ;; Also, if you already have a PostScript file you can print it. Instead
738 ;; of printing each buffer, region or major mode at once, you can save
739 ;; temporarily the PostScript code generated in a buffer and print it
740 ;; later. The option `Despool...' despools the PostScript spooling
741 ;; buffer directly on a printer. If you type C-u before choosing this
742 ;; option, the PostScript code generated is saved in a file instead of
743 ;; sending to printer. To spool the PostScript code generated you need
744 ;; to turn on the option 16. This option is enabled if spooling is on
745 ;; (option 16). See also the NOTE 1, NOTE 2 and NOTE 3 on option 1.
747 ;; 3. You can select a new PostScript printer to send PostScript code
748 ;; generated. For selection it's used all PostScript printers defined
749 ;; in `pr-ps-printer-alist' variable (see it for documentation).
750 ;; See also `pr-setting-database'.
752 ;; II. Text printing:
754 ;; 4. If you have control characters (character code from \000 to \037) in a
755 ;; buffer and you want to print them in a text printer, select this
756 ;; option. All control characters in your buffer or region will be
757 ;; replaced by a printable representation. The printable representations
758 ;; use ^ (for ASCII control characters) or hex. The characters tab,
759 ;; linefeed, space, return and formfeed are not affected. You don't need
760 ;; to select this option if you use any option of section I, the
761 ;; PostScript engine treats control characters properly.
763 ;; 5. If you want to print a directory, buffer, region or major mode in a
764 ;; text printer, select this option. See also the NOTE 1 on option 1.
766 ;; 6. You can select a new text printer to send text generated. For
767 ;; selection it's used all text printers defined in
768 ;; `pr-txt-printer-alist' variable (see it for documentation).
769 ;; See also `pr-setting-database'.
771 ;; III. PostScript page toggle options:
773 ;; 7. If you want a PostScript landscape printing, turn on this option.
775 ;; 8. If you want to have a header in each page in your PostScript code,
776 ;; turn on this option.
778 ;; 9. If you want to draw a gaudy frame around the header, turn on this
779 ;; option. This option is enabled if print header is on (option 8).
781 ;; 10. If you want that the line number is printed in your PostScript code,
782 ;; turn on this option.
784 ;; 11. If you want background zebra stripes in your PostScript code, turn on
785 ;; this option.
787 ;; 12. If you want a duplex printing and your PostScript printer has this
788 ;; feature, turn on this option.
790 ;; 13. If you turned on duplex printing, you can choose if you want to have
791 ;; a printing suitable for binding on the left or right (tumble off), or
792 ;; to have a printing suitable for binding at top or bottom (tumble on).
793 ;; This option is enabled if duplex is on (option 12).
795 ;; 14. If you want a PostScript upside-down printing, turn on this option.
797 ;; 15. With this option, you can choose if you want to print all pages, odd
798 ;; pages, even pages, odd sheets or even sheets.
799 ;; See also `ps-even-or-odd-pages'.
801 ;; IV. PostScript processing toggle options:
803 ;; 16. If you want to spool the PostScript code generated, turn on this
804 ;; option. To spool the PostScript code generated use option 2. You
805 ;; can despool later by choosing option 1 or 2, sub-option `Despool...'.
807 ;; 17. If you use colors in your buffers and want to see these colors on
808 ;; your PostScript code generated, turn on this option. If you have a
809 ;; black/white PostScript printer, these colors are displayed in gray
810 ;; scale by PostScript printer interpreter.
812 ;; 18. If you don't have a PostScript printer to send PostScript files, turn
813 ;; on this option. When this option is on, the ghostscript is used to
814 ;; print PostScript files. In GNU or Unix system, if ghostscript is set
815 ;; as a PostScript filter, you don't need to turn on this option.
817 ;; V. Printing customization:
819 ;; 19. If you want that region is automagically detected, turn on this
820 ;; option. Note that this will only work if you're using transient mark
821 ;; mode. When this option is on, the `*-buffer*' commands will behave
822 ;; like `*-region*' commands, that is, `*-buffer*' commands will print
823 ;; only the region marked instead of all buffer.
825 ;; 20. Turn this option on if you want that when current major-mode is
826 ;; declared in `pr-mode-alist', the `*-buffer*' and `*-region*' commands
827 ;; behave like `*-mode*' commands.
829 ;; 21. If you want that Printing menu stays open while you are setting
830 ;; toggle options, turn on this option. The variables
831 ;; `pr-menu-char-height' and `pr-menu-char-width' are used to guess the
832 ;; menu position, so don't forget to adjust these variables if menu
833 ;; position is not ok.
835 ;; VI. Customization:
837 ;; 22. Besides all options in section III, IV and V, you can customize much
838 ;; more PostScript options in `ps-print' option. Or you can customize
839 ;; some `lpr' options for text printing. Or customize `printing'
840 ;; options.
842 ;; 23. Show current settings for `printing', `ps-print' or `lpr'.
844 ;; 24. Quick help for printing menu layout.
847 ;; Option Settings
848 ;; ---------------
850 ;; Below it's shown only the main options that affect all `printing' package.
851 ;; Check all the settings below *BEFORE* running `printing' commands.
853 ;; * Example of setting for GNU or Unix system:
855 ;; (require 'printing)
856 ;; (setq pr-path-alist
857 ;; '((unix "." "~/bin" ghostview mpage PATH)
858 ;; (ghostview "$HOME/bin/gsview-dir")
859 ;; (mpage "$HOME/bin/mpage-dir")
860 ;; ))
861 ;; (setq pr-txt-name 'prt_06a)
862 ;; (setq pr-txt-printer-alist
863 ;; '((prt_06a "lpr" nil "prt_06a")
864 ;; (prt_07c nil nil "prt_07c")
865 ;; ))
866 ;; (setq pr-ps-name 'lps_06b)
867 ;; (setq pr-ps-printer-alist
868 ;; '((lps_06b "lpr" nil "-P" "lps_06b")
869 ;; (lps_07c "lpr" nil nil "lps_07c")
870 ;; (lps_08c nil nil nil "lps_08c")
871 ;; ))
872 ;; (setq pr-temp-dir "/tmp/")
873 ;; (setq pr-gv-command "gv")
874 ;; (setq pr-gs-command "gs")
875 ;; (setq pr-gs-switches '("-q -dNOPAUSE -I/usr/share/ghostscript/5.10"))
876 ;; (setq pr-gs-device "uniprint")
877 ;; (setq pr-gs-resolution 300)
878 ;; (setq pr-ps-utility 'mpage)
879 ;; (setq pr-ps-utility-alist
880 ;; '((mpage "mpage" nil "-b%s" "-%d" "-l" "-t" "-T" ">" nil)
881 ;; (psnup "psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
882 ;; (inherits-from: . no-duplex))
883 ;; ))
884 ;; (setq pr-setting-database
885 ;; '((no-duplex
886 ;; nil nil nil
887 ;; (pr-file-duplex . nil)
888 ;; (pr-file-tumble . nil))
889 ;; ))
890 ;; (pr-update-menus t) ; update now printer and utility menus
892 ;; * Example of setting for Windows system:
894 ;; (require 'printing)
895 ;; (setq pr-path-alist
896 ;; '((windows "c:/applications/executables" PATH ghostview mpage)
897 ;; (ghostview "c:/gs/gsview-dir")
898 ;; (mpage "c:/mpage-dir")
899 ;; ))
900 ;; (setq pr-txt-name 'prt_06a)
901 ;; (setq pr-txt-printer-alist
902 ;; '((prt_06a "print" nil "/D:\\\\printers\\prt_06a")
903 ;; (prt_07c nil nil "/D:\\\\printers\\prt_07c")
904 ;; (PRN "" nil "PRN")
905 ;; (standard "redpr.exe" nil "")
906 ;; ))
907 ;; (setq pr-ps-name 'lps_06b)
908 ;; (setq pr-ps-printer-alist
909 ;; '((lps_06a "print" nil "/D:" "\\\\printers\\lps_06a")
910 ;; (lps_06b "print" nil nil "\\\\printers\\lps_06b")
911 ;; (lps_07c "print" nil "" "/D:\\\\printers\\lps_07c")
912 ;; (lps_08c nil nil nil "\\\\printers\\lps_08c")
913 ;; (b/w "gsprint" ("-all" "-twoup") "-printer " "b/w-pr-name")
914 ;; (LPT1 "" nil "" "LPT1:")
915 ;; (PRN "" nil "" "PRN")
916 ;; (standard "redpr.exe" nil "" "")
917 ;; ))
918 ;; (setq pr-temp-dir "C:/WINDOWS/TEMP/")
919 ;; (setq pr-gv-command "c:/gs/gsview/gsview32.exe")
920 ;; (setq pr-gs-command "c:/gs/gswin32.exe")
921 ;; (setq pr-gs-switches '("-q -dNOPAUSE -Ic:/gs/gs5.50;c:/gs/gs5.50/fonts"))
922 ;; (setq pr-gs-device "mswinpr2")
923 ;; (setq pr-gs-resolution 300)
924 ;; (setq pr-ps-utility 'psnup)
925 ;; (setq pr-ps-utility-alist
926 ;; '((psnup "c:/psutils/psnup" ("-q") "-P%s" "-%d" "-l" nil nil " "
927 ;; nil (inherits-from: . no-duplex))
928 ;; ))
929 ;; (setq pr-setting-database
930 ;; '((no-duplex
931 ;; nil nil nil
932 ;; (pr-file-duplex . nil)
933 ;; (pr-file-tumble . nil))
934 ;; ))
935 ;; (pr-update-menus t) ; update now printer and utility menus
937 ;; NOTE: Don't forget to download and install the utilities declared on
938 ;; `pr-ps-utility-alist'.
941 ;; Utilities
942 ;; ---------
944 ;; `printing' package has the following utilities:
946 ;; `pr-setup' Return the current `printing' setup.
948 ;; `lpr-setup' Return the current `lpr' setup.
950 ;; `pr-update-menus' Update utility, PostScript and text printer menus.
952 ;; `pr-menu-bind' Install `printing' menu in the menubar.
955 ;; Below are some URL where you can find good utilities.
957 ;; * For `printing' package:
959 ;; printing `http://www.emacswiki.org/cgi-bin/emacs/download/printing.el'
960 ;; ps-print `http://www.emacswiki.org/cgi-bin/wiki/PsPrintPackage'
962 ;; * For GNU or Unix system:
964 ;; gs, gv `http://www.gnu.org/software/ghostscript/ghostscript.html'
965 ;; enscript `http://people.ssh.fi/mtr/genscript/'
966 ;; psnup `http://www.knackered.org/angus/psutils/'
967 ;; mpage `http://www.mesa.nl/pub/mpage/'
969 ;; * For Windows system:
971 ;; gswin32, gsview32
972 ;; `http://www.gnu.org/software/ghostscript/ghostscript.html'
973 ;; gsprint `http://www.cs.wisc.edu/~ghost/gsview/gsprint.htm'.
974 ;; enscript `http://people.ssh.fi/mtr/genscript/'
975 ;; psnup `http://gnuwin32.sourceforge.net/packages/psutils.htm'
976 ;; redmon `http://www.cs.wisc.edu/~ghost/redmon/'
979 ;; Acknowledgments
980 ;; ---------------
982 ;; Thanks to Stefan Monnier <monnier@iro.umontreal.ca> for GNU Emacs and XEmacs
983 ;; printing menu (in `pr-menu-spec') merging suggestion.
985 ;; Thanks to Lennart Borgman <lennart.borgman.073@student.lu.se> for gsprint
986 ;; suggestion (see tip 5 in section Tips).
988 ;; Thanks to Drew Adams <drew.adams@oracle.com> for suggestions:
989 ;; - directory processing.
990 ;; - `pr-path-alist' variable.
991 ;; - doc fix.
992 ;; - a lot of tests on Windows.
994 ;; Thanks to Fred Labrosse <f.labrosse@maths.bath.ac.uk> for XEmacs tests.
996 ;; Thanks to Klaus Berndl <klaus.berndl@sdm.de> for invaluable help/debugging
997 ;; and for suggestions:
998 ;; - even/odd pages printing.
999 ;; - ghostscript parameters for `pr-ps-printer-alist'.
1000 ;; - default printer name.
1001 ;; - completion functions.
1002 ;; - automagic region detection.
1003 ;; - menu entry hiding.
1004 ;; - fast fire PostScript printing command.
1005 ;; - `pr-path-style' variable.
1007 ;; Thanks to Kim F. Storm <storm@filanet.dk> for beta-test and for suggestions:
1008 ;; - PostScript Print and PostScript Print Preview merge.
1009 ;; - Tools/Printing menu.
1010 ;; - replace *-using-preview by *-using-ghostscript.
1011 ;; - printer selection.
1012 ;; - extra parameters for `pr-ps-printer-alist'.
1014 ;; Thanks to:
1015 ;; Frederic Corne <frederic.corne@erli.fr> print-nt.el
1016 ;; Tom Vogels <tov@ece.cmu.edu> mh-e-init.el
1017 ;; Matthew O. Persico <mpersico@erols.com> win32-ps-print.el
1018 ;; Volker Franz <volker.franz@tuebingen.mpg.de> ps-print-interface.el
1019 ;; And to all people who contributed with them.
1022 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1024 ;;; Code:
1027 (require 'lpr)
1028 (require 'ps-print)
1031 (and (string< ps-print-version "6.6.4")
1032 (error "`printing' requires `ps-print' package version 6.6.4 or later"))
1035 (defconst pr-cygwin-system
1036 (and ps-windows-system (getenv "OSTYPE")
1037 (string-match "cygwin" (getenv "OSTYPE"))))
1040 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1041 ;; To avoid compilation gripes
1044 (or (fboundp 'subst-char-in-string) ; hacked from subr.el
1045 (defun subst-char-in-string (fromchar tochar string &optional inplace)
1046 "Replace FROMCHAR with TOCHAR in STRING each time it occurs.
1047 Unless optional argument INPLACE is non-nil, return a new string."
1048 (let ((i (length string))
1049 (newstr (if inplace string (copy-sequence string))))
1050 (while (> (setq i (1- i)) 0)
1051 (if (eq (aref newstr i) fromchar)
1052 (aset newstr i tochar)))
1053 newstr)))
1056 (or (fboundp 'make-temp-file) ; hacked from subr.el
1057 (defun make-temp-file (prefix &optional dir-flag suffix)
1058 "Create a temporary file.
1059 The returned file name (created by appending some random characters at the end
1060 of PREFIX, and expanding against `temporary-file-directory' if necessary),
1061 is guaranteed to point to a newly created empty file.
1062 You can then use `write-region' to write new data into the file.
1064 If DIR-FLAG is non-nil, create a new empty directory instead of a file.
1066 If SUFFIX is non-nil, add that at the end of the file name."
1067 (let ((umask (default-file-modes))
1068 file)
1069 (unwind-protect
1070 (progn
1071 ;; Create temp files with strict access rights. It's easy to
1072 ;; loosen them later, whereas it's impossible to close the
1073 ;; time-window of loose permissions otherwise.
1074 (set-default-file-modes ?\700)
1075 (while (condition-case ()
1076 (progn
1077 (setq file
1078 (make-temp-name
1079 (expand-file-name prefix temporary-file-directory)))
1080 (if suffix
1081 (setq file (concat file suffix)))
1082 (if dir-flag
1083 (make-directory file)
1084 (write-region "" nil file nil 'silent nil 'excl))
1085 nil)
1086 (file-already-exists t))
1087 ;; the file was somehow created by someone else between
1088 ;; `make-temp-name' and `write-region', let's try again.
1089 nil)
1090 file)
1091 ;; Reset the umask.
1092 (set-default-file-modes umask)))))
1095 (eval-when-compile
1096 ;; User Interface --- declared here to avoid compiler warnings
1097 (defvar pr-path-style)
1098 (defvar pr-auto-region)
1099 (defvar pr-menu-char-height)
1100 (defvar pr-menu-char-width)
1101 (defvar pr-menu-lock)
1102 (defvar pr-ps-printer-alist)
1103 (defvar pr-txt-printer-alist)
1104 (defvar pr-ps-utility-alist)
1107 ;; Internal fun alias to avoid compilation gripes
1108 (defalias 'pr-menu-lookup 'ignore)
1109 (defalias 'pr-menu-lock 'ignore)
1110 (defalias 'pr-menu-alist 'ignore)
1111 (defalias 'pr-even-or-odd-pages 'ignore)
1112 (defalias 'pr-menu-get-item 'ignore)
1113 (defalias 'pr-menu-set-item-name 'ignore)
1114 (defalias 'pr-menu-set-utility-title 'ignore)
1115 (defalias 'pr-menu-set-ps-title 'ignore)
1116 (defalias 'pr-menu-set-txt-title 'ignore)
1117 (defalias 'pr-region-active-p 'ignore)
1118 (defalias 'pr-do-update-menus 'ignore)
1119 (defalias 'pr-update-mode-line 'ignore)
1120 (defalias 'pr-read-string 'ignore)
1121 (defalias 'pr-set-keymap-parents 'ignore)
1122 (defalias 'pr-keep-region-active 'ignore))
1125 ;; Internal Vars --- defined here to avoid compiler warnings
1126 (defvar pr-menu-print-item "print"
1127 "Non-nil means that menu binding was not done.
1129 Used by `pr-menu-bind' and `pr-update-menus'.")
1131 (defvar pr-ps-printer-menu-modified t
1132 "Non-nil means `pr-ps-printer-alist' was modified and we need to update menu.")
1134 (defvar pr-txt-printer-menu-modified t
1135 "Non-nil means `pr-txt-printer-alist' was modified and we need to update menu.")
1137 (defvar pr-ps-utility-menu-modified t
1138 "Non-nil means `pr-ps-utility-alist' was modified and we need to update menu.")
1140 (defconst pr-even-or-odd-alist
1141 '((nil . "Print All Pages")
1142 (even-page . "Print Even Pages")
1143 (odd-page . "Print Odd Pages")
1144 (even-sheet . "Print Even Sheets")
1145 (odd-sheet . "Print Odd Sheets")))
1148 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1149 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1150 ;; XEmacs Definitions
1153 (cond
1154 ((featurep 'xemacs) ; XEmacs
1155 ;; XEmacs
1156 (defalias 'pr-set-keymap-parents 'set-keymap-parents)
1157 (defalias 'pr-set-keymap-name 'set-keymap-name)
1159 ;; XEmacs
1160 (defun pr-read-string (prompt initial history default)
1161 (let ((str (read-string prompt initial)))
1162 (if (and str (not (string= str "")))
1164 default)))
1166 ;; XEmacs
1167 (defvar zmacs-region-stays nil)
1169 ;; XEmacs
1170 (defun pr-keep-region-active ()
1171 (setq zmacs-region-stays t))
1173 ;; XEmacs
1174 (defun pr-region-active-p ()
1175 (and pr-auto-region (not zmacs-region-stays) (ps-mark-active-p)))
1177 ;; XEmacs
1178 (defun pr-menu-char-height ()
1179 (font-height (face-font 'default)))
1181 ;; XEmacs
1182 (defun pr-menu-char-width ()
1183 (font-width (face-font 'default)))
1185 ;; XEmacs
1186 (defmacro pr-xemacs-global-menubar (&rest body)
1187 `(save-excursion
1188 (let ((temp (get-buffer-create (make-temp-name " *Temp"))))
1189 ;; be sure to access global menubar
1190 (set-buffer temp)
1191 ,@body
1192 (kill-buffer temp))))
1194 ;; XEmacs
1195 (defun pr-global-menubar (pr-menu-spec)
1196 ;; Menu binding
1197 (pr-xemacs-global-menubar
1198 (add-submenu nil (cons "Printing" pr-menu-spec) "Apps"))
1199 (setq pr-menu-print-item nil))
1201 ;; XEmacs
1202 (defvar current-mouse-event nil)
1203 (defun pr-menu-position (entry index horizontal)
1204 (make-event
1205 'button-release
1206 (list 'button 1
1207 'x (- (event-x-pixel current-mouse-event) ; X
1208 (* horizontal pr-menu-char-width))
1209 'y (- (event-y-pixel current-mouse-event) ; Y
1210 (* (pr-menu-index entry index) pr-menu-char-height)))))
1212 (defvar pr-menu-position nil)
1213 (defvar pr-menu-state nil)
1215 ;; XEmacs
1216 (defvar current-menubar nil) ; to avoid compilation gripes
1217 (defun pr-menu-lookup (path)
1218 (car (find-menu-item current-menubar (cons "Printing" path))))
1220 ;; XEmacs
1221 (defun pr-menu-lock (entry index horizontal state path)
1222 (when pr-menu-lock
1223 (or (and pr-menu-position (eq state pr-menu-state))
1224 (setq pr-menu-position (pr-menu-position entry index horizontal)
1225 pr-menu-state state))
1226 (let* ((menu (pr-menu-lookup path))
1227 (result (get-popup-menu-response menu pr-menu-position)))
1228 (and (misc-user-event-p result)
1229 (funcall (event-function result)
1230 (event-object result))))
1231 (setq pr-menu-position nil)))
1233 ;; XEmacs
1234 (defalias 'pr-update-mode-line 'set-menubar-dirty-flag)
1236 ;; XEmacs
1237 (defvar pr-ps-name-old "PostScript Printers")
1238 (defvar pr-txt-name-old "Text Printers")
1239 (defvar pr-ps-utility-old "PostScript Utility")
1240 (defvar pr-even-or-odd-old "Print All Pages")
1242 ;; XEmacs
1243 (defun pr-do-update-menus (&optional force)
1244 (pr-menu-alist pr-ps-printer-alist
1245 'pr-ps-name
1246 'pr-menu-set-ps-title
1247 '("Printing")
1248 'pr-ps-printer-menu-modified
1249 force
1250 pr-ps-name-old
1251 'postscript 2)
1252 (pr-menu-alist pr-txt-printer-alist
1253 'pr-txt-name
1254 'pr-menu-set-txt-title
1255 '("Printing")
1256 'pr-txt-printer-menu-modified
1257 force
1258 pr-txt-name-old
1259 'text 2)
1260 (let ((save-var pr-ps-utility-menu-modified))
1261 (pr-menu-alist pr-ps-utility-alist
1262 'pr-ps-utility
1263 'pr-menu-set-utility-title
1264 '("Printing" "PostScript Print" "File")
1265 'save-var
1266 force
1267 pr-ps-utility-old
1268 nil 1))
1269 (pr-menu-alist pr-ps-utility-alist
1270 'pr-ps-utility
1271 'pr-menu-set-utility-title
1272 '("Printing" "PostScript Preview" "File")
1273 'pr-ps-utility-menu-modified
1274 force
1275 pr-ps-utility-old
1276 nil 1)
1277 (pr-even-or-odd-pages ps-even-or-odd-pages force))
1279 ;; XEmacs
1280 (defun pr-menu-alist (alist var-sym fun menu-path modified-sym force name
1281 entry index)
1282 (when (and alist (or force (symbol-value modified-sym)))
1283 (pr-xemacs-global-menubar
1284 (add-submenu menu-path
1285 (pr-menu-create name alist var-sym
1286 fun entry index)))
1287 (funcall fun (symbol-value var-sym))
1288 (set modified-sym nil)))
1290 ;; XEmacs
1291 (defun pr-relabel-menu-item (newname var-sym)
1292 (pr-xemacs-global-menubar
1293 (relabel-menu-item
1294 (list "Printing" (symbol-value var-sym))
1295 newname)
1296 (set var-sym newname)))
1298 ;; XEmacs
1299 (defun pr-menu-set-ps-title (value &optional item entry index)
1300 (pr-relabel-menu-item (format "PostScript Printer: %s" value)
1301 'pr-ps-name-old)
1302 (pr-ps-set-printer value)
1303 (and index
1304 (pr-menu-lock entry index 12 'toggle nil)))
1306 ;; XEmacs
1307 (defun pr-menu-set-txt-title (value &optional item entry index)
1308 (pr-relabel-menu-item (format "Text Printer: %s" value)
1309 'pr-txt-name-old)
1310 (pr-txt-set-printer value)
1311 (and index
1312 (pr-menu-lock entry index 12 'toggle nil)))
1314 ;; XEmacs
1315 (defun pr-menu-set-utility-title (value &optional item entry index)
1316 (pr-xemacs-global-menubar
1317 (let ((newname (format "%s" value)))
1318 (relabel-menu-item
1319 (list "Printing" "PostScript Print" "File" pr-ps-utility-old)
1320 newname)
1321 (relabel-menu-item
1322 (list "Printing" "PostScript Preview" "File" pr-ps-utility-old)
1323 newname)
1324 (setq pr-ps-utility-old newname)))
1325 (pr-ps-set-utility value)
1326 (and index
1327 (pr-menu-lock entry index 5 nil '("PostScript Print" "File"))))
1329 ;; XEmacs
1330 (defun pr-even-or-odd-pages (value &optional no-lock)
1331 (pr-relabel-menu-item (cdr (assq value pr-even-or-odd-alist))
1332 'pr-even-or-odd-old)
1333 (setq ps-even-or-odd-pages value)
1334 (or no-lock
1335 (pr-menu-lock 'postscript-options 8 12 'toggle nil)))
1338 (t ; GNU Emacs
1339 ;; Do nothing
1340 )) ; end cond featurep
1344 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1345 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1346 ;; GNU Emacs Definitions
1349 (cond
1350 ((featurep 'xemacs) ; XEmacs
1351 ;; Do nothing
1353 (t ; GNU Emacs
1354 ;; GNU Emacs
1355 (defalias 'pr-set-keymap-parents 'set-keymap-parent)
1356 (defalias 'pr-set-keymap-name 'ignore)
1357 (defalias 'pr-read-string 'read-string)
1359 ;; GNU Emacs
1360 (defvar deactivate-mark)
1362 ;; GNU Emacs
1363 (defun pr-keep-region-active ()
1364 (setq deactivate-mark nil))
1366 ;; GNU Emacs
1367 (defun pr-region-active-p ()
1368 (and pr-auto-region transient-mark-mode mark-active))
1370 ;; GNU Emacs
1371 (defun pr-menu-char-height ()
1372 (frame-char-height))
1374 ;; GNU Emacs
1375 (defun pr-menu-char-width ()
1376 (frame-char-width))
1378 (defvar pr-menu-bar nil
1379 "Specify Printing menu-bar entry.")
1381 ;; GNU Emacs
1382 ;; Menu binding
1383 ;; Replace existing "print" item by "Printing" item.
1384 ;; If you're changing this file, you'll load it a second,
1385 ;; third... time, but "print" item exists only in the first load.
1386 (eval-when-compile
1387 (require 'easymenu)) ; to avoid compilation gripes
1389 (eval-and-compile
1390 (cond
1391 ;; GNU Emacs 20
1392 ((< emacs-major-version 21)
1393 (defun pr-global-menubar (pr-menu-spec)
1394 (require 'easymenu)
1395 (easy-menu-change '("tools") "Printing" pr-menu-spec pr-menu-print-item)
1396 (when pr-menu-print-item
1397 (easy-menu-remove-item nil '("tools") pr-menu-print-item)
1398 (setq pr-menu-print-item nil
1399 pr-menu-bar (vector 'menu-bar 'tools
1400 (pr-get-symbol "Printing")))))
1402 ;; GNU Emacs 21 & 22
1404 (defun pr-global-menubar (pr-menu-spec)
1405 (require 'easymenu)
1406 (let ((menu-file (if (= emacs-major-version 21)
1407 '("menu-bar" "files") ; GNU Emacs 21
1408 '("menu-bar" "file")))) ; GNU Emacs 22 or higher
1409 (cond
1410 (pr-menu-print-item
1411 (easy-menu-add-item global-map menu-file
1412 (easy-menu-create-menu "Print" pr-menu-spec)
1413 "print-buffer")
1414 (dolist (item '("print-buffer" "print-region"
1415 "ps-print-buffer-faces" "ps-print-region-faces"
1416 "ps-print-buffer" "ps-print-region"))
1417 (easy-menu-remove-item global-map menu-file item))
1418 (setq pr-menu-print-item nil
1419 pr-menu-bar (vector 'menu-bar
1420 (pr-get-symbol (nth 1 menu-file))
1421 (pr-get-symbol "Print"))))
1423 (easy-menu-add-item global-map menu-file
1424 (easy-menu-create-menu "Print" pr-menu-spec)))
1428 (eval-and-compile
1429 (cond
1430 (ps-windows-system
1431 ;; GNU Emacs for Windows 9x/NT
1432 (defun pr-menu-position (entry index horizontal)
1433 (let ((pos (cdr (mouse-pixel-position))))
1434 (list
1435 (list (or (car pos) 0) ; X
1436 (- (or (cdr pos) 0) ; Y
1437 (* (pr-menu-index entry index) pr-menu-char-height)))
1438 (selected-frame)))) ; frame
1441 ;; GNU Emacs
1442 (defun pr-menu-position (entry index horizontal)
1443 (let ((pos (cdr (mouse-pixel-position))))
1444 (list
1445 (list (- (or (car pos) 0) ; X
1446 (* horizontal pr-menu-char-width))
1447 (- (or (cdr pos) 0) ; Y
1448 (* (pr-menu-index entry index) pr-menu-char-height)))
1449 (selected-frame)))) ; frame
1452 (defvar pr-menu-position nil)
1453 (defvar pr-menu-state nil)
1455 ;; GNU Emacs
1456 (defun pr-menu-lookup (path)
1457 (lookup-key global-map
1458 (if path
1459 (vconcat pr-menu-bar
1460 (mapcar 'pr-get-symbol
1461 (if (listp path)
1462 path
1463 (list path))))
1464 pr-menu-bar)))
1466 ;; GNU Emacs
1467 (defun pr-menu-lock (entry index horizontal state path)
1468 (when pr-menu-lock
1469 (or (and pr-menu-position (eq state pr-menu-state))
1470 (setq pr-menu-position (pr-menu-position entry index horizontal)
1471 pr-menu-state state))
1472 (let* ((menu (pr-menu-lookup path))
1473 (result (x-popup-menu pr-menu-position menu)))
1474 (and result
1475 (let ((command (lookup-key menu (vconcat result))))
1476 (if (fboundp command)
1477 (funcall command)
1478 (eval command)))))
1479 (setq pr-menu-position nil)))
1481 ;; GNU Emacs
1482 (defalias 'pr-update-mode-line 'force-mode-line-update)
1484 ;; GNU Emacs
1485 (defun pr-do-update-menus (&optional force)
1486 (pr-menu-alist pr-ps-printer-alist
1487 'pr-ps-name
1488 'pr-menu-set-ps-title
1489 "PostScript Printers"
1490 'pr-ps-printer-menu-modified
1491 force
1492 "PostScript Printers"
1493 'postscript 2)
1494 (pr-menu-alist pr-txt-printer-alist
1495 'pr-txt-name
1496 'pr-menu-set-txt-title
1497 "Text Printers"
1498 'pr-txt-printer-menu-modified
1499 force
1500 "Text Printers"
1501 'text 2)
1502 (let ((save-var pr-ps-utility-menu-modified))
1503 (pr-menu-alist pr-ps-utility-alist
1504 'pr-ps-utility
1505 'pr-menu-set-utility-title
1506 '("PostScript Print" "File" "PostScript Utility")
1507 'save-var
1508 force
1509 "PostScript Utility"
1510 nil 1))
1511 (pr-menu-alist pr-ps-utility-alist
1512 'pr-ps-utility
1513 'pr-menu-set-utility-title
1514 '("PostScript Preview" "File" "PostScript Utility")
1515 'pr-ps-utility-menu-modified
1516 force
1517 "PostScript Utility"
1518 nil 1)
1519 (pr-even-or-odd-pages ps-even-or-odd-pages force))
1521 ;; GNU Emacs
1522 (defun pr-menu-get-item (name-list)
1523 ;; NAME-LIST is a string or a list of strings.
1524 (or (listp name-list)
1525 (setq name-list (list name-list)))
1526 (and name-list
1527 (let* ((reversed (reverse name-list))
1528 (name (pr-get-symbol (car reversed)))
1529 (path (nreverse (cdr reversed)))
1530 (menu (lookup-key
1531 global-map
1532 (vconcat pr-menu-bar
1533 (mapcar 'pr-get-symbol path)))))
1534 (assq name (nthcdr 2 menu)))))
1536 ;; GNU Emacs
1537 (defvar pr-temp-menu nil)
1539 ;; GNU Emacs
1540 (defun pr-menu-alist (alist var-sym fun menu-path modified-sym force name
1541 entry index)
1542 (when (and alist (or force (symbol-value modified-sym)))
1543 (easy-menu-define pr-temp-menu nil ""
1544 (pr-menu-create name alist var-sym fun entry index))
1545 (let ((item (pr-menu-get-item menu-path)))
1546 (and item
1547 (let* ((binding (nthcdr 3 item))
1548 (key-binding (cdr binding)))
1549 (setcar binding pr-temp-menu)
1550 (and key-binding (listp (car key-binding))
1551 (setcdr binding (cdr key-binding))) ; skip KEY-BINDING
1552 (funcall fun (symbol-value var-sym) item))))
1553 (set modified-sym nil)))
1555 ;; GNU Emacs
1556 (defun pr-menu-set-item-name (item name)
1557 (and item
1558 (setcar (nthcdr 2 item) name))) ; ITEM-NAME
1560 ;; GNU Emacs
1561 (defun pr-menu-set-ps-title (value &optional item entry index)
1562 (pr-menu-set-item-name (or item
1563 (pr-menu-get-item "PostScript Printers"))
1564 (format "PostScript Printer: %s" value))
1565 (pr-ps-set-printer value)
1566 (and index
1567 (pr-menu-lock entry index 12 'toggle nil)))
1569 ;; GNU Emacs
1570 (defun pr-menu-set-txt-title (value &optional item entry index)
1571 (pr-menu-set-item-name (or item
1572 (pr-menu-get-item "Text Printers"))
1573 (format "Text Printer: %s" value))
1574 (pr-txt-set-printer value)
1575 (and index
1576 (pr-menu-lock entry index 12 'toggle nil)))
1578 ;; GNU Emacs
1579 (defun pr-menu-set-utility-title (value &optional item entry index)
1580 (let ((name (symbol-name value)))
1581 (if item
1582 (pr-menu-set-item-name item name)
1583 (pr-menu-set-item-name
1584 (pr-menu-get-item
1585 '("PostScript Print" "File" "PostScript Utility"))
1586 name)
1587 (pr-menu-set-item-name
1588 (pr-menu-get-item
1589 '("PostScript Preview" "File" "PostScript Utility"))
1590 name)))
1591 (pr-ps-set-utility value)
1592 (and index
1593 (pr-menu-lock entry index 5 nil '("PostScript Print" "File"))))
1595 ;; GNU Emacs
1596 (defun pr-even-or-odd-pages (value &optional no-lock)
1597 (pr-menu-set-item-name (pr-menu-get-item "Print All Pages")
1598 (cdr (assq value pr-even-or-odd-alist)))
1599 (setq ps-even-or-odd-pages value)
1600 (or no-lock
1601 (pr-menu-lock 'postscript-options 8 12 'toggle nil)))
1603 )) ; end cond featurep
1606 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1607 ;; Internal Functions (I)
1610 (defun pr-dosify-file-name (path)
1611 "Replace unix-style directory separator character with dos/windows one."
1612 (interactive "sPath: ")
1613 (if (eq pr-path-style 'windows)
1614 (subst-char-in-string ?/ ?\\ path)
1615 path))
1618 (defun pr-unixify-file-name (path)
1619 "Replace dos/windows-style directory separator character with unix one."
1620 (interactive "sPath: ")
1621 (if (eq pr-path-style 'windows)
1622 (subst-char-in-string ?\\ ?/ path)
1623 path))
1626 (defun pr-standard-file-name (path)
1627 "Ensure the proper directory separator depending on the OS.
1628 That is, if Emacs is running on DOS/Windows, ensure dos/windows-style directory
1629 separator; otherwise, ensure unix-style directory separator."
1630 (if (or pr-cygwin-system ps-windows-system)
1631 (subst-char-in-string ?/ ?\\ path)
1632 (subst-char-in-string ?\\ ?/ path)))
1635 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1636 ;; Customization Functions
1639 (defun pr-alist-custom-set (symbol value)
1640 "Set the value of custom variables for printer & utility selection."
1641 (set symbol value)
1642 (and (featurep 'printing) ; update only after printing is loaded
1643 (pr-update-menus t)))
1646 (defun pr-ps-utility-custom-set (symbol value)
1647 "Update utility menu entry."
1648 (set symbol value)
1649 (and (featurep 'printing) ; update only after printing is loaded
1650 (pr-menu-set-utility-title value)))
1653 (defun pr-ps-name-custom-set (symbol value)
1654 "Update `PostScript Printer:' menu entry."
1655 (set symbol value)
1656 (and (featurep 'printing) ; update only after printing is loaded
1657 (pr-menu-set-ps-title value)))
1660 (defun pr-txt-name-custom-set (symbol value)
1661 "Update `Text Printer:' menu entry."
1662 (set symbol value)
1663 (and (featurep 'printing) ; update only after printing is loaded
1664 (pr-menu-set-txt-title value)))
1667 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1668 ;; User Interface
1671 (defgroup printing nil
1672 "Printing Utilities group."
1673 :tag "Printing Utilities"
1674 :link '(emacs-library-link :tag "Source Lisp File" "printing.el")
1675 :prefix "pr-"
1676 :version "22.1"
1677 :group 'wp
1678 :group 'postscript)
1681 (defcustom pr-path-style
1682 (if (and (not pr-cygwin-system)
1683 ps-windows-system)
1684 'windows
1685 'unix)
1686 "Specify which path style to use for external commands.
1688 Valid values are:
1690 windows Windows 9x/NT style (\\)
1692 unix Unix style (/)"
1693 :type '(choice :tag "Path style"
1694 (const :tag "Windows 9x/NT Style (\\)" :value windows)
1695 (const :tag "Unix Style (/)" :value unix))
1696 :group 'printing)
1699 (defcustom pr-path-alist
1700 '((unix PATH)
1701 (cygwin PATH)
1702 (windows PATH))
1703 "Specify an alist for command paths.
1705 It's used to find commands used for printing package, like gv, gs, gsview.exe,
1706 mpage, print.exe, etc. See also `pr-command' function.
1708 Each element has the form:
1710 (ENTRY DIRECTORY...)
1712 Where:
1714 ENTRY It's a symbol, used to identify this entry.
1715 There must exist at least one of the following entries:
1717 unix this entry is used when Emacs is running on GNU or
1718 Unix system.
1720 cygwin this entry is used when Emacs is running on Windows
1721 95/98/NT/2000 with Cygwin.
1723 windows this entry is used when Emacs is running on Windows
1724 95/98/NT/2000.
1726 DIRECTORY It should be a string or a symbol. If it's a symbol, it should
1727 exist an equal entry in `pr-path-alist'. If it's a string,
1728 it's considered a directory specification.
1730 The directory specification may contain:
1731 $var environment variable expansion
1732 ~/ tilde expansion
1733 ./ current directory
1734 ../ previous directory
1736 For example, let's say the home directory is /home/my and the
1737 current directory is /home/my/dir, so:
1739 THE ENTRY IS EXPANDED TO
1740 ~/entry /home/my/entry
1741 ./entry /home/my/dir/entry
1742 ../entry /home/my/entry
1743 $HOME/entry /home/my/entry
1744 $HOME/~/other/../my/entry /home/my/entry
1746 SPECIAL SYMBOL: If the symbol `PATH' is used in the directory
1747 list and there isn't a `PATH' entry in `pr-path-alist' or the
1748 `PATH' entry has a null directory list, the PATH environment
1749 variable is used.
1751 Examples:
1753 * On GNU or Unix system:
1755 '((unix \".\" \"~/bin\" ghostview mpage PATH)
1756 (ghostview \"$HOME/bin/gsview-dir\")
1757 (mpage \"$HOME/bin/mpage-dir\")
1760 * On Windows system:
1762 '((windows \"c:/applications/executables\" PATH ghostview mpage)
1763 (ghostview \"c:/gs/gsview-dir\")
1764 (mpage \"c:/mpage-dir\")
1766 :type '(repeat
1767 (cons :tag ""
1768 (symbol :tag "Identifier ")
1769 (repeat :tag "Directory List"
1770 (choice :menu-tag "Directory"
1771 :tag "Directory"
1772 (string :value "")
1773 (symbol :value symbol)))))
1774 :group 'printing)
1777 (defcustom pr-txt-name 'default
1778 "Specify a printer for printing a text file.
1780 The printer name symbol should be defined on `pr-txt-printer-alist' (see it for
1781 documentation).
1783 This variable should be modified by customization engine. If this variable is
1784 modified by other means (for example, a lisp function), use `pr-update-menus'
1785 function (see it for documentation) to update text printer menu."
1786 :type 'symbol
1787 :set 'pr-txt-name-custom-set
1788 :group 'printing)
1791 (defcustom pr-txt-printer-alist
1792 (list (list 'default lpr-command nil
1793 (cond ((boundp 'printer-name) printer-name)
1794 (ps-windows-system "PRN")
1795 (t nil)
1797 ;; Examples:
1798 ;; * On GNU or Unix system:
1799 ;; '((prt_06a "lpr" nil "prt_06a")
1800 ;; (prt_07c nil nil "prt_07c")
1801 ;; )
1802 ;; * On Windows system:
1803 ;; '((prt_06a "print" nil "/D:\\\\printers\\prt_06a")
1804 ;; (prt_07c nil nil "/D:\\\\printers\\prt_07c")
1805 ;; (PRN "" nil "PRN")
1806 ;; (standard "redpr.exe" nil "")
1807 ;; )
1808 "Specify an alist of all text printers (text printer database).
1810 The alist element has the form:
1812 (SYMBOL COMMAND SWITCHES NAME)
1814 Where:
1816 SYMBOL It's a symbol to identify a text printer. It's for
1817 `pr-txt-name' variable setting and for menu selection.
1818 Examples:
1819 'prt_06a
1820 'my_printer
1822 COMMAND Name of the program for printing a text file. On MS-DOS and
1823 MS-Windows systems, if the value is an empty string, then Emacs
1824 will write directly to the printer port given by NAME (see text
1825 below), that is, the NAME should be something like \"PRN\" or
1826 \"LPT1:\".
1827 If NAME is something like \"\\\\\\\\host\\\\share-name\" then
1828 COMMAND shouldn't be an empty string.
1829 The programs `print' and `nprint' (the standard print programs
1830 on Windows NT and Novell Netware respectively) are handled
1831 specially, using NAME as the destination for output; any other
1832 program is treated like `lpr' except that an explicit filename
1833 is given as the last argument.
1834 If COMMAND is nil, it's used the default printing program:
1835 `print' for Windows system, `lp' for lp system and `lpr' for
1836 all other systems. See also `pr-path-alist'.
1837 Examples:
1838 \"print\"
1839 \"lpr\"
1840 \"lp\"
1842 SWITCHES List of sexp's to pass as extra options for text printer
1843 program. It is recommended to set NAME (see text below)
1844 instead of including an explicit switch on this list.
1845 Example:
1846 . for lpr
1847 '(\"-#3\" \"-l\")
1850 NAME A string that specifies a text printer name.
1851 On Unix-like systems, a string value should be a name
1852 understood by lpr's -P option (or lp's -d option).
1853 On MS-DOS and MS-Windows systems, it is the name of a printer
1854 device or port. Typical non-default settings would be \"LPT1:\"
1855 to \"LPT3:\" for parallel printers, or \"COM1\" to \"COM4\" or
1856 \"AUX\" for serial printers, or \"\\\\\\\\hostname\\\\printer\"
1857 (or \"/D:\\\\\\\\hostname\\\\printer\") for a shared network
1858 printer. You can also set it to a name of a file, in which
1859 case the output gets appended to that file. If you want to
1860 discard the printed output, set this to \"NUL\".
1861 Examples:
1862 . for print.exe
1863 \"/D:\\\\\\\\host\\\\share-name\"
1864 \"LPT1:\"
1865 \"PRN\"
1867 . for lpr or lp
1868 \"share-name\"
1870 This variable should be modified by customization engine. If this variable is
1871 modified by other means (for example, a lisp function), use `pr-update-menus'
1872 function (see it for documentation) to update text printer menu.
1874 Examples:
1876 * On GNU or Unix system:
1878 '((prt_06a \"lpr\" nil \"prt_06a\")
1879 (prt_07c nil nil \"prt_07c\")
1882 * On Windows system:
1884 '((prt_06a \"print\" nil \"/D:\\\\\\\\printers\\\\prt_06a\")
1885 (prt_07c nil nil \"/D:\\\\\\\\printers\\\\prt_07c\")
1886 (PRN \"\" nil \"PRN\")
1887 (standard \"redpr.exe\" nil \"\")
1890 Useful links:
1892 * Information about the print command (print.exe)
1893 `http://www.computerhope.com/printhlp.htm'
1895 * RedMon - Redirection Port Monitor (redpr.exe)
1896 `http://www.cs.wisc.edu/~ghost/redmon/index.htm'
1898 * Redirection Port Monitor (redpr.exe on-line help)
1899 `http://www.cs.wisc.edu/~ghost/redmon/en/redmon.htm'
1901 * UNIX man pages: lpr (or type `man lpr')
1902 `http://bama.ua.edu/cgi-bin/man-cgi?lpr'
1903 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lpr'
1905 * UNIX man pages: lp (or type `man lp')
1906 `http://bama.ua.edu/cgi-bin/man-cgi?lp'
1907 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lp'
1909 :type '(repeat
1910 (list :tag "Text Printer"
1911 (symbol :tag "Printer Symbol Name")
1912 (string :tag "Printer Command")
1913 (repeat :tag "Printer Switches"
1914 (sexp :tag "Switch" :value ""))
1915 (choice :menu-tag "Printer Name"
1916 :tag "Printer Name"
1917 (const :tag "None" nil)
1918 string)))
1919 :set 'pr-alist-custom-set
1920 :group 'printing)
1923 (defcustom pr-ps-name 'default
1924 "Specify a printer for printing a PostScript file.
1926 This printer name symbol should be defined on `pr-ps-printer-alist' (see it for
1927 documentation).
1929 This variable should be modified by customization engine. If this variable is
1930 modified by other means (for example, a lisp function), use `pr-update-menus'
1931 function (see it for documentation) to update PostScript printer menu."
1932 :type 'symbol
1933 :set 'pr-ps-name-custom-set
1934 :group 'printing)
1937 (defcustom pr-ps-printer-alist
1938 (list (list 'default lpr-command nil
1939 (cond (ps-windows-system nil)
1940 (ps-lp-system "-d")
1941 (t "-P"))
1942 (or (getenv "PRINTER") (getenv "LPDEST") ps-printer-name)))
1943 ;; Examples:
1944 ;; * On GNU or Unix system:
1945 ;; '((lps_06b "lpr" nil "-P" "lps_06b")
1946 ;; (lps_07c "lpr" nil nil "lps_07c")
1947 ;; (lps_08c nil nil nil "lps_08c")
1948 ;; )
1949 ;; * On Windows system:
1950 ;; '((lps_06a "print" nil "/D:" "\\\\printers\\lps_06a")
1951 ;; (lps_06b "print" nil nil "\\\\printers\\lps_06b")
1952 ;; (lps_07c "print" nil "" "/D:\\\\printers\\lps_07c")
1953 ;; (lps_08c nil nil nil "\\\\printers\\lps_08c")
1954 ;; (b/w "gsprint" ("-all" "-twoup") "-printer " "b/w-pr-name")
1955 ;; (LPT1 "" nil "" "LPT1:")
1956 ;; (PRN "" nil "" "PRN")
1957 ;; (standard "redpr.exe" nil "" "")
1958 ;; )
1959 "Specify an alist for all PostScript printers (PostScript printer database).
1961 The alist element has the form:
1963 (SYMBOL COMMAND SWITCHES PRINTER-SWITCH NAME DEFAULT...)
1965 Where:
1967 SYMBOL It's a symbol to identify a PostScript printer. It's for
1968 `pr-ps-name' variable setting and for menu selection.
1969 Examples:
1970 'prt_06a
1971 'my_printer
1973 COMMAND Name of the program for printing a PostScript file. On MS-DOS
1974 and MS-Windows systems, if the value is an empty string then
1975 Emacs will write directly to the printer port given by NAME
1976 (see text below), that is, the NAME should be something like
1977 \"PRN\" or \"LPT1:\".
1978 If NAME is something like \"\\\\\\\\host\\\\share-name\" then
1979 COMMAND shouldn't be an empty string.
1980 The programs `print' and `nprint' (the standard print programs
1981 on Windows NT and Novell Netware respectively) are handled
1982 specially, using NAME as the destination for output; any other
1983 program is treated like `lpr' except that an explicit filename
1984 is given as the last argument.
1985 If COMMAND is nil, it's used the default printing program:
1986 `print' for Windows system, `lp' for lp system and `lpr' for
1987 all other systems. See also `pr-path-alist'.
1988 Examples:
1989 \"print\"
1990 \"lpr\"
1991 \"lp\"
1992 \"cp\"
1993 \"gsprint\"
1995 SWITCHES List of sexp's to pass as extra options for PostScript printer
1996 program. It is recommended to set NAME (see text below)
1997 instead of including an explicit switch on this list.
1998 Example:
1999 . for lpr
2000 '(\"-#3\" \"-l\")
2003 . for gsprint.exe
2004 '(\"-all\" \"-twoup\")
2006 PRINTER-SWITCH A string that specifies PostScript printer name switch. If
2007 it's necessary to have a space between PRINTER-SWITCH and NAME,
2008 it should be inserted at the end of PRINTER-SWITCH string.
2009 If PRINTER-SWITCH is nil, it's used the default printer name
2010 switch: `/D:' for Windows system, `-d' for lp system and `-P'
2011 for all other systems.
2012 Examples:
2013 . for lpr
2014 \"-P \"
2016 . for lp
2017 \"-d \"
2019 . for print.exe
2020 \"/D:\"
2022 . for gsprint.exe
2023 \"-printer \"
2025 NAME A string that specifies a PostScript printer name.
2026 On Unix-like systems, a string value should be a name
2027 understood by lpr's -P option (or lp's -d option).
2028 On MS-DOS and MS-Windows systems, it is the name of a printer
2029 device or port. Typical non-default settings would be \"LPT1:\"
2030 to \"LPT3:\" for parallel printers, or \"COM1\" to \"COM4\" or
2031 \"AUX\" for serial printers, or \"\\\\\\\\hostname\\\\printer\"
2032 (or \"/D:\\\\\\\\hostname\\\\printer\") for a shared network
2033 printer. You can also set it to a name of a file, in which
2034 case the output gets appended to that file. If you want to
2035 discard the printed output, set this to \"NUL\".
2036 Examples:
2037 . for cp.exe
2038 \"\\\\\\\\host\\\\share-name\"
2040 . for print.exe or gsprint.exe
2041 \"/D:\\\\\\\\host\\\\share-name\"
2042 \"\\\\\\\\host\\\\share-name\"
2043 \"LPT1:\"
2044 \"PRN\"
2046 . for lpr or lp
2047 \"share-name\"
2049 DEFAULT It's a way to set default values when this entry is selected.
2050 It's a cons like:
2052 (VARIABLE . VALUE)
2054 Which associates VARIABLE with VALUE. When this entry is
2055 selected, it's executed the following command:
2057 (set VARIABLE (eval VALUE))
2059 Note that VALUE can be any valid lisp expression. So, don't
2060 forget to quote symbols and constant lists.
2061 If VARIABLE is the special keyword `inherits-from:', VALUE must
2062 be a symbol name setting defined in `pr-setting-database' from
2063 which the current setting inherits the context. Take care with
2064 circular inheritance.
2065 Examples:
2066 '(ps-landscape-mode . nil)
2067 '(ps-spool-duplex . t)
2068 '(pr-gs-device . (my-gs-device t))
2070 This variable should be modified by customization engine. If this variable is
2071 modified by other means (for example, a lisp function), use `pr-update-menus'
2072 function (see it for documentation) to update PostScript printer menu.
2074 Examples:
2076 * On GNU or Unix system:
2078 '((lps_06b \"lpr\" nil \"-P\" \"lps_06b\")
2079 (lps_07c \"lpr\" nil nil \"lps_07c\")
2080 (lps_08c nil nil nil \"lps_08c\")
2083 * On Windows system:
2085 '((lps_06a \"print\" nil \"/D:\" \"\\\\\\\\printers\\\\lps_06a\")
2086 (lps_06b \"print\" nil nil \"\\\\\\\\printers\\\\lps_06b\")
2087 (lps_07c \"print\" nil \"\" \"/D:\\\\\\\\printers\\\\lps_07c\")
2088 (lps_08c nil nil nil \"\\\\\\\\printers\\\\lps_08c\")
2089 (b/w1 \"gsprint\" (\"-all\" \"-twoup\") \"-printer \" \"b/w-pr-name\")
2090 (b/w2 \"gsprint\" (\"-all\" \"-twoup\") nil \"-printer \\\\\\\\printers\\\\lps_06a\")
2091 (LPT1 \"\" nil \"\" \"LPT1:\")
2092 (PRN \"\" nil \"\" \"PRN\")
2093 (standard \"redpr.exe\" nil \"\" \"\")
2097 gsprint:
2099 You can use gsprint instead of ghostscript to print monochrome PostScript files
2100 in Windows. The gsprint utility documentation says that it is more efficient
2101 than ghostscript to print monochrome PostScript.
2103 To print non-monochrome PostScript file, the efficiency of ghostscript is
2104 similar to gsprint.
2106 Also the gsprint utility comes together with gsview distribution.
2108 As an example of gsprint declaration:
2110 (setq pr-ps-printer-alist
2111 '((A \"gsprint\" (\"-all\" \"-twoup\") \"-printer \" \"lps_015\")
2112 (B \"gsprint\" (\"-all\" \"-twoup\") nil \"-printer lps_015\")
2113 ;; some other printer declaration
2116 The example above declares that printer A prints all pages (-all) and two pages
2117 per sheet (-twoup). The printer B declaration does the same as the printer A
2118 declaration, the only difference is the printer name selection.
2120 There are other command line options like:
2122 -mono Render in monochrome as 1bit/pixel (only black and white).
2123 -grey Render in greyscale as 8bits/pixel.
2124 -color Render in color as 24bits/pixel.
2126 The default is `-mono'. So, printer A and B in the example above are using
2127 implicitly the `-mono' option. Note that in `-mono' no gray tone or color is
2128 printed, this includes the zebra stripes, that is, in `-mono' the zebra stripes
2129 are not printed.
2132 Useful links:
2134 * GSPRINT - Ghostscript print to Windows printer
2135 `http://www.cs.wisc.edu/~ghost/gsview/gsprint.htm'
2137 * Introduction to Ghostscript
2138 `http://www.cs.wisc.edu/~ghost/doc/intro.htm'
2140 * How to use Ghostscript
2141 `http://www.cs.wisc.edu/~ghost/doc/cvs/Use.htm'
2143 * Information about the print command (print.exe)
2144 `http://www.computerhope.com/printhlp.htm'
2146 * RedMon - Redirection Port Monitor (redpr.exe)
2147 `http://www.cs.wisc.edu/~ghost/redmon/index.htm'
2149 * Redirection Port Monitor (redpr.exe on-line help)
2150 `http://www.cs.wisc.edu/~ghost/redmon/en/redmon.htm'
2152 * UNIX man pages: lpr (or type `man lpr')
2153 `http://bama.ua.edu/cgi-bin/man-cgi?lpr'
2154 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lpr'
2156 * UNIX man pages: lp (or type `man lp')
2157 `http://bama.ua.edu/cgi-bin/man-cgi?lp'
2158 `http://www.mediacollege.com/cgi-bin/man/page.cgi?section=all&topic=lp'
2160 * GNU utilities for Win32 (cp.exe)
2161 `http://unxutils.sourceforge.net/'
2163 :type '(repeat
2164 (list
2165 :tag "PostScript Printer"
2166 (symbol :tag "Printer Symbol Name")
2167 (string :tag "Printer Command")
2168 (repeat :tag "Printer Switches"
2169 (sexp :tag "Switch" :value ""))
2170 (choice :menu-tag "Printer Name Switch"
2171 :tag "Printer Name Switch"
2172 (const :tag "None" nil)
2173 string)
2174 (choice :menu-tag "Printer Name"
2175 :tag "Printer Name"
2176 (const :tag "None" nil)
2177 string)
2178 (repeat
2179 :tag "Default Value List"
2180 :inline t
2181 (cons
2182 :tag ""
2183 (choice
2184 :menu-tag "Variable"
2185 :tag "Variable"
2186 (const :tag "Landscape" ps-landscape-mode)
2187 (const :tag "Print Header" ps-print-header)
2188 (const :tag "Print Header Frame" ps-print-header-frame)
2189 (const :tag "Line Number" ps-line-number)
2190 (const :tag "Zebra Stripes" ps-zebra-stripes)
2191 (const :tag "Duplex" ps-spool-duplex)
2192 (const :tag "Tumble" ps-spool-tumble)
2193 (const :tag "Upside-Down" ps-print-upside-down)
2194 (const :tag "PS File Landscape" pr-file-landscape)
2195 (const :tag "PS File Duplex" pr-file-duplex)
2196 (const :tag "PS File Tumble" pr-file-tumble)
2197 (const :tag "Auto Region" pr-auto-region)
2198 (const :tag "Auto Mode" pr-auto-mode)
2199 (const :tag "Ghostscript Device" pr-gs-device)
2200 (const :tag "Ghostscript Resolution" pr-gs-resolution)
2201 (const :tag "inherits-from:" inherits-from:)
2202 (variable :tag "Other"))
2203 (sexp :tag "Value")))
2205 :set 'pr-alist-custom-set
2206 :group 'printing)
2209 (defcustom pr-temp-dir
2210 (pr-dosify-file-name
2211 (if (boundp 'temporary-file-directory)
2212 (symbol-value 'temporary-file-directory)
2213 ;; hacked from `temporary-file-directory' variable in files.el
2214 (file-name-as-directory
2215 (or (getenv "TMPDIR") (getenv "TMP") (getenv "TEMP")
2216 (cond (ps-windows-system "c:/temp")
2217 (t "/tmp")
2218 )))))
2219 "Specify a directory for temporary files during printing.
2221 See also `pr-ps-temp-file' and `pr-file-modes'."
2222 :type '(directory :tag "Temporary Directory")
2223 :group 'printing)
2226 (defcustom pr-ps-temp-file "prspool-"
2227 "Specify PostScript temporary file name prefix.
2229 See also `pr-temp-dir' and `pr-file-modes'."
2230 :type '(file :tag "PostScript Temporary File Name")
2231 :group 'printing)
2234 ;; It uses 0600 as default instead of (default-file-modes).
2235 ;; So, by default, only the session owner have permission to deal with files
2236 ;; generated by `printing'.
2237 (defcustom pr-file-modes ?\600
2238 "Specify the file permission bits for newly created files.
2240 It should be an integer; only the low 9 bits are used.
2242 See also `pr-temp-dir' and `pr-ps-temp-file'."
2243 :type '(integer :tag "File Permission Bits")
2244 :group 'printing)
2247 (defcustom pr-gv-command
2248 (if ps-windows-system
2249 "gsview32.exe"
2250 "gv")
2251 "Specify path and name of the gsview/gv utility.
2253 See also `pr-path-alist'.
2255 Useful links:
2257 * GNU gv manual
2258 `http://www.gnu.org/software/gv/manual/gv.html'
2260 * GSview Help
2261 `http://www.cs.wisc.edu/~ghost/gsview/gsviewen.htm'
2263 * GSview Help - Common Problems
2264 `http://www.cs.wisc.edu/~ghost/gsview/gsviewen.htm#Common_Problems'
2266 * GSview Readme (compilation & installation)
2267 `http://www.cs.wisc.edu/~ghost/gsview/Readme.htm'
2269 * GSview (main site)
2270 `http://www.cs.wisc.edu/~ghost/gsview/index.htm'
2272 * Ghostscript, Ghostview and GSview
2273 `http://www.cs.wisc.edu/~ghost/'
2275 * Ghostview
2276 `http://www.cs.wisc.edu/~ghost/gv/index.htm'
2278 * gv 3.5, June 1997
2279 `http://www.cs.wisc.edu/~ghost/gv/gv_doc/gv.html'
2281 * MacGSView (MacOS)
2282 `http://www.cs.wisc.edu/~ghost/macos/index.htm'
2284 :type '(string :tag "Ghostview Utility")
2285 :group 'printing)
2288 (defcustom pr-gs-command
2289 (if ps-windows-system
2290 "gswin32.exe"
2291 "gs")
2292 "Specify path and name of the ghostscript utility.
2294 See also `pr-path-alist'.
2296 Useful links:
2298 * Ghostscript, Ghostview and GSview
2299 `http://www.cs.wisc.edu/~ghost/'
2301 * Introduction to Ghostscript
2302 `http://www.cs.wisc.edu/~ghost/doc/intro.htm'
2304 * How to use Ghostscript
2305 `http://www.cs.wisc.edu/~ghost/doc/cvs/Use.htm'
2307 * Printer compatibility
2308 `http://www.cs.wisc.edu/~ghost/doc/printer.htm'
2310 :type '(string :tag "Ghostscript Utility")
2311 :group 'printing)
2314 (defcustom pr-gs-switches
2315 (if ps-windows-system
2316 '("-q -dNOPAUSE -Ic:/gs/gs5.50;c:/gs/gs5.50/fonts")
2317 '("-q -dNOPAUSE -I/usr/share/ghostscript/5.10"))
2318 "Specify ghostscript switches. See the documentation on GS for more info.
2320 It's a list of strings, where each string is one or more ghostscript switches.
2322 A note on the gs switches:
2324 -q quiet
2325 -dNOPAUSE don't wait for user intervention
2326 -Ic:/gs/gs5.50;c:/gs/gs5.50/fonts the directories needed for gs
2327 -c quit it's added at the end to terminate gs
2329 To see ghostscript documentation for more information:
2331 * On GNU or Unix system:
2332 - for full documentation, type: man gs
2333 - for brief documentation, type: gs -h
2335 * On Windows system:
2336 - for full documentation, see in a browser the file
2337 c:/gstools/gs5.50/index.html, that is, the file index.html which is
2338 located in the same directory as gswin32.exe.
2339 - for brief documentation, type: gswin32.exe -h
2341 Useful links:
2343 * Introduction to Ghostscript
2344 `http://www.cs.wisc.edu/~ghost/doc/intro.htm'
2346 * How to use Ghostscript
2347 `http://www.cs.wisc.edu/~ghost/doc/cvs/Use.htm'
2349 * Printer compatibility
2350 `http://www.cs.wisc.edu/~ghost/doc/printer.htm'
2352 :type '(repeat (string :tag "Ghostscript Switch"))
2353 :group 'printing)
2356 (defcustom pr-gs-device
2357 (if ps-windows-system
2358 "mswinpr2"
2359 "uniprint")
2360 "Specify the ghostscript device switch value (-sDEVICE=).
2362 A note on the gs switches:
2364 -sDEVICE=djet500 the printer - works with HP DeskJet 540
2366 See `pr-gs-switches' for documentation.
2367 See also `pr-ps-printer-alist'."
2368 :type '(string :tag "Ghostscript Device")
2369 :group 'printing)
2372 (defcustom pr-gs-resolution 300
2373 "Specify ghostscript resolution switch value (-r).
2375 A note on the gs switches:
2377 -r300 resolution 300x300
2379 See `pr-gs-switches' for documentation.
2380 See also `pr-ps-printer-alist'."
2381 :type '(integer :tag "Ghostscript Resolution")
2382 :group 'printing)
2385 (defcustom pr-print-using-ghostscript nil
2386 "Non-nil means print using ghostscript.
2388 This is useful if you don't have a PostScript printer, so you could use the
2389 ghostscript to print a PostScript file.
2391 In GNU or Unix system, if ghostscript is set as a PostScript filter, this
2392 variable should be nil."
2393 :type 'boolean
2394 :group 'printing)
2397 (defcustom pr-faces-p nil
2398 "Non-nil means print with face attributes."
2399 :type 'boolean
2400 :group 'printing)
2403 (defcustom pr-spool-p nil
2404 "Non-nil means spool printing in a buffer."
2405 :type 'boolean
2406 :group 'printing)
2409 (defcustom pr-file-landscape nil
2410 "Non-nil means print PostScript file in landscape orientation."
2411 :type 'boolean
2412 :group 'printing)
2415 (defcustom pr-file-duplex nil
2416 "Non-nil means print PostScript file in duplex mode."
2417 :type 'boolean
2418 :group 'printing)
2421 (defcustom pr-file-tumble nil
2422 "Non-nil means print PostScript file in tumble mode.
2424 If tumble is off, produces a printing suitable for binding on the left or
2425 right.
2426 If tumble is on, produces a printing suitable for binding at the top or
2427 bottom."
2428 :type 'boolean
2429 :group 'printing)
2432 (defcustom pr-auto-region t
2433 "Non-nil means region is automagically detected.
2435 Note that this will only work if you're using transient mark mode.
2437 When this variable is non-nil, the `*-buffer*' commands will behave like
2438 `*-region*' commands, that is, `*-buffer*' commands will print only the region
2439 marked instead of all buffer."
2440 :type 'boolean
2441 :group 'printing)
2444 (defcustom pr-auto-mode t
2445 "Non-nil means major-mode specific printing is prefered over normal printing.
2447 That is, if current major-mode is declared in `pr-mode-alist', the `*-buffer*'
2448 and `*-region*' commands will behave like `*-mode*' commands; otherwise,
2449 `*-buffer*' commands will print the current buffer and `*-region*' commands
2450 will print the current region."
2451 :type 'boolean
2452 :group 'printing)
2455 (defcustom pr-mode-alist
2456 '((mh-folder-mode ; mh summary buffer
2457 pr-mh-lpr-1 pr-mh-print-1
2459 (ps-article-author ps-article-subject)
2460 ("/pagenumberstring load" pr-article-date)
2463 (mh-letter-mode ; mh letter buffer
2464 pr-mh-lpr-2 pr-mh-print-2
2466 (ps-article-author ps-article-subject)
2467 ("/pagenumberstring load" pr-article-date)
2470 (rmail-summary-mode ; rmail summary buffer
2471 pr-rmail-lpr pr-rmail-print
2473 (ps-article-subject ps-article-author buffer-name)
2477 (rmail-mode ; rmail buffer
2478 pr-rmail-lpr pr-rmail-print
2480 (ps-article-subject ps-article-author buffer-name)
2484 (gnus-summary-mode ; gnus summary buffer
2485 pr-gnus-lpr pr-gnus-print
2487 (ps-article-subject ps-article-author gnus-newsgroup-name)
2491 (gnus-article-mode ; gnus article buffer
2492 pr-gnus-lpr pr-gnus-print
2494 (ps-article-subject ps-article-author gnus-newsgroup-name)
2498 (Info-mode ; Info buffer
2499 pr-mode-lpr pr-mode-print
2501 (ps-info-node ps-info-file)
2505 (vm-mode ; vm mode
2506 pr-vm-lpr pr-vm-print
2508 (ps-article-subject ps-article-author buffer-name)
2513 "Specify an alist for a major-mode and printing functions.
2515 To customize a major mode printing, just declare the customization in
2516 `pr-mode-alist' and invoke some of `*-mode*' commands. An example for major
2517 mode usage is when you're using gnus (or mh, or rmail, etc.) and you're in the
2518 *Summary* buffer, if you forget to switch to the *Article* buffer before
2519 printing, you'll get a nicely formatted list of article subjects shows up at
2520 the printer. With major mode printing you don't need to switch from gnus
2521 *Summary* buffer first.
2523 The elements have the following form:
2525 (MAJOR-MODE
2526 LPR-PRINT PS-PRINT
2527 HEADER-LINES
2528 LEFT-HEADER
2529 RIGHT-HEADER
2530 KILL-LOCAL-VARIABLE
2531 DEFAULT...)
2533 Where:
2535 MAJOR-MODE It's the major mode symbol.
2537 LPR-PRINT It's a symbol function for text printing. It's invoked with
2538 one argument:
2539 (HEADER-LINES LEFT-HEADER RIGHT-HEADER DEFAULT...).
2541 Usually LPR-PRINT function prepares the environment or buffer
2542 and then call the function `pr-mode-lpr' which it's used to
2543 process the buffer and send it to text printer.
2545 The `pr-mode-lpr' definition is:
2547 (pr-mode-lpr HEADER-LIST &optional FROM TO)
2549 Where HEADER-LIST is like the argument passed to LPR-PRINT.
2550 FROM and TO are the beginning and end markers, respectively,
2551 for a region. If FROM is nil, it's used (point-min); if TO is
2552 nil, it's used (point-max).
2554 PS-PRINT It's a symbol function for PostScript printing. It's invoked
2555 with 3 arguments: n-up printing, file name and the list:
2556 (HEADER-LINES LEFT-HEADER RIGHT-HEADER DEFAULT...).
2558 Usually PS-PRINT function prepares the environment or buffer
2559 and then call the function `pr-mode-print' which it's used to
2560 process the buffer and send it to PostScript printer.
2562 The `pr-mode-print' definition is:
2564 (pr-mode-print N-UP FILENAME HEADER-LIST &optional FROM TO)
2566 Where N-UP, FILENAME and HEADER-LIST are like the arguments
2567 passed to PS-PRINT. FROM and TO are the beginning and end
2568 markers, respectively, for a region. If TO is nil, it's used
2569 (point-max).
2571 HEADER-LINES It's the number of header lines; if is nil, it uses
2572 `ps-header-lines' value.
2574 LEFT-HEADER It's the left header part, it's a list of string, variable
2575 symbol or function symbol (with no argument); if is nil, it
2576 uses `ps-left-header' value.
2578 RIGHT-HEADER It's the right header part, it's a list of string, variable
2579 symbol or function symbol (with no argument); if is nil, it
2580 uses `ps-right-header' value.
2582 KILL-LOCAL-VARIABLE
2583 Non-nil means to kill all buffer local variable declared in
2584 DEFAULT (see below).
2586 DEFAULT It's a way to set default values when this entry is selected.
2587 It's a cons like:
2589 (VARIABLE-SYM . VALUE)
2591 Which associates VARIABLE-SYM with VALUE. When this entry is
2592 selected, it's executed the following command:
2594 (set (make-local-variable VARIABLE-SYM) (eval VALUE))
2596 Note that VALUE can be any valid lisp expression. So, don't
2597 forget to quote symbols and constant lists.
2598 If VARIABLE is the special keyword `inherits-from:', VALUE must
2599 be a symbol name setting defined in `pr-setting-database' from
2600 which the current setting inherits the context. Take care with
2601 circular inheritance.
2602 Examples:
2603 '(ps-landscape-mode . nil)
2604 '(ps-spool-duplex . t)
2605 '(pr-gs-device . (my-gs-device t))"
2606 :type '(repeat
2607 (list
2608 :tag ""
2609 (symbol :tag "Major Mode")
2610 (function :tag "Text Printing Function")
2611 (function :tag "PS Printing Function")
2612 (choice :menu-tag "Number of Header Lines"
2613 :tag "Number of Header Lines"
2614 (integer :tag "Number")
2615 (const :tag "Default Number" nil))
2616 (repeat :tag "Left Header List"
2617 (choice :menu-tag "Left Header"
2618 :tag "Left Header"
2619 string symbol))
2620 (repeat :tag "Right Header List"
2621 (choice :menu-tag "Right Header"
2622 :tag "Right Header"
2623 string symbol))
2624 (boolean :tag "Kill Local Variable At End")
2625 (repeat
2626 :tag "Default Value List"
2627 :inline t
2628 (cons
2629 :tag ""
2630 (choice
2631 :menu-tag "Variable"
2632 :tag "Variable"
2633 (const :tag "Landscape" ps-landscape-mode)
2634 (const :tag "Print Header" ps-print-header)
2635 (const :tag "Print Header Frame" ps-print-header-frame)
2636 (const :tag "Line Number" ps-line-number)
2637 (const :tag "Zebra Stripes" ps-zebra-stripes)
2638 (const :tag "Duplex" ps-spool-duplex)
2639 (const :tag "Tumble" ps-spool-tumble)
2640 (const :tag "Upside-Down" ps-print-upside-down)
2641 (const :tag "PS File Landscape" pr-file-landscape)
2642 (const :tag "PS File Duplex" pr-file-duplex)
2643 (const :tag "PS File Tumble" pr-file-tumble)
2644 (const :tag "Auto Region" pr-auto-region)
2645 (const :tag "Auto Mode" pr-auto-mode)
2646 (const :tag "Ghostscript Device" pr-gs-device)
2647 (const :tag "Ghostscript Resolution" pr-gs-resolution)
2648 (const :tag "inherits-from:" inherits-from:)
2649 (variable :tag "Other"))
2650 (sexp :tag "Value")))
2652 :group 'printing)
2655 (defcustom pr-ps-utility 'mpage
2656 "Specify PostScript utility symbol.
2658 This utility symbol should be defined on `pr-ps-utility-alist' (see it for
2659 documentation).
2661 This variable should be modified by customization engine. If this variable is
2662 modified by other means (for example, a lisp function), use `pr-update-menus'
2663 function (see it for documentation) to update PostScript utility menu.
2665 NOTE: Don't forget to download and install the utilities declared on
2666 `pr-ps-utility-alist'."
2667 :type '(symbol :tag "PS File Utility")
2668 :set 'pr-ps-utility-custom-set
2669 :group 'printing)
2672 (defcustom pr-ps-utility-alist
2673 '((mpage "mpage" nil "-b%s" "-%d" "-l" "-t" "-T" ">" nil)
2674 (psnup "psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
2675 (inherits-from: . no-duplex))
2677 ;; Examples:
2678 ;; * On GNU or Unix system:
2679 ;; '((mpage "mpage" nil "-b%s" "-%d" "-l" "-t" "-T" ">" nil)
2680 ;; (psnup "psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
2681 ;; (pr-file-duplex . nil) (pr-file-tumble . nil))
2682 ;; )
2683 ;; * On Windows system:
2684 ;; '((psnup "c:/psutils/psnup" ("-q") "-P%s" "-%d" "-l" nil nil " " nil
2685 ;; (pr-file-duplex . nil) (pr-file-tumble . nil))
2686 ;; )
2687 "Specify an alist for PostScript utility processing (PS utility database).
2689 The alist element has the form:
2691 (SYMBOL UTILITY MUST-SWITCHES PAPERSIZE N-UP LANDSCAPE DUPLEX TUMBLE OUTPUT
2692 SWITCHES DEFAULT...)
2694 Where:
2696 SYMBOL It's a symbol to identify a PostScript utility. It's for
2697 `pr-ps-utility' variable setting and for menu selection.
2698 Examples:
2699 'mpage
2700 'psnup
2702 UTILITY Name of utility for processing a PostScript file.
2703 See also `pr-path-alist'.
2704 Examples:
2705 . for GNU or Unix system:
2706 \"mpage\"
2707 \"psnup -q\"
2709 . for Windows system:
2710 \"c:/psutils/psnup -q\"
2712 MUST-SWITCHES List of sexp's to pass as options to the PostScript utility
2713 program. These options are necessary to process the utility
2714 program and must be placed before any other switches.
2715 Example:
2716 . for psnup:
2717 '(\"-q\")
2719 PAPERSIZE It's a format string to specify paper size switch.
2720 Example:
2721 . for mpage
2722 \"-b%s\"
2724 N-UP It's a format string to specify n-up switch.
2725 Example:
2726 . for psnup
2727 \"-%d\"
2729 LANDSCAPE It's a string to specify landscape switch. If the utility
2730 doesn't have landscape switch, set to nil.
2731 Example:
2732 . for psnup
2733 \"-l\"
2735 DUPLEX It's a string to specify duplex switch. If the utility doesn't
2736 have duplex switch, set to nil.
2737 Example:
2738 . for psnup
2741 TUMBLE It's a string to specify tumble switch. If the utility doesn't
2742 have tumble switch, set to nil.
2743 Example:
2744 . for psnup
2747 OUTPUT It's a string to specify how to generate an output file. Some
2748 utilities accept an output file option, but some others need
2749 output redirection or some other way to specify an output file.
2750 Example:
2751 . for psnup
2752 \" \" ; psnup ... input output
2754 . for mpage
2755 \">\" ; mpage ... input > output
2757 SWITCHES List of sexp's to pass as extra options to the PostScript utility
2758 program.
2759 Example:
2760 . for psnup
2761 '(\"-q\")
2764 DEFAULT It's a way to set default values when this entry is selected.
2765 It's a cons like:
2767 (VARIABLE . VALUE)
2769 Which associates VARIABLE with VALUE. When this entry is
2770 selected, it's executed the following command:
2772 (set VARIABLE (eval VALUE))
2774 Note that VALUE can be any valid lisp expression. So, don't
2775 forget to quote symbols and constant lists.
2776 If VARIABLE is the special keyword `inherits-from:', VALUE must
2777 be a symbol name setting defined in `pr-setting-database' from
2778 which the current setting inherits the context. Take care with
2779 circular inheritance.
2780 Examples:
2781 '(pr-file-landscape . nil)
2782 '(pr-file-duplex . t)
2783 '(pr-gs-device . (my-gs-device t))
2785 This variable should be modified by customization engine. If this variable is
2786 modified by other means (for example, a lisp function), use `pr-update-menus'
2787 function (see it for documentation) to update PostScript utility menu.
2789 NOTE: Don't forget to download and install the utilities declared on
2790 `pr-ps-utility-alist'.
2792 Examples:
2794 * On GNU or Unix system:
2796 '((mpage \"mpage\" nil \"-b%s\" \"-%d\" \"-l\" \"-t\" \"-T\" \">\" nil)
2797 (psnup \"psnup\" (\"-q\") \"-P%s\" \"-%d\" \"-l\" nil nil \" \" nil
2798 (pr-file-duplex . nil) (pr-file-tumble . nil))
2801 * On Windows system:
2803 '((psnup \"c:/psutils/psnup\" (\"-q\") \"-P%s\" \"-%d\" \"-l\" nil nil \" \"
2804 nil (pr-file-duplex . nil) (pr-file-tumble . nil))
2807 Useful links:
2809 * mpage download (GNU or Unix)
2810 `http://www.mesa.nl/pub/mpage/'
2812 * mpage documentation (GNU or Unix - or type `man mpage')
2813 `http://www.cs.umd.edu/faq/guides/manual_unix/node48.html'
2814 `http://www.rt.com/man/mpage.1.html'
2816 * psnup (Windows, GNU or Unix)
2817 `http://www.knackered.org/angus/psutils/'
2818 `http://gershwin.ens.fr/vdaniel/Doc-Locale/Outils-Gnu-Linux/PsUtils/'
2820 * psnup (PsUtils for Windows)
2821 `http://gnuwin32.sourceforge.net/packages/psutils.htm'
2823 * psnup documentation (GNU or Unix - or type `man psnup')
2824 `http://linux.about.com/library/cmd/blcmdl1_psnup.htm'
2825 `http://amath.colorado.edu/computing/software/man/psnup.html'
2827 * GNU Enscript (Windows, GNU or Unix)
2828 `http://people.ssh.com/mtr/genscript/'
2830 * GNU Enscript documentation (Windows, GNU or Unix)
2831 `http://people.ssh.com/mtr/genscript/enscript.man.html'
2832 (on GNU or Unix, type `man enscript')
2834 :type '(repeat
2835 (list :tag "PS File Utility"
2836 (symbol :tag "Utility Symbol")
2837 (string :tag "Utility Name")
2838 (repeat :tag "Must Utility Switches"
2839 (sexp :tag "Switch" :value ""))
2840 (choice :menu-tag "Paper Size"
2841 :tag "Paper Size"
2842 (const :tag "No Paper Size" nil)
2843 (string :tag "Paper Size Format"))
2844 (choice :menu-tag "N-Up"
2845 :tag "N-Up"
2846 (const :tag "No N-Up" nil)
2847 (string :tag "N-Up Format"))
2848 (choice :menu-tag "Landscape"
2849 :tag "Landscape"
2850 (const :tag "No Landscape" nil)
2851 (string :tag "Landscape Switch"))
2852 (choice :menu-tag "Duplex"
2853 :tag "Duplex"
2854 (const :tag "No Duplex" nil)
2855 (string :tag "Duplex Switch"))
2856 (choice :menu-tag "Tumble"
2857 :tag "Tumble"
2858 (const :tag "No Tumble" nil)
2859 (string :tag "Tumble Switch"))
2860 (string :tag "Output Separator")
2861 (repeat :tag "Utility Switches"
2862 (sexp :tag "Switch" :value ""))
2863 (repeat
2864 :tag "Default Value List"
2865 :inline t
2866 (cons
2867 :tag ""
2868 (choice
2869 :menu-tag "Variable"
2870 :tag "Variable"
2871 (const :tag "PS File Landscape" pr-file-landscape)
2872 (const :tag "PS File Duplex" pr-file-duplex)
2873 (const :tag "PS File Tumble" pr-file-tumble)
2874 (const :tag "Ghostscript Device" pr-gs-device)
2875 (const :tag "Ghostscript Resolution" pr-gs-resolution)
2876 (const :tag "inherits-from:" inherits-from:)
2877 (variable :tag "Other"))
2878 (sexp :tag "Value")))
2880 :set 'pr-alist-custom-set
2881 :group 'printing)
2884 (defcustom pr-menu-lock t
2885 "Non-nil means menu is locked while selecting toggle options.
2887 See also `pr-menu-char-height' and `pr-menu-char-width'."
2888 :type 'boolean
2889 :group 'printing)
2892 (defcustom pr-menu-char-height (pr-menu-char-height)
2893 "Specify menu char height in pixels.
2895 This variable is used to guess which vertical position should be locked the
2896 menu, so don't forget to adjust it if menu position is not ok.
2898 See also `pr-menu-lock' and `pr-menu-char-width'."
2899 :type 'integer
2900 :group 'printing)
2903 (defcustom pr-menu-char-width (pr-menu-char-width)
2904 "Specify menu char width in pixels.
2906 This variable is used to guess which horizontal position should be locked the
2907 menu, so don't forget to adjust it if menu position is not ok.
2909 See also `pr-menu-lock' and `pr-menu-char-height'."
2910 :type 'integer
2911 :group 'printing)
2914 (defcustom pr-setting-database
2915 '((no-duplex ; setting symbol name
2916 nil nil nil ; inherits local kill-local
2917 (pr-file-duplex . nil) ; settings
2918 (pr-file-tumble . nil))
2920 "Specify an alist for settings in general.
2922 The elements have the following form:
2924 (SYMBOL INHERITS LOCAL KILL-LOCAL SETTING...)
2926 Where:
2928 SYMBOL It's a symbol to identify the setting group.
2930 INHERITS Specify the inheritance for SYMBOL group. It's a symbol name
2931 setting from which the current setting inherits the context.
2932 If INHERITS is nil, means that there is no inheritance.
2933 This is a simple inheritance mechanism.
2935 Let's see an example to illustrate the inheritance mechanism:
2937 (setq pr-setting-database
2938 '((no-duplex ; setting symbol name
2939 nil ; inherits
2940 nil nil ; local kill-local
2941 (pr-file-duplex . nil) ; settings
2942 (pr-file-tumble . nil)
2944 (no-duplex-and-landscape ; setting symbol name
2945 no-duplex ; inherits
2946 nil nil ; local kill-local
2947 (pr-file-landscape . nil) ; settings
2950 The example above has two setting groups: no-duplex and
2951 no-duplex-and-landscape. When setting no-duplex is activated
2952 through `inherits-from:' (see `pr-ps-utility', `pr-mode-alist'
2953 and `pr-ps-printer-alist'), the variables pr-file-duplex and
2954 pr-file-tumble are both set to nil.
2956 Now when setting no-duplex-and-landscape is activated through
2957 `inherits-from:', the variable pr-file-landscape is set to nil
2958 and also the settings for no-duplex are done, because
2959 no-duplex-and-landscape inherits settings from no-duplex.
2961 Take care with circular inheritance. It's an error if circular
2962 inheritance happens.
2964 LOCAL Non-nil means that all settings for SYMBOL group will be
2965 declared local buffer.
2967 KILL-LOCAL Non-nil means that all settings for SYMBOL group will be
2968 killed at end. It has effect only when LOCAL is non-nil.
2970 SETTING It's a cons like:
2972 (VARIABLE . VALUE)
2974 Which associates VARIABLE with VALUE. When this entry is
2975 selected, it's executed the following command:
2977 * If LOCAL is non-nil:
2978 (set (make-local-variable VARIABLE) (eval VALUE))
2980 * If LOCAL is nil:
2981 (set VARIABLE (eval VALUE))
2983 Note that VALUE can be any valid lisp expression. So, don't
2984 forget to quote symbols and constant lists.
2985 This setting is ignored if VARIABLE is equal to keyword
2986 `inherits-from:'.
2987 Examples:
2988 '(ps-landscape-mode . nil)
2989 '(ps-spool-duplex . t)
2990 '(pr-gs-device . (my-gs-device t))"
2991 :type '(repeat
2992 (list
2993 :tag ""
2994 (symbol :tag "Setting Name")
2995 (choice :menu-tag "Inheritance"
2996 :tag "Inheritance"
2997 (const :tag "No Inheritance" nil)
2998 (symbol :tag "Inherits From"))
2999 (boolean :tag "Local Buffer Setting")
3000 (boolean :tag "Kill Local Variable At End")
3001 (repeat
3002 :tag "Setting List"
3003 :inline t
3004 (cons
3005 :tag ""
3006 (choice
3007 :menu-tag "Variable"
3008 :tag "Variable"
3009 (const :tag "Landscape" ps-landscape-mode)
3010 (const :tag "Print Header" ps-print-header)
3011 (const :tag "Print Header Frame" ps-print-header-frame)
3012 (const :tag "Line Number" ps-line-number)
3013 (const :tag "Zebra Stripes" ps-zebra-stripes)
3014 (const :tag "Duplex" ps-spool-duplex)
3015 (const :tag "Tumble" ps-spool-tumble)
3016 (const :tag "Upside-Down" ps-print-upside-down)
3017 (const :tag "PS File Landscape" pr-file-landscape)
3018 (const :tag "PS File Duplex" pr-file-duplex)
3019 (const :tag "PS File Tumble" pr-file-tumble)
3020 (const :tag "Auto Region" pr-auto-region)
3021 (const :tag "Auto Mode" pr-auto-mode)
3022 (const :tag "Ghostscript Device" pr-gs-device)
3023 (const :tag "Ghostscript Resolution" pr-gs-resolution)
3024 (variable :tag "Other"))
3025 (sexp :tag "Value")))
3027 :group 'printing)
3030 (defcustom pr-visible-entry-list
3031 '(postscript text postscript-options postscript-process printing help)
3032 "Specify a list of Printing menu visible entries.
3034 Valid values with the corresponding menu parts are:
3036 +------------------------------+
3037 | Printing Interface |
3038 +------------------------------+
3039 `postscript' | PostScript Preview >|
3040 | PostScript Print >|
3041 | PostScript Printer: name >|
3042 +------------------------------+
3043 `text' | Printify >|
3044 | Print >|
3045 | Text Printer: name >|
3046 +------------------------------+
3047 `postscript-options' |[ ] Landscape |
3048 |[ ] Print Header |
3049 |[ ] Print Header Frame |
3050 |[ ] Line Number |
3051 |[ ] Zebra Stripes |
3052 |[ ] Duplex |
3053 |[ ] Tumble |
3054 |[ ] Upside-Down |
3055 | Print All Pages >|
3056 +------------------------------+
3057 `postscript-process' |[ ] Spool Buffer |
3058 |[ ] Print with faces |
3059 |[ ] Print via Ghostscript |
3060 +------------------------------+
3061 `printing' |[ ] Auto Region |
3062 |[ ] Auto Mode |
3063 |[ ] Menu Lock |
3064 +------------------------------+
3065 `help' | Customize >|
3066 | Show Settings >|
3067 | Help |
3068 +------------------------------+
3070 Any other value is ignored."
3071 :type '(repeat :tag "Menu Visible Part"
3072 (choice :menu-tag "Menu Part"
3073 :tag "Menu Part"
3074 (const postscript)
3075 (const text)
3076 (const postscript-options)
3077 (const postscript-process)
3078 (const printing)
3079 (const help)))
3080 :group 'printing)
3083 (defcustom pr-delete-temp-file t
3084 "Non-nil means delete temporary files.
3086 Set `pr-delete-temp-file' to nil, if the following message (or a similar)
3087 happens when printing:
3089 Error: could not open \"c:\\temp\\prspool.ps\" for reading."
3090 :type 'boolean
3091 :group 'printing)
3094 (defcustom pr-list-directory nil
3095 "Non-nil means list directory when processing a directory.
3097 That is, any subdirectories (and the superdirectory) of the directory (given as
3098 argument of functions below) are also printed (as dired-mode listings).
3100 It's used by `pr-ps-directory-preview', `pr-ps-directory-using-ghostscript',
3101 `pr-ps-directory-print', `pr-ps-directory-ps-print', `pr-printify-directory'
3102 and `pr-txt-directory'."
3103 :type 'boolean
3104 :group 'printing)
3107 (defcustom pr-buffer-name "*Printing Interface*"
3108 "Specify the name of the buffer interface for printing package.
3110 It's used by `pr-interface'."
3111 :type 'string
3112 :group 'printing)
3115 (defcustom pr-buffer-name-ignore
3116 (list (regexp-quote pr-buffer-name) ; ignore printing interface buffer
3117 "^ .*$") ; ignore invisible buffers
3118 "Specify a regexp list for buffer names to be ignored in interface buffer.
3120 NOTE: Case is important for matching, that is, `case-fold-search' is always
3121 nil.
3123 It's used by `pr-interface'."
3124 :type '(repeat (regexp :tag "Buffer Name Regexp"))
3125 :group 'printing)
3128 (defcustom pr-buffer-verbose t
3129 "Non-nil means to be verbose when editing a field in interface buffer.
3131 It's used by `pr-interface'."
3132 :type 'boolean
3133 :group 'printing)
3136 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3137 ;; Internal Variables
3140 (defvar pr-txt-command nil
3141 "Name of program for printing a text file.
3142 See `pr-txt-printer-alist'.")
3145 (defvar pr-txt-switches nil
3146 "List of sexp's to pass as extra options to the text printer program.
3147 See `pr-txt-printer-alist'.")
3150 (defvar pr-txt-printer nil
3151 "Specify text printer name.
3152 See `pr-txt-printer-alist'.")
3155 (defvar pr-ps-command nil
3156 "Name of program for printing a PostScript file.
3157 See `pr-ps-printer-alist'.")
3160 (defvar pr-ps-switches nil
3161 "List of sexp's to pass as extra options to the PostScript printer program.
3162 See `pr-ps-printer-alist'.")
3165 (defvar pr-ps-printer-switch nil
3166 "Specify PostScript printer name switch.
3167 See `pr-ps-printer-alist'.")
3170 (defvar pr-ps-printer nil
3171 "Specify PostScript printer name.
3172 See `pr-ps-printer-alist'.")
3175 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3176 ;; Macros
3179 (defmacro pr-save-file-modes (&rest body)
3180 "Set temporally file modes to `pr-file-modes'."
3181 `(let ((pr--default-file-modes (default-file-modes))) ; save default
3182 (set-default-file-modes pr-file-modes)
3183 ,@body
3184 (set-default-file-modes pr--default-file-modes))) ; restore default
3187 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3188 ;; Keys & Menus
3191 (defsubst pr-visible-p (key)
3192 (memq key pr-visible-entry-list))
3195 (defsubst pr-mode-alist-p ()
3196 (cdr (assq major-mode pr-mode-alist)))
3199 (defsubst pr-auto-mode-p ()
3200 (and pr-auto-mode (pr-mode-alist-p)))
3203 (defsubst pr-using-ghostscript-p ()
3204 (and pr-print-using-ghostscript (not pr-spool-p)))
3207 (defalias 'pr-get-symbol
3208 (if (fboundp 'easy-menu-intern) ; hacked from easymenu.el
3209 'easy-menu-intern
3210 (lambda (s) (if (stringp s) (intern s) s))))
3213 (defconst pr-menu-spec
3214 ;; Menu mapping:
3215 ;; unfortunately XEmacs doesn't support :active for submenus,
3216 ;; only for items.
3217 ;; So, it uses :included instead of :active.
3218 ;; Also, XEmacs doesn't support :help tag.
3219 (let ((pr-:active (if (featurep 'xemacs)
3220 :included ; XEmacs
3221 :active)) ; GNU Emacs
3222 (pr-:help (if (featurep 'xemacs)
3223 'ignore ; XEmacs
3224 #'(lambda (text) (list :help text))))) ; GNU Emacs
3226 ["Printing Interface" pr-interface
3227 ,@(funcall
3228 pr-:help "Use buffer interface instead of menu interface")]
3229 "--"
3230 ("PostScript Preview" :included (pr-visible-p 'postscript)
3231 ,@(funcall
3232 pr-:help "Preview PostScript instead of sending to printer")
3233 ("Directory" ,pr-:active (not pr-spool-p)
3234 ["1-up" (pr-ps-directory-preview 1 nil nil t) t]
3235 ["2-up" (pr-ps-directory-preview 2 nil nil t) t]
3236 ["4-up" (pr-ps-directory-preview 4 nil nil t) t]
3237 ["Other..." (pr-ps-directory-preview nil nil nil t)
3238 :keys "\\[pr-ps-buffer-preview]"])
3239 ("Buffer" ,pr-:active (not pr-spool-p)
3240 ["1-up" (pr-ps-buffer-preview 1 t) t]
3241 ["2-up" (pr-ps-buffer-preview 2 t) t]
3242 ["4-up" (pr-ps-buffer-preview 4 t) t]
3243 ["Other..." (pr-ps-buffer-preview nil t)
3244 :keys "\\[pr-ps-buffer-preview]"])
3245 ("Region" ,pr-:active (and (not pr-spool-p) (ps-mark-active-p))
3246 ["1-up" (pr-ps-region-preview 1 t) t]
3247 ["2-up" (pr-ps-region-preview 2 t) t]
3248 ["4-up" (pr-ps-region-preview 4 t) t]
3249 ["Other..." (pr-ps-region-preview nil t)
3250 :keys "\\[pr-ps-region-preview]"])
3251 ("Mode" ,pr-:active (and (not pr-spool-p) (pr-mode-alist-p))
3252 ["1-up" (pr-ps-mode-preview 1 t) t]
3253 ["2-up" (pr-ps-mode-preview 2 t) t]
3254 ["4-up" (pr-ps-mode-preview 4 t) t]
3255 ["Other..." (pr-ps-mode-preview nil t)
3256 :keys "\\[pr-ps-mode-preview]"])
3257 ("File"
3258 ["No Preprocessing..." (call-interactively 'pr-ps-file-preview)
3259 :keys "\\[pr-ps-file-preview]"
3260 ,@(funcall
3261 pr-:help "Preview PostScript file")]
3262 "--"
3263 ["PostScript Utility" pr-update-menus :active pr-ps-utility-alist
3264 ,@(funcall
3265 pr-:help "Select PostScript utility")]
3266 "--"
3267 ["1-up..." (pr-ps-file-up-preview 1 t t) pr-ps-utility-alist]
3268 ["2-up..." (pr-ps-file-up-preview 2 t t) pr-ps-utility-alist]
3269 ["4-up..." (pr-ps-file-up-preview 4 t t) pr-ps-utility-alist]
3270 ["Other..." (pr-ps-file-up-preview nil t t)
3271 :keys "\\[pr-ps-file-up-preview]" :active pr-ps-utility-alist]
3272 "--"
3273 ["Landscape" pr-toggle-file-landscape-menu
3274 :style toggle :selected pr-file-landscape
3275 ,@(funcall
3276 pr-:help "Toggle landscape for PostScript file")
3277 :active pr-ps-utility-alist]
3278 ["Duplex" pr-toggle-file-duplex-menu
3279 :style toggle :selected pr-file-duplex
3280 ,@(funcall
3281 pr-:help "Toggle duplex for PostScript file")
3282 :active pr-ps-utility-alist]
3283 ["Tumble" pr-toggle-file-tumble-menu
3284 :style toggle :selected pr-file-tumble
3285 ,@(funcall
3286 pr-:help "Toggle tumble for PostScript file")
3287 :active (and pr-file-duplex pr-ps-utility-alist)])
3288 ["Despool..." (call-interactively 'pr-despool-preview)
3289 :active pr-spool-p :keys "\\[pr-despool-preview]"
3290 ,@(funcall
3291 pr-:help "Despool PostScript buffer to printer or file (C-u)")])
3292 ("PostScript Print" :included (pr-visible-p 'postscript)
3293 ,@(funcall
3294 pr-:help "Send PostScript to printer or file (C-u)")
3295 ("Directory"
3296 ["1-up" (pr-ps-directory-ps-print 1 nil nil t) t]
3297 ["2-up" (pr-ps-directory-ps-print 2 nil nil t) t]
3298 ["4-up" (pr-ps-directory-ps-print 4 nil nil t) t]
3299 ["Other..." (pr-ps-directory-ps-print nil nil nil t)
3300 :keys "\\[pr-ps-buffer-ps-print]"])
3301 ("Buffer"
3302 ["1-up" (pr-ps-buffer-ps-print 1 t) t]
3303 ["2-up" (pr-ps-buffer-ps-print 2 t) t]
3304 ["4-up" (pr-ps-buffer-ps-print 4 t) t]
3305 ["Other..." (pr-ps-buffer-ps-print nil t)
3306 :keys "\\[pr-ps-buffer-ps-print]"])
3307 ("Region" ,pr-:active (ps-mark-active-p)
3308 ["1-up" (pr-ps-region-ps-print 1 t) t]
3309 ["2-up" (pr-ps-region-ps-print 2 t) t]
3310 ["4-up" (pr-ps-region-ps-print 4 t) t]
3311 ["Other..." (pr-ps-region-ps-print nil t)
3312 :keys "\\[pr-ps-region-ps-print]"])
3313 ("Mode" ,pr-:active (pr-mode-alist-p)
3314 ["1-up" (pr-ps-mode-ps-print 1 t) t]
3315 ["2-up" (pr-ps-mode-ps-print 2 t) t]
3316 ["4-up" (pr-ps-mode-ps-print 4 t) t]
3317 ["Other..." (pr-ps-mode-ps-print nil t)
3318 :keys "\\[pr-ps-mode-ps-print]"])
3319 ("File"
3320 ["No Preprocessing..." (call-interactively 'pr-ps-file-ps-print)
3321 :keys "\\[pr-ps-file-ps-print]"
3322 ,@(funcall
3323 pr-:help "Send PostScript file to printer")]
3324 "--"
3325 ["PostScript Utility" pr-update-menus :active pr-ps-utility-alist
3326 ,@(funcall
3327 pr-:help "Select PostScript utility")]
3328 "--"
3329 ["1-up..." (pr-ps-file-up-ps-print 1 t t) pr-ps-utility-alist]
3330 ["2-up..." (pr-ps-file-up-ps-print 2 t t) pr-ps-utility-alist]
3331 ["4-up..." (pr-ps-file-up-ps-print 4 t t) pr-ps-utility-alist]
3332 ["Other..." (pr-ps-file-up-ps-print nil t t)
3333 :keys "\\[pr-ps-file-up-ps-print]" :active pr-ps-utility-alist]
3334 "--"
3335 ["Landscape" pr-toggle-file-landscape-menu
3336 :style toggle :selected pr-file-landscape
3337 ,@(funcall
3338 pr-:help "Toggle landscape for PostScript file")
3339 :active pr-ps-utility-alist]
3340 ["Duplex" pr-toggle-file-duplex-menu
3341 :style toggle :selected pr-file-duplex
3342 ,@(funcall
3343 pr-:help "Toggle duplex for PostScript file")
3344 :active pr-ps-utility-alist]
3345 ["Tumble" pr-toggle-file-tumble-menu
3346 :style toggle :selected pr-file-tumble
3347 ,@(funcall
3348 pr-:help "Toggle tumble for PostScript file")
3349 :active (and pr-file-duplex pr-ps-utility-alist)])
3350 ["Despool..." (call-interactively 'pr-despool-ps-print)
3351 :active pr-spool-p :keys "\\[pr-despool-ps-print]"
3352 ,@(funcall
3353 pr-:help "Despool PostScript buffer to printer or file (C-u)")])
3354 ["PostScript Printers" pr-update-menus
3355 :active pr-ps-printer-alist :included (pr-visible-p 'postscript)
3356 ,@(funcall
3357 pr-:help "Select PostScript printer")]
3358 "--"
3359 ("Printify" :included (pr-visible-p 'text)
3360 ,@(funcall
3361 pr-:help
3362 "Replace non-printing chars with printable representations.")
3363 ["Directory" pr-printify-directory t]
3364 ["Buffer" pr-printify-buffer t]
3365 ["Region" pr-printify-region (ps-mark-active-p)])
3366 ("Print" :included (pr-visible-p 'text)
3367 ,@(funcall
3368 pr-:help "Send text to printer")
3369 ["Directory" pr-txt-directory t]
3370 ["Buffer" pr-txt-buffer t]
3371 ["Region" pr-txt-region (ps-mark-active-p)]
3372 ["Mode" pr-txt-mode (pr-mode-alist-p)])
3373 ["Text Printers" pr-update-menus
3374 :active pr-txt-printer-alist :included (pr-visible-p 'text)
3375 ,@(funcall
3376 pr-:help "Select text printer")]
3377 "--"
3378 ["Landscape" pr-toggle-landscape-menu
3379 :style toggle :selected ps-landscape-mode
3380 :included (pr-visible-p 'postscript-options)]
3381 ["Print Header" pr-toggle-header-menu
3382 :style toggle :selected ps-print-header
3383 :included (pr-visible-p 'postscript-options)]
3384 ["Print Header Frame" pr-toggle-header-frame-menu
3385 :style toggle :selected ps-print-header-frame :active ps-print-header
3386 :included (pr-visible-p 'postscript-options)]
3387 ["Line Number" pr-toggle-line-menu
3388 :style toggle :selected ps-line-number
3389 :included (pr-visible-p 'postscript-options)]
3390 ["Zebra Stripes" pr-toggle-zebra-menu
3391 :style toggle :selected ps-zebra-stripes
3392 :included (pr-visible-p 'postscript-options)]
3393 ["Duplex" pr-toggle-duplex-menu
3394 :style toggle :selected ps-spool-duplex
3395 :included (pr-visible-p 'postscript-options)]
3396 ["Tumble" pr-toggle-tumble-menu
3397 :style toggle :selected ps-spool-tumble :active ps-spool-duplex
3398 :included (pr-visible-p 'postscript-options)]
3399 ["Upside-Down" pr-toggle-upside-down-menu
3400 :style toggle :selected ps-print-upside-down
3401 :included (pr-visible-p 'postscript-options)]
3402 ("Print All Pages" :included (pr-visible-p 'postscript-options)
3403 ,@(funcall
3404 pr-:help "Select odd/even pages/sheets to print")
3405 ["All Pages" (pr-even-or-odd-pages nil)
3406 :style radio :selected (eq ps-even-or-odd-pages nil)]
3407 ["Even Pages" (pr-even-or-odd-pages 'even-page)
3408 :style radio :selected (eq ps-even-or-odd-pages 'even-page)]
3409 ["Odd Pages" (pr-even-or-odd-pages 'odd-page)
3410 :style radio :selected (eq ps-even-or-odd-pages 'odd-page)]
3411 ["Even Sheets" (pr-even-or-odd-pages 'even-sheet)
3412 :style radio :selected (eq ps-even-or-odd-pages 'even-sheet)]
3413 ["Odd Sheets" (pr-even-or-odd-pages 'odd-sheet)
3414 :style radio :selected (eq ps-even-or-odd-pages 'odd-sheet)])
3415 "--"
3416 ["Spool Buffer" pr-toggle-spool-menu
3417 :style toggle :selected pr-spool-p
3418 :included (pr-visible-p 'postscript-process)
3419 ,@(funcall
3420 pr-:help "Toggle PostScript spooling")]
3421 ["Print with faces" pr-toggle-faces-menu
3422 :style toggle :selected pr-faces-p
3423 :included (pr-visible-p 'postscript-process)
3424 ,@(funcall
3425 pr-:help "Toggle PostScript printing with faces")]
3426 ["Print via Ghostscript" pr-toggle-ghostscript-menu
3427 :style toggle :selected pr-print-using-ghostscript
3428 :included (pr-visible-p 'postscript-process)
3429 ,@(funcall
3430 pr-:help "Toggle PostScript generation using ghostscript")]
3431 "--"
3432 ["Auto Region" pr-toggle-region-menu
3433 :style toggle :selected pr-auto-region
3434 :included (pr-visible-p 'printing)]
3435 ["Auto Mode" pr-toggle-mode-menu
3436 :style toggle :selected pr-auto-mode
3437 :included (pr-visible-p 'printing)]
3438 ["Menu Lock" pr-toggle-lock-menu
3439 :style toggle :selected pr-menu-lock
3440 :included (pr-visible-p 'printing)]
3441 "--"
3442 ("Customize" :included (pr-visible-p 'help)
3443 ["printing" pr-customize t]
3444 ["ps-print" ps-print-customize t]
3445 ["lpr" lpr-customize t])
3446 ("Show Settings" :included (pr-visible-p 'help)
3447 ["printing" pr-show-pr-setup t]
3448 ["ps-print" pr-show-ps-setup t]
3449 ["lpr" pr-show-lpr-setup t])
3450 ["Help" pr-help :active t :included (pr-visible-p 'help)]
3454 (defun pr-menu-bind ()
3455 "Install `printing' menu in the menubar.
3457 On Emacs 20, it replaces the Tools/Print menu by Tools/Printing menu.
3459 On Emacs 21 and 22, it replaces the File/Print* menu entries by File/Print
3460 menu.
3462 Calls `pr-update-menus' to adjust menus."
3463 (interactive)
3464 (pr-global-menubar pr-menu-spec)
3465 (pr-update-menus t))
3468 ;; Key binding
3469 (let ((pr-print-key (if (featurep 'xemacs)
3470 'f22 ; XEmacs
3471 'print))) ; GNU Emacs
3472 (global-set-key `[,pr-print-key] 'pr-ps-fast-fire)
3473 ;; Well, M-print and S-print are used because in my keyboard S-print works
3474 ;; and M-print doesn't. But M-print can work in other keyboard.
3475 (global-set-key `[(meta ,pr-print-key)] 'pr-ps-mode-using-ghostscript)
3476 (global-set-key `[(shift ,pr-print-key)] 'pr-ps-mode-using-ghostscript)
3477 ;; Well, C-print and C-M-print are used because in my keyboard C-M-print works
3478 ;; and C-print doesn't. But C-print can work in other keyboard.
3479 (global-set-key `[(control ,pr-print-key)] 'pr-txt-fast-fire)
3480 (global-set-key `[(control meta ,pr-print-key)] 'pr-txt-fast-fire))
3483 ;;; You can also use something like:
3484 ;;;(global-set-key "\C-ci" 'pr-interface)
3485 ;;;(global-set-key "\C-cbp" 'pr-ps-buffer-print)
3486 ;;;(global-set-key "\C-cbx" 'pr-ps-buffer-preview)
3487 ;;;(global-set-key "\C-cbb" 'pr-ps-buffer-using-ghostscript)
3488 ;;;(global-set-key "\C-crp" 'pr-ps-region-print)
3489 ;;;(global-set-key "\C-crx" 'pr-ps-region-preview)
3490 ;;;(global-set-key "\C-crr" 'pr-ps-region-using-ghostscript)
3493 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3494 ;; Help Message
3497 (defconst pr-help-message
3498 (concat "printing.el version " pr-version
3499 " ps-print.el version " ps-print-version
3500 "\n\n
3501 Menu Layout
3502 -----------
3504 The `printing' menu (Tools/Printing or File/Print) has the following layout:
3506 +-----------------------------+
3507 A 0 | Printing Interface |
3508 +-----------------------------+ +-A---------+ +-B------+
3509 I 1 | PostScript Preview >|-------|Directory >|-----|1-up |
3510 2 | PostScript Print >|---- A |Buffer >|-- B |2-up |
3511 3 | PostScript Printer: name >|---- C |Region >|-- B |4-up |
3512 +-----------------------------+ |Mode >|-- B |Other...|
3513 II 4 | Printify >|-----\\ |File >|--\\ +--------+
3514 5 | Print >|---\\ | |Despool... | |
3515 6 | Text Printer: name >|-\\ | | +-----------+ |
3516 +-----------------------------+ | | | +---------+ +------------+
3517 III 7 |[ ]Landscape | | | \\-|Directory| | No Prep... | Ia
3518 8 |[ ]Print Header | | | |Buffer | +------------+ Ib
3519 9 |[ ]Print Header Frame | | | |Region | | name >|- C
3520 10 |[ ]Line Number | | | +---------+ +------------+
3521 11 |[ ]Zebra Stripes | | | +---------+ | 1-up... | Ic
3522 12 |[ ]Duplex | | \\---|Directory| | 2-up... |
3523 13 |[ ]Tumble | \\--\\ |Buffer | | 4-up... |
3524 14 |[ ]Upside-Down | | |Region | | Other... |
3525 15 | Print All Pages >|--\\ | |Mode | +------------+
3526 +-----------------------------+ | | +---------+ |[ ]Landscape| Id
3527 IV 16 |[ ]Spool Buffer | | | +-C-------+ |[ ]Duplex | Ie
3528 17 |[ ]Print with faces | | \\--|( )name A| |[ ]Tumble | If
3529 18 |[ ]Print via Ghostscript | | |( )name B| +------------+
3530 +-----------------------------+ | |... |
3531 V 19 |[ ]Auto Region | | |(*)name |
3532 20 |[ ]Auto Mode | | |... |
3533 21 |[ ]Menu Lock | | +---------+ +--------------+
3534 +-----------------------------+ \\------------------|(*)All Pages |
3535 VI 22 | Customize >|--- D +-D------+ |( )Even Pages |
3536 23 | Show Settings >|-------|printing| |( )Odd Pages |
3537 24 | Help | |ps-print| |( )Even Sheets|
3538 +-----------------------------+ |lpr | |( )Odd Sheets |
3539 +--------+ +--------------+
3541 See `pr-visible-entry-list' for hiding some parts of the menu.
3543 The menu has the following sections:
3545 A. Interface:
3547 0. You can use a buffer interface instead of menus. It looks like the
3548 customization buffer. Basically, it has the same options found in the
3549 menu and some extra options, all this on a buffer.
3551 I. PostScript printing:
3553 1. You can generate a PostScript file (if you type C-u before activating
3554 menu) or PostScript temporary file for a directory, a buffer, a region
3555 or a major mode, choosing 1-up, 2-up, 4-up or any other n-up printing;
3556 after file generation, ghostview is activated using the file generated
3557 as argument. This option is disabled if spooling is on (option 16).
3558 Also, if you already have a PostScript file you can preview it.
3559 Instead of previewing each buffer, region or major mode at once, you
3560 can save temporarily the PostScript code generated in a buffer and
3561 preview it later. The option `Despool...' despools the PostScript
3562 spooling buffer in a temporary file and uses ghostview to preview it.
3563 If you type C-u before choosing this option, the PostScript code
3564 generated is saved in a file instead of saving in a temporary file. To
3565 spool the PostScript code generated you need to turn on the option 16.
3566 The option `Despool...' is enabled if spooling is on (option 16).
3568 NOTE 1: It's possible to customize a major mode printing, just declare
3569 the customization in `pr-mode-alist' and invoke some of
3570 `*-mode*' commands or select Mode option in Printing menu. An
3571 example for major mode usage is when you're using gnus (or mh,
3572 or rmail, etc.) and you're in the *Summary* buffer, if you
3573 forget to switch to the *Article* buffer before printing,
3574 you'll get a nicely formatted list of article subjects shows
3575 up at the printer. With major mode printing you don't need to
3576 switch from gnus *Summary* buffer first.
3578 NOTE 2: There are the following options for PostScript file processing:
3579 Ia. Print the file *No Preprocessing*, that is, send it
3580 directly to PostScript printer.
3581 Ib. PostScript utility processing selection.
3582 See `pr-ps-utility-alist' and `pr-setting-database' for
3583 documentation.
3584 Ic. Do n-up processing before printing.
3585 Id. Toggle on/off landscape for PostScript file processing.
3586 Ie. Toggle on/off duplex for PostScript file processing.
3587 If. Toggle on/off tumble for PostScript file processing.
3589 NOTE 3: Don't forget to download and install the utilities declared on
3590 `pr-ps-utility-alist'.
3592 2. Operate the same way as option 1, but it sends directly the PostScript
3593 code (or put in a file, if you've typed C-u) or it uses ghostscript to
3594 print the PostScript file generated. It depends on option 18, if it's
3595 turned on, it uses ghostscript; otherwise, it sends directly to
3596 printer. If spooling is on (option 16), the PostScript code is saved
3597 temporarily in a buffer instead of printing it or saving it in a file.
3598 Also, if you already have a PostScript file you can print it.
3599 Instead of printing each buffer, region or major mode at once, you can
3600 save temporarily the PostScript code generated in a buffer and print it
3601 later. The option `Despool...' despools the PostScript spooling buffer
3602 directly on a printer. If you type C-u before choosing this option,
3603 the PostScript code generated is saved in a file instead of sending it to
3604 the printer. To spool the PostScript code generated you need to turn on
3605 option 16. This option is enabled if spooling is on (option 16).
3606 See also the NOTE 1, NOTE 2 and NOTE 3 on option 1.
3608 3. You can select a new PostScript printer to send PostScript code
3609 generated. For selection it's used all PostScript printers defined
3610 in `pr-ps-printer-alist' variable (see it for documentation).
3611 See also `pr-setting-database'.
3613 II. Text printing:
3615 4. If you have control characters (character code from \\000 to \\037) in a
3616 buffer and you want to print them in a text printer, select this
3617 option. All control characters in your buffer or region will be
3618 replaced by a printable representation. The printable representations
3619 use ^ (for ASCII control characters) or hex. The characters tab,
3620 linefeed, space, return and formfeed are not affected.
3621 You don't need to select this option if you use any option of section
3622 I, the PostScript engine treats control characters properly.
3624 5. If you want to print a directory, buffer, region or major mode in a
3625 text printer, select this option. See also the NOTE 1 on option 1.
3627 6. You can select a new text printer to send text generated. For
3628 selection it's used all text printers defined in `pr-txt-printer-alist'
3629 variable (see it for documentation).
3630 See also `pr-setting-database'.
3632 III. PostScript page toggle options:
3634 7. If you want a PostScript landscape printing, turn on this option.
3636 8. If you want to have a header in each page in your PostScript code,
3637 turn on this option.
3639 9. If you want to draw a gaudy frame around the header, turn on this
3640 option. This option is enabled if print header is on (option 8).
3642 10. If you want that the line number is printed in your PostScript code,
3643 turn on this option.
3645 11. If you want background zebra stripes in your PostScript code, turn on
3646 this option.
3648 12. If you want a duplex printing and your PostScript printer has this
3649 feature, turn on this option.
3651 13. If you turned on duplex printing, you can choose if you want to have a
3652 printing suitable for binding on the left or right (tumble off), or to
3653 have a printing suitable for binding at top or bottom (tumble on).
3654 This option is enabled if duplex is on (option 12).
3656 14. If you want a PostScript upside-down printing, turn on this option.
3658 15. With this option, you can choose if you want to print all pages, odd
3659 pages, even pages, odd sheets or even sheets.
3660 See also `ps-even-or-odd-pages'.
3662 IV. PostScript processing toggle options:
3664 16. If you want to spool the PostScript code generated, turn on this
3665 option. To spool the PostScript code generated use option 2. You can
3666 despool later by choosing option 1 or 2, sub-option `Despool...'.
3668 17. If you use colors in your buffers and want to see these colors on your
3669 PostScript code generated, turn on this option. If you have a
3670 black/white PostScript printer, these colors are displayed in gray
3671 scale by PostScript printer interpreter.
3673 18. If you don't have a PostScript printer to send PostScript files, turn
3674 on this option. When this option is on, the ghostscript is used to
3675 print PostScript files. In GNU or Unix system, if ghostscript is set
3676 as a PostScript filter, you don't need to turn on this option.
3678 V. Printing customization:
3680 19. If you want that region is automagically detected, turn on this
3681 option. Note that this will only work if you're using transient mark
3682 mode. When this option is on, the `*-buffer*' commands will behave
3683 like `*-region*' commands, that is, `*-buffer*' commands will print
3684 only the region marked instead of all buffer.
3686 20. Turn this option on if you want that when current major-mode is
3687 declared in `pr-mode-alist', the `*-buffer*' and `*-region*' commands
3688 behave like `*-mode*' commands.
3690 21. If you want that Printing menu stays open while you are setting
3691 toggle options, turn on this option. The variables
3692 `pr-menu-char-height' and `pr-menu-char-width' are used to guess the
3693 menu position, so don't forget to adjust these variables if menu
3694 position is not ok.
3696 VI. Customization:
3698 22. Besides all options in section III, IV and V, you can customize much
3699 more PostScript options in `ps-print' option. Or you can customize
3700 some `lpr' options for text printing. Or customize `printing'
3701 options.
3703 23. Show current settings for `printing', `ps-print' or `lpr'.
3705 24. Quick help for printing menu layout.
3707 "Printing help message.")
3710 (defconst pr-interface-help-message
3711 (concat "printing.el version " pr-version
3712 " ps-print.el version " ps-print-version
3713 "\n\n
3714 The printing interface buffer has the same functionality as the printing menu.
3715 The major difference is that the states (like sending PostScript generated to a
3716 file, n-up printing, etc.) are set and saved between priting buffer
3717 activation. Also, the landscape, duplex and tumble values are the same for
3718 PostScript file and directory/buffer/region/mode processing; using menu, there
3719 are different value sets for PostScript file and directory/buffer/region/mode
3720 processing.
3722 The printing interface buffer has the following sections:
3724 1. Print:
3726 Here you can choose to print/preview a buffer, a directory or a PostScript
3727 file:
3729 1a. Buffer:
3731 * Buffer List:
3732 Select a buffer from the current buffer list.
3734 * Region:
3735 If it's on, this means that the selected buffer has an active region,
3736 so you can turn on/off, as you wish.
3737 If it's off when a buffer is selected, this means that the selected
3738 buffer has no active region, so it'll not be possible to turn it on.
3739 If you want to process the region, let this option on.
3740 If you want to process the whole buffer, let this option off.
3742 * Mode:
3743 If it's on, this means that the selected buffer major mode is declared
3744 for major mode processing, so you can turn on/off, as you wish.
3745 If it's off when a buffer is selected, this means that the selected
3746 buffer major mode isn't declared for major mode processing, so it'll
3747 not be possible to turn it on.
3748 If you want the major mode processing, let this option on.
3749 If you don't want the major mode processing, let this option off.
3751 NOTE 1: It's possible to customize a major mode printing, just declare
3752 the customization in `pr-mode-alist' and invoke some of
3753 `*-mode*' commands or select Mode option in Printing menu. An
3754 example for major mode usage is when you're using gnus (or mh,
3755 or rmail, etc.) and you're in the *Summary* buffer, if you
3756 forget to switch to the *Article* buffer before printing,
3757 you'll get a nicely formatted list of article subjects shows
3758 up at the printer. With major mode printing you don't need to
3759 switch from gnus *Summary* buffer first.
3761 1b. Directory:
3763 * Directory:
3764 Specify a valid directory path.
3766 * File Regexp:
3767 Specify a file name regexp. All file names in the directory that
3768 match with regexp will be printed/previewed. An empty file name
3769 regexp means to print/preview all files in the directory.
3771 * List Directory Entry:
3772 If it's turned on, list directory entries besides file entries.
3774 1c. PostScript file:
3776 * PostScript File:
3777 Specify an existent PostScript file to print/preview.
3779 * PostScript Utility:
3780 Select a PostScript utility.
3781 See `pr-ps-utility-alist' and `pr-setting-database' for documentation.
3783 NOTE 2: Don't forget to download and install the utilities declared on
3784 `pr-ps-utility-alist'.
3786 * No Preprocessing:
3787 If it's turned on, don't use the PostScript utility to preprocess the
3788 PostScript file before printing/previewing.
3790 2. PostScript printer:
3792 * PostScript Printer:
3793 You can select a new PostScript printer to send PostScript code
3794 generated. For selection it's used all PostScript printers defined
3795 in `pr-ps-printer-alist' variable (see it for documentation).
3796 See also `pr-setting-database'.
3798 * Despool:
3799 If spooling is on, you can turn it on/off, as you wish.
3800 If spooling is off, it'll not be possible to turn it on.
3801 If it's turned on, specify to despools the PostScript spooling buffer in
3802 a temporary file or in the selected PostScript file when
3803 printing/previewing.
3805 * Preview:
3806 Preview the PostScript generated.
3808 * Print:
3809 Print the PostScript generated.
3811 * Quit:
3812 Quit from printing interface buffer.
3814 * Send to Printer/Temporary File:
3815 If it's turned on, the PostScript generated is sent directly to
3816 PostScript printer or, for previewing, to a temporary file.
3818 * Send to File:
3819 Specify a file name to send the PostScript generated.
3821 * N-Up:
3822 Specify n-up printing.
3824 3. Text printer:
3826 * Text Printer:
3827 Select a new text printer to send text generated. For selection it's used
3828 all text printers defined in `pr-txt-printer-alist' variable (see it for
3829 documentation). See also `pr-setting-database'.
3831 * Printify:
3832 If you have control characters (character code from \\000 to \\037) in a
3833 buffer and you want to print them in a text printer, select this
3834 option. All control characters in your buffer or region will be
3835 replaced by a printable representation. The printable representations
3836 use ^ (for ASCII control characters) or hex. The characters tab,
3837 linefeed, space, return and formfeed are not affected.
3838 You don't need to select this option if you use any option of section
3839 I, the PostScript engine treats control characters properly.
3841 * Print:
3842 To print a directory, buffer, region or major mode in a
3843 text printer, select this option. See also the NOTE 1 on section 1.
3845 * Quit:
3846 Quit from printing interface buffer.
3848 4. Settings:
3850 There are 3 setting columns:
3852 4a. First column (left column):
3854 * Landscape:
3855 PostScript landscape printing.
3857 * Print Header:
3858 To have a header in each page in your PostScript code.
3860 * Print Header Frame:
3861 To draw a gaudy frame around the header.
3863 * Line Number:
3864 The line number is printed in your PostScript code.
3866 * Zebra Stripes:
3867 Background zebra stripes in your PostScript code.
3869 * Duplex:
3870 Duplex printing (if your PostScript printer has this feature).
3872 * Tumble:
3873 If duplex printing is on, you can choose if you want to have a
3874 printing suitable for binding on the left or right (tumble off), or to
3875 have a printing suitable for binding at top or bottom (tumble on).
3877 * Upside-Down:
3878 PostScript upside-down printing.
3880 4b. Second column (middle column):
3882 * Auto Region:
3883 If you want that region is automagically detected, turn on this
3884 option. Note that this will only work if you're using transient mark
3885 mode. When this option is on, the `*-buffer*' commands will behave
3886 like `*-region*' commands, that is, `*-buffer*' commands will print
3887 only the region marked instead of all buffer.
3889 * Auto Mode:
3890 Turn this option on if you want that when current major-mode is
3891 declared in `pr-mode-alist', the `*-buffer*' and `*-region*' commands
3892 behave like `*-mode*' commands.
3894 * Menu Lock:
3895 If you want that Printing menu stays open while you are setting
3896 toggle options, turn on this option. The variables
3897 `pr-menu-char-height' and `pr-menu-char-width' are used to guess the
3898 menu position, so don't forget to adjust these variables if menu
3899 position is not ok.
3901 * Spool Buffer:
3902 To spool the PostScript code generated. You can despool later by
3903 setting Despool option on PostScript printer section.
3905 * Print with faces:
3906 If you use colors in your buffers and want to see these colors on your
3907 PostScript code generated, turn on this option. If you have a
3908 black/white PostScript printer, these colors are displayed in gray
3909 scale by PostScript printer interpreter.
3911 * Print via Ghostscript:
3912 If you don't have a PostScript printer to send PostScript files, turn
3913 on this option. When this option is on, the ghostscript is used to
3914 print PostScript files. In GNU or Unix system, if ghostscript is set
3915 as a PostScript filter, you don't need to turn on this option.
3917 * Parity Page Menu:
3918 To print all pages, odd pages, even pages, odd sheets or even sheets.
3919 See also `ps-even-or-odd-pages'.
3921 4c. Third column (right column):
3923 * Verbose:
3924 That is, to be verbose when editing a field in interface buffer.
3926 5. Customize:
3928 Besides all options in section 4, you can customize much more PostScript
3929 options in `ps-print' option. Or you can customize some `lpr' options for
3930 text printing. Or customize `printing' options.
3932 6. Show settings:
3934 Show current settings for `printing', `ps-print' or `lpr'.
3936 7. Help:
3938 Quick help for printing interface buffer and printing menu layout. You can
3939 also quit the printing interface buffer or kill all printing help buffer.
3941 "Printing buffer interface help message.")
3944 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3945 ;; Commands
3948 ;;;###autoload
3949 (defun pr-interface (&optional buffer)
3950 "Activate the printing interface buffer.
3952 If BUFFER is nil, the current buffer is used for printing.
3954 For more information, type \\[pr-interface-help]."
3955 (interactive)
3956 (with-current-buffer (or buffer (current-buffer))
3957 (pr-create-interface)))
3960 ;;;###autoload
3961 (defun pr-ps-directory-preview (n-up dir file-regexp &optional filename)
3962 "Preview directory using ghostview.
3964 Interactively, the command prompts for N-UP printing number, a directory, a
3965 file name regexp for matching and, when you use a prefix argument (C-u), the
3966 command prompts the user for a file name, and saves the PostScript image in
3967 that file instead of saving it in a temporary file.
3969 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
3970 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
3971 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
3972 save the image in a temporary file. If FILENAME is a string, save the
3973 PostScript image in a file with that name. If FILENAME is t, prompts for a
3974 file name.
3976 See also documentation for `pr-list-directory'."
3977 (interactive (pr-interactive-ps-dir-args (pr-prompt "PS preview dir")))
3978 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
3979 (pr-prompt "PS preview dir"))
3980 (setq filename (pr-ps-file filename))
3981 (pr-ps-file-list n-up dir file-regexp filename)
3982 (or pr-spool-p
3983 (pr-ps-file-preview filename)))
3986 ;;;###autoload
3987 (defun pr-ps-directory-using-ghostscript (n-up dir file-regexp &optional filename)
3988 "Print directory using PostScript through ghostscript.
3990 Interactively, the command prompts for N-UP printing number, a directory, a
3991 file name regexp for matching and, when you use a prefix argument (C-u), the
3992 command prompts the user for a file name, and saves the PostScript image in
3993 that file instead of saving it in a temporary file.
3995 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
3996 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
3997 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
3998 save the image in a temporary file. If FILENAME is a string, save the
3999 PostScript image in a file with that name. If FILENAME is t, prompts for a
4000 file name.
4002 See also documentation for `pr-list-directory'."
4003 (interactive (pr-interactive-ps-dir-args (pr-prompt "PS print dir GS")))
4004 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
4005 (pr-prompt "PS print dir GS"))
4006 (let ((file (pr-ps-file filename)))
4007 (pr-ps-file-list n-up dir file-regexp file)
4008 (pr-ps-file-using-ghostscript file)
4009 (or filename (pr-delete-file file))))
4012 ;;;###autoload
4013 (defun pr-ps-directory-print (n-up dir file-regexp &optional filename)
4014 "Print directory using PostScript printer.
4016 Interactively, the command prompts for N-UP printing number, a directory, a
4017 file name regexp for matching and, when you use a prefix argument (C-u), the
4018 command prompts the user for a file name, and saves the PostScript image in
4019 that file instead of saving it in a temporary file.
4021 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
4022 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
4023 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
4024 save the image in a temporary file. If FILENAME is a string, save the
4025 PostScript image in a file with that name. If FILENAME is t, prompts for a
4026 file name.
4028 See also documentation for `pr-list-directory'."
4029 (interactive (pr-interactive-ps-dir-args (pr-prompt "PS print dir")))
4030 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
4031 (pr-prompt "PS print dir"))
4032 (let ((file (pr-ps-file filename)))
4033 (pr-ps-file-list n-up dir file-regexp file)
4034 (pr-ps-file-print file)
4035 (or filename (pr-delete-file file))))
4038 ;;;###autoload
4039 (defun pr-ps-directory-ps-print (n-up dir file-regexp &optional filename)
4040 "Print directory using PostScript printer or through ghostscript.
4042 It depends on `pr-print-using-ghostscript'.
4044 Interactively, the command prompts for N-UP printing number, a directory, a
4045 file name regexp for matching and, when you use a prefix argument (C-u), the
4046 command prompts the user for a file name, and saves the PostScript image in
4047 that file instead of saving it in a temporary file.
4049 Noninteractively, if N-UP is nil, prompts for N-UP printing number. If DIR is
4050 nil, prompts for DIRectory. If FILE-REGEXP is nil, prompts for
4051 FILE(name)-REGEXP. The argument FILENAME is treated as follows: if it's nil,
4052 save the image in a temporary file. If FILENAME is a string, save the
4053 PostScript image in a file with that name. If FILENAME is t, prompts for a
4054 file name.
4056 See also documentation for `pr-list-directory'."
4057 (interactive (pr-interactive-ps-dir-args
4058 (pr-prompt (pr-prompt-gs "PS print dir"))))
4059 (pr-set-ps-dir-args 'n-up 'dir 'file-regexp 'filename
4060 (pr-prompt (pr-prompt-gs "PS print dir")))
4061 (if (pr-using-ghostscript-p)
4062 (pr-ps-directory-using-ghostscript n-up dir file-regexp filename)
4063 (pr-ps-directory-print n-up dir file-regexp filename)))
4066 ;;;###autoload
4067 (defun pr-ps-buffer-preview (n-up &optional filename)
4068 "Preview buffer using ghostview.
4070 Interactively, the command prompts for N-UP printing number and, when you use a
4071 prefix argument (C-u), the command prompts the user for a file name, and saves
4072 the PostScript image in that file instead of saving it in a temporary file.
4074 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
4075 argument FILENAME is treated as follows: if it's nil, save the image in a
4076 temporary file. If FILENAME is a string, save the PostScript image in a file
4077 with that name. If FILENAME is t, prompts for a file name."
4078 (interactive (pr-interactive-n-up-file (pr-prompt "PS preview")))
4079 (if (pr-auto-mode-p)
4080 (pr-ps-mode-preview n-up filename)
4081 (pr-ps-preview (pr-region-active-symbol) n-up filename
4082 (pr-region-active-string "PS preview"))))
4085 ;;;###autoload
4086 (defun pr-ps-buffer-using-ghostscript (n-up &optional filename)
4087 "Print buffer using PostScript through ghostscript.
4089 Interactively, the command prompts for N-UP printing number and, when you use a
4090 prefix argument (C-u), the command prompts the user for a file name, and saves
4091 the PostScript image in that file instead of sending it to the printer.
4093 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
4094 argument FILENAME is treated as follows: if it's nil, send the image to the
4095 printer. If FILENAME is a string, save the PostScript image in a file with
4096 that name. If FILENAME is t, prompts for a file name."
4097 (interactive (pr-interactive-n-up-file (pr-prompt "PS print GS")))
4098 (if (pr-auto-mode-p)
4099 (pr-ps-mode-using-ghostscript n-up filename)
4100 (pr-ps-using-ghostscript (pr-region-active-symbol) n-up filename
4101 (pr-region-active-string "PS print GS"))))
4104 ;;;###autoload
4105 (defun pr-ps-buffer-print (n-up &optional filename)
4106 "Print buffer using PostScript printer.
4108 Interactively, the command prompts for N-UP printing number and, when you use a
4109 prefix argument (C-u), the command prompts the user for a file name, and saves
4110 the PostScript image in that file instead of sending it to the printer.
4112 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
4113 argument FILENAME is treated as follows: if it's nil, send the image to the
4114 printer. If FILENAME is a string, save the PostScript image in a file with
4115 that name. If FILENAME is t, prompts for a file name."
4116 (interactive (pr-interactive-n-up-file (pr-prompt "PS print")))
4117 (if (pr-auto-mode-p)
4118 (pr-ps-mode-print n-up filename)
4119 (pr-ps-print (pr-region-active-symbol) n-up filename
4120 (pr-region-active-string "PS print"))))
4123 ;;;###autoload
4124 (defun pr-ps-buffer-ps-print (n-up &optional filename)
4125 "Print buffer using PostScript printer or through ghostscript.
4127 It depends on `pr-print-using-ghostscript'.
4129 Interactively, the command prompts for N-UP printing number and, when you use a
4130 prefix argument (C-u), the command prompts the user for a file name, and saves
4131 the PostScript image in that file instead of sending it to the printer.
4133 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
4134 argument FILENAME is treated as follows: if it's nil, send the image to the
4135 printer. If FILENAME is a string, save the PostScript image in a file with
4136 that name. If FILENAME is t, prompts for a file name."
4137 (interactive (pr-interactive-n-up-file
4138 (pr-prompt (pr-prompt-gs "PS print"))))
4139 (cond ((pr-auto-mode-p)
4140 (pr-ps-mode-ps-print n-up filename))
4141 ((pr-using-ghostscript-p)
4142 (pr-ps-using-ghostscript (pr-region-active-symbol) n-up filename
4143 (pr-region-active-string "PS print GS")))
4145 (pr-ps-print (pr-region-active-symbol) n-up filename
4146 (pr-region-active-string "PS print")))))
4149 ;;;###autoload
4150 (defun pr-ps-region-preview (n-up &optional filename)
4151 "Preview region using ghostview.
4153 See also `pr-ps-buffer-preview'."
4154 (interactive (pr-interactive-n-up-file (pr-prompt-region "PS preview")))
4155 (if (pr-auto-mode-p)
4156 (let ((pr-auto-region t))
4157 (pr-ps-mode-preview n-up filename))
4158 (pr-ps-preview 'region n-up filename "PS preview region")))
4161 ;;;###autoload
4162 (defun pr-ps-region-using-ghostscript (n-up &optional filename)
4163 "Print region using PostScript through ghostscript.
4165 See also `pr-ps-buffer-using-ghostscript'."
4166 (interactive (pr-interactive-n-up-file (pr-prompt-region "PS print GS")))
4167 (if (pr-auto-mode-p)
4168 (let ((pr-auto-region t))
4169 (pr-ps-mode-using-ghostscript n-up filename))
4170 (pr-ps-using-ghostscript 'region n-up filename "PS print GS region")))
4173 ;;;###autoload
4174 (defun pr-ps-region-print (n-up &optional filename)
4175 "Print region using PostScript printer.
4177 See also `pr-ps-buffer-print'."
4178 (interactive (pr-interactive-n-up-file (pr-prompt-region "PS print")))
4179 (if (pr-auto-mode-p)
4180 (let ((pr-auto-region t))
4181 (pr-ps-mode-print n-up filename))
4182 (pr-ps-print 'region n-up filename "PS print region")))
4185 ;;;###autoload
4186 (defun pr-ps-region-ps-print (n-up &optional filename)
4187 "Print region using PostScript printer or through ghostscript.
4189 See also `pr-ps-buffer-ps-print'."
4190 (interactive (pr-interactive-n-up-file
4191 (pr-prompt-region (pr-prompt-gs "PS print"))))
4192 (cond ((pr-auto-mode-p)
4193 (let ((pr-auto-region t))
4194 (pr-ps-mode-ps-print n-up filename)))
4195 ((pr-using-ghostscript-p)
4196 (pr-ps-using-ghostscript 'region n-up filename "PS print GS region"))
4198 (pr-ps-print 'region n-up filename "PS print region"))))
4201 ;;;###autoload
4202 (defun pr-ps-mode-preview (n-up &optional filename)
4203 "Preview major mode using ghostview.
4205 See also `pr-ps-buffer-preview'."
4206 (interactive (pr-interactive-n-up-file "PS preview mode"))
4207 (pr-set-n-up-and-filename 'n-up 'filename "PS preview mode")
4208 (let ((file (pr-ps-file filename)))
4209 (and (pr-ps-mode n-up file)
4210 (not pr-spool-p)
4211 (pr-ps-file-preview file))))
4214 ;;;###autoload
4215 (defun pr-ps-mode-using-ghostscript (n-up &optional filename)
4216 "Print major mode using PostScript through ghostscript.
4218 See also `pr-ps-buffer-using-ghostscript'."
4219 (interactive (pr-interactive-n-up-file "PS print GS mode"))
4220 (pr-set-n-up-and-filename 'n-up 'filename "PS print GS mode")
4221 (let ((file (pr-ps-file filename)))
4222 (when (and (pr-ps-mode n-up file)
4223 (not pr-spool-p))
4224 (pr-ps-file-using-ghostscript file)
4225 (or filename (pr-delete-file file)))))
4228 ;;;###autoload
4229 (defun pr-ps-mode-print (n-up &optional filename)
4230 "Print major mode using PostScript printer.
4232 See also `pr-ps-buffer-print'."
4233 (interactive (pr-interactive-n-up-file "PS print mode"))
4234 (pr-set-n-up-and-filename 'n-up 'filename "PS print mode")
4235 (pr-ps-mode n-up filename))
4238 ;;;###autoload
4239 (defun pr-ps-mode-ps-print (n-up &optional filename)
4240 "Print major mode using PostScript or through ghostscript.
4242 See also `pr-ps-buffer-ps-print'."
4243 (interactive (pr-interactive-n-up-file (pr-prompt-gs "PS print mode")))
4244 (if (pr-using-ghostscript-p)
4245 (pr-ps-mode-using-ghostscript n-up filename)
4246 (pr-ps-mode-print n-up filename)))
4249 ;;;###autoload
4250 (defun pr-printify-directory (&optional dir file-regexp)
4251 "Replace nonprinting characters in directory with printable representations.
4252 The printable representations use ^ (for ASCII control characters) or hex.
4253 The characters tab, linefeed, space, return and formfeed are not affected.
4255 Interactively, the command prompts for a directory and a file name regexp for
4256 matching.
4258 Noninteractively, if DIR is nil, prompts for DIRectory. If FILE-REGEXP is nil,
4259 prompts for FILE(name)-REGEXP.
4261 See also documentation for `pr-list-directory'."
4262 (interactive (pr-interactive-dir-args "Printify dir"))
4263 (pr-set-dir-args 'dir 'file-regexp "Printify dir")
4264 (pr-file-list dir file-regexp 'pr-printify-buffer))
4267 ;;;###autoload
4268 (defun pr-printify-buffer ()
4269 "Replace nonprinting characters in buffer with printable representations.
4270 The printable representations use ^ (for ASCII control characters) or hex.
4271 The characters tab, linefeed, space, return and formfeed are not affected."
4272 (interactive "*")
4273 (if (pr-region-active-p)
4274 (pr-printify-region)
4275 (printify-region (point-min) (point-max))))
4278 ;;;###autoload
4279 (defun pr-printify-region ()
4280 "Replace nonprinting characters in region with printable representations.
4281 The printable representations use ^ (for ASCII control characters) or hex.
4282 The characters tab, linefeed, space, return and formfeed are not affected."
4283 (interactive "*")
4284 (printify-region (point) (mark)))
4287 ;;;###autoload
4288 (defun pr-txt-directory (&optional dir file-regexp)
4289 "Print directory using text printer.
4291 Interactively, the command prompts for a directory and a file name regexp for
4292 matching.
4294 Noninteractively, if DIR is nil, prompts for DIRectory. If FILE-REGEXP is nil,
4295 prompts for FILE(name)-REGEXP.
4297 See also documentation for `pr-list-directory'."
4298 (interactive (pr-interactive-dir-args "Print dir"))
4299 (pr-set-dir-args 'dir 'file-regexp "Print dir")
4300 (pr-file-list dir file-regexp 'pr-txt-buffer))
4303 ;;;###autoload
4304 (defun pr-txt-buffer ()
4305 "Print buffer using text printer."
4306 (interactive)
4307 (cond ((pr-auto-mode-p)
4308 (pr-txt-mode))
4309 ((pr-region-active-p)
4310 (pr-txt-region))
4312 (pr-txt-print (point-min) (point-max)))))
4315 ;;;###autoload
4316 (defun pr-txt-region ()
4317 "Print region using text printer."
4318 (interactive)
4319 (if (pr-auto-mode-p)
4320 (let ((pr-auto-region t))
4321 (pr-txt-mode))
4322 (pr-txt-print (point) (mark))))
4325 ;;;###autoload
4326 (defun pr-txt-mode ()
4327 "Print major mode using text printer."
4328 (interactive)
4329 (let ((args (pr-mode-alist-p)))
4330 (if args
4331 (funcall (car args) (nthcdr 2 args))
4332 (ding)
4333 (message "`%s' major mode not declared." major-mode))))
4336 ;;;###autoload
4337 (defun pr-despool-preview (&optional filename)
4338 "Preview spooled PostScript.
4340 Interactively, when you use a prefix argument (C-u), the command prompts the
4341 user for a file name, and saves the spooled PostScript image in that file
4342 instead of saving it in a temporary file.
4344 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4345 save the image in a temporary file. If FILENAME is a string, save the
4346 PostScript image in a file with that name."
4347 (interactive (list (ps-print-preprint current-prefix-arg)))
4348 (let ((file (pr-ps-file filename)))
4349 (when (stringp file)
4350 (pr-despool-print file)
4351 (pr-ps-file-preview file))))
4354 ;;;###autoload
4355 (defun pr-despool-using-ghostscript (&optional filename)
4356 "Print spooled PostScript using ghostscript.
4358 Interactively, when you use a prefix argument (C-u), the command prompts the
4359 user for a file name, and saves the spooled PostScript image in that file
4360 instead of sending it to the printer.
4362 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4363 send the image to the printer. If FILENAME is a string, save the PostScript
4364 image in a file with that name."
4365 (interactive (list (ps-print-preprint current-prefix-arg)))
4366 (let ((file (pr-ps-file filename)))
4367 (when (stringp file)
4368 (pr-despool-print file)
4369 (pr-ps-file-using-ghostscript file)
4370 (or filename (pr-delete-file file)))))
4373 ;;;###autoload
4374 (defun pr-despool-print (&optional filename)
4375 "Send the spooled PostScript to the printer.
4377 Interactively, when you use a prefix argument (C-u), the command prompts the
4378 user for a file name, and saves the spooled PostScript image in that file
4379 instead of sending it to the printer.
4381 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4382 send the image to the printer. If FILENAME is a string, save the PostScript
4383 image in a file with that name."
4384 (interactive (list (ps-print-preprint current-prefix-arg)))
4385 (pr-save-file-modes
4386 (let ((ps-lpr-command (pr-command pr-ps-command))
4387 (ps-lpr-switches pr-ps-switches)
4388 (ps-printer-name-option pr-ps-printer-switch)
4389 (ps-printer-name pr-ps-printer))
4390 (ps-despool filename))))
4393 ;;;###autoload
4394 (defun pr-despool-ps-print (&optional filename)
4395 "Send the spooled PostScript to the printer or use ghostscript to print it.
4397 Interactively, when you use a prefix argument (C-u), the command prompts the
4398 user for a file name, and saves the spooled PostScript image in that file
4399 instead of sending it to the printer.
4401 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
4402 send the image to the printer. If FILENAME is a string, save the PostScript
4403 image in a file with that name."
4404 (interactive (list (ps-print-preprint current-prefix-arg)))
4405 (if pr-print-using-ghostscript
4406 (pr-despool-using-ghostscript filename)
4407 (pr-despool-print filename)))
4410 ;;;###autoload
4411 (defun pr-ps-file-preview (filename)
4412 "Preview PostScript file FILENAME."
4413 (interactive (list (pr-ps-infile-preprint "Preview ")))
4414 (and (stringp filename) (file-exists-p filename)
4415 (pr-call-process pr-gv-command filename)))
4418 ;;;###autoload
4419 (defun pr-ps-file-up-preview (n-up ifilename &optional ofilename)
4420 "Preview PostScript file FILENAME."
4421 (interactive (pr-interactive-n-up-inout "PS preview"))
4422 (let ((outfile (pr-ps-utility-args 'n-up 'ifilename 'ofilename
4423 "PS preview ")))
4424 (pr-ps-utility-process n-up ifilename outfile)
4425 (pr-ps-file-preview outfile)))
4428 ;;;###autoload
4429 (defun pr-ps-file-using-ghostscript (filename)
4430 "Print PostScript file FILENAME using ghostscript."
4431 (interactive (list (pr-ps-infile-preprint "Print preview ")))
4432 (and (stringp filename) (file-exists-p filename)
4433 (let* ((file (pr-expand-file-name filename))
4434 (tempfile (pr-dosify-file-name (make-temp-file file))))
4435 ;; gs use
4436 (pr-call-process pr-gs-command
4437 (format "-sDEVICE=%s" pr-gs-device)
4438 (format "-r%d" pr-gs-resolution)
4439 (pr-switches-string pr-gs-switches "pr-gs-switches")
4440 (format "-sOutputFile=\"%s\"" tempfile)
4441 file
4442 "-c quit")
4443 ;; printing
4444 (pr-ps-file-print tempfile)
4445 ;; deleting
4446 (pr-delete-file tempfile))))
4449 ;;;###autoload
4450 (defun pr-ps-file-print (filename)
4451 "Print PostScript file FILENAME."
4452 (interactive (list (pr-ps-infile-preprint "Print ")))
4453 (and (stringp filename) (file-exists-p filename)
4454 ;; printing
4455 (let ((file (pr-expand-file-name filename)))
4456 (if (string= pr-ps-command "")
4457 ;; default action
4458 (let ((ps-spool-buffer (get-buffer-create ps-spool-buffer-name)))
4459 (with-current-buffer ps-spool-buffer
4460 (erase-buffer)
4461 (insert-file-contents-literally file))
4462 (pr-despool-print))
4463 ;; use `pr-ps-command' to print
4464 (apply 'pr-call-process
4465 pr-ps-command
4466 (pr-switches-string pr-ps-switches "pr-ps-switches")
4467 (if (string-match "cp" pr-ps-command)
4468 ;; for "cp" (cmd in out)
4469 (list file
4470 (concat pr-ps-printer-switch pr-ps-printer))
4471 ;; else, for others (cmd out in)
4472 (list (concat pr-ps-printer-switch pr-ps-printer)
4473 file)))))))
4476 ;;;###autoload
4477 (defun pr-ps-file-ps-print (filename)
4478 "Send PostScript file FILENAME to printer or use ghostscript to print it."
4479 (interactive (list (pr-ps-infile-preprint
4480 (if pr-print-using-ghostscript
4481 "Print preview "
4482 "Print "))))
4483 (if pr-print-using-ghostscript
4484 (pr-ps-file-using-ghostscript filename)
4485 (pr-ps-file-print filename)))
4488 ;;;###autoload
4489 (defun pr-ps-file-up-ps-print (n-up ifilename &optional ofilename)
4490 "Process a PostScript file IFILENAME and send it to printer.
4492 Interactively, the command prompts for N-UP printing number, for an input
4493 PostScript file IFILENAME and, when you use a prefix argument (C-u), the
4494 command prompts the user for an output PostScript file name OFILENAME, and
4495 saves the PostScript image in that file instead of sending it to the printer.
4497 Noninteractively, if N-UP is nil, prompts for N-UP printing number. The
4498 argument IFILENAME is treated as follows: if it's t, prompts for an input
4499 PostScript file name; otherwise, it *must* be a string that it's an input
4500 PostScript file name. The argument OFILENAME is treated as follows: if it's
4501 nil, send the image to the printer. If OFILENAME is a string, save the
4502 PostScript image in a file with that name. If OFILENAME is t, prompts for a
4503 file name."
4504 (interactive (pr-interactive-n-up-inout
4505 (if pr-print-using-ghostscript
4506 "PS print GS"
4507 "PS print")))
4508 (let ((outfile (pr-ps-utility-args 'n-up 'ifilename 'ofilename
4509 (if pr-print-using-ghostscript
4510 "PS print GS "
4511 "PS print "))))
4512 (pr-ps-utility-process n-up ifilename outfile)
4513 (unless ofilename
4514 (pr-ps-file-ps-print outfile)
4515 (pr-delete-file outfile))))
4518 ;;;###autoload
4519 (defun pr-toggle-file-duplex ()
4520 "Toggle duplex for PostScript file."
4521 (interactive)
4522 (pr-toggle-file-duplex-menu t))
4525 ;;;###autoload
4526 (defun pr-toggle-file-tumble ()
4527 "Toggle tumble for PostScript file.
4529 If tumble is off, produces a printing suitable for binding on the left or
4530 right.
4531 If tumble is on, produces a printing suitable for binding at the top or
4532 bottom."
4533 (interactive)
4534 (pr-toggle-file-tumble-menu t))
4537 ;;;###autoload
4538 (defun pr-toggle-file-landscape ()
4539 "Toggle landscape for PostScript file."
4540 (interactive)
4541 (pr-toggle-file-landscape-menu t))
4544 ;;;###autoload
4545 (defun pr-toggle-ghostscript ()
4546 "Toggle printing using ghostscript."
4547 (interactive)
4548 (pr-toggle-ghostscript-menu t))
4551 ;;;###autoload
4552 (defun pr-toggle-faces ()
4553 "Toggle printing with faces."
4554 (interactive)
4555 (pr-toggle-faces-menu t))
4558 ;;;###autoload
4559 (defun pr-toggle-spool ()
4560 "Toggle spooling."
4561 (interactive)
4562 (pr-toggle-spool-menu t))
4565 ;;;###autoload
4566 (defun pr-toggle-duplex ()
4567 "Toggle duplex."
4568 (interactive)
4569 (pr-toggle-duplex-menu t))
4572 ;;;###autoload
4573 (defun pr-toggle-tumble ()
4574 "Toggle tumble.
4576 If tumble is off, produces a printing suitable for binding on the left or
4577 right.
4578 If tumble is on, produces a printing suitable for binding at the top or
4579 bottom."
4580 (interactive)
4581 (pr-toggle-tumble-menu t))
4584 ;;;###autoload
4585 (defun pr-toggle-landscape ()
4586 "Toggle landscape."
4587 (interactive)
4588 (pr-toggle-landscape-menu t))
4591 ;;;###autoload
4592 (defun pr-toggle-upside-down ()
4593 "Toggle upside-down."
4594 (interactive)
4595 (pr-toggle-upside-down-menu t))
4598 ;;;###autoload
4599 (defun pr-toggle-line ()
4600 "Toggle line number."
4601 (interactive)
4602 (pr-toggle-line-menu t))
4605 ;;;###autoload
4606 (defun pr-toggle-zebra ()
4607 "Toggle zebra stripes."
4608 (interactive)
4609 (pr-toggle-zebra-menu t))
4612 ;;;###autoload
4613 (defun pr-toggle-header ()
4614 "Toggle printing header."
4615 (interactive)
4616 (pr-toggle-header-menu t))
4619 ;;;###autoload
4620 (defun pr-toggle-header-frame ()
4621 "Toggle printing header frame."
4622 (interactive)
4623 (pr-toggle-header-frame-menu t))
4626 ;;;###autoload
4627 (defun pr-toggle-lock ()
4628 "Toggle menu lock."
4629 (interactive)
4630 (pr-toggle-lock-menu t))
4633 ;;;###autoload
4634 (defun pr-toggle-region ()
4635 "Toggle auto region."
4636 (interactive)
4637 (pr-toggle-region-menu t))
4640 ;;;###autoload
4641 (defun pr-toggle-mode ()
4642 "Toggle auto mode."
4643 (interactive)
4644 (pr-toggle-mode-menu t))
4647 ;;;###autoload
4648 (defun pr-customize (&rest ignore)
4649 "Customization of the `printing' group."
4650 (interactive)
4651 (customize-group 'printing))
4654 ;;;###autoload
4655 (defun lpr-customize (&rest ignore)
4656 "Customization of the `lpr' group."
4657 (interactive)
4658 (customize-group 'lpr))
4661 ;;;###autoload
4662 (defun pr-help (&rest ignore)
4663 "Help for the printing package."
4664 (interactive)
4665 (pr-show-setup pr-help-message "*Printing Help*"))
4668 ;;;###autoload
4669 (defun pr-ps-name ()
4670 "Interactively select a PostScript printer."
4671 (interactive)
4672 (pr-menu-set-ps-title
4673 (pr-complete-alist "PostScript printer"
4674 pr-ps-printer-alist pr-ps-name)))
4677 ;;;###autoload
4678 (defun pr-txt-name ()
4679 "Interactively select a text printer."
4680 (interactive)
4681 (pr-menu-set-txt-title
4682 (pr-complete-alist "Text printer"
4683 pr-txt-printer-alist pr-txt-name)))
4686 ;;;###autoload
4687 (defun pr-ps-utility ()
4688 "Interactively select a PostScript utility."
4689 (interactive)
4690 (pr-menu-set-utility-title
4691 (pr-complete-alist "Postscript utility"
4692 pr-ps-utility-alist pr-ps-utility)))
4695 ;;;###autoload
4696 (defun pr-show-ps-setup (&rest ignore)
4697 "Show current ps-print settings."
4698 (interactive)
4699 (pr-show-setup (ps-setup) "*PS Setup*"))
4702 ;;;###autoload
4703 (defun pr-show-pr-setup (&rest ignore)
4704 "Show current printing settings."
4705 (interactive)
4706 (pr-show-setup (pr-setup) "*PR Setup*"))
4709 ;;;###autoload
4710 (defun pr-show-lpr-setup (&rest ignore)
4711 "Show current lpr settings."
4712 (interactive)
4713 (pr-show-setup (lpr-setup) "*LPR Setup*"))
4716 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4717 ;; Fast Commands
4720 ;;;###autoload
4721 (defun pr-ps-fast-fire (n-up &optional select)
4722 "Fast fire function for PostScript printing.
4724 If a region is active, the region will be printed instead of the whole buffer.
4725 Also if the current major-mode is defined in `pr-mode-alist', the settings in
4726 `pr-mode-alist' will be used, that is, the current buffer or region will be
4727 printed using `pr-ps-mode-ps-print'.
4730 Interactively, you have the following situations:
4732 M-x pr-ps-fast-fire RET
4733 The command prompts the user for a N-UP value and printing will
4734 immediatelly be done using the current active printer.
4736 C-u M-x pr-ps-fast-fire RET
4737 C-u 0 M-x pr-ps-fast-fire RET
4738 The command prompts the user for a N-UP value and also for a current
4739 PostScript printer, then printing will immediatelly be done using the new
4740 current active printer.
4742 C-u 1 M-x pr-ps-fast-fire RET
4743 The command prompts the user for a N-UP value and also for a file name,
4744 and saves the PostScript image in that file instead of sending it to the
4745 printer.
4747 C-u 2 M-x pr-ps-fast-fire RET
4748 The command prompts the user for a N-UP value, then for a current
4749 PostScript printer and, finally, for a file name. Then change the active
4750 printer to that chosen by user and saves the PostScript image in
4751 that file instead of sending it to the printer.
4754 Noninteractively, the argument N-UP should be a positive integer greater than
4755 zero and the argument SELECT is treated as follows:
4757 If it's nil, send the image to the printer.
4759 If it's a list or an integer lesser or equal to zero, the command prompts
4760 the user for a current PostScript printer, then printing will immediatelly
4761 be done using the new current active printer.
4763 If it's an integer equal to 1, the command prompts the user for a file name
4764 and saves the PostScript image in that file instead of sending it to the
4765 printer.
4767 If it's an integer greater or equal to 2, the command prompts the user for a
4768 current PostScript printer and for a file name. Then change the active
4769 printer to that chosen by user and saves the PostScript image in that file
4770 instead of sending it to the printer.
4772 If it's a symbol which it's defined in `pr-ps-printer-alist', it's the new
4773 active printer and printing will immediatelly be done using the new active
4774 printer.
4776 Otherwise, send the image to the printer.
4779 Note that this command always behaves as if `pr-auto-region' and `pr-auto-mode'
4780 are both set to t."
4781 (interactive (list (pr-interactive-n-up (pr-prompt-gs "PS print fast"))
4782 current-prefix-arg))
4783 (let ((pr-auto-region t)
4784 (pr-auto-mode t)
4785 filename)
4786 (cond ((null select))
4787 ((listp select)
4788 (pr-ps-name))
4789 ((and (symbolp select)
4790 (assq select pr-ps-printer-alist))
4791 (pr-menu-set-ps-title select))
4792 ((integerp select)
4793 (and (/= select 1)
4794 (pr-ps-name))
4795 (and (>= select 1) (not pr-spool-p)
4796 (setq filename (pr-ps-outfile-preprint
4797 (if pr-print-using-ghostscript
4798 "Fast GS "
4799 "Fast "))))))
4800 (pr-ps-buffer-ps-print
4801 (if (integerp n-up)
4802 (min (max n-up 1) 100)
4803 (error "n-up must be an integer greater than zero"))
4804 filename)))
4807 ;;;###autoload
4808 (defun pr-txt-fast-fire (&optional select-printer)
4809 "Fast fire function for text printing.
4811 If a region is active, the region will be printed instead of the whole buffer.
4812 Also if the current major-mode is defined in `pr-mode-alist', the settings in
4813 `pr-mode-alist' will be used, that is, the current buffer or region will be
4814 printed using `pr-txt-mode'.
4816 Interactively, when you use a prefix argument (C-u), the command prompts the
4817 user for a new active text printer.
4819 Noninteractively, the argument SELECT-PRINTER is treated as follows:
4821 If it's nil, the printing is sent to the current active text printer.
4823 If it's a symbol which it's defined in `pr-txt-printer-alist', it's the new
4824 active printer and printing will immediatelly be done using the new active
4825 printer.
4827 If it's non-nil, the command prompts the user for a new active text printer.
4829 Note that this command always behaves as if `pr-auto-region' and `pr-auto-mode'
4830 are both set to t."
4831 (interactive (list current-prefix-arg))
4832 (cond ((null select-printer))
4833 ((and (symbolp select-printer)
4834 (assq select-printer pr-txt-printer-alist))
4835 (pr-menu-set-txt-title select-printer))
4837 (pr-txt-name)))
4838 (let ((pr-auto-region t)
4839 (pr-auto-mode t))
4840 (pr-txt-buffer)))
4843 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4844 ;; Utilities
4847 (defun pr-setup ()
4848 "Return the current `printing' setup.
4850 This is *not* an interactive command.
4851 One way to see `printing' setup is to switch to a *Scratch* buffer and type:
4853 M-: (insert (pr-setup)) RET
4855 Or choose the menu option Printing/Show Settings/printing."
4856 (let (ps-prefix-quote)
4857 (mapconcat
4858 #'ps-print-quote
4859 (list
4860 (concat "\n;;; printing.el version " pr-version "\n")
4861 ";; internal vars"
4862 (ps-comment-string "emacs-version " emacs-version)
4863 (ps-comment-string "pr-txt-command " pr-txt-command)
4864 (ps-comment-string "pr-txt-switches "
4865 (pr-switches-string pr-txt-switches "pr-txt-switches"))
4866 (ps-comment-string "pr-txt-printer " pr-txt-printer)
4867 (ps-comment-string "pr-ps-command " pr-ps-command)
4868 (ps-comment-string "pr-ps-switches "
4869 (pr-switches-string pr-ps-switches "pr-ps-switches"))
4870 (ps-comment-string "pr-ps-printer-switch" pr-ps-printer-switch)
4871 (ps-comment-string "pr-ps-printer " pr-ps-printer)
4872 (ps-comment-string "pr-cygwin-system " pr-cygwin-system)
4873 (ps-comment-string "ps-windows-system " ps-windows-system)
4874 (ps-comment-string "ps-lp-system " ps-lp-system)
4876 '(14 . pr-path-style)
4877 '(14 . pr-path-alist)
4879 '(21 . pr-txt-name)
4880 '(21 . pr-txt-printer-alist)
4882 '(20 . pr-ps-name)
4883 '(20 . pr-ps-printer-alist)
4885 '(20 . pr-temp-dir)
4886 '(20 . pr-ps-temp-file)
4887 '(20 . pr-file-modes)
4888 '(20 . pr-delete-temp-file)
4889 '(20 . pr-list-directory)
4891 '(17 . pr-gv-command)
4892 '(17 . pr-gs-command)
4893 '(17 . pr-gs-switches)
4894 '(17 . pr-gs-device)
4895 '(17 . pr-gs-resolution)
4897 '(27 . pr-print-using-ghostscript)
4898 '(27 . pr-faces-p)
4899 '(27 . pr-spool-p)
4900 '(27 . pr-file-landscape)
4901 '(27 . pr-file-duplex)
4902 '(27 . pr-file-tumble)
4903 '(27 . pr-auto-region)
4904 '(27 . pr-auto-mode)
4906 '(20 . pr-ps-utility)
4907 '(20 . pr-ps-utility-alist)
4909 '(14 . pr-mode-alist)
4911 '(20 . pr-menu-lock)
4912 '(20 . pr-menu-char-height)
4913 '(20 . pr-menu-char-width)
4915 '(20 . pr-setting-database)
4917 '(22 . pr-visible-entry-list)
4919 '(22 . pr-buffer-verbose)
4920 '(22 . pr-buffer-name)
4921 '(22 . pr-buffer-name-ignore)
4922 ")\n\n;;; printing.el - end of settings\n")
4923 "\n")))
4926 (defun lpr-setup ()
4927 "Return the current `lpr' setup.
4929 This is *not* an interactive command.
4930 One way to see `lpr' setup is to switch to a *Scratch* buffer and type:
4932 M-: (insert (lpr-setup)) RET
4934 Or choose the menu option Printing/Show Settings/lpr."
4935 (let (ps-prefix-quote)
4936 (mapconcat
4937 #'ps-print-quote
4938 (list
4939 "\n;;; lpr.el settings\n"
4940 (ps-comment-string "emacs-version" emacs-version)
4942 '(25 . printer-name)
4943 '(25 . lpr-switches)
4944 '(25 . lpr-add-switches)
4945 '(25 . lpr-command)
4946 '(25 . lpr-headers-switches)
4947 '(25 . print-region-function)
4948 '(25 . lpr-page-header-program)
4949 '(25 . lpr-page-header-switches)
4950 ")\n\n;;; lpr.el - end of settings\n")
4951 "\n")))
4954 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4955 ;; mh-e (adapted from mh-e-init.el -- Tom Vogels <tov@ece.cmu.edu>)
4957 (declare-function mh-get-msg-num "mh-utils" (error-if-no-message))
4958 (declare-function mh-show "mh-show" (&optional message redisplay-flag))
4959 (declare-function mh-start-of-uncleaned-message "mh-show" ())
4960 (defvar mh-show-buffer)
4963 (defun pr-article-date ()
4964 "Find the date of an article or mail message in current buffer.
4965 Return only the dayname, if present, weekday, month, and year."
4966 (save-excursion
4967 (goto-char (point-min))
4968 (if (re-search-forward
4969 "^Date:[ \t]+\\(\\([A-Za-z]+, \\)?[0-9]+ [A-Za-z]+ [0-9]+\\)" nil t)
4970 (buffer-substring (match-beginning 1) (match-end 1))
4971 (format-time-string "%Y/%m/%d"))))
4974 (defun pr-mh-current-message ()
4975 "Go to mh-inbox current message."
4976 (let ((msg (or (mh-get-msg-num nil) 0)))
4977 (mh-show)
4978 (set-buffer mh-show-buffer)
4979 (goto-char (point-min))
4980 (mh-start-of-uncleaned-message)
4981 (message "Printing message %d" msg)))
4984 (defun pr-mh-print-1 (n-up filename header-list)
4985 "Print mh-inbox current message in PostScript."
4986 (save-excursion
4987 (save-window-excursion
4988 (pr-mh-current-message)
4989 (pr-mode-print n-up filename header-list (point)))))
4992 (defun pr-mh-lpr-1 (header-list)
4993 "Print mh-inbox current message in text printer."
4994 (save-excursion
4995 (save-window-excursion
4996 (pr-mh-current-message)
4997 (pr-mode-lpr header-list (point)))))
5000 (defalias 'pr-mh-print-2 'pr-mode-print)
5003 (defalias 'pr-mh-lpr-2 'pr-mode-lpr)
5006 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5007 ;; rmail (hacked from ps-print.el)
5010 (defun pr-rmail-lpr (header-list)
5011 "Print RMAIL current message in text printer."
5012 (pr-lpr-message-from-summary header-list
5013 'rmail-buffer 'rmail-summary-buffer))
5016 (defun pr-rmail-print (n-up filename header-list)
5017 "Print RMAIL current message in PostScript."
5018 (pr-ps-message-from-summary n-up filename header-list
5019 'rmail-buffer 'rmail-summary-buffer))
5022 (defun pr-ps-message-from-summary (n-up filename header-list
5023 summary-buffer summary-default)
5024 "Print current message in PostScript."
5025 (let ((buf (or (and (boundp summary-buffer)
5026 (symbol-value summary-buffer))
5027 (symbol-value summary-default))))
5028 (and (get-buffer buf)
5029 (with-current-buffer buf
5030 (pr-mode-print n-up filename header-list)))))
5033 (defun pr-lpr-message-from-summary (header-list summary-buffer summary-default)
5034 "Print current message in text printer."
5035 (let ((buf (or (and (boundp summary-buffer)
5036 (symbol-value summary-buffer))
5037 (symbol-value summary-default))))
5038 (and (get-buffer buf)
5039 (with-current-buffer buf
5040 (pr-mode-lpr header-list)))))
5043 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5044 ;; gnus (hacked from ps-print.el)
5047 (defvar pr-gnus-article "*Article*")
5050 (defun pr-gnus-print (n-up filename header-list)
5051 "Print *Article* current message in PostScript."
5052 (pr-ps-message-from-summary n-up filename header-list
5053 'gnus-article-buffer 'pr-gnus-article))
5056 (defun pr-gnus-lpr (header-list)
5057 "Print *Article* current message in text printer."
5058 (pr-lpr-message-from-summary header-list
5059 'gnus-article-buffer 'pr-gnus-article))
5062 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5063 ;; vm (hacked from ps-print.el)
5066 (defvar pr-vm-summary "")
5069 (defun pr-vm-print (n-up filename header-list)
5070 "Print current vm message in PostScript."
5071 (pr-ps-message-from-summary n-up filename header-list
5072 'vm-mail-buffer 'pr-vm-summary))
5075 (defun pr-vm-lpr (header-list)
5076 "Print current vm message in text printer."
5077 (pr-lpr-message-from-summary header-list
5078 'vm-mail-buffer 'pr-vm-summary))
5081 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5082 ;; Mode Functions
5085 (defun pr-ps-mode (n-up filename)
5086 "If current major mode is declared, print it in PostScript."
5087 (let ((args (pr-mode-alist-p)))
5088 (if args
5089 (let ((fun (cdr args)))
5090 (funcall (car fun) n-up filename (cdr fun))
5092 (ding)
5093 (message "`%s' major mode not declared." major-mode)
5094 nil)))
5097 (defmacro pr-local-variable (header-list &rest body)
5098 `(save-excursion
5099 (let ((ps-header-lines (or (nth 0 ,header-list) ps-header-lines))
5100 (ps-left-header (or (nth 1 ,header-list) ps-left-header))
5101 (ps-right-header (or (nth 2 ,header-list) ps-right-header))
5102 ps-razzle-dazzle)
5103 (let ((local-var-list (pr-eval-local-alist (nthcdr 4 ,header-list))))
5104 ,@body
5105 (and (nth 3 ,header-list)
5106 (pr-kill-local-variable local-var-list))))))
5109 (defun pr-mode-print (n-up filename header-list &optional from to)
5110 "Print current major mode in PostScript."
5111 (pr-local-variable
5112 header-list
5113 (let ((file (pr-ps-file filename))
5114 (start (cond (from)
5115 ((pr-region-active-p) (region-beginning))
5116 (t nil)
5118 (pr-text2ps (pr-region-active-symbol start) n-up file start
5119 (cond (to)
5120 ((pr-region-active-p) (region-end))
5121 (from (point-max))
5123 (unless (or pr-spool-p filename)
5124 (pr-ps-file-print file)
5125 (pr-delete-file file)))))
5128 (defun pr-mode-lpr (header-list &optional from to)
5129 "Print current major mode in text printer."
5130 (pr-local-variable
5131 header-list
5132 (pr-txt-print (cond (from)
5133 ((pr-region-active-p) (region-beginning))
5134 (t (point-min)))
5135 (cond (to)
5136 ((pr-region-active-p) (region-end))
5137 (t (point-max))))))
5140 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5141 ;; Menu Lock
5144 (defconst pr-menu-entry-alist
5145 '((postscript . 3)
5146 (text . 3)
5147 (postscript-options . 9)
5148 (postscript-process . 3)
5149 (printing . 3)
5150 (help . 3)
5152 "Alist that associates menu part with number of items per part.
5154 It's used by `pr-menu-index'.
5156 Each element has the form:
5158 (MENU-PART . NUMBER-OF-ITEMS)
5160 See `pr-visible-entry-alist'.")
5163 (defun pr-menu-index (entry index)
5164 (let ((base-list
5165 (cond ((eq entry 'text)
5166 '(postscript))
5167 ((eq entry 'postscript-options)
5168 '(postscript text))
5169 ((eq entry 'postscript-process)
5170 '(postscript text postscript-options))
5171 ((eq entry 'printing)
5172 '(postscript text postscript-options postscript-process))
5174 nil)
5176 key)
5177 (while base-list
5178 (setq key (car base-list)
5179 base-list (cdr base-list))
5180 (and (pr-visible-p key)
5181 (setq index (+ index
5182 (cdr (assq key pr-menu-entry-alist)))))))
5183 (+ index 2))
5186 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5187 ;; Printer & Utility Selection
5190 (defun pr-update-var (var-sym alist)
5191 (or (assq (symbol-value var-sym) alist)
5192 (set var-sym (car (car alist)))))
5195 (defun pr-update-menus (&optional force)
5196 "Update utility, PostScript and text printer menus.
5198 If FORCE is non-nil, update menus doesn't matter if `pr-ps-printer-alist',
5199 `pr-txt-printer-alist' or `pr-ps-utility-alist' were modified or not;
5200 otherwise, update PostScript printer menu if `pr-ps-printer-menu-modified' is
5201 non-nil, update text printer menu if `pr-txt-printer-menu-modified' is
5202 non-nil, and update PostScript File menus if `pr-ps-utility-menu-modified' is
5203 non-nil.
5205 If menu binding was not done, calls `pr-menu-bind'."
5206 (interactive "P")
5207 (if pr-menu-print-item ; since v6.8.4
5208 ;; There was no menu binding yet, so do it now!
5209 ;; This is a hack to be compatible with old versions of printing.
5210 ;; So, user does not need to change printing calling in init files.
5211 (pr-menu-bind)
5212 ;; Here menu binding is ok.
5213 (pr-update-var 'pr-ps-name pr-ps-printer-alist)
5214 (pr-update-var 'pr-txt-name pr-txt-printer-alist)
5215 (pr-update-var 'pr-ps-utility pr-ps-utility-alist)
5216 (pr-do-update-menus force)))
5219 (defun pr-menu-create (name alist var-sym fun entry index)
5220 (cons name
5221 (mapcar
5222 #'(lambda (elt)
5223 (let ((sym (car elt)))
5224 (vector
5225 (symbol-name sym)
5226 (list fun (list 'quote sym) nil (list 'quote entry) index)
5227 :style 'radio
5228 :selected (list 'eq var-sym (list 'quote sym)))))
5229 alist)))
5232 (defun pr-ps-set-utility (value)
5233 (let ((item (cdr (assq value pr-ps-utility-alist))))
5234 (or item
5235 (error
5236 "Invalid PostScript utility name `%s' for variable `pr-ps-utility'"
5237 value))
5238 (setq pr-ps-utility value)
5239 (pr-eval-alist (nthcdr 9 item)))
5240 (pr-update-mode-line))
5243 (defun pr-ps-set-printer (value)
5244 (let ((ps (cdr (assq value pr-ps-printer-alist))))
5245 (or ps
5246 (error
5247 "Invalid PostScript printer name `%s' for variable `pr-ps-name'"
5248 value))
5249 (setq pr-ps-name value
5250 pr-ps-command (pr-dosify-file-name (nth 0 ps))
5251 pr-ps-switches (nth 1 ps)
5252 pr-ps-printer-switch (nth 2 ps)
5253 pr-ps-printer (nth 3 ps))
5254 (or (stringp pr-ps-command)
5255 (setq pr-ps-command
5256 (cond (ps-windows-system "print")
5257 (ps-lp-system "lp")
5258 (t "lpr")
5260 (or (stringp pr-ps-printer-switch)
5261 (setq pr-ps-printer-switch
5262 (cond (ps-windows-system "/D:")
5263 (ps-lp-system "-d")
5264 (t "-P")
5266 (pr-eval-alist (nthcdr 4 ps)))
5267 (pr-update-mode-line))
5270 (defun pr-txt-set-printer (value)
5271 (let ((txt (cdr (assq value pr-txt-printer-alist))))
5272 (or txt
5273 (error "Invalid text printer name `%s' for variable `pr-txt-name'"
5274 value))
5275 (setq pr-txt-name value
5276 pr-txt-command (pr-dosify-file-name (nth 0 txt))
5277 pr-txt-switches (nth 1 txt)
5278 pr-txt-printer (nth 2 txt)))
5279 (or (stringp pr-txt-command)
5280 (setq pr-txt-command
5281 (cond (ps-windows-system "print")
5282 (ps-lp-system "lp")
5283 (t "lpr")
5285 (pr-update-mode-line))
5288 (defun pr-eval-alist (alist)
5289 (mapcar #'(lambda (option)
5290 (let ((var-sym (car option))
5291 (value (cdr option)))
5292 (if (eq var-sym 'inherits-from:)
5293 (pr-eval-setting-alist value 'global)
5294 (set var-sym (eval value)))))
5295 alist))
5298 (defun pr-eval-local-alist (alist)
5299 (let (local-list)
5300 (mapc #'(lambda (option)
5301 (let ((var-sym (car option))
5302 (value (cdr option)))
5303 (setq local-list
5304 (if (eq var-sym 'inherits-from:)
5305 (nconc (pr-eval-setting-alist value) local-list)
5306 (set (make-local-variable var-sym) (eval value))
5307 (cons var-sym local-list)))))
5308 alist)
5309 local-list))
5312 (defun pr-eval-setting-alist (key &optional global old)
5313 (let ((setting (cdr (assq key pr-setting-database))))
5314 (and setting
5315 (let ((inherits (nth 0 setting))
5316 (local (nth 1 setting))
5317 (kill (nth 2 setting))
5318 local-list)
5319 (and local global
5320 (progn
5321 (ding)
5322 (message "There are local buffer settings for `%S'." key)
5323 (setq global nil)))
5324 (and inherits
5325 (if (memq inherits old)
5326 (error "Circular inheritance for `%S'" inherits)
5327 (setq local-list
5328 (pr-eval-setting-alist inherits global
5329 (cons inherits old)))))
5330 (mapc
5331 (cond ((not local) ; global settings
5332 #'(lambda (option)
5333 (let ((var-sym (car option)))
5334 (or (eq var-sym 'inherits-from:)
5335 (set var-sym (eval (cdr option)))))))
5336 (kill ; local settings with killing
5337 #'(lambda (option)
5338 (let ((var-sym (car option)))
5339 (unless (eq var-sym 'inherits-from:)
5340 (setq local-list (cons var-sym local-list))
5341 (set (make-local-variable var-sym)
5342 (eval (cdr option)))))))
5343 (t ; local settings without killing
5344 #'(lambda (option)
5345 (let ((var-sym (car option)))
5346 (or (eq var-sym 'inherits-from:)
5347 (set (make-local-variable var-sym)
5348 (eval (cdr option))))))))
5349 (nthcdr 3 setting))
5350 local-list))))
5353 (defun pr-kill-local-variable (local-var-list)
5354 (mapcar 'kill-local-variable local-var-list))
5357 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
5358 ;; Internal Functions (II)
5361 (defun pr-toggle (var-sym mess entry index horizontal state
5362 &optional path no-menu)
5363 (set var-sym (not (symbol-value var-sym)))
5364 (message "%s is %s" mess (if (symbol-value var-sym) "on" "off"))
5365 (or no-menu
5366 (pr-menu-lock entry index horizontal state path)))
5369 (defun pr-toggle-file-duplex-menu (&optional no-menu)
5370 (interactive)
5371 (pr-toggle 'pr-file-duplex "PS file duplex" nil 7 5 nil
5372 '("PostScript Print" "File") no-menu))
5375 (defun pr-toggle-file-tumble-menu (&optional no-menu)
5376 (interactive)
5377 (pr-toggle 'pr-file-tumble "PS file tumble" nil 8 5 nil
5378 '("PostScript Print" "File") no-menu))
5381 (defun pr-toggle-file-landscape-menu (&optional no-menu)
5382 (interactive)
5383 (pr-toggle 'pr-file-landscape "PS file landscape" nil 6 5 nil
5384 '("PostScript Print" "File") no-menu))
5387 (defun pr-toggle-ghostscript-menu (&optional no-menu)
5388 (interactive)
5389 (pr-toggle 'pr-print-using-ghostscript "Printing using ghostscript"
5390 'postscript-process 2 12 'toggle nil no-menu))
5393 (defun pr-toggle-faces-menu (&optional no-menu)
5394 (interactive)
5395 (pr-toggle 'pr-faces-p "Printing with faces"
5396 'postscript-process 1 12 'toggle nil no-menu))
5399 (defun pr-toggle-spool-menu (&optional no-menu)
5400 (interactive)
5401 (pr-toggle 'pr-spool-p "Spooling printing"
5402 'postscript-process 0 12 'toggle nil no-menu))
5405 (defun pr-toggle-duplex-menu (&optional no-menu)
5406 (interactive)
5407 (pr-toggle 'ps-spool-duplex "Printing duplex"
5408 'postscript-options 5 12 'toggle nil no-menu))
5411 (defun pr-toggle-tumble-menu (&optional no-menu)
5412 (interactive)
5413 (pr-toggle 'ps-spool-tumble "Tumble"
5414 'postscript-options 6 12 'toggle nil no-menu))
5417 (defun pr-toggle-landscape-menu (&optional no-menu)
5418 (interactive)
5419 (pr-toggle 'ps-landscape-mode "Landscape"
5420 'postscript-options 0 12 'toggle nil no-menu))
5423 (defun pr-toggle-upside-down-menu (&optional no-menu)
5424 (interactive)
5425 (pr-toggle 'ps-print-upside-down "Upside-Down"
5426 'postscript-options 7 12 'toggle nil no-menu))
5429 (defun pr-toggle-line-menu (&optional no-menu)
5430 (interactive)
5431 (pr-toggle 'ps-line-number "Line number"
5432 'postscript-options 3 12 'toggle nil no-menu))
5435 (defun pr-toggle-zebra-menu (&optional no-menu)
5436 (interactive)
5437 (pr-toggle 'ps-zebra-stripes "Zebra stripe"
5438 'postscript-options 4 12 'toggle nil no-menu))
5441 (defun pr-toggle-header-menu (&optional no-menu)
5442 (interactive)
5443 (pr-toggle 'ps-print-header "Print header"
5444 'postscript-options 1 12 'toggle nil no-menu))
5447 (defun pr-toggle-header-frame-menu (&optional no-menu)
5448 (interactive)
5449 (pr-toggle 'ps-print-header-frame "Print header frame"
5450 'postscript-options 2 12 'toggle nil no-menu))
5453 (defun pr-toggle-lock-menu (&optional no-menu)
5454 (interactive)
5455 (pr-toggle 'pr-menu-lock "Menu lock"
5456 'printing 2 12 'toggle nil no-menu))
5459 (defun pr-toggle-region-menu (&optional no-menu)
5460 (interactive)
5461 (pr-toggle 'pr-auto-region "Auto region"
5462 'printing 0 12 'toggle nil no-menu))
5465 (defun pr-toggle-mode-menu (&optional no-menu)
5466 (interactive)
5467 (pr-toggle 'pr-auto-mode "Auto mode"
5468 'printing 1 12 'toggle nil no-menu))
5471 (defun pr-prompt (str)
5472 (if (pr-auto-mode-p)
5473 (concat str " mode")
5474 (pr-region-active-string str)))
5477 (defun pr-prompt-region (str)
5478 (concat str (if (pr-auto-mode-p)
5479 " mode"
5480 " region")))
5483 (defun pr-prompt-gs (str)
5484 (if (pr-using-ghostscript-p)
5485 (concat str " GS")
5486 str))
5489 (defun pr-region-active-symbol (&optional region-p)
5490 (if (or region-p (pr-region-active-p))
5491 'region
5492 'buffer))
5495 (defun pr-region-active-string (prefix)
5496 (concat prefix
5497 (if (pr-region-active-p)
5498 " region"
5499 " buffer")))
5502 (defun pr-show-setup (settings buffer-name)
5503 (with-output-to-temp-buffer buffer-name
5504 (princ settings)
5505 (help-print-return-message)))
5508 (defun pr-complete-alist (prompt alist default)
5509 (let ((collection (mapcar #'(lambda (elt)
5510 (setq elt (car elt))
5511 (cons (symbol-name elt) elt))
5512 alist)))
5513 (cdr (assoc (completing-read (concat prompt ": ")
5514 collection nil t
5515 (symbol-name default) nil
5516 (symbol-name default))
5517 collection))))
5520 (defun pr-delete-file (file)
5521 (and pr-delete-temp-file (file-exists-p file)
5522 (delete-file file)))
5525 (defun pr-expand-file-name (filename)
5526 (pr-dosify-file-name (expand-file-name filename)))
5529 (defun pr-ps-outfile-preprint (&optional mess)
5530 (let* ((prompt (format "%soutput PostScript file name: " (or mess "")))
5531 (res (read-file-name prompt default-directory "" nil)))
5532 (while (cond ((not (file-writable-p res))
5533 (ding)
5534 (setq prompt "is unwritable"))
5535 ((file-directory-p res)
5536 (ding)
5537 (setq prompt "is a directory"))
5538 ((file-exists-p res)
5539 (ding)
5540 (setq prompt "exists")
5541 (not (y-or-n-p (format "File `%s' exists; overwrite? "
5542 res))))
5543 (t nil))
5544 (setq res (read-file-name
5545 (format "File %s; PostScript file: " prompt)
5546 (file-name-directory res) nil nil
5547 (file-name-nondirectory res))))
5548 (pr-expand-file-name res)))
5551 (defun pr-ps-infile-preprint (&optional mess)
5552 (let* ((prompt (format "%sinput PostScript file name: " (or mess "")))
5553 (res (read-file-name prompt default-directory "" nil)))
5554 (while (cond ((not (file-exists-p res))
5555 (ding)
5556 (setq prompt "doesn't exist"))
5557 ((not (file-readable-p res))
5558 (ding)
5559 (setq prompt "is unreadable"))
5560 ((file-directory-p res)
5561 (ding)
5562 (setq prompt "is a directory"))
5563 (t nil))
5564 (setq res (read-file-name
5565 (format "File %s; PostScript file: " prompt)
5566 (file-name-directory res) nil nil
5567 (file-name-nondirectory res))))
5568 (pr-expand-file-name res)))
5571 (defun pr-ps-utility-args (n-up-sym infile-sym outfile-sym prompt)
5572 ;; check arguments for PostScript file processing.
5573 ;; n-up
5574 (or (symbol-value n-up-sym)
5575 (set n-up-sym (pr-interactive-n-up prompt)))
5576 ;; input file
5577 (and (eq (symbol-value infile-sym) t)
5578 (set infile-sym (pr-ps-infile-preprint prompt)))
5579 (or (symbol-value infile-sym)
5580 (error "%s: input PostScript file name is missing" prompt))
5581 (set infile-sym (pr-dosify-file-name (symbol-value infile-sym)))
5582 ;; output file
5583 (and (eq (symbol-value outfile-sym) t)
5584 (set outfile-sym (and current-prefix-arg
5585 (pr-ps-outfile-preprint prompt))))
5586 (and (symbol-value outfile-sym)
5587 (set outfile-sym (pr-dosify-file-name (symbol-value outfile-sym))))
5588 (pr-ps-file (symbol-value outfile-sym)))
5591 (defun pr-ps-utility-process (n-up infile outfile)
5592 ;; activate utility to process a PostScript file.
5593 (let (item)
5594 (and (stringp infile) (file-exists-p infile)
5595 (setq item (cdr (assq pr-ps-utility pr-ps-utility-alist)))
5596 (pr-call-process (nth 0 item)
5597 (pr-switches-string (nth 1 item)
5598 "pr-ps-utility-alist entry")
5599 (pr-switches-string (nth 8 item)
5600 "pr-ps-utility-alist entry")
5601 (and (nth 2 item)
5602 (format (nth 2 item) ps-paper-type))
5603 (format (nth 3 item) n-up)
5604 (and pr-file-landscape (nth 4 item))
5605 (and pr-file-duplex (nth 5 item))
5606 (and pr-file-tumble (nth 6 item))
5607 (pr-expand-file-name infile)
5608 (nth 7 item)
5609 (pr-expand-file-name outfile)))))
5612 (defun pr-remove-nil-from-list (lst)
5613 (while (and lst (null (car lst)))
5614 (setq lst (cdr lst)))
5615 (let ((b lst)
5616 (l (cdr lst)))
5617 (while l
5618 (if (car l)
5619 (setq b l
5620 l (cdr l))
5621 (setq l (cdr l))
5622 (setcdr b l))))
5623 lst)
5626 (defun pr-call-process (command &rest args)
5627 (let ((buffer (get-buffer-create "*Printing Command Output*"))
5628 (cmd (pr-command command))
5629 status)
5630 (setq args (pr-remove-nil-from-list args))
5631 ;; *Printing Command Output* == show command & args
5632 (with-current-buffer buffer
5633 (goto-char (point-max))
5634 (insert (format "%s %S\n" cmd args)))
5635 ;; *Printing Command Output* == show any return message from command
5636 (pr-save-file-modes
5637 (setq status
5638 (condition-case data
5639 (apply 'call-process cmd nil buffer nil args)
5640 ((quit error)
5641 (error-message-string data)))))
5642 ;; *Printing Command Output* == show exit status
5643 (with-current-buffer buffer
5644 (goto-char (point-max))
5645 (insert (format "Exit status: %s\n\n" status)))
5646 ;; message if error status
5647 (if (or (stringp status)
5648 (and (integerp status) (/= status 0)))
5649 (message
5650 "Printing error status: %s (see *Printing Command Output* buffer)"
5651 status))))
5654 (defun pr-txt-print (from to)
5655 (let ((lpr-command (pr-standard-file-name (pr-command pr-txt-command)))
5656 (lpr-switches (pr-switches pr-txt-switches "pr-txt-switches"))
5657 (printer-name pr-txt-printer))
5658 (lpr-region from to)))
5661 (defun pr-switches-string (switches mess)
5662 ;; If SWITCHES is nil, return nil.
5663 ;; Otherwise, return the list of string in a string.
5664 (and switches
5665 (mapconcat 'identity (pr-switches switches mess) " ")))
5668 (defun pr-switches (switches mess)
5669 (or (listp switches)
5670 (error "%S should have a list of strings" mess))
5671 (ps-flatten-list ; dynamic evaluation
5672 (mapcar 'ps-eval-switch switches)))
5675 (defun pr-ps-preview (kind n-up filename mess)
5676 (pr-set-n-up-and-filename 'n-up 'filename mess)
5677 (let ((file (pr-ps-file filename)))
5678 (pr-text2ps kind n-up file)
5679 (or pr-spool-p (pr-ps-file-preview file))))
5682 (defun pr-ps-using-ghostscript (kind n-up filename mess)
5683 (pr-set-n-up-and-filename 'n-up 'filename mess)
5684 (let ((file (pr-ps-file filename)))
5685 (pr-text2ps kind n-up file)
5686 (unless (or pr-spool-p filename)
5687 (pr-ps-file-using-ghostscript file)
5688 (pr-delete-file file))))
5691 (defun pr-ps-print (kind n-up filename mess)
5692 (pr-set-n-up-and-filename 'n-up 'filename mess)
5693 (let ((file (pr-ps-file filename)))
5694 (pr-text2ps kind n-up file)
5695 (unless (or pr-spool-p filename)
5696 (pr-ps-file-print file)
5697 (pr-delete-file file))))
5700 (defun pr-ps-file (&optional filename)
5701 (pr-dosify-file-name (or filename
5702 (make-temp-file
5703 (convert-standard-filename
5704 (expand-file-name pr-ps-temp-file pr-temp-dir))
5705 nil ".ps"))))
5708 (defun pr-interactive-n-up (mess)
5709 (or (stringp mess) (setq mess "*"))
5710 (save-match-data
5711 (let* ((fmt-prompt "%s[%s] N-up printing (default 1): ")
5712 (prompt "")
5713 (str (pr-read-string (format fmt-prompt prompt mess) "1" nil "1"))
5714 int)
5715 (while (if (string-match "^\\s *[0-9]+$" str)
5716 (setq int (string-to-number str)
5717 prompt (cond ((< int 1) "Integer below 1; ")
5718 ((> int 100) "Integer above 100; ")
5719 (t nil)))
5720 (setq prompt "Invalid integer syntax; "))
5721 (ding)
5722 (setq str
5723 (pr-read-string (format fmt-prompt prompt mess) str nil "1")))
5724 int)))
5727 (defun pr-interactive-dir (mess)
5728 (let* ((dir-name (file-name-directory (or (buffer-file-name)
5729 default-directory)))
5730 (fmt-prompt (concat "%s[" mess "] Directory to print: "))
5731 (dir (read-file-name (format fmt-prompt "")
5732 "" dir-name nil dir-name))
5733 prompt)
5734 (while (cond ((not (file-directory-p dir))
5735 (ding)
5736 (setq prompt "It's not a directory! "))
5737 ((not (file-readable-p dir))
5738 (ding)
5739 (setq prompt "Directory is unreadable! "))
5740 (t nil))
5741 (setq dir-name (file-name-directory dir)
5742 dir (read-file-name (format fmt-prompt prompt)
5743 "" dir-name nil dir-name)))
5744 (file-name-as-directory dir)))
5747 (defun pr-interactive-regexp (mess)
5748 (pr-read-string (format "[%s] File regexp to print: " mess) "" nil ""))
5751 (defun pr-interactive-dir-args (mess)
5752 (list
5753 ;; get directory argument
5754 (pr-interactive-dir mess)
5755 ;; get file name regexp
5756 (pr-interactive-regexp mess)))
5759 (defun pr-interactive-ps-dir-args (mess)
5760 (list
5761 ;; get n-up argument
5762 (pr-interactive-n-up mess)
5763 ;; get directory argument
5764 (pr-interactive-dir mess)
5765 ;; get file name regexp
5766 (pr-interactive-regexp mess)
5767 ;; get output file name
5768 (and (not pr-spool-p)
5769 (ps-print-preprint current-prefix-arg))))
5772 (defun pr-interactive-n-up-file (mess)
5773 (list
5774 ;; get n-up argument
5775 (pr-interactive-n-up mess)
5776 ;; get output file name
5777 (and (not pr-spool-p)
5778 (ps-print-preprint current-prefix-arg))))
5781 (defun pr-interactive-n-up-inout (mess)
5782 (list
5783 ;; get n-up argument
5784 (pr-interactive-n-up mess)
5785 ;; get input file name
5786 (pr-ps-infile-preprint (concat mess " "))
5787 ;; get output file name
5788 (ps-print-preprint current-prefix-arg)))
5791 (defun pr-set-outfilename (filename-sym)
5792 (and (not pr-spool-p)
5793 (eq (symbol-value filename-sym) t)
5794 (set filename-sym (and current-prefix-arg
5795 (ps-print-preprint current-prefix-arg))))
5796 (and (symbol-value filename-sym)
5797 (set filename-sym (pr-dosify-file-name (symbol-value filename-sym)))))
5800 (defun pr-set-n-up-and-filename (n-up-sym filename-sym mess)
5801 ;; n-up
5802 (or (symbol-value n-up-sym)
5803 (set n-up-sym (pr-interactive-n-up mess)))
5804 ;; output file
5805 (pr-set-outfilename filename-sym))
5808 (defun pr-set-dir-args (dir-sym regexp-sym mess)
5809 ;; directory
5810 (or (symbol-value dir-sym)
5811 (set dir-sym (pr-interactive-dir mess)))
5812 ;; file name regexp
5813 (or (symbol-value regexp-sym)
5814 (set regexp-sym (pr-interactive-regexp mess))))
5817 (defun pr-set-ps-dir-args (n-up-sym dir-sym regexp-sym filename-sym mess)
5818 ;; n-up
5819 (or (symbol-value n-up-sym)
5820 (set n-up-sym (pr-interactive-n-up mess)))
5821 ;; directory & file name regexp
5822 (pr-set-dir-args dir-sym regexp-sym mess)
5823 ;; output file
5824 (pr-set-outfilename filename-sym))
5827 (defun pr-find-buffer-visiting (file)
5828 (if (not (file-directory-p file))
5829 (find-buffer-visiting (if ps-windows-system
5830 (downcase file)
5831 file))
5832 (let ((truename (file-truename file))
5833 (blist (buffer-list))
5834 found)
5835 (while (and (not found) blist)
5836 (with-current-buffer (car blist)
5837 (and (eq major-mode 'dired-mode)
5838 (save-excursion
5839 (goto-char (point-min))
5840 (string= (buffer-substring-no-properties
5841 (+ (point-min) 2)
5842 (progn
5843 (end-of-line)
5844 (1- (point))))
5845 truename))
5846 (setq found (car blist))))
5847 (setq blist (cdr blist)))
5848 found)))
5851 (defun pr-file-list (dir file-regexp fun)
5852 (mapcar #'(lambda (file)
5853 (and (or pr-list-directory
5854 (not (file-directory-p file)))
5855 (let ((buffer (pr-find-buffer-visiting file))
5856 pop-up-windows
5857 pop-up-frames)
5858 (and (or buffer
5859 (file-readable-p file))
5860 (with-current-buffer (or buffer
5861 (find-file-noselect file))
5862 (funcall fun)
5863 (or buffer
5864 (kill-buffer (current-buffer))))))))
5865 (directory-files dir t file-regexp)))
5868 (defun pr-delete-file-if-exists (filename)
5869 (and (not pr-spool-p) (stringp filename) (file-exists-p filename)
5870 (delete-file filename)))
5873 (defun pr-ps-file-list (n-up dir file-regexp filename)
5874 (pr-delete-file-if-exists (setq filename (pr-expand-file-name filename)))
5875 (let ((pr-spool-p t))
5876 (pr-file-list dir file-regexp
5877 #'(lambda ()
5878 (if (pr-auto-mode-p)
5879 (pr-ps-mode n-up filename)
5880 (pr-text2ps 'buffer n-up filename)))))
5881 (or pr-spool-p
5882 (pr-despool-print filename)))
5885 (defun pr-text2ps (kind n-up filename &optional from to)
5886 (pr-save-file-modes
5887 (let ((ps-n-up-printing n-up)
5888 (ps-spool-config (and (eq ps-spool-config 'setpagedevice)
5889 'setpagedevice)))
5890 (pr-delete-file-if-exists filename)
5891 (cond (pr-faces-p
5892 (cond (pr-spool-p
5893 ;; pr-faces-p and pr-spool-p
5894 ;; here FILENAME arg is ignored
5895 (cond ((eq kind 'buffer)
5896 (ps-spool-buffer-with-faces))
5897 ((eq kind 'region)
5898 (ps-spool-region-with-faces (or from (point))
5899 (or to (mark))))
5901 ;; pr-faces-p and not pr-spool-p
5902 ((eq kind 'buffer)
5903 (ps-print-buffer-with-faces filename))
5904 ((eq kind 'region)
5905 (ps-print-region-with-faces (or from (point))
5906 (or to (mark)) filename))
5908 (pr-spool-p
5909 ;; not pr-faces-p and pr-spool-p
5910 ;; here FILENAME arg is ignored
5911 (cond ((eq kind 'buffer)
5912 (ps-spool-buffer))
5913 ((eq kind 'region)
5914 (ps-spool-region (or from (point)) (or to (mark))))
5916 ;; not pr-faces-p and not pr-spool-p
5917 ((eq kind 'buffer)
5918 (ps-print-buffer filename))
5919 ((eq kind 'region)
5920 (ps-print-region (or from (point)) (or to (mark)) filename))
5921 ))))
5924 (defun pr-command (command)
5925 "Return absolute file name specification for COMMAND.
5927 If COMMAND is an empty string, return it.
5929 If COMMAND is already an absolute file name specification, return it.
5930 Else it uses `pr-path-alist' to find COMMAND, if find it then return it;
5931 otherwise, gives an error.
5933 When using `pr-path-alist' to find COMMAND, the entries `cygwin', `windows' and
5934 `unix' are used (see `pr-path-alist' for documentation).
5936 If Emacs is running on Windows 95/98/NT/2000, tries to find COMMAND,
5937 COMMAND.exe, COMMAND.bat and COMMAND.com in this order."
5938 (if (string= command "")
5939 command
5940 (pr-dosify-file-name
5941 (or (pr-find-command command)
5942 (pr-path-command (cond (pr-cygwin-system 'cygwin)
5943 (ps-windows-system 'windows)
5944 (t 'unix))
5945 (file-name-nondirectory command)
5946 nil)
5947 (error "Command not found: %s"
5948 (file-name-nondirectory command))))))
5951 (defun pr-path-command (symbol command sym-list)
5952 (let ((lpath (cdr (assq symbol pr-path-alist)))
5953 cmd)
5954 ;; PATH expansion
5955 (and (eq symbol 'PATH) (null lpath)
5956 (setq lpath (parse-colon-path (getenv "PATH"))))
5957 (while (and lpath
5958 (not
5959 (setq cmd
5960 (let ((path (car lpath)))
5961 (cond
5962 ;; symbol expansion
5963 ((symbolp path)
5964 (and (not (memq path sym-list))
5965 (pr-path-command path command
5966 (cons path sym-list))))
5967 ;; normal path
5968 ((stringp path)
5969 (pr-find-command
5970 (expand-file-name
5971 (substitute-in-file-name
5972 (concat (file-name-as-directory path)
5973 command)))))
5974 )))))
5975 (setq lpath (cdr lpath)))
5976 cmd))
5979 (defun pr-find-command (cmd)
5980 (if ps-windows-system
5981 ;; windows system
5982 (let ((ext (cons (file-name-extension cmd t)
5983 (list ".exe" ".bat" ".com")))
5984 found)
5985 (setq cmd (file-name-sans-extension cmd))
5986 (while (and ext
5987 (setq found (concat cmd (car ext)))
5988 (not (and (file-regular-p found)
5989 (file-executable-p found))))
5990 (setq ext (cdr ext)
5991 found nil))
5992 found)
5993 ;; non-windows systems
5994 (and (file-regular-p cmd)
5995 (file-executable-p cmd)
5996 cmd)))
5999 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
6000 ;; Printing Interface (inspired by ps-print-interface.el)
6003 (eval-when-compile
6004 (require 'cus-edit)
6005 (require 'wid-edit)
6006 (require 'widget))
6009 (defvar pr-i-window-configuration nil)
6011 (defvar pr-i-buffer nil)
6012 (defvar pr-i-region nil)
6013 (defvar pr-i-mode nil)
6014 (defvar pr-i-despool nil)
6015 (defvar pr-i-ps-as-is t)
6016 (defvar pr-i-n-up 1)
6017 (defvar pr-i-directory "./")
6018 (defvar pr-i-regexp "")
6019 (defvar pr-i-ps-file "")
6020 (defvar pr-i-out-file "")
6021 (defvar pr-i-answer-yes nil)
6022 (defvar pr-i-process 'buffer)
6023 (defvar pr-i-ps-send 'printer)
6026 (defvar pr-interface-map nil
6027 "Keymap for pr-interface.")
6029 (unless pr-interface-map
6030 (let ((map (make-sparse-keymap)))
6031 (cond ((featurep 'xemacs) ; XEmacs
6032 (pr-set-keymap-parents map (list widget-keymap))
6033 (pr-set-keymap-name map 'pr-interface-map))
6034 (t ; GNU Emacs
6035 (pr-set-keymap-parents map widget-keymap)))
6036 (define-key map "q" 'pr-interface-quit)
6037 (define-key map "?" 'pr-interface-help)
6038 (setq pr-interface-map map)))
6041 (defmacro pr-interface-save (&rest body)
6042 `(with-current-buffer pr-i-buffer
6043 ,@body))
6046 (defun pr-create-interface ()
6047 "Create the front end for printing package."
6048 (setq pr-i-buffer (buffer-name (current-buffer))
6049 pr-i-region (ps-mark-active-p)
6050 pr-i-mode (pr-mode-alist-p)
6051 pr-i-window-configuration (current-window-configuration))
6053 (put 'pr-i-process 'pr-widget-list nil)
6054 (put 'pr-i-ps-send 'pr-widget-list nil)
6056 (delete-other-windows)
6057 (kill-buffer (get-buffer-create pr-buffer-name))
6058 (switch-to-buffer (get-buffer-create pr-buffer-name))
6060 ;; header
6061 (let ((versions (concat "printing v" pr-version
6062 " ps-print v" ps-print-version)))
6063 ;; to keep compatibility with Emacs 20 & 21:
6064 ;; DO NOT REPLACE `?\ ' BY `?\s'
6065 (widget-insert (make-string (- 79 (length versions)) ?\ ) versions))
6066 (pr-insert-italic "\nCurrent Directory : " 1)
6067 (pr-insert-italic default-directory)
6069 (pr-insert-section-1) ; 1. Print
6070 (pr-insert-section-2) ; 2. PostScript Printer
6071 (pr-insert-section-3) ; 3. Text Printer
6073 ;; separator
6074 (widget-insert "\n\n " (make-string 77 ?-))
6076 (pr-insert-section-4) ; 4. Settings
6077 (pr-insert-section-5) ; 5. Customize
6078 (pr-insert-section-6) ; 6. Show Settings
6079 (pr-insert-section-7) ; 7. Help
6081 (use-local-map pr-interface-map)
6082 (widget-setup)
6083 (goto-char (point-min))
6085 (and pr-i-region ; let region activated
6086 (pr-keep-region-active)))
6089 (defun pr-insert-section-1 ()
6090 ;; 1. Print:
6091 (pr-insert-italic "\nPrint :" 1)
6093 ;; 1a. Buffer:
6094 ;; 1a. Buffer: Buffer List
6095 (pr-insert-radio-button 'pr-i-process 'buffer)
6096 (pr-insert-menu "Buffer List" 'pr-i-buffer
6097 (let ((blist (buffer-list))
6098 case-fold-search choices)
6099 (while blist
6100 (let ((name (buffer-name (car blist)))
6101 (ignore pr-buffer-name-ignore)
6102 found)
6103 (setq blist (cdr blist))
6104 (while (and ignore (not found))
6105 (setq found (string-match (car ignore) name)
6106 ignore (cdr ignore)))
6107 (or found
6108 (setq choices
6109 (cons (list 'quote
6110 (list 'choice-item
6111 :format "%[%t%]"
6112 name))
6113 choices)))))
6114 (nreverse choices))
6115 " Buffer : " nil
6116 '(progn
6117 (pr-interface-save
6118 (setq pr-i-region (ps-mark-active-p)
6119 pr-i-mode (pr-mode-alist-p)))
6120 (pr-update-checkbox 'pr-i-region)
6121 (pr-update-checkbox 'pr-i-mode)))
6122 ;; 1a. Buffer: Region
6123 (put 'pr-i-region 'pr-widget
6124 (pr-insert-checkbox
6125 "\n "
6126 'pr-i-region
6127 #'(lambda (widget &rest ignore)
6128 (let ((region-p (pr-interface-save
6129 (ps-mark-active-p))))
6130 (cond ((null (widget-value widget)) ; widget is nil
6131 (setq pr-i-region nil))
6132 (region-p ; widget is true and there is a region
6133 (setq pr-i-region t)
6134 (widget-value-set widget t)
6135 (widget-setup)) ; MUST be called after widget-value-set
6136 (t ; widget is true and there is no region
6137 (ding)
6138 (message "There is no region active")
6139 (setq pr-i-region nil)
6140 (widget-value-set widget nil)
6141 (widget-setup))))) ; MUST be called after widget-value-set
6142 " Region"))
6143 ;; 1a. Buffer: Mode
6144 (put 'pr-i-mode 'pr-widget
6145 (pr-insert-checkbox
6147 'pr-i-mode
6148 #'(lambda (widget &rest ignore)
6149 (let ((mode-p (pr-interface-save
6150 (pr-mode-alist-p))))
6151 (cond
6152 ((null (widget-value widget)) ; widget is nil
6153 (setq pr-i-mode nil))
6154 (mode-p ; widget is true and there is a `mode'
6155 (setq pr-i-mode t)
6156 (widget-value-set widget t)
6157 (widget-setup)) ; MUST be called after widget-value-set
6158 (t ; widget is true and there is no `mode'
6159 (ding)
6160 (message
6161 "This buffer isn't in a mode that printing treats specially.")
6162 (setq pr-i-mode nil)
6163 (widget-value-set widget nil)
6164 (widget-setup))))) ; MUST be called after widget-value-set
6165 " Mode\n"))
6167 ;; 1b. Directory:
6168 (pr-insert-radio-button 'pr-i-process 'directory)
6169 (widget-create
6170 'directory
6171 :size 58
6172 :format " Directory : %v"
6173 :notify 'pr-interface-directory
6174 :action (lambda (widget &optional event)
6175 (if (pr-interface-directory widget)
6176 (pr-widget-field-action widget event)
6177 (ding)
6178 (message "Please specify a readable directory")))
6179 pr-i-directory)
6180 ;; 1b. Directory: File Regexp
6181 (widget-create 'regexp
6182 :size 58
6183 :format "\n File Regexp : %v\n"
6184 :notify (lambda (widget &rest ignore)
6185 (setq pr-i-regexp (widget-value widget)))
6186 pr-i-regexp)
6187 ;; 1b. Directory: List Directory Entry
6188 (widget-insert " ")
6189 (pr-insert-toggle 'pr-list-directory " List Directory Entry\n")
6191 ;; 1c. PostScript File:
6192 (pr-insert-radio-button 'pr-i-process 'file)
6193 (widget-create
6194 'file
6195 :size 51
6196 :format " PostScript File : %v"
6197 :notify 'pr-interface-infile
6198 :action (lambda (widget &rest event)
6199 (if (pr-interface-infile widget)
6200 (pr-widget-field-action widget event)
6201 (ding)
6202 (message "Please specify a readable PostScript file")))
6203 pr-i-ps-file)
6204 ;; 1c. PostScript File: PostScript Utility
6205 (pr-insert-menu "PostScript Utility" 'pr-ps-utility
6206 (pr-choice-alist pr-ps-utility-alist)
6207 "\n PostScript Utility : "
6208 " ")
6209 ;; 1c. PostScript File: No Preprocessing
6210 (pr-insert-toggle 'pr-i-ps-as-is " No Preprocessing"))
6213 (defun pr-insert-section-2 ()
6214 ;; 2. PostScript Printer:
6215 ;; 2. PostScript Printer: PostScript Printer List
6216 (pr-insert-italic "\n\nPostScript Printer : " 2 20)
6217 (pr-insert-menu "PostScript Printer" 'pr-ps-name
6218 (pr-choice-alist pr-ps-printer-alist))
6219 ;; 2. PostScript Printer: Despool
6220 (put 'pr-i-despool 'pr-widget
6221 (pr-insert-checkbox
6223 'pr-i-despool
6224 #'(lambda (widget &rest ignore)
6225 (if pr-spool-p
6226 (setq pr-i-despool (not pr-i-despool))
6227 (ding)
6228 (message "Can despool only when spooling is actually selected")
6229 (setq pr-i-despool nil))
6230 (widget-value-set widget pr-i-despool)
6231 (widget-setup)) ; MUST be called after widget-value-set
6232 " Despool "))
6233 ;; 2. PostScript Printer: Preview Print Quit
6234 (pr-insert-button 'pr-interface-preview "Preview" " ")
6235 (pr-insert-button 'pr-interface-ps-print "Print" " ")
6236 (pr-insert-button 'pr-interface-quit "Quit")
6237 ;; 2. PostScript Printer: Send to Printer/Temporary File
6238 (pr-insert-radio-button 'pr-i-ps-send 'printer)
6239 (widget-insert " Send to Printer/Temporary File")
6240 ;; 2. PostScript Printer: Send to File
6241 (pr-insert-radio-button 'pr-i-ps-send 'file)
6242 (widget-create
6243 'file
6244 :size 57
6245 :format " Send to File : %v"
6246 :notify 'pr-interface-outfile
6247 :action (lambda (widget &rest event)
6248 (if (and (pr-interface-outfile widget)
6249 (or (not (file-exists-p pr-i-out-file))
6250 (setq pr-i-answer-yes
6251 (y-or-n-p "File exists; overwrite? "))))
6252 (pr-widget-field-action widget event)
6253 (ding)
6254 (message "Please specify a writable PostScript file")))
6255 pr-i-out-file)
6256 ;; 2. PostScript Printer: N-Up
6257 (widget-create
6258 'integer
6259 :size 3
6260 :format "\n N-Up : %v"
6261 :notify (lambda (widget &rest ignore)
6262 (let ((value (if (string= (widget-apply widget :value-get) "")
6264 (widget-value widget))))
6265 (if (and (integerp value)
6266 (<= 1 value) (<= value 100))
6267 (progn
6268 (message " ")
6269 (setq pr-i-n-up value))
6270 (ding)
6271 (message "Please specify an integer between 1 and 100"))))
6272 pr-i-n-up))
6275 (defun pr-insert-section-3 ()
6276 ;; 3. Text Printer:
6277 (pr-insert-italic "\n\nText Printer : " 2 14)
6278 (pr-insert-menu "Text Printer" 'pr-txt-name
6279 (pr-choice-alist pr-txt-printer-alist)
6280 nil " ")
6281 (pr-insert-button 'pr-interface-printify "Printify" " ")
6282 (pr-insert-button 'pr-interface-txt-print "Print" " ")
6283 (pr-insert-button 'pr-interface-quit "Quit"))
6286 (defun pr-insert-section-4 ()
6287 ;; 4. Settings:
6288 ;; 4. Settings: Landscape Auto Region Verbose
6289 (pr-insert-checkbox "\n\n " 'ps-landscape-mode
6290 #'(lambda (&rest ignore)
6291 (setq ps-landscape-mode (not ps-landscape-mode)
6292 pr-file-landscape ps-landscape-mode))
6293 " Landscape ")
6294 (pr-insert-toggle 'pr-auto-region " Auto Region ")
6295 (pr-insert-toggle 'pr-buffer-verbose " Verbose\n ")
6297 ;; 4. Settings: Print Header Auto Mode
6298 (pr-insert-toggle 'ps-print-header " Print Header ")
6299 (pr-insert-toggle 'pr-auto-mode " Auto Mode\n ")
6301 ;; 4. Settings: Print Header Frame Menu Lock
6302 (pr-insert-toggle 'ps-print-header-frame " Print Header Frame ")
6303 (pr-insert-toggle 'pr-menu-lock " Menu Lock\n ")
6305 ;; 4. Settings: Line Number
6306 (pr-insert-toggle 'ps-line-number " Line Number\n ")
6308 ;; 4. Settings: Zebra Stripes Spool Buffer
6309 (pr-insert-toggle 'ps-zebra-stripes " Zebra Stripes")
6310 (pr-insert-checkbox " "
6311 'pr-spool-p
6312 #'(lambda (&rest ignore)
6313 (setq pr-spool-p (not pr-spool-p))
6314 (unless pr-spool-p
6315 (setq pr-i-despool nil)
6316 (pr-update-checkbox 'pr-i-despool)))
6317 " Spool Buffer")
6319 ;; 4. Settings: Duplex Print with faces
6320 (pr-insert-checkbox "\n "
6321 'ps-spool-duplex
6322 #'(lambda (&rest ignore)
6323 (setq ps-spool-duplex (not ps-spool-duplex)
6324 pr-file-duplex ps-spool-duplex))
6325 " Duplex ")
6326 (pr-insert-toggle 'pr-faces-p " Print with faces")
6328 ;; 4. Settings: Tumble Print via Ghostscript
6329 (pr-insert-checkbox "\n "
6330 'ps-spool-tumble
6331 #'(lambda (&rest ignore)
6332 (setq ps-spool-tumble (not ps-spool-tumble)
6333 pr-file-tumble ps-spool-tumble))
6334 " Tumble ")
6335 (pr-insert-toggle 'pr-print-using-ghostscript " Print via Ghostscript\n ")
6337 ;; 4. Settings: Upside-Down Page Parity
6338 (pr-insert-toggle 'ps-print-upside-down " Upside-Down")
6339 (pr-insert-italic "\n\nSelect Pages : " 2 14)
6340 (pr-insert-menu "Page Parity" 'ps-even-or-odd-pages
6341 (mapcar #'(lambda (alist)
6342 (list 'quote
6343 (list 'choice-item
6344 :format "%[%t%]"
6345 :tag (cdr alist)
6346 :value (car alist))))
6347 pr-even-or-odd-alist)))
6350 (defun pr-insert-section-5 ()
6351 ;; 5. Customize:
6352 (pr-insert-italic "\n\nCustomize : " 2 11)
6353 (pr-insert-button 'pr-customize "printing" " ")
6354 (pr-insert-button #'(lambda (&rest ignore) (ps-print-customize))
6355 "ps-print" " ")
6356 (pr-insert-button 'lpr-customize "lpr"))
6359 (defun pr-insert-section-6 ()
6360 ;; 6. Show Settings:
6361 (pr-insert-italic "\nShow Settings : " 1 14)
6362 (pr-insert-button 'pr-show-pr-setup "printing" " ")
6363 (pr-insert-button 'pr-show-ps-setup "ps-print" " ")
6364 (pr-insert-button 'pr-show-lpr-setup "lpr"))
6367 (defun pr-insert-section-7 ()
6368 ;; 7. Help:
6369 (pr-insert-italic "\nHelp : " 1 5)
6370 (pr-insert-button 'pr-interface-help "Interface Help" " ")
6371 (pr-insert-button 'pr-help "Menu Help" " ")
6372 (pr-insert-button 'pr-interface-quit "Quit" "\n ")
6373 (pr-insert-button 'pr-kill-help "Kill All Printing Help Buffer"))
6376 (defun pr-kill-help (&rest ignore)
6377 "Kill all printing help buffer."
6378 (interactive)
6379 (let ((help '("*Printing Interface Help*" "*Printing Help*"
6380 "*LPR Setup*" "*PR Setup*" "*PS Setup*")))
6381 (while help
6382 (let ((buffer (get-buffer (car help))))
6383 (setq help (cdr help))
6384 (when buffer
6385 (delete-windows-on buffer)
6386 (kill-buffer buffer)))))
6387 (recenter (- (window-height) 2)))
6390 (defun pr-interface-quit (&rest ignore)
6391 "Kill the printing buffer interface and quit."
6392 (interactive)
6393 (kill-buffer pr-buffer-name)
6394 (set-window-configuration pr-i-window-configuration))
6397 (defun pr-interface-help (&rest ignore)
6398 "printing buffer interface help."
6399 (interactive)
6400 (pr-show-setup pr-interface-help-message "*Printing Interface Help*"))
6403 (defun pr-interface-txt-print (&rest ignore)
6404 "Print using lpr package."
6405 (interactive)
6406 (condition-case data
6407 (cond
6408 ((eq pr-i-process 'directory)
6409 (pr-i-directory)
6410 (pr-interface-save
6411 (pr-txt-directory pr-i-directory pr-i-regexp)))
6412 ((eq pr-i-process 'buffer)
6413 (pr-interface-save
6414 (cond (pr-i-region
6415 (let ((pr-auto-mode pr-i-mode))
6416 (pr-txt-region)))
6417 (pr-i-mode
6418 (let (pr-auto-region)
6419 (pr-txt-mode)))
6421 (let (pr-auto-mode pr-auto-region)
6422 (pr-txt-buffer)))
6424 ((eq pr-i-process 'file)
6425 (error "Please specify a text file"))
6427 (error "Internal error: `pr-i-process' = %S" pr-i-process))
6429 ;; handlers
6430 ((quit error)
6431 (ding)
6432 (message "%s" (error-message-string data)))))
6435 (defun pr-interface-printify (&rest ignore)
6436 "Printify a buffer."
6437 (interactive)
6438 (condition-case data
6439 (cond
6440 ((eq pr-i-process 'directory)
6441 (pr-i-directory)
6442 (pr-interface-save
6443 (pr-printify-directory pr-i-directory pr-i-regexp)))
6444 ((eq pr-i-process 'buffer)
6445 (pr-interface-save
6446 (if pr-i-region
6447 (pr-printify-region)
6448 (pr-printify-buffer))))
6449 ((eq pr-i-process 'file)
6450 (error "Cannot printify a PostScript file"))
6452 (error "Internal error: `pr-i-process' = %S" pr-i-process))
6454 ;; handlers
6455 ((quit error)
6456 (ding)
6457 (message "%s" (error-message-string data)))))
6460 (defun pr-interface-ps-print (&rest ignore)
6461 "Print using ps-print package."
6462 (interactive)
6463 (pr-interface-ps 'pr-despool-ps-print 'pr-ps-directory-ps-print
6464 'pr-ps-file-ps-print 'pr-ps-file-up-ps-print
6465 'pr-ps-region-ps-print 'pr-ps-mode-ps-print
6466 'pr-ps-buffer-ps-print))
6469 (defun pr-interface-preview (&rest ignore)
6470 "Preview a PostScript file."
6471 (interactive)
6472 (pr-interface-ps 'pr-despool-preview 'pr-ps-directory-preview
6473 'pr-ps-file-preview 'pr-ps-file-up-preview
6474 'pr-ps-region-preview 'pr-ps-mode-preview
6475 'pr-ps-buffer-preview))
6478 (defun pr-interface-ps (ps-despool ps-directory ps-file ps-file-up ps-region
6479 ps-mode ps-buffer)
6480 (condition-case data
6481 (let ((outfile (or (and (eq pr-i-process 'file) pr-i-ps-as-is)
6482 (pr-i-ps-send))))
6483 (cond
6484 ((and pr-i-despool pr-spool-p)
6485 (pr-interface-save
6486 (funcall ps-despool outfile))
6487 (setq pr-i-despool nil)
6488 (pr-update-checkbox 'pr-i-despool))
6489 ((eq pr-i-process 'directory)
6490 (pr-i-directory)
6491 (pr-interface-save
6492 (funcall ps-directory
6493 pr-i-n-up pr-i-directory pr-i-regexp outfile)))
6494 ((eq pr-i-process 'file)
6495 (cond ((or (file-directory-p pr-i-ps-file)
6496 (not (file-readable-p pr-i-ps-file)))
6497 (error "Please specify a readable PostScript file"))
6498 (pr-i-ps-as-is
6499 (pr-interface-save
6500 (funcall ps-file pr-i-ps-file)))
6502 (pr-interface-save
6503 (funcall ps-file-up pr-i-n-up pr-i-ps-file outfile)))
6505 ((eq pr-i-process 'buffer)
6506 (pr-interface-save
6507 (cond (pr-i-region
6508 (let ((pr-auto-mode pr-i-mode))
6509 (funcall ps-region pr-i-n-up outfile)))
6510 (pr-i-mode
6511 (let (pr-auto-region)
6512 (funcall ps-mode pr-i-n-up outfile)))
6514 (let (pr-auto-mode pr-auto-region)
6515 (funcall ps-buffer pr-i-n-up outfile)))
6518 (error "Internal error: `pr-i-process' = %S" pr-i-process))
6520 ;; handlers
6521 ((quit error)
6522 (ding)
6523 (message "%s" (error-message-string data)))))
6526 (defun pr-i-ps-send ()
6527 (cond ((eq pr-i-ps-send 'printer)
6528 nil)
6529 ((not (eq pr-i-ps-send 'file))
6530 (error "Internal error: `pr-i-ps-send' = %S" pr-i-ps-send))
6531 ((or (file-directory-p pr-i-out-file)
6532 (not (file-writable-p pr-i-out-file)))
6533 (error "Please specify a writable PostScript file"))
6534 ((or (not (file-exists-p pr-i-out-file))
6535 pr-i-answer-yes
6536 (setq pr-i-answer-yes
6537 (y-or-n-p (format "File `%s' exists; overwrite? "
6538 pr-i-out-file))))
6539 pr-i-out-file)
6541 (error "File already exists"))))
6544 (defun pr-i-directory ()
6545 (or (and (file-directory-p pr-i-directory)
6546 (file-readable-p pr-i-directory))
6547 (error "Please specify be a readable directory")))
6550 (defun pr-interface-directory (widget &rest ignore)
6551 (and pr-buffer-verbose
6552 (message "You can use M-TAB or ESC TAB for file completion"))
6553 (let ((dir (widget-value widget)))
6554 (and (file-directory-p dir)
6555 (file-readable-p dir)
6556 (setq pr-i-directory dir))))
6559 (defun pr-interface-infile (widget &rest ignore)
6560 (and pr-buffer-verbose
6561 (message "You can use M-TAB or ESC TAB for file completion"))
6562 (let ((file (widget-value widget)))
6563 (and (not (file-directory-p file))
6564 (file-readable-p file)
6565 (setq pr-i-ps-file file))))
6568 (defun pr-interface-outfile (widget &rest ignore)
6569 (setq pr-i-answer-yes nil)
6570 (and pr-buffer-verbose
6571 (message "You can use M-TAB or ESC TAB for file completion"))
6572 (let ((file (widget-value widget)))
6573 (and (not (file-directory-p file))
6574 (file-writable-p file)
6575 (setq pr-i-out-file file))))
6578 (defun pr-widget-field-action (widget event)
6579 (and (get-buffer "*Completions*") ; clean frame window
6580 (delete-windows-on "*Completions*"))
6581 (message " ") ; clean echo area
6582 (widget-field-action widget event))
6585 (defun pr-insert-italic (str &optional from to)
6586 (let ((len (length str)))
6587 (put-text-property (if from (max from 0) 0)
6588 (if to (max to len) len)
6589 'face 'italic str)
6590 (widget-insert str)))
6593 (defun pr-insert-checkbox (before var-sym fun label)
6594 (widget-insert before)
6595 (prog1
6596 (widget-create 'checkbox
6597 :notify fun
6598 (symbol-value var-sym))
6599 (widget-insert label)))
6602 (defun pr-insert-toggle (var-sym label)
6603 (widget-create 'checkbox
6604 :notify `(lambda (&rest ignore)
6605 (setq ,var-sym (not ,var-sym)))
6606 (symbol-value var-sym))
6607 (widget-insert label))
6610 (defun pr-insert-button (fun label &optional separator)
6611 (widget-create 'push-button
6612 :notify fun
6613 label)
6614 (and separator
6615 (widget-insert separator)))
6618 (defun pr-insert-menu (tag var-sym choices &optional before after &rest body)
6619 (and before (widget-insert before))
6620 (eval `(widget-create 'menu-choice
6621 :tag ,tag
6622 :format "%v"
6623 :inline t
6624 :value ,var-sym
6625 :notify (lambda (widget &rest ignore)
6626 (setq ,var-sym (widget-value widget))
6627 ,@body)
6628 :void '(choice-item :format "%[%t%]"
6629 :tag "Can not display value!")
6630 ,@choices))
6631 (and after (widget-insert after)))
6634 (defun pr-insert-radio-button (var-sym sym)
6635 (widget-insert "\n")
6636 (let ((wid-list (get var-sym 'pr-widget-list))
6637 (wid (eval `(widget-create
6638 'radio-button
6639 :format " %[%v%]"
6640 :value (eq ,var-sym (quote ,sym))
6641 :notify (lambda (&rest ignore)
6642 (setq ,var-sym (quote ,sym))
6643 (pr-update-radio-button (quote ,var-sym)))))))
6644 (put var-sym 'pr-widget-list (cons (cons wid sym) wid-list))))
6647 (defun pr-update-radio-button (var-sym)
6648 (let ((wid-list (get var-sym 'pr-widget-list)))
6649 (while wid-list
6650 (let ((wid (car (car wid-list)))
6651 (value (cdr (car wid-list))))
6652 (setq wid-list (cdr wid-list))
6653 (widget-value-set wid (eq (symbol-value var-sym) value))))
6654 (widget-setup)))
6657 (defun pr-update-checkbox (var-sym)
6658 (let ((wid (get var-sym 'pr-widget)))
6659 (when wid
6660 (widget-value-set wid (symbol-value var-sym))
6661 (widget-setup))))
6664 (defun pr-choice-alist (alist)
6665 (let ((max (apply 'max (mapcar #'(lambda (alist)
6666 (length (symbol-name (car alist))))
6667 alist))))
6668 (mapcar #'(lambda (alist)
6669 (let* ((sym (car alist))
6670 (name (symbol-name sym)))
6671 (list
6672 'quote
6673 (list
6674 'choice-item
6675 :format "%[%t%]"
6676 :tag (concat name
6677 (make-string (- max (length name)) ?_))
6678 :value sym))))
6679 alist)))
6682 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
6685 (provide 'printing)
6688 ;; arch-tag: 9ce9ac3f-0f60-4370-900b-1943215d9d18
6689 ;;; printing.el ends here