Commit | Line | Data |
---|---|---|
fc68affa ER |
1 | ;;; flow-ctrl.el --- help for lusers on cu(1) or ttys with wired-in ^S/^Q flow control |
2 | ||
d733c5ec | 3 | ;;; Copyright (C) 1990, 1991, 1994 Free Software Foundation, Inc. |
3a801d0c | 4 | |
fc68affa ER |
5 | ;; Author Kevin Gallagher |
6 | ;; Maintainer: FSF | |
fc68affa | 7 | ;; Adapted-By: ESR |
fd7fa35a | 8 | ;; Keywords: hardware |
1a06eabd | 9 | |
59243403 RS |
10 | ;; This file is part of GNU Emacs. |
11 | ||
12 | ;; GNU Emacs is free software; you can redistribute it and/or modify | |
13 | ;; it under the terms of the GNU General Public License as published by | |
14 | ;; the Free Software Foundation; either version 2, or (at your option) | |
15 | ;; any later version. | |
16 | ||
17 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
18 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 | ;; GNU General Public License for more details. | |
21 | ||
22 | ;; You should have received a copy of the GNU General Public License | |
23 | ;; along with GNU Emacs; see the file COPYING. If not, write to | |
24 | ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. | |
fc68affa ER |
25 | |
26 | ;;; Commentary: | |
0f39230e JB |
27 | |
28 | ;;;; Terminals that use XON/XOFF flow control can cause problems with | |
282d89c0 | 29 | ;;;; GNU Emacs users. This file contains Emacs Lisp code that makes it |
0f39230e JB |
30 | ;;;; easy for a user to deal with this problem, when using such a |
31 | ;;;; terminal. | |
32 | ;;;; | |
33 | ;;;; To invoke these adjustments, a user need only invoke the function | |
61251338 | 34 | ;;;; enable-flow-control-on with a list of terminal types in his/her own |
0f39230e JB |
35 | ;;;; .emacs file. As arguments, give it the names of one or more terminal |
36 | ;;;; types in use by that user which require flow control adjustments. | |
37 | ;;;; Here's an example: | |
38 | ;;;; | |
61251338 | 39 | ;;;; (enable-flow-control-on "vt200" "vt300" "vt101" "vt131") |
0f39230e JB |
40 | |
41 | ;;; Portability note: This uses (getenv "TERM"), and therefore probably | |
42 | ;;; won't work outside of UNIX-like environments. | |
43 | ||
fc68affa ER |
44 | ;;; Code: |
45 | ||
162de182 RS |
46 | (defvar flow-control-c-s-replacement ?\034 |
47 | "Character that replaces C-s, when flow control handling is enabled.") | |
48 | (defvar flow-control-c-q-replacement ?\036 | |
49 | "Character that replaces C-q, when flow control handling is enabled.") | |
0f39230e | 50 | |
8f21333a RS |
51 | (put 'keyboard-translate-table 'char-table-extra-slots 0) |
52 | ||
162de182 RS |
53 | ;;;###autoload |
54 | (defun enable-flow-control (&optional argument) | |
55 | "Toggle flow control handling. | |
56 | When handling is enabled, user can type C-s as C-\\, and C-q as C-^. | |
57 | With arg, enable flow control mode if arg is positive, otherwise disable." | |
58 | (interactive "P") | |
59 | (if (if argument | |
60 | ;; Argument means enable if arg is positive. | |
61 | (<= (prefix-numeric-value argument) 0) | |
62 | ;; No arg means toggle. | |
63 | (nth 1 (current-input-mode))) | |
64 | (progn | |
65 | ;; Turn flow control off, and stop exchanging chars. | |
66 | (set-input-mode t nil (nth 2 (current-input-mode))) | |
f87de92a RS |
67 | (if keyboard-translate-table |
68 | (progn | |
8f21333a RS |
69 | (aset keyboard-translate-table flow-control-c-s-replacement nil) |
70 | (aset keyboard-translate-table ?\^s nil) | |
71 | (aset keyboard-translate-table flow-control-c-q-replacement nil) | |
72 | (aset keyboard-translate-table ?\^q nil)))) | |
162de182 RS |
73 | ;; Turn flow control on. |
74 | ;; Tell emacs to pass C-s and C-q to OS. | |
75 | (set-input-mode nil t (nth 2 (current-input-mode))) | |
76 | ;; Initialize translate table, saving previous mappings, if any. | |
8f21333a RS |
77 | (cond ((null keyboard-translate-table) |
78 | (setq keyboard-translate-table | |
79 | (make-char-table 'keyboard-translate-table nil))) | |
80 | ((char-table-p keyboard-translate-table) | |
81 | (setq keyboard-translate-table | |
82 | (copy-sequence keyboard-translate-table))) | |
83 | (t | |
84 | (let ((the-table (make-char-table 'keyboard-translate-table nil))) | |
85 | (let ((i 0) | |
86 | (j (length keyboard-translate-table))) | |
87 | (while (< i j) | |
88 | (aset the-table i (elt keyboard-translate-table i)) | |
89 | (setq i (1+ i)))) | |
90 | (setq keyboard-translate-table the-table)))) | |
162de182 RS |
91 | ;; Swap C-s and C-\ |
92 | (aset keyboard-translate-table flow-control-c-s-replacement ?\^s) | |
93 | (aset keyboard-translate-table ?\^s flow-control-c-s-replacement) | |
94 | ;; Swap C-q and C-^ | |
95 | (aset keyboard-translate-table flow-control-c-q-replacement ?\^q) | |
96 | (aset keyboard-translate-table ?\^q flow-control-c-q-replacement) | |
97 | (message (concat | |
98 | "XON/XOFF adjustment for " | |
99 | (getenv "TERM") | |
83d8b97d RS |
100 | ": use " |
101 | (single-key-description flow-control-c-s-replacement) | |
102 | " for C-s, and use " | |
103 | (single-key-description flow-control-c-q-replacement) | |
104 | " for C-q")) | |
162de182 | 105 | (sleep-for 2))) ; Give user a chance to see message. |
0f39230e JB |
106 | |
107 | ;;;###autoload | |
61251338 | 108 | (defun enable-flow-control-on (&rest losing-terminal-types) |
9c50f912 | 109 | "Enable flow control if using one of a specified set of terminal types. |
61251338 | 110 | Use `(enable-flow-control-on \"vt100\" \"h19\")' to enable flow control |
9c50f912 | 111 | on VT-100 and H19 terminals. When flow control is enabled, |
328561fc | 112 | you must type C-\\ to get the effect of a C-s, and type C-^ |
9c50f912 | 113 | to get the effect of a C-q." |
0f39230e JB |
114 | (let ((term (getenv "TERM")) |
115 | hyphend) | |
409adbc7 KH |
116 | ;; Look for TERM in LOSING-TERMINAL-TYPES. |
117 | ;; If we don't find it literally, try stripping off words | |
118 | ;; from the end, one by one. | |
119 | (while (and term (not (member term losing-terminal-types))) | |
120 | ;; Strip off last hyphen and what follows, then try again. | |
121 | (if (setq hyphend (string-match "[-_][^-_]+$" term)) | |
122 | (setq term (substring term 0 hyphend)) | |
123 | (setq term nil))) | |
3bf5f17a | 124 | (if term |
409adbc7 | 125 | (enable-flow-control)))) |
0f39230e | 126 | |
49116ac0 JB |
127 | (provide 'flow-ctrl) |
128 | ||
1a06eabd | 129 | ;;; flow-ctrl.el ends here |