Auto wrap
| Documentation has been moved to https://stkb.github.io/Rewrap. This wiki is no longer maintained and may be out of date. |
Auto-wrap works like the auto-fill mode in Emacs. When pressing <space> or <enter> after the cursor is past the wrapping column, that line is wrapped onto the next.
Like in Emacs function, auto-wrap does not attempt to re-flow the entire paragraph; it only adds a break in the current line. It's handy when typing new text, but won't automatically fix a paragraph after inserting/removing text. For this you can always do a standard alt+q after making edits.
To suggest any improvements to this feature, please create an issue!
Auto-wrap is turned off by default. Turning it on is global: it affects all documents edited. In code files, only comments will be affected, so it's pretty safe to leave it on.
The Command Rewrap: Toggle Auto-Wrap in the command palette (F1) toggles it on/off.
A message shows in the status bar for a few seconds indicating the status.
There's no default keybinding for this command, but you can add one by binding to the command ID rewrap.toggleAutoWrap.
{
"key": "shift+alt+q",
"command": "rewrap.toggleAutoWrap"
}On the Edit menu, under the Rewrap Lines command, is the Toggle Auto-Wrap item.
The check-mark shows the status and a brief statusbar message is shown when turning on/off.
To add a keybinding, go to Tools -> Options, then Environment -> Keyboard. In this dialog pane search for the command Edit.ToggleAutoWrap and you can assign a shortcut key to it.