Fix providers documentation

Author: Daniel Carabas

REFERENCE.md

@@ -2378,7 +2378,7 @@ The following properties are available in the `postgresql_conn_validator` type.
 
 Valid values: present, absent
 
-The basic property that the resource should be in.
+Ensure connection validation
 
 Default value: present
 
@@ -2466,11 +2466,11 @@ An arbitrary tag for your own reference; the name of the message.
 
 ##### `unless`
 
-
+Optional SQL command to execute before the main command
 
 ##### `onlyif`
 
-
+Optional SQL command executed before the main command - return true if matching row found
 
 ##### `connect_settings`
 

lib/puppet/provider/postgresql_psql/ruby.rb

@@ -1,4 +1,5 @@
 Puppet::Type.type(:postgresql_psql).provide(:ruby) do
+  desc 'Postgres psql provider'
   def run_unless_sql_command(sql)
     # for the 'unless' queries, we wrap the user's query in a 'SELECT COUNT',
     # which makes it easier to parse and process the output.
@@ -63,5 +64,4 @@ def run_command(command, user, group, environment)
                                                       custom_environment: environment)
     [output, $CHILD_STATUS.dup]
   end
-
 end

lib/puppet/provider/postgresql_replication_slot/ruby.rb

@@ -1,5 +1,5 @@
 Puppet::Type.type(:postgresql_replication_slot).provide(:ruby) do
-  # For confinement
+  desc 'For confinement'
   commands psql: 'psql'
 
   def self.instances

lib/puppet/type/postgresql_conn_validator.rb

@@ -6,6 +6,7 @@
           purposes such as monitoring."
 
   ensurable do
+    desc 'Ensure connection validation'
     defaultvalues
     defaultto :present
   end

lib/puppet/type/postgresql_psql.rb

@@ -26,7 +26,9 @@ def sync
   end
 
   newparam(:unless) do
-    Desc 'An optional SQL command to execute prior to the main :command; ' \
+    desc 'Optional SQL command to execute before the main command'
+
+    desc 'An optional SQL command to execute prior to the main :command; ' \
          'this is generally intended to be used for idempotency, to check ' \
          'for the existence of an object in the database to determine whether ' \
          'or not the main SQL command needs to be executed at all.'
@@ -45,7 +47,9 @@ def matches(value)
   end
 
   newparam(:onlyif) do
-    Desc 'An optional SQL command to execute prior to the main :command; ' \
+    desc 'Optional SQL command executed before the main command - return true if matching row found'
+
+    desc 'An optional SQL command to execute prior to the main :command; ' \
          'this is generally intended to be used for idempotency, to check ' \
          'for the existence of an object in the database to determine whether ' \
          'or not the main SQL command needs to be executed at all.'