Add --nousepkg-atoms, --useoldpkg-atoms and --reinstall-atoms flag to Portage

man/emerge.1

 .TH "EMERGE" "1" "Nov 2010" "Portage VERSION" "Portage"
 .SH "NAME"
 emerge \- Command\-line interface to the Portage system
 .SH "SYNOPSIS"
 .TP
 .BR emerge
 [\fIoptions\fR] [\fIaction\fR] [\fIebuild\fR | \fItbz2file\fR | \fIfile\fR | \fI@set\fR | \fIatom\fR] ...
 .TP
 .BR emerge
 \fB\-\-sync\fR | \fB\-\-version\fR
@@ skipping 446 matching lines @@
 the package, even if it is already installed.  Note that Portage will
 not remerge dependencies by default. Also note that this option takes
 precedence over options such as \fB\-\-newuse\fR, preventing a package
 from being reinstalled even though the corresponding USE flag settings
 may have changed.
 .TP
 .BR "\-\-nospinner"
 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 "\-\-nousepkg\-atoms " ATOMS
+A space separated list of package names or slot atoms. Emerge will ignore
+matching binary packages.
+.TP
 .BR "\-\-oneshot " (\fB\-1\fR)
 Emerge as normal, but do not add the packages to the world file
 for later updating.
 .TP
 .BR "\-\-onlydeps " (\fB\-o\fR)
 Only merge (or pretend to merge) the dependencies of the packages
 specified, not the packages themselves.
 .TP
 .BR "\-\-package\-moves [ y | n ]"
 Perform package moves when necessary. This option
@@ skipping 50 matching lines @@
 have a BUILD_TIME that is larger than the given TIMESTAMP
 and that is larger than that of the installed package will
 be considered by the rebuilt\-binaries logic.
 .TP
 .BR "\-\-reinstall changed\-use"
 Tells emerge to include installed packages where USE flags have
 changed since installation.  Unlike \fB\-\-newuse\fR, this option does
 not trigger reinstallation when flags that the user has not
 enabled are added or removed.
 .TP
+.BR "\-\-reinstall\-atoms " ATOMS
+A space separated list of package names or slot atoms. Emerge will treat
+matching packages as if they are not installed, and reinstall them if
+necessary.
+.TP
 .BR \-\-root=DIR
 Set the \fBROOT\fR environment variable.
 .TP
 .BR "\-\-root\-deps[=rdeps]"
 If no argument is given then build\-time dependencies of packages for
 \fBROOT\fR are installed to
 \fBROOT\fR instead of /. If the \fBrdeps\fR argument is given then discard
 all build\-time dependencies of packages for \fBROOT\fR. This option is
 only meaningful when used together with \fBROOT\fR and it should not
 be enabled under normal circumstances. For currently supported
@@ skipping 37 matching lines @@
 Updates packages to the best version available, which may
 not always be the  highest version number due to masking
 for testing and development. Package atoms specified on
 the command line are greedy, meaning that unspecific
 atoms may match multiple versions of slotted packages.
 .TP
 .BR "\-\-use\-ebuild\-visibility [ y | n ]"
 Use unbuilt ebuild metadata for visibility
 checks on built packages.
 .TP
+.BR "\-\-useoldpkg\-atoms " ATOMS
+A space separated list of package names or slot atoms. Emerge will prefer
+matching binary packages over newer unbuilt packages.
+.TP
 .BR "\-\-usepkg [ y | n ] (\-k short option)"
 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
 .BR "\-\-usepkgonly [ y | n ] (\-K short option)"
 Tells emerge to only use binary packages (from $PKGDIR).  All the binary 
 packages must be available at the time of dependency calculation or emerge 
 will simply abort.  Portage does not use $PORTDIR when calculating dependency 
@@ skipping 301 matching lines @@
 .BR ebuild (1),
 .BR ebuild (5),
 .BR make.conf (5),
 .BR color.map (5),
 .BR portage (5)
 .LP
 A number of helper applications reside in \fI/usr/lib/portage/bin\fR.
 .LP
 The \fBapp\-portage/gentoolkit\fR package contains useful scripts such as 
 \fBequery\fR (a package query tool).