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>

1 files changed, 1 insertions, 25 deletions

diff --git a/eclass/db.eclass b/eclass/db.eclass
index 8e20c249476a..9a246d18979a 100644
--- a/eclass/db.eclass
+++ b/eclass/db.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: db.eclass
@@ -16,10 +16,6 @@ DEPEND="test? ( >=dev-lang/tcl-8.4 )"
 
 RDEPEND=""
 
-# @FUNCTION: db_fix_so
-# @DESCRIPTION:
-# Please document me
-
 db_fix_so() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && EROOT="${ROOT}"
 	LIB="${EROOT}/usr/$(get_libdir)"
@@ -73,10 +69,6 @@ db_fix_so() {
 	fi
 }
 
-# @FUNCTION: db_src_install_doc
-# @DESCRIPTION:
-# Please document me
-
 db_src_install_doc() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && ED="${D}"
 	# not everybody wants this wad of documentation as it is primarily API docs
@@ -91,10 +83,6 @@ db_src_install_doc() {
 	db_src_install_examples
 }
 
-# @FUNCTION: db_src_install_examples
-# @DESCRIPTION:
-# Please document me
-
 db_src_install_examples() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && ED="${D}"
 	if use examples ; then
@@ -114,10 +102,6 @@ db_src_install_examples() {
 	fi
 }
 
-# @FUNCTION: db_src_install_usrbinslot
-# @DESCRIPTION:
-# Please document me
-
 db_src_install_usrbinslot() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && ED="${D}"
 	# slot all program names to avoid overwriting
@@ -132,10 +116,6 @@ db_src_install_usrbinslot() {
 	done
 }
 
-# @FUNCTION: db_src_install_headerslot
-# @DESCRIPTION:
-# Please document me
-
 db_src_install_headerslot() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && ED="${D}"
 	# install all headers in a slotted location
@@ -143,10 +123,6 @@ db_src_install_headerslot() {
 	mv "${ED}"/usr/include/*.h "${ED}"/usr/include/db${SLOT}/ || die
 }
 
-# @FUNCTION: db_src_install_usrlibcleanup
-# @DESCRIPTION:
-# Please document me
-
 db_src_install_usrlibcleanup() {
 	has "${EAPI:-0}" 0 1 2 && ! use prefix && ED="${D}"
 	LIB="${ED}/usr/$(get_libdir)"