<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect2 SYSTEM "../../../dtd/dblite.dtd">

<sect2 lang="en" id="git-column(1)">
    <title>git-column(1)</title>
    <date>2024-07-02</date>
<revhistory><revision><date>2024-07-02</date></revision></revhistory>
<indexterm>
<primary>git-column(1)</primary>
</indexterm>
<simplesect id="git-column(1)__name">
<title>NAME</title>
<simpara>git-column - Display data in columns</simpara>
</simplesect>
<simplesect id="git-column(1)__synopsis">
<title>SYNOPSIS</title>
<blockquote>
<literallayout><emphasis>git column</emphasis> [--command=&lt;name&gt;] [--[raw-]mode=&lt;mode&gt;] [--width=&lt;width&gt;]
             [--indent=&lt;string&gt;] [--nl=&lt;string&gt;] [--padding=&lt;n&gt;]</literallayout>
</blockquote>
</simplesect>
<simplesect id="git-column(1)__description">
<title>DESCRIPTION</title>
<simpara>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.</simpara>
</simplesect>
<simplesect id="git-column(1)__options">
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>
--command=&lt;name&gt;
</term>
<listitem>
<simpara>
        Look up layout mode using configuration variable column.&lt;name&gt; and
        column.ui.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--mode=&lt;mode&gt;
</term>
<listitem>
<simpara>
        Specify layout mode. See configuration variable column.ui for option
        syntax in <xref linkend="git-config(1)" />.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--raw-mode=&lt;n&gt;
</term>
<listitem>
<simpara>
        Same as --mode but take mode encoded as a number. This is mainly used
        by other commands that have already parsed layout mode.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--width=&lt;width&gt;
</term>
<listitem>
<simpara>
        Specify the terminal width. By default <emphasis>git column</emphasis> will detect the
        terminal width, or fall back to 80 if it is unable to do so.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--indent=&lt;string&gt;
</term>
<listitem>
<simpara>
        String to be printed at the beginning of each line.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--nl=&lt;string&gt;
</term>
<listitem>
<simpara>
        String to be printed at the end of each line,
        including newline character.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--padding=&lt;N&gt;
</term>
<listitem>
<simpara>
        The number of spaces between columns. One space by default.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</simplesect>
<simplesect id="git-column(1)__examples">
<title>EXAMPLES</title>
<simpara>Format data by columns:</simpara>
<screen>$ seq 1 24 | git column --mode=column --padding=5
1      4      7      10     13     16     19     22
2      5      8      11     14     17     20     23
3      6      9      12     15     18     21     24</screen>
<simpara>Format data by rows:</simpara>
<screen>$ seq 1 21 | git column --mode=row --padding=5
1      2      3      4      5      6      7
8      9      10     11     12     13     14
15     16     17     18     19     20     21</screen>
<simpara>List some tags in a table with unequal column widths:</simpara>
<screen>$ git tag --list 'v2.4.*' --column=row,dense
v2.4.0  v2.4.0-rc0  v2.4.0-rc1  v2.4.0-rc2  v2.4.0-rc3
v2.4.1  v2.4.10     v2.4.11     v2.4.12     v2.4.2
v2.4.3  v2.4.4      v2.4.5      v2.4.6      v2.4.7
v2.4.8  v2.4.9</screen>
</simplesect>
<simplesect id="git-column(1)__configuration">
<title>CONFIGURATION</title>
<simpara>Everything below this line in this section is selectively included
from the <xref linkend="git-config(1)" /> documentation. The content is the same
as what's found there:</simpara>
<variablelist>
<varlistentry>
<term>
column.ui
</term>
<listitem>
<simpara>
        Specify whether supported commands should output in columns.
        This variable consists of a list of tokens separated by spaces
        or commas:
</simpara>
<simpara>These options control when the feature should be enabled
(defaults to <emphasis>never</emphasis>):</simpara>
<variablelist>
<varlistentry>
<term>
<emphasis>always</emphasis>
</term>
<listitem>
<simpara>
        always show in columns
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<emphasis>never</emphasis>
</term>
<listitem>
<simpara>
        never show in columns
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<emphasis>auto</emphasis>
</term>
<listitem>
<simpara>
        show in columns if the output is to the terminal
</simpara>
</listitem>
</varlistentry>
</variablelist>
<simpara>These options control layout (defaults to <emphasis>column</emphasis>).  Setting any
of these implies <emphasis>always</emphasis> if none of <emphasis>always</emphasis>, <emphasis>never</emphasis>, or <emphasis>auto</emphasis> are
specified.</simpara>
<variablelist>
<varlistentry>
<term>
<emphasis>column</emphasis>
</term>
<listitem>
<simpara>
        fill columns before rows
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<emphasis>row</emphasis>
</term>
<listitem>
<simpara>
        fill rows before columns
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<emphasis>plain</emphasis>
</term>
<listitem>
<simpara>
        show in one column
</simpara>
</listitem>
</varlistentry>
</variablelist>
<simpara>Finally, these options can be combined with a layout option (defaults
to <emphasis>nodense</emphasis>):</simpara>
<variablelist>
<varlistentry>
<term>
<emphasis>dense</emphasis>
</term>
<listitem>
<simpara>
        make unequal size columns to utilize more space
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<emphasis>nodense</emphasis>
</term>
<listitem>
<simpara>
        make equal size columns
</simpara>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>
column.branch
</term>
<listitem>
<simpara>
        Specify whether to output branch listing in <emphasis>git branch</emphasis> in columns.
        See <emphasis>column.ui</emphasis> for details.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
column.clean
</term>
<listitem>
<simpara>
        Specify the layout when listing items in <emphasis>git clean -i</emphasis>, which always
        shows files and directories in columns. See <emphasis>column.ui</emphasis> for details.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
column.status
</term>
<listitem>
<simpara>
        Specify whether to output untracked files in <emphasis>git status</emphasis> in columns.
        See <emphasis>column.ui</emphasis> for details.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
column.tag
</term>
<listitem>
<simpara>
        Specify whether to output tag listings in <emphasis>git tag</emphasis> in columns.
        See <emphasis>column.ui</emphasis> for details.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</simplesect>
<simplesect id="git-column(1)__git">
<title>GIT</title>
<simpara>Part of the <xref linkend="git(1)" /> suite</simpara>
</simplesect>
</sect2>
