Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 116837 - Several bugs and a couple of suggestions
Summary: Several bugs and a couple of suggestions
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-12-26 19:47 UTC by Chris Bruner
Modified: 2005-12-31 08:49 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 Chris Bruner 2005-12-26 19:47:54 UTC
Problems with the Gentoo Install documentation

1. Alternative install http://www.gentoo.org/doc/en/handbook/2005.1/handbook-x86.xml?full=1#download

needs to download a snapshot as well. Not mentioned. Also distfile download is not handled.
Instead it says to proceed to http://www.gentoo.org/doc/en/handbook/2005.1/handbook-x86.xml?full=1#installing_portage 

which assumes the files are on the CD, (on a minimal install they are not).

2. A warning is given about configuring the make.conf

Warning:  Do not make any modifications to the USE variable if you are performing a stage3 with GRP installation. You can alter the USE variable after having installed the packages you want. Gremlins are known to attack your system if you ignore this warning!


GRP although defined earlier, means nothing to a new user, and how would a new user know if he was using that with a Minimal or Universal install. 

Earlier in the documentation it says that GRP is not available for all architectures (and is apparently for the one I am using). However it is not known if I'm actually using this with a minimal or universal install.	

I want to use alsa, but -alsa is defined in the use. Now I don't know if I can change it or not.

Later after the chroot the USE variable is configured, so why not shorten this section to just say, "Leave the USE varaiable until later"

(The warning later makes much more sense, in that it implies that GRP can be done later or not)


3. http://www.gentoo.org/doc/en/handbook/2005.1/handbook-x86.xml?full=1#book_part1_chap6
has an unnecessary -L

cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf


4. emerging the kernel dies
USE="-doc" emerge gentoo-sources
Calculating dependencies ...done!
>>> emerge (1 of 1) sys-kernel/gentoo-sources-2.6.14-r5 to /
mv: cannot stat `/var/tmp/portage/gentoo-sources-2.6.14-r5/temp/environment': No such file or directory
>>> md5 files   ;-) gentoo-sources-2.4.32-r1.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.14-r1.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.14-r5.ebuild
>>> md5 files   ;-) gentoo-sources-2.4.31-r1.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.12-r9.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.14-r4.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.14-r3.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.12-r10.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.14.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.13-r5.ebuild
>>> md5 files   ;-) gentoo-sources-2.6.14-r2.ebuild
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.14-r2
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.14-r1
>>> md5 files   ;-) files/digest-gentoo-sources-2.4.32-r1
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.12-r9
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.12-r10
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.14-r5
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.14-r3
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.13-r5
>>> md5 files   ;-) files/gentoo-sources-2.4.CAN-2004-1056.patch
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.14-r4
>>> md5 files   ;-) files/digest-gentoo-sources-2.6.14
>>> md5 files   ;-) files/gentoo-sources-2.4.81106.patch
>>> md5 files   ;-) files/digest-gentoo-sources-2.4.31-r1
>>> md5 files   ;-) files/Changelog-2.4.bz2
>>> md5 src_uri ;-) linux-2.6.14.tar.bz2
>>> md5 src_uri ;-) genpatches-2.6.14-6.base.tar.bz2
>>> md5 src_uri ;-) genpatches-2.6.14-6.extras.tar.bz2
ACCESS DENIED  open_wr:   /newroot/dev/pts/0
ACCESS DENIED  open_wr:   /newroot/dev/pts/0
>>> Checking linux-2.6.14.tar.bz2's mtime...
>>> Checking genpatches-2.6.14-6.base.tar.bz2's mtime...
>>> Checking genpatches-2.6.14-6.extras.tar.bz2's mtime...
>>> WORKDIR is up-to-date, keeping...
--------------------------- ACCESS VIOLATION SUMMARY ---------------------------
LOG FILE = "/var/log/sandbox/sandbox-sys-kernel_-_gentoo-sources-2.6.14-r5-12514.log"

open_wr:   /newroot/dev/pts/0
open_wr:   /newroot/dev/pts/0
--------------------------------------------------------------------------------



Fix is 
mount -o bind /dev /mnt/gentoo/dev
  
before chroot


In Configuring the kernel

Suggests using lspci by emerging it.   It's actually already available from the CD.  Switch to anther terminal, run lspci to see what is available then switch back. (although it is useful to have around)

alt-f2
lspci
alt-f1

Another nice trick is to copy config.gz from /proc to /usr/src/linux
gunzip it (also from the cdrom) move it to .config in order to have a default configuration setup (of the same one that you are currently using).

alt-f2
cp /proc/config.gz /mnt/gentoo/usr/src/linux/
cd /mnt/gentoo/usr/src/linux
gunzip config.gz
mv config .config
alt-f1


9.c. Optional: File Indexing

 If you want to index your system's files so you are able to quickly locate them using the locate tool, you need to install sys-apps/slocate.

Can't do this as there's already an slocate group

>>> md5 files   ;-) files/digest-slocate-2.7-r8
>>> md5 src_uri ;-) slocate-2.7.tar.gz
>>> md5 src_uri ;-) slocate-2.7-debian.patch.bz2
 * The 'slocate' group has been renamed to 'locate'.
 * You seem to already have a 'slocate' group.
 * Please rename it:
 * groupmod -n locate slocate

!!! ERROR: sys-apps/slocate-2.7-r8 failed.
!!! Function pkg_setup, Line 28, Exitcode 0
Comment 1 SpanKY gentoo-dev 2005-12-26 20:09:33 UTC
> 3. has an unnecessary -L
> 
> cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf

no, it is needed because resolv.conf may be a symlink and cp may be an alias which causes symlinks to be copied as symlinks

keeping the -L is sane for everyone

> 4. emerging the kernel dies
> open_wr:   /newroot/dev/pts/0
> open_wr:   /newroot/dev/pts/0

this is being covered elsewhere, search bugzilla

> 9.c. Optional: File Indexing
> 
> Can't do this as there's already an slocate group

not a documentation issue really, the package clearly describes what needs to be done ... and it will be a none issue in the next release
Comment 2 Xavier Neys (RETIRED) gentoo-dev 2005-12-31 08:49:59 UTC
You're either reading the wrong handbook, or the wrong installation CD.
It's all explained right at the beginning.
http://www.gentoo.org/doc/en/handbook/2005.1/handbook-x86.xml?part=1&chap=1#doc_chap1_sect3