Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 37377 - Handbook, part 1. Grammar and typos.
Summary: Handbook, part 1. Grammar and typos.
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All All
: High normal (vote)
Assignee: Sven Vermeulen (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-01-06 01:19 UTC by Gregorio Guidi (RETIRED)
Modified: 2004-01-06 02:29 UTC (History)
1 user (show)

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 Gregorio Guidi (RETIRED) gentoo-dev 2004-01-06 01:19:18 UTC
Here's what I found reviewing part 1 of the handbook. Some of
these issues are just "things that don't sound good to me"
but as I'm not a native english speaker, I may be wrong.

2.a - Introduction - 1 para
> succesfully
< successfully

2.b - Gentoo KDE/Gnome LiveCD - 1 para
< does not contain GRP, distfiles, nor a portage snapshot
> does not contain GRP, source code, nor a portage snapshot
[the word "distfiles" was never used before and can cause confusion]

2.c - Booting the HPPA LiveCD(s) - 7 para
< When the boot is succesful,
> When the boot is successful,

3.d - Code listing 12
< we load the pcnet32 kernel
> we load the pcnet32 module

3.d - Code listing 13
< succesfull
> successful

3.d - Understanding Network Terminology - 4 para
< As is usual, the netmask
> As usual, the netmask

4.a - Partitions - 2 para
< A primary partition is a partition of which the information is stored in the MBR
> A primary partition is a partition which has its information stored in the MBR

4.a - Partitions - 3 para
< but as four partitions is too little, it is brought to life
> but as four partitions were too few, it was brought to life

4.a - Partitions - 3 para
< without loosing backwards compatibility.
> without losing backward compatibility.

4.b - How Many and How Big? - 1 para
< security and makes backups more easy
> security and makes backups easier

4.i - Initialising the Partitions - 1 para
< you first need activate LVM
> you first need to activate LVM

4.i - Set up the Volume Group - 1 para
< where these devices files are located
> where these device files are located

4.j - Introduction - 1 para
< with what we use default in this handbook
> with what we use as default in this handbook

4.k - Code listing 48
< Bind-mounting proc and dev
> Bind-mounting proc

5.a - 4 para
< you have to choose for the alternative option
> you have to choose the alternative option

5.b - Downloading the Stage Tarball - 2 para
< For there on you should see
> There you should see

6.a - Optional: Selecting Mirrors - 1 para
< If you are booted
> If you have booted

6.a - Optional: Selecting Mirrors - 1 para
< for both Portage as source code
> for both Portage and source code

6.a - Copy DNS Info - 1 para
< and that is copy over the DNS information
> that is copying over the DNS information

6.a - Configuring the USE variable - 2 para
< you can define with what options a package should be compiled with
> you can define what options a package should be compiled with

8.b - Creating /etc/fstab - 1 para
< /etc/fstab uses a special syntaxis
> /etc/fstab uses a special syntax

8.b - Creating /etc/fstab - 1 para
< The sixth field is used by fsck the order
> The sixth field is used by fsck to determine the order

8.b - Creating /etc/fstab - 3 para
< Lets take a look at how we write down
> Let us take a look at how we write down

8.c - Configuring your Network - 6 para
< So lets give two examples
> So let us give two examples

9.b - Understanding GRUB's terminology - 3 para
< and who are a little lost in the GRUB numbering scheme.
> and that are a little lost in the GRUB numbering scheme.

9.b - Code listing 5
< Which listing to boot default
> Which listing to boot as default

9.h - Alternative: Manual yaBoot Configuration - 3 para
< Once yaboot.conf is set up how you want it
> Once yaboot.conf is set up the way you want it

10.a - 1 para
< system tools of which we cannot provide
> system tools for which we cannot provide

10.a - 1 para
< We also said that the we would install
> We also said that we would install

10.a - 4 para
< use syslog-ng as it is very powerfull
> use syslog-ng as it is very powerful

10.b - 2 para
< is similar with installing a system logger
> is similar to installing a system logger

10.b - Note
< using the prebuild packages
> using the precompiled packages
["prebuilt" should be the correct word, but I like more "precompiled".
If you're interested, "prebuilt" is also in 2.a-Architectures,
7.a-Choosing a Kernel (2 times), 11.b (near the end)]

11.b - Optional: Install Extra Packages - 2 para
< copy over the prebuild binaries
> copy over the precompiled binaries

11.b - Optional: Install Extra Packages - 3 para
< copy over all prebuild binaries
> copy over all precompiled binaries

11.b - Code listing 8
< Copy over prebuild binaries
> Copy over precompiled binaries

11.b - Optional: Install Extra Packages - 4 para
< CD-2 contains several prebuild binaries
> CD-2 contains several precompiled binaries
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2004-01-06 02:19:59 UTC
Thanks. I've fixed most of them in CVS so they should show up within the next hour. I kept the prebuilt as compiling is only a small step of the building process. I did fix prebuild->prebuilt though. 

I believe the only thing I didn't change was 
    < and who are a little lost in the GRUB numbering scheme.
    > and that are a little lost in the GRUB numbering scheme.
as the "who" is about the users, not the disks/partitions. I'm not 100% confident if the right way is "the users who" or "the users that", so I've kept it as is.

Thanks for the feedback!
Comment 2 Gregorio Guidi (RETIRED) gentoo-dev 2004-01-06 02:29:56 UTC
Wow, that was fast.
Thanks a lot, part 2 now...