aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorStefan Kangas2025-03-15 02:37:44 +0100
committerStefan Kangas2025-03-15 04:10:28 +0100
commitaa66edeeba508bf5be89a5257216a5d995e47d89 (patch)
treebd4075d304bd6f2743d8437c86dbe80f7e4591fd
parent3864b9352a01804af2e4b43a6bc171953375cdf7 (diff)
downloademacs-aa66edeeba508bf5be89a5257216a5d995e47d89.tar.gz
emacs-aa66edeeba508bf5be89a5257216a5d995e47d89.zip
Delete pre-Emacs 20 documentation from term.el
* lisp/term.el: Delete comment titled "Converting process modes to use term mode". This comment from 1994 is only of historical interest.
-rw-r--r--lisp/term.el71
1 files changed, 0 insertions, 71 deletions
diff --git a/lisp/term.el b/lisp/term.el
index 4f0c5337c1e..862103d88e6 100644
--- a/lisp/term.el
+++ b/lisp/term.el
@@ -4742,77 +4742,6 @@ The return value may be nil for a special serial port."
4742 (nth 1 y)))))))) 4742 (nth 1 y))))))))
4743 4743
4744 4744
4745;;; Converting process modes to use term mode
4746;; ===========================================================================
4747;; Renaming variables
4748;; Most of the work is renaming variables and functions. These are the common
4749;; ones:
4750;; Local variables:
4751;; last-input-start term-last-input-start
4752;; last-input-end term-last-input-end
4753;; shell-prompt-pattern term-prompt-regexp
4754;; shell-set-directory-error-hook <no equivalent>
4755;; Miscellaneous:
4756;; shell-set-directory <unnecessary>
4757;; shell-mode-map term-mode-map
4758;; Commands:
4759;; shell-send-input term-send-input
4760;; shell-send-eof term-delchar-or-maybe-eof
4761;; kill-shell-input term-kill-input
4762;; interrupt-shell-subjob term-interrupt-subjob
4763;; stop-shell-subjob term-stop-subjob
4764;; quit-shell-subjob term-quit-subjob
4765;; kill-shell-subjob term-kill-subjob
4766;; kill-output-from-shell term-kill-output
4767;; show-output-from-shell term-show-output
4768;; copy-last-shell-input Use term-previous-input/term-next-input
4769;;
4770;; SHELL-SET-DIRECTORY is gone, its functionality taken over by
4771;; SHELL-DIRECTORY-TRACKER, the shell mode's term-input-filter-functions.
4772;; Term mode does not provide functionality equivalent to
4773;; shell-set-directory-error-hook; it is gone.
4774;;
4775;; term-last-input-start is provided for modes which want to munge
4776;; the buffer after input is sent, perhaps because the inferior
4777;; insists on echoing the input. The LAST-INPUT-START variable in
4778;; the old shell package was used to implement a history mechanism,
4779;; but you should think twice before using term-last-input-start
4780;; for this; the input history ring often does the job better.
4781;;
4782;; If you are implementing some process-in-a-buffer mode, called foo-mode, do
4783;; *not* create the term-mode local variables in your foo-mode function.
4784;; This is not modular. Instead, call term-mode, and let *it* create the
4785;; necessary term-specific local variables. Then create the
4786;; foo-mode-specific local variables in foo-mode. Set the buffer's keymap to
4787;; be foo-mode-map, and its mode to be foo-mode. Set the term-mode hooks
4788;; (term-{prompt-regexp, input-filter, input-filter-functions,
4789;; get-old-input) that need to be different from the defaults. Call
4790;; foo-mode-hook, and you're done. Don't run the term-mode hook yourself;
4791;; term-mode will take care of it. The following example, from shell.el,
4792;; is typical:
4793;;
4794;; (defvar shell-mode-map
4795;; (let ((map (make-sparse-keymap)))
4796;; (define-key map "\C-c\C-f" 'shell-forward-command)
4797;; (define-key map "\C-c\C-b" 'shell-backward-command)
4798;; (define-key map "\t" 'term-dynamic-complete)
4799;; (define-key map "\M-?"
4800;; 'term-dynamic-list-filename-completions)))
4801;;
4802;; (define-derived-mode shell-mode term-mode "Shell"
4803;; "A shell mode."
4804;; (setq-local term-prompt-regexp shell-prompt-pattern)
4805;; (setq-local shell-directory-stack nil)
4806;; (add-hook 'term-input-filter-functions #'shell-directory-tracker nil t))
4807;;
4808;; Completion for term-mode users
4809;;
4810;; For modes that use term-mode, term-dynamic-complete-functions is the
4811;; hook to add completion functions to. Functions on this list should return
4812;; non-nil if completion occurs (i.e., further completion should not occur).
4813;; You could use completion-in-region to do the bulk of the
4814;; completion job.
4815
4816(provide 'term) 4745(provide 'term)
4817 4746
4818;;; term.el ends here 4747;;; term.el ends here