man1/git-column.1

   1 '\" t
   2 .\"     Title: git-column
   3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 12/10/2021
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.34.1.182.ge773545c7f
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-COLUMN" "1" "12/10/2021" "Git 2\&.34\&.1\&.182\&.ge77354" "Git Manual"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 git-column \- Display data in columns
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 \fIgit column\fR [\-\-command=<name>] [\-\-[raw\-]mode=<mode>] [\-\-width=<width>]
  36              [\-\-indent=<string>] [\-\-nl=<string>] [\-\-padding=<n>]
  37 .fi
  38 .sp
  39 .SH "DESCRIPTION"
  40 .sp
  41 This command formats the lines of its standard input into a table with multiple columns\&. Each input line occupies one cell of the table\&. It is used internally by other git commands to format output into columns\&.
  42 .SH "OPTIONS"
  43 .PP
  44 \-\-command=<name>
  45 .RS 4
  46 Look up layout mode using configuration variable column\&.<name> and column\&.ui\&.
  47 .RE
  48 .PP
  49 \-\-mode=<mode>
  50 .RS 4
  51 Specify layout mode\&. See configuration variable column\&.ui for option syntax in
  52 \fBgit-config\fR(1)\&.
  53 .RE
  54 .PP
  55 \-\-raw\-mode=<n>
  56 .RS 4
  57 Same as \-\-mode but take mode encoded as a number\&. This is mainly used by other commands that have already parsed layout mode\&.
  58 .RE
  59 .PP
  60 \-\-width=<width>
  61 .RS 4
  62 Specify the terminal width\&. By default
  63 \fIgit column\fR
  64 will detect the terminal width, or fall back to 80 if it is unable to do so\&.
  65 .RE
  66 .PP
  67 \-\-indent=<string>
  68 .RS 4
  69 String to be printed at the beginning of each line\&.
  70 .RE
  71 .PP
  72 \-\-nl=<string>
  73 .RS 4
  74 String to be printed at the end of each line, including newline character\&.
  75 .RE
  76 .PP
  77 \-\-padding=<N>
  78 .RS 4
  79 The number of spaces between columns\&. One space by default\&.
  80 .RE
  81 .SH "EXAMPLES"
  82 .sp
  83 Format data by columns:
  84 .sp
  85 .if n \{\
  86 .RS 4
  87 .\}
  88 .nf
  89 $ seq 1 24 | git column \-\-mode=column \-\-padding=5
  90 1      4      7      10     13     16     19     22
  91 2      5      8      11     14     17     20     23
  92 3      6      9      12     15     18     21     24
  93 .fi
  94 .if n \{\
  95 .RE
  96 .\}
  97 .sp
  98 .sp
  99 Format data by rows:
 100 .sp
 101 .if n \{\
 102 .RS 4
 103 .\}
 104 .nf
 105 $ seq 1 21 | git column \-\-mode=row \-\-padding=5
 106 1      2      3      4      5      6      7
 107 8      9      10     11     12     13     14
 108 15     16     17     18     19     20     21
 109 .fi
 110 .if n \{\
 111 .RE
 112 .\}
 113 .sp
 114 .sp
 115 List some tags in a table with unequal column widths:
 116 .sp
 117 .if n \{\
 118 .RS 4
 119 .\}
 120 .nf
 121 $ git tag \-\-list \(aqv2\&.4\&.*\(aq \-\-column=row,dense
 122 v2\&.4\&.0  v2\&.4\&.0\-rc0  v2\&.4\&.0\-rc1  v2\&.4\&.0\-rc2  v2\&.4\&.0\-rc3
 123 v2\&.4\&.1  v2\&.4\&.10     v2\&.4\&.11     v2\&.4\&.12     v2\&.4\&.2
 124 v2\&.4\&.3  v2\&.4\&.4      v2\&.4\&.5      v2\&.4\&.6      v2\&.4\&.7
 125 v2\&.4\&.8  v2\&.4\&.9
 126 .fi
 127 .if n \{\
 128 .RE
 129 .\}
 130 .sp
 131 .SH "GIT"
 132 .sp
 133 Part of the \fBgit\fR(1) suite