From 7d2a9960adcbe546808e90a9a193590cbf575ab3 Mon Sep 17 00:00:00 2001
From: Karel Zak
Date: Tue, 3 Oct 2017 15:35:17 +0200
Subject: rfkill: support old "list" output

.. just because we want to be replacement for the original version.

Signed-off-by: Karel Zak <kzak@redhat.com>
---
 sys-utils/rfkill.8 | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

(limited to 'sys-utils/rfkill.8')

diff --git a/sys-utils/rfkill.8 b/sys-utils/rfkill.8
index 0cb704070..cdaecfafe 100644
--- a/sys-utils/rfkill.8
+++ b/sys-utils/rfkill.8
@@ -4,17 +4,24 @@
 rfkill \- tool for enabling and disabling wireless devices
 .SH SYNOPSIS
 .B rfkill
-.RI [ options ] " command" " [" id | type \ ...]
+.RI [ options ]
+.RI [ command ]
+.RI [ id|type \ ...]
 
 .SH DESCRIPTION
 .B rfkill
 lists, enabling and disabling wireless devices.
 
+The command "list" output format is deprecated and maintained for backward
+compatibility only. The new output format is the default when no command is
+specified or when the option \fB\-\-output\fR is used.
+
 The default output is subject to change.  So whenever possible, you should
 avoid using default outputs in your scripts.  Always explicitly define expected
 columns by using the \fB\-\-output\fR option together with a columns list in
 environments where a stable output is required.
 
+
 .SH OPTIONS
 .TP
 \fB\-J\fR, \fB\-\-json\fR
@@ -44,9 +51,8 @@ Display help text and exit.
 Listen for rfkill events and display them on stdout.
 .TP
 \fBlist \fR[\fIid\fR|\fItype\fR ...]
-List the current state of all available devices.  The full list has TYPE and
-ID columns that one can use to limit the scope.  It is a good idea to check
-with
+List the current state of all available devices.  The command output format is deprecated, see the section DESCRIPTION.
+It is a good idea to check with
 .B list
 command
 .IR id " or " type
@@ -66,7 +72,7 @@ Enable the corresponding device.  If the device is hard\-blocked, for example
 via a hardware switch, it will remain unavailable though it is now
 soft\-unblocked.
 .SH EXAMPLES
-rfkill list
+rfkill --output ID,TYPE
 .br
 rfkill block all
 .br
@@ -87,6 +93,10 @@ The code has been later modifified by
 .MT kerolasa@\:iki.\:fi
 Sami Kerola
 .ME
+and
+.MT kzak@\:redhat.\:com
+Karel Zak
+.ME
 for util-linux project.
 .PP
 This manual page was written by
-- 
cgit v1.2.3-55-g7522