Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 114107 - stage 3 only version of handbook, can cause install to fail
Summary: stage 3 only version of handbook, can cause install to fail
Status: RESOLVED DUPLICATE of bug 112661
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: x86 Linux
: High major (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-11-30 22:25 UTC by corey
Modified: 2005-12-03 11:22 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
Proposed fix (gentoo-advisor.tgz,1.07 MB, application/x-compressed-tar)
2005-12-03 10:14 UTC, corey
Details

Note You need to log in before you can comment on or make changes to this bug.
Description corey 2005-11-30 22:25:03 UTC
The stage 1 and stage 2 instalation instructions have been removed from the
handbook.  I personally remember my initial confusion as to the stage 1, stage
2, and stage 3 decicion when i read the handbook for the first time, and I'm
guessing this is why stage 1 and 2 were removed, but it allows the following
situation to happen:

I went to install (planning to do a stage 1 or stage 2, (for the coolness
factor)) The new directions only contained a stage 3 install, so I just went
with that and downloaded the stage-3 athlon-xp tarball.  I unpacked it via the
handbook.  I went to edit make.conf and make.conf.example said that binaries
compiled for the athlon-xp will break on the athlon thunderbird (which I have).  

The handbook also states that only stage 1 users should change their CHOST
setting.  Which imples that grabbing the standard x86 stage-3 (which is 486
optimized?) and changing optimization to athlon (and CHOST acordingly) would be
a bad thing.  At this point the user is stranded.

There is a small blurb about stage1/stage2 in the faq, but there is something
very unsettling about it.  Perhaps either how terse it is, or that the
instructions are no longer in sequence.


I personally am fine as I have a old copy of the handbook that has stage 1 and
stage 2 information in it.   

We definately don't want to revert the handbook to the old "there's stage 1,
stage 2, and stage 3 types of installs, but were not going to recomend one
method over the other, you have to figure that out on your own" kind of
attitude, but what if we add the stage1/stage2 instructions back in as a
appendix, and adding astricks, or daggars, or something to mark the points in
the handbook instructions at which you should reference the stage1/stage2
appendix?  We should still be able to have a "don't do stage 1 or stage 2
installs, it's for people other then *you*" attitude, come across so that people
know to pick stage 3 by default.
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2005-12-01 01:38:11 UTC
A bootstrapping guide is in progress.
BTW, you could have used the i686 stage3

*** This bug has been marked as a duplicate of 112661 ***
Comment 2 corey 2005-12-03 10:14:50 UTC
Created attachment 73992 [details]
Proposed fix

running this should fix the problem
Comment 3 Jan Kundrát (RETIRED) gentoo-dev 2005-12-03 10:19:31 UTC
(In reply to comment #2) 
> Created an attachment (id=73992) [edit] 
> Proposed fix 
 
There's no point in attaching 1MB .tar files to the bugzilla, especially to 
resolved bugreports... 
Comment 4 corey 2005-12-03 11:22:12 UTC
A bootstrapping guide sounds great and will resolve the "missing stage1 and
stage2" issue.  

It appears from what he said that I could have used the pentium pro (i686)
stage3.  I found this to be non-obvious, and I assume that other people will
have the same confusion.  This is what my fix addresses.  Should I have opened
it as a new bug report?

And it's one meg because I left a executable in it just in case people were too
lazy to emerge the dependancy.