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.