Skip to content

Latest commit

 

History

History
120 lines (94 loc) · 4.13 KB

README.org

File metadata and controls

120 lines (94 loc) · 4.13 KB
Raw

:editor word-wrap

Description

This module adds a minor-mode fn:+word-wrap-mode, which intelligently wraps long lines in the buffer without modifying the buffer content.

Maintainers

  • @flatwhatson

Become a maintainer?

Module flags

This module has no flags.

Packages

  • doom-package:adaptive-wrap
  • doom-package:visual-fill-column

Hacks

No hacks documented for this module.

Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module has no external requirements.

Usage

󱌣 This module has no usage documentation yet. Write some?

Configuration

󱌣 This module’s configuration documentation is incomplete. Complete it?

Activation

Word wrapping is not enabled by default.

Wrapping can be toggled in the current buffer with M-x +word-wrap-mode. The default doom bindings bind this to SPC t w for evil users.

To enable wrapping in a specific mode, add it to the appropriate hook in $DOOMDIR/config.el:

;; enable word-wrap in C/C++/ObjC/Java
(add-hook 'c-mode-common-hook #'+word-wrap-mode)

To customize the behaviour in a specific mode:

;; use a single indent and wrap at fill-column in json-mode
(add-hook! 'json-mode-hook
  (setq-local +word-wrap-extra-indent 'single
              +word-wrap-fill-style 'soft)
  (+word-wrap-mode +1))

To turn on word wrapping (almost) everywhere:

;; enable word-wrap (almost) everywhere
(+global-word-wrap-mode +1)

To disable global word-wrapping in a specific mode:

;; disable global word-wrap in emacs-lisp-mode
(add-to-list '+word-wrap-disabled-modes 'emacs-lisp-mode)

Settings

Wrapped lines will be indented to match the preceding line. In code buffers, lines which are not inside a string or comment will have extra indentation as determined by +word-wrap-extra-indent. The default is to increase the indent by twice the major-mode indent.

The +word-wrap-extra-indent variable supports the following values:

  • double: indent by twice the major-mode indentation
  • single: indent by the major-mode indentation
  • a positive integer: indent by this fixed amount
  • a negative integer: dedent by this fixed amount
  • nil: no extra indent

Long lines are wrapped at the window margin by default, however soft-wrapping at fill-column is supported by setting +word-wrap-fill-style. When set to auto, if auto-fill-mode is enabled in the buffer, its behavior will not be affected. This allows hard and soft wrapping methods to co-exist, with hard-wrapping for new lines and soft-wrapping for existing lines. To disable hard-wrapping entirely, set +word-wrap-fill-style to soft.

This module also includes a global minor-mode +global-word-wrap-mode to automatically enable wrapping in most buffers. Wrapping will not be enabled in buffers whose major mode is marked “special”, or are listed in +word-wrap-disabled-modes.

The +word-wrap-text-modes variable lists modes which shouldn’t have any extra indentation, regardless of the +word-wrap-extra-indent setting. This is useful for modes which are primarily text, such as text-mode and markdown-mode.

The +word-wrap-visual-modes variable lists modes which should only enable visual-line-mode and not provide any prefix indentation. This is useful for modes like org-mode which handle prefix indentation themselves.

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

Appendix

󱌣 This module has no appendix yet. Write one?