Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 371276 - Explain when to use emerge -e when changes to /etc/make.conf are made
Summary: Explain when to use emerge -e when changes to /etc/make.conf are made
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-06-12 15:27 UTC by bgoodr
Modified: 2011-06-12 21:10 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description bgoodr 2011-06-12 15:27:27 UTC
If I change CFLAGS in /etc/make.conf, it would be best to rebuild the world with "emerge -e world". It needs to be explained somewhere in the handbook that changes to /etc/make.conf do NOT automatically cause a rebuild of the world when CFLAGS is changed, as apparently portage does not clue into changes to /etc/make.conf as a file dependency and does not therefore rebuild the world when CFLAGS value has changed.

User scenario:
1. User initially sets CFLAGS to include -march=VALUE1
2. User builds a new system using the installation guide
3. User gets deep into the installation guide and finds some flag that needs to be set for specific architectures such as omiting frame pointers or changes to -march=VALUE2
4. User makes that change and runs emerge and finds that not all packages are rebuilt.

Therefore, perhaps a sentence or two is in order to be added to the handbook in the sections (that's plural) that explain when to use the -e switch w.r.t. changes to CFLAGS?

-bg
Comment 1 nm (RETIRED) gentoo-dev 2011-06-12 21:10:32 UTC
Not in the handbook. Users do not need to mess about re-emerging world when installing.

You don't normally need to recompile your entire world right then and there just because you change a few CFLAGs. You can just gradually rebuild everything with each merge after the change.

If you change CHOST, *then* you need to rebuild world, and we have a guide for that:

http://www.gentoo.org/doc/en/change-chost.xml

Or if you upgrade to a  new major version of your compiler:

http://www.gentoo.org/doc/en/gcc-upgrading.xml

Or if you're using a stage1 or stage2 tarball:

http://www.gentoo.org/doc/en/faq.xml#stage12