In section 6.d Code Listing 18: ------------------------------------------------------ Code Listing 18: View what 'emerge system' will do # emerge --pretend --emptytree system | less Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using emerge --pretend --newuse system is sufficient. If you didn't touch the USE flag either, why are you running a stage2 installation then? View what 'emerge system' will do # emerge --pretend --emptytree system | less Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using emerge --pretend --newuse system is sufficient. If you didn't touch the USE flag either, why are you running a stage2 installation then? ------------------------------------------------------ It says that "using emerge --pretend --newuse system is sufficient.". Why is it sufficient? Giving the --newuse flag is seemingly necessary for portage to compile sys-libs/glibc with the userlocales USE flag. But it doesn't state that clearly enough. Don't take me as slaming the documentation, because you guys have great documentation, I just wanted to point out a "gray area" that I thought could use some elaboration. I have also noticed the usage of --emptytree in the 2005.0 documentation compared to the 2004.3 documentation. Doing emerge -h tells me what that is, but the documentation doesn't state it. Do you guys want "bug reports" on the documentation or would you rather not have them? Just curious as this is my first bug report on the documentation. Thanks guys. Reproducible: Always Steps to Reproduce: 1. 2. 3.
The explanation for --newuse is immediately preceding: if you haven't touched the default CFLAGS/CXXFLAGS setting As for not explaning --emptytree, well, I can see that one.
Yeah, but let's assume I'm a complete Gentoo newbie who is learning as they go. WHAT does --newuse do when this is the initial setup. Let's pretend I'm this hypothetical newbie who thinks that --newuse is used for rebuilding a system. Does --newuse override some kind of USE flags that the livecd had? I'm just trying to point out that more detail would be nice. ------------------------------------ if you haven't touched the default CFLAGS/CXXFLAGS setting ------------------------------------ I can see where that is useful to a DO THIS, DO THAT mindset, but WHY you're doing something is helpful too. Such as: ------------------------------------ ... if you haven't touched the default CFLAGS/CXXFLAGS setting then emerge --pretend --newuse system is sufficient BECAUSE ... ------------------------------------ The key word is answering the question "WHY?". I'm just trying to help add polish to what is already really good documentation.
I've changed the first occurrence of the explanation to the following in the handbook: """ Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using emerge --pretend --newuse system is sufficient: it will rebuild the applications that are affected by a change in USE flags (compared to the USE flag we used while building the stage2). If you didn't touch the USE flag either, why are you running a stage2 installation then? """ I left the second occurrence as-is though.
According to the documentation, this is the impression that it gives me: If you haven't changed your USE flags, emerge --pretend --newuse system is sufficient... "But if I have?", the newbie asks. What do I do then? I understand about the 2nd occurence as they are so close together.
It's a regular language construct. """ Show me your driver license and social security card. If you don't have a driver license, the social security card is sufficient. """ When you read "if you blabla" but "blabla" does not affect you, then you don't have to read the rest of the sentence. In other words, if you have altered your CFLAGS/CXXFLAGS, then use the first command. If you haven't, use the second command.