Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 154899

Summary: portage introduction makes it sound like --update doesn't update (direct) dependencies
Product: [OLD] Docs on www.gentoo.org Reporter: Wesley Pegden <wes>
Component: Installation HandbookAssignee: nm (RETIRED) <nightmorph>
Status: RESOLVED FIXED    
Severity: normal CC: docs-team
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Wesley Pegden 2006-11-12 09:04:52 UTC
Look at http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1

It makes it sound like emerge --update world doesn't update direct dependencies.
Comment 1 nm (RETIRED) gentoo-dev 2006-11-12 11:51:08 UTC
(In reply to comment #0)
> Look at http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1
> 
> It makes it sound like emerge --update world doesn't update direct
> dependencies.
> 

"Portage will then search for newer version of the applications you have installed. However, it will only verify the versions for the applications you have explicitly installed - not the dependencies. If you want to update every single package on your system, add the --deep argument:"

[. . .]

"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 [emerge -uD world] once in a while."

It's pretty straightforward to me.
Comment 2 Jan Kundrát (RETIRED) gentoo-dev 2006-11-12 11:58:01 UTC
(In reply to comment #1)
> "Portage will then search for newer version of the applications you have
> installed. However, it will only verify the versions for the applications you
> have explicitly installed - not the dependencies. If you want to update every
> single package on your system, add the --deep argument:"

Then the Handbook is incorrect, see `man emerge`:

--deep (-D)
When  used in conjunction with --update, this flag forces emerge to consider the entire dependency tree of packages, instead of checking only the immediate dependencies of the packages.  As an example, this catches updates in libraries that are not directly listed in the dependencies of a package.
Comment 3 nm (RETIRED) gentoo-dev 2006-11-12 13:02:37 UTC
I'll take this one after some consultation with jkt on IRC.
Comment 4 nm (RETIRED) gentoo-dev 2006-11-12 13:28:53 UTC
Made even clearer; thanks to jkt for discussing on IRC.

Fixed in CVS.