merge from portage_2_0

29 files changed, 659 insertions, 124 deletions

diff --git a/man/check-kernel.eclass.5 b/man/check-kernel.eclass.5
index 4d4a964..4f12d12 100644
--- a/man/check-kernel.eclass.5
+++ b/man/check-kernel.eclass.5
@@ -1,6 +1,6 @@
 .TH "CHECK-KERNEL.ECLASS" "5" "Aug 2004" "Portage 2.0.51" "portage"
 .SH "NAME"
-check-kernel \- check kernel sources
+check-kernel.eclass \- check kernel sources
 .SH "DESCRIPTION"
 The \fBcheck-kernel\fR eclass provides an easy interface for detecting kernel
 sources and retrieving various information.
@@ -50,4 +50,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Aaron Walker <ka0ttic@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/check-kernel.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/check-kernel.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/check-reqs.eclass.5 b/man/check-reqs.eclass.5
new file mode 100644
index 0000000..2110ba0
--- /dev/null
+++ b/man/check-reqs.eclass.5
@@ -0,0 +1,55 @@
+.TH CHECK-REQS.ECLASS 5 "Dec 2004" "Portage 2.0.51" "portage"
+.SH NAME
+check-reqs.eclass \- functions for checking proper build requirements
+.SH DESCRIPTION
+The \fBcheck-reqs\fR eclass provides a uniform interface for handling ebuilds
+which require an abnormally high amount of system resources.  The variable(s)
+and function(s) mentioned here should usually be set/called from \fBpkg_setup\fR.
+.br
+
+\fBNOTE\fR: Minimum criteria for use of this eclass is a build that requires
+>256MB of RAM and/or >1GB of temporary or install space.
+.SH VARIABLES
+\fBNOTE\fR: all numerical values are evaluated as megabytes (MB).
+.TP
+.B CHECKREQS_ACTION = \fI"(warn|error|ignore)"\fR
+Defines action to take if current system resources do not satisfy requirements.
+\fBNOTE\fR: this variable is for end user only.  Ebuilds must *not* override or
+set a default for this variable.
+.TP
+.B CHECKREQS_MEMORY = \fI"256"\fR
+Defines amount of memory required.  Note that the \fBcheck-reqs\fR eclass does
+not take swap space into account when checking current memory resources.
+.TP
+.B CHECKREQS_DISK_BUILD = \fI"1024"\fR
+Defines amount of temporary build space required.
+.TP
+.B CHECKREQS_DISK_USR = \fI"1024"\fR
+Defines amount of /usr space required.
+.TP
+.B CHECKREQS_DISK_VAR = \fI"1024"\fR
+Defines amount of /var space required.
+.SH FUNCTIONS
+\fBNOTE\fR: all numerical values are evaluated as megabytes (MB).  Any values
+should merely be rough estimates, and a high degree of precision should not
+be implied -- for example, "2048" (or "2000") are more appropriate than "2137".
+.TP
+.B check_reqs
+Performs resource checks based on above defined variables. If the checks fail,
+the action specified by \fBCHECKREQS_ACTION\fR will be executed.  If for some
+reason the \fBcheck-reqs\fR eclass is unable to determine current resources,
+then no action will be performed.  This function should be called from within
+\fBpkg_setup\fR.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/check-reqs.eclass
+.SH AUTHORS
+.nf
+Aaron Walker <ka0ttic@gentoo.org>
+Ciaran McCreesh <ciaranm@gentoo.org>
+.fi
+.SH CVS HEADER
+$Header $
diff --git a/man/cvs.eclass.5 b/man/cvs.eclass.5
index 74969c3..3536d1a 100644
--- a/man/cvs.eclass.5
+++ b/man/cvs.eclass.5
@@ -1,7 +1,7 @@
-.TH "CVS.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
-.SH "NAME"
-cvs \- provides generic cvs fetching functions
-.SH "DESCRIPTION"
+.TH CVS.ECLASS 5 "Nov 2004" "Portage 2.0.51" portage
+.SH NAME
+cvs.eclass \- provides generic cvs fetching functions
+.SH DESCRIPTION
 The \fBcvs\fR eclass contains a suite of functions that are used to
 create 'live' cvs ebuilds.  These ebuilds are called 'live' because
 they will checkout a cvs repository at the time of emerge and compile
@@ -9,11 +9,10 @@ the source from the checkout.  This eclass usually generates pretty
 unstable ebuilds ... but you can't get anymore bleeding edge than
 a live cvs checkout :).
 
-.br
 Common usage of this eclass involves setting \fBECVS_SERVER\fR and
 \fBECVS_MODULE\fR to grab the relevant cvs sources, and then letting
 the eclass define \fBsrc_unpack\fR for you.
-.SH "VARIABLES"
+.SH VARIABLES
 .TP
 .B "ECVS_CVS_COMMAND" = \fI"cvs -q -f -z4"\fR
 The command to run in order to checkout the module from the cvs
@@ -56,7 +55,7 @@ The module to checkout from the cvs server.  Please note that you
 The branch to checkout the sources from.  The common targets are
 HEAD (current 'stable' cvs code) and SPLIT (current 'unstable' cvs
 code).
-.SH "FUNCTIONS"
+.SH FUNCTIONS
 .TP
 .B cvs_fetch
 This function will setup \fBECVS_TOP_DIR\fR and any other pre-checkout
@@ -69,13 +68,13 @@ This function will determine where the cvs files need to be saved and
 then where they need to be placed after the checkout.  The final result
 is that you will have a copy of \fBECVS_MODULE\fR in \fB${WORKDIR}\fR.  Thus
 you will usually set \fB${S}\fR to be \fB${WORKDIR}/${ECVS_MODULE}\fR.
-.SH "REPORTING BUGS"
+.SH REPORTING BUGS
 Please report bugs via http://bugs.gentoo.org/
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR ebuild (5)
-.SH "FILES"
+.SH FILES
 .BR /usr/portage/eclass/cvs.eclass
-.SH "AUTHORS"
+.SH AUTHORS
 Mike Frysinger <vapier@gentoo.org>
-.SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/cvs.eclass.5,v 1.4 2004/09/17 00:17:10 vapier Exp $
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/cvs.eclass.5,v 1.5 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/dispatch-conf.1 b/man/dispatch-conf.1
index bf7d9f0..3658b9c 100644
--- a/man/dispatch-conf.1
+++ b/man/dispatch-conf.1
@@ -1,4 +1,4 @@
-.TH "DISPATCH-CONF "1" "May 2004" "Portage 2.0.51" "Portage"
+.TH "DISPATCH-CONF" "1" "May 2004" "Portage 2.0.51" "Portage"
 .SH NAME
 dispatch-conf \- Sanely update configuration files after emerging new packages
 .SH SYNOPSIS
@@ -90,4 +90,4 @@ Mike Frysinger <vapier@gentoo.org>
 .br
 Grant Goodyear <g2boojum@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/dispatch-conf.1,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/dispatch-conf.1,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/distutils.eclass.5 b/man/distutils.eclass.5
