Subject: More Guide patches
To: NetBSD Docs <netbsd-docs@NetBSD.org>
From: Ceri Davies <ceri@submonkey.net>
List: netbsd-docs
Date: 12/12/2004 16:22:16
--37cJpJlYZwAfNbm5
Content-Type: multipart/mixed; boundary="KaGhPsiNaI6/sRd6"
Content-Disposition: inline
--KaGhPsiNaI6/sRd6
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Some spelling corrections, some grammar, and some corrections to what
I believe are Deutsch-isms.
Ceri
--=20
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former. -- Einstein (attrib.)
--KaGhPsiNaI6/sRd6
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="chap-2boot.xml.diff"
Content-Transfer-Encoding: quoted-printable
Index: chap-2boot.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /a/NetBSD/ncvs/htdocs/guide/en/chap-2boot.xml,v
retrieving revision 1.13
diff -u -r1.13 chap-2boot.xml
--- chap-2boot.xml 3 Dec 2004 00:03:59 -0000 1.13
+++ chap-2boot.xml 12 Dec 2004 15:59:32 -0000
@@ -253,7 +253,7 @@
=20
<para>It's time to add new users to the system, since you don't
want to use the root account for your daily work (yes, we're
- serious about that!). &os; offers the &man.useradd.8; manpage
+ serious about that!). &os; offers the &man.useradd.8; utility
to create user accounts. For example, to create a new user:</para>
=20
<screen>&rprompt; <userinput>useradd -m joe</userinput></screen>
@@ -261,7 +261,7 @@
<para>The defaults for the &man.useradd.8; command can be
changed; see the &man.useradd.8; man page.</para>
=20
- <para>Any accounts that can &man.su.1; to root require the account
+ <para>Accounts that can &man.su.1; to root are required
to be in the=20
"wheel" group. This can be done when the account is created by
specifying a secondary group:</para>
@@ -300,7 +300,7 @@
=20
<para>Shadow passwords are enabled by default on &os;: all the
passwords in <filename>/etc/passwd</filename>=20
- contain an <quote>*</quote>; the encrypted passwords belong to
+ contain an <quote>*</quote>; the encrypted passwords are stored in
another file,=20
<filename>/etc/master.passwd</filename>, that can be read only by
root.
@@ -308,12 +308,12 @@
password file, the program opens a copy of
<filename>/etc/master.passwd</filename>; when you exit,
&man.vipw.8; checks the validity of the copy, creates a
- new <filename>/etc/passwd</filename> and installs a new
+ new <filename>/etc/passwd</filename> and installs the new
<filename>/etc/master.passwd</filename> file.
Finally, &man.vipw.8; launches
&man.pwd.mkdb.8;, which creates the files
<filename>/etc/pwd.db</filename> and
- <filename>/etc/spwd.db</filename>, two databases equivalent to
+ <filename>/etc/spwd.db</filename>, two databases which are equivalen=
t to
<filename>/etc/passwd</filename> and
<filename>/etc/master.passwd</filename> but faster to process.</para>
=20
@@ -349,9 +349,9 @@
<para>&man.halt.8;, &man.reboot.8;, and &man.shutdown.8;
are not synonyms: the latter is more sophisticated.
On a multiuser system you should really use &man.shutdown.8;;
- you can also schedule a shutdown time, notify users, and it will
+ this will allow you to schedule a shutdown time, notify users, and i=
t will
also take care to shutdown database processes etc. properly
- withouth simply &man.kill.1;ing them. =20
+ without simply &man.kill.1;ing them. =20
For a more detailed description, see the &man.shutdown.8;,
&man.halt.8; and &man.reboot.8; manpages.</para>
</sect1>
--KaGhPsiNaI6/sRd6
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="chap-audio.xml.diff"
Content-Transfer-Encoding: quoted-printable
Index: chap-audio.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /a/NetBSD/ncvs/htdocs/guide/en/chap-audio.xml,v
retrieving revision 1.10
diff -u -r1.10 chap-audio.xml
--- chap-audio.xml 29 Nov 2004 16:56:33 -0000 1.10
+++ chap-audio.xml 12 Dec 2004 16:04:16 -0000
@@ -12,20 +12,20 @@
<title>Basic hardware elements</title>
=20
<para>In order to make audio work on your system you must know what
- audio card is installed. Sadly it often not enough to know
+ audio card is installed. Sadly it is often not enough to know
the brand and model of the card, because many cards use
chipsets manufactured from third parties. Therefore knowing
the chipset installed on the audio card can sometimes be
useful.
The &os; kernel can recognize many chipsets and a quick
- look at <command>dmesg</command> is enough most of the times.</para>
+ look at <command>dmesg</command> is enough most of the time.</para>
=20
- <para>Therefore, write the following command:</para>
+ <para>Therefore, type the following command:</para>
=20
<screen>&rprompt; <userinput>dmesg | more</userinput></screen>
=20
<para>and look for the audio card and chipset. If you're lucky you
- don't need to do anything because &os; automatically
+ won't need to do anything because &os; automatically
detects and configures many audio cards.</para>
=20
<para>Sometimes audio doesn't work because the card is not
@@ -107,7 +107,7 @@
=20
<para>If you hear something it means that the card is supported by
&os; and was recognized and configured by the kernel at
- boot, otherwise you must configure the kernel settings for
+ boot; otherwise you must configure the kernel settings for
the audio device installed on the system (assuming the
card/chipset is supported.)</para>
</sect1>
@@ -119,7 +119,7 @@
=20
<para>&os; supports a wide range of audio cards and the GENERIC
kernel already enables and configures most of them.
- Sometimes it is necessary to setup manually the IRQ and DMA
+ Sometimes it is necessary to manually set up the IRQ and DMA
for non-PnP ISA cards.</para>
=20
<note>
@@ -136,7 +136,7 @@
compatibility, but a great number of them work with the WSS
emulation.</para>
=20
- <para>OPL is a MIDI synthetizer produced by Yamaha; there are many
+ <para>OPL is a MIDI synthesizer produced by Yamaha; there are many
OPL variants (e.g. OPL2, OPL3SA, OPL3SA2, etc.).
Many audio cards rely on this component or on a compatible
one. For example, the chips produced by Crystal (and amongst
@@ -144,13 +144,13 @@
that's why they work with &os;.</para>
=20
<para>WSS is not a microchip; it is the acronym of Windows Sound
- System. Wss is the name of the &os; kernel driver which
+ System. WSS is the name of the &os; kernel driver which
supports the audio system of Microsoft Windows.
Many audio cards work with Windows because they adhere to
this standard (WSS) and the same holds for &os;.</para>
=20
<para>Of the many audio cards that I tested with &os;, a good
- number works only if <filename>opl*</filename> and
+ number work only if <filename>opl*</filename> and
<filename>wss*</filename> are enabled in the kernel.</para>
=20
<para>You should have no problem to get the Creative SoundBlaster
@@ -206,7 +206,7 @@
=20
<screen>&rprompt; <userinput>audioctl -w play=3D44100,2,16,slinear_l=
e</userinput></screen>
=20
- <para>This command sets the frequence to 44100Hz, 2 audio
+ <para>This command sets the frequency to 44100Hz, 2 audio
channels, 16 bit, slinear_le encoding.</para>
=20
<para>You can see the supported encodings with:</para>
--KaGhPsiNaI6/sRd6
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="chap-boot.xml.diff"
Content-Transfer-Encoding: quoted-printable
Index: chap-boot.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /a/NetBSD/ncvs/htdocs/guide/en/chap-boot.xml,v
retrieving revision 1.16
diff -u -r1.16 chap-boot.xml
--- chap-boot.xml 3 Dec 2004 00:04:39 -0000 1.16
+++ chap-boot.xml 12 Dec 2004 16:13:40 -0000
@@ -56,7 +56,7 @@
<para>For the first login you will use the <username>root</username>
superuser, which is the only user defined at the end of the
installation.
- At the password prompt write the password for root that you
+ At the password prompt type the password for root that you
have defined during the installation.
If you haven't defined a password, just press Enter.</para>
=20
@@ -73,7 +73,7 @@
<sect1 id=3D"chap-boot-keyboard-layout">
<title>Changing the keyboard layout</title>
=20
- <para>The keyboard has still the US layout; if you have a different ke=
yboard
+ <para>The keyboard still has the US layout; if you have a different ke=
yboard
it's better to change its layout now, before
starting to configure the system.
For example, to use the italian keyboard, give the following command=
:</para>
@@ -106,7 +106,7 @@
</itemizedlist>
=20
<para>This setting will last until the next reboot.
- To make it permanent, add a <quote>encoding</quote>line to=20
+ To make it permanent, add an <quote>encoding</quote>line to=20
<filename>/etc/wscons.conf</filename>: it will be executed
automatically the next time you reboot.</para>
=20
@@ -115,7 +115,7 @@
&rprompt; <userinput>echo encoding it >>/etc/wscons.conf</userinput>=
</screen>
=20
<note>
- <para>be careful and type two <quote>></quote> characters.
+ <para>Be careful and type two <quote>></quote> characters.
If you type only one <quote>></quote>, you will overwrite the f=
ile
instead of adding a line.</para>
</note>
@@ -137,14 +137,14 @@
<quote><replaceable>name</replaceable></quote>
command and <command>man -k <replaceable>name</replaceable></command=
> shows a list of man pages
dealing with <quote><replaceable>name</replaceable></quote> (you can=
also use the
- <command>apropos</command> command.)</para>
+ <command>apropos</command> command).</para>
=20
<para>To learn the basics of the <command>man</command> command, type:=
</para>
=20
<screen>&rprompt; <userinput>man man</userinput></screen>
=20
- <para>The manual is divided in nine sections, containing not only basic
- informations on commands but also the descriptions of some &os;
+ <para>The manual is divided into nine sections, containing not only ba=
sic
+ information on commands but also the descriptions of some &os;
features and structures.
For example, take a look at the &man.hier.7; man page, which describ=
es in
detail the layout of the filesystem used by &os;.</para>
@@ -236,7 +236,7 @@
New password:
Retype new password:</screen>
=20
- <para>Password are not displayed on the screen while you type.
+ <para>Passwords are not displayed on the screen while you type.
Later we will see how to add other accounts on the system.</para>
</sect1>
=20
@@ -249,7 +249,7 @@
chosen during system installation time, and it usually is
<command>csh</command>; if this
doesn't mean anything to you, you should begin studying csh with
- (&man.csh.1;): it's a good interactive shell
+ &man.csh.1;: it's a good interactive shell
although it lacks history editing (have a look at
<emphasis>tcsh</emphasis>, bash or even the &os;
<filename>/bin/sh</filename> for this).
@@ -271,12 +271,12 @@
</itemizedlist>
=20
<para>The new shell will come into effect the next time you login.
- In the mean time, you can issue the following command if you use
+ In the meantime, you can issue the following command if you use
<command>csh</command>:</para>
=20
<screen>&rprompt; <userinput>set filec</userinput></screen>
=20
- <para>that enables filename completion on the command line (with the E=
SC
+ <para>which enables filename completion on the command line (with the =
ESC
key; use Ctrl+D for a list of possible completions.)</para>
=20
<para>You can also install other shells on the system, if you want to:
@@ -348,7 +348,7 @@
the one in <filename>/etc/defaults/rc.conf</filename> (which
should stay unchanged).</para>
=20
- <para>Understanding the <filename>/etc/rc.con</filename> file is
+ <para>Understanding the <filename>/etc/rc.conf</filename> file is
very important. The &man.rc.conf.5; manual page contains a
detailed description of all the options.</para>
=20
@@ -375,16 +375,16 @@
</listitem>
=20
<listitem>
- <para>Define an <emphasis>hostname</emphasis> for your machine (use
+ <para>Define a <emphasis>hostname</emphasis> for your machine (use
a fully qualified hostname, i.e. one including domain).
If you have a standalone machine you can use any name (for
- example, <hostid>woody.toys.net</hostid>.)
+ example, <hostid>woody.toys.net</hostid>).
If your machine is connected to a network, you should supply
the correct network name.</para>
=20
<note>
<para>Make sure that the hostname is resolvable, either using
- DNS or <filename>/etc/hosts</filename>, some programs
+ DNS or <filename>/etc/hosts</filename>; some programs
do not work with an unresolvable hostname.</para>
</note>
</listitem>
@@ -419,7 +419,7 @@
=20
<para>
Suppose we want to enable soft-dependencies for all filesystems,
- except for the <filename>/</filename> partition, we would change
+ except for the <filename>/</filename> partition. We would change
it to (changes are emphasized):
</para>
=20
@@ -463,7 +463,7 @@
<sect1 id=3D"chap-boot-rebooting">
<title>Rebooting the system</title>
=20
- <para>In this first session you have</para>
+ <para>In this first session you have:</para>
=20
<itemizedlist>
<listitem>
--KaGhPsiNaI6/sRd6--
--37cJpJlYZwAfNbm5
Content-Type: application/pgp-signature
Content-Disposition: inline
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.6 (FreeBSD)
iD8DBQFBvHA3ocfcwTS3JF8RAiNnAJoCgk2+FqMVm96GP5n4lk5UdxPJoACeI7tY
B2FzV5Ly2oq3yzIXg4vfhrc=
=vfJJ
-----END PGP SIGNATURE-----
--37cJpJlYZwAfNbm5--