Bug 369841

Summary:	Clarify terms and usages in handbook including openrc fixes
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Sven Vermeulen <sven.vermeulen>
Component:	Installation Handbook	Assignee:	Docs Team <docs-team>
Status:	RESOLVED FIXED
Severity:	normal
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/doc/en/handbook/
Whiteboard:
Package list:		Runtime testing required:	---
Bug Depends on:
Bug Blocks:	213988
Attachments:	Combined patchset

Description Sven Vermeulen 2011-06-02 19:02:15 UTC

The handbook has a few open edges when dealing with terminology or certain applications. One user (Tom de Havas) was so kind of providing lots of information on this, of which I'd like to summarize the following:

- We talk about "initrd" but use init ram filesystems. As most documents on the internet talk about the "initial ram disk" for "initrd", my suggestion would be to call it "init ram disk" instead of "init root disk" in the handbook. Users will then not be confused when they see initramfs.
- After pressing Alt-F2 on the LiveCD you don't need to log on, you immediately get a root prompt.
- The /etc/modules.autoload.d/kernel-2.6 stuff is confusing. The 3c59x example should clarify what this is (it's a driver for a specific 3Com network card family). Oh, and also the openrc change (/etc/conf.d/modules) should be used
- The command to launch links/lynx is missing.
- Mention that HTTP mirrors suffice (any mirror works, but only of HTTP are we certain that the user will not complain as he is already surfing)
- Mention that mirrorselect uses "spacebar" to select mirrors


Reproducible: Always

Comment 1 Sven Vermeulen 2011-06-02 19:02:49 UTC

Created attachment 275631 [details, diff]
Combined patchset

Patchset that corrects the above points. If you rather see separate patches, just yell and I'll make them separate.

Comment 2 Jan Kundrát (RETIRED) gentoo-dev

2011-08-03 08:27:11 UTC

In CVS, thanks.