(PUP-2914) Add rgen 0.7.0 to vendored libraries

This commit adds the rgen 0.7.0 library by placing it in the vendor lib
that is needed for development on the new parser.
(PUP-2914) Remove rgen 0.7.0 dependency

The library rgen was an unnecessary dependency since it was
vendored. This commit removes unnecessary dependency.
(doc) Add Puppet Specific Documentation

Vendored libraries had no way for us to tell where they had come from or
what version the library was at.
This commit adds `PUPPET_README.md` files to each of our vendored
libraries to give us more information about where they came from.
(PUP-2745) Skip dependencies with malformed dependencies.

Prior to this commit if we encountered a dependent candidate module with a
malformed dependency, we would just ignore the malformed dependency.
This commit changes that behavior to ignore the entire dependent candidate as
an invalid module, this preventing the installation of a module with unknown
dependencies.
(PUP-1044) Ensure file bucket streams are closed at all times after use

This makes the stream() method on file bucket file take a block
to ensure that the processing of the stream always ends up closing it.
(PUP-2817) Fix zone properties so that nil is not passed through

Before this patch, when `insync?` was called on the zone properties ip,
dataset and inherit with value nil (happens the first time when the properties
are not present), `true` was returned, which resulted in them not being set
until the values were actually queried, which happened after the installation
of zone. Unfortunately, the inherit property can only be set before
installation.

This patch removes the spurious check for `nil`, which always returned `true`,
and instead handles it similar to when `:absent` is used.
Merge pull request #2999 from hlindberg/PUP-1044_ensure-closed-filebucket-file

(PUP-1044) Ensure file bucket streams are closed at all times after use
(PUP-406) Deprecate stringify_ facts option

The `stringify_facts` option is going to be removed in Puppet 4.0 and we
need to let users know about deprecated features.

This commit adds in a deprecation message in the stringify_facts
description.
(PUP-586) Deprecate Instrumentation System

The instrumentation system is being removed in Puppet 4.0.

This commit is for adding a deprecation message on the subcommands for
users to migrate off of it before it is finally deleted.
(maint) Fix up regex in indirector rest spec 404 tests

Seeing sporadic failures on 1.8.7 with these two tests, probably related
to order of parameter keys not being guaranteed.  This patch loosens the
regex on these two tests slightly so that it the keys can be in any
order.

With Britt Gresham <britt@puppetlabs.com>
Merge remote-tracking branch 'upstream/pr/2995'

* upstream/pr/2995:
  (doc) Add Puppet Specific Documentation
  (PUP-2914) Remove rgen 0.7.0 dependency
  (PUP-2914) Add rgen 0.7.0 to vendored libraries
Merge pull request #3000 from demophoon/deprecation/master/deprecate-stringify-fact-default

(PUP-406) Deprecate stringify_ facts option
Merge pull request #2998 from demophoon/deprecation/master/deprecate-instrumentation-system

(PUP-586) Deprecate Instrumentation System
Merge pull request #2973 from vrthra/fix/pup-2817/zones

(PUP-2817) Fix zone properties so that nil is not passed through
Merge pull request #2980 from highb/fix/master/pup-2745_skip_module

(PUP-2745) Skip dependencies with malformed dependencies.
PUP-2289 Fix host type newline validation

This commit fix the first bug reported on PUP-2289.
This is done by implementing validation of newlines
on ip, hostname, comments and host_aliases, making
sure we don't have any \n or \r.

Bellow is the problem description:

If the ip address or hostname or host_aliases
use double quoting and have \n, Puppet Will:

1 - Write the wrong entry on /etc/hosts with the linebreak.
This leads to a corrupted /etc/hosts, with some lines
that could not be parsed by the host resource provider
parsed.

This leads to second bug on the second puppet run,
where it will have error after failing to parse the file,
but wipes out the /etc/hosts file, writing only the information
on that file that is managed by puppet.

How to reproduce it:
1- backup /etc/hosts
cp /etc/hosts /etc/hosts.orig
2 - Create the script to reproduce the bug 01
cat <<EOF > /tmp/hostsbug.pp
host {'hostsbug': ip => "10.10.12.1\n" }
EOF
The same apply if you have newline on hostname, hostaliases or comment.
3 - Run the script the first time to reproduce bug 01.
puppet apply /tmp/hostsbug.pp
4 - Check /etc/hosts
cat /etc/hosts

Leonardo Rodrigues de Mello
PUP-2289 tests for bug on host type
Merge branch 'fix_pup-2289' of https://github.com/lmello/puppet into fix_pup-2289