| Junio C Hamano | 22700fb | 2012-05-03 23:07:25 | [diff] [blame] | 1 | git-column(1) |
| 2 | ============= |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | git-column - Display data in columns |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| 11 | 'git column' [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>] |
| Junio C Hamano | 010705a | 2012-06-19 23:37:26 | [diff] [blame] | 12 | [--indent=<string>] [--nl=<string>] [--padding=<n>] |
| Junio C Hamano | 22700fb | 2012-05-03 23:07:25 | [diff] [blame] | 13 | |
| 14 | DESCRIPTION |
| 15 | ----------- |
| Junio C Hamano | 32a7527 | 2018-10-16 07:37:35 | [diff] [blame] | 16 | This command formats the lines of its standard input into a table with |
| 17 | multiple columns. Each input line occupies one cell of the table. It |
| 18 | is used internally by other git commands to format output into |
| 19 | columns. |
| Junio C Hamano | 22700fb | 2012-05-03 23:07:25 | [diff] [blame] | 20 | |
| 21 | OPTIONS |
| 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 |
| Junio C Hamano | 32a7527 | 2018-10-16 07:37:35 | [diff] [blame] | 29 | syntax in linkgit:git-config[1]. |
| Junio C Hamano | 22700fb | 2012-05-03 23:07:25 | [diff] [blame] | 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 | |
| Junio C Hamano | 32a7527 | 2018-10-16 07:37:35 | [diff] [blame] | 49 | EXAMPLES |
| Junio C Hamano | ace33e4 | 2019-01-18 23:16:05 | [diff] [blame] | 50 | -------- |
| Junio C Hamano | 32a7527 | 2018-10-16 07:37:35 | [diff] [blame] | 51 | |
| 52 | Format data by columns: |
| 53 | ------------ |
| 54 | $ seq 1 24 | git column --mode=column --padding=5 |
| 55 | 1 4 7 10 13 16 19 22 |
| 56 | 2 5 8 11 14 17 20 23 |
| 57 | 3 6 9 12 15 18 21 24 |
| 58 | ------------ |
| 59 | |
| 60 | Format data by rows: |
| 61 | ------------ |
| 62 | $ seq 1 21 | git column --mode=row --padding=5 |
| 63 | 1 2 3 4 5 6 7 |
| 64 | 8 9 10 11 12 13 14 |
| 65 | 15 16 17 18 19 20 21 |
| 66 | ------------ |
| 67 | |
| 68 | List some tags in a table with unequal column widths: |
| 69 | ------------ |
| 70 | $ git tag --list 'v2.4.*' --column=row,dense |
| 71 | v2.4.0 v2.4.0-rc0 v2.4.0-rc1 v2.4.0-rc2 v2.4.0-rc3 |
| 72 | v2.4.1 v2.4.10 v2.4.11 v2.4.12 v2.4.2 |
| 73 | v2.4.3 v2.4.4 v2.4.5 v2.4.6 v2.4.7 |
| 74 | v2.4.8 v2.4.9 |
| 75 | ------------ |
| 76 | |
| Junio C Hamano | 22700fb | 2012-05-03 23:07:25 | [diff] [blame] | 77 | GIT |
| 78 | --- |
| 79 | Part of the linkgit:git[1] suite |
