swapon: mark --sumarry as deprecated

Signed-off-by: Karel Zak <kzak@redhat.com>
This commit is contained in:
Karel Zak 2014-06-30 11:03:12 +02:00
parent 7471244148
commit a6c6662d7c
4 changed files with 11 additions and 2 deletions

View 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: "swapon --summary" output format
why: does not provide control on output data formatting. The recommended solution
is to use --show=<columns> in all scripts.
what: "pid" as binary name for "kill --pid"
why: too ugly, too obscure

View File

@ -5,6 +5,9 @@ The command cytune(8) has been REMOVED from util-linux.
The non-libmount mount(8) implementation has been REMOVED from util-linux.
The "swapon --summary" output format is deprecated in favor of the
"swapon --show[=<columns>]" that provides better control on output formatting.
Release highlights
------------------

View File

@ -145,7 +145,8 @@ When priority is not defined it defaults to \-1.
.TP
.B "\-s, \-\-summary"
Display swap usage summary by device. Equivalent to "cat /proc/swaps".
Not available before Linux 2.1.25.
Not available before Linux 2.1.25. This output format is DEPRECATED in favour
of \fB\-\-show\fR that provides better control on output data.
.TP
\fB\-\-show\fR [\fIcolumn\fR, ...]
Display definable device table similar to

View File

@ -683,7 +683,7 @@ static void __attribute__ ((__noreturn__)) usage(FILE * out)
" -e, --ifexists silently skip devices that do not exist\n"
" -f, --fixpgsz reinitialize the swap space if necessary\n"
" -p, --priority <prio> specify the priority of the swap device\n"
" -s, --summary display summary about used swap devices\n"
" -s, --summary display summary about used swap devices (DEPRECATED)\n"
" --show[=<columns>] display summary in definable table\n"
" --noheadings don't print headings, use with --show\n"
" --raw use the raw output format, use with --show\n"