@@ -11,19 +11,19 @@ local builds with this command (configuring is not necessary):
11
11
12
12
::
13
13
14
- $ cabal v2- build
14
+ $ cabal build
15
15
16
16
To open a GHCi shell with this package, use this command:
17
17
18
18
::
19
19
20
- $ cabal v2- repl
20
+ $ cabal repl
21
21
22
22
To run an executable defined in this package, use this command:
23
23
24
24
::
25
25
26
- $ cabal v2- run <executable name> [executable args]
26
+ $ cabal run <executable name> [executable args]
27
27
28
28
Developing multiple packages
29
29
----------------------------
@@ -51,37 +51,37 @@ directory, run the command: (using cabal-install-2.0 or greater.)
51
51
52
52
::
53
53
54
- $ cabal v2- build all
54
+ $ cabal build all
55
55
56
- To build a specific package, you can either run ``v2- build `` from the
56
+ To build a specific package, you can either run ``build `` from the
57
57
directory of the package in question:
58
58
59
59
::
60
60
61
61
$ cd cabal-install
62
- $ cabal v2- build
62
+ $ cabal build
63
63
64
64
or you can pass the name of the package as an argument to
65
- ``cabal v2- build `` (this works in any subdirectory of the project):
65
+ ``cabal build `` (this works in any subdirectory of the project):
66
66
67
67
::
68
68
69
- $ cabal v2- build cabal-install
69
+ $ cabal build cabal-install
70
70
71
71
You can also specify a specific component of the package to build. For
72
72
example, to build a test suite named ``package-tests ``, use the command:
73
73
74
74
::
75
75
76
- $ cabal v2- build package-tests
76
+ $ cabal build package-tests
77
77
78
78
Targets can be qualified with package names. So to request
79
79
``package-tests `` *from * the ``Cabal `` package, use
80
80
``Cabal-tests:package-tests ``.
81
81
82
82
Unlike sandboxes, there is no need to setup a sandbox or ``add-source ``
83
83
projects; just check in ``cabal.project `` to your repository and
84
- ``v2- build `` will just work.
84
+ ``build `` will just work.
85
85
86
86
Cookbook
87
87
========
@@ -94,14 +94,14 @@ line::
94
94
95
95
profiling: True
96
96
97
- Now, ``cabal v2- build `` will automatically build all libraries and
97
+ Now, ``cabal build `` will automatically build all libraries and
98
98
executables with profiling. You can fine-tune the profiling settings
99
99
for each package using :cfg-field: `profiling-detail `::
100
100
101
101
package p
102
102
profiling-detail: toplevel-functions
103
103
104
- Alternately, you can call ``cabal v2- build --enable-profiling `` to
104
+ Alternately, you can call ``cabal build --enable-profiling `` to
105
105
temporarily build with profiling.
106
106
107
107
How can I have a reproducible set of versions for my dependencies?
@@ -173,13 +173,13 @@ built version.
173
173
The global package store is ``~/.cabal/store `` (configurable via
174
174
global `store-dir ` option); if you need to clear your store for
175
175
whatever reason (e.g., to reclaim disk space or because the global
176
- store is corrupted), deleting this directory is safe (``v2- build ``
176
+ store is corrupted), deleting this directory is safe (``build ``
177
177
will just rebuild everything it needs on its next invocation).
178
178
179
179
This split motivates some of the UI choices for Nix-style local build
180
- commands. For example, flags passed to ``cabal v2- build `` are only
180
+ commands. For example, flags passed to ``cabal build `` are only
181
181
applied to *local * packages, so that adding a flag to
182
- ``cabal v2- build `` doesn't necessitate a rebuild of *every * transitive
182
+ ``cabal build `` doesn't necessitate a rebuild of *every * transitive
183
183
dependency in the global package store.
184
184
185
185
In cabal-install 2.0 and above, Nix-style local builds also take advantage of a
@@ -194,10 +194,10 @@ are not currently built on a per-component basis.
194
194
Where are my build products?
195
195
----------------------------
196
196
197
- A major deficiency in the current implementation of v2- build is that
197
+ A major deficiency in the current implementation of `` cabal build`` is that
198
198
there is no programmatic way to access the location of build products.
199
199
The location of the build products is intended to be an internal
200
- implementation detail of v2- build, but we also understand that many
200
+ implementation detail of `` cabal build`` , but we also understand that many
201
201
unimplemented features can only be reasonably worked around by
202
202
accessing build products directly.
203
203
@@ -245,7 +245,7 @@ the time it takes to execute a rebuild cycle. While the details of how
245
245
``cabal-install `` does caching are an implementation detail and may
246
246
change in the future, knowing what gets cached is helpful for
247
247
understanding the performance characteristics of invocations to
248
- ``v2- build ``. The cached intermediate results are stored in
248
+ ``build ``. The cached intermediate results are stored in
249
249
``dist-newstyle/cache ``; this folder can be safely deleted to clear the
250
250
cache.
251
251
@@ -261,7 +261,7 @@ this folder (the most important two are first):
261
261
already available in the store.)
262
262
``source-hashes `` (binary)
263
263
The hashes of all local source files. When all local source files of
264
- a local package are unchanged, ``cabal v2- build `` will skip
264
+ a local package are unchanged, ``cabal build `` will skip
265
265
invoking ``setup build `` entirely (saving us from a possibly
266
266
expensive call to ``ghc --make ``). The full list of source files
267
267
participating in compilation is determined using
0 commit comments