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.
|