1dune-external-lib-deps(1) Dune Manual dune-external-lib-deps(1)
2
3
4
6 dune-external-lib-deps - Print out external libraries needed to build
7 the given targets.
8
10 dune external-lib-deps [OPTION]... TARGET...
11
13 Print out the external libraries needed to build the given targets.
14
15 The output of jbuild external-lib-deps @install should be included in
16 what is written in your <package>.opam file.
17
19 -f, --force
20 Force actions associated to aliases to be re-executed even if their
21 dependencies haven't changed.
22
23 --help[=FMT] (default=auto)
24 Show this help in format FMT. The value FMT must be one of `auto',
25 `pager', `groff' or `plain'. With `auto', the format is `pager` or
26 `plain' whenever the TERM env var is `dumb' or undefined.
27
28 --missing
29 Only print out missing dependencies
30
31 --sexp
32 Produce a s-expression output
33
34 --unstable-by-dir
35 Print dependencies per directory (this feature is currently
36 unstable)
37
38 --version
39 Show version information.
40
41 -w, --watch
42 Instead of terminating build after completion, wait continuously
43 for file changes.
44
46 These options are common to all commands.
47
48 --auto-promote
49 Automatically promote files. This is similar to running dune
50 promote after the build.
51
52 --build-dir=FILE (absent DUNE_BUILD_DIR env)
53 Specified build directory. _build if unspecified
54
55 --config-file=FILE
56 Load this configuration file instead of the default one.
57
58 --debug-backtraces
59 Always print exception backtraces.
60
61 --debug-dependency-path
62 In case of error, print the dependency path from the targets on the
63 command line to the rule that failed.
64
65 --debug-findlib
66 Debug the findlib sub-system.
67
68 --default-target=TARGET
69 Set the default target that when none is specified to dune build.
70 It defaults to @@default.
71
72 --dev
73 Same as --profile dev
74
75 --diff-command=VAL
76 Shell command to use to diff files. Use - to disable printing the
77 diff.
78
79 --display=MODE
80 Control the display mode of Dune. See dune-config(5) for more
81 details.
82
83 --ignore-promoted-rules
84 Ignore rules with (mode promote)
85
86 -j JOBS
87 Run no more than JOBS commands simultaneously.
88
89 --no-buffer
90 Do not buffer the output of commands executed by dune. By default
91 dune buffers the output of subcommands, in order to prevent
92 interleaving when multiple commands are executed in parallel.
93 However, this can be an issue when debugging long running tests.
94 With --no-buffer, commands have direct access to the terminal. Note
95 that as a result their output won't be captured in the log file.
96 You should use this option in conjunction with -j 1, to avoid
97 interleaving. Additionally you should use --verbose as well, to
98 make sure that commands are printed before they are being executed.
99
100 --no-config
101 Do not load the configuration file
102
103 --no-print-directory
104 Suppress "Entering directory" messages
105
106 --only-packages=PACKAGES
107 Ignore stanzas referring to a package that is not in PACKAGES.
108 PACKAGES is a comma-separated list of package names. Note that this
109 has the same effect as deleting the relevant stanzas from jbuild
110 files. It is mostly meant for releases. During development, it is
111 likely that what you want instead is to build a particular
112 <package>.install target.
113
114 -p PACKAGES, --for-release-of-packages=PACKAGES
115 Shorthand for --root . --only-packages PACKAGE
116 --ignore-promoted-rules --no-config --profile release. You must use
117 this option in your <package>.opam files, in order to build only
118 what's necessary when your project contains multiple packages as
119 well as getting reproducible builds.
120
121 --profile=VAL (absent DUNE_PROFILE env)
122 Select the build profile, for instance dev or release. The default
123 is dev.
124
125 --root=DIR
126 Use this directory as workspace root instead of guessing it. Note
127 that this option doesn't change the interpretation of targets given
128 on the command line. It is only intended for scripts.
129
130 --store-orig-source-dir (absent DUNE_STORE_ORIG_SOURCE_DIR env)
131 Store original source location in dune-package metadata
132
133 --trace-file=FILE
134 Output trace data in catapult format (compatible with
135 chrome://tracing)
136
137 --verbose
138 Same as --display verbose
139
140 --workspace=FILE
141 Use this specific workspace file instead of looking it up.
142
143 -x VAL
144 Cross-compile using this toolchain.
145
147 Use `dune COMMAND --help' for help on a single command.
148
150 These environment variables affect the execution of external-lib-deps:
151
152 DUNE_BUILD_DIR
153 Specified build directory. _build if unspecified
154
155 DUNE_PROFILE
156 Build profile. dev if unspecified or release if -p is set.
157
158 DUNE_STORE_ORIG_SOURCE_DIR
159 Store original source location in dune-package metadata
160
162 Check bug reports at https://github.com/ocaml/dune/issues
163
164
165
166Dune 11VERSION11 dune-external-lib-deps(1)