Cygwin: cygcheck: improve documentation
Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
This commit is contained in:
parent
603f880cb7
commit
784a141e0f
|
@ -131,6 +131,20 @@
|
||||||
<command>cygcheck</command>
|
<command>cygcheck</command>
|
||||||
<arg choice="plain">-k</arg>
|
<arg choice="plain">-k</arg>
|
||||||
</cmdsynopsis>
|
</cmdsynopsis>
|
||||||
|
<cmdsynopsis>
|
||||||
|
<command>cygcheck</command>
|
||||||
|
<arg choice="plain">-e</arg>
|
||||||
|
<arg choice="plain" rep="repeat"><replaceable>PATTERN</replaceable></arg>
|
||||||
|
</cmdsynopsis>
|
||||||
|
<cmdsynopsis>
|
||||||
|
<command>cygcheck</command>
|
||||||
|
<arg choice="plain">-i</arg>
|
||||||
|
<arg>--inst</arg>
|
||||||
|
<arg>--curr</arg>
|
||||||
|
<arg>--prev</arg>
|
||||||
|
<arg>--test</arg>
|
||||||
|
<arg choice="plain" rep="repeat"><replaceable>PATTERN</replaceable></arg>
|
||||||
|
</cmdsynopsis>
|
||||||
<cmdsynopsis>
|
<cmdsynopsis>
|
||||||
<command>cygcheck</command>
|
<command>cygcheck</command>
|
||||||
<arg choice="plain">-f</arg>
|
<arg choice="plain">-f</arg>
|
||||||
|
@ -171,6 +185,16 @@ At least one command option or a PROGRAM is required, as shown above.
|
||||||
-r, --registry also scan registry for Cygwin settings (with -s)
|
-r, --registry also scan registry for Cygwin settings (with -s)
|
||||||
-k, --keycheck perform a keyboard check session (must be run from a
|
-k, --keycheck perform a keyboard check session (must be run from a
|
||||||
plain console only, not from a pty/rxvt/xterm)
|
plain console only, not from a pty/rxvt/xterm)
|
||||||
|
-e, --search-package list all available packages matching PATTERN
|
||||||
|
PATTERN is a glob pattern with * and ? as wildcard chars
|
||||||
|
-i, --info-package print full info on packages matching PATTERN, installed
|
||||||
|
and available packages
|
||||||
|
PATTERN is a glob pattern with * and ? as wildcard chars
|
||||||
|
info selection specifiers (multiple allowed):
|
||||||
|
--inst only print info on installed package
|
||||||
|
--curr only print info on most recent available package
|
||||||
|
--prev only print info on older, but still available packages
|
||||||
|
--test only print info on test packages
|
||||||
-f, --find-package find the package to which FILE belongs
|
-f, --find-package find the package to which FILE belongs
|
||||||
-l, --list-package list contents of PACKAGE (or all packages if none given)
|
-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
|
-p, --package-query search for REGEXP in the entire cygwin.com package
|
||||||
|
@ -184,9 +208,11 @@ At least one command option or a PROGRAM is required, as shown above.
|
||||||
with another command, otherwise print this help
|
with another command, otherwise print this help
|
||||||
-V, --version print the version of cygcheck and exit
|
-V, --version print the version of cygcheck and exit
|
||||||
|
|
||||||
Note: -c, -f, and -l only report on packages that are currently installed. To
|
Notes:
|
||||||
search all official Cygwin packages use -p instead. The -p REGEXP matches
|
-c, -f, and -l only report on packages that are currently installed.
|
||||||
package names, descriptions, and names of files/paths within all packages.
|
-i and -e report on available packages, too. To search for files within
|
||||||
|
uninstalled Cygwin packages, use -p. The -p REGEXP matches package names,
|
||||||
|
descriptions, and names of files/paths within all packages.
|
||||||
</screen>
|
</screen>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
|
@ -218,6 +244,57 @@ Note: -c, -f, and -l only report on packages that are currently installed. To
|
||||||
list one or more programs on the command line and specify
|
list one or more programs on the command line and specify
|
||||||
<literal>-s</literal>, <command>cygcheck</command> will report on
|
<literal>-s</literal>, <command>cygcheck</command> will report on
|
||||||
both.</para>
|
both.</para>
|
||||||
|
<para> The <literal>-e</literal> option allows to seach for available
|
||||||
|
packages in the Cygwin distribution. <literal>PATTERN</literal> is
|
||||||
|
a glob pattern, using * and ? as wildcard characters, just as in
|
||||||
|
filename patterns. <literal>PATTERN</literal> is searched for in
|
||||||
|
the package name and the summary of a package.</para>
|
||||||
|
<para> The <literal>-i</literal> option prints a lot of information
|
||||||
|
available for installed packages, as well as for available packages
|
||||||
|
in the Cygwin distribution. <literal>PATTERN</literal> is a glob
|
||||||
|
pattern, using * and ? as wildcard characters, just as in filename
|
||||||
|
patterns. <literal>PATTERN</literal> is compared against the
|
||||||
|
package name as well as against the combined package name and version.
|
||||||
|
With additional info selectors, <literal>--inst</literal>,
|
||||||
|
<literal>--curr</literal>, <literal>--prev</literal>, and
|
||||||
|
<literal>--test</literal>, allow to specify that only information
|
||||||
|
in terms of installed, current latest available, older available,
|
||||||
|
as well as test packages respectively, is requested.</para>
|
||||||
|
|
||||||
|
<example
|
||||||
|
id="utils-cygcheck-eiex"><title>Example <command>cygcheck</command> -e/-i
|
||||||
|
usage</title>
|
||||||
|
<screen>
|
||||||
|
$ cygcheck -e grep
|
||||||
|
grep : search for regular expression matches in text files
|
||||||
|
grep-debuginfo : Debug info for grep
|
||||||
|
grepmail : search mailboxes for mail matching an expression
|
||||||
|
pdfgrep : Command-line utility for searching text in PDFs
|
||||||
|
pdfgrep-debuginfo : Debug info for pdfgrep
|
||||||
|
sgrep : Search indexed text regions like SGML,XML and HTML files
|
||||||
|
|
||||||
|
$ cygcheck -i --curr grep
|
||||||
|
Latest available package:
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
Name : grep
|
||||||
|
Version : 3.8
|
||||||
|
Release : 2
|
||||||
|
Architecture: x86_64
|
||||||
|
Size : 401340 (392 K)
|
||||||
|
Source : grep-3.8-2-src.tar.xz
|
||||||
|
Summary : search for regular expression matches in text files
|
||||||
|
Description :
|
||||||
|
GNU grep searches one or more input files for lines containing a
|
||||||
|
match to a specified pattern. By default, grep outputs the matching lines.
|
||||||
|
The GNU implementation includes several useful extensions over POSIX.
|
||||||
|
|
||||||
|
</screen>
|
||||||
|
</example>
|
||||||
|
|
||||||
|
<para> Note that <literal>-e</literal> and <literal>-i</literal>
|
||||||
|
options fetch info from a distribution db file. This file will be
|
||||||
|
downloading on demand and refreshed if it's older than 24 hours.</para>
|
||||||
<para> The <literal>-f</literal> option helps you to track down which
|
<para> 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 a file came from, and <literal>-l</literal> lists all files in a
|
||||||
package. For example, to find out about
|
package. For example, to find out about
|
||||||
|
@ -225,7 +302,7 @@ Note: -c, -f, and -l only report on packages that are currently installed. To
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<example
|
<example
|
||||||
id="utils-cygcheck-ex"><title>Example <command>cygcheck</command>
|
id="utils-cygcheck-ex"><title>Example <command>cygcheck</command> -f/-l
|
||||||
usage</title>
|
usage</title>
|
||||||
<screen>
|
<screen>
|
||||||
$ cygcheck -f /usr/bin/less
|
$ cygcheck -f /usr/bin/less
|
||||||
|
|
|
@ -2738,7 +2738,7 @@ Usage: cygcheck [-v] [-h] PROGRAM\n\
|
||||||
cygcheck -k\n\
|
cygcheck -k\n\
|
||||||
cygcheck -f FILE [FILE]...\n\
|
cygcheck -f FILE [FILE]...\n\
|
||||||
cygcheck -l [PACKAGE]...\n\
|
cygcheck -l [PACKAGE]...\n\
|
||||||
cygcheck -i [--inst,--curr,--prev,--test] [PATTERN]...\n\
|
cygcheck -i [--inst] [--curr] [--prev] [--test] [PATTERN]...\n\
|
||||||
cygcheck -e [PATTERN]...\n\
|
cygcheck -e [PATTERN]...\n\
|
||||||
cygcheck -p REGEXP\n\
|
cygcheck -p REGEXP\n\
|
||||||
cygcheck --delete-orphaned-installation-keys\n\
|
cygcheck --delete-orphaned-installation-keys\n\
|
||||||
|
@ -2760,7 +2760,7 @@ At least one command option or a PROGRAM is required, as shown above.\n\
|
||||||
-i, --info-package print full info on packages matching PATTERN, installed\n\
|
-i, --info-package print full info on packages matching PATTERN, installed\n\
|
||||||
and available packages\n\
|
and available packages\n\
|
||||||
PATTERN is a glob pattern with * and ? as wildcard chars\n\
|
PATTERN is a glob pattern with * and ? as wildcard chars\n\
|
||||||
info selection specifiers (multiple allowed):\n\
|
info selection specifiers (multiple allowed):\n\
|
||||||
--inst only print info on installed package\n\
|
--inst only print info on installed package\n\
|
||||||
--curr only print info on most recent available package\n\
|
--curr only print info on most recent available package\n\
|
||||||
--prev only print info on older, but still available packages\n\
|
--prev only print info on older, but still available packages\n\
|
||||||
|
@ -2780,9 +2780,10 @@ At least one command option or a PROGRAM is required, as shown above.\n\
|
||||||
-V, --version print the version of cygcheck and exit\n\
|
-V, --version print the version of cygcheck and exit\n\
|
||||||
\n\
|
\n\
|
||||||
Notes:\n\
|
Notes:\n\
|
||||||
-c, -f, and -l only report on packages that are currently installed. To\n\
|
-c, -f, and -l only report on packages that are currently installed.\n\
|
||||||
search all official Cygwin packages use -p instead. The -p REGEXP matches\n\
|
-i and -e report on available packages, too. To search for files within\n\
|
||||||
package names, descriptions, and names of files/paths within all packages.\n\
|
uninstalled Cygwin packages, use -p. The -p REGEXP matches package names,\n\
|
||||||
|
descriptions, and names of files/paths within all packages.\n\
|
||||||
\n");
|
\n");
|
||||||
exit (status);
|
exit (status);
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue