| … | |
… | |
| 2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
| 3 | |
3 | |
| 4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 6 | |
6 | |
| 7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.72 2008/12/24 07:07:48 nightmorph Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
| 11 | <abstract> |
11 | <abstract> |
| 12 | This chapter explains the "simple" steps a user definitely needs to know to |
12 | This chapter explains the "simple" steps a user definitely needs to know to |
| 13 | maintain the software on his system. |
13 | maintain the software on his system. |
| 14 | </abstract> |
14 | </abstract> |
| 15 | |
15 | |
| 16 | <version>1.65</version> |
16 | <version>1.66</version> |
| 17 | <date>2008-12-23</date> |
17 | <date>2010-02-13</date> |
| 18 | |
18 | |
| 19 | <section> |
19 | <section> |
| 20 | <title>Welcome to Portage</title> |
20 | <title>Welcome to Portage</title> |
| 21 | <body> |
21 | <body> |
| 22 | |
22 | |
| … | |
… | |
| 325 | <title>Metapackages</title> |
325 | <title>Metapackages</title> |
| 326 | <body> |
326 | <body> |
| 327 | |
327 | |
| 328 | <p> |
328 | <p> |
| 329 | Some packages in the Portage tree don't have any real content but are used to |
329 | Some packages in the Portage tree don't have any real content but are used to |
| 330 | install a collection of packages. For instance, the <c>kde</c> package will |
330 | install a collection of packages. For instance, the <c>kde-meta</c> package will |
| 331 | install a complete KDE environment on your system by pulling in various |
331 | install a complete KDE environment on your system by pulling in various |
| 332 | KDE-related packages as dependencies. |
332 | KDE-related packages as dependencies. |
| 333 | </p> |
333 | </p> |
| 334 | |
334 | |
| 335 | <p> |
335 | <p> |
| … | |
… | |
| 446 | these dependencies explicitly marks a package or virtual as being <e>not</e> |
446 | these dependencies explicitly marks a package or virtual as being <e>not</e> |
| 447 | compatible, it triggers a blockage. |
447 | compatible, it triggers a blockage. |
| 448 | </p> |
448 | </p> |
| 449 | |
449 | |
| 450 | <p> |
450 | <p> |
|
|
451 | While recent versions of Portage are smart enough to work around minor blockages |
|
|
452 | without user intervention, occasionally you will need to fix it yourself, as |
|
|
453 | explained below. |
|
|
454 | </p> |
|
|
455 | |
|
|
456 | <p> |
| 451 | To fix a blockage, you can choose to not install the package or unmerge the |
457 | To fix a blockage, you can choose to not install the package or unmerge the |
| 452 | conflicting package first. In the given example, you can opt not to install |
458 | conflicting package first. In the given example, you can opt not to install |
| 453 | <c>postfix</c> or to remove <c>ssmtp</c> first. |
459 | <c>postfix</c> or to remove <c>ssmtp</c> first. |
| 454 | </p> |
460 | </p> |
| 455 | |
461 | |
| 456 | <p> |
462 | <p> |
| 457 | You may also see blocking packages with specific atoms, such as |
463 | You may also see blocking packages with specific atoms, such as |
| 458 | <b><</b>media-video/mplayer-bin-1.0_rc1-r2. In this case, updating to a more |
464 | <b><</b>media-video/mplayer-1.0_rc1-r2. In this case, updating to a more |
| 459 | recent version of the blocking package would remove the block. |
465 | recent version of the blocking package would remove the block. |
| 460 | </p> |
466 | </p> |
| 461 | |
467 | |
| 462 | <p> |
468 | <p> |
| 463 | It is also possible that two packages that are yet to be installed are blocking |
469 | It is also possible that two packages that are yet to be installed are blocking |
| … | |
… | |
| 547 | <subsection id="ambiguousebuild"> |
553 | <subsection id="ambiguousebuild"> |
| 548 | <title>Ambiguous Ebuild Name</title> |
554 | <title>Ambiguous Ebuild Name</title> |
| 549 | <body> |
555 | <body> |
| 550 | |
556 | |
| 551 | <pre caption="Portage warning about ambiguous ebuild names"> |
557 | <pre caption="Portage warning about ambiguous ebuild names"> |
|
|
558 | [ Results for search key : listen ] |
|
|
559 | [ Applications found : 2 ] |
|
|
560 | |
|
|
561 | * dev-tinyos/listen [ Masked ] |
|
|
562 | Latest version available: 1.1.15 |
|
|
563 | Latest version installed: [ Not Installed ] |
|
|
564 | Size of files: 10,032 kB |
|
|
565 | Homepage: http://www.tinyos.net/ |
|
|
566 | Description: Raw listen for TinyOS |
|
|
567 | License: BSD |
|
|
568 | |
|
|
569 | * media-sound/listen [ Masked ] |
|
|
570 | Latest version available: 0.6.3 |
|
|
571 | Latest version installed: [ Not Installed ] |
|
|
572 | Size of files: 859 kB |
|
|
573 | Homepage: http://www.listen-project.org |
|
|
574 | Description: A Music player and management for GNOME |
|
|
575 | License: GPL-2 |
|
|
576 | |
| 552 | !!! The short ebuild name "aterm" is ambiguous. Please specify |
577 | !!! The short ebuild name "listen" is ambiguous. Please specify |
| 553 | !!! one of the following fully-qualified ebuild names instead: |
578 | !!! one of the above fully-qualified ebuild names instead. |
| 554 | |
|
|
| 555 | dev-libs/aterm |
|
|
| 556 | x11-terms/aterm |
|
|
| 557 | </pre> |
579 | </pre> |
| 558 | |
580 | |
| 559 | <p> |
581 | <p> |
| 560 | The application you want to install has a name that corresponds with more than |
582 | The application you want to install has a name that corresponds with more than |
| 561 | one package. You need to supply the category name as well. Portage will inform |
583 | one package. You need to supply the category name as well. Portage will inform |