Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 238 - mistakes in the "install from source" and "desktop" docs
Summary: mistakes in the "install from source" and "desktop" docs
Status: VERIFIED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Grant Goodyear (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2002-01-19 14:26 UTC by aeoo
Modified: 2002-12-15 21:08 UTC (History)
0 users

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description aeoo 2002-01-19 14:26:59 UTC
Not in any particular order, sorry ;).

--- Install from Source ---

1. It would be nice to add:

mkfs.xfs -d agcount=3 -l size=32m

to give people better experience with xfs, as suggested by Daniel.

2. Mention that if you plan to replace reiserfs with xfs, you will need to force
mount your partitions with 'mount -t xfs ..." option, or else, it will think
your xfs partition is still reiserfs and do all kinds of not nice things to you,
like replay the log and corrupt it?  But, even if you do this, you'll still get
errors on boot.  This is a known problem in mount.  This *only* affects people
who reformat their reiserfs partitions as xfs.

3. Code listing 21 needs to replace:

mv bzImage bzImage.orig

with

mv /boot/bzImage /boot/bzImage.orig

4. Code listing 32 needs to be deleted because it duplicates code listing 30.

5. For code listing 36 you need to stress to the user *NOT* to put white space
after the comma in 'root (hd0,0)'.  This might seem obvious or minor, but it
caused me a 5 min delay while I figured it out.

6. Code listing 25 is inacurate, imo.  It doesn't set fsck PASS field correctly.
 Here is an example of mine:

/dev/hdg7          /mnt/boot   ext3      noauto     1    2
/dev/hdg9          /           xfs       defaults   0    1
/dev/hdg8          none        swap      sw         0    0
/dev/hdg10         /home       xfs       defaults   0    2
/dev/hdg11         /usr        xfs       defaults   0    2
/dev/cdroms/cdrom0 /mnt/cdrom  iso9660   noauto,ro  0    0
proc               /proc       proc      defaults   0    0

I adjusted the spacing to avoid wrap around in bugzilla.  The logic behind this
setup is: 0 is used for partitions that do not need to be fsck'ed, 1 is used for
partitions that need to be fscked on the first pass, 2 is second pass, etc.  So,
root needs to be clean before other partitions can be fscked and mounted.  At
least that's the idea I get from the man page.  Please correct me if I am wrong.

--- Desktop ---

7. In code listing 17, delete:

/etc/init.d/alsa start

because this init file is *not* in media-sound/alsa-driver as might seem
logical.  It's actually in media-sound/alsa-utils.  The deleted line belongs in
code listing 24.

8. It might be nice to show an example of a good /etc/X11/XF86Config file,
because a nicely configured one is nothing like the raw one that's provided by
XFree86.
Comment 1 Daniel Robbins (RETIRED) gentoo-dev 2002-01-21 09:36:31 UTC
g2boojum, could you take a look at these when you have time?
Comment 2 Grant Goodyear (RETIRED) gentoo-dev 2002-01-21 14:27:05 UTC
Fixed, although I decided _not_ to add a "good" XF86Config file since I'm not
sure I'm qualified to judge.  I did add a link to chouser's article, however. 
Drobbins  will still need to update the site before these changes take effect.
Comment 3 Grant Goodyear (RETIRED) gentoo-dev 2002-01-29 12:27:38 UTC
Now on the site.
Comment 4 John Davis (zhen) (RETIRED) gentoo-dev 2002-12-15 21:05:40 UTC
Trying to clean out the docs-depricated so that I can close the catergory ...