]> git.ipfire.org Git - thirdparty/git.git/blame_incremental - Documentation/git-column.txt
t4034: abstract away SHA-1-specific constants
[thirdparty/git.git] / Documentation / git-column.txt
... / ...
CommitLineData
1git-column(1)
2=============
3
4NAME
5----
6git-column - Display data in columns
7
8SYNOPSIS
9--------
10[verse]
11'git column' [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>]
12 [--indent=<string>] [--nl=<string>] [--padding=<n>]
13
14DESCRIPTION
15-----------
16This command formats the lines of its standard input into a table with
17multiple columns. Each input line occupies one cell of the table. It
18is used internally by other git commands to format output into
19columns.
20
21OPTIONS
22-------
23--command=<name>::
24 Look up layout mode using configuration variable column.<name> and
25 column.ui.
26
27--mode=<mode>::
28 Specify layout mode. See configuration variable column.ui for option
29 syntax in linkgit:git-config[1].
30
31--raw-mode=<n>::
32 Same as --mode but take mode encoded as a number. This is mainly used
33 by other commands that have already parsed layout mode.
34
35--width=<width>::
36 Specify the terminal width. By default 'git column' will detect the
37 terminal width, or fall back to 80 if it is unable to do so.
38
39--indent=<string>::
40 String to be printed at the beginning of each line.
41
42--nl=<N>::
43 String to be printed at the end of each line,
44 including newline character.
45
46--padding=<N>::
47 The number of spaces between columns. One space by default.
48
49EXAMPLES
50--------
51
52Format data by columns:
53------------
54$ seq 1 24 | git column --mode=column --padding=5
551 4 7 10 13 16 19 22
562 5 8 11 14 17 20 23
573 6 9 12 15 18 21 24
58------------
59
60Format data by rows:
61------------
62$ seq 1 21 | git column --mode=row --padding=5
631 2 3 4 5 6 7
648 9 10 11 12 13 14
6515 16 17 18 19 20 21
66------------
67
68List some tags in a table with unequal column widths:
69------------
70$ git tag --list 'v2.4.*' --column=row,dense
71v2.4.0 v2.4.0-rc0 v2.4.0-rc1 v2.4.0-rc2 v2.4.0-rc3
72v2.4.1 v2.4.10 v2.4.11 v2.4.12 v2.4.2
73v2.4.3 v2.4.4 v2.4.5 v2.4.6 v2.4.7
74v2.4.8 v2.4.9
75------------
76
77GIT
78---
79Part of the linkgit:git[1] suite