/[gentoo]/xml/htdocs/doc/en/handbook/hb-working-portage.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-working-portage.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.72 Revision 1.73
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>
12This chapter explains the "simple" steps a user definitely needs to know to 12This chapter explains the "simple" steps a user definitely needs to know to
13maintain the software on his system. 13maintain 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>
329Some packages in the Portage tree don't have any real content but are used to 329Some packages in the Portage tree don't have any real content but are used to
330install a collection of packages. For instance, the <c>kde</c> package will 330install a collection of packages. For instance, the <c>kde-meta</c> package will
331install a complete KDE environment on your system by pulling in various 331install a complete KDE environment on your system by pulling in various
332KDE-related packages as dependencies. 332KDE-related packages as dependencies.
333</p> 333</p>
334 334
335<p> 335<p>
446these dependencies explicitly marks a package or virtual as being <e>not</e> 446these dependencies explicitly marks a package or virtual as being <e>not</e>
447compatible, it triggers a blockage. 447compatible, it triggers a blockage.
448</p> 448</p>
449 449
450<p> 450<p>
451While recent versions of Portage are smart enough to work around minor blockages
452without user intervention, occasionally you will need to fix it yourself, as
453explained below.
454</p>
455
456<p>
451To fix a blockage, you can choose to not install the package or unmerge the 457To fix a blockage, you can choose to not install the package or unmerge the
452conflicting package first. In the given example, you can opt not to install 458conflicting 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>
457You may also see blocking packages with specific atoms, such as 463You may also see blocking packages with specific atoms, such as
458<b>&lt;</b>media-video/mplayer-bin-1.0_rc1-r2. In this case, updating to a more 464<b>&lt;</b>media-video/mplayer-1.0_rc1-r2. In this case, updating to a more
459recent version of the blocking package would remove the block. 465recent version of the blocking package would remove the block.
460</p> 466</p>
461 467
462<p> 468<p>
463It is also possible that two packages that are yet to be installed are blocking 469It 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>
560The application you want to install has a name that corresponds with more than 582The application you want to install has a name that corresponds with more than
561one package. You need to supply the category name as well. Portage will inform 583one package. You need to supply the category name as well. Portage will inform

Legend:
Removed from v.1.72  
changed lines
  Added in v.1.73

  ViewVC Help
Powered by ViewVC 1.1.20