.TH dub 1 "March 2016"
.SH NAME
DUB \- Package and build management system for D
.SH SYNOPSIS
 dub [\-\-version] [<command>] [<options...>] [\-\- [<application arguments...>]]
.SH DESCRIPTION
Manages the DUB project in the current directory. If the command is omitted,
DUB will default to "run". When running an application, "\-\-" can be used to
separate DUB options from options passed to the application.
.PP
Run "dub <command> \fB\-\-help\fR" to get help for a specific command.
.PP
You can use the "http_proxy" environment variable to configure a proxy server
to be used for fetching packages.
.PP
\fBPackage creation\fR
.TP
init  [<directory> [<dependency>...]]
Initializes an empty package skeleton
.PP
\fBBuild, test and run\fR
.TP
run [<package>]
Builds and runs a package (default command)
.TP
build [<package>]
Builds a package (uses the main package in the current
working directory by default)
.TP
test [<package>]
Executes the tests of the selected package
.TP
generate <generator> [<package>]
Generates project files using the specified generator
.TP
describe [<package>]
Prints a JSON description of the project and its dependencies
.TP
clean [<package>]
Removes intermediate build files and cached build results
.TP
dustmite <destination\-path>
Create reduced test cases for build errors
.PP
\fBPackage management\fR
.TP
fetch <name>
Manually retrieves and caches a package
.TP
remove <name>
Removes a cached package
.TP
upgrade [<package>]
Forces an upgrade of all dependencies
.TP
add\-path <path>
Adds a default package search path
.TP
remove\-path <path>
Removes a package search path
.TP
add\-local <path> [<version>]
Adds a local package directory (e.g. a git repository)
.TP
remove\-local <path>
Removes a local package directory
.TP
list
Prints a list of all local packages dub is aware of
.TP
add\-override <package> <version\-spec> <target\-path/target\-version>
Adds a new package override.
.TP
remove\-override <package> <version\-spec>
Removes an existing package override.
.TP
list\-overrides
Prints a list of all local package overrides
.TP
clean\-caches
Removes cached metadata
.PP
\fBCommon options\fR
.TP
\fB\-h\fR  \fB\-\-help\fR
Display general or command specific help
.TP
\fB\-\-root\fR=\fI\,VALUE\/\fR
Path to operate in instead of the current working dir
.TP
\fB\-\-registry\fR=\fI\,VALUE\/\fR
Search the given DUB registry URL first when resolving
dependencies. Can be specified multiple times.
.TP
\fB\-\-skip\-registry\fR=\fI\,VALUE\/\fR
Skips searching certain package registries for
dependencies:

 none: Search all configured registries (default)

 standard: Don't search on http://code.dlang.org/

 all: Search none of the configured registries

.TP
\fB\-\-annotate\fR
Do not perform any action, just print what would be
done
.TP
\fB\-\-bare\fR
Read only packages contained in the current directory
.TP
\fB\-v\fR  \fB\-\-verbose\fR
Print diagnostic output
.TP
\fB\-q\fR  \fB\-\-quiet\fR
Only print warnings and errors
.TP
\fB\-\-vquiet\fR
Print no messages
.TP
\fB\-\-cache\fR=\fI\,VALUE\/\fR
Puts any fetched packages in the specified location
[local|system|user].