|
Lines 170-175
Link Here
|
| 170 |
packages is to use \fBquickpkg\fR which creates a tbz2 from the |
170 |
packages is to use \fBquickpkg\fR which creates a tbz2 from the |
| 171 |
live filesystem. |
171 |
live filesystem. |
| 172 |
.TP |
172 |
.TP |
|
|
173 |
\fB\-\-buildpkgonly\fR (\fB\-B\fR) |
| 174 |
Creates binary a binary package, but does not merge it to the system. This |
| 175 |
has the restriction that unsatisfied dependencies must not exist for the |
| 176 |
desired package as they cannot be used if they do not exist on the system. |
| 177 |
.TP |
| 178 |
\fB\-\-changelog\fR (\fB\-l\fR) |
| 179 |
When pretending, also display the ChangeLog entries for packages that will |
| 180 |
be upgraded. |
| 181 |
.TP |
| 173 |
\fB\-\-columns\fR |
182 |
\fB\-\-columns\fR |
| 174 |
Used along side \fI--pretend\fR to causes the package, new version, |
183 |
Used along side \fI--pretend\fR to causes the package, new version, |
| 175 |
and old version to be displayed in an aligned format for easy cut\-n\-paste. |
184 |
and old version to be displayed in an aligned format for easy cut\-n\-paste. |
|
Lines 180-186
Link Here
|
| 180 |
causing it to output verbose debug information to stdout. |
189 |
causing it to output verbose debug information to stdout. |
| 181 |
\-\-debug is great for finding bash syntax errors. |
190 |
\-\-debug is great for finding bash syntax errors. |
| 182 |
.TP |
191 |
.TP |
| 183 |
\fB\-\-deep\fR |
192 |
\fB\-\-deep\fR (\fB\-D\fR) |
| 184 |
When used in conjunction with \fB\-\-update\fR, this flag forces |
193 |
When used in conjunction with \fB\-\-update\fR, this flag forces |
| 185 |
\fBemerge\fR to consider the entire dependency tree of packages, |
194 |
\fBemerge\fR to consider the entire dependency tree of packages, |
| 186 |
instead of checking only the immediate dependencies of the packages. |
195 |
instead of checking only the immediate dependencies of the packages. |
|
Lines 204-210
Link Here
|
| 204 |
dealing with the same config multiple times. This flag will cause the |
213 |
dealing with the same config multiple times. This flag will cause the |
| 205 |
file to always be merged. |
214 |
file to always be merged. |
| 206 |
.TP |
215 |
.TP |
| 207 |
\fB\-\-nodeps\fR |
216 |
\fB\-\-nodeps\fR (\fB\-O\fR) |
| 208 |
Merges specified packages without merging any dependencies. Note that |
217 |
Merges specified packages without merging any dependencies. Note that |
| 209 |
the build may fail if the dependencies aren't satisfied. |
218 |
the build may fail if the dependencies aren't satisfied. |
| 210 |
.TP |
219 |
.TP |
|
Lines 234-254
Link Here
|
| 234 |
the printout, N = new, U = upgrading, R = replacing, B = blocked by |
243 |
the printout, N = new, U = upgrading, R = replacing, B = blocked by |
| 235 |
an already installed package. |
244 |
an already installed package. |
| 236 |
.TP |
245 |
.TP |
|
|
246 |
\fB\-\-quiet\fR (\fB\-q\fR) |
| 247 |
Effects vary, but the general outcome is a reduced or condensed output from |
| 248 |
portage's displays. |
| 249 |
.TP |
| 250 |
\fB\-\-resume\fR |
| 251 |
Resumes the last merge operation. Can be treated just like a regular merge |
| 252 |
as --pretend and other options work along side. 'emerge --resume' only |
| 253 |
returns an error on failure. Nothing to do exits with a message and a |
| 254 |
success condition. |
| 255 |
.TP |
| 237 |
\fB\-\-searchdesc\fR (\fB\-S\fR) |
256 |
\fB\-\-searchdesc\fR (\fB\-S\fR) |
| 238 |
Matches the search string against the description field as well as |
257 |
Matches the search string against the description field as well as |
| 239 |
the package name. \fBTake caution\fR as the descriptions are also |
258 |
the package name. \fBTake caution\fR as the descriptions are also |
| 240 |
matched as regular expressions. |
259 |
matched as regular expressions. |
| 241 |
.TP |
260 |
.TP |
|
|
261 |
\fB\-\-skipfirst\fR (\fB\-u\fR) |
| 262 |
This option is only valid in a resume situation. It removes the first |
| 263 |
package in the resume list so that a merge may continue in the presence of |
| 264 |
an uncorrectable or inconsequential error. This should only be used in cases |
| 265 |
where skipping the package will not result in failed dependencies. |
| 266 |
.TP |
| 242 |
\fB\-\-update\fR (\fB\-u\fR) |
267 |
\fB\-\-update\fR (\fB\-u\fR) |
| 243 |
Updates packages to the most recent version available. \fBNote that\fR \-\-update \fBdoes not have full functionality yet\fR. It will not automatically update dependencies of packages in the \fBworld\fR file, unless they too are in the \fBworld\fR file. |
268 |
Updates packages to the most recent version available. \fBNote that\fR \-\-update \fBdoes not have full functionality yet\fR. It will not automatically update dependencies of packages in the \fBworld\fR file, unless they too are in the \fBworld\fR file. |
| 244 |
.TP |
269 |
.TP |
|
|
270 |
\fB\-\-upgradeonly\fR (\fB\-U\fR) |
| 271 |
Updates packages, but excludes updates that would result in a lower version of the package being installed. SLOTs are considered at a basic level. |
| 272 |
.TP |
| 245 |
\fB\-\-usepkg\fR (\fB\-k\fR) |
273 |
\fB\-\-usepkg\fR (\fB\-k\fR) |
| 246 |
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. |
274 |
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. |
| 247 |
.TP |
275 |
.TP |
|
|
276 |
\fB\-\-usepkgonly\fR (\fB\-K\fR) |
| 277 |
Like --usepkg above, except this only allows the use of binary packages, and |
| 278 |
it will abort the emerge if the package is not available at the time of |
| 279 |
dependency calculation. |
| 280 |
.TP |
| 248 |
\fB\-\-verbose\fR (\fB\-v\fR) |
281 |
\fB\-\-verbose\fR (\fB\-v\fR) |
| 249 |
Tell emerge to run in verbose mode. Currently this flag causes emerge to print out GNU info errors, if any. |
282 |
Tell emerge to run in verbose mode. Currently this flag causes emerge to print out GNU info errors, if any. |
| 250 |
.TP |
283 |
.TP |
| 251 |
\fB\-\-version\fR |
284 |
\fB\-\-version\fR (\fB\-V\fR) |
| 252 |
Displays the version number of \fBemerge\fR. It cannot be used in |
285 |
Displays the version number of \fBemerge\fR. It cannot be used in |
| 253 |
conjunction with other options; the name and format of the action |
286 |
conjunction with other options; the name and format of the action |
| 254 |
is a convention. |
287 |
is a convention. |
