From 83a6d908990af0b6f8fa9da6b577c359c32c2526 Mon Sep 17 00:00:00 2001
From: Ken Celenza <ken@celenza.org>
Date: Sun, 9 Apr 2017 12:00:54 -0400
Subject: [PATCH] Update Banner Doc (#23412)

I think most people's banner will come from an external file. Show an example, and clarify there is no extra lines allowed.
---
 lib/ansible/modules/network/ios/ios_banner.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/ansible/modules/network/ios/ios_banner.py b/lib/ansible/modules/network/ios/ios_banner.py
index 0aff433a00d..8ef40b07222 100644
--- a/lib/ansible/modules/network/ios/ios_banner.py
+++ b/lib/ansible/modules/network/ios/ios_banner.py
@@ -44,7 +44,7 @@ options:
     description:
       - The banner text that should be
         present in the remote device running configuration.  This argument
-        accepts a multiline string. Requires I(state=present).
+        accepts a multiline string, with no empty lines. Requires I(state=present).
     default: null
   state:
     description:
@@ -68,6 +68,13 @@ EXAMPLES = """
   ios_banner:
     banner: motd
     state: absent
+
+- name: Configure banner from file
+  ios_banner:
+    banner:  motd
+    text: "{{ lookup('file', './config_partial/raw_banner.cfg') }}"
+    state: present
+
 """
 
 RETURN = """