find-candidates
Name
cave-find-candidates — Find a list of candidate packages for a search.
DESCRIPTION
Finds a list of candidate packages for a search. Used by 'cave search'; not generally called directly by end users. Note that this command will often select candidates that do not actually match some of the supplied restrictions; use 'cave match' to obtain accurate results.
OPTIONS
Global Options
Global options, used by every subcommand.
- -h , --help
- display help message
Hints
Hints allow, but do not require, the search to return a reduced set of results
- --name-description-substring
- Candidates whose name or description does not include the specified string as a substring may be omitted
SEARCH CANDIDATE OPTIONS
Candidate Options
Control which packages and versions are selected as candidates for matching.
- -a , --all-versions (+a , --no-all-versions)
- Search in every version of packages
- -v , --visible (+v , --no-visible)
- Search only in visible (not masked) versions of packages
- -m , --matching
- Search only in packages matching the supplied specification
MATCH OPTIONS
Pattern Options
Alter how patterns are matched.
- -t , --type
Specify which matching algorithm to use
- text (t)
- Match an exact text substring, ignoring case (default)
- exact (x)
- Match only an entire exact string, ignoring case
- regex (r)
- Match using ECMAScript regular expressions, ignoring case
- -C , --case-sensitive (+C , --no-case-sensitive)
- Make matching case sensitive.
- -& , --and (+& , --no-and)
- If multiple patterns are specified, require that all patterns match. Default is to succeed if any pattern matches.
- -! , --not (+! , --no-not)
- Invert the results of pattern matches.
Search Key Options
Alter the keys used for searching. If no option in this group is specified, matches are carried out on name and description. Otherwise, matches are carried out on all of the specified keys.
- -k , --key
- Search the named metadata key (e.g. DESCRIPTION). May be specified multiple times.
- -n , --name (+n , --no-name)
- Search package names.
- -d , --description (+d , --no-description)
- Search package descriptions.
Key Handling Options
Alter how key values are interpreted.
- -e , --enabled-only (+e , --no-enabled-only)
- Only search enabled parts of conditional dependency spec trees
INDEX OPTIONS
Index Options
Controls the use of an index. An index may be created using cave manage-search-index. Note that strange errors or partial results may occur if the index is not up to date.
- --index
- Use the specified index file