index d8b117a..059066d 100644
--- a/man/distutils.eclass.5
+++ b/man/distutils.eclass.5
@@ -1,6 +1,6 @@
 .TH "DISTUTILS.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-distutils \- allow easier installation of distutils-based python modules
+distutils.eclass \- allow easier installation of distutils-based python modules
 .SH "DESCRIPTION"
 The \fBdistutils\fR eclass is designed to allow easier installation of
 distutils-based python modules and their incorporation into the Gentoo
@@ -36,4 +36,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/distutils.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/distutils.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/ebook.eclass.5 b/man/ebook.eclass.5
index e82edea..289517b 100644
--- a/man/ebook.eclass.5
+++ b/man/ebook.eclass.5
@@ -1,6 +1,6 @@
 .TH "EBOOK.ECLASS" "5" "Aug 2004" "Portage 2.0.51" "portage"
 .SH "NAME"
-ebook \- easy installation of ebooks
+ebook.eclass \- easy installation of ebooks
 .SH "DESCRIPTION"
 The \fBebook\fR eclass makes writing ebuilds for ebooks a trivial task.
 .SH "VARIABLES"
@@ -72,4 +72,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Aaron Walker <ka0ttic@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ebook.eclass.5,v 1.2 2004/09/29 12:55:49 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ebook.eclass.5,v 1.3 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/ebuild.5 b/man/ebuild.5
index 02b0d7c..a5f74de 100644
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -41,7 +41,7 @@ src_install() {
 	doinfo doc/sed.info
 	doman doc/sed.1
 	into /
-	dobin sed/sed
+	dobin sed/sed || die "dobin sed failed"
 	dodir /usr/bin
 	dosym /bin/sed /usr/bin/sed
 	dodoc NEWS README* THANKS TODO AUTHORS BUGS ANNOUNCE
@@ -108,9 +108,10 @@ Contains the path to a \fItemporary directory\fR.  You may use this for
 whatever you like.
 .TP
 \fBD\fR = \fI"${PORTAGE_TMPDIR}/portage/${PF}/image"\fR
-Contains the path to the temporary \fIinstall directory\fR.  Every write
-operation that does not involve the helper tools and functions (found
-below) should be prefixed with ${D}.  Do not modify this variable.
+Contains the path to the temporary \fIinstall directory\fR.  Every write 
+operation that does not involve the helper tools and functions (found below) 
+should be prefixed with ${D}.  Do not modify this variable.  This will not be 
+available inside of the pkg_* functions.
 .TP
 \fBDESCRIPTION\fR = \fI"A happy little package"\fR
 Should contain a short description of the package.
@@ -216,9 +217,9 @@ examples you may find in the portage tree:
 
 \fI!\fR means block packages from being installed at the same time.
 .br
-\fI*\fR means match any version of the package so long as the specified 
-base is matched.  So with a version of '2*', we can match '2.1', '2.2', 
-'2.2.1', etc... and not match version '1.0', '3.0', '4.1', etc...
+\fI*\fR means match any version of the package so long as the specified base 
+is matched.  So with a version of '2*', we can match '2.1', '2.2', '2.2.1', 
+etc... and not match version '1.0', '3.0', '4.1', etc...
 .br
 \fI~\fR means match any revision of the base version specified.  So in the 
 above example, we would match versions '1.0.2a', '1.0.2a-r1', '1.0.2a-r2', 
@@ -425,7 +426,7 @@ Useful for creating custom options to pass to a configure script. If
 \fI--with-[configure option]\fR will be echoed.  If \fIUSE item\fR is
 not in the \fBUSE\fR variable, then the string
 \fI--without-[configure option]\fR will be echoed.  If
-\fIconfigure option\fR is not specified, than \fIUSE item\fR will be
+\fIconfigure option\fR is not specified, then \fIUSE item\fR will be
 used in its place.
 .RS
 .TP
@@ -451,7 +452,7 @@ Useful for creating custom options to pass to a configure script. If
 \fI--enable-[configure option]\fR will be echoed.  If \fIUSE item\fR is
 not in the \fBUSE\fR variable, then the string
 \fI--disable-[configure option]\fR will be echoed. If \fIconfigure option\fR
-is not specified, than \fIUSE item\fR will be used in its place.
+is not specified, then \fIUSE item\fR will be used in its place.
 .br
 See \fBuse_with\fR for an example.
 .TP
@@ -520,9 +521,8 @@ writers.  If you wish to pass more options to configure, just pass the
 extra arguements to \fBeconf\fR.
 .TP
 \fBemake\fR \fI[make options]\fR
-This is used as a replacement for make.  Performs
-'make ${MAKEOPTS} \fImake options\fR' (as set in /etc/make.globals),
-default is MAKEOPTS="\-j2".
+This is used as a replacement for make.  Performs 'make ${MAKEOPTS} 
+\fImake options\fR' (as set in /etc/make.globals), default is MAKEOPTS="\-j2".
 
 \fB***warning***\fR
 .br
@@ -542,11 +542,12 @@ make \\
 	mandir=${D}/usr/share/man \\
 	sysconfdir=${D}/etc \\
 	\fI${EXTRA_EINSTALL}\fR \\
-	\fImake options\fR install
+	\fImake options\fR \\
+	install
 .fi
-Please do not use this in place of 'make install DESTDIR=${D}'.  That
-is the preferred way of installing make-based packages.  Also, do not 
-utilize the \fIEXTRA_EINSTALL\fR variable since it is for users.
+Please do \fBnot\fR use this in place of 'make install DESTDIR=${D}'.  
+That is the preferred way of installing make-based packages.  Also, do 
+not utilize the \fIEXTRA_EINSTALL\fR variable since it is for users.
 
 .PD 0
 .TP
@@ -821,4 +822,4 @@ Nicholas Jones <carpaski@gentoo.org>
 Mike Frysinger <vapier@gentoo.org>
 .fi
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ebuild.5,v 1.73 2004/10/16 20:15:48 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ebuild.5,v 1.74 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/emerge.1 b/man/emerge.1
index 0e79eab..ab8b9f0 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -210,10 +210,10 @@ As an example, this catches updates in libraries that are not directly
 listed in the dependencies of a package.
 .TP
 .BR "\-\-emptytree " (\fB\-e\fR)
-Virtually tweaks the tree of installed packages to only contain libc;
-this is great to use together with \fB\-\-pretend\fR.  This allows developers
-to get a complete overview of the complete dependency tree of a package,
-and it enables complete trees to be rebuilt using the latest libraries.
+Reinstalls all world packages and their dependencies to the current USE 
+specifications while differing from the installed set of packages as 
+little as possible.  You should run with \fB\-\-pretend\fR first to make 
+sure the result is what you expect.
 .TP
 .BR "\-\-fetchonly " (\fB\-f\fR)
 Instead of doing any package building, just perform fetches for all
@@ -243,7 +243,7 @@ on that subject.  The internal \fBemerge\fR help documentation is
 updated more frequently than this man page; check it out if you
 are having problems that this man page does not help resolve.
 .TP
-.BR "\-\-newuse"
+.BR "\-\-newuse " (\fB\-N\fR)
 Tells emerge to include installed packages where USE flags have changed
 since compilation. An asterisk marks when a USE flag has changed since
 the package was compiled.
@@ -270,7 +270,7 @@ not remerge dependencies by default.
 Disables the spinner for the session.  The spinner is active when the
 terminal device is determined to be a TTY.  This flag disables it regardless.
 .TP
-.BR "\-\-oneshot"
+.BR "\-\-oneshot " (\fB\-1\fR)
 Emerge as normal, but do not add the packages to the world profile
 for later updating.
 .TP
@@ -419,30 +419,28 @@ when the previous version emerged was injected (see \fBinject\fR for more info)
 or very outdated (so old that \fBSLOT\fR did not exist).  Either way, a newer version
 of Xfree is availabe for your updating delight.
 .TP
-.B [ebuild     U ] sys\-devel/distcc\-2.16 [2.13\-r1] \-gnome \-gtk +ipv6* (\-selinux)
-The \-gtk and \-gnome reflect the status of \fBUSE\fR variables when emerging distcc.  Here
-we see that distcc can use the \fBUSE\fR variables gtk and gnome, but that your current
-settings have gtk and gnome disabled.  This means optional support for gtk and gnome will
-not be enabled in distcc when you emerge it.
-An asterisk shows that the \fBUSE\fR flags have changed since the package was last installed.  
-In this case, ipv6 is enabled but was previously disabled.  A \fBUSE\fR flag in brackets, like 
-(\-selinux), is always disabled and shows that the flag is not available for the current system 
-profile.
-.br 
-\fB*Note:\fR The \fBUSE\fR status is only displayed when you use the \fB\-\-pretend\fR
-and \fB\-\-verbose\fR options.
+.B [ebuild     U ] sys\-devel/distcc\-2.16 [2.13\-r1] \-gtk +ipv6* (\-selinux)
+The \-gtk reflects the status of \fBUSE\fR variables when emerging distcc.  
+Here we see that distcc can use the \fBUSE\fR variable gtk, but that your 
+current settings have gtk disabled.  This means optional support for gtk will
+not be enabled in distcc when you emerge it.  An asterisk shows that the 
+\fBUSE\fR flags have changed since the package was last installed.  In this 
+case, ipv6 is enabled but was previously disabled.  A \fBUSE\fR flag in 
+pparenthesis, like (\-selinux), is always disabled and shows that the flag is 
+not available for the current system profile.
+.br
+\fB*Note:\fR The \fBUSE\fR status is only displayed when you use the 
+\fB\-\-pretend\fR and \fB\-\-verbose\fR options.
 .SH "NOTES"
-You should almost always precede any package install or update
-attempt with a \fB\-\-pretend\fR install or update.  This lets
-you see how much will be done, and shows you any blocking
-packages that you will have to rectify.  This goes doubly so
-for the \fBsystem\fR and \fBworld\fR classes, which can
-update a large number of packages if the portage tree has
-been particularly active.
+You should almost always precede any package install or update attempt with a 
+\fB\-\-pretend\fR install or update.  This lets you see how much will be 
+done, and shows you any blocking packages that you will have to rectify.  
+This goes doubly so for the \fBsystem\fR and \fBworld\fR classes, which can 
+update a large number of packages if the portage tree has been particularly 
+active.
 .LP
-You also want to typically use \fB\-\-update\fR, which ignores
-packages that are already fully updated but upgrades those that
-are not.
+You also want to typically use \fB\-\-update\fR, which ignores packages that 
+are already fully updated but upgrades those that are not.
 .LP
 When you install a package with uninstalled dependencies and do
 not explicitly state those dependencies in the list of parameters,
@@ -492,12 +490,9 @@ proven to be "stable", are masked with a tilde (\fB~\fR) in front of the
 architecture name.  \fBemerge\fR examines the \fBACCEPT_KEYWORDS\fR environment 
 variable to allow or disallow the emerging of a package masked by \fBKEYWORDS\fR.  
 To inform \fBemerge\fR that it should build these 'testing' versions 
-of packages, you may set \fBACCEPT_KEYWORDS\fR to "\fB~arch\fR", where 
-\fBarch\fR is one of: \fIx86 ppc sparc mips alpha arm hppa\fR.  For example, 
-\fBACCEPT_KEYWORDS="~x86" emerge xfree\fR will cause \fBemerge\fR to consider 
-\fBKEYWORDS\fR\-masked versions of XFree as potentional upgrade 
-candidates.  \fBWARNING:\fR Do \fInot\fR set this variable to anything 
-other than the value corresponding to your architecture.
+of packages, you should update your \fI/etc/portage/package.keywords\fR file 
+to list the packages you want the 'testing' version.  See \fBportage\fR(5) for 
+more information.
 .SH "REPORTING BUGS"
 Please report any bugs you encounter through our website:
 .LP
@@ -571,4 +566,4 @@ Mike Frysinger <vapier@gentoo.org>
 Marius Mauch <genone@gentoo.org>
 .br 
 .SH "CVS HEADER"
-$Id: emerge.1,v 1.71 2004/10/26 02:48:17 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/emerge.1,v 1.72 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/eutils.eclass.5 b/man/eutils.eclass.5
index 71b164b..b9d0a62 100644
--- a/man/eutils.eclass.5
+++ b/man/eutils.eclass.5
@@ -1,6 +1,6 @@
 .TH "EUTILS.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-eutils \- many extra (but common) functions that are used in ebuilds
+eutils.eclass \- many extra (but common) functions that are used in ebuilds
 .SH "DESCRIPTION"
 The \fBeutils\fR eclass contains a suite of functions that complement
 the ones that ebuild.sh already contain.  The idea is that the functions
@@ -86,7 +86,7 @@ by \fB${CATEGORY}\fR) then pass a \fItype\fR value (see http://www.freedesktop.o
 for valid values).  Finally, if the application needs to start up in a special directory,
 pass the last value as the full \fIpath\fR name.
 .TP
