Some fixes to follow coding conventions in files maintained by FSF.
[bpt/emacs.git] / lisp / lpr.el
index 3b8e2d8..213a6d0 100644 (file)
@@ -1,6 +1,6 @@
-;;; lpr.el --- print Emacs buffer on line printer.
+;;; lpr.el --- print Emacs buffer on line printer
 
-;; Copyright (C) 1985, 1988, 1992, 1994 Free Software Foundation, Inc.
+;; Copyright (C) 1985, 1988, 1992, 1994, 2001 Free Software Foundation, Inc.
 
 ;; Maintainer: FSF
 ;; Keywords: unix
 
 ;;; Commentary:
 
-;; Commands to send the region or a buffer your printer.  Entry points
+;; Commands to send the region or a buffer to 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:
 
+;;;###autoload
+(defvar lpr-windows-system
+  (memq system-type '(emx win32 w32 mswindows ms-dos windows-nt)))
+
+;;;###autoload
+(defvar lpr-lp-system
+  (memq system-type '(usg-unix-v dgux hpux irix)))
+
+
 (defgroup lpr nil
   "Print Emacs buffer on line printer"
   :group 'wp)
 
 
 ;;;###autoload
-(defcustom lpr-switches nil 
+(defcustom printer-name
+  (and lpr-windows-system "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; otherwise the value should be nil.
+
+On MS-DOS and MS-Windows systems, a string value is taken as the name of
+a printer device or port, provided `lpr-command' is set to \"\".
+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 the 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 :menu-tag "Printer Name"
+                :tag "Printer Name"
+                (const :tag "Default" nil)
+                ;; could use string but then we lose completion for files.
+                (file :tag "Name"))
+  :group '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.
+(defcustom lpr-add-switches (memq system-type '(berkeley-unix gnu/linux))
+  "*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)
 
+(defcustom lpr-printer-switch
+  (if lpr-lp-system
+      "-d "
+    "-P")
+  "*Printer switch, that is, something like \"-P\", \"-d \", \"/D:\", etc.
+This switch is used in conjunction with `printer-name'."
+  :type '(choice :menu-tag "Printer Name Switch"
+                :tag "Printer Name Switch"
+                (const :tag "None" nil)
+                (string :tag "Printer Switch"))
+  :group 'lpr)
+
 ;;;###autoload
 (defcustom lpr-command
-  (if (memq system-type '(usg-unix-v dgux hpux irix))
-      "lp" "lpr")
-  "*Name of program for printing a file."
+  (cond
+   (lpr-windows-system
+    "")
+   (lpr-lp-system
+    "lp")
+   (t
+    "lpr"))
+  "*Name of program for printing a file.
+
+On MS-DOS and MS-Windows systems, if the value is an empty string then
+Emacs will write directly to the printer port named by `printer-name'.
+The programs `print' and `nprint' (the standard print programs on
+Windows NT and Novell Netware respectively) are handled specially, using
+`printer-name' as the destination for output; any other program is
+treated like `lpr' except that an explicit filename is given as the last
+argument."
   :type 'string
   :group 'lpr)
 
@@ -70,7 +129,7 @@ and print the result."
 (defcustom print-region-function nil
   "Function to call to print the region on a printer.
 See definition of `print-region-1' for calling conventions."
-  :type 'function
+  :type '(choice (const nil) function)
   :group 'lpr)
 
 (defcustom lpr-page-header-program "pr"
@@ -88,29 +147,51 @@ The variable `lpr-page-header-program' specifies the program to use."
 
 ;;;###autoload
 (defun lpr-buffer ()
-  "Print buffer contents as with Unix command `lpr'.
-`lpr-switches' is a list of extra switches (strings) to pass to lpr."
+  "Print buffer contents without pagination or page headers.
+See the variables `lpr-switches' and `lpr-command'
+for customization of the printer command."
   (interactive)
   (print-region-1 (point-min) (point-max) lpr-switches nil))
 
 ;;;###autoload
 (defun print-buffer ()
-  "Print buffer contents as with Unix command `lpr -p'.
-`lpr-switches' is a list of extra switches (strings) to pass to lpr."
+  "Paginate and print buffer contents.
+
+The variable `lpr-headers-switches' controls how to paginate.
+If it is nil (the default), we run the `pr' program (or whatever program
+`lpr-page-header-program' specifies) to paginate.
+`lpr-page-header-switches' specifies the switches for that program.
+
+Otherwise, the switches in `lpr-headers-switches' are used
+in the print command itself; we expect them to request pagination.
+See the variables `lpr-switches' and `lpr-command'
+for further customization of the printer command."
   (interactive)
   (print-region-1 (point-min) (point-max) lpr-switches t))
 
 ;;;###autoload
 (defun lpr-region (start end)
-  "Print region contents as with Unix command `lpr'.
-`lpr-switches' is a list of extra switches (strings) to pass to lpr."
+  "Print region contents without pagination or page headers.
+See the variables `lpr-switches' and `lpr-command'
+for customization of the printer command."
   (interactive "r")
   (print-region-1 start end lpr-switches nil))
 
 ;;;###autoload
 (defun print-region (start end)
-  "Print region contents as with Unix command `lpr -p'.
-`lpr-switches' is a list of extra switches (strings) to pass to lpr."
+  "Paginate and print the region contents.
+
+The variable `lpr-headers-switches' controls how to paginate.
+If it is nil (the default), we run the `pr' program (or whatever program
+`lpr-page-header-program' specifies) to paginate.
+`lpr-page-header-switches' specifies the switches for that program.
+
+Otherwise, the switches in `lpr-headers-switches' are used
+in the print command itself; we expect them to request pagination.
+See the variables `lpr-switches' and `lpr-command'
+for further customization of the printer command."
   (interactive "r")
   (print-region-1 start end lpr-switches t))
 
@@ -118,32 +199,37 @@ The variable `lpr-page-header-program' specifies the program to use."
   ;; 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"))
+  (let ((name  (concat (buffer-name) " Emacs buffer"))
        (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)
+       ;; 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)
+       nswitches
        switch-string)
     (save-excursion
-      (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 " "))
-             ""))
+      (and page-headers lpr-headers-switches
+          ;; It's 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 nswitches     (lpr-flatten-list
+                          (mapcar 'lpr-eval-switch ; Dynamic evaluation
+                                  switches))
+           switch-string (if switches
+                             (concat " with options "
+                                     (mapconcat 'identity switches " "))
+                           ""))
       (message "Spooling%s..." switch-string)
       (if (/= tab-width 8)
          (let ((new-coords (print-region-new-buffer start end)))
-           (setq start (car new-coords) end (cdr new-coords))
-           (setq tab-width width)
+           (setq start     (car new-coords)
+                 end       (cdr new-coords)
+                 tab-width width)
            (save-excursion
              (goto-char end)
              (setq end (point-marker)))
@@ -154,22 +240,24 @@ The variable `lpr-page-header-program' specifies the program to use."
              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 'call-process-region (car new-coords) (cdr new-coords)
+                    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-switches
-                               (list "-J" name))
-                          ;; These belong in pr if we are using that.
-                          (and lpr-add-switches lpr-headers-switches
-                               (list "-T" title))
-                          switches)))
+                   (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 lpr-printer-switch
+                                      printer-name)))
+                   nswitches))
       (if (markerp end)
          (set-marker end nil))
       (message "Spooling%s...done" switch-string))))
