X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/8ec1a37406d4e1305df2b696dd90b91167ab2041..3917863bc11c3936eb35d3c962e79d3717be612a:/lisp/lpr.el diff --git a/lisp/lpr.el b/lisp/lpr.el index 272d5af04d..301a50af9a 100644 --- a/lisp/lpr.el +++ b/lisp/lpr.el @@ -18,37 +18,95 @@ ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License -;; along with GNU Emacs; see the file COPYING. If not, write to -;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. +;; along with GNU Emacs; see the file COPYING. If not, write to the +;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, +;; Boston, MA 02111-1307, USA. ;;; Commentary: ;; Commands to send the region or a buffer your printer. Entry points ;; are `lpr-buffer', `print-buffer', lpr-region', or `print-region'; option -;; variables include `lpr-switches' and `lpr-command'. +;; variables include `printer-name', `lpr-switches' and `lpr-command'. ;;; Code: +(defgroup lpr nil + "Print Emacs buffer on line printer" + :group 'wp) + ;;;###autoload -(defvar lpr-switches nil - "*List of strings to pass as extra switch args to `lpr' when it is invoked.") +(defcustom printer-name + (if (memq system-type '(ms-dos windows-nt)) "PRN") + "*The name of a local printer to which data is sent for printing. +\(Note that PostScript files are sent to `ps-printer-name', which see.\) + +On Unix-like systems, a string value should be a name understood by +lpr's -P option. + +On MS-DOS and MS-Windows systems, it is the name of a printer device or +port. Typical non-default settings would be \"LPT1\" to \"LPT3\" for +parallel printers, or \"COM1\" to \"COM4\" or \"AUX\" for serial +printers, or \"//hostname/printer\" for a shared network printer. You +can also set it to a name of a file, in which case the output gets +appended to that file. If you want to discard the printed output, set +this to \"NUL\"." + :type '(choice ; could use string but then we lose completion for files. + (file :tag "Name") + (const :tag "Default" nil)) + :group 'lpr) -(defvar lpr-add-options (eq system-type 'berkeley-unix) - "*Non-nil means construct -T and -J options for the `lpr'.") +;;;###autoload +(defcustom lpr-switches nil + "*List of strings to pass as extra options for the printer program. +It is recommended to set `printer-name' instead of including an explicit +switch on this list. +See `lpr-command'." + :type '(repeat (string :tag "Argument")) + :group 'lpr) + +(defcustom lpr-add-switches (eq system-type 'berkeley-unix) + "*Non-nil means construct -T and -J options for the printer program. +These are made assuming that the program is `lpr'; +if you are using some other incompatible printer program, +this variable should be nil." + :type 'boolean + :group 'lpr) ;;;###autoload -(defvar lpr-command +(defcustom lpr-command (if (memq system-type '(usg-unix-v dgux hpux irix)) "lp" "lpr") - "*Shell command for printing a file") - -(defvar lpr-headers-switches - (if (memq system-type '(usg-unix-v dgux hpux irix)) nil "-p") - "*List of strings to use as options for `lpr' to request page headings.") - -(defvar print-region-function nil + "*Name of program for printing a file." + :type 'string + :group 'lpr) + +;; Default is nil, because that enables us to use pr -f +;; which is more reliable than pr with no args, which is what lpr -p does. +(defcustom lpr-headers-switches nil + "*List of strings of options to request page headings in the printer program. +If nil, we run `lpr-page-header-program' to make page headings +and print the result." + :type '(repeat (string :tag "Argument")) + :group 'lpr) + +(defcustom print-region-function nil "Function to call to print the region on a printer. -See definition of `print-region-1' for calling conventions.") +See definition of `print-region-1' for calling conventions." + :type 'function + :group 'lpr) + +(defcustom lpr-page-header-program "pr" + "*Name of program for adding page headers to a file." + :type 'string + :group 'lpr) + +;; Berkeley systems support -F, and GNU pr supports both -f and -F, +;; So it looks like -F is a better default. +(defcustom lpr-page-header-switches '("-F") + "*List of strings to use as options for the page-header-generating program. +The variable `lpr-page-header-program' specifies the program to use." + :type '(repeat string) + :group 'lpr) ;;;###autoload (defun lpr-buffer () @@ -84,12 +142,31 @@ See definition of `print-region-1' for calling conventions.") ;; and it seems to annoying to do for that MIPS system. (let ((name (concat (buffer-name) " Emacs buffer")) (title (concat (buffer-name) " Emacs buffer")) - (width tab-width)) + ;; Make pipes use the same coding system as + ;; writing the buffer to a file would. + (coding-system-for-write + (or coding-system-for-write buffer-file-coding-system)) + (coding-system-for-read + (or coding-system-for-read buffer-file-coding-system)) + (width tab-width) + switch-string) (save-excursion - (message "Spooling...") + (if page-headers + (if lpr-headers-switches + ;; It is possible to use an lpr option + ;; to get page headers. + (setq switches (append (if (stringp lpr-headers-switches) + (list lpr-headers-switches) + lpr-headers-switches) + switches)))) + (setq switch-string + (if switches (concat " with options " + (mapconcat 'identity switches " ")) + "")) + (message "Spooling%s..." switch-string) (if (/= tab-width 8) - (progn - (print-region-new-buffer start end) + (let ((new-coords (print-region-new-buffer start end))) + (setq start (car new-coords) end (cdr new-coords)) (setq tab-width width) (save-excursion (goto-char end) @@ -97,40 +174,49 @@ See definition of `print-region-1' for calling conventions.") (untabify (point-min) (point-max)))) (if page-headers (if lpr-headers-switches - ;; On BSD, use an option to get page headers. - (setq switches (append (if (stringp lpr-headers-switches) - (list lpr-headers-switches) - lpr-headers-switches) - switches)) - (print-region-new-buffer start end) - (call-process-region start end "pr" t t nil) + ;; We handled this above by modifying SWITCHES. + nil + ;; Run a separate program to get page headers. + (let ((new-coords (print-region-new-buffer start end))) + (setq start (car new-coords) end (cdr new-coords))) + (apply 'call-process-region start end lpr-page-header-program + t t nil + (nconc (list "-h" title) + lpr-page-header-switches)) (setq start (point-min) end (point-max)))) (apply (or print-region-function 'call-process-region) (nconc (list start end lpr-command nil nil nil) - (nconc (and lpr-add-options - (list "-J" name "-T" title)) + (nconc (and lpr-add-switches + (list "-J" name)) + ;; These belong in pr if we are using that. + (and lpr-add-switches lpr-headers-switches + (list "-T" title)) + (and (stringp printer-name) + (list (concat "-P" printer-name))) switches))) (if (markerp end) (set-marker end nil)) - (message "Spooling...done")))) + (message "Spooling%s...done" switch-string)))) ;; This function copies the text between start and end -;; into a new buffer, makes that buffer current, -;; and sets start and end to the buffer bounds. -;; start and end are used free. +;; into a new buffer, makes that buffer current. +;; It returns the new range to print from the new current buffer +;; as (START . END). + (defun print-region-new-buffer (ostart oend) - (or (string= (buffer-name) " *spool temp*") - (let ((oldbuf (current-buffer))) - (set-buffer (get-buffer-create " *spool temp*")) - (widen) (erase-buffer) - (insert-buffer-substring oldbuf ostart oend) - (setq start (point-min) end (point-max))))) + (if (string= (buffer-name) " *spool temp*") + (cons ostart oend) + (let ((oldbuf (current-buffer))) + (set-buffer (get-buffer-create " *spool temp*")) + (widen) (erase-buffer) + (insert-buffer-substring oldbuf ostart oend) + (cons (point-min) (point-max))))) (defun printify-region (begin end) - "Turn nonprinting characters (other than TAB, LF, SPC, RET, and FF) -in the current buffer into printable representations as control or -hexadecimal escapes." + "Replace nonprinting characters in region with printable representations. +The printable representations use ^ (for ASCII control characters) or hex. +The characters tab, linefeed, space, return and formfeed are not affected." (interactive "r") (save-excursion (goto-char begin) @@ -143,4 +229,6 @@ hexadecimal escapes." (format "\\^%c" (+ c ?@)) (format "\\%02x" c))))))) +(provide 'lpr) + ;;; lpr.el ends here