I kicked back this afternoon and went through each and every step of the x86 Install Guide and converted it into a Quick Guide. It has all the important stuff, and just leaves out the verbose information. So basially, if someone already has the understanding that the main guide gives them, then they can use this as a command reference. URL included. Reproducible: Always Steps to Reproduce:
Created attachment 18350 [details] HTML file so that it stays available :)
Great job. We where thinking of a quick installation reference, but we never started on it. This seems to be a very nice start :)
Created attachment 18407 [details] Updated version, now in GuideXML Feedback appreciated.
Created attachment 18408 [details] Here is the html output of the previously attached GuideXML file.
So what else needs to be done to put this live?
it's better to put the codes in <i> tags..
What needs to be done is verifying the guide, checking the length (max 2 pages). If we cannot get the length right, split the guide up in seperate guides for stage{1,2,3} +- networking and stage3+GRP etc. It should also be reviewed heavily. Don't attempt to get something this important online that fast, otherwise quality might be the victim of it :(
Created attachment 18657 [details] New version. XML
Created attachment 18658 [details] New version. HTML Comments please. Removing stage 1 and 2 steps would only take out about 5 lines, which would not be worth it since the guide would then be lacking. This new version is much more compressed in size, and a few errors were fixed.
(or you can download latest tarball online with lynx http://gentoo.oregonstate.edu/releases/x86/1.4/ ) * lynx should be replaced with links *there should be a link to dri-howto I can see your efforts in quick guide, but the guide shouldn't just be a list of commands to enter. also, grub.conf might look very confusing to a newbie
> I can see your efforts in quick guide, > but the guide shouldn't just be a list of > commands to enter. > > also, grub.conf might look very confusing to a newbie This guide is supposed to be for those who already know what they're doing when it comes to Gentoo installs. The doc is to serve as a list to jog one's memory, if you will. Those that will be using this guide will already know the syntax of the config files and how to (ab)use them. In short, the doc has my approval to be left as a list of pure commands. In fact, a doc that provides the list of commands is Just What the Doctor Ordered(TM).
Created attachment 18748 [details] Quick Installation Reference I've removed some obsolete information (if you can call it obsolete). The reason for the quick installation reference is, as you expressed in the <abstract>, meant to have people that _have_ experience with installing Gentoo informed about the necessary steps. With that in mind, I've removed some information (such as RAID stuff as it's being bugreported anyway) so that the guide is a little bit more tight. If you use ?style=printable and you have setup your browser with a smaller font, you can get this on two pages. *pfew* this isn't easy :)
I read through the whole thing. Looks great!! Really pushed it that extra mile I couldn't see. I wasn't able to find any information on hotplug being genkernel specific. ? >> # emerge -k xfree gnome kde + mozilla openoffice-bin This is all that is actually needed for the lilo.conf. ___ boot = /dev/hda prompt timeout = 50 default = Gentoo image = /boot/kernel-2.4.20-gentoo-r6 root = /dev/hdax label = Gentoo other = /dev/hdax label = XP ___
last comment should have said image = /boot/kernel-<kernel version> rather then image = /boot/kernel-2.4.20-gentoo-r6
Regarding the lilo.conf, it depends on if you manually copied over bzImage to /boot, or copied _and_ renamed it. I always rename it, but some prefer to have it called bzImage. I'll see if I can have the user rename the kernel image so that the lilo.conf is shortened. Hotplug is not solely for genkernel, but chances are very slim that you need it if you manually compiled your kernel. This is because most of the time, if you compile manually, you only compile the necessary modules, and have them started by adding them to /etc/modules.d/modules.autoload-2.4 (or whatever the file is called), or don't even use modules. In such cases, hotplug doesn't do anything except slowing down the boot process. Hotplug scans all available modules and tries to load them. That's its job, which it does well, but it is only needed if you use genkernel.
I've shortened the quickinstall.xml a bit more. You can find the recent version on http://dev.gentoo.org/~swift/quickinstall.html
Created attachment 19001 [details] Quick Installation Manual
It keeps getting better. :) # emerge -k pcmcia-cs (or emu10k1, nforce-net, nforce-audio, e100, e1000, ati-drivers, rp-pppoe) nvidia-kernel is missing from this line. That is the only thing I saw.
I've committed this one in the CVS.