Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
Typo in Gentoo handbook for 5.d Configuring the compile?
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Installing Gentoo
View previous topic :: View next topic  
Author Message
ronstudio
n00b
n00b


Joined: 14 Aug 2011
Posts: 28

PostPosted: Fri Aug 31, 2012 4:44 pm    Post subject: Typo in Gentoo handbook for 5.d Configuring the compile? Reply with quote

Hi,

I wonder if this is a typo in the in the Gentoo handbook, for 5.d Configuring the compile options, after downloading the latest stage3 and portage, it's the time to edit the make.conf:

I suppose that Instead of editing the make.conf in portage:
Code Listing 4.1: Opening /etc/portage/make.conf
# nano -w /mnt/gentoo/etc/portage/make.conf

The file to be edit should be:
# nano -w /mnt/gentoo/etc/make.conf

for adding those flags like CFLAGS, CXXFLAGS and MAKEOPTS.

Or the system has been updated for having these flags under portage/make.conf?
Back to top
View user's profile Send private message
kurly
Apprentice
Apprentice


Joined: 02 Apr 2012
Posts: 253

PostPosted: Fri Aug 31, 2012 4:53 pm    Post subject: Reply with quote

/etc/make.conf is the 'old' location and /etc/portage/make.conf is the 'new' location. Both are supported by today's software and likely will remain supported well into the future. But for a new installation, you should probably use the new location.
Back to top
View user's profile Send private message
John R. Graham
Administrator
Administrator


Joined: 08 Mar 2005
Posts: 10263
Location: Somewhere over Atlanta, Georgia

PostPosted: Fri Aug 31, 2012 5:35 pm    Post subject: Reply with quote

@ronstudio,

Apologies. @kurly is correct. The documentation got ahead of the stage3 tarball generation. The prototype make.conf will be moved to /etc/portage but there's currently another issue with the stage3 autobuild process that's preventing them from being refreshed. Portage will accept it in either location. You can move it to the new location or leave it where it is: your choice.

- John
_________________
I can confirm that I have received between 0 and 499 National Security Letters.
Back to top
View user's profile Send private message
spacelike
n00b
n00b


Joined: 15 Sep 2011
Posts: 61

PostPosted: Fri Aug 31, 2012 8:05 pm    Post subject: Reply with quote

I noticed the exact same thing recently and thought it was a typo too.

The people on #gentoo recommended I just make a symlink so that both paths work, just letting you know.
Back to top
View user's profile Send private message
John R. Graham
Administrator
Administrator


Joined: 08 Mar 2005
Posts: 10263
Location: Somewhere over Atlanta, Georgia

PostPosted: Fri Aug 31, 2012 8:10 pm    Post subject: Reply with quote

A symlink is a waste of time. Portage looks at both locations.

- John
_________________
I can confirm that I have received between 0 and 499 National Security Letters.
Back to top
View user's profile Send private message
steak-sandwich
n00b
n00b


Joined: 27 Aug 2012
Posts: 26

PostPosted: Fri Aug 31, 2012 11:29 pm    Post subject: Reply with quote

In my opinion this info should be added somewhere in the documentation, that both places are valid. Then people wouldn't get so confused in the beginning.
Back to top
View user's profile Send private message
ronstudio
n00b
n00b


Joined: 14 Aug 2011
Posts: 28

PostPosted: Sat Sep 01, 2012 1:23 am    Post subject: Reply with quote

Thanks a lot for the help and explanation.

haha, Actually the major reason which made me think it is a typo because when you make a fresh install, /etc/make.conf has some basic content inside. So I can just follow the handbook to make the adjustment based on my hardware.

However, /etc/portage/make.conf is completely blank. For someone who has never done the Gentoo install before, I afraid he/she may have no idea for the syntax or how to complete it.
Back to top
View user's profile Send private message
John R. Graham
Administrator
Administrator


Joined: 08 Mar 2005
Posts: 10263
Location: Somewhere over Atlanta, Georgia

PostPosted: Sat Sep 01, 2012 1:31 am    Post subject: Reply with quote

steak-sandwich wrote:
In my opinion this info should be added somewhere in the documentation, that both places are valid. Then people wouldn't get so confused in the beginning.
It's already documented in
Code:
man portage
that both locations are valid.

Regarding the Handbook, that documentation is correct because we intend to put the default make.conf in /etc/portage going forward. Currently only the Stage3 tarball is incorrect, which we'll get it fixed shortly.

- John
_________________
I can confirm that I have received between 0 and 499 National Security Letters.
Back to top
View user's profile Send private message
vdodge1
n00b
n00b


Joined: 28 Aug 2007
Posts: 8
Location: Syracuse New York

PostPosted: Sun Sep 09, 2012 5:44 pm    Post subject: Reply with quote

John R. Graham wrote:
steak-sandwich wrote:
In my opinion this info should be added somewhere in the documentation, that both places are valid. Then people wouldn't get so confused in the beginning.
It's already documented in
Code:
man portage
that both locations are valid.

Regarding the Handbook, that documentation is correct because we intend to put the default make.conf in /etc/portage going forward. Currently only the Stage3 tarball is incorrect, which we'll get it fixed shortly.

- John


John,

Thank you very much for helping to clear up this point. However, I respectfully disagree regarding the Handbook documentation. I believe the current Handbook is incorrect and misleading.

Section 5.d. in The Handbook says:
"To keep your settings, Portage provides you with /etc/portage/make.conf, a configuration file for Portage. It is this file we will edit now."

As of this morning, the current AMD64 Stage3 tarball, dated 22-June-2012 does not provide any make.conf file in the etc/portage/ directory of the installation.

An earlier comment mentioned that the file was empty. I believe they assumed it was empty because executing the command at Code Listing 4.1: Opening /etc/portage/make.conf, creates a new empty file when nano doesn't find an existing make.conf file.

I hope one of these issues, Handbook documentation or Stage3 tarball is resolved soon. I think Step 5 of the installation process is very early to take the chance of alienating potential future Gentoo users and contributors, especially when a documentation fix is relatively simple.
_________________
"... and if that doesn't work, CONGRATULATIONS!!! You're about to learn a whole lot more about linux and your system hardware!"
Back to top
View user's profile Send private message
John R. Graham
Administrator
Administrator


Joined: 08 Mar 2005
Posts: 10263
Location: Somewhere over Atlanta, Georgia

PostPosted: Sun Sep 09, 2012 7:46 pm    Post subject: Reply with quote

I do understand your point. I spoke to the Release Engineering team about reversing the changes to the Handbook or else getting the Stages updated quickly. I think that there is some other issue with the Stages right now related to recent changes to the system set, which hasn't been as quickly resolved as they would like.

- John
_________________
I can confirm that I have received between 0 and 499 National Security Letters.
Back to top
View user's profile Send private message
John R. Graham
Administrator
Administrator


Joined: 08 Mar 2005
Posts: 10263
Location: Somewhere over Atlanta, Georgia

PostPosted: Tue Sep 11, 2012 10:44 am    Post subject: Reply with quote

Approaching closure on this issue:
eselect news read new wrote:
Title make.conf and make.profile move
Author Jorge Manuel B. S. Vicetto <jmbsvicetto@gentoo.org>
Posted 2012-09-09
Revision 1

Starting next week, new stages will have make.conf and make.profile
moved from /etc to /etc/portage. This is a change in the installation
defaults, that will only affect new installs so it doesn't affect
current systems.

Current users don't need to do anything. But if you want to follow the
preferred location, you may want to take the chance to move the files
in your system(s) to the new location.
- John
_________________
I can confirm that I have received between 0 and 499 National Security Letters.
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Installing Gentoo All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum