From 7f0da6d851372337cfb5d7920f7abe73450eaac9 Mon Sep 17 00:00:00 2001
From: David Shrewsbury <shrewsbury.dave@gmail.com>
Date: Tue, 9 Jun 2015 16:18:38 -0400
Subject: [PATCH] Update the docstring for os_security_group

Indicate that idempotence is on security group names, and give
an example for updating a security group description.
---
 .../modules/cloud/openstack/os_security_group.py      | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/ansible/modules/cloud/openstack/os_security_group.py b/lib/ansible/modules/cloud/openstack/os_security_group.py
index 55422ac20a3..bf316962a39 100644
--- a/lib/ansible/modules/cloud/openstack/os_security_group.py
+++ b/lib/ansible/modules/cloud/openstack/os_security_group.py
@@ -34,7 +34,8 @@ description:
 options:
    name:
      description:
-        - Name that has to be given to the security group
+        - Name that has to be given to the security group. This module
+          requires that security group names be unique.
      required: true
    description:
      description:
@@ -54,8 +55,16 @@ EXAMPLES = '''
 # Create a security group
 - os_security_group:
     cloud=mordred
+    state=present
     name=foo
     description=security group for foo servers
+
+# Update the existing 'foo' security group description
+- os_security_group:
+    cloud=mordred
+    state=present
+    name=foo
+    description=updated description for the foo security group
 '''