dub-generate(1)

1DUB-GENERATE(1)            The D Language Foundation           DUB-GENERATE(1)
2
3
4

NAME

6       dub - Package and build management system for D
7

SYNOPSIS

9       dub generate <generator> [<package>[@<version-spec>]] OPTIONS...
10

DESCRIPTION

12       Generates project files using one of the supported generators:
13
14
15
16       visuald - VisualD project files
17
18       sublimetext - SublimeText project file
19
20       cmake - CMake build scripts
21
22       build - Builds the package directly
23
24
25
26       An  optional  package name can be given to generate a different package
27       than the root/CWD package.
28

OPTIONS

30       -b,    Specifies the type of build to perform. Note  that  setting  the
31              DFLAGS  environment  variable  will override the build type with
32              custom flags.  Possible names:
33                debug  (default),  plain,  release,  release-debug,   release-
34              nobounds,   unittest,  profile,  profile-gc,  docs,  ddox,  cov,
35              unittest-cov, syntax and custom types
36
37       -c,    Builds the specified configuration. Configurations  can  be  de‐
38              fined in dub.json
39
40       --override-config=VALUE
41              Uses  the  specified configuration for a certain dependency. Can
42              be specified multiple times.  Format:  --override-config=<depen‐
43              dency>/<config>
44
45       --compiler=VALUE
46              Specifies the compiler binary to use (can be a path).  Arbitrary
47              pre- and suffixes to the identifiers below are recognized  (e.g.
48              ldc2 or dmd-2.063) and matched to the proper compiler type:
49                dmd, gdc, ldc, gdmd, ldmd
50
51       -a,    Force a different architecture (e.g. x86 or x86_64)
52
53       -d,    Define  the  specified  debug version identifier when building -
54              can be used multiple times
55
56       --nodeps
57              Do not resolve missing dependencies before building
58
59       --build-mode=VALUE
60              Specifies the way the compiler and  linker  are  invoked.  Valid
61              values:
62                separate (default), allAtOnce, singleFile
63
64       --single
65              Treats  the  package name as a filename. The file must contain a
66              package recipe comment.
67
68       --force-remove
69              Deprecated option that does nothing.
70
71       --filter-versions
72              [Experimental] Filter  version  identifiers  and  debug  version
73              identifiers to improve build cache efficiency.
74
75       --combined
76              Tries to build the whole project in a single compiler run.
77
78       --print-builds
79              Prints the list of available build types
80
81       --print-configs
82              Prints the list of available configurations
83
84       --print-platform
85              Prints  the  identifiers  for the current build platform as used
86              for the build fields in dub.json
87
88       --parallel
89              Runs multiple compiler instances in parallel, if possible.
90

FILES

92       dub.sdl, dub.json
93

AUTHOR

95       Copyright (c) 1999-2022 by The D Language Foundation
96

ONLINE DOCUMENTATION

98       ⟨http://code.dlang.org/docs/commandline⟩http://code.dlang.org/docs/commandline
99