Documentation / git-column.txton commit Merge gitk to pick up emergency build fix (8a3a681)
   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