mirror of
https://github.com/git/git.git
synced 2024-12-01 14:03:34 +08:00
c93ca46cf5
'git column's '--nl' option can be used to specify a "string to be
printed at the end of each line" (quoting the man page), but this
option and its mandatory argument has been parsed as OPT_INTEGER since
the introduction of the command in 7e29b8254f (Add column layout
skeleton and git-column, 2012-04-21). Consequently, any non-number
argument is rejected by parse-options, and any number other than 0
leads to segfault:
$ printf "%s\n" one two |git column --mode=plain --nl=foo
error: option `nl' expects a numerical value
$ printf "%s\n" one two |git column --mode=plain --nl=42
Segmentation fault (core dumped)
$ printf "%s\n" one two |git column --mode=plain --nl=0
one
two
Parse this option as OPT_STRING.
Signed-off-by: SZEDER Gábor <szeder.dev@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
80 lines
2.0 KiB
Plaintext
80 lines
2.0 KiB
Plaintext
git-column(1)
|
|
=============
|
|
|
|
NAME
|
|
----
|
|
git-column - Display data in columns
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git column' [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>]
|
|
[--indent=<string>] [--nl=<string>] [--padding=<n>]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
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.
|
|
|
|
OPTIONS
|
|
-------
|
|
--command=<name>::
|
|
Look up layout mode using configuration variable column.<name> and
|
|
column.ui.
|
|
|
|
--mode=<mode>::
|
|
Specify layout mode. See configuration variable column.ui for option
|
|
syntax in linkgit:git-config[1].
|
|
|
|
--raw-mode=<n>::
|
|
Same as --mode but take mode encoded as a number. This is mainly used
|
|
by other commands that have already parsed layout mode.
|
|
|
|
--width=<width>::
|
|
Specify the terminal width. By default 'git column' will detect the
|
|
terminal width, or fall back to 80 if it is unable to do so.
|
|
|
|
--indent=<string>::
|
|
String to be printed at the beginning of each line.
|
|
|
|
--nl=<string>::
|
|
String to be printed at the end of each line,
|
|
including newline character.
|
|
|
|
--padding=<N>::
|
|
The number of spaces between columns. One space by default.
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
Format data by columns:
|
|
------------
|
|
$ 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
|
|
------------
|
|
|
|
Format data by rows:
|
|
------------
|
|
$ 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
|
|
------------
|
|
|
|
List some tags in a table with unequal column widths:
|
|
------------
|
|
$ 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
|
|
------------
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|