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>