summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZac Medico2011-12-07 19:20:39 (GMT)
committerZac Medico2011-12-07 19:20:39 (GMT)
commitc93a46851c43f7e8539a67b2376dc8f55af41789 (patch)
tree5713a69b9ca881eddf4aa405ab492056c1b68f09
parent97bb245fd38673d562ade9b4b23d3ec95f167045 (diff)
man: document fixpackages for bug #393517
-rw-r--r--man/emerge.121
-rw-r--r--man/fixpackages.115
2 files changed, 31 insertions, 5 deletions
diff --git a/man/emerge.1 b/man/emerge.1
index 0329e20..b4da69c 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -1,4 +1,4 @@
-.TH "EMERGE" "1" "Oct 2011" "Portage VERSION" "Portage"
+.TH "EMERGE" "1" "Dec 2011" "Portage VERSION" "Portage"
.SH "NAME"
emerge \- Command\-line interface to the Portage system
.SH "SYNOPSIS"
@@ -427,8 +427,8 @@ are modified. This option is enabled by default.
\fBWARNING:\fR
If you want to disable \-\-dynamic\-deps, then it may be necessary to
-first run \fBfixpackages\fR in order to get the best results. The
-\fBfixpackages\fR command performs two different operations that can
+first run \fBfixpackages\fR(1) in order to get the best results. The
+\fBfixpackages\fR(1) command performs two different operations that can
also be performed separately by the `emaint \-\-fix moveinst` and
`emaint \-\-fix movebin` commands (see \fBemaint\fR(1)).
.TP
@@ -561,11 +561,22 @@ 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
-is enabled by default. \fBWARNING:\fR This option
+Perform package moves when necessary. This option is enabled
+by default. Package moves are typically applied immediately
+after a \fB\-\-sync\fR action. They are applied in an
+incremental fashion, using only the subset of the history of
+package moves which have been added or modified since the
+previous application of package moves.
+
+\fBWARNING:\fR This option
should remain enabled under normal circumstances.
Do not disable it unless you know what you are
doing.
+
+\fBNOTE:\fR The \fBfixpackages\fR(1) command can be used to
+exhaustively apply the entire history of package moves,
+regardless of whether or not any of the package moves have
+been previously applied.
.TP
.BR "\-\-pretend " (\fB\-p\fR)
Instead of actually performing the merge, simply display what *would*
diff --git a/man/fixpackages.1 b/man/fixpackages.1
new file mode 100644
index 0000000..3168327
--- /dev/null
+++ b/man/fixpackages.1
@@ -0,0 +1,15 @@
+.TH "FIXPACKAGES" "1" "Dec 2011" "Portage VERSION" "Portage"
+.SH NAME
+fixpackages \- Perform package move updates for all packages
+.SH SYNOPSIS
+\fBfixpackages\fR
+.SH DESCRIPTION
+The fixpackages program performs package move updates on configuration
+files, installed packages, and binary packages.
+.SH "REPORTING BUGS"
+Please report bugs via http://bugs.gentoo.org/
+.SH AUTHORS
+Zac Medico <zmedico@gentoo.org>
+.SH "SEE ALSO"
+.BR emaint (1),
+.BR emerge (1)