Bug 62186

Summary:	Linguistic problems with the Gentoo Handbook
Product:	[OLD] Docs-user	Reporter:	Sven Vermeulen (RETIRED) <swift>
Component:	Handbook	Assignee:	Xavier Neys (RETIRED) <neysx>
Status:	RESOLVED FIXED
Severity:	normal	CC:	docs-team
Priority:	High
Version:	unspecified
Hardware:	All
OS:	All
URL:	http://www.gentoo.org/doc/en/handbook/handbook-x86.xml
Whiteboard:
Package list:		Runtime testing required:	---
Attachments:	Corrections to the Gentoo Handbook

Description Sven Vermeulen (RETIRED) gentoo-dev

2004-08-30 00:06:51 UTC

E-mail sent to www@gentoo.org by  John Richards <jn@jhrichards.plus.com>:

"""
I have recently been installing Gentoo for the first time. It is probably
only at a time like this that one reads a Handbook with great care right
through from beginning to end. As a linguist, it was quite clear to me that,
although he has a very good command of the language in general, English was
not the native language of the (primary) author. This has led to a number of
awkward or even incorrect phrases and passages. I append the list of the
ones I noted for your consideration. I hope they may be of help for future
editions.

Thank you for an excellent work. I have very much taken to Gentoo!!
"""

The list is attached to this bugreport.

Comment 1 Sven Vermeulen (RETIRED) gentoo-dev

2004-08-30 00:08:13 UTC

Created attachment 38469 [details]
Corrections to the Gentoo Handbook

Comment 2 Xavier Neys (RETIRED) gentoo-dev

2004-08-30 11:25:27 UTC

It's taken me some time to find all those mistakes ;-)
Of course, page numbers are useless.

John had two comments besides the language problems:
 1- reiserfs not readable from Windows
I was not even aware other filesystems were. If anyone knows what tools can be used to access the different FS in Linux, maybe it could be worth mentioning them in the FAQ but I'd rather leave the HB as it is, for now.
 2- why is ccache not installed by default?
No idea and I am not going to try to find out ;-) Anyway, why burden our users with the why's amd why not's? If you want it, emerge ccache, it can't be simpler.

Many thanks to you John.

Comment 3 SpanKY gentoo-dev

2004-08-30 15:50:35 UTC

ccache is a feature not everyone wants ... if it were part of the stage files that means it'd have to be added to the system targets and that's not going to happen

as for the reiserfs / dual boot junk ... ext2/ext3 is about the only filesystem that has any windows drivers written for it and those arent even totally stable/easy to use ... so i dont really think a note should be added about it (after all, we dont want newcomers mounting their partitions in windows and totally blowing it up / screwing the filesystems ...)