Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 232905 - Linux x86 Handbook: Portage profiles are essentially undocumented.
Summary: Linux x86 Handbook: Portage profiles are essentially undocumented.
Status: RESOLVED DUPLICATE of bug 232903
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: x86 Linux
: High normal (vote)
Assignee: Docs Team
URL: http://archives.gentoo.org/gentoo-use...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-07-25 10:09 UTC by Alan Mackenzie
Modified: 2008-07-25 15:36 UTC (History)
0 users

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 Alan Mackenzie 2008-07-25 10:09:04 UTC
Section 6b Configuring Portage/Choosing the right profile:
There is no description of "a profile" which says:
(i) The target of the link /etc/make.profile is a DIRECTORY (not a file);
(ii) What files are part of a profile and what they do;
(iii) That files with the same name all the way up the directory path are relevant, with the lower files taking precedence over the higher ones.

The manual doesn't say whether I should edit a profile or not.  It doesn't recommend a profile for the first installation (unless the Code Listing 2.2 is a recommendation; it isn't very explicit).

Without the above description, sentences such as "The default USE settings are placed in the make.defaults files of your profile" are difficult to understand.



Reproducible: Always




I am a new Gentoo user, but an experienced Linux user.

I was hit by this lack of documentation whilst doing my first installation.  This lack has caused me several days confusion and frustration, finally resolved by the good guys on gentoo-user@lists.gentoo.org.  See the thread in the URL in this bug report.

  I have spent (?lost) many hours fruitlessly searching the rest of the Gentoo site for this info.  Please fix the docs!  Thanks in advance!
Comment 1 Carsten Lohrke (RETIRED) gentoo-dev 2008-07-25 15:36:09 UTC

*** This bug has been marked as a duplicate of bug 232903 ***