@@ -184,7 +272,8 @@ The variable `lpr-page-header-program' specifies the program to use."
       (cons ostart oend)
     (let ((oldbuf (current-buffer)))
       (set-buffer (get-buffer-create " *spool temp*"))
-      (widen) (erase-buffer)
+      (widen)
+      (erase-buffer)
       (insert-buffer-substring oldbuf ostart oend)
       (cons (point-min) (point-max)))))
 
@@ -199,10 +288,38 @@ The characters tab, linefeed, space, return and formfeed are not affected."
       (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)))))))
+       (insert (if (< c ?\ )
+                   (format "\\^%c" (+ c ?@))
+                 (format "\\%02x" c)))))))
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; Functions hacked from `ps-print' package.
+
+;; Dynamic evaluation
+(defun lpr-eval-switch (arg)
+  (cond ((stringp arg) arg)
+       ((functionp arg) (apply arg nil))
+       ((symbolp arg) (symbol-value arg))
+       ((consp arg) (apply (car arg) (cdr arg)))
+       (t nil)))
+
+;; `lpr-flatten-list' is defined here (copied from "message.el" and
+;; enhanced to handle dotted pairs as well) until we can get some
+;; sensible autoloads, or `flatten-list' gets put somewhere decent.
+
+;; (lpr-flatten-list '((a . b) c (d . e) (f g h) i . j))
+;; => (a b c d e f g h i j)
+
+(defun lpr-flatten-list (&rest list)
+  (lpr-flatten-list-1 list))
+
+(defun lpr-flatten-list-1 (list)
+  (cond
+   ((null list) (list))
+   ((consp list)
+    (append (lpr-flatten-list-1 (car list))
+           (lpr-flatten-list-1 (cdr list))))
+   (t (list list))))
 
 (provide 'lpr)