From 18d3a03fda242d42cc2cc64fe3d59f3c8dac540b Mon Sep 17 00:00:00 2001
From: Karel Zak
Date: Tue, 3 Oct 2017 13:44:19 +0200
Subject: rfkill: refactor actions

* convert action string to ID and use switch()
* add note about default output to the man page

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

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

diff --git a/sys-utils/rfkill.8 b/sys-utils/rfkill.8
index ce0aadc31..0cb704070 100644
--- a/sys-utils/rfkill.8
+++ b/sys-utils/rfkill.8
@@ -5,6 +5,16 @@ rfkill \- tool for enabling and disabling wireless devices
 .SH SYNOPSIS
 .B rfkill
 .RI [ options ] " command" " [" id | type \ ...]
+
+.SH DESCRIPTION
+.B rfkill
+lists, enabling and disabling wireless devices.
+
+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
-- 
cgit v1.2.3-55-g7522