--- fixheadtails.eclass.orig	2008-02-17 01:41:12.000000000 +0100
+++ fixheadtails.eclass	2008-02-17 01:49:05.000000000 +0100
@@ -1,19 +1,18 @@
-# Copyright 1999-2004 Gentoo Foundation
+# Copyright 1999-2008 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/fixheadtails.eclass,v 1.10 2005/12/20 01:31:53 vapier Exp $
+# $Header:  $
+
+# @ECLASS: fixheadtails.eclass
+# @MAINTAINER:
+# ???
 #
-# Author John Mylchreest <johnm@gentoo.org>
+# Original author John Mylchreest <johnm@gentoo.org>
+# @BLURB: Replaces obsolete head/tail with POSIX compliant ones
+# @DESCRIPTION:
+# Replaces obsolete head/tail with POSIX compliant ones
 
 DEPEND=">=sys-apps/sed-4"
 
-# ht_fix_all
-# This fixes all files within the current directory.
-# Do be used in src_unpack ; cd ${S}; ht_fix_all
-
-# ht_fix_file <param> [<param>] [<param>]..
-# This fixes the files passed by PARAM
-# to be used for specific files. ie: ht_fix_file "${FILESDIR}/mypatch.patch"
-
 do_sed_fix() {
 	einfo " - fixed $1"
 	sed -i \
@@ -23,6 +22,13 @@
 			die "sed ${1} failed"
 }
 
+# @FUNCTION: ht_fix_file
+# @USAGE: < param > [ param ] [ param ] [ ... ]
+# @DESCRIPTION: 
+# This fixes the files passed by PARAM
+# to be used for specific files.
+#
+# ie: ht_fix_file "${FILESDIR}/mypatch.patch"
 ht_fix_file() {
 	local i
 
@@ -33,6 +39,11 @@
 	done
 }
 
+# @FUNCTION: ht_fix_all
+# @DESCRIPTION:
+# This fixes all files within the current directory.
+#
+# To be used in src_unpack ; cd ${S}; ht_fix_all
 ht_fix_all() {
 	local MATCHES
 	MATCHES=$(grep -l -s -i -R -e "head -[ 0-9]" -e "tail [+-][ 0-9]" * | sort -u)