JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

* utils.sgml: Add id's to all examples.

Browse Source
This commit is contained in:
Corinna Vinschen 2008-07-17 10:32:03 +00:00
parent a0c53f920f
commit b2dab9e8bc
2 changed files with 17 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
winsup/utils/ChangeLog
View File

@ -1,3 +1,7 @@
2008-07-17 Corinna Vinschen <corinna@vinschen.de>
* utils.sgml: Add id's to all examples.
2008-07-09 Corinna Vinschen <corinna@vinschen.de> 2008-07-09 Corinna Vinschen <corinna@vinschen.de>
* mkgroup.c: Use statically linked functions throughout, except for * mkgroup.c: Use statically linked functions throughout, except for

26
winsup/utils/utils.sgml
View File

@ -81,7 +81,7 @@ The <literal>-f</literal> option helps you to track down which package a
file came from, and <literal>-l</literal> lists all files in a package. 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 For example, to find out about <filename>/usr/bin/less</filename> and its
package: package:
<example><title>Example <command>cygcheck</command> usage</title> <example id="utils-cygcheck-ex"><title>Example <command>cygcheck</command> usage</title>
<screen> <screen>
$ cygcheck -f /usr/bin/less $ cygcheck -f /usr/bin/less
less-381-1 less-381-1
@ -128,7 +128,7 @@ package listing</ulink> page.</para>
<para>For example, perhaps you are getting an error because you are missing a <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: 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> <screen>
$ cygcheck -p 'cygintl-2\.dll' $ cygcheck -p 'cygintl-2\.dll'
Found 1 matches for 'cygintl-2\.dll'. Found 1 matches for 'cygintl-2\.dll'.
@ -270,7 +270,7 @@ contain spaces (C:\Program Files) so should be enclosed in quotes.
</para> </para>
<example><title>Example <command>cygpath</command> usage</title> <example id="utils-cygpath-ex"><title>Example <command>cygpath</command> usage</title>
<screen> <screen>
<![CDATA[ <![CDATA[
#!/bin/sh #!/bin/sh
@ -452,7 +452,7 @@ given signal, or a list of all signal names if no signal is given.</para>
option, either with a signal number or a signal name (minus the "SIG" option, either with a signal number or a signal name (minus the "SIG"
part), like these examples:</para> part), like these examples:</para>
<example><title>Using the kill command</title> <example id="utils-kill-ex"><title>Using the kill command</title>
<screen> <screen>
<prompt>$</prompt> <userinput>kill 123</userinput> <prompt>$</prompt> <userinput>kill 123</userinput>
<prompt>$</prompt> <userinput>kill -1 123</userinput> <prompt>$</prompt> <userinput>kill -1 123</userinput>
@ -536,7 +536,7 @@ create a file with the correct format.
To initially set up your machine if you are a local user, you'd do To initially set up your machine if you are a local user, you'd do
something like this:</para> 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> <screen>
<prompt>$</prompt> <userinput>mkdir /etc</userinput> <prompt>$</prompt> <userinput>mkdir /etc</userinput>
<prompt>$</prompt> <userinput>mkgroup -l &gt; /etc/group</userinput> <prompt>$</prompt> <userinput>mkgroup -l &gt; /etc/group</userinput>
@ -610,7 +610,7 @@ if remote access is desired.
To initially set up your machine if you are a local user, you'd do To initially set up your machine if you are a local user, you'd do
something like this:</para> 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> <screen>
<prompt>$</prompt> <userinput>mkdir /etc</userinput> <prompt>$</prompt> <userinput>mkdir /etc</userinput>
<prompt>$</prompt> <userinput>mkpasswd -l &gt; /etc/passwd</userinput> <prompt>$</prompt> <userinput>mkpasswd -l &gt; /etc/passwd</userinput>
@ -642,7 +642,7 @@ SIDs, see <xref linkend="ntsec"></xref> in the Cygwin User's Guide. The
use the specified prefix instead of the account home dir or <literal>/home/ use the specified prefix instead of the account home dir or <literal>/home/
</literal>. For example, this command: </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> <screen>
<prompt>$</prompt> <userinput>mkpasswd -l -p "$(cygpath -H)" &gt; /etc/passwd</userinput> <prompt>$</prompt> <userinput>mkpasswd -l -p "$(cygpath -H)" &gt; /etc/passwd</userinput>
</screen> </screen>
@ -689,12 +689,12 @@ done by mount commands on typical UNIX systems. Please see
behind the Cygwin POSIX file system and strategies for using behind the Cygwin POSIX file system and strategies for using
mounts. To remove mounts, use <command>umount</command></para> 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 <para>If you just type <command>mount</command> with no parameters, it
will display the current mount table for you.</para> will display the current mount table for you.</para>
<example> <example id="utils-mount-ex">
<title>Displaying the current set of mount points</title> <title>Displaying the current set of mount points</title>
<screen> <screen>
<prompt>c:\cygwin\&gt;</prompt> <userinput>mount</userinput> <prompt>c:\cygwin\&gt;</prompt> <userinput>mount</userinput>
@ -718,7 +718,7 @@ demonstrates how to mount the directory
<filename>\\pollux\home\joe\data</filename> to <filename>/data</filename>. <filename>\\pollux\home\joe\data</filename> to <filename>/data</filename>.
</para> </para>
<example> <example id="utils-mount-add-ex">
<title>Adding mount points</title> <title>Adding mount points</title>
<screen> <screen>
<prompt>c:\cygwin\&gt;</prompt> <userinput>ls /data</userinput> <prompt>c:\cygwin\&gt;</prompt> <userinput>ls /data</userinput>
@ -802,7 +802,7 @@ most of the options are duplicates of other mount flags):</para>
</screen> </screen>
</sect3> </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 <para>Whenever Cygwin cannot use any of the existing mounts to convert
from a particular Win32 path to a POSIX one, Cygwin will, instead, from a particular Win32 path to a POSIX one, Cygwin will, instead,
@ -815,7 +815,7 @@ can be used to change this default automount prefix through the use of the
"--change-cygdrive-prefix" option. In the following example, we will "--change-cygdrive-prefix" option. In the following example, we will
set the automount prefix to <filename>/</filename>:</para> set the automount prefix to <filename>/</filename>:</para>
<example> <example id="utils-cygdrive-ex">
<title>Changing the default prefix</title> <title>Changing the default prefix</title>
<screen> <screen>
<prompt>c:\cygwin\&gt;</prompt> <userinput>mount --change-cygdrive-prefix /</userinput> <prompt>c:\cygwin\&gt;</prompt> <userinput>mount --change-cygdrive-prefix /</userinput>
@ -834,7 +834,7 @@ automounted filesystems default to binary mode file accesses.</para>
</sect3> </sect3>
<sect3><title>Limitations</title> <sect3 id="utils-limitations"><title>Limitations</title>
<para>Limitations: there is a hard-coded limit of 30 mount <para>Limitations: there is a hard-coded limit of 30 mount
points. Also, although you can mount to pathnames that do not start points. Also, although you can mount to pathnames that do not start