clean binutils\fR cleans out old versions of binutils;

clean binutils\fR cleans out old versions of binutils;

\fBemerge clean net\-www/mozilla\-0.9.9\-r2\fR cleans out that

\fBemerge clean net\-www/mozilla\-0.9.9\-r2\fR cleans out that

specific version of Mozilla.  This is generally safe to use.

specific version of Mozilla.  This is generally safe to use.

.TP

.TP

\fBdepclean\fR

\fBdepclean\fR

Determines all packages installed on the system that have no

Determines all packages installed on the system that have no

\fBsync\fR

\fBsync\fR

Initiates a portage tree update with one of the rsync.gentoo.org

Initiates a portage tree update with one of the rsync.gentoo.org

mirrors.  \fBNote that any changes you have made to the portage

mirrors.  \fBNote that any changes you have made to the portage

this uses \fBrsync\fR to do the update. See make.conf's description

this uses \fBrsync\fR to do the update. See make.conf's description

of PORTDIR_OVERLAY for a method to avoid deletions.

of PORTDIR_OVERLAY for a method to avoid deletions.

.TP

.TP

\fI${PKGDIR}\fR/All directory.

\fI${PKGDIR}\fR/All directory.

.TP

.TP

\fB\-\-columns\fR

\fB\-\-columns\fR

and old version to be displayed in an aligned format for easy cut\-n\-paste.

and old version to be displayed in an aligned format for easy cut\-n\-paste.

.TP

.TP

\fB\-\-debug\fR (\fB\-d\fR)

\fB\-\-debug\fR (\fB\-d\fR)

\fB\-\-emptytree\fR (\fB\-e\fR)

\fB\-\-emptytree\fR (\fB\-e\fR)

Virtually tweaks the tree of installed packages to only contain glibc;

Virtually tweaks the tree of installed packages to only contain glibc;

this is great to use together with \-\-pretend. This allows developers

this is great to use together with \-\-pretend. This allows developers

and it enables complete trees to be rebuilt using the latest libraries.

and it enables complete trees to be rebuilt using the latest libraries.

.TP

.TP

\fB\-\-fetchonly\fR (\fB\-f\fR)

\fB\-\-fetchonly\fR (\fB\-f\fR)

Instead of doing any package building, just perform fetches for all

Instead of doing any package building, just perform fetches for all

.TP

.TP

\fB\-\-noconfmem\fR

\fB\-\-noconfmem\fR

Causes portage to disregard merge records indicating that a config file

Causes portage to disregard merge records indicating that a config file

the build may fail if the dependencies aren't satisfied.

the build may fail if the dependencies aren't satisfied.

.TP

.TP

\fB\-\-noreplace\fR (\fB\-n\fR)

\fB\-\-noreplace\fR (\fB\-n\fR)

you specify on on the command\-line *will* cause Portage to remerge

you specify on on the command\-line *will* cause Portage to remerge

the package, even if it is already installed. Note that Portage will

the package, even if it is already installed. Note that Portage will

not remerge dependencies by default.

not remerge dependencies by default.

for later updating.

for later updating.

.TP

.TP

\fB\-\-onlydeps\fR (\fB\-o\fR)

\fB\-\-onlydeps\fR (\fB\-o\fR)

.TP

.TP

\fB\-\-pretend\fR (\fB\-p\fR)

\fB\-\-pretend\fR (\fB\-p\fR)

Instead of actually performing the merge, simply display what *would*

Instead of actually performing the merge, simply display what *would*

have been installed if \-\-pretend weren't used.  Using \-\-pretend

have been installed if \-\-pretend weren't used.  Using \-\-pretend

is strongly recommended before installing an unfamiliar package. In

is strongly recommended before installing an unfamiliar package. In

the printout, N = new, U = upgrading, R = replacing, B = blocked by

the printout, N = new, U = upgrading, R = replacing, B = blocked by

.TP

.TP

\fB\-\-searchdesc\fR (\fB\-S\fR)

