diff --git a/notification/mail.py b/notification/mail.py
index a1ec44087dd..10ef61ef2be 100644
--- a/notification/mail.py
+++ b/notification/mail.py
@@ -61,7 +61,7 @@ options:
     required: false
   subject:
     description:
-      - The subject of the email being sent.
+      - The subject of the email being sent. Alias: I(msg)
     aliases: [ msg ]
     required: true
   body:
@@ -115,7 +115,7 @@ options:
 
 EXAMPLES = '''
 # Example playbook sending mail to root
-- local_action: mail msg='System {{ ansible_hostname }} has been successfully provisioned.'
+- local_action: mail subject='System {{ ansible_hostname }} has been successfully provisioned.'
 
 # Sending an e-mail using Gmail SMTP servers
 - local_action: mail
@@ -125,7 +125,7 @@ EXAMPLES = '''
                 password='mysecret'
                 to="John Smith <john.smith@example.com>"
                 subject='Ansible-report'
-                msg='System {{ ansible_hostname }} has been successfully provisioned.'
+                body='System {{ ansible_hostname }} has been successfully provisioned.'
 
 # Send e-mail to a bunch of users, attaching files
 - local_action: mail