]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
column: rename --columns to --output-width
authorKarel Zak <kzak@redhat.com>
Tue, 17 Jan 2017 12:11:27 +0000 (13:11 +0100)
committerKarel Zak <kzak@redhat.com>
Tue, 17 Jan 2017 12:14:05 +0000 (13:14 +0100)
* rename to use less confusing option name
* cleanup usage()
* update man page

Addresses: https://github.com/karelzak/util-linux/pull/327
Signed-off-by: Karel Zak <kzak@redhat.com>
Documentation/deprecated.txt
text-utils/column.1
text-utils/column.c

index 39dc335a06ec7f9e641bf41fac923de0b9bbd17e..fba47e0b5859f1d3cf29ada0b767f085e2c224ea 100644 (file)
@@ -2,6 +2,11 @@ The following is a list of commands or features that are deprecated.  All
 deprecated utils are in maintenance mode and we keep them in source tree for
 backward compatibility only.
 
+what:  column --columns
+why:   renamed to --output-width
+since: v2.30
+
+--------------------------
 
 what:  tailf
 why:   "tail -f" is better nowadays, tailf has unfixed bugs
index 524678224bbfd0a8b99bd7fa57ff13c9ba3d5cc2..5c6f36add64c7510e25c7196aec1a75e06bf2c29 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)column.1   8.1 (Berkeley) 6/6/93
 .\"
-.TH COLUMN 1 "July 2014" "util-linux" "User Commands"
+.TH COLUMN 1 "January 2017" "util-linux" "User Commands"
 .SH NAME
 column \- columnate lists
 .SH SYNOPSIS
@@ -45,8 +45,9 @@ are filled before columns.  Input is taken from \fIfile\fR, or
 otherwise from standard input.  Empty lines are ignored.
 .PP
 .SH OPTIONS
-.IP "\fB\-c, \-\-columns\fP \fIwidth\fP"
-Output is formatted to a width specified as number of characters.
+.IP "\fB\-c, \-\-output\-width\fP \fIwidth\fP"
+Output is formatted to a width specified as number of characters. The original
+name of this option is --columns; this name deprecated since v2.30.
 .IP "\fB\-o, \-\-output\-separator\fP \fIstring\fP"
 Specify the columns delimiter for table output (default is two spaces).
 .IP "\fB\-s, \-\-separator\fP \fIseparators\fP"
index a642d84327e735d1ad469563a93f9de47dcfe65c..43b3af5f5aeb2b9396ef461243a180586105647f 100644 (file)
@@ -120,12 +120,12 @@ static void __attribute__((__noreturn__)) usage(int rc)
        fputs(_("Columnate lists.\n"), out);
 
        fputs(USAGE_OPTIONS, out);
-       fputs(_(" -c, --columns <width>    width of output in number of characters\n"), out);
-       fputs(_(" -t, --table              create a table\n"), out);
-       fputs(_(" -s, --separator <string> possible table delimiters\n"), out);
-       fputs(_(" -o, --output-separator <string>\n"
-               "                          columns separator for table output; default is two spaces\n"), out);
-       fputs(_(" -x, --fillrows           fill rows before columns\n"), out);
+       fputs(_(" -t, --table                      create a table\n"), out);
+       fputs(_(" -s, --separator <string>         possible table delimiters\n"), out);
+       fputs(_(" -o, --output-separator <string>  columns separator for table output\n"
+               "                                    (default is two spaces)\n"), out);
+       fputs(_(" -c, --output-width <width>       width of output in number of characters\n"), out);
+       fputs(_(" -x, --fillrows                   fill rows before columns\n"), out);
        fputs(USAGE_SEPARATOR, out);
        fputs(USAGE_HELP, out);
        fputs(USAGE_VERSION, out);
@@ -152,13 +152,14 @@ int main(int argc, char **argv)
 
        static const struct option longopts[] =
        {
+               { "columns",    1, 0, 'c' },    /* deprecated */
+               { "fillrows",   0, 0, 'x' },
                { "help",       0, 0, 'h' },
-               { "version",    0, 0, 'V' },
-               { "columns",    1, 0, 'c' },
-               { "table",      0, 0, 't' },
-               { "separator",  1, 0, 's' },
                { "output-separator", 1, 0, 'o' },
-               { "fillrows",   0, 0, 'x' },
+               { "output-width", 1, 0, 'c' },
+               { "separator",  1, 0, 's' },
+               { "table",      0, 0, 't' },
+               { "version",    0, 0, 'V' },
                { NULL,         0, 0, 0 },
        };