-.BR "unpack_makeself "\fI[makeself archive]\fR \fI[byte offset]\fR"
+.BR "unpack_makeself " "\fI[makeself archive]\fR \fI[byte offset]\fR"
 Unpack a makeself archive rather than relying on the script to unpack itself.  Useful for when 
 the scripts use old (POSIX) syntax that is no longer supported properly.  If you don't specify 
 a file to unpack, then \fB${A}\fR is used instead.  If you don't specify the offset, then the 
@@ -173,4 +173,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/eutils.eclass.5,v 1.5 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/eutils.eclass.5,v 1.6 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/fixheadtails.eclass.5 b/man/fixheadtails.eclass.5
index 4ef1256..4c46c67 100644
--- a/man/fixheadtails.eclass.5
+++ b/man/fixheadtails.eclass.5
@@ -1,7 +1,7 @@
 .TH "FIXHEADTAILS.ECLASS" "5" "Aug 2004" "Portage 2.0.51" "portage"
 .SH "NAME"
-fixheadtails \- functions for replacing obsolete head/tail invocations with
-newer POSIX compliant ones.
+fixheadtails.eclass \- functions for replacing obsolete head/tail invocations 
+with newer POSIX compliant ones.
 .SH "DESCRIPTION"
 The \fBfixheadtails\fR eclass contains functions for parsing file(s) and 
 replacing obsolete head/tail invocations in the form similar to:
