/[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.30 Revision 1.31
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
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/1.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.30 2004/08/01 15:03:27 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.31 2004/08/04 07:01:58 swift Exp $ -->
8 8
9<sections> 9<sections>
10<section> 10<section>
11<title>Obtaining Package Information</title> 11<title>Obtaining Package Information</title>
12<subsection> 12<subsection>
13<title>The Lord of All Tools: emerge</title> 13<title>The Lord of All Tools: emerge</title>
14<body> 14<body>
15 15
16<p> 16<p>
17The main Portage tool that most users will use is <c>emerge</c>. We have already 17The main Portage tool that most users will use is <c>emerge</c>. We have already
18used it during the Gentoo installation and in the previous chapter, but we just 18used it during the Gentoo installation and in the previous chapter, but we just
19briefly explained how to use it. This chapter will elaborate on <c>emerge</c> 19briefly explained how to use it. This chapter will elaborate on <c>emerge</c>
20and teach you how to use <c>emerge</c> to fix all your software-related needs. 20and teach you how to use <c>emerge</c> to fix all your software-related needs.
21</p> 21</p>
22 22
634<p> 634<p>
635Right next to the word "ebuild" you will notice a letter (or combination of 635Right next to the word "ebuild" you will notice a letter (or combination of
636letters) which gives you more information about the package: 636letters) which gives you more information about the package:
637</p> 637</p>
638 638
639<ul> 639<ul>
640 <li> 640 <li>
641 <e>B</e> (blocks) The package listed to the left is blocking the emerge of 641 <e>B</e> (blocks) The package listed to the left is blocking the emerge of
642 the package listed to the right 642 the package listed to the right
643 </li> 643 </li>
644 <li> 644 <li>
645 <e>N</e> (new) The package is new to your system and will be emerged for the 645 <e>N</e> (new) The package is new to your system and will be emerged for the
646 first time 646 first time
647 </li> 647 </li>
648 <li> 648 <li>
649 <e>R</e> (reemerge) The package isn't new, but needs to be reemerged 649 <e>R</e> (replace) The package isn't new, but needs to be reemerged
650 </li> 650 </li>
651 <li> 651 <li>
652 <e>F</e> (fetch) The package requires that you download the source code 652 <e>F</e> (fetch) The package requires that you download the source code
653 manually (for instance due to licencing issues) 653 manually (for instance due to licencing issues)
654 </li> 654 </li>
655 <li> 655 <li>
656 <e>U</e> (update) The package already exists on your system but will be 656 <e>U</e> (update) The package already exists on your system but will be
657 upgraded 657 upgraded
658 </li> 658 </li>
659 <li> 659 <li>
660 <e>UD</e> (downgrade) The package already exists on your system but will be 660 <e>UD</e> (downgrade) The package already exists on your system but will be
661 downgraded 661 downgraded
662 </li> 662 </li>
663 <li> 663 <li>
664 <e>U-</e> (slot warning) The package you have installed on your system 664 <e>U-</e> (slot warning) The package you have installed on your system
665 is listed as a package that can not coexist with a different version, but 665 is listed as a package that can not coexist with a different version, but
666 your update does. The update will be installed and the older version will be 666 your update does. The update will be installed and the older version will be
667 removed. 667 removed.
668 </li> 668 </li>
669</ul> 669</ul>
670
671<p>
672In certain cases, an update may mean a downgrade (i.e. install an older version
673instead of a newer version). If you don't want this to happen, use the
674<c>--upgradeonly</c> option (<c>-U</c> in short):
675</p>
676
677<pre caption="Upgrading your entire system">
678# <i>emerge --update --upgradeonly world</i>
679</pre>
680 670
681<p> 671<p>
682We have mentioned that the <e>world</e> file doesn't contain dependencies. When 672We have mentioned that the <e>world</e> file doesn't contain dependencies. When
683you run <c>emerge --update world</c> only the packages mentioned in the 673you run <c>emerge --update world</c> only the packages mentioned in the
684<e>world</e> file and it's immediate dependencies are checked and, if necessary, 674<e>world</e> file and it's immediate dependencies are checked and, if necessary,
685upgraded. If you want <c>emerge</c> to check <e>all</e> the dependencies 675upgraded. If you want <c>emerge</c> to check <e>all</e> the dependencies
686(including the dependencies of the dependencies), add the <c>--deep</c> flag: 676(including the dependencies of the dependencies), add the <c>--deep</c> flag:
687</p> 677</p>
688 678
689<pre caption="Upgrading your entire system, including all dependencies"> 679<pre caption="Upgrading your entire system, including all dependencies">
690# <i>emerge --update --deep world</i> 680# <i>emerge --update --deep world</i>
691</pre> 681</pre>
692 682
693<p> 683<p>
694Of course, we are talking here about <e>system</e> and <e>world</e>, but you can 684Of course, we are talking here about <e>system</e> and <e>world</e>, but you can

Legend:
Removed from v.1.30  
changed lines
  Added in v.1.31

  ViewVC Help
Powered by ViewVC 1.1.20