File: cli.rst

package info (click to toggle)
ocaml-dune 3.20.2-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 33,564 kB
  • sloc: ml: 175,178; asm: 28,570; ansic: 5,251; sh: 1,096; lisp: 625; makefile: 148; python: 125; cpp: 48; javascript: 10
file content (231 lines) | stat: -rw-r--r-- 4,842 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
Command Line Interface
======================

This is a short overview of the commands available in Dune. Reference
documentation for each command is available through ``dune COMMAND --help``.

.. describe:: dune build

   Build the given targets, or the default ones.

.. describe:: dune cache

   Manage the shared cache of build artifacts.

   .. describe:: dune cache size

      Query the size of the Dune cache.

   .. describe:: dune cache trim

      Trim the Dune cache.

.. describe:: dune clean

   Clean the project.

.. describe:: dune coq

   Command group related to Coq.

   .. describe:: dune coq top

      Execute a Coq toplevel with the local configuration.

.. describe:: dune describe

   Describe the workspace.

   .. describe:: dune describe aliases

      Print aliases in a given directory. Works similarly to ls.

   .. describe:: dune describe env

      Print the environment of a directory.

   .. describe:: dune describe external-lib-deps

      Print out the external libraries needed to build the project. It's an
      approximated set of libraries.

   .. describe:: dune describe installed-libraries

      Print out the libraries installed on the system.

   .. describe:: dune describe opam-files

      Print information about the opam files that have been discovered.

   .. describe:: dune describe package-entries

      prints information about the entries per package.

   .. describe:: dune describe pp

      Build a given file and print the preprocessed output.

   .. describe:: dune describe rules

      Dump rules.

   .. describe:: dune describe targets

      Print targets in a given directory. Works similarly to ls.

   .. describe:: dune describe workspace

      Print a description of the workspace's structure. If some directories
      are provided, then only those directories of the workspace are
      considered.

.. describe:: dune diagnostics

   Fetch and return errors from the current build.

.. describe:: dune exec

   Execute a command in a similar environment as if installation was performed.

.. describe:: dune fmt

   Format source code.

.. describe:: dune format-dune-file

   Format ``dune`` files.

.. describe:: dune help

   Additional Dune help.

.. describe:: dune init

   Command group for initializing Dune components.

   .. describe:: dune init executable

      Initialize a binary executable.

   .. describe:: dune init library

      Initialize an OCaml library.

   .. describe:: dune init project

      Initialize a whole OCaml project.

   .. describe:: dune init test

      Initialize a test harness.

.. describe:: dune install

   Install packages defined in workspace.

.. describe:: dune installed-libraries

   Print out libraries installed on the system.

.. describe:: dune ocaml

   Command group related to OCaml.

   .. describe:: dune ocaml dump-dot-merlin

      Print Merlin configuration.

   .. describe:: dune ocaml merlin

      Command group related to Merlin.

      .. describe:: dune ocaml merlin dump-config

         Prints the entire content of the Merlin configuration for the given
         folder in a user friendly form.

      .. describe:: dune ocaml merlin start-session

         Start a Merlin configuration server.

   .. describe:: dune ocaml ocaml-merlin

      Start a Merlin configuration server.

   .. describe:: dune ocaml top

      Print a list of toplevel directives for including directories and loading
      ``.cma`` files.

   .. describe:: dune ocaml top-module

      Print a list of toplevel directives for loading a module into the toplevel.

   .. describe:: dune ocaml utop

      Load library in UTop.

.. describe:: dune ocaml-merlin

   Start a Merlin configuration server.

.. describe:: dune printenv

   Print the environment of a directory.

.. describe:: dune promotion

   Control how changes are propagated back to source code.

   .. describe:: dune promotion apply

           Promote files from the last run.

   .. describe:: dune promotion diff

           List promotions to be applied.

.. describe:: dune promote

   A command alias for ``dune promotion apply``.

.. describe:: dune rpc

   Dune's RPC mechanism. Experimental.

.. describe:: dune rules

   Dump rules.

.. describe:: dune runtest

   Run tests.

.. describe:: dune test

   A command alias for ``dune runtest``.

.. describe:: dune shutdown

   Cancel and shutdown any builds in the current workspace.

.. describe:: dune subst

   Substitute watermarks in source files.

.. describe:: dune top

   Print a list of toplevel directives for including directories and loading
   ``.cma`` files.

.. describe:: dune uninstall

   Uninstall packages defined in the workspace.

.. describe:: dune upgrade

   Upgrade projects across major Dune versions.

.. describe:: dune utop

   Load library in UTop.