projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| 7e29b825 NTND |
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>] | |
| b4ab1980 | 12 | [--indent=<string>] [--nl=<string>] [--padding=<n>] |
| 7e29b825 NTND |
13 | |
| 14 | DESCRIPTION | |
| 15 | ----------- | |
| 6271d947 FE |
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. | |
| 7e29b825 NTND |
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 | |
| 6271d947 | 29 | syntax in linkgit:git-config[1]. |
| 7e29b825 NTND |
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 | ||
| 6271d947 | 49 | EXAMPLES |
| 0ee7a9af | 50 | -------- |
| 6271d947 FE |
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 | ||
| 7e29b825 NTND |
77 | GIT |
| 78 | --- | |
| 79 | Part of the linkgit:git[1] suite |