Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 53273 - 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 DUPLICATE of bug 53272
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Linux x86 Installation Guide (show other bugs)
Hardware: x86 Linux
: High minor (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-06-07 22:02 UTC by Casey Boettcher
Modified: 2005-07-17 13:06 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 Casey Boettcher 2004-06-07 22:02:47 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:06 UTC
This is a duplicate created accidentally when I resubmitted form data after having pressed the back button of the browser.

Apologies for the inconvenience.

Casey

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