cave(1)

Name

cave - A commandline client for the other package mangler.

Synopsis

cave [ --environment class:suffix ] [ --log-level level ] COMMAND [ARGS...]

cave help [ --all ]

Description

The front-end to a number of commands.

For the COMMAND argument, see 'cave help' for a list of common commands, or 'cave help --all' for all commands. To see documentation for a command named 'foo', use 'man cave-foo'.

In addition to built-in commands, cave will also look in the directories named in the colon-separated CAVE_COMMANDS_PATH environment variable, or, if unset, '/usr/libexec/cave/commands'. Any executables in this path will also be available as commands (with any file extension stripped); these executables may use the $CAVE environment variable to get access to the main cave program.

Arguments specified after the COMMAND are handled by the individual commands. Arguments before the COMMAND are global arguments shared by all commands.

Options

Global Options

Global options, used by every subcommand.

-E, --environment

Environment specification (class:suffix, both parts optional)

-L, --log-level

Specify the log level

debug (d): Show debug output (noisy)
qa (q): Show QA messages and warnings only (default)
warning (w): Show warnings only
silent (s): Suppress all log messages (UNSAFE)

-c, --colour

Specify whether to use colour

auto (a): Yes if stdout is connected to a terminal (default)
yes (y): Yes
no (n): No

-h, --help

display help message

-v, --version

display version information

Environment

CAVE_COMMANDS_PATH: Colon-separated paths in which to look for additional commands.

Introduction	cave	paludis	accerso
Bugs, Requests, Support		importare	adjutrix
Overview		inquisitio	instruo
FAQ		reconcilio	appareo
Clients
Configuration
API