Function: binary-overwrite-mode

binary-overwrite-mode is an interactive and byte-compiled function defined in simple.el.gz.

Signature

(binary-overwrite-mode &optional ARG)

Documentation

Toggle Binary Overwrite mode.

When Binary Overwrite mode is enabled, printing characters typed in replace existing text. Newlines are not treated specially, so typing at the end of a line joins the line to the next, with the typed character between them. Typing before a tab character simply replaces the tab with the character typed. C-q (quoted-insert) replaces the text at the cursor, just as ordinary typing characters do.

Note that Binary Overwrite mode is not its own minor mode; it is a specialization of overwrite mode, entered by setting the overwrite-mode(var)/overwrite-mode(fun) variable to overwrite-mode-binary.

This is a minor mode. If called interactively, toggle the Binary-Overwrite mode mode. If the prefix argument is positive, enable the mode, and if it is zero or negative, disable the mode.

If called from Lisp, toggle the mode if ARG is toggle. Enable the mode if ARG is nil, omitted, or is a positive number. Disable the mode if ARG is a negative number.

To check whether the minor mode is enabled in the current buffer, evaluate overwrite-mode(var)/overwrite-mode(fun).

The mode's hook is called both when the mode is enabled and when it is disabled.

View in manual

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/simple.el.gz
(define-minor-mode binary-overwrite-mode
  "Toggle Binary Overwrite mode.

When Binary Overwrite mode is enabled, printing characters typed
in replace existing text.  Newlines are not treated specially, so
typing at the end of a line joins the line to the next, with the
typed character between them.  Typing before a tab character
simply replaces the tab with the character typed.
\\[quoted-insert] replaces the text at the cursor, just as
ordinary typing characters do.

Note that Binary Overwrite mode is not its own minor mode; it is
a specialization of overwrite mode, entered by setting the
`overwrite-mode' variable to `overwrite-mode-binary'."
  :variable (overwrite-mode
             . (lambda (v) (setq overwrite-mode (if v 'overwrite-mode-binary)))))