Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 29649 - x86 Quick Install Guide
Summary: x86 Quick Install Guide
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Linux x86 Installation Guide (show other bugs)
Hardware: x86 Linux
: High enhancement (vote)
Assignee: Sven Vermeulen (RETIRED)
URL: http://dev.gentoo.org/~swift/quickins...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-09-26 00:31 UTC by Steven Wagner
Modified: 2003-10-16 07:40 UTC (History)
1 user (show)

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


Attachments
HTML file so that it stays available :) (quickinstall.html,17.79 KB, text/html)
2003-09-26 00:58 UTC, Sven Vermeulen (RETIRED)
Details
Updated version, now in GuideXML (quickinstall2.xml,14.35 KB, text/plain)
2003-09-27 20:19 UTC, Steven Wagner
Details
Here is the html output of the previously attached GuideXML file. (install.html,21.43 KB, text/html)
2003-09-27 20:20 UTC, Steven Wagner
Details
New version. XML (quickinstall2.xml,10.86 KB, text/plain)
2003-10-03 02:47 UTC, Steven Wagner
Details
New version. HTML (install.html,19.06 KB, text/html)
2003-10-03 02:49 UTC, Steven Wagner
Details
Quick Installation Reference (quickinstall.xml,12.23 KB, text/xml)
2003-10-04 09:43 UTC, Sven Vermeulen (RETIRED)
Details
Quick Installation Manual (quickinstall.xml,11.77 KB, text/xml)
2003-10-09 05:44 UTC, Sven Vermeulen (RETIRED)
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Steven Wagner 2003-09-26 00:31:39 UTC
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:
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2003-09-26 00:58:11 UTC
Created attachment 18350 [details]
HTML file so that it stays available :)
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2003-09-26 00:58:52 UTC
Great job. We where thinking of a quick installation reference, but we never
started on it. This seems to be a very nice start :)
Comment 3 Steven Wagner 2003-09-27 20:19:10 UTC
Created attachment 18407 [details]
Updated version, now in GuideXML

Feedback appreciated.
Comment 4 Steven Wagner 2003-09-27 20:20:48 UTC
Created attachment 18408 [details]
Here is the html output of the previously attached GuideXML file.
Comment 5 Steven Wagner 2003-10-01 15:55:53 UTC
So what else needs to be done to put this live?
Comment 6 Benny Chuang (RETIRED) gentoo-dev 2003-10-01 16:51:48 UTC
it's better to put the codes in <i> tags..
Comment 7 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-01 21:27:07 UTC
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 :(
Comment 8 Steven Wagner 2003-10-03 02:47:35 UTC
Created attachment 18657 [details]
New version.  XML
Comment 9 Steven Wagner 2003-10-03 02:49:26 UTC
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.
Comment 10 Benny Chuang (RETIRED) gentoo-dev 2003-10-03 15:35:34 UTC
(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
Comment 11 Zack Gilburd (RETIRED) gentoo-dev 2003-10-03 17:23:36 UTC
> 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).
Comment 12 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-04 09:43:28 UTC
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 :)
Comment 13 Steven Wagner 2003-10-04 19:22:46 UTC
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
___
Comment 14 Steven Wagner 2003-10-04 19:25:11 UTC
last comment should have said
image = /boot/kernel-<kernel version>
rather then
image = /boot/kernel-2.4.20-gentoo-r6
Comment 15 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-05 02:54:00 UTC
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.
Comment 16 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-09 05:43:23 UTC
I've shortened the quickinstall.xml a bit more. You can find the recent version
on http://dev.gentoo.org/~swift/quickinstall.html
Comment 17 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-09 05:44:07 UTC
Created attachment 19001 [details]
Quick Installation Manual
Comment 18 Steven Wagner 2003-10-09 13:32:11 UTC
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.
Comment 19 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-16 07:40:31 UTC
I've committed this one in the CVS.