@@ -29,4 +29,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Aaron Walker <ka0ttic@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/fixheadtails.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/fixheadtails.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/flag-o-matic.eclass.5 b/man/flag-o-matic.eclass.5
index b89fb52..1c0a6d7 100644
--- a/man/flag-o-matic.eclass.5
+++ b/man/flag-o-matic.eclass.5
@@ -1,6 +1,6 @@
 .TH "FLAG-O-MATIC.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-flag\-o\-matic \- manipulate CFLAGS/CXXFLAGS easily and reliably
+flag\-o\-matic.eclass \- manipulate CFLAGS/CXXFLAGS easily and reliably
 .SH "DESCRIPTION"
 The \fBflag\-o\-matic\fR eclass contains a suite of functions to
 manipulate the CFLAGS/CXXFLAGS variables.
@@ -48,15 +48,29 @@ will leave the user with -mfpmath=386.
 .BR "append-ldflags " "\fI<flags>\fR"
 Add extra \fIflags\fR to the current LDFLAGS.
 .TP
+.BR "filter-ldflags " "\fI<flags>\fR"
+Remove particular \fIflags\fR from LDFLAGS.  This function
+will only match complete flags.
+.TP
+.BR "filter-lfs-flags"
+Remove flags that enable Large File Support.
+.TP
+.BR "append-lfs-flags"
+Add flags that enable Large File Support.
+.TP
 .BR "strip-flags"
-Strip CFLAGS/CXXFLAGS of everything except for flags known to
-be good flags.  Users of stable profile are limited to these flags:
+Strip CFLAGS/CXXFLAGS of everything except for flags known to 
+be good flags, or are flags that affect the ABI.  Users of stable 
+profile are limited to these flags:
 .br
 .I "-O -O1 -O2 -mcpu -march -mtune -fstack-protector -pipe -g"
 .br
 Users of unstable profile are allowed the above flags and these flags:
 .br
 .I "-Os -O3 -freorder-blocks -fprefetch-loop-arrays"
+.TP
+.BR "test_flag " "\fI<flag>\fR"
+Tests to see if \fIflag\fR is supported by the active toolchain.
 .SH "REPORTING BUGS"
 Please report bugs via http://bugs.gentoo.org/
 .SH "SEE ALSO"
@@ -67,4 +81,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/flag-o-matic.eclass.5,v 1.5 2004/09/25 07:37:12 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/flag-o-matic.eclass.5,v 1.6 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/font.eclass.5 b/man/font.eclass.5
index c7831de..fd4892f 100644
--- a/man/font.eclass.5
+++ b/man/font.eclass.5
@@ -1,6 +1,6 @@
 .TH "FONT.ECLASS" "5" "Aug 2004" "Portage 2.0.51" "portage"
 .SH "NAME"
