|author||Zac Medico||2011-12-07 19:20:39 (GMT)|
|committer||Zac Medico||2011-12-07 19:20:39 (GMT)|
man: document fixpackages for bug #393517
2 files changed, 31 insertions, 5 deletions
diff --git a/man/emerge.1 b/man/emerge.1
index 0329e20..b4da69c 100644
@@ -1,4 +1,4 @@
-.TH "EMERGE" "1" "Oct 2011" "Portage VERSION" "Portage"
+.TH "EMERGE" "1" "Dec 2011" "Portage VERSION" "Portage"
emerge \- Command\-line interface to the Portage system
@@ -427,8 +427,8 @@ are modified. This option is enabled by default.
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)).
@@ -561,11 +561,22 @@ Only merge (or pretend to merge) the dependencies of the packages
specified, not the packages themselves.
.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
+\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.
.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
@@ -0,0 +1,15 @@
+.TH "FIXPACKAGES" "1" "Dec 2011" "Portage VERSION" "Portage"
+fixpackages \- Perform package move updates for all packages
+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/
+Zac Medico <firstname.lastname@example.org>
+.SH "SEE ALSO"
+.BR emaint (1),
+.BR emerge (1)