Bug 286119

Summary:	CHOST is now defined in the profile linked to by /etc/make.profile. Documentation on putting CHOST in /etc/make.conf is unnecessary
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Rachel Greenham <rachel>
Component:	Installation Handbook	Assignee:	Docs Team <docs-team>
Status:	RESOLVED WONTFIX
Severity:	minor
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5
Whiteboard:
Package list:		Runtime testing required:	---
Bug Depends on:
Bug Blocks:	260403

Description Rachel Greenham 2009-09-23 17:19:52 UTC

In the section on setting up /etc/make.conf instructions are given to put a CHOST line in, and to make sure it's correct. (Associated with this, the make.conf supplied as default in the stage3 download has a default CHOST line.)

It turns out that these days CHOST is defined in /etc/make.profile; specifically the profile to which that is a symlink. Therefore the CHOST line in /etc/make.conf is unnecessary, as is the documentation about it.

The references to CHOST should be removed from both the handbook and the stage3 default /etc/make.conf; or at least have a mention that you can put it in if for some mad reason you need to override the profile's CHOST. Though /etc/make.conf.example is probably the place for that.

The current documentation doesn't *fail* in that the resulting system works; it's just unnecessary duplication (and might be more failure-prone as it may encourage some to fiddle with it when they shouldn't!)


Reproducible: Always

Comment 1 SpanKY gentoo-dev

2009-10-18 07:40:21 UTC

that's not really true.  there will always be a case for setting the CHOST in make.conf as it is impossible to have profiles for every possible CHOST variant.

Comment 2 nm (RETIRED) gentoo-dev

2009-11-30 08:48:08 UTC

Will leave as-is per comment #1. Thanks for the suggestion, though.