eclass: [QA] Revert multiple meaningless doc changes

Revert multiple meaningless eclass documentation changes, notably adding
a lot of placeholders and documenting implementation details.  These
changes were aimed at silencing (valid) documentation warnings without
actually providing valuable documentation to the end users.  While some
of these changes were beneficial, it would take a lot of effort to
review them all and the author is unwilling to fix his mistakes.

Signed-off-by: Michał Górny <mgorny@gentoo.org>

56 files changed, 71 insertions, 558 deletions

diff --git a/eclass/acct-group.eclass b/eclass/acct-group.eclass
index 18a40d7ad6f5..1d5d14290dad 100644
--- a/eclass/acct-group.eclass
+++ b/eclass/acct-group.eclass
@@ -31,11 +31,6 @@
 # - RDEPEND if it is needed at install time (e.g. you 'fowners' files
 #   in pkg_preinst) or run time.
 
-# @VARIABLE: _ACCT_GROUP_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# If null set to 1
-
 if [[ -z ${_ACCT_GROUP_ECLASS} ]]; then
 _ACCT_GROUP_ECLASS=1
 
diff --git a/eclass/acct-user.eclass b/eclass/acct-user.eclass
index af5a4a923354..22b0038fbff7 100644
--- a/eclass/acct-user.eclass
+++ b/eclass/acct-user.eclass
@@ -39,11 +39,6 @@
 # - RDEPEND if it is needed at install time (e.g. you 'fowners' files
 #   in pkg_preinst) or run time.
 
-# @VARIABLE: _ACCT_USER_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# If null set to 1
-
 if [[ -z ${_ACCT_USER_ECLASS} ]]; then
 _ACCT_USER_ECLASS=1
 
diff --git a/eclass/alternatives.eclass b/eclass/alternatives.eclass
index 108a55af8112..79f14d81b134 100644
--- a/eclass/alternatives.eclass
+++ b/eclass/alternatives.eclass
@@ -2,8 +2,6 @@
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: alternatives.eclass
-# @MAINTAINER:
-# maintainer-needed@gentoo.org
 # @AUTHOR:
 # Original author: Alastair Tse <liquidx@gentoo.org> (03 Oct 2003)
 # @BLURB: Creates symlink to the latest version of multiple slotted packages.
@@ -74,17 +72,14 @@ alternatives_auto_makesym() {
 	alternatives_makesym ${SYMLINK} ${ALT}
 }
 
-# @FUNCTION: alternatives_makesym
-# @USAGE: alternatives_makesym <resulting symlink> [alternative targets..]
-# @DESCRIPTION:
-# make sure it is in the prefix, allow it already to be in the prefix
-
 alternatives_makesym() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX=
 	local ALTERNATIVES=""
 	local SYMLINK=""
 	local alt pref
 
