generated files need puppet "warning" in comment header

[hairmare]

All generated files should contain the following comment on their first line.

# this file is managed by the syslogng puppet module

Spec MUST be implemented for all file resources in /etc/syslog-ng.

It SHOULD be implemented along the lines of

file { 'file.conf':
  contents => [
    '# this file is managed by the syslogng puppet module',
    template('file.erb'),
  ],
}

It MAY make the message configurable as a param. Doing so it MUST add spec for a default and the configured value. The param SHOULD be on the main syslogng class and only on that.

[hairmare]

This was also intended to help admins that are new to puppet. In the light of this I'm considering to change the purging config to true as default for the 1.0.0 release. I'll have to get input on this from my syslog crack as well as sleep over this some.