Variable: magit-repolist-columns

magit-repolist-columns is a customizable variable defined in magit-repos.el.

Value

(("Name" 25 magit-repolist-column-ident nil)
 ("Version" 25 magit-repolist-column-version
  ((:sort magit-repolist-version<)))
 ("B<U" 3 magit-repolist-column-unpulled-from-upstream
  ((:right-align t)
   (:sort <)))
 ("B>U" 3 magit-repolist-column-unpushed-to-upstream
  ((:right-align t)
   (:sort <)))
 ("Path" 99 magit-repolist-column-path nil))

Documentation

List of columns displayed by magit-list-repositories.

Each element has the form (HEADER WIDTH FORMAT PROPS).

HEADER is the string displayed in the header. WIDTH is the width of the column. FORMAT is a function that is called with one argument, the repository identification (usually its basename), and with default-directory bound to the toplevel of its working tree. It has to return a string to be inserted or nil. PROPS is an alist that supports the keys :right-align, :pad-right and
:sort.

The :sort function has a weird interface described in the docstring of tabulated-list--get-sort. Alternatively < and magit-repolist-version< can be used as those functions are automatically replaced with functions that satisfy the interface. Set :sort to nil to inhibit sorting; if unspecified, then the column is sortable using the default sorter.

You may wish to display a range of numeric columns using just one character per column and without any padding between columns, in which case you should use an appropriate HEADER, set WIDTH to 1, and set :pad-right to 0. "+" is substituted for numbers higher than 9.

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-repos.el
(defcustom magit-repolist-columns
  `(("Name"    25 ,#'magit-repolist-column-ident
     ())
    ("Version" 25 ,#'magit-repolist-column-version
     ((:sort magit-repolist-version<)))
    ("B<U"      3 ,#'magit-repolist-column-unpulled-from-upstream
     (;; (:help-echo "Upstream changes not in branch")
      (:right-align t)
      (:sort <)))
    ("B>U"      3 ,#'magit-repolist-column-unpushed-to-upstream
     (;; (:help-echo "Local changes not in upstream")
      (:right-align t)
      (:sort <)))
    ("Path"    99 ,#'magit-repolist-column-path
     ()))
  "List of columns displayed by `magit-list-repositories'.

Each element has the form (HEADER WIDTH FORMAT PROPS).

HEADER is the string displayed in the header.  WIDTH is the width
of the column.  FORMAT is a function that is called with one
argument, the repository identification (usually its basename),
and with `default-directory' bound to the toplevel of its working
tree.  It has to return a string to be inserted or nil.  PROPS is
an alist that supports the keys `:right-align', `:pad-right' and
`:sort'.

The `:sort' function has a weird interface described in the
docstring of `tabulated-list--get-sort'.  Alternatively `<' and
`magit-repolist-version<' can be used as those functions are
automatically replaced with functions that satisfy the interface.
Set `:sort' to nil to inhibit sorting; if unspecified, then the
column is sortable using the default sorter.

You may wish to display a range of numeric columns using just one
character per column and without any padding between columns, in
which case you should use an appropriate HEADER, set WIDTH to 1,
and set `:pad-right' to 0.  \"+\" is substituted for numbers higher
than 9."
  :package-version '(magit . "2.12.0")
  :group 'magit-repolist
  :type '(repeat (list :tag "Column"
                       (string   :tag "Header Label")
                       (integer  :tag "Column Width")
                       (function :tag "Inserter Function")
                       (repeat   :tag "Properties"
                                 (list (choice :tag "Property"
                                               (const :right-align)
                                               (const :pad-right)
                                               (const :sort)
                                               (symbol))
                                       (sexp   :tag "Value"))))))