]> git.eshelyaron.com Git - emacs.git/commitdiff
Delete pre-Emacs 20 documentation from term.el
authorStefan Kangas <stefankangas@gmail.com>
Sat, 15 Mar 2025 01:37:44 +0000 (02:37 +0100)
committerEshel Yaron <me@eshelyaron.com>
Sat, 15 Mar 2025 17:13:29 +0000 (18:13 +0100)
* lisp/term.el: Delete comment titled "Converting process modes to use
term mode".  This comment from 1994 is only of historical interest.

(cherry picked from commit aa66edeeba508bf5be89a5257216a5d995e47d89)

lisp/term.el

index 4394f11033113dfc27319e6ebf3a80729db8e6c7..fcbc1a421d165c377b3290781ea20e82c4dc5e0f 100644 (file)
@@ -4710,77 +4710,6 @@ The return value may be nil for a special serial port."
           :button (:toggle . ,(equal (plist-get config (nth 0 y))
                                      (nth 1 y))))))))
 
-\f
-;;; Converting process modes to use term mode
-;; ===========================================================================
-;; Renaming variables
-;; Most of the work is renaming variables and functions.  These are the common
-;; ones:
-;; Local variables:
-;;     last-input-start        term-last-input-start
-;;     last-input-end          term-last-input-end
-;;     shell-prompt-pattern    term-prompt-regexp
-;;     shell-set-directory-error-hook <no equivalent>
-;; Miscellaneous:
-;;     shell-set-directory     <unnecessary>
-;;     shell-mode-map          term-mode-map
-;; Commands:
-;;     shell-send-input        term-send-input
-;;     shell-send-eof          term-delchar-or-maybe-eof
-;;     kill-shell-input        term-kill-input
-;;     interrupt-shell-subjob  term-interrupt-subjob
-;;     stop-shell-subjob       term-stop-subjob
-;;     quit-shell-subjob       term-quit-subjob
-;;     kill-shell-subjob       term-kill-subjob
-;;     kill-output-from-shell  term-kill-output
-;;     show-output-from-shell  term-show-output
-;;     copy-last-shell-input   Use term-previous-input/term-next-input
-;;
-;; SHELL-SET-DIRECTORY is gone, its functionality taken over by
-;; SHELL-DIRECTORY-TRACKER, the shell mode's term-input-filter-functions.
-;; Term mode does not provide functionality equivalent to
-;; shell-set-directory-error-hook; it is gone.
-;;
-;; term-last-input-start is provided for modes which want to munge
-;; the buffer after input is sent, perhaps because the inferior
-;; insists on echoing the input.  The LAST-INPUT-START variable in
-;; the old shell package was used to implement a history mechanism,
-;; but you should think twice before using term-last-input-start
-;; for this; the input history ring often does the job better.
-;;
-;; If you are implementing some process-in-a-buffer mode, called foo-mode, do
-;; *not* create the term-mode local variables in your foo-mode function.
-;; This is not modular.  Instead, call term-mode, and let *it* create the
-;; necessary term-specific local variables.  Then create the
-;; foo-mode-specific local variables in foo-mode.  Set the buffer's keymap to
-;; be foo-mode-map, and its mode to be foo-mode.  Set the term-mode hooks
-;; (term-{prompt-regexp, input-filter, input-filter-functions,
-;; get-old-input) that need to be different from the defaults.  Call
-;; foo-mode-hook, and you're done.  Don't run the term-mode hook yourself;
-;; term-mode will take care of it.  The following example, from shell.el,
-;; is typical:
-;;
-;; (defvar shell-mode-map
-;;   (let ((map (make-sparse-keymap)))
-;;     (define-key map "\C-c\C-f" 'shell-forward-command)
-;;     (define-key map "\C-c\C-b" 'shell-backward-command)
-;;     (define-key map "\t" 'term-dynamic-complete)
-;;     (define-key map "\M-?"
-;;       'term-dynamic-list-filename-completions)))
-;;
-;; (define-derived-mode shell-mode term-mode "Shell"
-;;   "A shell mode."
-;;   (setq-local term-prompt-regexp shell-prompt-pattern)
-;;   (setq-local shell-directory-stack nil)
-;;   (add-hook 'term-input-filter-functions #'shell-directory-tracker nil t))
-;;
-;; Completion for term-mode users
-;;
-;; For modes that use term-mode, term-dynamic-complete-functions is the
-;; hook to add completion functions to.  Functions on this list should return
-;; non-nil if completion occurs (i.e., further completion should not occur).
-;; You could use completion-in-region to do the bulk of the
-;; completion job.
 \f
 (provide 'term)