+	# usage: alternatives_makesym <resulting symlink> [alternative targets..]
+	# make sure it is in the prefix, allow it already to be in the prefix
 	SYMLINK=${EPREFIX}/${1#${EPREFIX}}
 	# this trick removes the trailing / from ${ROOT}
 	pref=${ROOT%/}
@@ -129,7 +124,6 @@ alternatives_makesym() {
 # @FUNCTION: alernatives-pkg_postinst
 # @DESCRIPTION:
 # The alternatives pkg_postinst, this function will be exported
-
 alternatives_pkg_postinst() {
 	if [ -n "${ALTERNATIVES}" -a -n "${SOURCE}" ]; then
 		alternatives_makesym ${SOURCE} ${ALTERNATIVES}
@@ -139,7 +133,6 @@ alternatives_pkg_postinst() {
 # @FUNCTION: alternatives_pkg_postrm
 # @DESCRIPTION:
 # The alternatives pkg_postrm, this function will be exported
-
 alternatives_pkg_postrm() {
 	if [ -n "${ALTERNATIVES}" -a -n "${SOURCE}" ]; then
 		alternatives_makesym ${SOURCE} ${ALTERNATIVES}
diff --git a/eclass/ant-tasks.eclass b/eclass/ant-tasks.eclass
index a96222f8ff50..42f801a84d70 100644
--- a/eclass/ant-tasks.eclass
+++ b/eclass/ant-tasks.eclass
@@ -1,4 +1,4 @@
-# Copyright 2007-2019 Gentoo Authors
+# Copyright 2007-2020 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: ant-tasks.eclass
@@ -66,7 +66,6 @@ ANT_TASK_DEPNAME=${ANT_TASK_DEPNAME-${ANT_TASK_NAME}}
 
 # @VARIABLE: ANT_TASK_PV
 # @INTERNAL
-# @DESCRIPTION:
 # Version of ant-core this task is intended to register and thus load with.
 ANT_TASK_PV="${PV}"
 
diff --git a/eclass/apache-2.eclass b/eclass/apache-2.eclass
index ded2b6696aa7..ccfe482f528e 100644
--- a/eclass/apache-2.eclass
+++ b/eclass/apache-2.eclass
@@ -1,4 +1,4 @@
-# Copyright 1999-2019 Gentoo Authors
+# Copyright 1999-2020 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: apache-2.eclass
@@ -87,12 +87,7 @@ SRC_URI="mirror://apache/httpd/httpd-${PV}.tar.bz2
 # This variable needs to be set in the ebuild and contains a list of available
 # built-in modules
 
-# @VARIABLE: IUSE_MPMS
-# @DESCRIPTION:
-# Combine IUSE_MPMS_FORK and IUSE_MPMS_THREAD
-
 IUSE_MPMS="${IUSE_MPMS_FORK} ${IUSE_MPMS_THREAD}"
-
 IUSE="${IUSE} debug doc gdbm ldap libressl selinux ssl static suexec threads"
 
 for module in ${IUSE_MODULES} ; do
diff --git a/eclass/apache-module.eclass b/eclass/apache-module.eclass
index 05372bcd426e..e192a7454277 100644
--- a/eclass/apache-module.eclass
+++ b/eclass/apache-module.eclass
@@ -95,11 +95,7 @@ inherit depend.apache
 # INTERNAL FUNCTIONS
 # ==============================================================================
 
-# @FUNCTION: apache_cd_dir
-# @INTERNAL
-# @DESCRIPTION:
 # Internal function to construct the default ${APXS2_S} path if required.
-
 apache_cd_dir() {
 	debug-print-function $FUNCNAME $*
 
@@ -117,11 +113,7 @@ apache_cd_dir() {
 	echo "${CD_DIR}"
 }
 
-# @FUNCTION: apache_mod_file
-# @INTERNAL
-# @DESCRIPTION:
 # Internal function to construct the default ${APACHE2_MOD_FILE} if required.
-
 apache_mod_file() {
 	debug-print-function $FUNCNAME $*
 
@@ -131,13 +123,9 @@ apache_mod_file() {
 	echo "${MOD_FILE}"
 }
 
-# @FUNCTION: apache_doc_magic
-# @INTERNAL
-# @DESCRIPTION:
 # Internal function for picking out html files from ${DOCFILES}. It takes an
 # optional first argument `html'; if the first argument is equals `html', only
 # html files are returned, otherwise normal (non-html) docs are returned.
-
 apache_doc_magic() {
 	debug-print-function $FUNCNAME $*
 
diff --git a/eclass/aspell-dict-r1.eclass b/eclass/aspell-dict-r1.eclass
index 14e2b0b6344c..b07af61fdf1e 100644
--- a/eclass/aspell-dict-r1.eclass
+++ b/eclass/aspell-dict-r1.eclass
@@ -42,11 +42,6 @@ esac
 
 EXPORT_FUNCTIONS src_configure src_install
 
-# @VARIABLE: _ASPELL_DICT_R1
-# @INTERNAL
-# @DESCRIPTION:
-# Please document me
-
 if [[ ! ${_ASPELL_DICT_R1} ]]; then
 
 # aspell packages have an idiosyncratic versioning scheme, that is
diff --git a/eclass/autotools-utils.eclass b/eclass/autotools-utils.eclass
index 13d2f653a972..3fcaa79f80ab 100644
--- a/eclass/autotools-utils.eclass
+++ b/eclass/autotools-utils.eclass
@@ -113,11 +113,6 @@ esac
 # Note that dependencies are added for autoconf, automake and libtool only.
 # If your package needs one of the external tools listed above, you need to add
 # appropriate packages to DEPEND yourself.
-
-# @VARIABLE: AUTOTOOLS_AUTO_DEPEND
-# @DESCRIPTION:
-# Please document me
-
 [[ ${AUTOTOOLS_AUTORECONF} ]] || : ${AUTOTOOLS_AUTO_DEPEND:=no}
 
 # eutils for eqawarn, path_exists
@@ -197,12 +192,6 @@ EXPORT_FUNCTIONS src_prepare src_configure src_compile src_install src_test
 # cases only.
 
 # Determine using IN or OUT source build
-
-# @FUNCTION: _check_build_dir
-# @INTERNAL
-# @DESCRIPTION:
-# Please document me
-
 _check_build_dir() {
 	: ${ECONF_SOURCE:=${S}}
 	# Respect both the old variable and the new one, depending
diff --git a/eclass/autotools.eclass b/eclass/autotools.eclass
index 12c8e899d19f..d7ce23bfdf35 100644
--- a/eclass/autotools.eclass
+++ b/eclass/autotools.eclass
@@ -23,11 +23,6 @@ if [[ ${__AUTOTOOLS_AUTO_DEPEND+set} == "set" ]] ; then
 	fi
 fi
 
-# @ECLASS-VARIABLE: _AUTOTOOLS_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# Please document
-
 if [[ -z ${_AUTOTOOLS_ECLASS} ]]; then
 _AUTOTOOLS_ECLASS=1
 
@@ -104,11 +99,6 @@ if [[ -n ${WANT_AUTOCONF} ]] ; then
 	export WANT_AUTOCONF
 fi
 
-# @ECLASS-VARIABLE: _libtool_atom
-# @INTERNAL
-# @DESCRIPTION:
-# Set libtool ${P}
-
 _libtool_atom=">=sys-devel/libtool-2.4"
 if [[ -n ${WANT_LIBTOOL} ]] ; then
 	case ${WANT_LIBTOOL} in
@@ -119,10 +109,6 @@ if [[ -n ${WANT_LIBTOOL} ]] ; then
 	export WANT_LIBTOOL
 fi
 
-# @ECLASS-VARIABLE: AUTOTOOLS_DEPEND
-# @DESCRIPTION:
-# Set DEPEND
-
 AUTOTOOLS_DEPEND="${_automake_atom}
 	${_autoconf_atom}
 	${_libtool_atom}"
@@ -133,7 +119,6 @@ RDEPEND=""
 # Set to 'no' to disable automatically adding to DEPEND.  This lets
 # ebuilds form conditional depends by using ${AUTOTOOLS_DEPEND} in
 # their own DEPEND string.
-
 : ${AUTOTOOLS_AUTO_DEPEND:=yes}
 if [[ ${AUTOTOOLS_AUTO_DEPEND} != "no" ]] ; then
 	case ${EAPI:-0} in
@@ -141,12 +126,6 @@ if [[ ${AUTOTOOLS_AUTO_DEPEND} != "no" ]] ; then
 		7) BDEPEND=${AUTOTOOLS_DEPEND} ;;
 	esac
 fi
-
-# @ECLASS-VARIABLE: __AUTOTOOLS_AUTO_DEPEND
-# @INTERNAL
-# @DESCRIPTION:
-# Set internal variable
-
 __AUTOTOOLS_AUTO_DEPEND=${AUTOTOOLS_AUTO_DEPEND} # See top of eclass
 
 unset _automake_atom _autoconf_atom
@@ -272,7 +251,6 @@ eautoreconf() {
 # @FUNCTION: _at_uses_pkg
 # @USAGE: <macros>
 # @INTERNAL
-# @DESCRIPTION:
 # See if the specified macros are enabled.
 _at_uses_pkg() {
 	if [[ -n $(autotools_check_macro "$@") ]] ; then
@@ -287,68 +265,14 @@ _at_uses_pkg() {
 		egrep -q "${args[@]}" configure.??
 	fi
 }
-
-# @FUNCTION: _at_uses_autoheader
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_autoheader()  { _at_uses_pkg A{C,M}_CONFIG_HEADER{S,}; }
-
-# @FUNCTION: _at_uses_automake
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_automake()    { _at_uses_pkg AM_INIT_AUTOMAKE; }
-
-# @FUNCTION: _at_uses_gettext
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_gettext()     { _at_uses_pkg AM_GNU_GETTEXT_{,REQUIRE_}VERSION; }
-
-# @FUNCTION: _at_uses_glibgettext
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_glibgettext() { _at_uses_pkg AM_GLIB_GNU_GETTEXT; }
-
-# @FUNCTION: _at_uses_intltool
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_intltool()    { _at_uses_pkg {AC,IT}_PROG_INTLTOOL; }
-
-# @FUNCTION: _at_uses_gtkdoc
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_gtkdoc()      { _at_uses_pkg GTK_DOC_CHECK; }
-
-# @FUNCTION: _at_uses_gnomedoc
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_gnomedoc()    { _at_uses_pkg GNOME_DOC_INIT; }
-
-# @FUNCTION: _at_uses_libtool
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_libtool()     { _at_uses_pkg A{C,M}_PROG_LIBTOOL LT_INIT; }
-
-# @FUNCTION: _at_uses_libltdl
-# @INTERNAL
-# @DESCRIPTION:
-# Call another function
-
 _at_uses_libltdl()     { _at_uses_pkg LT_CONFIG_LTDL_DIR; }
 
 # @FUNCTION: eaclocal_amflags
@@ -367,10 +291,10 @@ eaclocal_amflags() {
 		autotools_env_setup
 		aclocal_opts=$(sed -n \
 			"/^ACLOCAL_AMFLAGS[[:space:]]*=/{ \
-			# match the first line
-			s:[^=]*=::p; \
-			# then gobble up all escaped lines
-			: nextline /\\\\$/{ n; p; b nextline; } \
+			  # match the first line
+			  s:[^=]*=::p; \
+			  # then gobble up all escaped lines
+			  : nextline /\\\\$/{ n; p; b nextline; } \
 			}" ${amflags_file})
 		eval aclocal_opts=\""${aclocal_opts}"\"
 		break
@@ -626,11 +550,10 @@ autotools_run_tool() {
 	fi
 }
 
-# @ECLASS-VARIABLE: ALL_AUTOTOOLS_MACROS
-# @DESCRIPTION:
+# Internal function to check for support
+
 # Keep a list of all the macros we might use so that we only
 # have to run the trace code once.  Order doesn't matter.
-
 ALL_AUTOTOOLS_MACROS=(
 	A{C,M}_PROG_LIBTOOL LT_INIT LT_CONFIG_LTDL_DIR
 	A{C,M}_CONFIG_HEADER{S,}
@@ -643,11 +566,6 @@ ALL_AUTOTOOLS_MACROS=(
 	GTK_DOC_CHECK
 	GNOME_DOC_INIT
 )
-
-# @FUNCTION: autotools_check_macro
-# @DESCRIPTION:
-# Check the macros
-
 autotools_check_macro() {
 	[[ -f configure.ac || -f configure.in ]] || return 0
 
@@ -673,7 +591,6 @@ autotools_check_macro() {
 # @INTERNAL
 # @DESCRIPTION:
 # Look for a macro and extract its value.
-
 autotools_check_macro_val() {
 	local macro scan_out
 
@@ -689,11 +606,6 @@ autotools_check_macro_val() {
 	return 0
 }
 
-# @FUNCTION: _autotools_m4dir_include
-# @INTERNAL
-# @DESCRIPTION:
-# m4dir include stuff
-
 _autotools_m4dir_include() {
 	local x include_opts flag
 
@@ -715,17 +627,7 @@ _autotools_m4dir_include() {
 
 	echo ${include_opts}
 }
-
-# @FUNCTION: autotools_m4dir_include
-# @DESCRIPTION:
-# Call another function
-
 autotools_m4dir_include()    { _autotools_m4dir_include ${AT_M4DIR} ; }
-
-# @FUNCTION: autotools_m4sysdir_include
-# @DESCRIPTION:
-# m4sysdir include stuff
-
 autotools_m4sysdir_include() {
 	# First try to use the paths the system integrator has set up.
 	local paths=( $(eval echo ${AT_SYS_M4DIR}) )
diff --git a/eclass/base.eclass b/eclass/base.eclass
index 4682890b3dc3..0f9a2e576b78 100644
--- a/eclass/base.eclass
+++ b/eclass/base.eclass
@@ -28,22 +28,12 @@
 # @DESCRIPTION:
 # The base eclass defines some default functions and variables.
 
-# @VARIABLE: _BASE_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# If null set to 1
-
 if [[ -z ${_BASE_ECLASS} ]]; then
 _BASE_ECLASS=1
 
 inherit eutils
 
-# @VARIABLE: BASE_EXPF
-# @DESCRIPTION:
-# Please document me
-
 BASE_EXPF="src_unpack src_compile src_install"
-
 case "${EAPI:-0}" in
 	0|1) ;;
 	2|3|4|5) BASE_EXPF+=" src_prepare src_configure" ;;
diff --git a/eclass/bash-completion-r1.eclass b/eclass/bash-completion-r1.eclass
index b5c7d2854f75..70d40a25969e 100644
--- a/eclass/bash-completion-r1.eclass
+++ b/eclass/bash-completion-r1.eclass
@@ -1,4 +1,4 @@
-# Copyright 1999-2019 Gentoo Authors
+# Copyright 1999-2020 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: bash-completion-r1.eclass
@@ -61,11 +61,10 @@ _bash-completion-r1_get_bashcompdir() {
 	_bash-completion-r1_get_bashdir completionsdir /usr/share/bash-completion/completions
 }
 
-# @FUNCTION: _bash-completion-r1_get_bashhelpersdir
+# @FUNCTION: _bash-completion-r1_get_helpersdir
 # @INTERNAL
 # @DESCRIPTION:
 # Get unprefixed bash-completion helpers directory.
-
 _bash-completion-r1_get_bashhelpersdir() {
 	debug-print-function ${FUNCNAME} "${@}"
 
diff --git a/eclass/bazel.eclass b/eclass/bazel.eclass
index 493e2d4593d6..854b740db4f2 100644
--- a/eclass/bazel.eclass
+++ b/eclass/bazel.eclass
@@ -24,11 +24,6 @@ case "${EAPI:-0}" in
 		;;
 esac
 
-# @VARIABLE: _BAZEL_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# Please document me
-
 if [[ ! ${_BAZEL_ECLASS} ]]; then
 
 inherit multiprocessing toolchain-funcs
diff --git a/eclass/cargo.eclass b/eclass/cargo.eclass
index d1e968b4e9ce..7f7a681f6f52 100644
--- a/eclass/cargo.eclass
+++ b/eclass/cargo.eclass
@@ -9,18 +9,10 @@
 # @SUPPORTED_EAPIS: 6 7
 # @BLURB: common functions and variables for cargo builds
 
-# @VARIABLE: _CARGO_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# If null set to 1
-
 if [[ -z ${_CARGO_ECLASS} ]]; then
 _CARGO_ECLASS=1
 
-# @VARIABLE: RUST_DEPEND
-# @DESCRIPTION:
 # we need this for 'cargo vendor' subcommand and net.offline config knob
-
 RUST_DEPEND=">=virtual/rust-1.37.0"
 
 case "${EAPI:-0}" in
@@ -43,16 +35,7 @@ fi
 
 IUSE="${IUSE} debug"
 
-# @VARIABLE: ECARGO_HOME
-# @DESCRIPTION:
-# Adjust the working directory
-
 ECARGO_HOME="${WORKDIR}/cargo_home"
-
-# @VARIABLE: ECARGO_VENDOR
-# @DESCRIPTION:
-# Vendorize the working directory
-
 ECARGO_VENDOR="${ECARGO_HOME}/gentoo"
 
 # @ECLASS-VARIABLE: CARGO_OPTIONAL
diff --git a/eclass/cdrom.eclass b/eclass/cdrom.eclass
index 4481eaa1dd9b..4bbe6aa31759 100644
--- a/eclass/cdrom.eclass
+++ b/eclass/cdrom.eclass
@@ -14,11 +14,6 @@
 # eclass will require RESTRICT="bindist" but the point still stands.
 # The functions are generally called in src_unpack.
 
-# @VARIABLE: _CDROM_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# If null set to 1
-
 if [[ -z ${_CDROM_ECLASS} ]]; then
 _CDROM_ECLASS=1
 
diff --git a/eclass/check-reqs.eclass b/eclass/check-reqs.eclass
index e512c1bb23a0..a45cbd15fee7 100644
--- a/eclass/check-reqs.eclass
+++ b/eclass/check-reqs.eclass
@@ -38,11 +38,6 @@
 # These checks should probably mostly work on non-Linux, and they should
 # probably degrade gracefully if they don't. Probably.
 
-# @VARIABLE: _CHECK_REQS_ECLASS_
-# @INTERNAL
-# @DESCRIPTION:
-# Please document me
-
 if [[ ! ${_CHECK_REQS_ECLASS_} ]]; then
 
 # @ECLASS-VARIABLE: CHECKREQS_MEMORY
@@ -72,8 +67,6 @@ esac
 
 EXPORT_FUNCTIONS pkg_pretend pkg_setup
 
-# @FUNCTION: check_reqs
-# @DESCRIPTION:
 # Obsolete function executing all the checks and printing out results
 check_reqs() {
 	eerror "Package calling old ${FUNCNAME} function."
@@ -357,8 +350,8 @@ check-reqs_unsatisfied() {
 	${msg} "There is NOT at least ${sizeunit} ${location}"
 
 	# @ECLASS-VARIABLE: CHECKREQS_FAILED
-	# @INTERNAL
 	# @DESCRIPTION:
+	# @INTERNAL
 	# If set the checks failed and eclass should abort the build.
 	# Internal, do not set yourself.
 	CHECKREQS_FAILED="true"
diff --git a/eclass/chromium-2.eclass b/eclass/chromium-2.eclass
index d8225f983e2f..b3d63f302d05 100644
--- a/eclass/chromium-2.eclass
+++ b/eclass/chromium-2.eclass
@@ -43,11 +43,6 @@ chromium_suid_sandbox_check_kernel_config() {
 # @DESCRIPTION:
 # List of language packs available for this package.
 
-# @FUNCTION: _chromium_set_l10n_IUSE
-# @INTERNAL
-# @DESCRIPTION:
-# Please document me
-
 _chromium_set_l10n_IUSE() {
 	[[ ${EAPI:-0} == 0 ]] && die "EAPI=${EAPI} is not supported"
 
@@ -105,10 +100,6 @@ chromium_remove_language_paks() {
 	done
 }
 
-# @FUNCTION: chromium_pkg_die
-# @DESCRIPTION:
-# Various reasons to die
-
 chromium_pkg_die() {
 	if [[ "${EBUILD_PHASE}" != "compile" ]]; then
 		return
diff --git a/eclass/cmake.eclass b/eclass/cmake.eclass
index 384556fd7d14..62fa02715700 100644
--- a/eclass/cmake.eclass
+++ b/eclass/cmake.eclass
@@ -17,11 +17,6 @@
 # out-of-source builds (default), in-source builds and an implementation of the
 # well-known use_enable function for CMake.
 
-# @VARIABLE: _CMAKE_ECLASS
-# @INTERNAL
-# @DESCRIPTION:
-# If null set to 1
-
 if [[ -z ${_CMAKE_ECLASS} ]]; then
 _CMAKE_ECLASS=1
 
@@ -140,10 +135,7 @@ _cmake_banned_func() {
 	die "${FUNCNAME[1]} is banned. use -D$1<related_CMake_variable>=\"\$(usex $2)\" instead"
 }
 
-# @FUNCTION: _cmake_check_build_dir
-# @DESCRIPTION:
 # Determine using IN or OUT source build
-
 _cmake_check_build_dir() {
 	: ${CMAKE_USE_DIR:=${S}}
 	if [[ -n ${CMAKE_IN_SOURCE_BUILD} ]]; then
@@ -276,12 +268,8 @@ cmake-utils_use() { _cmake_banned_func "" "$@" ; }
 # Banned. Use -DNOFOO=$(usex !foo) instead.
 cmake-utils_useno() { _cmake_banned_func "" "$@" ; }
 
-# @FUNCTION: _cmake_modify-cmakelists
-# @INTERNAL
-# @DESCRIPTION:
 # Internal function for modifying hardcoded definitions.
 # Removes dangerous definitions that override Gentoo settings.
-
 _cmake_modify-cmakelists() {
 	debug-print-function ${FUNCNAME} "$@"
 
diff --git a/eclass/cuda.eclass b/eclass/cuda.eclass
index cfc42a859495..b1da77c69dda 100644
--- a/eclass/cuda.eclass
+++ b/eclass/cuda.ec