Stupot wrote:If somebody just up and grabs his make.conf after the explanation given, then they are going to have big problems, no matter what file wolfden put up as an example. The whole point of this thread was to learn how to customize make.conf for your own personal machine. There's no good example that exists where anybody could just up and copy the sample make.conf without most likely running into problems.
[edit]
You're assuming that they read the explanation - many people look at the example first, then skim the explanation. Very few people are willing to read anything longer than a sentence, these days. Anyway, back to my non-edited portion of my post:
[/edit]
Of course there's no good example for that situation, but there are
better examples. Many of them.
The point of an example is to give the people looking at it an idea of what a good <exampled_item> might look like. The file posted is a ricer make.conf - something to be avoided at all costs,
especially for the newbie to portage.
Let me try to put it in non-make.conf terms: You're writing a recipe for other people to follow for ... iunno, some food item. Krumkake, we'll say, just because I really like krumkake. You describe in detail how to mix the ingredients, what temperature to set the krumkake griddle-type-thing to, how long to cook it before taking it out and rolling it up, etc. Then, as an example, you show images of the process, but your dough is thick and ends up making pancake-thick krumkake things which crack as you roll them into cones. On top of that, they're burnt on the outside and not cooked on the inside.
Your recipe may very well result in something great, but your examples are horrible. This will result in two separate reactions in two types of people: For the person who knows what krumkake should look like, the examples prove that you know absolutely nothing about krumkake, so your recipe will be completely ignored. For the person who's never had krumkake before but is trying to make some for the first time, your recipe will result in something that looks nothing like your examples - so the newbie will get confused and try to modify the recipe so that their krumkake comes out looking like the ... crap ... in your example.
A ricer make.conf such as the example given acts in much the same way - experienced gentoo users will ignore your post, thinking that you actually support the use of eXtreme CFLAGS and LDFLAGS, and newbies will try to model their make.conf after the example, because they assume that the example is the Right Way(tm) to do it. The result being that advanced users won't bother to read your post and new users will be turned off quickly due to the large files, breakage, and slower performance gleaned by using such CFLAGS and LDFLAGS.
What you do on your own computer is your own business, but an example should be
sane. This particular example may not be worthy of the Ricer of the Year award, but it *is* rice enough that I, personally, would never trust any advice given in the original post.
