A user (see link) attempted to emerge gentoo-sources as that handbook told him to, but portage wanted to bring in a number of large packages because on some useflag(s). Reproducible: Always Steps to Reproduce: 1. Follow handbook, setting useflags, etc. 2. Emerge <kernel>-sources Actual Results: Lots of packages want to be compiled additionally. Expected Results: Only the kernel sources should be emerged, unless the user wishes other wise. I would recommend the following solution: Add a brief paragraph telling users to all the --nodep option to emerge when merging kernel-sources if multiple packages what to get compiled before hand. i.e. emerge --nodep <kernel>-sources.
(In reply to comment #0) > 1. Follow handbook, setting useflags, etc. The user added the "doc" USE flag. The handbook needs some TLC, and the USE flags should be mentioned much later IMO. In the meantime, I'll just add USE="-doc" emerge.. like we already do with USE="-X"...
Fixed with USE="-doc" Hopefully the USE flags section will be shifted towards the end of the handbook in the near future.
