On Fri, Nov 30, 2012 at 10:44:31AM -0500, Richard Yao wrote:
> On 11/30/2012 06:46 AM, Sven Vermeulen wrote:
> > On Nov 29, 2012 10:24 AM, "Markos Chandras" <hwoar...@gentoo.org> wrote:
> > > > We could slightly simplify the handbook installation procedure if we
> > > > told people to use emerge-webrsync to fetch the initial snapshot. What
> > > > do people think?
> > >
> > > Seems a good improvement to me.
> > 
> > I'm ok with it as well. I'll draft up something. I suspect emerge-webrsync
> > is available on all platforms?
> 
> It is part of sys-apps/portage.

Okay, I've updated the instructions.

First, I removed the references to the stage3 snapshots on the "Universal
CD" as I don't think we have a (recent enough) Universal CD, and we would
recommend the stage3 files from our mirrors anyway.

Second, the Portage tree snapshots are now installed through emerge-webrsync
(which means the entire section on downloading the tarballs, checking
integrity, extracting is now a single paragraph).

Finally, the section on updating the Portage tree (using emerge --sync) is
now marked as optional, with the remark that if you're behind a firewall you
can safely ignore this section as the user will already have a quite
up-to-date tree installed.

I don't know if we should remove the section altogether (about emerge
--sync) or not. It is a small step and users *will* create bug reports about
it if they don't notice it in the documentation anymore. Marking it optional
seems to be a good approach here.

Wkr,
        Sven Vermeulen

PS Commit was made a few minutes ago, so please give it an hour before it
shows up on the site.

Reply via email to