Fixed up initial line
[bpt/emacs.git] / lisp / lpr.el
index 2962246..3495619 100644 (file)
@@ -1,11 +1,15 @@
-;; Print Emacs buffer on line printer.
-;; Copyright (C) 1985, 1988, 1992 Free Software Foundation, Inc.
+;;; lpr.el --- print Emacs buffer on line printer.
+
+;; Copyright (C) 1985, 1988, 1992, 1994 Free Software Foundation, Inc.
+
+;; Maintainer: FSF
+;; Keywords: unix
 
 ;; This file is part of GNU Emacs.
 
 ;; GNU Emacs is free software; you can redistribute it and/or modify
 ;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation; either version 1, or (at your option)
+;; the Free Software Foundation; either version 2, or (at your option)
 ;; any later version.
 
 ;; GNU Emacs is distributed in the hope that it will be useful,
 ;; 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'.
 
+;;; Code:
 
 ;;;###autoload
-(defconst lpr-switches nil "\
-*List of strings to pass as extra switch args to lpr when it is invoked.")
+(defvar lpr-switches nil 
+  "*List of strings to pass as extra options for the printer program.
+See `lpr-command'.")
 
-(defvar lpr-command (if (eq system-type 'usg-unix-v)
-                       "lp" "lpr")
-  "*Shell command for printing a file")
+(defvar 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.")
+
+;;;###autoload
+(defvar lpr-command
+  (if (memq system-type '(usg-unix-v dgux hpux irix))
+      "lp" "lpr")
+  "*Name of program for printing a file.")
+
+;; 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.
+(defvar 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.")
 
 (defvar print-region-function nil
   "Function to call to print the region on a printer.
 See definition of `print-region-1' for calling conventions.")
 
+(defvar lpr-page-header-program "pr"
+  "*Name of program for adding page headers to a file.")
+
+(defvar 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.")
+
 ;;;###autoload
 (defun lpr-buffer ()
   "Print buffer contents as with Unix command `lpr'.
@@ -59,38 +94,95 @@ See definition of `print-region-1' for calling conventions.")
   (print-region-1 start end lpr-switches t))
 
 (defun print-region-1 (start end switches page-headers)
+  ;; On some MIPS system, having a space in the job name
+  ;; crashes the printer demon.  But using dashes looks ugly
+  ;; and it seems to annoying to do for that MIPS system.
   (let ((name (concat (buffer-name) " Emacs buffer"))
-       (width tab-width))
+       (title (concat (buffer-name) " Emacs buffer"))
+       ;; On MS-DOS systems, make pipes use binary mode if the
+       ;; original file is binary.
+       (binary-process-input buffer-file-type)
+       (binary-process-output buffer-file-type)
+       (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)
+             (setq end (point-marker)))
            (untabify (point-min) (point-max))))
       (if page-headers
-         (if (eq system-type 'usg-unix-v)
-             (progn
-               (print-region-new-buffer)
-               (call-process-region start end "pr" t t nil))
-           ;; On BSD, use an option to get page headers.
-           (setq switches (cons "-p" switches))))
+         (if lpr-headers-switches
+             ;; 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 (and lpr-add-switches
+                                            (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 (eq system-type 'berkeley-unix)
-                               (list "-J" name "-T" name))
+                   (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))
                           switches)))
-      (message "Spooling...done"))))
+      (if (markerp end)
+         (set-marker end nil))
+      (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.
-(defun print-region-new-buffer ()
-  (or (string= (buffer-name) " *spool temp*")
-      (let ((oldbuf (current-buffer)))
-       (set-buffer (get-buffer-create " *spool temp*"))
-       (widen) (erase-buffer)
-       (insert-buffer-substring oldbuf start end)
-       (setq start (point-min) end (point-max)))))
+;; 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)
+  (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."
+  (interactive "r")
+  (save-excursion
+    (goto-char begin)
+    (let (c)
+      (while (re-search-forward "[\^@-\^h\^k\^n-\^_\177-\377]" end t)
+       (setq c (preceding-char))
+       (delete-backward-char 1)
+       (insert 
+        (if (< c ?\ )
+            (format "\\^%c" (+ c ?@))
+          (format "\\%02x" c)))))))
+
+(provide 'lpr)
+
+;;; lpr.el ends here