diff --git a/add_host b/add_host
index fe9780e9219..20d38252959 100644
--- a/add_host
+++ b/add_host
@@ -5,13 +5,14 @@ DOCUMENTATION = '''
 module: add_host
 short_description: add a host (and alternatively a group) to the ansible-playbook in-memory inventory
 description:
-  - Use variables to create new hosts and groups in inventory for use in later plays of the same playbook
+  - Use variables to create new hosts and groups in inventory for use in later plays of the same playbook. 
+    Takes variables so you can define the new hosts more fully.
 version_added: 0.9
 options:
   hostname:
     description:
     - The hostname/ip of the host to add to the inventory
-    required: true
+    required: true     
   groupname:
     description:
     - The groupname to add the hostname to.
@@ -20,4 +21,6 @@ author: Seth Vidal
 examples:
   - description: add host to group 'just_created'
     code: add_host hostname=${ip_from_ec2create} groupname=just_created
+  - description add a host with a non-standard port local to your machines
+    code: add_host hostname='${new_ip}:${new_port}' ansible_ssh_port='${new_port}' ansible_ssh_host='${new_ip}' groupname=cloud_hosts
 '''
\ No newline at end of file