diff options
author | Zac Medico <zmedico@gentoo.org> | 2011-12-07 11:20:39 -0800 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2011-12-07 11:20:39 -0800 |
commit | c93a46851c43f7e8539a67b2376dc8f55af41789 (patch) | |
tree | 5713a69b9ca881eddf4aa405ab492056c1b68f09 | |
parent | 97bb245fd38673d562ade9b4b23d3ec95f167045 (diff) | |
download | portage-c93a46851c43f7e8539a67b2376dc8f55af41789.tar.gz portage-c93a46851c43f7e8539a67b2376dc8f55af41789.tar.bz2 portage-c93a46851c43f7e8539a67b2376dc8f55af41789.zip |
man: document fixpackages for bug #393517
-rw-r--r-- | man/emerge.1 | 21 | ||||
-rw-r--r-- | man/fixpackages.1 | 15 |
2 files changed, 31 insertions, 5 deletions
diff --git a/man/emerge.1 b/man/emerge.1 index 0329e20ff..b4da69cf9 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 000000000..31683278d --- /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) |