Merge pull request #10212 from cchurch/vmware_inventory_improvements

VMware inventory script updates from Tower.

plugins/inventory/vmware.ini

-# Ansible vmware external inventory script settings
-#
+# Ansible VMware external inventory script settings
+
 [defaults]
+
+# If true (the default), return only guest VMs.  If false, also return host
+# systems in the results.
 guests_only = True
-#vm_group =
-#hw_group =
 
-[cache]
-max_age = 3600
-dir = ~/.cache/ansible
+# Specify an alternate group name for guest VMs.  If not defined, defaults to
+# the basename of the inventory script + "_vm", e.g. "vmware_vm".
+#vm_group = vm_group_name
+
+# Specify an alternate group name for host systems when guests_only=false.
+# If not defined, defaults to the basename of the inventory script + "_hw",
+# e.g. "vmware_hw".
+#hw_group = hw_group_name
+
+# Specify the number of seconds to use the inventory cache before it is
+# considered stale.  If not defined, defaults to 0 seconds.
+#cache_max_age = 3600
+
+# Specify the directory used for storing the inventory cache.  If not defined,
+# caching will be disabled.
+#cache_dir = ~/.cache/ansible
 
 [auth]
+
+# Specify hostname or IP address of vCenter/ESXi server.  A port may be
+# included with the hostname, e.g.: vcenter.example.com:8443.  This setting
+# may also be defined via the VMWARE_HOST environment variable.
 host = vcenter.example.com
+
+# Specify a username to access the vCenter host.  This setting may also be
+# defined with the VMWARE_USER environment variable.
 user = ihasaccess
+
+# Specify a password to access the vCenter host. This setting may also be
+# defined with the VMWARE_PASSWORD environment variable.
 password = ssshverysecret