http://www.gentoo.org/doc/en/handbook/2005.1/handbook-alpha.xml?part=1&chap=5 seems quiet unrevealant to me: -march=athlon-xp please, bne serous ... athlon line in Alpha doc :P yes, I know the historical link, but this is a Gentoo install book. Here is my make.conf: ***************************************** CFLAGS="-mieee -O2 -mcpu=ev56 -pipe" CHOST="alpha-unknown-linux-gnu" CXXFLAGS="${CFLAGS}" PORT_LOGDIR=/var/log/portage MAKEOPTS="-j2" ************************************ and please add a discussion about advisable -pipe, how to determine the CPU version, and check it is supported by GCC, the VERY IMPORTANT j option (especially with MP systems Alpha are designed for), and explain what about the 'unknown' part of CHOST. I also put PORTAGE_TMPFS="/dev/shm" but thats more criticable as default option. Thanks.
CCing the alpha team. What do you guys have to say about this? For the record: <@SwifT> iirc it is in a public part - we should remove the examples and refer to the make.conf.examples on the file system Sounds good to me, but I'd like feedback from the alpha guys.
I'd have no concerns at all just pointing to make.conf.example. Very few people have asked about the CFLAGS stuff in the past but less confusion is always good :)
Some one told me on IRC that all installlation docs tend to share common files, and try to unify docs. Still, I have discovered interesting things are are only in Alpha, like use of -o bind to mount /dev. My motivation to open this bug is that the URL mentionned above explicitely contains the word Alpha ... and not generic-book or so ... maybe in the backend admins copy files between archs (or use symlinks ?), but as end user, I want to report what seems odd to me. But still, you could add some lines about the points/discussoins I mentioned about.
Hi: Indeed, our handbooks try to share as much info as possible, which make them much easier to maintain. Please read http://www.gentoo.org/doc/en/handbook/#doc_chap4 for more info. File referenced here is hb-install-stage.xml. Josh, we can improve our hb-install-stage (if so, please open a new bug or just do it ;) ) but this bug seems haven't understood our shared files handbook format. I close it.