Why not having genflags been used (automatically? maybe with user assistance!) to choose optimal CFLAGS directly from the Gentoo installation process? It would help a lot. Often an user get gentoo installed and if he remember it then will look google&forums for processor's optimizazion. Reproducible: Always Steps to Reproduce: 1. 2. 3.
That's more of a documentation thing.
Genflag doesn't choose "optimal" flags as optimal is something we can't globally achieve. It gives a plausible setting. I can't find genflags on our LiveCDs (base.pkg and kern.pkg files). Are they available? And if so, are they on all architectures? If not, then mentioning genflags to the users might be a good idea, but not in the installation guide. The latter should contain information that works for all LiveCDs, no-network installations, etc.
genflags doesn't seem production-ready too... (On an "x86" system) # host2flags -h /usr/sbin/host2flags: line 26: dohelp: command not found I'm marking this one as WONTFIX. When genflags is production-ready, available on all LiveCDs and has been thouroughly tested we will use it in the documentation (as was the idea when genflags was first discussed).