Module 'pgsql': add documentation

refs #6842

.vagrant-puppet/modules/pgsql/manifests/database/create.pp

@@ -1,3 +1,23 @@
+# Define: pgsql::database::create
+#
+#   Create a PgSQL database
+#
+# Parameters:
+#
+#   [*username*]   - name of the user the database belongs to
+#   [*password*]   - password of the user the database belongs to
+#
+# Requires:
+#
+#   pgsql
+#
+# Sample Usage:
+#
+# pgsql::database::create { 'icinga2':
+#   username   => 'icinga2',
+#   password   => 'icinga2',
+# }
+#
 define pgsql::database::create ($username, $password) {
   include pgsql
 

.vagrant-puppet/modules/pgsql/manifests/database/populate.pp

@@ -1,3 +1,25 @@
+# Define: pgsql::database::populate
+#
+#   Create and populate a PgSQL database
+#
+# Parameters:
+#
+#   [*username*]   - name of the user the database belongs to
+#   [*password*]   - password of the user the database belongs to
+#   [*schemafile*] - file with the schema for the database
+#
+# Requires:
+#
+#   pgsql::database::create
+#
+# Sample Usage:
+#
+# pgsql::database::populate { 'icinga2':
+#   username   => 'icinga2',
+#   password   => 'icinga2',
+#   schemafile => '/usr/share/icinga2-ido-pgsql/schema/pgsql.sql',
+# }
+#
 define pgsql::database::populate ($username, $password, $schemafile) {
   Exec { path => '/usr/bin' }