Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 369841 - Clarify terms and usages in handbook including openrc fixes
Summary: Clarify terms and usages in handbook including openrc fixes
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook/
Whiteboard:
Keywords:
Depends on:
Blocks: 213988
  Show dependency tree
 
Reported: 2011-06-02 19:02 UTC by Sven Vermeulen
Modified: 2011-08-03 08:27 UTC (History)
0 users

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


Attachments
Combined patchset (handbook.patch,9.12 KB, patch)
2011-06-02 19:02 UTC, Sven Vermeulen
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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.