Bug 53272 – If CHOST altered, user needs to give source command before or after bootstrap.sh?

• Product: [OLD] Docs-user
• Status: RESOLVED FIXED

[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) 2004-06-24 06:34:31 UTC]

*** Bug 54022 has been marked as a duplicate of this bug. ***

[Comment 3 Sven Vermeulen (RETIRED) 2004-07-31 04:36:26 UTC]

Right before; I've moved that instruction to the place where the CHOST variable is actually changed.