postgres{,-multi}.eclass: More Documentation Fixes

Fix a few keyword typos and adhere to the doc standard.

Bugs: 624502

eclass/postgres-multi.eclass

@@ -39,7 +39,7 @@ fi
 # POSTGRES_COMPAT.
 export _POSTGRES_INTERSECT_SLOTS=( )
 
-# @FUNCTION _postgres-multi_multibuild_wrapper
+# @FUNCTION: _postgres-multi_multibuild_wrapper
 # @INTERNAL
 # @USAGE: _postgres-multi_multibuild_wrapper <command> [<arg> ...]
 # @DESCRIPTION:
@@ -98,7 +98,6 @@ postgres-multi_forbest() {
 }
 
 # @FUNCTION: postgres-multi_pkg_setup
-# @REQUIRED
 # @USAGE: postgres-multi_pkg_setup
 # @DESCRIPTION:
 # Initialize internal environment variable(s). This is required if
@@ -119,7 +118,6 @@ postgres-multi_pkg_setup() {
 }
 
 # @FUNCTION: postgres-multi_src_prepare
-# @REQUIRED
 # @USAGE: postgres-multi_src_prepare
 # @DESCRIPTION:
 # Calls eapply_user then copies ${S} into a build directory for each

eclass/postgres.eclass

@@ -23,12 +23,14 @@ esac
 
 
 # @ECLASS-VARIABLE: POSTGRES_COMPAT
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # A Bash array containing a list of compatible PostgreSQL slots as
 # defined by the developer. If declared, must be declared before
 # inheriting this eclass. Example: POSTGRES_COMPAT=( 9.4 9.{5,6} )
 
 # @ECLASS-VARIABLE: POSTGRES_USEDEP
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Add the 2-Style and/or 4-Style use dependencies without brackets to be used
 # for POSTGRES_DEP. If declared, must be done before inheriting this eclass.
@@ -114,7 +116,6 @@ postgres_new_user() {
 }
 
 # @FUNCTION: postgres_pkg_setup
-# @REQUIRED
 # @USAGE: postgres_pkg_setup
 # @DESCRIPTION:
 # Initialize environment variable(s) according to the best