On Tue, February 8, 2005 10:03 am, Nick Rout said: > is one error an appalling level of documentation? > > I think the documentation does a good job of explaining what needs to be > done, and why, and how to. > > No, I think all the install documentation is apalling. The fact that I don't like the style is a matter of personal taste, and I discount it. But, I reiterate my earlier point that it just shouldn't be necessary to make all of these manual steps, or to learn half the potted history of linux just to get a machine up and running.
As you pointed out, there is an abridged version somewhere, but I went to the Gentoo site, and looked for resources on how to build a gentoo system. The documentation that I'm criticising is where I ended up. I've learned over the years to read *all* of the documentation before I start something new. I'm now working through it, and I'm on 'page' 8 of 12, and have needed extra resource from this list to get this far. Now, I'm not really a novice at this kind of thing... (: Cheers, Steve > On Tue, 08 Feb 2005 09:50:59 +1300 (NZDT) > Steve Holdoway <[EMAIL PROTECTED]> wrote: > >> <rant> >> Given that there will be (at least) a large minority of people who want >> to >> try something a bit more hardcore, and upgrade from ubuntu or similar, >> then the apalling level of documentation that comes along with gentoo >> will >> probably put them off for life. The bug has been found and documented, >> so >> why is page 6 not reflecting the change? >> >> Is it a rite of passage, like learning all the switches to cpio? >> </rant> >> >> Come back debian, all is forgiven (: >> >> Steve >> >> On Tue, February 8, 2005 9:31 am, Nick Rout said: >> > Here is a description of the ipv6 problem i mentioned earlier: >> > >> > This is copied from a message on the gentoo-user list on 19 January. >> > >> > Personally I never use mirrorselect as there are no official mirrors >> in nz >> > and jetstreamgames does me nicely. >> > >> > Also remember that you can do an install from the sources on the >> universal >> > livecd, or the binaries on the packages cd. >> > >> > cheers. >> > >> > "The sequence of steps given in... >> > http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?full=1#book_part1_chap6 >> > appears to be causing problems, according to traffic on the Gentoo >> users >> > mailing list. Here is my diagnosis of what is going wrong. >> > >> > The current sequence in Chapter 6a is... >> > - first run mirrorselect >> > - then chroot >> > >> > The current LiveCD appears to have IPV6 networking enabled. >> > Paradoxically, it is causing problems for users whose ISPs support >> IPV6, >> > or at least IPV6 tunneling over IPV4. Here is the situation in detail >> > >> > - mirrorselect tries a whole bunch of mirrors, including several >> > IPV6-only mirrors >> > >> > - If your ISP *DOES NOT* support IPV6 (including IPV6 tunneling) >> > things work OK. Attempting to contact the IPV6-only mirrors >> fails, >> > and mirrorselect picks a bunch of IPV4-accessable mirrors, and >> > things work OK. >> > >> > - If your ISP *DOES* support IPV6 (or at least IPV6 tunneling), you >> > run into problems. Since hardly anyone is on IPV6, the IPV6-only >> > mirrors have a lot less traffic, and are much more responsive to >> > download requests. So mirrorselect's speed-tests will always >> > favour the IPV6-only sites, and put them in your MIRRORS variable. >> > >> > Apparently, while the LiveCD has IPV6-enabled networking, the >> chrooted >> > environment is IPV4-only. After chrooting, you have IPV4-only >> networking >> > software trying to contact IPV6-only servers... oops. This is >> consistent >> > with the problems reported on the mailing list, by *SOME* people >> > (i.e. those whose ISP supports IPV6 in some manner). >> > >> > The solution to this problem is quite simple... >> > - first chroot >> > - then run mirrorselect >> > >> > This will cause mirrorselect to choose only servers that can be >> > accessed from the chrooted environment. Today, this will result in >> > mirrorselect only picking IPV4-accessable mirrors. Somewhere down the >> > road, if/when the Gentoo install puts IPV6 networking into the >> chrooted >> > environment, then mirrorselect will pick up IPV6 mirrors." >> > >> > >> > >> > >> > On Tue, 08 Feb 2005 08:55:31 +1300 (NZDT) >> > Steve Holdoway <[EMAIL PROTECTED]> wrote: >> > >> >> Thanks Nick, >> >> >> >> Maybe now I'll break the 24 hour barrier for a single install (: >> >> >> >> Cheers, >> >> >> >> Steve >> >> On Tue, February 8, 2005 8:40 am, Nick Rout said: >> >> > On Tue, 2005-02-08 at 08:04 +1300, Steve Holdoway wrote: >> >> >> So, using the mirrorselect command to create myself a list of the >> 4 >> >> most >> >> >> useful sources gives me three that are uncontactable, and one in >> >> poland >> >> >> with no current sources on. >> >> >> >> >> >> Can anyone suggest some useful sources so I can get this thing off >> >> the >> >> >> ground? >> >> > >> >> > /etc/make.conf >> >> > >> >> > GENTOO_MIRRORS="http://linux.jetstreamgames.co.nz/gentoo"; >> >> > >> >> > mirrorselect does not work well round this backwater of the >> internet, >> >> > and it also has problems getting confused about ipv6 mirrors. >> >> > >> >> >> >> >> >> Cheers, >> >> >> >> >> >> >> >> >> Steve >> >> >> >> >> > -- >> >> > Nick Rout <[EMAIL PROTECTED]> >> >> > >> >> > >> >> >> >> >> >> -- >> >> Artificial Intelligence is no match for natural stupidity. >> > >> > -- >> > Nick Rout <[EMAIL PROTECTED]> >> > >> > >> >> >> -- >> Artificial Intelligence is no match for natural stupidity. > > -- > Nick Rout <[EMAIL PROTECTED]> > > -- Artificial Intelligence is no match for natural stupidity.
