;; 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 'file ; could use string but then we lose completion for files.
+ :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 hpux)) 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 ()
(print-region-1 start end lpr-switches t))
(defun print-region-1 (start end switches page-headers)
- ;; Avoid having a space in the job name
- ;; because on some MIPS system that crashes the printer demon.
- (let ((name (concat (buffer-name) "-Emacs-buffer"))
+ ;; 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"))
(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)
(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)
(format "\\^%c" (+ c ?@))
(format "\\%02x" c)))))))
+(provide 'lpr)
+
;;; lpr.el ends here