Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 53272 - If CHOST altered, user needs to give source command before or after bootstrap.sh?
Summary: If CHOST altered, user needs to give source command before or after bootstrap...
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Linux x86 Installation Guide (show other bugs)
Hardware: x86 Linux
: High minor (vote)
Assignee: Sven Vermeulen (RETIRED)
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
: 53273 54022 (view as bug list)
Depends on:
Blocks:
 
Reported: 2004-06-07 22:02 UTC by Casey Boettcher
Modified: 2004-07-31 04:36 UTC (History)
2 users (show)

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 Casey Boettcher 2004-06-07 22:02:11 UTC
Code listing 11 in section 6c of the installation guide is as follows:

# cd /usr/portage
# scripts/bootstrap.sh

But immediately under that listing, the guide advises the user that, if they've altered the CHOST setting in make.conf, the command in code listing 12 should be run.

# source /etc/profile

It's at this point that the user must ask himself or herself the correct order of commands. The number 12 comes after 11, and English readers read from top to bottom. Do I give the command "source /etc/profile" before or after I run boostrap.sh?

This points out a separate, broader issue related to the practice of numbering the code listings in this document: there are some listings that are alternatives to others.

I'd suggest the following scheme: for listings that apply to the same step, use an alpha-numeric notation. For example, if I could type either "scripts/bootstrap.sh -f" or "scripts/bootsrap.sh" to accomplish the same step, then these two pieces of code should not be numbered in a sequential fashion. Rather, they could be numbered as 11-a and 11-b, thereby helping to alleviate confusion.

Just a thought.



Reproducible: Always
Steps to Reproduce:
Just read the doc.
Comment 1 Casey Boettcher 2004-06-07 22:07:11 UTC
*** Bug 53273 has been marked as a duplicate of this bug. ***
Comment 2 Tobias Scherbaum (RETIRED) gentoo-dev 2004-06-24 06:34:31 UTC
*** Bug 54022 has been marked as a duplicate of this bug. ***
Comment 3 Sven Vermeulen (RETIRED) gentoo-dev 2004-07-31 04:36:26 UTC
Right before; I've moved that instruction to the place where the CHOST variable is actually changed.