\fB\-\-searchdesc\fR (\fB\-S\fR)

Matches the search string against the description field as well as

Matches the search string against the description field as well as

matched as regular expressions.

matched as regular expressions.

.TP

.TP

\fB\-\-update\fR (\fB\-u\fR)

\fB\-\-update\fR (\fB\-u\fR)

.TP

.TP

\fB\-\-usepkg\fR (\fB\-k\fR) 

\fB\-\-usepkg\fR (\fB\-k\fR) 

Tells emerge to use binary packages (from $PKGDIR) if they are available, thus possibly avoiding some time\-consuming compiles. This option is useful for CD installs; you can export PKGDIR=/mnt/cdrom/packages and then use this option to have emerge "pull" binary packages from the CD in order to satisfy dependencies.

Tells emerge to use binary packages (from $PKGDIR) if they are available, thus possibly avoiding some time\-consuming compiles. This option is useful for CD installs; you can export PKGDIR=/mnt/cdrom/packages and then use this option to have emerge "pull" binary packages from the CD in order to satisfy dependencies.

.TP

.TP

\fB\-\-verbose\fR (\fB\-v\fR)

\fB\-\-verbose\fR (\fB\-v\fR)

.TP

.TP

\fB\-\-version\fR

\fB\-\-version\fR

Displays the version number of \fBemerge\fR.  It cannot be used in

Displays the version number of \fBemerge\fR.  It cannot be used in

is a convention.

is a convention.

.SH "OUTPUT"

.SH "OUTPUT"

While utilizing emerge and the pretend/verbose flags, the output

While utilizing emerge and the pretend/verbose flags, the output

exists to explain what the shorthanded information means.

exists to explain what the shorthanded information means.

.TP

.TP

.B [blocks B     ] app-text/dos2unix (from pkg app-text/hd2u-0.8.0)

.B [blocks B     ] app-text/dos2unix (from pkg app-text/hd2u-0.8.0)

we see that nmap can use the \fBUSE\fR variables gtk and gnome, but that your current

we see that nmap can use the \fBUSE\fR variables gtk and gnome, but that your current

settings have gtk and gnome disabled.  So optional support for gtk and gnome will

settings have gtk and gnome disabled.  So optional support for gtk and gnome will

not be enabled in nmap when you emerge it.

not be enabled in nmap when you emerge it.

.SH "NOTES"

.SH "NOTES"

You should almost always precede any package install or update

You should almost always precede any package install or update

attempt with a \fB\-\-pretend\fR install or update.  This lets

attempt with a \fB\-\-pretend\fR install or update.  This lets

update a large number of packages if the portage tree has

update a large number of packages if the portage tree has

been particularly active.

been particularly active.

.LP 

.LP 

When you install a package with uninstalled dependencies and do

When you install a package with uninstalled dependencies and do

not explicitly state those dependencies in the list of parameters,

not explicitly state those dependencies in the list of parameters,

they will not be added to the world file.  If you want them to be

they will not be added to the world file.  If you want them to be

flags specified on the command line are NOT remembered\fR.  For

flags specified on the command line are NOT remembered\fR.  For

example, \fBUSE="\-x \-gnome" emerge mc\fR will emerge mc with

example, \fBUSE="\-x \-gnome" emerge mc\fR will emerge mc with

those USE settings.

those USE settings.

.SH "MASKED PACKAGES"

.SH "MASKED PACKAGES"

\fINOTE: Please use caution when using development packages. Problems

\fINOTE: Please use caution when using development packages. Problems

and bugs resulting from misusing masked packages drains Gentoo

and bugs resulting from misusing masked packages drains Gentoo

edit this file\fR.

edit this file\fR.

.TP

.TP

\fB/etc/make.profile/use.defaults\fR

\fB/etc/make.profile/use.defaults\fR

.TP

.TP

\fB/usr/portage/profiles/use.desc\fR 

\fB/usr/portage/profiles/use.desc\fR 

Contains the master list of USE flags with descriptions of their

Contains the master list of USE flags with descriptions of their