.TH DUB-DESCRIBE 1 "2020-08-08" "The D Language Foundation" "The D Language Foundation" .SH NAME dub \- Package and build management system for D .SH SYNOPSIS \fBdub describe\fR [<\fIpackage\fR>] \fIOPTIONS\&.\&.\&.\fR .SH DESCRIPTION Prints a JSON build description for the root package an all of their dependencies in a format similar to a JSON package description file. This is useful mostly for IDEs. All usual options that are also used for build/run/generate apply. When --data=VALUE is supplied, specific build settings for a project will be printed instead (by default, formatted for the current compiler). The --data=VALUE option can be specified multiple times to retrieve several pieces of information at once. A comma-separated list is also acceptable (ex: --data=dflags,libs). The data will be output in the same order requested on the command line. The accepted values for --data=VALUE are: main-source-file, dflags, lflags, libs, linker-files, source-files, versions, debug-versions, import-paths, string-import-paths, import-files, options The following are also accepted by --data if --data-list is used: target-type, target-path, target-name, working-directory, copy-files, string-import-files, pre-generate-commands, post-generate-commands, pre-build-commands, post-build-commands, requirements .SH OPTIONS .IP -b, --build=VALUE Specifies the type of build to perform. Note that setting the DFLAGS environment variable will override the build type with custom flags. Possible names: debug (default), plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, unittest-cov, syntax and custom types .IP -c, --config=VALUE Builds the specified configuration. Configurations can be defined in dub.json .IP --override-config=VALUE Uses the specified configuration for a certain dependency. Can be specified multiple times. Format: --override-config=/ .IP --compiler=VALUE Specifies the compiler binary to use (can be a path). Arbitrary pre- and suffixes to the identifiers below are recognized (e.g. ldc2 or dmd-2.063) and matched to the proper compiler type: dmd, gdc, ldc, gdmd, ldmd .IP -a, --arch=VALUE Force a different architecture (e.g. x86 or x86_64) .IP -d, --debug=VALUE Define the specified debug version identifier when building - can be used multiple times .IP --nodeps Do not resolve missing dependencies before building .IP --build-mode=VALUE Specifies the way the compiler and linker are invoked. Valid values: separate (default), allAtOnce, singleFile .IP --single Treats the package name as a filename. The file must contain a package recipe comment. .IP --force-remove Deprecated option that does nothing. .IP --filter-versions [Experimental] Filter version identifiers and debug version identifiers to improve build cache efficiency. .IP --import-paths Shortcut for --data=import-paths --data-list .IP --string-import-paths Shortcut for --data=string-import-paths --data-list .IP --data=VALUE Just list the values of a particular build setting, either for this package alone or recursively including all dependencies. Accepts a comma-separated list. See above for more details and accepted possibilities for VALUE. .IP --data-list Output --data information in list format (line-by-line), instead of formatting for a compiler command line. .IP --data-0 Output --data information using null-delimiters, rather than spaces or newlines. Result is usable with, ex., xargs -0. .SH FILES \fIdub\&.sdl\fR, \fIdub\&.json\fR .SH AUTHOR Copyright (c) 1999-2020 by The D Language Foundation .SH "ONLINE DOCUMENTATION" .UR http://code.dlang.org/docs/commandline .UE http://code.dlang.org/docs/commandline .SH "SEE ALSO" \fBdmd(1)\fR, \fBdub(1)\fR