Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 122460 - x86/Athlon example for Alpha documentations sounds strange about CFLAGS.
Summary: x86/Athlon example for Alpha documentations sounds strange about CFLAGS.
Status: RESOLVED CANTFIX
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: Alpha All
: High minor (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-02-11 06:53 UTC by DEMAINE Benoît-Pierre, aka DoubleHP
Modified: 2006-02-11 18:25 UTC (History)
1 user (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 DEMAINE Benoît-Pierre, aka DoubleHP 2006-02-11 06:53:57 UTC
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.
Comment 1 nm (RETIRED) gentoo-dev 2006-02-11 07:04:33 UTC
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.
Comment 2 Bryan Østergaard (RETIRED) gentoo-dev 2006-02-11 07:58:20 UTC
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 :)
Comment 3 DEMAINE Benoît-Pierre, aka DoubleHP 2006-02-11 07:59:12 UTC
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.
Comment 4 Jose Luis Rivero (yoswink) (RETIRED) gentoo-dev 2006-02-11 18:25:26 UTC
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.