update eclass documentation to use new markings and avoid warnings

2 files changed, 13 insertions, 7 deletions

diff --git a/eclass/autotools.eclass b/eclass/autotools.eclass
index 163b95a20f13..eb8dc5b242fe 100644
--- a/eclass/autotools.eclass
+++ b/eclass/autotools.eclass
@@ -1,6 +1,6 @@
 # Copyright 1999-2010 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/autotools.eclass,v 1.99 2010/07/06 18:55:50 vapier Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/autotools.eclass,v 1.100 2010/08/21 19:36:45 vapier Exp $
 
 # @ECLASS: autotools.eclass
 # @MAINTAINER:
@@ -25,6 +25,7 @@ inherit eutils libtool
 : ${WANT_AUTOMAKE:=latest}
 
 # @ECLASS-VARIABLE: _LATEST_AUTOMAKE
+# @INTERNAL
 # @DESCRIPTION:
 # CONSTANT!
 # The latest major version/slot of automake available on each arch.
@@ -74,11 +75,13 @@ fi
 unset _automake_atom _autoconf_atom
 
 # @ECLASS-VARIABLE: AM_OPTS
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Additional options to pass to automake during
 # eautoreconf call.
 
 # @ECLASS-VARIABLE: AT_NOELIBTOOLIZE
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Don't run elibtoolize command if set to 'yes',
 # useful when elibtoolize needs to be ran with
diff --git a/eclass/cvs.eclass b/eclass/cvs.eclass
index 8e412b2965fa..a2d895089c69 100644
--- a/eclass/cvs.eclass
+++ b/eclass/cvs.eclass
@@ -1,6 +1,6 @@
 # Copyright 1999-2008 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/cvs.eclass,v 1.72 2010/08/21 18:21:06 vapier Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/cvs.eclass,v 1.73 2010/08/21 19:36:45 vapier Exp $
 
 # @ECLASS: cvs.eclass
 # @MAINTAINER:
@@ -35,6 +35,7 @@ inherit eutils
 # on the cvs connection.  The default of "cvs -q -f -z4" means to be
 # quiet, to disregard the ~/.cvsrc config file and to use maximum
 # compression.
+[[ -z ${ECVS_CVS_COMMAND} ]] && ECVS_CVS_COMMAND="cvs ${ECVS_CVS_OPTIONS} ${ECVS_CVS_COMPRESS}"
 
 # @ECLASS-VARIABLE: ECVS_CVS_COMPRESS
 # @DESCRIPTION:
@@ -46,11 +47,6 @@ inherit eutils
 # Additional options to the cvs commands.
 [[ -z ${ECVS_CVS_OPTIONS} ]] && ECVS_CVS_OPTIONS="-q -f"
 
-# @ECLASS-VARIABLE: ECVS_CVS_COMMAND
-# @DESCRIPTION:
-# The cvs command.
-[[ -z ${ECVS_CVS_COMMAND} ]] && ECVS_CVS_COMMAND="cvs ${ECVS_CVS_OPTIONS} ${ECVS_CVS_COMPRESS}"
-
 # @ECLASS-VARIABLE: ECVS_UP_OPTS
 # @DESCRIPTION:
 # CVS options given after the cvs update command. Don't remove "-dP" or things
@@ -70,12 +66,14 @@ inherit eutils
 : ${ECVS_OFFLINE:=${ESCM_OFFLINE}}
 
 # @ECLASS-VARIABLE: ECVS_LOCAL
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # If this is set, the CVS module will be fetched non-recursively.
 # Refer to the information in the CVS man page regarding the -l
 # command option (not the -l global option).
 
 # @ECLASS-VARIABLE: ECVS_LOCALNAME
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Local name of checkout directory
 #
@@ -106,6 +104,7 @@ inherit eutils
 [ -z "$ECVS_SERVER" ] && ECVS_SERVER="offline"
 
 # @ECLASS-VARIABLE: ECVS_MODULE
+# @REQUIRED
 # @DESCRIPTION:
 # The name of the CVS module to be fetched
 #
@@ -115,6 +114,7 @@ inherit eutils
 #[ -z "$ECVS_MODULE" ] && die "$ECLASS: error: ECVS_MODULE not set, cannot continue"
 
 # @ECLASS-VARIABLE: ECVS_BRANCH
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # The name of the branch/tag to use
 #
@@ -151,6 +151,7 @@ inherit eutils
 [ -z "$ECVS_PASS" ] && ECVS_PASS=""
 
 # @ECLASS-VARIABLE: ECVS_SSH_HOST_KEY
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # If SSH is used for `ext' authentication, use this variable to
 # specify the host key of the remote server.  The format of the value
@@ -160,11 +161,13 @@ inherit eutils
 # remote host key will not be verified.
 
 # @ECLASS-VARIABLE: ECVS_CLEAN
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Set this to get a clean copy when updating (passes the
 # -C option to cvs update)
 
 # @ECLASS-VARIABLE: ECVS_RUNAS
+# @DEFAULT_UNSET
 # @DESCRIPTION:
 # Specifies an alternate (non-root) user to use to run cvs.  Currently
 # b0rked and wouldn't work with portage userpriv anyway without