-font \- easy, uniform font installation
+font.eclass \- easy, uniform font installation
 .SH "DESCRIPTION"
 The \fBfont\fR eclass attempts to make font installation as easy as possible.
 Everything that usually involves installing fonts (such as creating scalable
@@ -61,4 +61,4 @@ Aaron Walker <ka0ttic@gentoo.org>
 Mike Frysinger <vapier@gentoo.org>
 .fi
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/font.eclass.5,v 1.2 2004/09/29 12:55:49 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/font.eclass.5,v 1.3 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/fortran.eclass.5 b/man/fortran.eclass.5
new file mode 100644
index 0000000..1e35be5
--- /dev/null
+++ b/man/fortran.eclass.5
@@ -0,0 +1,53 @@
+.TH FORTRAN.ECLASS 5 "Nov 2004" "Portage 2.0.51" "portage"
+.SH NAME
+fortran.eclass \- functions for fortran packages
+.SH DESCRIPTION
+The \fBfortran\fR eclass provides an interface to ease the integration of the
+various fortran compilers available.
+.SH VARIABLES
+\fBNOTE\fR: since the \fBfortran\fR eclass does not check to see if the
+following variables are set prior to inheritance, you must ensure that if you
+need to define any of them, that you do so after inheritance occurs.
+.TP
+.B FORTRAN
+Defines a list of fortran compilers that can be used for the build.  Defaults
+to 'f77'.
+.TP
+.B f77_CONF
+Defines configure option that enables the use of the f77 compiler.  Defaults
+to '--with-f77'.
+.TP
+.B f2c_CONF
+Defines configure option that enables the use of the f2c compiler.  Defaults
+to '--with-f2c'.
+.SH FUNCTIONS
+.TP
+.B fortran_conf
+Displays the necessary configure options for the currently selected fortran
+compiler.
+.TP
+.B need_fortran \fI[ profile1 ] < profile2 >\fR
+Checks to see if at least one of the specified profiles is installed. Currently 
+supported profiles include \fBf77\fR, \fBf2c\fR, and \fBifc\fR.
+.TP
+.B patch_fortran
+Applies any patches located in \fB${FILESDIR}\fR named "\fB${P}\fR-COMPILER*",
+where COMPILER is the fortran compiler currently selected for use.
+.TP
+.B fortran_pkg_setup
+Default pkg_setup which calls \fBneed_fortran\fR to ensure that a suitable
+fortran compiler is installed.
+.TP
+.B fortran_src_unpack
+Default src_unpack which besides unpacking the distfile(s), calls
+\fBpatch_fortran\fR to apply any compiler-specific patches.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/fortran.eclass
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/fortran.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/games.eclass.5 b/man/games.eclass.5
index 88b2dbb..e66bd41 100644
--- a/man/games.eclass.5
+++ b/man/games.eclass.5
@@ -1,6 +1,6 @@
 .TH "GAMES.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-games \- standardize the install of all games
+games.eclass \- standardize the install of all games
 .SH "DESCRIPTION"
 The \fBgames\fR eclass is used to centrally control how all games
 will be emerged onto systems.  Here we basically control the filesystem
@@ -116,4 +116,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/games.eclass.5,v 1.7 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/games.eclass.5,v 1.8 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/horde.eclass.5 b/man/horde.eclass.5
index 1f82cfd..8239e87 100644
--- a/man/horde.eclass.5
+++ b/man/horde.eclass.5
@@ -1,6 +1,6 @@
 .TH "HORDE.ECLASS" "5" "Aug 2004" "Portage 2.0.51" "portage"
 .SH "NAME"
-horde \- standardize the installation of horde packages
+horde.eclass \- standardize the installation of horde packages
 .SH "DESCRIPTION"
 The \fBhorde\fR eclass provides generic functions to make the writing of
 horde ebuilds trivial.  The \fBhorde\fR eclass also provides transparent 
@@ -48,4 +48,4 @@ Aaron Walker <ka0ttic@gentoo.org>
 Mike Frysinger <vapier@gentoo.org>
 .fi
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/horde.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/horde.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/libtool.eclass.5 b/man/libtool.eclass.5
index a045f14..1564fa3 100644
--- a/man/libtool.eclass.5
+++ b/man/libtool.eclass.5
@@ -1,6 +1,7 @@
 .TH "LIBTOOL.ECLASS" "5" "Aug 2004" "Portage 2.0.51" "portage"
 .SH "NAME"
-libtool \- fixes the libtool files that are distributed with some packages
+libtool.eclass \- fixes the libtool files that are distributed with some 
+packages
 .SH "DESCRIPTION"
 The \fBlibtool\fR eclass provides an easy way to patch the libtool files 
 that come with some packages.  Often times these files are outdated and 
@@ -44,4 +45,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Aaron Walker <ka0ttic@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/libtool.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/libtool.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/perl-module.eclass.5 b/man/perl-module.eclass.5
index 73e9029..5c324b1 100644
--- a/man/perl-module.eclass.5
+++ b/man/perl-module.eclass.5
@@ -1,6 +1,6 @@
 .TH "PERL-MODULE.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-perl-module \- handles generic perl module ebuilds
+perl-module.eclass \- handles generic perl module ebuilds
 .SH "DESCRIPTION"
 The \fBperl-module\fR eclass is used for the compilation, testing, and 
 installation of perl modules within the portage system, following 
@@ -63,4 +63,4 @@ Michael Cummings <mcummings@gentoo.org>
 .br
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/perl-module.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/perl-module.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/python.eclass.5 b/man/python.eclass.5
new file mode 100644
index 0000000..5addbf5
--- /dev/null
+++ b/man/python.eclass.5
@@ -0,0 +1,82 @@
+.TH PYTHON.ECLASS 5 "Nov 2004" "Portage 2.0.51" portage
+.SH NAME
+python.eclass \- functions for Python-related ebuilds
+.SH DESCRIPTION
+The \fBpython\fR eclass provides general utility functions for Python-related
+ebuilds.
+.SH VARIABLES
+.TP
+.B PYVER
+Defines major and minor Python version.  This is a READ-ONLY variable, set by
+the \fBpython_version\fR function.
+.TP
+.B PYVER_MAJOR
+Defines major Python version.  This is a READ-ONLY variable, set by the
+\fBpython_version\fR function.
+.TP
+.B PYVER_MINOR
+Defines minor Python version.  This is a READ-ONLY variable, set by the
+\fBpython_version\fR function.
+.TP
+.B PYVER_MICRO
+Defines micro Python version.  This is a READ-ONLY variable, set by the
+\fBpython_version\fR function.
+.TP
+.B PYTHON_OVERRIDE_PYVER = \fI"2.2"\fR
+When set, overrides the version of Python to use in the \fBpython_mod_compile\fR
+and \fBpython_mod_optimize\fR functions.
+.SH FUNCTIONS
+.TP
+.B python_version
+Sets variables \fBPYVER\fR, \fBPYVER_MAJOR\fR, \fBPYVER_MINOR\fR, and
+\fBPYVER_MICRO\fR to the version of Python currently available.
+.TP
+.B python_disable_pyc
+Disables automatic recompilation of modules to .pyc/.pyo.  This is supported by
+>=dev-lang/python-2.2.3-r3 only.
+.TP
+.B python_enable_pyc
+Enables automatic recompilation of modules to .pyc/.pyo.  This is supported by
+>=dev-lang/python-2.2.3-r2 only.
+.TP
+.B python_makesym
+Creates the /usr/bin/python symbolic link to point to the latest installed
+version of Python.
+.TP
+.B python_tkinter_exists
+Checks to see if Python was compiled with Tkinter support (via USE=tcltk).
+If not, this function will print an error message informing the user that
+Tkinter support is required and then die.
+.TP
+.B python_mod_exists \fI[ module ]\fR
+Checks to see if the specified module is installed and loadable.  Returns true
+(0) if so or false (1) if not.
+.TP
+.B python_mod_compile \fI[ file ]\fR
+Precompiles the specified file, creating the module's pyc and pyo files.  If
+the variable, \fBPYTHON_OVERRIDE_PYVER\fR is set, this function will use the
+specified version of Python to compile rather than the version detected by
+\fBpython_version\fR.  This function should only be run from \fBpkg_postinst\fR.
+.TP
+.B python_mod_optimize \fI< dir1 > < dir 2 >\fR
+If called with no arguments, this function will recompile all modules under
+sys.path without recursing into subdirectories.  Called with arguments, this
+function will recursively compile all modules in the specified directories.
+If the variable, \fBPYTHON_OVERRIDE_PYVER\fR is set, this function will use
+the specified version of Python rather than the version detected by
+\fBpython_version\fR.
+.TP
+.B python_mod_cleanup \fI< dir1 > < dir2 >\fR
+Recursively searches specified directories (or /usr/lib/python*/site-packages
+if called with no arguments) removing orphaned bytecode (.pyc/.pyo files with
+no corresponding .py file).
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/python.eclass
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/python.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/repoman.1 b/man/repoman.1
index 9edbce2..8762947 100644
--- a/man/repoman.1
+++ b/man/repoman.1
@@ -41,41 +41,48 @@ Scan current directory tree for QA issues.  If OK, commit via cvs.
 .BR CVS/Entries.IO_error
 While attempting to commit, a CVS/Entries directory wasn't found- either the cvs co is damaged, or permissions block repoman from reading the file.
 .TP
-.BR digest.stray
-Digest files were found that do not have a corresponding ebuild.
+.BR digest.assumed
+Files listed in the digest were not found in your $DISTDIR so the existing 
+digest entries are assumed to be correct.
+.TP
+.BR digest.disjointed
+The digests were not added to cvs when the matching ebuild had already been 
+added.
 .TP
 .BR digest.missing
 Ebuild files were found that do not have a corresponding digest.
 .TP
+.BR digest.notadded
+The digests were found but have not been added to cvs.
+.TP
+.BR digest.stray
+Digest files were found that do not have a corresponding ebuild.
+.TP
+.BR ebuild.disjointed
+The ebuilds were not added to cvs when the matching digest had already been 
+added.
+.TP
 .BR ebuild.invalidname
 The ebuild has a filename that is not-parseable by portage.
 .TP
-.BR ebuild.namenomatch
-The euild has a filename that does not have the same name as the parent directory.
-.TP
 .BR changelog.missing
 The ChangeLog file was not found.
 .TP
+.BR ebuild.namenomatch
+The euild has a filename that does not have the same name as the parent 
+directory.
+.TP
 .BR ebuild.notadded
 The ebuilds were found but have not been added to cvs.
 .TP
-.BR digest.notadded
-The digests were found but have not been added to cvs.
-.TP
-.BR ebuild.disjointed
-The ebuilds were not added to cvs when the matching digest had already been added.
-.TP
-.BR digest.disjointed
-The digests were not added to cvs when the matching ebuild had already been added.
-.TP
-.BR filedir.missing
-The package lacks a files directory.
+.BR file.executable
+The file has the executable bit set, when it's not needed- check is limited to ebuilds, digests, Manifest, ChangeLog, and metadata.xml.
 .TP
 .BR file.size
 The file's size exceeds 20k, current policy is no files over 20k in a packages files directory.
 .TP
-.BR file.executable
-The file has the executable bit set, when it's not needed- check is limited to ebuilds, digests, Manifest, ChangeLog, and metadata.xml.
+.BR filedir.missing
+The package lacks a files directory.
 .TP
 .BR DEPEND.bad
 User-visible ebuilds with bad DEPEND settings (matched against *visible* ebuilds).
@@ -117,4 +124,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "SEE ALSO"
 .BR emerge (1)
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/repoman.1,v 1.7 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/repoman.1,v 1.8 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/rpm.eclass.5 b/man/rpm.eclass.5
index 65ac969..3a26ad4 100644
--- a/man/rpm.eclass.5
+++ b/man/rpm.eclass.5
@@ -1,6 +1,6 @@
 .TH "RPM.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-rpm \- convienence class for extracting RPM's
+rpm.eclass \- convienence class for extracting RPM's
 .SH "DESCRIPTION"
 The \fBrpm\fR eclass exists in order to unpack RPM's for you.  This
 way developers dont have to keep employing their own tricks just to
@@ -34,4 +34,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/rpm.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/rpm.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/ruby.eclass.5 b/man/ruby.eclass.5
new file mode 100644
index 0000000..ae303ba
--- /dev/null
+++ b/man/ruby.eclass.5
@@ -0,0 +1,47 @@
+.TH RUBY.ECLASS 5 "Nov 2004" "Portage 2.0.51" portage
+.SH NAME
+ruby.eclass \- functions to ease installation of Ruby software
+.SH DESCRIPTION
+The \fBruby\fR eclass provides an interface designed to ease the installation
+and integration of Ruby software.
+.SH VARIABLES
+.TP
+.B RUBY = \fI"/usr/bin/ruby"\fR
+Defines the location of the Ruby binary. Defaults to '/usr/bin/ruby'.
+.TP
+.B USE_RUBY = \fI"ruby18"\fR
+Defines a white-space delimited list of supported Ruby versions.  This variable
+can be set to "any" if the ebuild only installs version independant files.
+Possible values for this variable include \fBany\fR, \fBruby16\fR, \fBruby18\fR,
+and \fBruby19\fR.
+.TP
+.B RUBY_ECONF = \fI"--with-foo"\fR
+Defines any extra arguments to pass to econf.
+.TP
+.B PATCHES = \fI"foo.patch *.diff"\fR
+Defines a white-space delimited list of patches that should be applied.  In
+addition to literal filenames, globbing may also be used.
+.SH FUNCTIONS
+.TP
+.B ruby_einstall
+Default einstall that executes standard Ruby installation scripts in addition
+to installing all .rb files into the local Ruby site directory.
+.TP
+.B erubydoc
+Installs documentation, HTML, and examples into /usr/share/doc/\fB${PF}\fR.
+.TP
+.B ruby_src_compile
+Default src_compile that simply executes \fBruby_econf\fR and \fBruby_emake\fR.
+.TP
+.B ruby_src_install
+Default src_install that simply runs \fBruby_einstall\fR and \fBerubydoc\fR.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/ruby.eclass
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ruby.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/ssl-cert.eclass.5 b/man/ssl-cert.eclass.5
index e3218b4..6909d65 100644
--- a/man/ssl-cert.eclass.5
+++ b/man/ssl-cert.eclass.5
@@ -1,6 +1,6 @@
 .TH "SSL-CERT.ECLASS" "5" "Oct 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-ssl-cert \- provides common SSL certificates installation routines
+ssl-cert.eclass \- provides common SSL certificates installation routines
 .SH "DESCRIPTION"
 The \fBssl-cert\fR eclass contains a function used to generate and
 install SSL certificates and related files for testing and initial
@@ -51,4 +51,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Max Kalika <max@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ssl-cert.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ssl-cert.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/stardict.eclass.5 b/man/stardict.eclass.5
index 0f91d69..c5bbf2c 100644
--- a/man/stardict.eclass.5
+++ b/man/stardict.eclass.5
@@ -1,6 +1,6 @@
 .TH "STARDICT.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-startdict \- convienence class to do stardict dictionary installations
+startdict.eclass \- convienence class to do stardict dictionary installations
 .SH "DESCRIPTION"
 The \fBstartdict\fR eclass contains appropriate variables and functions
 to quickly make ebuild's for stardictionaries.  The eclass will define
@@ -31,4 +31,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/stardict.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/stardict.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/subversion.eclass.5 b/man/subversion.eclass.5
new file mode 100644
index 0000000..6645684
--- /dev/null
+++ b/man/subversion.eclass.5
@@ -0,0 +1,59 @@
+.TH SUBVERSION.ECLASS 5 "Nov 2004" "Portage 2.0.51" portage
+.SH NAME
+subversion.eclass \- provides subversion fetching functions
+.SH DESCRIPTION
+The \fBsubversion\fR eclass provides functions that enable the ebuild author
+to create 'live' ebuilds that fetch the program's sources from a subversion
+repository.
+.br
+
+\fBNOTE\fR: At the very minimum, the \fBsubversion\fR eclass requires the
+\fBESVN_REPO_URI\fR variable to be set (see below).
+.SH VARIABLES
+.TP
+.B "ESVN_REPO_URI" = \fI"svn://foo/bar/trunk"\fR
+This variable sets the URI from which the sources will be fetched.  The
+\fBsubversion\fR eclass supports fetching from the following protocols:
+\fIhttp\fR, \fIhttps\fR, and \fIsvn\fR.  This variable is required to be set.
+.TP
+.B "ESVN_STORE_DIR" = \fI"${DISTDIR}/svn-src"\fB
+This variable defines the location in which the fetched sources will be kept.
+The default value is '${DISTDIR}/svn-src' and should be sufficient in most
+cases.
+.TP
+.B "ESVN_FETCH_CMD" = \fI"svn checkout"\fB
+This variable defines the command used for initial checkout and defaults to 'svn checkout'.
+.TP
+.B "ESVN_UPDATE_CMD" = \fI"svn update"\fB
+This variable defines the command used for updating sources and defaults to 'svn update'.
+.TP
+.B "ESVN_PROJECT" = \fI"foobar"\fB
+This variable defines the name of the project and defaults to '${PN/-svn}'.
+.TP
+.B "ESVN_BOOTSTRAP" = \fI"autogen.sh"\fB
+This variable defines the name of the bootstrap script to execute in
+preparation for the build process.  This variable is empty by default.  Note:
+"./" is automatically prepended, so it is unnecessary for the ebuild author to
+do so.
+.TP
+.B "ESVN_PATCHES" = \fI"foo.patch *.diff"\fB
+This variable defines a list of patches to apply prior to fetching the sources.
+In addition to literal filenames, you may also use globbing such as *.diff.
+This variable is empty by default.
+.SH FUNCTIONS
+.TP
+.B subversion_src_unpack
+The default \fBsrc_unpack\fR provided by the \fBsubversion\fR eclass simply
+fetches the program's sources from the URI specified by \fBESVN_REPO_URI\fR,
+applies any patches specified by \fBESVN_PATCHES\fR, and then executes the
+bootstrap script specified by \fBESVN_BOOTSTRAP\fR.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/subversion.eclass
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header $
diff --git a/man/tla.eclass.5 b/man/tla.eclass.5
new file mode 100644
index 0000000..53c1854
--- /dev/null
+++ b/man/tla.eclass.5
@@ -0,0 +1,52 @@
+.TH TLA.ECLASS 5 "Nov 2004" "Portage 2.0.51" portage
+.SH NAME
+tla.eclass \- provides generic tla fetching functions
+.SH DESCRIPTION
+The \fBtla\fR eclass provides an interface to easily allow ebuild authors to
+create 'live' tla ebuilds that fetch their sources from a tla repository.
+.SH VARIABLES
+.TP
+.B ETLA_TLA_CMD = \fI"tla"\fR
+Defines tla executable.  Defaults to 'tla'.
+.TP
+.B ETLA_GET_CMD = \fI"get"\fR
+Defines tla get option.  Defaults to 'get'.
+.TP
+.B ETLA_UPDATE_CMD = \fI"replay"\fR
+Defines tla update option.  Defaults to 'replay'.
+.TP
+.B ETLA_TOP_DIR = \fI"${DISTDIR}/tla-src"\fR
+Defines location where fetched sources will be kept.  Defaults to '${DISTDIR}/tla-src'.
+.TP
+.B ETLA_VERSION = \fI"foo@bar.com--archive-name/category--branch--version"\fR
+Defines tla version in the above format.  This variable will be passed as the
+argument to a tla subcommand such as get, replay, etc.
+.TP
+.B ETLA_CACHE_DIR = \fI"${ELTA_VERSION}"\fR
+Defines the location where the version shall be cached.  This location is
+relative to \fBETLA_TOP_DIR\fR.  Defaults to '\fBETLA_VERSION\fR'.
+.TP
+.B ETLA_ARCHIVES
+Defines a whitespace-delimited list of significant archive URI's.  This variable
+should at least include the URI of the archive that the wanted version is stored
+in.
+.TP
+.B ETLA_CLEAN
+Defines whether or not to fetch a clean copy of sources if there is already a
+working copy available.  If set, the working copy will be removed and a fresh
+copy will be fetched.  Otherwise, the working copy will just be updated (via
+\fBETLA_UPDATE_CMD\fR).  This variable is unset by default.
+.SH FUNCTIONS
+.TP
+.B tla_src_unpack
+Default src_unpack that fetches the sources and places them in \fB${WORKDIR}\fR/\fB${P}\fR.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/tla.eclass
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/tla.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/toolchain-funcs.eclass.5 b/man/toolchain-funcs.eclass.5
index de72acd..0255e9a 100644
--- a/man/toolchain-funcs.eclass.5
+++ b/man/toolchain-funcs.eclass.5
@@ -1,13 +1,13 @@
 .TH "TOOLCHAIN-FUNCS.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-toolchain-funcs \- functions to get commonly needed info about the 
+toolchain-funcs.eclass \- functions to get commonly needed info about the 
 toolchain (binutils/gcc/glibc/etc...)
 .SH "DESCRIPTION"
 The \fBtoolchain-funcs\fR eclass contains a suite of functions that are 
 used to glean information about the toolchain that is used to compile.  
-This allows developers to worry about gcc specs rather than figuring
+This allows developers to worry about gcc specs rather than figuring 
 out how to find the specs in the first place.
-.SH "FUNCTIONS"
+.SH "TOOL FUNCTIONS"
 .TP
 .B tc-getAR
 Returns the name of the binutils archiver.  Usually 'ar'.
@@ -26,6 +26,12 @@ Returns the name of the C compiler binary.  Usually 'gcc'.
 .B tc-getCXX
 Returns the name of the C++ compiler binary.  Usually 'g++'.
 .TP
+.B tc-getF77
+Returns the name of the fortran compiler.
+.TP
+.B tc-getGCJ
+Returns the name of the java compiler.  Usually 'gcj'.
+.TP
 .B tc-getLD
 Returns the name of the linker.  Usually 'ld'.
 .TP
@@ -34,6 +40,31 @@ Returns the name of the symbol/object thingy.  Usually 'nm'.
 .TP
 .B tc-getRANLIB
 Returns the name of the archiver indexer.  Usually 'ranlib'.
+.SH "MISC FUNCTIONS"
+.TP
+\fBtc-arch\fR [\fITARGET\fR]
+Echo the portage $ARCH that the current toolchain represents.  
+Basically this is a drop-in replacment for $ARCH usage.  If no 
+\fITARGET\fR is specified, then CHOST will be used.
+.TP
+\fBtc-arch-kernel\fR [\fITARGET\fR]
+Echo the kernel $ARCH that the current toolchain represents.  If no 
+\fITARGET\fR is specified, then CHOST will be used.
+.TP
+\fBtc-endian\fR [\fITARGET\fR]
+Echo 'little' or 'big' based upon what the current toolchain represents.  
+If no \fITARGET\fR is specified, then CHOST will be used.
+.TP
+\fBtc-export\fR <\fBlist of variables\fR>
+Quickly export \fBlist of variables\fR to the environment.  Much easier 
+than exporting each idividual variable at a time.
+
+For example: \fBtc-export\fR CC CXX AR RANLIB
+.TP
+.B tc-is-cross-compiler
+Return shell true/false based upon whether the current building 
+setup is for a cross compiler.
+.SH "VERSION FUNCTIONS"
 .TP
 .B gcc-fullversion
 Returns the version as by `$CC -dumpversion`.
@@ -78,4 +109,4 @@ Please report bugs via http://bugs.gentoo.org/
 .SH "AUTHORS"
 Mike Frysinger <vapier@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/toolchain-funcs.eclass.5,v 1.1 2004/10/21 00:56:56 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/toolchain-funcs.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/versionator.eclass.5 b/man/versionator.eclass.5
new file mode 100644
index 0000000..7b75a24
--- /dev/null
+++ b/man/versionator.eclass.5
@@ -0,0 +1,53 @@
+.TH VERSIONATOR.ECLASS 5 "Nov 2004" "Portage 2.0.51" portage
+.SH NAME
+versionator.eclass \- provides functions for easy manipulation of versions
+.SH DESCRIPTION
+The \fBversionator\fR eclass provides functions to ease manipulation of
+software versions.  The most common use of this eclass is for manipulation of
+the \fB${PV}\fR variable (and saving the result in a variable such as
+\fB${MY_PV}\fR).
+.SH FUNCTIONS
+\fBNOTE\fR: the following functions all operate on a version string (denoted
+as \fIPV\fR in this manual page), which defaults to \fB${PV}\fR if omitted.
+See the eclass for example version strings and their respective results.
+.TP
+.B get_all_version_components \fI< PV >\fR
+Splits PV into its component parts.
+.TP
+.B get_version_components \fI< PV >\fR
+Splits PV into its component parts, ignoring '.', '-', and '_'.
+.TP
+.B get_major_version \fI< PV >\fR
+Retrieves major version from PV.
+.TP
+.B get_version_component_range \fI[ RANGE ] < PV >\fR
+Retrieves a component or range of components, RANGE, from PV.  RANGE may be
+a single number for a particular component, a range such as 1-2 for a range
+of components, or a range such as 2- for that component and everything after it.
+.TP
+.B get_after_major_version \fI< PV >\fR
+Retrieves everything after the major version and its separator (if present).
+.TP
+.B replace_version_separator \fI[ N ] [ SEP ] < PV >\fR
+Replaces the Nth separator of PV with separator, SEP.  If N is a character
+literal (eg. '-'), the first separator of this kind is replaced.
+.TP
+.B replace_all_version_separators \fI[ SEP ] < PV >\fR
+Replaces all version separators in PV with separator, SEP.
+.TP
+.B delete_version_separator \fI[ N ] < PV >\fR
+Deletes the Nth separator of PV.  If N is a character literal (eg. '-'), the first
+separator of this kind is deleted.
+.TP
+.B delete_all_version_separators \fI<PV>\fR
+Deletes all version separators in PV.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.BR /usr/portage/eclass/versionator.eclass
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/versionator.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/vim-plugin.eclass.5 b/man/vim-plugin.eclass.5
new file mode 100644
index 0000000..2f80258
--- /dev/null
+++ b/man/vim-plugin.eclass.5
@@ -0,0 +1,86 @@
+.TH VIM-PLUGIN.ECLASS 5 "Dec 2004" "Portage 2.0.51" portage
+.SH NAME
+vim-plugin.eclass \- functions to ease installation of Vim plugins
+.SH DESCRIPTION
+The \fBvim-plugin\fR eclass provides functions meant to simplify the
+installation of Vim plugins into a version-independent directory,
+/usr/share/vim/vimfiles.
+.SH VARIABLES
+.TP
+.B VIM_PLUGIN_HELPFILES
+Defines a white-space delimited list of help files, used soley for informing
+the user how to access them within Vim.
+.TP
+.B VIM_PLUGIN_HELPTEXT
+Defines help text to display.  Used only if \fBVIM_PLUGIN_HELPFILES\fR is unset.
+.TP
+.B VIM_PLUGIN_HELPURI
+Defines a URI where on-line plugin documentation is available.  This variable
+is only used if \fBVIM_PLUGIN_HELPFILES\fR and \fBVIM_PLUGIN_HELPTEXT\fR are
+unset.
+.TP
+.B VIM_PLUGIN_MESSAGES
+Defines a white-space delimited list of settings that the Vim plugin makes use
+of.  Currently, only 'filetype' is supported; any other specified settings will
+be ignored.
+.SH FUNCTIONS
+.TP
+.B update_vim_afterscripts
+Creates scripts in /usr/share/vim/vimfiles/after that are comprised of the
+snippets located in /usr/share/vim/vimfiles/after/*/*.vim.d. In addition,
+any stale scripts that were previously generated by this function are removed.
+.TP
+.B display_vim_plugin_help
+Displays a message containing plugin help information. This function checks
+the variables \fBVIM_PLUGIN_HELPFILES\fR, \fBVIM_PLUGIN_HELPTEXT\fR, and
+\fBVIM_PLUGIN_HELPURI\fR (in that order) and displays the first one that is
+defined.  In addition, any setting-specific messages that correspond to
+settings listed in \fBVIM_PLUGIN_MESSAGES\fR will be displayed.
+.TP
+.B vim-plugin_src_install
+Default src_install.  Installs plugin documentation prior to installing the
+entire contents of \fB${S}\fR to /usr/share/vim/vimfiles.
+.TP
+.B vim-plugin_pkg_postinst
+Default pkg_postinst that updates Vim helptags (see \fBupdate_vim_helptags\fR
+in vim-doc.eclass), updates after scripts, and calls \fBdisplay_vim_plugin_help\fR.
+.TP
+.B vim-plugin_pkg_postrm
+Default pkg_postrm that updates Vim helptags (see \fBupdate_vim_helptags\fR
+in vim-doc.eclass), updates after scripts, and removes any empty directories
+in /usr/share/vim/vimfiles.
+.SH PACKAGING
+In general, tarballs for plugins cannot be used directly because of vim.org's
+idiosyncratic download system. Instead, a Gentoo-specific tarball must be made
+with the following format for contents:
+
+.nf
+    packagename-version/
+    packagename-version/doc/
+    packagename-version/doc/whatever.txt
+    packagename-version/plugin/
+    packagename-version/plugin/whatever.vim
+    packagename-version/syntax/
+    packagename-version/syntax/whatever.vim
+.fi
+.SH PACKAGE NAMING CONVENTIONS
+Where possible, the upstream script name should be used as the package name.
+For packages which provide syntax or filetype files, the name should be suffixed
+with "-syntax" (for example, "app-vim/gentoo-syntax", "app-vim/fluxbox-syntax", 
+"app-vim/selinux-syntax").
+.SH PACKAGE VARIABLE CONVENTIONS
+The canonical form for the HOMEPAGE variable for vim.org scripts is 
+http://www.vim.org/scripts/script.php?script_id=123.
+.SH REPORTING BUGS
+Please report bugs via http://bugs.gentoo.org/
+.SH SEE ALSO
+.BR ebuild (5)
+.SH FILES
+.nf
+.B /usr/portage/eclass/vim-plugin.eclass  
+.B /usr/portage/eclass/vim-doc.eclass
+.fi
+.SH AUTHORS
+Aaron Walker <ka0ttic@gentoo.org>
+.SH CVS HEADER
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/vim-plugin.eclass.5,v 1.2 2005/02/10 01:37:36 vapier Exp $
diff --git a/man/vim.eclass.5 b/man/vim.eclass.5
index f1ef4d5..3e4d143 100644
--- a/man/vim.eclass.5
+++ b/man/vim.eclass.5
@@ -1,6 +1,6 @@
 .TH "VIM.ECLASS" "5" "Jun 2003" "Portage 2.0.51" "portage"
 .SH "NAME"
-vim \- common build routines for vim-core, vim and gvim
+vim.eclass \- common build routines for vim-core, vim and gvim
 .SH "DESCRIPTION"
 The \fBvim\fR eclass contains a suite of functions that are used to
 build \fBvim-core\fR, \fBvim\fR and \fBgvim\fR.  The vim-core ebuild
@@ -53,4 +53,4 @@ Ryan Phillips <rphillips@gentoo.org>
 .br
 Seemant Kulleen <seemant@gentoo.org>
 .SH "CVS HEADER"
-$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/vim.eclass.5,v 1.3 2004/09/17 00:17:10 vapier Exp $
+$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/vim.eclass.5,v 1.4 2005/02/10 01:37:36 vapier Exp $