The last several revisions of the 2.1 series have deprecated a lot of the old configuration lines in /etc/make.conf, yet though some of the new ways to set options are covered, the general *syntax* is not. Instead, I see numerous deprecation warnings during emerges, but with no "this is what it should look like" message. Example: it looks like PORTAGE_RSYNC_OPTS is the place to specify multiple options, yet there is no syntax for e.g. how to set RSYNC_EXCLUDEFROM. (do we just add a '--' in front of the old one-line setting?) It'd be nice if make.conf.example was a little more helpful in this regard.
Created attachment 93425 [details, diff] clarify the gcc targets in the CFLAGS section Nice bug, I just might throw my little enhancements in here. On patch: * ) Improve (I think) the comments on setting -march targets in the CFLAGS section. The CPU type descriptions are largely taken from the gcc 4.1.1 manual and edited for shortness. I also sorted them by gcc version which supports them, no guarantees everything is 100% covered, but there shoudn't be any harm in omitting one type or the other. *) Expanded the list of gccs used in Gentoos history, because nobody who needs to read these comments remembers Gentoo 1.4 anymore ;) Info taken from the old profiles in CVS so should be correct. Hope you like this.
I also added a small line about -O vs -0. I know this is trivial, stupid and superfluous, but so are the loads of posts on the Forums including that error.
INPUT_DEVICES="" VIDEO_CARDS="" are not in make.conf.example although Xorg 7 builds and wiki claim they are. man make.conf does not discuss these either.
(In reply to comment #0) I finished updating the Portage Handbook for bug 144128 ; so now at least there's a place to find all the info besides /etc/make.conf.example -- if you want to close this, or whatever. :)
(In reply to comment #0) > Example: it looks like PORTAGE_RSYNC_OPTS is the place to specify multiple > options, yet there is no syntax for e.g. how to set RSYNC_EXCLUDEFROM. (do we > just add a '--' in front of the old one-line setting?) It's PORTAGE_RSYNC_EXTRA_OPTS, and I don't see much use in copying large parts of the rsync manpage into portage docs. Any other examples? (generic statements aren't of any use) (In reply to comment #1) > Created an attachment (id=93425) [edit] > clarify the gcc targets in the CFLAGS section Patch applied, thanks.
(In reply to comment #5) > It's PORTAGE_RSYNC_EXTRA_OPTS, and I don't see much use in copying large parts > of the rsync manpage into portage docs. > Any other examples? (generic statements aren't of any use) This was quite some time ago. I've since had to dig through all the emerge code to write the new Portage 2.1 handbook (http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=2); the fact is that there is not even a mention of what/how to format choices in PORTAGE_RSYNC*, nor what the available options are. Now you say that they're in the rsync manpage, but that manpage is not mentioned at all in man make.conf. At the very least, you could include a pointer for the PORTAGE_RSYNC* references to read man rsync. Would it be so much trouble to add just a quick example for rsync excludes, to give an idea of the *EXTRA_OPTS syntax. That's the biggest problem with all the new Portage 2.1 stuff. "config variable FOO is listed here", but there's nothing that says what its syntax should look like. e.g. is it FOO="option", FOO="--bar=/foobar" FOO="--bar=/foobar --multiple=/bar" or just FOO=/dir/bar.
The patch from comment #1 is in svn r5505 and has been released in 2.1.2_rc4-r9.patch.
(In reply to comment #7) > The patch from comment #1 is in svn r5505 and has been released in > 2.1.2_rc4-r9.patch. > So, uhhh....is this all fixed? :) Seeing as latest stable is 2.1.3.9...