Variable: magit-diff-adjust-tab-width

magit-diff-adjust-tab-width is a customizable variable defined in magit-diff.el.

Value

nil

Documentation

Whether to adjust the width of tabs in diffs.

Determining the correct width can be expensive if it requires opening large and/or many files, so the widths are cached in the variable magit-diff--tab-width-cache. Set that to nil to invalidate the cache.

nil Never adjust tab width. Use tab-widths value from
          the Magit buffer itself instead.

t If the corresponding file-visiting buffer exits, then
          use tab-widths value from that buffer. Doing this is
          cheap, so this value is used even if a corresponding
          cache entry exists.

always If there is no such buffer, then temporarily visit the
          file to determine the value.

NUMBER Like always, but don't visit files larger than NUMBER
          bytes.

This variable was added, or its default value changed, in magit version 2.12.0.

Source Code

;; Defined in ~/.emacs.d/elpa/magit-20260411.1452/magit-diff.el
(defcustom magit-diff-adjust-tab-width nil
  "Whether to adjust the width of tabs in diffs.

Determining the correct width can be expensive if it requires
opening large and/or many files, so the widths are cached in
the variable `magit-diff--tab-width-cache'.  Set that to `nil'
to invalidate the cache.

`nil'     Never adjust tab width.  Use `tab-width's value from
          the Magit buffer itself instead.

`t'       If the corresponding file-visiting buffer exits, then
          use `tab-width's value from that buffer.  Doing this is
          cheap, so this value is used even if a corresponding
          cache entry exists.

`always'  If there is no such buffer, then temporarily visit the
          file to determine the value.

NUMBER    Like `always', but don't visit files larger than NUMBER
          bytes."
  :package-version '(magit . "2.12.0")
  :group 'magit-diff
  :type '(choice (const   :tag "Never" nil)
                 (const   :tag "If file-visiting buffer exists" t)
                 (integer :tag "If file isn't larger than N bytes")
                 (const   :tag "Always" always)))