swift 11/10/13 16:58:14 Modified: hb-working-portage.xml Log: Add information on --with-bdeps as per discussion on gentoo-dev
Revision Changes Path 1.77 xml/htdocs/doc/en/handbook/hb-working-portage.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.77&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.77&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.76&r2=1.77 Index: hb-working-portage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v retrieving revision 1.76 retrieving revision 1.77 diff -u -r1.76 -r1.77 --- hb-working-portage.xml 12 Aug 2011 19:24:18 -0000 1.76 +++ hb-working-portage.xml 13 Oct 2011 16:58:14 -0000 1.77 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.76 2011/08/12 19:24:18 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.77 2011/10/13 16:58:14 swift Exp $ --> <sections> @@ -294,15 +294,27 @@ installed. However, it will only verify the versions for the applications you have <e>explicitly</e> installed (the applications listed in <path>/var/lib/portage/world</path>) - it does not thoroughly check their -dependencies. If you want to update <e>every single package</e> on your system, +dependencies. If you want to update the dependencies of those packages as well, add the <c>--deep</c> argument: </p> -<pre caption="Updating your entire system"> +<pre caption="Updating your system with dependencies"> # <i>emerge --update --deep world</i> </pre> <p> +Still, this doesn't mean <e>all packages</e>: some packages on your system are +needed during the compile and build process of packages, but once that package +is installed, these dependencies are no longer required. Portage calls those +<e>build dependencies</e>. To include those in an update cycle, add +<c>--with-bdeps=y</c>: +</p> + +<pre caption="Updating your entire system"> +# <i>emerge --update --deep --with-bdeps=y world</i> +</pre> + +<p> Since security updates also happen in packages you have not explicitly installed on your system (but that are pulled in as dependencies of other programs), it is recommended to run this command once in a while. @@ -316,7 +328,7 @@ </p> <pre caption="Performing a full update"> -# <i>emerge --update --deep --newuse world</i> +# <i>emerge --update --deep --with-bdeps=y --newuse world</i> </pre> </body>
