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, 11 insertions, 14 deletions

diff --git a/eclass/font-ebdftopcf.eclass b/eclass/font-ebdftopcf.eclass
index 9e00eec467f2..29568e560134 100644
--- a/eclass/font-ebdftopcf.eclass
+++ b/eclass/font-ebdftopcf.eclass
@@ -1,15 +1,12 @@
 # Copyright 1999-2020 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
-# @ECLASS: font-ebdftopcf.eclass
-# @MAINTAINER:
-# Robin H. Johnson <robbat2@gentoo.org>
-# @AUTHOR:
-# Robin H. Johnson <robbat2@gentoo.org>
-# @BLURB: A simple eclass to convert BDF to PCF
-# @DESCRIPTION:
-# Make PCF font generator from BDF uniform and optimal
+# Author: Robin H. Johnson <robbat2@gentoo.org>
+
+# font-ebdftopcf.eclass
+# Eclass to make PCF font generator from BDF uniform and optimal
 # The manpage for this eclass is in media-gfx/ebdftopcf.
+
 # inherit this eclass after font.eclass
 
 # if USE="-X", this eclass is basically a no-op, since bdftopcf requires Xorg.
@@ -19,9 +16,9 @@ IUSE="X"
 DEPEND="X? ( media-gfx/ebdftopcf )"
 RDEPEND=""
 
-# @FUNCTION: ebdftopcf
-# @DESCRIPTION:
-# Convert BDF files to PCF
+#
+# Public functions
+#
 ebdftopcf() {
 	local bdffiles
 	bdffiles="$@"
@@ -32,9 +29,9 @@ ebdftopcf() {
 		|| die "Failed to build PCF files"
 }
 
-# @FUNCTION: font-ebdftopcf_src_compile
-# @DESCRIPTION:
-# Convert fonts from BDF to PCF
+#
+# Public inheritable functions
+#
 font-ebdftopcf_src_compile() {
 	use X && FONT_SUFFIX="pcf.gz"
 	use X || FONT_SUFFIX="bdf"