--- /usr/portage/eclass/qt3.eclass	2007-08-02 22:05:49.000000000 +0200
+++ qt3.eclass	2007-08-13 22:53:05.128095252 +0200
@@ -1,22 +1,17 @@
 # Copyright 2005 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
 # $Header: /var/cvsroot/gentoo-x86/eclass/qt3.eclass,v 1.30 2007/08/02 20:04:40 carlo Exp $
-#
-# Author Caleb Tennis <caleb@gentoo.org>
-#
-# This eclass is simple.  Inherit it, and in your depend, do something like this:
-#
-# DEPEND="$(qt_min_version 3.1)"
-#
-# and it handles the rest for you
-#
-# Caveats:
-#
-# Currently, the ebuild assumes that a minimum version of Qt3 is NOT satisfied by Qt4
 
-inherit toolchain-funcs versionator
+# @ECLASS: qt3.eclass
+# @MAINTAINER:
+# Caleb Tennis <caleb@gentoo.org>
+# @BLURB:
+# Eclass for Qt3 packages
+# @DESCRIPTION:
+# This eclass contains various functions that may be useful
+# when dealing with packages using Qt3 libraries.
 
-IUSE="${IUSE}"
+inherit toolchain-funcs versionator
 
 QTPKG="x11-libs/qt-"
 QT3MAJORVERSIONS="3.3 3.2 3.1 3.0"
@@ -31,6 +26,13 @@
 addwrite "${QTDIR}/etc/settings"
 addpredict "${QTDIR}/etc/settings"
 
+# @FUNCTION: qt_min_version
+# @USAGE: [minimum version]
+# @DESCRIPTION:
+# This function is simple.  In your depend, do something like this:
+# DEPEND="$(qt_min_version 3.1)"
+# and it handles the rest for you. Currently, the eclass assumes
+# that a minimum version of Qt3 is not satisfied by Qt4.
 qt_min_version() {
 	local list=$(qt_min_version_list "$@")
 	if [[ ${list%% *} == "${list}" ]]; then
@@ -66,16 +68,25 @@
 	echo ${VERSIONS}
 }
 
+# @FUNCTION: eqmake3
+# @USAGE: [.pro file] [additional parameters to qmake]
+# @MAINTAINER:
+# Przemyslaw Maciag <troll@gentoo.org>
+# Davide Pesavento <davidepesa@gmail.com>
+# @DESCRIPTION:
+# Runs qmake on the specified .pro file (defaults to
+# ${PN}.pro if eqmake3 was called with no argument).
+# Additional parameters are passed unmodified to qmake.
 eqmake3() {
 	local LOGFILE="${T}/qmake-$$.out"
 	local projprofile="${1}"
-	[ -z ${projprofile} ] && projprofile="${PN}.pro"
+	[[ -z ${projprofile} ]] && projprofile="${PN}.pro"
 	shift 1
 
 	ebegin "Processing qmake ${projprofile}"
 
 	# file exists?
-	if [ ! -f ${projprofile} ]; then
+	if [[ ! -f ${projprofile} ]]; then
 		echo
 		eerror "Project .pro file \"${projprofile}\" does not exists"
 		eerror "qmake cannot handle non-existing .pro files"
@@ -101,6 +112,7 @@
 	fi
 
 	${QTDIR}/bin/qmake ${projprofile} \
+		QTDIR=${QTDIR} \
 		QMAKE=${QTDIR}/bin/qmake \
 		QMAKE_CC=$(tc-getCC) \
 		QMAKE_CXX=$(tc-getCXX) \
@@ -120,7 +132,7 @@
 	eend ${result}
 
 	# was qmake successful?
-	if [ ${result} -ne 0 ]; then
+	if [[ ${result} -ne 0 ]]; then
 		echo
 		eerror "Running qmake on \"${projprofile}\" has failed"
 		echo