Update eclass documentation to be correclty parsed, bug #452204.

3 files changed, 23 insertions, 17 deletions

diff --git a/eclass/ChangeLog b/eclass/ChangeLog
index 4a208287b167..d37b034cfd11 100644
--- a/eclass/ChangeLog
+++ b/eclass/ChangeLog
@@ -1,6 +1,10 @@
 # ChangeLog for eclass directory
 # Copyright 1999-2013 Gentoo Foundation; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/ChangeLog,v 1.622 2013/01/16 19:06:15 sera Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/ChangeLog,v 1.623 2013/01/16 22:52:37 eva Exp $
+
+  16 Jan 2013; Gilles Dartiguelongue <eva@gentoo.org> gnome2.eclass,
+  gst-plugins10.eclass:
+  Update eclass documentation to be correclty parsed, bug #452204.
 
   16 Jan 2013; Ralph Sennhauser <sera@gentoo.org> java-utils-2.eclass:
   Be graceful if no system vm is set if trying to determine build vm from
diff --git a/eclass/gnome2.eclass b/eclass/gnome2.eclass
index 8ad48d668f58..e39f58ba4048 100644
--- a/eclass/gnome2.eclass
+++ b/eclass/gnome2.eclass
@@ -1,11 +1,11 @@
 # Copyright 1999-2013 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/gnome2.eclass,v 1.118 2013/01/13 22:35:28 eva Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/gnome2.eclass,v 1.119 2013/01/16 22:52:37 eva Exp $
 
 # @ECLASS: gnome2.eclass
 # @MAINTAINER:
 # gnome@gentoo.org
-# @BLURB: 
+# @BLURB: Provides phases for Gnome/Gtk+ based packages.
 # @DESCRIPTION:
 # Exports portage base functions used by ebuilds written for packages using the
 # GNOME framework. For additional functions, see gnome2-utils.eclass.
@@ -23,7 +23,7 @@ case "${EAPI:-0}" in
 esac
 
 # @ECLASS-VARIABLE: G2CONF
-# @DEFAULT-UNSET
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Extra configure opts passed to econf
 G2CONF=${G2CONF:-""}
@@ -39,26 +39,24 @@ else
 fi
 
 # @ECLASS-VARIABLE: ELTCONF
-# @DEFAULT-UNSET
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Extra options passed to elibtoolize
 ELTCONF=${ELTCONF:-""}
 
 # @ECLASS-VARIABLE: USE_EINSTALL
-# @DEFAULT-UNSET
-# @DEPRECATED
+# @DEFAULT_UNSET
 # @DESCRIPTION:
-# Should we use EINSTALL instead of DESTDIR
+# Should we use EINSTALL instead of DESTDIR. DEPRECATED
 USE_EINSTALL=${USE_EINSTALL:-""}
 
 # @ECLASS-VARIABLE: SCROLLKEEPER_UPDATE
-# @DEPRECATED
 # @DESCRIPTION:
-# Whether to run scrollkeeper for this package or not.
+# Whether to run scrollkeeper for this package or not. DEPRECATED
 SCROLLKEEPER_UPDATE=${SCROLLKEEPER_UPDATE:-"1"}
 
 # @ECLASS-VARIABLE: DOCS
-# @DEFAULT-UNSET
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # String containing documents passed to dodoc command.
 
@@ -275,8 +273,6 @@ gnome2_pkg_postinst() {
 	gnome2_scrollkeeper_update
 }
 
-# @#FUNCTION: gnome2_pkg_prerm
-# @#DESCRIPTION:
 # # FIXME Handle GConf schemas removal
 #gnome2_pkg_prerm() {
 #	gnome2_gconf_uninstall
diff --git a/eclass/gst-plugins10.eclass b/eclass/gst-plugins10.eclass
index 6e020a80d92f..a80825540b4e 100644
--- a/eclass/gst-plugins10.eclass
+++ b/eclass/gst-plugins10.eclass
@@ -1,6 +1,6 @@
-# Copyright 1999-2012 Gentoo Foundation
+# Copyright 1999-2013 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/gst-plugins10.eclass,v 1.8 2012/12/02 17:16:20 eva Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/gst-plugins10.eclass,v 1.9 2013/01/16 22:52:37 eva Exp $
 
 # @ECLASS: gst-plugins10.eclass
 # @MAINTAINER:
@@ -46,6 +46,7 @@ EXPORT_FUNCTIONS ${GST_EXPF}
 # @DESCRIPTION:
 # Should we delete all the .la files?
 # NOT to be used without due consideration.
+# Defaults to no for EAPI < 5.
 if has "${EAPI:-0}" 0 1 2 3; then
 	: ${GST_LA_PUNT:="no"}
 else
@@ -184,10 +185,9 @@ gst-plugins10_system_link() {
 
 # @FUNCTION: gst-plugins10_remove_unversioned_binaries
 # @INTERNAL
-# @DEPRECATED
 # @DESCRIPTION:
 # Remove the unversioned binaries gstreamer provides to prevent file collision
-# with other slots.
+# with other slots. DEPRECATED
 gst-plugins10_remove_unversioned_binaries() {
 	cd "${D}"/usr/bin
 	local gst_bins
@@ -199,6 +199,8 @@ gst-plugins10_remove_unversioned_binaries() {
 }
 
 # @FUNCTION: gst-plugins10_src_configure
+# @DESCRIPTION:
+# Handles logic common to configuring gstreamer plugins
 gst-plugins10_src_configure() {
 	local plugin gst_conf
 
@@ -248,6 +250,8 @@ gst-plugins10_src_configure() {
 }
 
 # @FUNCTION: gst-plugins10_src_compile
+# @DESCRIPTION:
+# Compiles requested gstreamer plugin.
 gst-plugins10_src_compile() {
 	has ${EAPI:-0} 0 1 && gst-plugins10_src_configure "$@"
 
@@ -261,6 +265,8 @@ gst-plugins10_src_compile() {
 }
 
 # @FUNCTION: gst-plugins10_src_install
+# @DESCRIPTION:
+# Installs requested gstreamer plugin.
 gst-plugins10_src_install() {
 	gst-plugins10_find_plugin_dir