file came from, and <literal>-l</literal> lists all files in a package.
For example, to find out about <filename>/usr/bin/less</filename> and its
package:
-<example><title>Example <command>cygcheck</command> usage</title>
+<example id="utils-cygcheck-ex"><title>Example <command>cygcheck</command> usage</title>
<screen>
$ cygcheck -f /usr/bin/less
less-381-1
<para>For example, perhaps you are getting an error because you are missing a
certain DLL and you want to know which package includes that file:
-<example><title>Searching all packages for a file</title>
+<example id="utils-search-ex"><title>Searching all packages for a file</title>
<screen>
$ cygcheck -p 'cygintl-2\.dll'
Found 1 matches for 'cygintl-2\.dll'.
</para>
-<example><title>Example <command>cygpath</command> usage</title>
+<example id="utils-cygpath-ex"><title>Example <command>cygpath</command> usage</title>
<screen>
<![CDATA[
#!/bin/sh
option, either with a signal number or a signal name (minus the "SIG"
part), like these examples:</para>
-<example><title>Using the kill command</title>
+<example id="utils-kill-ex"><title>Using the kill command</title>
<screen>
<prompt>$</prompt> <userinput>kill 123</userinput>
<prompt>$</prompt> <userinput>kill -1 123</userinput>
To initially set up your machine if you are a local user, you'd do
something like this:</para>
-<example><title>Setting up the groups file for local accounts</title>
+<example id="utils-mkgroup-ex"><title>Setting up the groups file for local accounts</title>
<screen>
<prompt>$</prompt> <userinput>mkdir /etc</userinput>
<prompt>$</prompt> <userinput>mkgroup -l > /etc/group</userinput>
To initially set up your machine if you are a local user, you'd do
something like this:</para>
-<example><title>Setting up the passwd file for local accounts</title>
+<example id="utils-mkpasswd-ex"><title>Setting up the passwd file for local accounts</title>
<screen>
<prompt>$</prompt> <userinput>mkdir /etc</userinput>
<prompt>$</prompt> <userinput>mkpasswd -l > /etc/passwd</userinput>
use the specified prefix instead of the account home dir or <literal>/home/
</literal>. For example, this command:
-<example><title>Using an alternate home root</title>
+<example id="utils-althome-ex"><title>Using an alternate home root</title>
<screen>
<prompt>$</prompt> <userinput>mkpasswd -l -p "$(cygpath -H)" > /etc/passwd</userinput>
</screen>
behind the Cygwin POSIX file system and strategies for using
mounts. To remove mounts, use <command>umount</command></para>
-<sect3><title>Using mount</title>
+<sect3 id="utils-mount"><title>Using mount</title>
<para>If you just type <command>mount</command> with no parameters, it
will display the current mount table for you.</para>
-<example>
+<example id="utils-mount-ex">
<title>Displaying the current set of mount points</title>
<screen>
<prompt>c:\cygwin\></prompt> <userinput>mount</userinput>
<filename>\\pollux\home\joe\data</filename> to <filename>/data</filename>.
</para>
-<example>
+<example id="utils-mount-add-ex">
<title>Adding mount points</title>
<screen>
<prompt>c:\cygwin\></prompt> <userinput>ls /data</userinput>
</screen>
</sect3>
-<sect3><title>Cygdrive mount points</title>
+<sect3 id="utils-cygdrive"><title>Cygdrive mount points</title>
<para>Whenever Cygwin cannot use any of the existing mounts to convert
from a particular Win32 path to a POSIX one, Cygwin will, instead,
"--change-cygdrive-prefix" option. In the following example, we will
set the automount prefix to <filename>/</filename>:</para>
-<example>
+<example id="utils-cygdrive-ex">
<title>Changing the default prefix</title>
<screen>
<prompt>c:\cygwin\></prompt> <userinput>mount --change-cygdrive-prefix /</userinput>
</sect3>
-<sect3><title>Limitations</title>
+<sect3 id="utils-limitations"><title>Limitations</title>
<para>Limitations: there is a hard-coded limit of 30 mount
points. Also, although you can mount to pathnames that do not start