* utils.sgml: Various syntactical and semantical fixes.

* cygcheck.cc (usage): Fix --find-package explanation.

winsup/utils/ChangeLog

@@ -1,3 +1,8 @@
+2009-04-03  Kevin Buettner  <kevinb@redhat.com>
+
+	* utils.sgml: Various syntactical and semantical fixes.
+	* cygcheck.cc (usage): Fix --find-package explanation.
+
 2009-03-26  Yaakov Selkowitz  <yselkowitz@cygwin.com>
 
 	* utils.sgml (passwd -R): Remove references to CYGWIN="server".

winsup/utils/cygcheck.cc

@@ -1984,7 +1984,7 @@ At least one command option or a PROGRAM is required, as shown above.\n\
   -r, --registry       also scan registry for Cygwin settings (with -s)\n\
   -k, --keycheck       perform a keyboard check session (must be run from a\n\
                        plain console only, not from a pty/rxvt/xterm)\n\
-  -f, --find-package   find the package that FILE belongs to\n\
+  -f, --find-package   find the package to which FILE belongs\n\
   -l, --list-package   list contents of PACKAGE (or all packages if none given)\n\
   -p, --package-query  search for REGEXP in the entire cygwin.com package\n\
                        repository (requires internet connectivity)\n\

winsup/utils/utils.sgml

@@ -32,7 +32,7 @@ At least one command option or a PROGRAM is required, as shown above.
   -r, --registry       also scan registry for Cygwin settings (with -s)
   -k, --keycheck       perform a keyboard check session (must be run from a
                        plain console only, not from a pty/rxvt/xterm)
-  -f, --find-package   find the package that FILE belongs to
+  -f, --find-package   find the package to which FILE belongs
   -l, --list-package   list contents of PACKAGE (or all packages if none given)
   -p, --package-query  search for REGEXP in the entire cygwin.com package
                        repository (requires internet connectivity)
@@ -373,7 +373,7 @@ ACL.  For directories <command>getfacl</command> displays additionally the
 default ACL.  With no options specified, <command>getfacl</command> displays 
 the filename, the owner, the group, and both the ACL and the default ACL, if 
 it exists. For more information on Cygwin and Windows ACLs, see
-see <xref linkend="ntsec"></xref> in the Cygwin User's Guide.
+<xref linkend="ntsec"></xref> in the Cygwin User's Guide.
 The format for ACL output is as follows:
 <screen>
      # file: filename
@@ -442,7 +442,7 @@ given signal, or a list of all signal names if no signal is given.</para>
 
 <para>To send a specific signal, use the <literal>-signN</literal>
 option, either with a signal number or a signal name (minus the "SIG"
-part), like these examples:</para>
+part), as shown in these examples:</para>
 
 <example id="utils-kill-ex"><title>Using the kill command</title>
 <screen>
@@ -560,14 +560,14 @@ With the <literal>-d/-D</literal> options the program contacts a Domain
 Controller, which my be unreachable or have restricted access.
 Comma-separated from the machine or domain, you can specify an offset
 which is used as base added to the group's RID to compute the gid
-(offset + RID = gid).  This allows to create the same gids every time you
+(offset + RID = gid).  This allows you to create the same gids every time you
 re-run <command>mkgroup</command>.
 For very simple needs, an entry for the current user's group can be
 created by using the option <literal>-c</literal> or <literal>-C</literal>.
 If you want to use one of the <literal>-D</literal>, <literal>-L</literal>
 or <literal>-C</literal> options, but you don't like the backslash as
 domain/group separator, you can specify another separator using the
-<literal>-S</literal> option, for instance</para>
+<literal>-S</literal> option, for instance:</para>
 
 <example id="utils-mkgroup-ex"><title>Setting up group entry for current user with different domain/group separator</title>
 <screen>
@@ -580,11 +580,11 @@ DOMAIN+my_group:S-1-5-21-2913048732-1697188782-3448811101-1144:11144:
 <para>The <literal>-o</literal> option allows for special cases
 (such as multiple domains) where the GIDs might match otherwise.
 The <literal>-g</literal> option only prints the information for one group.
-The <literal>-U</literal> option allows to enumerate the standard UNIX
+The <literal>-U</literal> option allows you to enumerate the standard UNIX
 groups on a Samba machine.  It's used together with
 <literal>-l samba-server</literal> or <literal>-L samba-server</literal>.
 The normal UNIX groups are usually not enumerated, but they can show
-up as group in <command>ls -l</command> output.
+up as a group in <command>ls -l</command> output.
 </para>
 
 </sect2>
@@ -667,7 +667,7 @@ option <literal>-c</literal> or  <literal>-C</literal>.
 If you want to use one of the <literal>-D</literal>, <literal>-L</literal>
 or <literal>-C</literal> options, but you don't like the backslash as
 domain/group separator, you can specify another separator using the
