Fix crontab doc formatting

bin/ansible-doc

@@ -208,7 +208,9 @@ def main():
             else:
                 print_man(doc)
         else:
-            sys.stderr.write("ERROR: module %s missing documentation\n" % module)
+            # this typically means we couldn't even parse the docstring, not just that the YAML is busted,
+            # probably a quoting issue.
+            sys.stderr.write("ERROR: module %s missing documentation (or could not parse documentation)\n" % module)
 
 if __name__ == '__main__':
     main()

library/cron

@@ -25,7 +25,7 @@
 # describing the job so that it can be found later, which is required to be
 # present in order for this plugin to find/modify the job.
 
-DOCUMENTATION = '''
+DOCUMENTATION = """
 ---
 module: cron
 short_description: Manage crontab entries.
@@ -59,16 +59,13 @@ options:
   state:
     description:
       - Whether to ensure the job is present or absent.  
-      - If the cron_file setting is specified and the state is 'absent', if after the deletion
-        of the job the file is empty, the file is deleted
     required: false
     default: present
     aliases: []
   cron_file:
-    descrition:
+    description:
-      - The file with appropriate job is created in /etc/cron.d directory. Also, you can store
+      - If specified, uses this file in cron.d versus in the main crontab
-        multiple jobs in one file.         
+    required: false
-    required: fasle
     default:
     aliases: []
   backup:
@@ -124,12 +121,12 @@ examples:
      description: 'Ensure an old job is no longer present. Removes any job that is preceded by "#Ansible: an old job" in the crontab'
    - code: 'cron: name="a job for reboot" reboot=True job="/some/job.sh"'
      description: 'Creates an entry like "@reboot /some/job.sh"'
-   - code: 'cron: name="yum autoupdate" weekday="2" minute=0 hour=12 user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate" cron_file=ansible_yum-autoupdate
+   - code: 'cron: name="yum autoupdate" weekday="2" minute=0 hour=12 user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate" cron_file=ansible_yum-autoupdate'
 
 requirements: cron
 author: Dane Summers
 updates: Mike Grozak
-'''
+"""
 
 import re
 import tempfile