1GIT-COLUMN(1) Git Manual GIT-COLUMN(1)
2
6 git-column - Display data in columns
7
9 git column [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>]
10 [--indent=<string>] [--nl=<string>] [--padding=<n>]
11
13 This command formats the lines of its standard input into a table with
14 multiple columns. Each input line occupies one cell of the table. It is
15 used internally by other git commands to format output into columns.
16
18 --command=<name>
19 Look up layout mode using configuration variable column.<name> and
20 column.ui.
21 --mode=<mode>
23 Specify layout mode. See configuration variable column.ui for
24 option syntax in git-config(1).
25 --raw-mode=<n>
27 Same as --mode but take mode encoded as a number. This is mainly
28 used by other commands that have already parsed layout mode.
29 --width=<width>
31 Specify the terminal width. By default git column will detect the
32 terminal width, or fall back to 80 if it is unable to do so.
33 --indent=<string>
35 String to be printed at the beginning of each line.
36 --nl=<string>
38 String to be printed at the end of each line, including newline
39 character.
40 --padding=<N>
42 The number of spaces between columns. One space by default.
43
45 Format data by columns:
46 $ seq 1 24 | git column --mode=column --padding=5
48 1 4 7 10 13 16 19 22
49 2 5 8 11 14 17 20 23
50 3 6 9 12 15 18 21 24
51 Format data by rows:
53 $ seq 1 21 | git column --mode=row --padding=5
55 1 2 3 4 5 6 7
56 8 9 10 11 12 13 14
57 15 16 17 18 19 20 21
58 List some tags in a table with unequal column widths:
60 $ git tag --list 'v2.4.*' --column=row,dense
62 v2.4.0 v2.4.0-rc0 v2.4.0-rc1 v2.4.0-rc2 v2.4.0-rc3
63 v2.4.1 v2.4.10 v2.4.11 v2.4.12 v2.4.2
64 v2.4.3 v2.4.4 v2.4.5 v2.4.6 v2.4.7
65 v2.4.8 v2.4.9
66
68 Everything below this line in this section is selectively included from
69 the git-config(1) documentation. The content is the same as what’s
70 found there:
71 column.ui
73 Specify whether supported commands should output in columns. This
74 variable consists of a list of tokens separated by spaces or
75 commas:
76 These options control when the feature should be enabled (defaults
78 to never):
79 always
81 always show in columns
82 never
84 never show in columns
85 auto
87 show in columns if the output is to the terminal
88 These options control layout (defaults to column). Setting any of
90 these implies always if none of always, never, or auto are
91 specified.
92 column
94 fill columns before rows
95 row
97 fill rows before columns
98 plain
100 show in one column
101 Finally, these options can be combined with a layout option
103 (defaults to nodense):
104 dense
106 make unequal size columns to utilize more space
107 nodense
109 make equal size columns
110 column.branch
112 Specify whether to output branch listing in git branch in columns.
113 See column.ui for details.
114 column.clean
116 Specify the layout when listing items in git clean -i, which always
117 shows files and directories in columns. See column.ui for details.
118 column.status
120 Specify whether to output untracked files in git status in columns.
121 See column.ui for details.
122 column.tag
124 Specify whether to output tag listings in git tag in columns. See
125 column.ui for details.
126
128 Part of the git(1) suite
129Git 2.43.0 11/20/2023 GIT-COLUMN(1)