Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 297245 - Minor bugs in install docs
Summary: Minor bugs in install docs
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: AMD64 Linux
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-12-17 00:56 UTC by Stefan Salewski
Modified: 2010-02-01 21: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 Stefan Salewski 2009-12-17 00:56:32 UTC
I am doing a fresh install from recent minimal install CD on a notebook following gentoo's instructions. I found 3 points which are not fully correct in docs, most serious first:

http://www.gentoo.org/doc/en/xorg-config.xml

# emerge xorg-server
# startx
>If you see an ugly, loathsome, repulsive, deformed window manager, that's twm.

But twm and xterm is not installed at this time, so we get an empty black screen when we test display prior to installing Gnome, KDE etc.

>http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=8

>rc-update add net.eth0 default

Seems to be obsolete now. I need this to suppress autostart:
LR500 ~ # cat /etc/conf.d/rc |grep eth
RC_PLUG_SERVICES="!net.eth0 !net.wlan0"

http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=11

>games  	be able to play games
>plugdev  	 Be able to mount and use pluggable devices ...

LR500 ~ # useradd -m -G users,wheel,audio,plugdev,games -s /bin/bash john
useradd: unknown group games
I think plugdev is unknown too without hal.

Best wishes,

Stefan Salewski


Reproducible: Always

Steps to Reproduce:
1.Install from minimal CD following instructions from Gentoo Handbook.
2.
3.
Comment 1 Stefan Salewski 2009-12-17 02:51:59 UTC
And here is one more typo:

http://www.gentoo.org/doc/en/xorg-config.xml

Code Listing 3.2: Editing 10-x11-input.fdi
<merge key="input.xkb.options" type="string">terminate:ctrl_alt_bksp</merge>>

I think there should be only one ">" at the right.
Comment 2 nm (RETIRED) gentoo-dev 2009-12-17 04:44:54 UTC
(In reply to comment #0)
> But twm and xterm is not installed at this time, so we get an empty black
> screen when we test display prior to installing Gnome, KDE etc.

Right, latest stable stuff does not install twm or xterm and a couple other packages.
 
> >rc-update add net.eth0 default
> 
> Seems to be obsolete now. I need this to suppress autostart:
> LR500 ~ # cat /etc/conf.d/rc |grep eth
> RC_PLUG_SERVICES="!net.eth0 !net.wlan0"

That's your own unique case. Nearly everyone else uses it.

> >games  	be able to play games
> >plugdev  	 Be able to mount and use pluggable devices ...
> 
> LR500 ~ # useradd -m -G users,wheel,audio,plugdev,games -s /bin/bash john
> useradd: unknown group games
> I think plugdev is unknown too without hal.

Nope. That's your own error. HAL is installed by default with xorg-server, so if you don't have it, that's your own configuration choice. Upstream expects HAL to be installed, as do our X packagers.

The games group is something else; it's only relevant once you install a game.

The other points have been fixed in CVS for the xorg guide.
Comment 3 Stefan Salewski 2010-02-01 21:49:41 UTC
On 2009-12-17 Stefan Salewski wrote:

>>http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=8
>>rc-update add net.eth0 default

>Seems to be obsolete now.

Please check, seems that "rc-update add net.eth0 default" is still advertised in Gentoo documentation. But it is obsolete, most net interfaces are started without this. And please note: People get confused if they remove net interfaces from rc-update list but interface is active again after reboot.