-<literal>-S</literal> option, simialar to the <command>mkgroup</command>.
+<literal>-S</literal> option, similar to the <command>mkgroup</command>.
 The <literal>-o</literal> option allows for special cases
 (such as multiple domains) where the UIDs might match otherwise.
 The <literal>-m</literal> option bypasses the current
@@ -687,7 +687,7 @@ use the specified prefix instead of the account home dir or <literal>/home/
 would put local users' home directories in the Windows 'Profiles' directory. 
 The <literal>-u</literal> option creates just an entry for
 the specified user.
-The <literal>-U</literal> option allows to enumerate the standard UNIX
+The <literal>-U</literal> option allows you to enumerate the standard UNIX
 users on a Samba machine.  It's used together with
 <literal>-l samba-server</literal> or <literal>-L samba-server</literal>.
 The normal UNIX users are usually not enumerated, but they can show
@@ -808,7 +808,7 @@ the <filename>/etc/fstab</filename> file.</para>
 
 <para>
 The <literal>-m</literal> option causes the <command>mount</command> utility
-to output the current mount table in a series of fstab entries.  This allows
+to output the current mount table in a series of fstab entries.
 You can save this output as a backup when experimenting with the mount table.
 Copy the output to <filename>/etc/fstab</filename> to restore the old state.
 It also makes moving your settings to a different machine much easier.</para>
@@ -1017,13 +1017,13 @@ running Windows services.  When a privileged Cygwin application calls the
 <command>set{e}uid(user_id)</command> system call, Cygwin checks if a
 password for that user has been stored in this registry area.  If so, it
 uses this password to switch to this user account using that password.
-This allows to logon through, for instance, <command>ssh</command> with
+This allows you to logon through, for instance, <command>ssh</command> with
-public key authentication and to get a full qualified user token with
+public key authentication and get a full qualified user token with
 all credentials for network access.  However, the method has some
-drawbacks security-wise.  This is explained in more detail in the
+drawbacks security-wise.  This is explained in more detail in
-<xref linkend="ntsec"></xref> section.</para>
+<xref linkend="ntsec"></xref>.</para>
 
-<para>Please note that storing password in that registry area is a
+<para>Please note that storing passwords in that registry area is a
 privileged operation which only administrative accounts are allowed to
 do.  If normal, non-admin users should be allowed to enter their
 passwords using <command>passwd -R</command>, it's required to run
@@ -1078,7 +1078,7 @@ waiting to output.
 </para>
 
 <para>
-By default <command>ps</command> will only show processes owned by the
+By default, <command>ps</command> will only show processes owned by the
 current user. With either the <literal>-a</literal> or <literal>-e</literal>
 option, all user's processes (and system processes) are listed. There are
 historical UNIX reasons for the synonomous options, which are functionally
@@ -1166,18 +1166,18 @@ Conversely, the <literal>-q</literal> option supresses error messages,
 so you can use the exit status of the program to detect if a key
 exists or not (for example).</para>
 
-<para>The <literal>-w</literal> option allows to access the 64 bit view
+<para>The <literal>-w</literal> option allows you to access the 64 bit view
-on the registry.  Several subkeys exist in a 32 bit and a 64 bit version
+of the registry.  Several subkeys exist in a 32 bit and a 64 bit version
 when running on Windows 64.  Since Cygwin is running in 32 bit mode, it
-has only access to the 32 bit view of these registry keys.  When using
+only has access to the 32 bit view of these registry keys.  When using
-the <literal>-w</literal> the 64 bit view is used and
+the <literal>-w</literal> switch, the 64 bit view is used and
 <command>regtool</command> can access the entire registry.
 This option is simply ignored when running on 32 bit Windows versions.
 </para>
 
-<para>The <literal>-W</literal> option allows to access the 32 bit view
+<para>The <literal>-W</literal> option allows you to access the 32 bit view
-on the registry.  The purpose of this  option is mainly symmetry.  It
+on the registry.  The purpose of this option is mainly for symmetry.  It
-allows to create OS agnostic scripts which would also work in a hypothetic
+permits creation of OS agnostic scripts which would also work in a hypothetical
 64 bit version of Cygwin.</para>
 
 <para>You must provide <command>regtool</command> with an 
@@ -1190,7 +1190,7 @@ the action must be <literal>add</literal>, <literal>set</literal>,
 <para>The <literal>add</literal> action adds a new key.  The 
 <literal>check</literal> action checks to see if a key exists (the 
 exit code of the program is zero if it does, nonzero if it does not).
-The <literal>get</literal> action gets the value of a value of a key,
+The <literal>get</literal> action gets the value of a key,
 and prints it (and nothing else) to stdout.  Note: if the value
 doesn't exist, an error message is printed and the program returns a
 non-zero exit code.  If you give <literal>-q</literal>, it doesn't