|
Lines 99-104
Link Here
|
| 99 |
\fBNote that changes in USE flags can drastically affect the |
99 |
\fBNote that changes in USE flags can drastically affect the |
| 100 |
output of \-\-depclean.\fR |
100 |
output of \-\-depclean.\fR |
| 101 |
.TP |
101 |
.TP |
|
|
102 |
.BR "\-\-help " (\fB\-h\fR) |
| 103 |
Displays help information for emerge. Adding one of the additional |
| 104 |
arguments listed above will give you more specific help information |
| 105 |
on that subject. The internal \fBemerge\fR help documentation is |
| 106 |
updated more frequently than this man page; check it out if you |
| 107 |
are having problems that this man page does not help resolve. |
| 108 |
.TP |
| 102 |
.BR \-\-info |
109 |
.BR \-\-info |
| 103 |
This is a list of information to include in bug reports which aids the |
110 |
This is a list of information to include in bug reports which aids the |
| 104 |
developers with fixing any problems you may report. \fBPlease include this |
111 |
developers with fixing any problems you may report. \fBPlease include this |
|
Lines 135-140
Link Here
|
| 135 |
\fBemerge \-\-metadata\fR to rebuild the cache as portage does at the end of |
142 |
\fBemerge \-\-metadata\fR to rebuild the cache as portage does at the end of |
| 136 |
a sync operation. |
143 |
a sync operation. |
| 137 |
.TP |
144 |
.TP |
|
|
145 |
.BR "\-\-resume" |
| 146 |
Resumes the last merge operation. Please note that this operation |
| 147 |
will only return an error on failure. If there is nothing for portage |
| 148 |
to do, then portage will exit with a message and a success condition. |
| 149 |
.TP |
| 138 |
.BR "\-\-search " (\fB\-s\fR) |
150 |
.BR "\-\-search " (\fB\-s\fR) |
| 139 |
Searches for matches of the supplied string in the portage tree. |
151 |
Searches for matches of the supplied string in the portage tree. |
| 140 |
The \-\-search string is a regular expression. For example, \fBemerge |
152 |
The \-\-search string is a regular expression. For example, \fBemerge |
|
Lines 142-148
Link Here
|
| 142 |
\fBemerge \-\-search "gcc$"\fR searches for any package that ends with |
154 |
\fBemerge \-\-search "gcc$"\fR searches for any package that ends with |
| 143 |
"gcc"; \fBemerge \-\-search "office"\fR searches for any package that |
155 |
"gcc"; \fBemerge \-\-search "office"\fR searches for any package that |
| 144 |
contains the word "office". If you want to search the package |
156 |
contains the word "office". If you want to search the package |
| 145 |
descriptions as well, use the \fB\-\-searchdesc\fR option. |
157 |
descriptions as well, use the \fB\-\-searchdesc\fR action. |
|
|
158 |
.TP |
| 159 |
.BR "\-\-searchdesc " (\fB\-S\fR) |
| 160 |
Matches the search string against the description field as well as |
| 161 |
the package name. \fBTake caution\fR as the descriptions are also |
| 162 |
matched as regular expressions. |
| 146 |
.TP |
163 |
.TP |
| 147 |
.BR \-\-sync |
164 |
.BR \-\-sync |
| 148 |
Initiates a portage tree update with one of the rsync.gentoo.org |
165 |
Initiates a portage tree update with one of the rsync.gentoo.org |
|
Lines 157-162
Link Here
|
| 157 |
it may remove packages necessary for the proper operation of your |
174 |
it may remove packages necessary for the proper operation of your |
| 158 |
system. Its arguments can be \fIebuilds\fR, \fIclasses\fR, or |
175 |
system. Its arguments can be \fIebuilds\fR, \fIclasses\fR, or |
| 159 |
\fIdependencies\fR \-\- see \fB\-\-clean\fR above for examples. |
176 |
\fIdependencies\fR \-\- see \fB\-\-clean\fR above for examples. |
|
|
177 |
.TP |
| 178 |
.BR "\-\-update " (\fB\-u\fR) |
| 179 |
Updates packages to the best version available, which may not |
| 180 |
always be the highest version number due to masking for testing |
| 181 |
and development. This will also update direct dependencies \-\- which |
| 182 |
may not be what you want. In general, use this action only in |
| 183 |
combination with the world or system target. |
| 184 |
.TP |
| 185 |
.BR "\-\-upgradeonly " (\fB\-U\fR) |
| 186 |
Updates packages, but excludes updates that would result in a |
| 187 |
lower version of the package being installed. \fBSLOT\fRs are |
| 188 |
considered at a basic level. |
| 189 |
.br |
| 190 |
This action is deprecated and should not be used anymore. Please use the |
| 191 |
/etc/portage/package.* files instead. |
| 192 |
.TP |
| 193 |
.BR "\-\-version " (\fB\-V\fR) |
| 194 |
Displays the version number of \fBemerge\fR. |
| 160 |
.SH "OPTIONS" |
195 |
.SH "OPTIONS" |
| 161 |
.TP |
196 |
.TP |
| 162 |
.BR "\-\-ask " (\fB\-a\fR) |
197 |
.BR "\-\-ask " (\fB\-a\fR) |
|
Lines 182-188
Link Here
|
| 182 |
dependencies must already be emerged on the system. |
217 |
dependencies must already be emerged on the system. |
| 183 |
.TP |
218 |
.TP |
| 184 |
.BR "\-\-changelog " (\fB\-l\fR) |
219 |
.BR "\-\-changelog " (\fB\-l\fR) |
| 185 |
Use this in conjunction with the \fB\-\-pretend\fR action. This will |
220 |
Use this in conjunction with the \fB\-\-pretend\fR option. This will |
| 186 |
show the ChangeLog entries for all the packages that will be upgraded. |
221 |
show the ChangeLog entries for all the packages that will be upgraded. |
| 187 |
.TP |
222 |
.TP |
| 188 |
.BR "\-\-columns" |
223 |
.BR "\-\-columns" |
|
Lines 229-241
Link Here
|
| 229 |
remote server without consulting packages existing in the local packages |
264 |
remote server without consulting packages existing in the local packages |
| 230 |
directory. |
265 |
directory. |
| 231 |
.TP |
266 |
.TP |
| 232 |
.BR "\-\-help " (\fB\-h\fR) |
|
|
| 233 |
Displays help information for emerge. Adding one of the additional |
| 234 |
arguments listed above will give you more specific help information |
| 235 |
on that subject. The internal \fBemerge\fR help documentation is |
| 236 |
updated more frequently than this man page; check it out if you |
| 237 |
are having problems that this man page does not help resolve. |
| 238 |
.TP |
| 239 |
.BR "\-\-newuse " (\fB\-N\fR) |
267 |
.BR "\-\-newuse " (\fB\-N\fR) |
| 240 |
Tells emerge to include installed packages where USE flags have changed since |
268 |
Tells emerge to include installed packages where USE flags have changed since |
| 241 |
compilation. An asterisk marks when a USE flag has changed since the package |
269 |
compilation. An asterisk marks when a USE flag has changed since the package |
|
Lines 299-316
Link Here
|
| 299 |
Results may vary, but the general outcome is a reduced or condensed |
327 |
Results may vary, but the general outcome is a reduced or condensed |
| 300 |
output from portage's displays. |
328 |
output from portage's displays. |
| 301 |
.TP |
329 |
.TP |
| 302 |
.BR "\-\-resume" |
|
|
| 303 |
Resumes the last merge operation. Please note that this operation |
| 304 |
will only return an error on failure. If there is nothing for portage |
| 305 |
to do, then portage will exit with a message and a success condition. |
| 306 |
.TP |
| 307 |
.BR "\-\-searchdesc " (\fB\-S\fR) |
| 308 |
Matches the search string against the description field as well as |
| 309 |
the package name. \fBTake caution\fR as the descriptions are also |
| 310 |
matched as regular expressions. |
| 311 |
.TP |
| 312 |
.BR "\-\-skipfirst" |
330 |
.BR "\-\-skipfirst" |
| 313 |
This action is only valid when used with \fB\-\-resume\fR. It removes the |
331 |
This option is only valid when used with \fB\-\-resume\fR. It removes the |
| 314 |
first package in the resume list so that a merge may continue in the presence |
332 |
first package in the resume list so that a merge may continue in the presence |
| 315 |
of an uncorrectable or inconsequential error. This should only be used in |
333 |
of an uncorrectable or inconsequential error. This should only be used in |
| 316 |
cases where skipping the package will not result in failed dependencies. |
334 |
cases where skipping the package will not result in failed dependencies. |
|
Lines 320-338
Link Here
|
| 320 |
This is only really useful in combination with \fB\-\-emptytree\fR or |
338 |
This is only really useful in combination with \fB\-\-emptytree\fR or |
| 321 |
\fB\-\-update\fR and \fB\-\-deep\fR. |
339 |
\fB\-\-update\fR and \fB\-\-deep\fR. |
| 322 |
.TP |
340 |
.TP |
| 323 |
.BR "\-\-update " (\fB\-u\fR) |
|
|
| 324 |
Updates packages to the best version available, which may not always be the |
| 325 |
highest version number due to masking for testing and development. This will |
| 326 |
also update direct dependencies which may not be what you want. In general, |
| 327 |
use this option only in combination with the world or system target. |
| 328 |
.TP |
| 329 |
.BR "\-\-upgradeonly " (\fB\-U\fR) |
| 330 |
Updates packages, but excludes updates that would result in a lower version |
| 331 |
of the package being installed. \fBSLOT\fRs are considered at a basic level. |
| 332 |
.br |
| 333 |
This option is deprecated and should not be used anymore. Please use the |
| 334 |
/etc/portage/package.* files from now on. |
| 335 |
.TP |
| 336 |
.BR "\-\-usepkg " (\fB\-k\fR) |
341 |
.BR "\-\-usepkg " (\fB\-k\fR) |
| 337 |
Tells emerge to use binary packages (from $PKGDIR) if they are available, thus possibly avoiding some |
342 |
Tells emerge to use binary packages (from $PKGDIR) if they are available, thus possibly avoiding some |
| 338 |
time\-consuming compiles. This option is useful for CD installs; you can export PKGDIR=/mnt/cdrom/packages |
343 |
time\-consuming compiles. This option is useful for CD installs; you can export PKGDIR=/mnt/cdrom/packages |
|
Lines 346-355
Link Here
|
| 346 |
.TP |
351 |
.TP |
| 347 |
.BR "\-\-verbose " (\fB\-v\fR) |
352 |
.BR "\-\-verbose " (\fB\-v\fR) |
| 348 |
Tell emerge to run in verbose mode. Currently this flag causes emerge to print out GNU info errors, if any, and to show the USE flags that will be used for each package when pretending. |
353 |
Tell emerge to run in verbose mode. Currently this flag causes emerge to print out GNU info errors, if any, and to show the USE flags that will be used for each package when pretending. |
| 349 |
.TP |
|
|
| 350 |
.BR "\-\-version " (\fB\-V\fR) |
| 351 |
Displays the version number of \fBemerge\fR. It cannot be used in |
| 352 |
conjunction with other options. |
| 353 |
.SH "OUTPUT" |
354 |
.SH "OUTPUT" |
| 354 |
When utilizing \fBemerge\fR with the \fB\-\-pretend\fR and \fB\-\-verbose\fR |
355 |
When utilizing \fBemerge\fR with the \fB\-\-pretend\fR and \fB\-\-verbose\fR |
| 355 |
flags, the output may be a little hard to understand at first. This section |
356 |
flags, the output may be a little hard to understand at first. This section |
