Gentoo Archives: gentoo-dev

From: Olav Kolbu <olav.kolbu@××××××××.no>
To: gentoo-dev@g.o
Subject: [gentoo-dev] "Install Instructions" changes
Date: Sun, 14 Jul 2002 05:17:50
1 Overall, good instructions. A couple of comments:
3 1. In section 14, you might also want to list redhat-sources, since quite
4 a few people have good experiences with all the work RedHat puts into
5 their kernel tree. It's one of the more stable "branches" around.
8 2. Same section, a bit further down. When mentioning which kernel options
9 to enable, be much more specific and detailed. E.g. the doc mentions
10 "Device File System". There is no such option, it's really called "/dev
11 file system support". This will be very confusing for newbies. I suggest
12 you go as far as listing the necessary options this way:
14 "File systems --->"
15 "/dev file system support (EXPERIMENTAL)"
17 I.e. cut'n'paste from the 'make menuconfig' output, with the complete menu
18 path to where the option is, for every option needed.
21 3. A large portion of people have cd burner today, so might as well write
22 a small paragraph on how they can get that working. Was pondering a
23 separate document, but since it's a kernel compile to enable it, it might
24 as well go in from the start. I.e.
25 "ATA/IDE/MFM/RLL support --->"
26 "IDE, ATA and ATAPI Block devices --->"
27 "SCSI emulation support"
28 ,
29 "SCSI support --->"
30 "SCSI generic support"
32 and a few of the CDROM filesystem types (can't remember off hand which of
33 them are default enabled).
35 Then tell them about the hd[abcd]=ide-scsi argument to the kernel that
36 should go in the menu.lst file.
39 4. This is more an install change suggestion than an install documentation
40 change. Both the fstab editing and the menu.lst editing can easily be
41 scriptet, since you have all the needed information at this point (all the
42 relevant filesystems are mounted). On one hand it helps the newbies learn
43 a bit about fstab and grub when they're forced to do it manualle, but on
44 the other hand it quickly gets old for people who have done it before. :-)
46 OK