From a6a330581cf8726fd929a92a12ee64ad0051071e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ji=C5=99=C3=AD=20Klime=C5=A1?= <jklimes@redhat.com>
Date: Mon, 29 Apr 2013 10:19:47 +0200
Subject: [PATCH] man: update nmcli man page description for 'connection down'

---
 man/nmcli.1.in | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/man/nmcli.1.in b/man/nmcli.1.in
index f969ff7812..4f005ef297 100644
--- a/man/nmcli.1.in
+++ b/man/nmcli.1.in
@@ -358,7 +358,17 @@ arguments: according to arguments
 .TP
 .B down [ id | uuid | path | apath ] <ID>
 .br
-Deactivate a connection.
+Deactivate a connection from a device without preventing the device from
+further auto-activation.
+.sp
+Be aware that this command only deactivates the specified connection, but
+doesn't prevent the device, the connection was on, from performing
+auto-activation. Thus, if the connection that was downed (or another
+compatible connection) has autoconnect flag set, it will be automatically
+started on the idling device again.
+.br
+In most cases you may want to use \fIdevice disconnect\fP command instead.
+.sp
 The connection is identified by its name, UUID or D-Bus path.
 If <ID> is ambiguous, a keyword \fIid\fP, \fIuuid\fP, \fIpath\fP or
 \fIapath\fP can be used.