Skip to content

Commit 592aec4

Browse files
authored
Merge pull request #7968 from microsoft/overtype
Add clarification for overtype mode
2 parents c1d0ce2 + aa089a7 commit 592aec4

File tree

2 files changed

+7
-5
lines changed

2 files changed

+7
-5
lines changed

docs/editor/codebasics.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -423,13 +423,15 @@ Then choose an encoding.
423423

424424
## Overtype mode
425425

426-
VS Code supports *overtype* mode, which lets you overwrite existing characters instead of inserting characters at the cursor position. By default, overtype mode is off.
426+
Prior to release 1.96, VS Code only supported *insert* mode, where characters are inserted at the cursor position, unless you installed the Vim [keymap extension](/docs/getstarted/keybindings.md#keymap-extensions).
427+
428+
As of release 1.96, VS Code supports *overtype* mode, which lets you overwrite existing characters instead of inserting characters at the cursor position. By default, overtype mode is off.
427429

428430
To switch between insert and overtype mode, run the **Toggle Overtype/Insert Mode** command in the Command Palette or press (`kb(editor.action.toggleOvertypeInsertMode)`). When you're in overtype mode, a Status Bar indicator shows `OVR`.
429431

430432
You can change the cursor style for overtype mode by configuring the `setting(editor.overtypeCursorStyle)` setting.
431433

432-
The `setting(editor.overtypeOnPaste)` setting enables you to use overtype for pasting text. You need to be in overtype mode for this setting to take effect.
434+
Use the `setting(editor.overtypeOnPaste)` setting to overwrite text when pasting. You need to be in overtype mode for this setting to take effect.
433435

434436
## Compare files
435437

release-notes/v1_96.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -276,13 +276,13 @@ The Find control now can persist the search history across sessions and restores
276276

277277
### Overtype mode
278278

279-
On popular request, we added overtype mode to overwrite text in the editor instead of inserting it when typing. A useful scenario for this is when editing Markdown tables, where you want to keep the table cell boundaries nicely aligned.
279+
Did you know that VS Code didn't support overwriting text in the editor, unless you installed the Vim keymap? On popular request, we now added overtype mode to overwrite text in the editor instead of inserting it when typing. A useful scenario for this is when editing Markdown tables, where you want to keep the table cell boundaries nicely aligned.
280280

281-
This mode can be toggled with the command **View: Toggle Overtype/Insert Mode**. When you're in overtype mode, the Status Bar shows an `OVR` indicator. In addition, there is a setting `setting(editor.overtypeOnPaste)`, which determines whether pasting in overtype mode should overwrite or insert. The default behavior is to insert pasted text.
281+
This mode can be toggled with the command **View: Toggle Overtype/Insert Mode** or by using the `kbstyle(Insert)` key on your keyboard. When you're in overtype mode, the Status Bar shows an `OVR` indicator.
282282

283283
<video src="images/1_96/overtype.mp4" title="Overtype mode" autoplay loop controls muted></video>
284284

285-
It is possible to change the cursor style while in overtype mode by using the setting `setting(editor.overtypeCursorStyle)`.
285+
It is possible to change the cursor style while in overtype mode by using the setting `setting(editor.overtypeCursorStyle)`. In addition, there is a setting `setting(editor.overtypeOnPaste)`, which determines whether pasting in overtype mode should overwrite or insert. The default behavior is to insert pasted text.
286286

287287
## Source Control
288288

0 commit comments

Comments
 (0)