Change hiera_include to properly call include with an array of arguments

Before this change hiera includes which looked up an empty array
resulted in this error:

    ArgumentError: include(): Wrong number of arguments given (0 for minimum 1)

Now hiera includes properly allow for a lookup that results in an empty
array

This regression was caused by the arity checks committed in
9ed6fcea48591cda58db1379b58cd39dfbdca684
(#21091) pass --fail to curl

This causes curl to treat things like 404's as errors, causing a
fallback to open-uri and, eventually, a sensible error message.
clean up docs for new parser functions
Merge pull request #1695 from djmitche/future-parser-docs-fixes

clean up docs for new parser functions
Revert "Merge pull request #1682 from zaphod42/issue/master/incorrect-management-of-rundir"

This reverts commit a6e746d1a5df96f59ea0fdbe13345a5fcdacc7ff, reversing
changes made to 4cce551e419c57fb1306fa4b98a429f83aa2527a.

This appears to be causing inexplicable failures in some testing
machines. The errors manifest with the master being unable to write to
certain directories:

  Warning: Unable to fetch my node definition, but the agent run will continue:
  Warning: Error 400 on SERVER: cannot generate tempfile `/var/lib/puppet/yaml/node/solaris-11-32-2.delivery.puppetlabs.net.yaml20130606-4478-it4k80-9'
  Info: Retrieving plugin
  Error: /File[/var/lib/puppet/lib]: Could not evaluate: Could not retrieve information from environment production source(s) puppet://solaris-11-32-2/plugins
  Error: Could not retrieve catalog from remote server: Error 400 on SERVER: cannot generate tempfile `/var/lib/puppet/yaml/facts/solaris-11-32-2.delivery.puppetlabs.net.yaml20130606-4478-19pqoux-9'
  Warning: Not using cache on failed catalog
  Error: Could not retrieve catalog; skipping run
(20967) Clear yamldir in configuration acceptance test.

Because yamldir subdirectories are not managed outside of
indirectory/yaml, service user changes can leave puppet unable to read
from them (#21145)

This change clears the yamldir in the puppet_manages_own_configuration_in_robust_manner
acceptance test to ensure that yamldir and all subdirs are rebuilt with
the new service user.
Merge pull request #1693 from djmitche/bug21091

(#21091) pass --fail to curl
(20967) Do not run on solaris and reclear yamldir in teardown.

Cannot roundtrip users on Solaris because of #21148, so can't run the
puppet_manages_own_configuration_in_robust_manner on Solaris.

Also need to clear yamldir again in teardown since we are resetting
user/group id to original uid/gid and yaml's unmanaged subdirs will be
owned by a previous uid/gid.
Merge pull request #1697 from zaphod42/issue/master/20967-mysterious-errors-caused-by-patch

Revert "Merge pull request #1682 from zaphod42/issue/master/incorrect-management-of-rundir"
Revert "Merge pull request #1697 from zaphod42/issue/master/20967-mysterious-errors-caused-by-patch"

This reverts commit 1b27ae45c6866f9931ed6042a1c4db0a4c6aabd8, reversing
changes made to cb4881f8737ce1138057b2ec69e01a68ea7e2b65.

    Joshua Partlow: Wait, @finch, I think you just reverted something
    @AndrewParker and I are working on

Whoops.
Merge pull request #1665 from lollipopman/hiera_include_arity

commit 9ed6fcea48591cda58db1379b58cd39dfbdca684 which added arity checks
Merge pull request #1698 from jpartlow/issue/master/yaml-dir-blocking-puppet-rundir-fix

(20967) Clear yamldir in configuration acceptance test.