--- app-portage/eclass-manpages/files/eclass-to-manpage.awk	2011-07-21 19:18:03.574684459 +0200
+++ app-portage/eclass-manpages/files/eclass-to-manpage.awk	2011-07-22 10:56:12.209428286 +0200
@@ -18,6 +18,7 @@
 # <optional; long description>
 # @EXAMPLE:
 # <optional; example usage>
+# @SEE_ALSO: <optional; list of eclass names>
 
 # The format of functions:
 # @FUNCTION: foo
@@ -72,7 +73,7 @@
 
 function eat_line() {
 	ret = $0
-	sub(/^# @[A-Z]*:[[:space:]]*/,"",ret)
+	sub(/^# @[A-Z_]*:[[:space:]]*/,"",ret)
 	getline
 	return ret
 }
@@ -114,6 +115,7 @@
 	blurb = ""
 	desc = ""
 	example = ""
+	see_also = ""
 
 	# first the man page header
 	print ".\\\" -*- coding: utf-8 -*-"
@@ -136,6 +138,8 @@
 		desc = eat_paragraph()
 	if ($2 == "@EXAMPLE:")
 		example = eat_paragraph()
+	if ($2 == "@SEE_ALSO:")
+		see_also = eat_line()
 
 	# finally display it
 	print ".SH \"NAME\""
@@ -311,7 +315,19 @@
 	print ".SH \"FILES\""
 	print ".BR " eclassdir "/" eclass
 	print ".SH \"SEE ALSO\""
-	print ".BR ebuild (5)"
+	if (see_also != "") {
+		split(see_also, a)
+		for (val in a) {
+			a[val] = a[val] ".eclass"
+		}
+		a[ebuild] = "ebuild"
+		n = asort(a)
+		for (i = 1; i <= n; i++) {
+			print ".BR " a[i] "(5)"
+		}
+	} else {
+		print ".BR ebuild(5)"
+	}
 }
 
 #