blob: 265cb72b718f284e49f9890404f1c8d25f4cfc0c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<h1>git-column</h1> <h2 id="_name">Name</h2> <div class="sectionbody"> <p>git-column - Display data in columns</p> </div> <h2 id="_synopsis">Synopsis</h2> <div class="sectionbody"> <div class="verseblock"> <pre class="content" data-language="shell">git column [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>]
[--indent=<string>] [--nl=<string>] [--padding=<n>]</pre> </div> </div> <h2 id="_description">Description</h2> <div class="sectionbody"> <p>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.</p> </div> <h2 id="_options">Options</h2> <div class="sectionbody"> <div class="dlist"> <dl> <dt class="hdlist1" id="Documentation/git-column.txt---commandltnamegt"> --command=<name> </dt> <dd> <p>Look up layout mode using configuration variable column.<name> and column.ui.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt---modeltmodegt"> --mode=<mode> </dt> <dd> <p>Specify layout mode. See configuration variable column.ui for option syntax in <a href="git-config">git-config[1]</a>.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt---raw-modeltngt"> --raw-mode=<n> </dt> <dd> <p>Same as --mode but take mode encoded as a number. This is mainly used by other commands that have already parsed layout mode.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt---widthltwidthgt"> --width=<width> </dt> <dd> <p>Specify the terminal width. By default <code>git column</code> will detect the terminal width, or fall back to 80 if it is unable to do so.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt---indentltstringgt"> --indent=<string> </dt> <dd> <p>String to be printed at the beginning of each line.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt---nlltstringgt"> --nl=<string> </dt> <dd> <p>String to be printed at the end of each line, including newline character.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt---paddingltNgt"> --padding=<N> </dt> <dd> <p>The number of spaces between columns. One space by default.</p> </dd> </dl> </div> </div> <h2 id="_examples">Examples</h2> <div class="sectionbody"> <p>Format data by columns:</p> <div class="listingblock"> <div class="content"> <pre data-language="shell-session">$ 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</pre> </div> </div> <p>Format data by rows:</p> <div class="listingblock"> <div class="content"> <pre data-language="shell-session">$ 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</pre> </div> </div> <p>List some tags in a table with unequal column widths:</p> <div class="listingblock"> <div class="content"> <pre data-language="shell-session">$ 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</pre> </div> </div> </div> <h2 id="_configuration">Configuration</h2> <div class="sectionbody"> <p>Everything below this line in this section is selectively included from the <a href="git-config">git-config[1]</a> documentation. The content is the same as what’s found there:</p> <div class="dlist"> <dl> <dt class="hdlist1" id="Documentation/git-column.txt-columnui"> column.ui </dt> <dd> <p>Specify whether supported commands should output in columns. This variable consists of a list of tokens separated by spaces or commas:</p> <p>These options control when the feature should be enabled (defaults to <code>never</code>):</p> <div class="openblock"> <div class="content"> <div class="dlist"> <dl> <dt class="hdlist1" id="Documentation/git-column.txt-codealwayscode"> <code>always</code> </dt> <dd> <p>always show in columns</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-codenevercode"> <code>never</code> </dt> <dd> <p>never show in columns</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-codeautocode"> <code>auto</code> </dt> <dd> <p>show in columns if the output is to the terminal</p> </dd> </dl> </div> </div> </div> <p>These options control layout (defaults to <code>column</code>). Setting any of these implies <code>always</code> if none of <code>always</code>, <code>never</code>, or <code>auto</code> are specified.</p> <div class="openblock"> <div class="content"> <div class="dlist"> <dl> <dt class="hdlist1" id="Documentation/git-column.txt-codecolumncode"> <code>column</code> </dt> <dd> <p>fill columns before rows</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-coderowcode"> <code>row</code> </dt> <dd> <p>fill rows before columns</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-codeplaincode"> <code>plain</code> </dt> <dd> <p>show in one column</p> </dd> </dl> </div> </div> </div> <p>Finally, these options can be combined with a layout option (defaults to <code>nodense</code>):</p> <div class="openblock"> <div class="content"> <div class="dlist"> <dl> <dt class="hdlist1" id="Documentation/git-column.txt-codedensecode"> <code>dense</code> </dt> <dd> <p>make unequal size columns to utilize more space</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-codenodensecode"> <code>nodense</code> </dt> <dd> <p>make equal size columns</p> </dd> </dl> </div> </div> </div> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-columnbranch"> column.branch </dt> <dd> <p>Specify whether to output branch listing in <code>git branch</code> in columns. See <code>column.ui</code> for details.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-columnclean"> column.clean </dt> <dd> <p>Specify the layout when listing items in <code>git clean -i</code>, which always shows files and directories in columns. See <code>column.ui</code> for details.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-columnstatus"> column.status </dt> <dd> <p>Specify whether to output untracked files in <code>git status</code> in columns. See <code>column.ui</code> for details.</p> </dd> <dt class="hdlist1" id="Documentation/git-column.txt-columntag"> column.tag </dt> <dd> <p>Specify whether to output tag listings in <code>git tag</code> in columns. See <code>column.ui</code> for details.</p> </dd> </dl> </div> </div><div class="_attribution">
<p class="_attribution-p">
© 2012–2024 Scott Chacon and others<br>Licensed under the MIT License.<br>
<a href="https://git-scm.com/docs/git-column" class="_attribution-link">https://git-scm.com/docs/git-column</a>
</p>
</div>
|
