1CABAL(1)                    General Commands Manual                   CABAL(1)
2
3
4

NAME

6       cabal  - a system for building and packaging Haskell libraries and pro‐
7       grams
8

SYNOPSIS

10       cabal command <arguments|[options]>...
11
12       Where the commands are
13
14       cabal install - Install packages.
15       cabal update - Updates list of known packages.
16       cabal list - List packages matching a search string.
17       cabal info - Display detailed information about a particular package.
18       cabal fetch - Downloads packages for later installation.
19       cabal freeze - Freeze dependencies.
20       cabal get - Download/Extract a package's source code (repository).
21       cabal check - Check the package for common mistakes.
22       cabal sdist - Generate a source distribution file (.tar.gz).
23       cabal upload - Uploads source packages or documentation to Hackage.
24       cabal report - Upload build reports to a remote server.
25       cabal run - Builds and runs an executable.
26       cabal init - Create a new .cabal package file (interactively).
27       cabal configure - Prepare to build the package.
28       cabal reconfigure - Reconfigure the package if necessary.
29       cabal build - Compile all/specific components.
30       cabal repl - Open an interpreter session for the given component.
31       cabal sandbox - Create/modify/delete a sandbox.
32       cabal doctest - Run doctest tests.
33       cabal haddock - Generate Haddock HTML documentation.
34       cabal exec - Give a command access to the sandbox package repository.
35       cabal user-config - Display and update the user's global cabal configu‐
36       ration.
37       cabal clean - Clean up after a build.
38       cabal gen-bounds - Generate dependency bounds.
39       cabal outdated - Check for outdated dependencies
40       cabal copy - Copy the files of all/specific components to install loca‐
41       tions.
42       cabal hscolour - Generate HsColour colourised code, in HTML format.
43       cabal register - Register this package with the compiler.
44       cabal test - Run all/specific tests in the test suite.
45       cabal bench - Run all/specific benchmarks.
46       cabal new-configure - Add extra project configuration
47       cabal new-update - Updates list of known packages.
48       cabal new-build - Compile targets within the project.
49       cabal new-repl - Open an interactive session for the given component.
50       cabal new-freeze - Freeze dependencies.
51       cabal new-haddock - Build Haddock documentation
52       cabal new-install - Install packages.
53       cabal new-run - Run an executable.
54       cabal new-test - Run test-suites
55       cabal new-bench - Run benchmarks
56       cabal new-exec - Give a command access to the store.
57

DESCRIPTION

59       Cabal is the standard package system for  Haskell  software.  It  helps
60       people to configure, build and install Haskell software and to distrib‐
61       ute it easily to other users and developers.
62
63       The command line cabal tool (also referred to as  cabal-install)  helps
64       with  installing existing packages and developing new packages.  It can
65       be used to work with local packages or to install packages from  online
66       package  archives,  including automatically installing dependencies. By
67       default it is configured to use Hackage,  which  is  Haskell's  central
68       package  archive  that contains thousands of libraries and applications
69       in the Cabal package format.
70

OPTIONS

72       Global options:
73
74       -V, --version
75              Print version information
76
77       --numeric-version
78              Print just the version number
79
80       --config-file FILE
81              Set an alternate location for the config file
82
83       --sandbox-config-file FILE
84              Set an alternate location for the sandbox config file  (default:
85              './cabal.sandbox.config')
86
87       --default-user-config FILE
88              Set  a  location  for  a  cabal.config file for projects without
89              their own cabal.config freeze file.
90
91       --require-sandbox
92       --no-require-sandbox
93              requiring the presence of a sandbox for sandbox-aware commands
94
95       --ignore-sandbox
96              Ignore any existing sandbox
97
98       --ignore-expiry
99              Ignore expiry dates on signed metadata (use only in  exceptional
100              circumstances)
101
102       --http-transport HttpTransport
103              Set  a  transport  for http(s) requests. Accepts 'curl', 'wget',
104              'powershell', and 'plain-http'. (default: 'curl')
105
106       --enable-nix
107       --disable-nix
108              Nix integration: run commands through nix-shell if a 'shell.nix'
109              file exists
110
111       --remote-repo NAME:URL
112              The name and url for a remote repository
113
114       --remote-repo-cache DIR
115              The location where downloads from all remote repos are cached
116
117       --local-repo DIR
118              The location of a local repository
119
120       --logs-dir DIR
121              The location to put log files
122
123       --world-file FILE
124              The location of the world file
125
126       --store-dir DIR
127              The location of the nix-local-build store
128
129

COMMANDS

131       cabal install
132
133       Usage: cabal install [FLAGS]
134          or: cabal install [FLAGS] PACKAGES
135
136
137       Installs  one  or more packages. By default, the installed package will
138       be registered in the user's  package  database  or,  if  a  sandbox  is
139       present in the current directory, inside the sandbox.
140
141       If  PACKAGES are specified, downloads and installs those packages. Oth‐
142       erwise, install the package in the current directory (and/or its depen‐
143       dencies)  (there  must be exactly one .cabal file in the current direc‐
144       tory).
145
146       When using a sandbox, the flags for `install` only affect  the  current
147       command  and have no effect on future commands. (To achieve that, `con‐
148       figure` must be used.)  In contrast, without a sandbox,  the  flags  to
149       `install`  are  saved  and  affect  future commands such as `build` and
150       `repl`. See the help for `configure`  for  a  list  of  commands  being
151       affected.
152
153       Installed  executables  will  by default (and without a sandbox) be put
154       into `~/.cabal/bin/`. If you want installed executable to be  available
155       globally,  make  sure  that the PATH environment variable contains that
156       directory.  When using a sandbox, executables will be put into  `$SAND‐
157       BOX/bin/` (by default: `./.cabal-sandbox/bin/`).
158
159       When  specifying --bindir, consider also specifying --datadir; this way
160       the sandbox can be deleted and the executable should  continue  working
161       as long as bindir and datadir are left untouched.
162
163
164       The flags --with-PROG and --PROG-option(s) can be used with the follow‐
165       ing programs:
166         alex ar c2hs cpphs doctest gcc ghc ghc-pkg ghcjs ghcjs-pkg  greencard
167       haddock
168         happy  haskell-suite  haskell-suite-pkg hmake hpc hsc2hs hscolour jhc
169       ld lhc
170         lhc-pkg pkg-config runghc strip tar uhc
171
172       Examples:
173         cabal install                     Package in the current directory
174         cabal install foo                 Package from the hackage server
175         cabal install foo-1.0             Specific version of a package
176         cabal install 'foo < 2'           Constrained package version
177         cabal install haddock --bindir=$HOME/hask-bin/  --datadir=$HOME/hask-
178       data/
179                                           Change installation destination
180
181
182       Flags:
183              -v, --verbose [n]
184                     Control  verbosity (n is 0--3, default verbosity level is
185                     1)
186
187              --builddir, --distdir, --distpref DIR
188                     The directory where  Cabal  puts  generated  build  files
189                     (default dist)
190
191              -g, --ghc
192                     compile with GHC
193
194              --ghcjs
195                     compile with GHCJS
196
197              --jhc
198                     compile with JHC
199
200              --lhc
201                     compile with LHC
202
203              --uhc
204                     compile with UHC
205
206              --haskell-suite
207                     compile with a haskell-suite compiler
208
209              --cabal-file PATH
210                     use this Cabal file
211
212              -w, --with-compiler PATH
213                     give the path to a particular compiler
214
215              --with-hc-pkg PATH
216                     give the path to the package tool
217
218              --prefix DIR
219                     bake this prefix in preparation of installation
220
221              --bindir DIR
222                     installation directory for executables
223
224              --libdir DIR
225                     installation directory for libraries
226
227              --libsubdir DIR
228                     subdirectory of libdir in which libs are installed
229
230              --dynlibdir DIR
231                     installation directory for dynamic libraries
232
233              --libexecdir DIR
234                     installation directory for program executables
235
236              --libexecsubdir DIR
237                     subdirectory  of  libexecdir in which private executables
238                     are installed
239
240              --datadir DIR
241                     installation directory for read-only data
242
243              --datasubdir DIR
244                     subdirectory of datadir in which data files are installed
245
246              --docdir DIR
247                     installation directory for documentation
248
249              --htmldir DIR
250                     installation directory for HTML documentation
251
252              --haddockdir DIR
253                     installation directory for haddock interfaces
254
255              --sysconfdir DIR
256                     installation directory for configuration files
257
258              --program-prefix PREFIX
259                     prefix to be applied to installed executables
260
261              --program-suffix SUFFIX
262                     suffix to be applied to installed executables
263
264              --enable-library-vanilla
265              --disable-library-vanilla
266                     Vanilla libraries
267
268              -p, --enable-library-profiling
269              --disable-library-profiling
270                     Library profiling
271
272              --enable-shared
273              --disable-shared
274                     Shared library
275
276              --enable-static
277              --disable-static
278                     Static library
279
280              --enable-executable-dynamic
281              --disable-executable-dynamic
282                     Executable dynamic linking
283
284              --enable-profiling
285              --disable-profiling
286                     Executable and library profiling
287
288              --enable-executable-profiling
289              --disable-executable-profiling
290                     Executable profiling (DEPRECATED)
291
292              --profiling-detail level
293                     Profiling  detail  level  for  executable   and   library
294                     (default,  none,  exported-functions, toplevel-functions,
295                     all-functions).
296
297              --library-profiling-detail level
298                     Profiling detail level for libraries only.
299
300              -O, --enable-optimization, --enable-optimisation [n]
301                     Build with optimization (n is 0--2, default is 1)
302
303              --disable-optimization, --disable-optimisation
304                     Build without optimization
305
306              --enable-debug-info [n]
307                     Emit debug info (n is 0--3, default is 0)
308
309              --disable-debug-info
310                     Don't emit debug info
311
312              --enable-library-for-ghci
313              --disable-library-for-ghci
314                     compile library for use with GHCi
315
316              --enable-split-sections
317              --disable-split-sections
318                     compile library code such that unneeded  definitions  can
319                     be dropped from the final executable (GHC 7.8+)
320
321              --enable-split-objs
322              --disable-split-objs
323                     split library into smaller objects to reduce binary sizes
324                     (GHC 6.6+)
325
326              --enable-executable-stripping
327              --disable-executable-stripping
328                     strip executables  upon  installation  to  reduce  binary
329                     sizes
330
331              --enable-library-stripping
332              --disable-library-stripping
333                     strip libraries upon installation to reduce binary sizes
334
335              --configure-option OPT
336                     Extra option for configure
337
338              --user
339              --global
340                     doing a per-user installation
341
342              --package-db DB
343                     Append  the given package database to the list of package
344                     databases used  (to  satisfy  dependencies  and  register
345                     into).  May  be  a specific file, 'global' or 'user'. The
346                     initial  list  is  ['global'],  ['global',  'user'],   or
347                     ['global',  $sandbox],  depending on context. Use 'clear'
348                     to reset the list  to  empty.  See  the  user  guide  for
349                     details.
350
351              -f, --flags FLAGS
352                     Force values for the given flags in Cabal conditionals in
353                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
354                     forces  the  flag "debug" to true and "usebytestrings" to
355                     false.
356
357              --extra-include-dirs PATH
358                     A list of directories to search for header files
359
360              --enable-deterministic
361              --disable-deterministic
362                     Try to be as deterministic as possible (used by the  test
363                     suite)
364
365              --ipid IPID
366                     Installed package ID to compile this package as
367
368              --cid CID
369                     Installed component ID to compile this component as
370
371              --extra-lib-dirs PATH
372                     A list of directories to search for external libraries
373
374              --extra-framework-dirs PATH
375                     A  list  of directories to search for external frameworks
376                     (OS X only)
377
378              --extra-prog-path PATH
379                     A list of directories to search for required programs (in
380                     addition to the normal search locations)
381
382              --instantiate-with NAME=MOD
383                     A mapping of signature names to concrete module instanti‐
384                     ations.
385
386              --enable-tests
387              --disable-tests
388                     dependency  checking  and  compilation  for  test  suites
389                     listed in the package description file.
390
391              --enable-coverage
392              --disable-coverage
393                     build package with Haskell Program Coverage. (GHC only)
394
395              --enable-library-coverage
396              --disable-library-coverage
397                     build  package  with Haskell Program Coverage. (GHC only)
398                     (DEPRECATED)
399
400              --enable-benchmarks
401              --disable-benchmarks
402                     dependency checking and compilation for benchmarks listed
403                     in the package description file.
404
405              --enable-relocatable
406              --disable-relocatable
407                     building a package that is relocatable. (GHC only)
408
409              --disable-response-files
410                     enable  workaround for old versions of programs like "ar"
411                     that do not support @file arguments
412
413              --with-alex PATH
414                     give the path to alex
415
416              --with-ar PATH
417                     give the path to ar
418
419              --with-c2hs PATH
420                     give the path to c2hs
421
422              --with-cpphs PATH
423                     give the path to cpphs
424
425              --with-doctest PATH
426                     give the path to doctest
427
428              --with-gcc PATH
429                     give the path to gcc
430
431              --with-ghc PATH
432                     give the path to ghc
433
434              --with-ghc-pkg PATH
435                     give the path to ghc-pkg
436
437              --with-ghcjs PATH
438                     give the path to ghcjs
439
440              --with-ghcjs-pkg PATH
441                     give the path to ghcjs-pkg
442
443              --with-greencard PATH
444                     give the path to greencard
445
446              --with-haddock PATH
447                     give the path to haddock
448
449              --with-happy PATH
450                     give the path to happy
451
452              --with-haskell-suite PATH
453                     give the path to haskell-suite
454
455              --with-haskell-suite-pkg PATH
456                     give the path to haskell-suite-pkg
457
458              --with-hmake PATH
459                     give the path to hmake
460
461              --with-hpc PATH
462                     give the path to hpc
463
464              --with-hsc2hs PATH
465                     give the path to hsc2hs
466
467              --with-hscolour PATH
468                     give the path to hscolour
469
470              --with-jhc PATH
471                     give the path to jhc
472
473              --with-ld PATH
474                     give the path to ld
475
476              --with-lhc PATH
477                     give the path to lhc
478
479              --with-lhc-pkg PATH
480                     give the path to lhc-pkg
481
482              --with-pkg-config PATH
483                     give the path to pkg-config
484
485              --with-runghc PATH
486                     give the path to runghc
487
488              --with-strip PATH
489                     give the path to strip
490
491              --with-tar PATH
492                     give the path to tar
493
494              --with-uhc PATH
495                     give the path to uhc
496
497              --alex-option OPT
498                     give an extra option to alex (no need  to  quote  options
499                     containing spaces)
500
501              --ar-option OPT
502                     give an extra option to ar (no need to quote options con‐
503                     taining spaces)
504
505              --c2hs-option OPT
506                     give an extra option to c2hs (no need  to  quote  options
507                     containing spaces)
508
509              --cpphs-option OPT
510                     give  an  extra option to cpphs (no need to quote options
511                     containing spaces)
512
513              --doctest-option OPT
514                     give an extra option to doctest (no need to quote options
515                     containing spaces)
516
517              --gcc-option OPT
518                     give  an  extra  option  to gcc (no need to quote options
519                     containing spaces)
520
521              --ghc-option OPT
522                     give an extra option to ghc (no  need  to  quote  options
523                     containing spaces)
524
525              --ghc-pkg-option OPT
526                     give an extra option to ghc-pkg (no need to quote options
527                     containing spaces)
528
529              --ghcjs-option OPT
530                     give an extra option to ghcjs (no need to  quote  options
531                     containing spaces)
532
533              --ghcjs-pkg-option OPT
534                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
535                     options containing spaces)
536
537              --greencard-option OPT
538                     give an extra option  to  greencard  (no  need  to  quote
539                     options containing spaces)
540
541              --haddock-option OPT
542                     give an extra option to haddock (no need to quote options
543                     containing spaces)
544
545              --happy-option OPT
546                     give an extra option to happy (no need to  quote  options
547                     containing spaces)
548
549              --haskell-suite-option OPT
550                     give  an  extra option to haskell-suite (no need to quote
551                     options containing spaces)
552
553              --haskell-suite-pkg-option OPT
554                     give an extra option to  haskell-suite-pkg  (no  need  to
555                     quote options containing spaces)
556
557              --hmake-option OPT
558                     give  an  extra option to hmake (no need to quote options
559                     containing spaces)
560
561              --hpc-option OPT
562                     give an extra option to hpc (no  need  to  quote  options
563                     containing spaces)
564
565              --hsc2hs-option OPT
566                     give  an extra option to hsc2hs (no need to quote options
567                     containing spaces)
568
569              --hscolour-option OPT
570                     give an extra  option  to  hscolour  (no  need  to  quote
571                     options containing spaces)
572
573              --jhc-option OPT
574                     give  an  extra  option  to jhc (no need to quote options
575                     containing spaces)
576
577              --ld-option OPT
578                     give an extra option to ld (no need to quote options con‐
579                     taining spaces)
580
581              --lhc-option OPT
582                     give  an  extra  option  to lhc (no need to quote options
583                     containing spaces)
584
585              --lhc-pkg-option OPT
586                     give an extra option to lhc-pkg (no need to quote options
587                     containing spaces)
588
589              --pkg-config-option OPT
590                     give  an  extra  option  to  pkg-config (no need to quote
591                     options containing spaces)
592
593              --runghc-option OPT
594                     give an extra option to runghc (no need to quote  options
595                     containing spaces)
596
597              --strip-option OPT
598                     give  an  extra option to strip (no need to quote options
599                     containing spaces)
600
601              --tar-option OPT
602                     give an extra option to tar (no  need  to  quote  options
603                     containing spaces)
604
605              --uhc-option OPT
606                     give  an  extra  option  to uhc (no need to quote options
607                     containing spaces)
608
609              --alex-options OPTS
610                     give extra options to alex
611
612              --ar-options OPTS
613                     give extra options to ar
614
615              --c2hs-options OPTS
616                     give extra options to c2hs
617
618              --cpphs-options OPTS
619                     give extra options to cpphs
620
621              --doctest-options OPTS
622                     give extra options to doctest
623
624              --gcc-options OPTS
625                     give extra options to gcc
626
627              --ghc-options OPTS
628                     give extra options to ghc
629
630              --ghc-pkg-options OPTS
631                     give extra options to ghc-pkg
632
633              --ghcjs-options OPTS
634                     give extra options to ghcjs
635
636              --ghcjs-pkg-options OPTS
637                     give extra options to ghcjs-pkg
638
639              --greencard-options OPTS
640                     give extra options to greencard
641
642              --haddock-options OPTS
643                     give extra options to haddock
644
645              --happy-options OPTS
646                     give extra options to happy
647
648              --haskell-suite-options OPTS
649                     give extra options to haskell-suite
650
651              --haskell-suite-pkg-options OPTS
652                     give extra options to haskell-suite-pkg
653
654              --hmake-options OPTS
655                     give extra options to hmake
656
657              --hpc-options OPTS
658                     give extra options to hpc
659
660              --hsc2hs-options OPTS
661                     give extra options to hsc2hs
662
663              --hscolour-options OPTS
664                     give extra options to hscolour
665
666              --jhc-options OPTS
667                     give extra options to jhc
668
669              --ld-options OPTS
670                     give extra options to ld
671
672              --lhc-options OPTS
673                     give extra options to lhc
674
675              --lhc-pkg-options OPTS
676                     give extra options to lhc-pkg
677
678              --pkg-config-options OPTS
679                     give extra options to pkg-config
680
681              --runghc-options OPTS
682                     give extra options to runghc
683
684              --strip-options OPTS
685                     give extra options to strip
686
687              --tar-options OPTS
688                     give extra options to tar
689
690              --uhc-options OPTS
691                     give extra options to uhc
692
693              --cabal-lib-version VERSION
694                     Select which version of the Cabal lib  to  use  to  build
695                     packages (useful for testing).
696
697              --constraint CONSTRAINT
698                     Specify    constraints    on    a    package    (version,
699                     installed/source, flags)
700
701              --preference CONSTRAINT
702                     Specify preferences (soft constraints) on the version  of
703                     a package
704
705              --solver SOLVER
706                     Select  dependency  solver  to  use  (default:  modular).
707                     Choices: modular.
708
709              --allow-older [DEPS]
710                     Ignore lower bounds in all dependencies or DEPS
711
712              --allow-newer [DEPS]
713                     Ignore upper bounds in all dependencies or DEPS
714
715              --enable-documentation
716              --disable-documentation
717                     building of documentation
718
719              --doc-index-file TEMPLATE
720                     A central index of haddock  API  documentation  (template
721                     cannot use $pkgid)
722
723              --dry-run
724                     Do  not  install  anything,  only  print  what  would  be
725                     installed.
726
727              --max-backjumps NUM
728                     Maximum  number  of  backjumps  allowed   while   solving
729                     (default:  2000).  Use a negative number to enable unlim‐
730                     ited backtracking. Use 0  to  disable  backtracking  com‐
731                     pletely.
732
733              --reorder-goals
734              --no-reorder-goals
735                     Try  to  reorder  goals  according to certain heuristics.
736                     Slows things down on average, but may  make  backtracking
737                     faster for some packages.
738
739              --count-conflicts
740              --no-count-conflicts
741                     Try  to  speed  up  solving  by preferring goals that are
742                     involved in a lot of conflicts (default).
743
744              --independent-goals
745              --no-independent-goals
746                     Treat several goals on the command line  as  independent.
747                     If  several  goals  depend on the same package, different
748                     versions can be chosen.
749
750              --shadow-installed-packages
751              --no-shadow-installed-packages
752                     If multiple package instances of  the  same  version  are
753                     installed, treat all but one as shadowed.
754
755              --strong-flags
756              --no-strong-flags
757                     Do not defer flag choices (this used to be the default in
758                     cabal-install <= 1.20).
759
760              --allow-boot-library-installs
761              --no-allow-boot-library-installs
762                     Allow cabal to install  base,  ghc-prim,  integer-simple,
763                     integer-gmp, and template-haskell.
764
765              --reinstall
766              --no-reinstall
767                     Install  even  if  it  means  installing the same version
768                     again.
769
770              --avoid-reinstalls
771              --no-avoid-reinstalls
772                     Do not select versions that would destructively overwrite
773                     installed packages.
774
775              --force-reinstalls
776              --no-force-reinstalls
777                     Reinstall  packages  even  if they will most likely break
778                     other installed packages.
779
780              --upgrade-dependencies
781              --no-upgrade-dependencies
782                     Pick the latest version for all dependencies, rather than
783                     trying to pick an installed version.
784
785              --only-dependencies
786              --no-only-dependencies
787                     Install  only  the  dependencies  necessary  to build the
788                     given packages
789
790              --dependencies-only
791              --no-dependencies-only
792                     A synonym for --only-dependencies
793
794              --index-state STATE
795                     Use source package index state as it existed at a  previ‐
796                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
797                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
798                     'HEAD' (default: 'HEAD').
799
800              --root-cmd COMMAND
801                     (No longer supported, do not use.)
802
803              --symlink-bindir DIR
804                     Add  symlinks  to  installed executables into this direc‐
805                     tory.
806
807              --build-summary TEMPLATE
808                     Save build summaries  to  file  (name  template  can  use
809                     $pkgid, $compiler, $os, $arch)
810
811              --build-log TEMPLATE
812                     Log  all  builds  to  file (name template can use $pkgid,
813                     $compiler, $os, $arch)
814
815              --remote-build-reporting LEVEL
816                     Generate build reports to send to a remote server  (none,
817                     anonymous or detailed).
818
819              --report-planning-failure
820                     Generate  build reports when the dependency solver fails.
821                     This is used by the Hackage build bot.
822
823              --enable-per-component
824              --disable-per-component
825                     Per-component builds when possible
826
827              --one-shot
828              --no-one-shot
829                     Do not record the packages in the world file.
830
831              --run-tests
832                     Run package test suites during installation.
833
834              -j, --jobs [NUM]
835                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
836                     given).
837
838              --keep-going
839                     After a build failure, continue to build other unaffected
840                     packages.
841
842              --offline
843              --no-offline
844                     Don't download packages from the Internet.
845
846              --project-file FILE
847                     Set the name of the cabal.project file to search  for  in
848                     parent directories
849
850              --only
851                     Only installs the package in the current directory.
852
853              --haddock-hoogle
854                     Generate a hoogle database
855
856              --haddock-html
857                     Generate HTML documentation (the default)
858
859              --haddock-html-location URL
860                     Location of HTML documentation for pre-requisite packages
861
862              --haddock-for-hackage
863                     Collection  of  flags  to generate documentation suitable
864                     for upload to hackage
865
866              --haddock-executables
867                     Run haddock for Executables targets
868
869              --haddock-tests
870                     Run haddock for Test Suite targets
871
872              --haddock-benchmarks
873                     Run haddock for Benchmark targets
874
875              --haddock-all
876                     Run haddock for all targets
877
878              --haddock-internal
879                     Run haddock for internal modules and include all symbols
880
881              --haddock-css PATH
882                     Use PATH as the haddock stylesheet
883
884              --haddock-hyperlink-source, --haddock-hyperlink-sources
885                     Hyperlink the documentation to the source code
886
887              --haddock-hscolour-css PATH
888                     Use PATH as the HsColour stylesheet
889
890              --haddock-contents-location URL
891                     Bake URL in as the location for the contents page
892
893
894       cabal update
895
896       Usage: cabal update [FLAGS]
897
898
899       For all known remote repositories, download the package list.
900
901
902       Relevant global configuration keys:
903         remote-repo
904         remote-repo-cache
905         local-repo
906
907
908       Flags:
909              -v, --verbose [n]
910                     Control verbosity (n is 0--3, default verbosity level  is
911                     1)
912
913              --index-state STATE
914                     Update  the  source  package  index  to  its  state as it
915                     existed at a previous time. Accepts unix-timestamps (e.g.
916                     '@1474732068'),     ISO8601    UTC    timestamps    (e.g.
917                     '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD').
918
919
920       cabal list
921
922       Usage: cabal list [FLAGS]
923          or: cabal list [FLAGS] STRINGS
924
925
926       List all packages, or all packages matching one of the search strings.
927
928       If there is a sandbox in the current directory and  config:ignore-sand‐
929       box  is  False,  use  the  sandbox package database. Otherwise, use the
930       package database specified with --package-db. If not specified, use the
931       user package database.
932
933
934       Examples:
935         cabal list pandoc
936           Will find pandoc, pandoc-citeproc, pandoc-lens, ...
937
938
939       Flags:
940              -v, --verbose [n]
941                     Control  verbosity (n is 0--3, default verbosity level is
942                     1)
943
944              --installed
945                     Only print installed packages
946
947              --simple-output
948                     Print in a easy-to-parse format
949
950              --package-db DB
951                     Append the given package database to the list of  package
952                     databases  used  (to  satisfy  dependencies  and register
953                     into). May be a specific file, 'global'  or  'user'.  The
954                     initial   list  is  ['global'],  ['global',  'user'],  or
955                     ['global', $sandbox], depending on context.  Use  'clear'
956                     to  reset  the  list  to  empty.  See  the user guide for
957                     details.
958
959
960       cabal info
961
962       Usage: cabal info [FLAGS] PACKAGES
963
964
965       If there is a sandbox in the current directory and  config:ignore-sand‐
966       box  is  False,  use  the  sandbox package database. Otherwise, use the
967       package database specified with --package-db. If not specified, use the
968       user package database.
969
970
971       Flags:
972              -v, --verbose [n]
973                     Control  verbosity (n is 0--3, default verbosity level is
974                     1)
975
976              --package-db DB
977                     Append the given package database to the list of  package
978                     databases  used  (to  satisfy  dependencies  and register
979                     into). May be a specific file, 'global'  or  'user'.  The
980                     initial   list  is  ['global'],  ['global',  'user'],  or
981                     ['global', $sandbox], depending on context.  Use  'clear'
982                     to  reset  the  list  to  empty.  See  the user guide for
983                     details.
984
985
986       cabal fetch
987
988       Usage: cabal fetch [FLAGS] PACKAGES
989
990
991       Note that it currently is not possible to fetch the dependencies for  a
992       package in the current directory.
993
994
995       Flags:
996              -v, --verbose [n]
997                     Control  verbosity (n is 0--3, default verbosity level is
998                     1)
999
1000              --dependencies, --deps
1001                     Resolve and fetch dependencies (default)
1002
1003              --no-dependencies, --no-deps
1004                     Ignore dependencies
1005
1006              --dry-run
1007                     Do  not  install  anything,  only  print  what  would  be
1008                     installed.
1009
1010              --enable-tests
1011              --disable-tests
1012                     dependency  checking  and  compilation  for  test  suites
1013                     listed in the package description file.
1014
1015              --enable-benchmarks
1016              --disable-benchmarks
1017                     dependency checking and compilation for benchmarks listed
1018                     in the package description file.
1019
1020              --solver SOLVER
1021                     Select  dependency  solver  to  use  (default:  modular).
1022                     Choices: modular.
1023
1024              --max-backjumps NUM
1025                     Maximum  number  of  backjumps  allowed   while   solving
1026                     (default:  2000).  Use a negative number to enable unlim‐
1027                     ited backtracking. Use 0  to  disable  backtracking  com‐
1028                     pletely.
1029
1030              --reorder-goals
1031              --no-reorder-goals
1032                     Try  to  reorder  goals  according to certain heuristics.
1033                     Slows things down on average, but may  make  backtracking
1034                     faster for some packages.
1035
1036              --count-conflicts
1037              --no-count-conflicts
1038                     Try  to  speed  up  solving  by preferring goals that are
1039                     involved in a lot of conflicts (default).
1040
1041              --independent-goals
1042              --no-independent-goals
1043                     Treat several goals on the command line  as  independent.
1044                     If  several  goals  depend on the same package, different
1045                     versions can be chosen.
1046
1047              --shadow-installed-packages
1048              --no-shadow-installed-packages
1049                     If multiple package instances of  the  same  version  are
1050                     installed, treat all but one as shadowed.
1051
1052              --strong-flags
1053              --no-strong-flags
1054                     Do not defer flag choices (this used to be the default in
1055                     cabal-install <= 1.20).
1056
1057              --allow-boot-library-installs
1058              --no-allow-boot-library-installs
1059                     Allow cabal to install  base,  ghc-prim,  integer-simple,
1060                     integer-gmp, and template-haskell.
1061
1062
1063       cabal freeze
1064
1065       Usage: cabal freeze [FLAGS]
1066
1067
1068       Calculates  a  valid  set  of dependencies and their exact versions. If
1069       successful, saves the result to the file `cabal.config`.
1070
1071       The package versions specified in `cabal.config` will be used  for  any
1072       future installs.
1073
1074       An existing `cabal.config` is ignored and overwritten.
1075
1076
1077       Flags:
1078              -v, --verbose [n]
1079                     Control  verbosity (n is 0--3, default verbosity level is
1080                     1)
1081
1082              --dry-run
1083                     Do not freeze anything, only print what would be frozen
1084
1085              --enable-tests
1086              --disable-tests
1087                     freezing of the dependencies of any tests suites  in  the
1088                     package description file.
1089
1090              --enable-benchmarks
1091              --disable-benchmarks
1092                     freezing  of the dependencies of any benchmarks suites in
1093                     the package description file.
1094
1095              --solver SOLVER
1096                     Select  dependency  solver  to  use  (default:  modular).
1097                     Choices: modular.
1098
1099              --max-backjumps NUM
1100                     Maximum   number   of  backjumps  allowed  while  solving
1101                     (default: 2000). Use a negative number to  enable  unlim‐
1102                     ited  backtracking.  Use  0  to disable backtracking com‐
1103                     pletely.
1104
1105              --reorder-goals
1106              --no-reorder-goals
1107                     Try to reorder goals  according  to  certain  heuristics.
1108                     Slows  things  down on average, but may make backtracking
1109                     faster for some packages.
1110
1111              --count-conflicts
1112              --no-count-conflicts
1113                     Try to speed up solving  by  preferring  goals  that  are
1114                     involved in a lot of conflicts (default).
1115
1116              --independent-goals
1117              --no-independent-goals
1118                     Treat  several  goals on the command line as independent.
1119                     If several goals depend on the  same  package,  different
1120                     versions can be chosen.
1121
1122              --shadow-installed-packages
1123              --no-shadow-installed-packages
1124                     If  multiple  package  instances  of the same version are
1125                     installed, treat all but one as shadowed.
1126
1127              --strong-flags
1128              --no-strong-flags
1129                     Do not defer flag choices (this used to be the default in
1130                     cabal-install <= 1.20).
1131
1132              --allow-boot-library-installs
1133              --no-allow-boot-library-installs
1134                     Allow  cabal  to  install base, ghc-prim, integer-simple,
1135                     integer-gmp, and template-haskell.
1136
1137
1138       cabal get
1139
1140       Usage: cabal get [PACKAGES]
1141
1142
1143       Creates a local copy of a package's source code. By default it gets the
1144       source  tarball  and unpacks it in a local subdirectory. Alternatively,
1145       with -s it will get the code from the source  repository  specified  by
1146       the package.
1147
1148
1149       Examples:
1150         cabal get hlint
1151           Download the latest stable version of hlint;
1152         cabal get lens --source-repository=head
1153           Download the source repository (i.e. git clone from github).
1154
1155
1156       Flags:
1157              -v, --verbose [n]
1158                     Control  verbosity (n is 0--3, default verbosity level is
1159                     1)
1160
1161              -d, --destdir PATH
1162                     Where to place the package source, defaults to  the  cur‐
1163                     rent directory.
1164
1165              -s, --source-repository [[head|this|...]]
1166                     Copy the package's source repository (ie git clone, darcs
1167                     get, etc as appropriate).
1168
1169              --index-state STATE
1170                     Use source package index state as it existed at a  previ‐
1171                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
1172                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
1173                     'HEAD'  (default:  'HEAD'). This determines which package
1174                     versions are available as well as .cabal file revision is
1175                     selected (unless --pristine is used).
1176
1177              --pristine
1178                     Unpack  the original pristine tarball, rather than updat‐
1179                     ing the .cabal file with the  latest  revision  from  the
1180                     package archive.
1181
1182
1183       cabal check
1184
1185       Usage: cabal check
1186
1187
1188       Expects a .cabal package file in the current directory.
1189
1190       The checks correspond to the requirements to packages on Hackage. If no
1191       errors and warnings are reported, Hackage will accept this package.
1192
1193
1194       Flags:
1195
1196       cabal sdist
1197
1198       Usage: cabal sdist [FLAGS]
1199
1200
1201       Flags:
1202              -v, --verbose [n]
1203                     Control verbosity (n is 0--3, default verbosity level  is
1204                     1)
1205
1206              --builddir, --distdir, --distpref DIR
1207                     The  directory  where  Cabal  puts  generated build files
1208                     (default dist)
1209
1210              --list-sources FILE
1211                     Just write a list of the package's sources to a file
1212
1213              --snapshot
1214                     Produce a snapshot source distribution
1215
1216              --output-directory DIR
1217                     Generate a source distribution in  the  given  directory,
1218                     without creating a tarball
1219
1220              --targz
1221                     Produce  a '.tar.gz' format archive (default and required
1222                     for uploading to hackage)
1223
1224              --zip
1225                     Produce a '.zip' format archive
1226
1227
1228       cabal upload
1229
1230       Usage: cabal upload [FLAGS] TARFILES
1231
1232
1233       You can store your Hackage login in the ~/.cabal/config  file  Relevant
1234       global configuration keys:
1235         username
1236         password
1237
1238
1239       Flags:
1240              -v, --verbose [n]
1241                     Control  verbosity (n is 0--3, default verbosity level is
1242                     1)
1243
1244              --publish
1245                     Publish the package instead of uploading it as  a  candi‐
1246                     date.
1247
1248              -d, --documentation
1249                     Upload  documentation  instead  of  a  source package. By
1250                     default, this uploads documentation for a package  candi‐
1251                     date.  To  upload  documentation for a published package,
1252                     combine with --publish.
1253
1254              -u, --username USERNAME
1255                     Hackage username.
1256
1257              -p, --password PASSWORD
1258                     Hackage password.
1259
1260              -P, --password-command PASSWORD
1261                     Command to get Hackage password.
1262
1263
1264       cabal report
1265
1266       Usage: cabal report [FLAGS]
1267
1268
1269       You can store your Hackage login in the ~/.cabal/config file
1270
1271
1272       Flags:
1273              -v, --verbose [n]
1274                     Control verbosity (n is 0--3, default verbosity level  is
1275                     1)
1276
1277              -u, --username USERNAME
1278                     Hackage username.
1279
1280              -p, --password PASSWORD
1281                     Hackage password.
1282
1283
1284       cabal run
1285
1286       Usage: cabal run [FLAGS] [EXECUTABLE] [-- EXECUTABLE_FLAGS]
1287
1288
1289       Builds  and  then  runs  the  specified executable. If no executable is
1290       specified, but the package contains just one executable,  that  one  is
1291       built and executed.
1292
1293       Use  `cabal  test --show-details=streaming` to run a test-suite and get
1294       its full output.
1295
1296
1297       Examples:
1298         cabal run
1299           Run the only executable in the current package;
1300         cabal run foo -- --fooflag
1301           Works similar to `./foo --fooflag`.
1302
1303
1304       Flags:
1305              -v, --verbose [n]
1306                     Control verbosity (n is 0--3, default verbosity level  is
1307                     1)
1308
1309              --builddir, --distdir, --distpref DIR
1310                     The  directory  where  Cabal  puts  generated build files
1311                     (default dist)
1312
1313              -j, --jobs [NUM]
1314                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
1315                     given).
1316
1317              --with-alex PATH
1318                     give the path to alex
1319
1320              --with-ar PATH
1321                     give the path to ar
1322
1323              --with-c2hs PATH
1324                     give the path to c2hs
1325
1326              --with-cpphs PATH
1327                     give the path to cpphs
1328
1329              --with-doctest PATH
1330                     give the path to doctest
1331
1332              --with-gcc PATH
1333                     give the path to gcc
1334
1335              --with-ghc PATH
1336                     give the path to ghc
1337
1338              --with-ghc-pkg PATH
1339                     give the path to ghc-pkg
1340
1341              --with-ghcjs PATH
1342                     give the path to ghcjs
1343
1344              --with-ghcjs-pkg PATH
1345                     give the path to ghcjs-pkg
1346
1347              --with-greencard PATH
1348                     give the path to greencard
1349
1350              --with-haddock PATH
1351                     give the path to haddock
1352
1353              --with-happy PATH
1354                     give the path to happy
1355
1356              --with-haskell-suite PATH
1357                     give the path to haskell-suite
1358
1359              --with-haskell-suite-pkg PATH
1360                     give the path to haskell-suite-pkg
1361
1362              --with-hmake PATH
1363                     give the path to hmake
1364
1365              --with-hpc PATH
1366                     give the path to hpc
1367
1368              --with-hsc2hs PATH
1369                     give the path to hsc2hs
1370
1371              --with-hscolour PATH
1372                     give the path to hscolour
1373
1374              --with-jhc PATH
1375                     give the path to jhc
1376
1377              --with-ld PATH
1378                     give the path to ld
1379
1380              --with-lhc PATH
1381                     give the path to lhc
1382
1383              --with-lhc-pkg PATH
1384                     give the path to lhc-pkg
1385
1386              --with-pkg-config PATH
1387                     give the path to pkg-config
1388
1389              --with-runghc PATH
1390                     give the path to runghc
1391
1392              --with-strip PATH
1393                     give the path to strip
1394
1395              --with-tar PATH
1396                     give the path to tar
1397
1398              --with-uhc PATH
1399                     give the path to uhc
1400
1401              --alex-option OPT
1402                     give  an  extra  option to alex (no need to quote options
1403                     containing spaces)
1404
1405              --ar-option OPT
1406                     give an extra option to ar (no need to quote options con‐
1407                     taining spaces)
1408
1409              --c2hs-option OPT
1410                     give  an  extra  option to c2hs (no need to quote options
1411                     containing spaces)
1412
1413              --cpphs-option OPT
1414                     give an extra option to cpphs (no need to  quote  options
1415                     containing spaces)
1416
1417              --doctest-option OPT
1418                     give an extra option to doctest (no need to quote options
1419                     containing spaces)
1420
1421              --gcc-option OPT
1422                     give an extra option to gcc (no  need  to  quote  options
1423                     containing spaces)
1424
1425              --ghc-option OPT
1426                     give  an  extra  option  to ghc (no need to quote options
1427                     containing spaces)
1428
1429              --ghc-pkg-option OPT
1430                     give an extra option to ghc-pkg (no need to quote options
1431                     containing spaces)
1432
1433              --ghcjs-option OPT
1434                     give  an  extra option to ghcjs (no need to quote options
1435                     containing spaces)
1436
1437              --ghcjs-pkg-option OPT
1438                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
1439                     options containing spaces)
1440
1441              --greencard-option OPT
1442                     give  an  extra  option  to  greencard  (no need to quote
1443                     options containing spaces)
1444
1445              --haddock-option OPT
1446                     give an extra option to haddock (no need to quote options
1447                     containing spaces)
1448
1449              --happy-option OPT
1450                     give  an  extra option to happy (no need to quote options
1451                     containing spaces)
1452
1453              --haskell-suite-option OPT
1454                     give an extra option to haskell-suite (no need  to  quote
1455                     options containing spaces)
1456
1457              --haskell-suite-pkg-option OPT
1458                     give  an  extra  option  to haskell-suite-pkg (no need to
1459                     quote options containing spaces)
1460
1461              --hmake-option OPT
1462                     give an extra option to hmake (no need to  quote  options
1463                     containing spaces)
1464
1465              --hpc-option OPT
1466                     give  an  extra  option  to hpc (no need to quote options
1467                     containing spaces)
1468
1469              --hsc2hs-option OPT
1470                     give an extra option to hsc2hs (no need to quote  options
1471                     containing spaces)
1472
1473              --hscolour-option OPT
1474                     give  an  extra  option  to  hscolour  (no  need to quote
1475                     options containing spaces)
1476
1477              --jhc-option OPT
1478                     give an extra option to jhc (no  need  to  quote  options
1479                     containing spaces)
1480
1481              --ld-option OPT
1482                     give an extra option to ld (no need to quote options con‐
1483                     taining spaces)
1484
1485              --lhc-option OPT
1486                     give an extra option to lhc (no  need  to  quote  options
1487                     containing spaces)
1488
1489              --lhc-pkg-option OPT
1490                     give an extra option to lhc-pkg (no need to quote options
1491                     containing spaces)
1492
1493              --pkg-config-option OPT
1494                     give an extra option to  pkg-config  (no  need  to  quote
1495                     options containing spaces)
1496
1497              --runghc-option OPT
1498                     give  an extra option to runghc (no need to quote options
1499                     containing spaces)
1500
1501              --strip-option OPT
1502                     give an extra option to strip (no need to  quote  options
1503                     containing spaces)
1504
1505              --tar-option OPT
1506                     give  an  extra  option  to tar (no need to quote options
1507                     containing spaces)
1508
1509              --uhc-option OPT
1510                     give an extra option to uhc (no  need  to  quote  options
1511                     containing spaces)
1512
1513              --alex-options OPTS
1514                     give extra options to alex
1515
1516              --ar-options OPTS
1517                     give extra options to ar
1518
1519              --c2hs-options OPTS
1520                     give extra options to c2hs
1521
1522              --cpphs-options OPTS
1523                     give extra options to cpphs
1524
1525              --doctest-options OPTS
1526                     give extra options to doctest
1527
1528              --gcc-options OPTS
1529                     give extra options to gcc
1530
1531              --ghc-options OPTS
1532                     give extra options to ghc
1533
1534              --ghc-pkg-options OPTS
1535                     give extra options to ghc-pkg
1536
1537              --ghcjs-options OPTS
1538                     give extra options to ghcjs
1539
1540              --ghcjs-pkg-options OPTS
1541                     give extra options to ghcjs-pkg
1542
1543              --greencard-options OPTS
1544                     give extra options to greencard
1545
1546              --haddock-options OPTS
1547                     give extra options to haddock
1548
1549              --happy-options OPTS
1550                     give extra options to happy
1551
1552              --haskell-suite-options OPTS
1553                     give extra options to haskell-suite
1554
1555              --haskell-suite-pkg-options OPTS
1556                     give extra options to haskell-suite-pkg
1557
1558              --hmake-options OPTS
1559                     give extra options to hmake
1560
1561              --hpc-options OPTS
1562                     give extra options to hpc
1563
1564              --hsc2hs-options OPTS
1565                     give extra options to hsc2hs
1566
1567              --hscolour-options OPTS
1568                     give extra options to hscolour
1569
1570              --jhc-options OPTS
1571                     give extra options to jhc
1572
1573              --ld-options OPTS
1574                     give extra options to ld
1575
1576              --lhc-options OPTS
1577                     give extra options to lhc
1578
1579              --lhc-pkg-options OPTS
1580                     give extra options to lhc-pkg
1581
1582              --pkg-config-options OPTS
1583                     give extra options to pkg-config
1584
1585              --runghc-options OPTS
1586                     give extra options to runghc
1587
1588              --strip-options OPTS
1589                     give extra options to strip
1590
1591              --tar-options OPTS
1592                     give extra options to tar
1593
1594              --uhc-options OPTS
1595                     give extra options to uhc
1596
1597              --only
1598                     Don't reinstall add-source dependencies (sandbox-only)
1599
1600
1601       cabal init
1602
1603       Usage: cabal init [FLAGS]
1604
1605
1606       Cabalise  a  project  by  creating a .cabal, Setup.hs, and optionally a
1607       LICENSE file.
1608
1609       Calling init with no arguments (recommended) uses an interactive  mode,
1610       which  will  try  to  guess  as much as possible and prompt you for the
1611       rest.  Command-line arguments are provided for scripting  purposes.  If
1612       you don't want interactive mode, be sure to pass the -n flag.
1613
1614
1615       Flags:
1616              -n, --non-interactive
1617                     Non-interactive mode.
1618
1619              -q, --quiet
1620                     Do not generate log messages to stdout.
1621
1622              --no-comments
1623                     Do not generate explanatory comments in the .cabal file.
1624
1625              -m, --minimal
1626                     Generate  a  minimal .cabal file, that is, do not include
1627                     extra empty fields.  Also implies --no-comments.
1628
1629              --overwrite
1630                     Overwrite any existing .cabal, LICENSE, or Setup.hs files
1631                     without warning.
1632
1633              --package-dir DIRECTORY
1634                     Root  directory  of the package (default = current direc‐
1635                     tory).
1636
1637              -p, --package-name PACKAGE
1638                     Name of the Cabal package to create.
1639
1640              --version VERSION
1641                     Initial version of the package.
1642
1643              --cabal-version VERSION_RANGE
1644                     Required version of the Cabal library.
1645
1646              -l, --license LICENSE
1647                     Project license.
1648
1649              -a, --author NAME
1650                     Name of the project's author.
1651
1652              -e, --email EMAIL
1653                     Email address of the maintainer.
1654
1655              -u, --homepage URL
1656                     Project homepage and/or repository.
1657
1658              -s, --synopsis TEXT
1659                     Short project synopsis.
1660
1661              -c, --category CATEGORY
1662                     Project category.
1663
1664              -x, --extra-source-file FILE
1665                     Extra source file to be distributed with tarball.
1666
1667              --is-library
1668                     Build a library.
1669
1670              --is-executable
1671                     Build an executable.
1672
1673              --is-libandexe
1674                     Build a library and an executable.
1675
1676              --main-is FILE
1677                     Specify the main module.
1678
1679              --language LANGUAGE
1680                     Specify the default language.
1681
1682              -o, --expose-module MODULE
1683                     Export a module from the package.
1684
1685              --extension EXTENSION
1686                     Use a LANGUAGE extension (in the other-extensions field).
1687
1688              -d, --dependency PACKAGE
1689                     Package dependency.
1690
1691              --source-dir DIR
1692                     Directory containing package source.
1693
1694              --build-tool TOOL
1695                     Required external build tool.
1696
1697              -v, --verbose [n]
1698                     Control verbosity (n is 0--3, default verbosity level  is
1699                     1)
1700
1701
1702       cabal configure
1703
1704       Usage: cabal configure [FLAGS]
1705
1706
1707       Configure  how  the  package  is  built  by setting package (and other)
1708       flags.
1709
1710       The configuration affects  several  other  commands,  including  build,
1711       test, bench, run, repl.
1712
1713
1714       The flags --with-PROG and --PROG-option(s) can be used with the follow‐
1715       ing programs:
1716         alex ar c2hs cpphs doctest gcc ghc ghc-pkg ghcjs ghcjs-pkg  greencard
1717       haddock
1718         happy  haskell-suite  haskell-suite-pkg hmake hpc hsc2hs hscolour jhc
1719       ld lhc
1720         lhc-pkg pkg-config runghc strip tar uhc
1721
1722       Examples:
1723         cabal configure
1724           Configure with defaults;
1725         cabal configure --enable-tests -fcustomflag
1726           Configure building package including tests,
1727           with some package-specific flag.
1728
1729
1730       Flags:
1731              -v, --verbose [n]
1732                     Control verbosity (n is 0--3, default verbosity level  is
1733                     1)
1734
1735              --builddir, --distdir, --distpref DIR
1736                     The  directory  where  Cabal  puts  generated build files
1737                     (default dist)
1738
1739              -g, --ghc
1740                     compile with GHC
1741
1742              --ghcjs
1743                     compile with GHCJS
1744
1745              --jhc
1746                     compile with JHC
1747
1748              --lhc
1749                     compile with LHC
1750
1751              --uhc
1752                     compile with UHC
1753
1754              --haskell-suite
1755                     compile with a haskell-suite compiler
1756
1757              --cabal-file PATH
1758                     use this Cabal file
1759
1760              -w, --with-compiler PATH
1761                     give the path to a particular compiler
1762
1763              --with-hc-pkg PATH
1764                     give the path to the package tool
1765
1766              --prefix DIR
1767                     bake this prefix in preparation of installation
1768
1769              --bindir DIR
1770                     installation directory for executables
1771
1772              --libdir DIR
1773                     installation directory for libraries
1774
1775              --libsubdir DIR
1776                     subdirectory of libdir in which libs are installed
1777
1778              --dynlibdir DIR
1779                     installation directory for dynamic libraries
1780
1781              --libexecdir DIR
1782                     installation directory for program executables
1783
1784              --libexecsubdir DIR
1785                     subdirectory of libexecdir in which  private  executables
1786                     are installed
1787
1788              --datadir DIR
1789                     installation directory for read-only data
1790
1791              --datasubdir DIR
1792                     subdirectory of datadir in which data files are installed
1793
1794              --docdir DIR
1795                     installation directory for documentation
1796
1797              --htmldir DIR
1798                     installation directory for HTML documentation
1799
1800              --haddockdir DIR
1801                     installation directory for haddock interfaces
1802
1803              --sysconfdir DIR
1804                     installation directory for configuration files
1805
1806              --program-prefix PREFIX
1807                     prefix to be applied to installed executables
1808
1809              --program-suffix SUFFIX
1810                     suffix to be applied to installed executables
1811
1812              --enable-library-vanilla
1813              --disable-library-vanilla
1814                     Vanilla libraries
1815
1816              -p, --enable-library-profiling
1817              --disable-library-profiling
1818                     Library profiling
1819
1820              --enable-shared
1821              --disable-shared
1822                     Shared library
1823
1824              --enable-static
1825              --disable-static
1826                     Static library
1827
1828              --enable-executable-dynamic
1829              --disable-executable-dynamic
1830                     Executable dynamic linking
1831
1832              --enable-profiling
1833              --disable-profiling
1834                     Executable and library profiling
1835
1836              --enable-executable-profiling
1837              --disable-executable-profiling
1838                     Executable profiling (DEPRECATED)
1839
1840              --profiling-detail level
1841                     Profiling   detail   level  for  executable  and  library
1842                     (default, none,  exported-functions,  toplevel-functions,
1843                     all-functions).
1844
1845              --library-profiling-detail level
1846                     Profiling detail level for libraries only.
1847
1848              -O, --enable-optimization, --enable-optimisation [n]
1849                     Build with optimization (n is 0--2, default is 1)
1850
1851              --disable-optimization, --disable-optimisation
1852                     Build without optimization
1853
1854              --enable-debug-info [n]
1855                     Emit debug info (n is 0--3, default is 0)
1856
1857              --disable-debug-info
1858                     Don't emit debug info
1859
1860              --enable-library-for-ghci
1861              --disable-library-for-ghci
1862                     compile library for use with GHCi
1863
1864              --enable-split-sections
1865              --disable-split-sections
1866                     compile  library  code such that unneeded definitions can
1867                     be dropped from the final executable (GHC 7.8+)
1868
1869              --enable-split-objs
1870              --disable-split-objs
1871                     split library into smaller objects to reduce binary sizes
1872                     (GHC 6.6+)
1873
1874              --enable-executable-stripping
1875              --disable-executable-stripping
1876                     strip  executables  upon  installation  to  reduce binary
1877                     sizes
1878
1879              --enable-library-stripping
1880              --disable-library-stripping
1881                     strip libraries upon installation to reduce binary sizes
1882
1883              --configure-option OPT
1884                     Extra option for configure
1885
1886              --user
1887              --global
1888                     doing a per-user installation
1889
1890              --package-db DB
1891                     Append the given package database to the list of  package
1892                     databases  used  (to  satisfy  dependencies  and register
1893                     into). May be a specific file, 'global'  or  'user'.  The
1894                     initial   list  is  ['global'],  ['global',  'user'],  or
1895                     ['global', $sandbox], depending on context.  Use  'clear'
1896                     to  reset  the  list  to  empty.  See  the user guide for
1897                     details.
1898
1899              -f, --flags FLAGS
1900                     Force values for the given flags in Cabal conditionals in
1901                     the  .cabal  file.  E.g., --flags="debug -usebytestrings"
1902                     forces the flag "debug" to true and  "usebytestrings"  to
1903                     false.
1904
1905              --extra-include-dirs PATH
1906                     A list of directories to search for header files
1907
1908              --enable-deterministic
1909              --disable-deterministic
1910                     Try  to be as deterministic as possible (used by the test
1911                     suite)
1912
1913              --ipid IPID
1914                     Installed package ID to compile this package as
1915
1916              --cid CID
1917                     Installed component ID to compile this component as
1918
1919              --extra-lib-dirs PATH
1920                     A list of directories to search for external libraries
1921
1922              --extra-framework-dirs PATH
1923                     A list of directories to search for  external  frameworks
1924                     (OS X only)
1925
1926              --extra-prog-path PATH
1927                     A list of directories to search for required programs (in
1928                     addition to the normal search locations)
1929
1930              --instantiate-with NAME=MOD
1931                     A mapping of signature names to concrete module instanti‐
1932                     ations.
1933
1934              --enable-tests
1935              --disable-tests
1936                     dependency  checking  and  compilation  for  test  suites
1937                     listed in the package description file.
1938
1939              --enable-coverage
1940              --disable-coverage
1941                     build package with Haskell Program Coverage. (GHC only)
1942
1943              --enable-library-coverage
1944              --disable-library-coverage
1945                     build package with Haskell Program Coverage.  (GHC  only)
1946                     (DEPRECATED)
1947
1948              --enable-benchmarks
1949              --disable-benchmarks
1950                     dependency checking and compilation for benchmarks listed
1951                     in the package description file.
1952
1953              --enable-relocatable
1954              --disable-relocatable
1955                     building a package that is relocatable. (GHC only)
1956
1957              --disable-response-files
1958                     enable workaround for old versions of programs like  "ar"
1959                     that do not support @file arguments
1960
1961              --with-alex PATH
1962                     give the path to alex
1963
1964              --with-ar PATH
1965                     give the path to ar
1966
1967              --with-c2hs PATH
1968                     give the path to c2hs
1969
1970              --with-cpphs PATH
1971                     give the path to cpphs
1972
1973              --with-doctest PATH
1974                     give the path to doctest
1975
1976              --with-gcc PATH
1977                     give the path to gcc
1978
1979              --with-ghc PATH
1980                     give the path to ghc
1981
1982              --with-ghc-pkg PATH
1983                     give the path to ghc-pkg
1984
1985              --with-ghcjs PATH
1986                     give the path to ghcjs
1987
1988              --with-ghcjs-pkg PATH
1989                     give the path to ghcjs-pkg
1990
1991              --with-greencard PATH
1992                     give the path to greencard
1993
1994              --with-haddock PATH
1995                     give the path to haddock
1996
1997              --with-happy PATH
1998                     give the path to happy
1999
2000              --with-haskell-suite PATH
2001                     give the path to haskell-suite
2002
2003              --with-haskell-suite-pkg PATH
2004                     give the path to haskell-suite-pkg
2005
2006              --with-hmake PATH
2007                     give the path to hmake
2008
2009              --with-hpc PATH
2010                     give the path to hpc
2011
2012              --with-hsc2hs PATH
2013                     give the path to hsc2hs
2014
2015              --with-hscolour PATH
2016                     give the path to hscolour
2017
2018              --with-jhc PATH
2019                     give the path to jhc
2020
2021              --with-ld PATH
2022                     give the path to ld
2023
2024              --with-lhc PATH
2025                     give the path to lhc
2026
2027              --with-lhc-pkg PATH
2028                     give the path to lhc-pkg
2029
2030              --with-pkg-config PATH
2031                     give the path to pkg-config
2032
2033              --with-runghc PATH
2034                     give the path to runghc
2035
2036              --with-strip PATH
2037                     give the path to strip
2038
2039              --with-tar PATH
2040                     give the path to tar
2041
2042              --with-uhc PATH
2043                     give the path to uhc
2044
2045              --alex-option OPT
2046                     give  an  extra  option to alex (no need to quote options
2047                     containing spaces)
2048
2049              --ar-option OPT
2050                     give an extra option to ar (no need to quote options con‐
2051                     taining spaces)
2052
2053              --c2hs-option OPT
2054                     give  an  extra  option to c2hs (no need to quote options
2055                     containing spaces)
2056
2057              --cpphs-option OPT
2058                     give an extra option to cpphs (no need to  quote  options
2059                     containing spaces)
2060
2061              --doctest-option OPT
2062                     give an extra option to doctest (no need to quote options
2063                     containing spaces)
2064
2065              --gcc-option OPT
2066                     give an extra option to gcc (no  need  to  quote  options
2067                     containing spaces)
2068
2069              --ghc-option OPT
2070                     give  an  extra  option  to ghc (no need to quote options
2071                     containing spaces)
2072
2073              --ghc-pkg-option OPT
2074                     give an extra option to ghc-pkg (no need to quote options
2075                     containing spaces)
2076
2077              --ghcjs-option OPT
2078                     give  an  extra option to ghcjs (no need to quote options
2079                     containing spaces)
2080
2081              --ghcjs-pkg-option OPT
2082                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
2083                     options containing spaces)
2084
2085              --greencard-option OPT
2086                     give  an  extra  option  to  greencard  (no need to quote
2087                     options containing spaces)
2088
2089              --haddock-option OPT
2090                     give an extra option to haddock (no need to quote options
2091                     containing spaces)
2092
2093              --happy-option OPT
2094                     give  an  extra option to happy (no need to quote options
2095                     containing spaces)
2096
2097              --haskell-suite-option OPT
2098                     give an extra option to haskell-suite (no need  to  quote
2099                     options containing spaces)
2100
2101              --haskell-suite-pkg-option OPT
2102                     give  an  extra  option  to haskell-suite-pkg (no need to
2103                     quote options containing spaces)
2104
2105              --hmake-option OPT
2106                     give an extra option to hmake (no need to  quote  options
2107                     containing spaces)
2108
2109              --hpc-option OPT
2110                     give  an  extra  option  to hpc (no need to quote options
2111                     containing spaces)
2112
2113              --hsc2hs-option OPT
2114                     give an extra option to hsc2hs (no need to quote  options
2115                     containing spaces)
2116
2117              --hscolour-option OPT
2118                     give  an  extra  option  to  hscolour  (no  need to quote
2119                     options containing spaces)
2120
2121              --jhc-option OPT
2122                     give an extra option to jhc (no  need  to  quote  options
2123                     containing spaces)
2124
2125              --ld-option OPT
2126                     give an extra option to ld (no need to quote options con‐
2127                     taining spaces)
2128
2129              --lhc-option OPT
2130                     give an extra option to lhc (no  need  to  quote  options
2131                     containing spaces)
2132
2133              --lhc-pkg-option OPT
2134                     give an extra option to lhc-pkg (no need to quote options
2135                     containing spaces)
2136
2137              --pkg-config-option OPT
2138                     give an extra option to  pkg-config  (no  need  to  quote
2139                     options containing spaces)
2140
2141              --runghc-option OPT
2142                     give  an extra option to runghc (no need to quote options
2143                     containing spaces)
2144
2145              --strip-option OPT
2146                     give an extra option to strip (no need to  quote  options
2147                     containing spaces)
2148
2149              --tar-option OPT
2150                     give  an  extra  option  to tar (no need to quote options
2151                     containing spaces)
2152
2153              --uhc-option OPT
2154                     give an extra option to uhc (no  need  to  quote  options
2155                     containing spaces)
2156
2157              --alex-options OPTS
2158                     give extra options to alex
2159
2160              --ar-options OPTS
2161                     give extra options to ar
2162
2163              --c2hs-options OPTS
2164                     give extra options to c2hs
2165
2166              --cpphs-options OPTS
2167                     give extra options to cpphs
2168
2169              --doctest-options OPTS
2170                     give extra options to doctest
2171
2172              --gcc-options OPTS
2173                     give extra options to gcc
2174
2175              --ghc-options OPTS
2176                     give extra options to ghc
2177
2178              --ghc-pkg-options OPTS
2179                     give extra options to ghc-pkg
2180
2181              --ghcjs-options OPTS
2182                     give extra options to ghcjs
2183
2184              --ghcjs-pkg-options OPTS
2185                     give extra options to ghcjs-pkg
2186
2187              --greencard-options OPTS
2188                     give extra options to greencard
2189
2190              --haddock-options OPTS
2191                     give extra options to haddock
2192
2193              --happy-options OPTS
2194                     give extra options to happy
2195
2196              --haskell-suite-options OPTS
2197                     give extra options to haskell-suite
2198
2199              --haskell-suite-pkg-options OPTS
2200                     give extra options to haskell-suite-pkg
2201
2202              --hmake-options OPTS
2203                     give extra options to hmake
2204
2205              --hpc-options OPTS
2206                     give extra options to hpc
2207
2208              --hsc2hs-options OPTS
2209                     give extra options to hsc2hs
2210
2211              --hscolour-options OPTS
2212                     give extra options to hscolour
2213
2214              --jhc-options OPTS
2215                     give extra options to jhc
2216
2217              --ld-options OPTS
2218                     give extra options to ld
2219
2220              --lhc-options OPTS
2221                     give extra options to lhc
2222
2223              --lhc-pkg-options OPTS
2224                     give extra options to lhc-pkg
2225
2226              --pkg-config-options OPTS
2227                     give extra options to pkg-config
2228
2229              --runghc-options OPTS
2230                     give extra options to runghc
2231
2232              --strip-options OPTS
2233                     give extra options to strip
2234
2235              --tar-options OPTS
2236                     give extra options to tar
2237
2238              --uhc-options OPTS
2239                     give extra options to uhc
2240
2241              --cabal-lib-version VERSION
2242                     Select  which  version  of  the Cabal lib to use to build
2243                     packages (useful for testing).
2244
2245              --constraint CONSTRAINT
2246                     Specify    constraints    on    a    package    (version,
2247                     installed/source, flags)
2248
2249              --preference CONSTRAINT
2250                     Specify  preferences (soft constraints) on the version of
2251                     a package
2252
2253              --solver SOLVER
2254                     Select  dependency  solver  to  use  (default:  modular).
2255                     Choices: modular.
2256
2257              --allow-older [DEPS]
2258                     Ignore lower bounds in all dependencies or DEPS
2259
2260              --allow-newer [DEPS]
2261                     Ignore upper bounds in all dependencies or DEPS
2262
2263
2264       cabal reconfigure
2265
2266       Usage: cabal reconfigure [FLAGS]
2267
2268
2269       Run  `configure`  with the most recently used flags, or append FLAGS to
2270       the most recently used configuration. Accepts the same flags as  `cabal
2271       configure'. If the package has never been configured, the default flags
2272       are used.
2273
2274
2275       Examples:
2276         cabal reconfigure
2277           Configure with the most recently used flags.
2278         cabal reconfigure -w PATH
2279           Reconfigure with the most recently used flags,
2280           but use the compiler at PATH.
2281
2282
2283
2284       Flags:
2285              -v, --verbose [n]
2286                     Control verbosity (n is 0--3, default verbosity level  is
2287                     1)
2288
2289              --builddir, --distdir, --distpref DIR
2290                     The  directory  where  Cabal  puts  generated build files
2291                     (default dist)
2292
2293              -g, --ghc
2294                     compile with GHC
2295
2296              --ghcjs
2297                     compile with GHCJS
2298
2299              --jhc
2300                     compile with JHC
2301
2302              --lhc
2303                     compile with LHC
2304
2305              --uhc
2306                     compile with UHC
2307
2308              --haskell-suite
2309                     compile with a haskell-suite compiler
2310
2311              --cabal-file PATH
2312                     use this Cabal file
2313
2314              -w, --with-compiler PATH
2315                     give the path to a particular compiler
2316
2317              --with-hc-pkg PATH
2318                     give the path to the package tool
2319
2320              --prefix DIR
2321                     bake this prefix in preparation of installation
2322
2323              --bindir DIR
2324                     installation directory for executables
2325
2326              --libdir DIR
2327                     installation directory for libraries
2328
2329              --libsubdir DIR
2330                     subdirectory of libdir in which libs are installed
2331
2332              --dynlibdir DIR
2333                     installation directory for dynamic libraries
2334
2335              --libexecdir DIR
2336                     installation directory for program executables
2337
2338              --libexecsubdir DIR
2339                     subdirectory of libexecdir in which  private  executables
2340                     are installed
2341
2342              --datadir DIR
2343                     installation directory for read-only data
2344
2345              --datasubdir DIR
2346                     subdirectory of datadir in which data files are installed
2347
2348              --docdir DIR
2349                     installation directory for documentation
2350
2351              --htmldir DIR
2352                     installation directory for HTML documentation
2353
2354              --haddockdir DIR
2355                     installation directory for haddock interfaces
2356
2357              --sysconfdir DIR
2358                     installation directory for configuration files
2359
2360              --program-prefix PREFIX
2361                     prefix to be applied to installed executables
2362
2363              --program-suffix SUFFIX
2364                     suffix to be applied to installed executables
2365
2366              --enable-library-vanilla
2367              --disable-library-vanilla
2368                     Vanilla libraries
2369
2370              -p, --enable-library-profiling
2371              --disable-library-profiling
2372                     Library profiling
2373
2374              --enable-shared
2375              --disable-shared
2376                     Shared library
2377
2378              --enable-static
2379              --disable-static
2380                     Static library
2381
2382              --enable-executable-dynamic
2383              --disable-executable-dynamic
2384                     Executable dynamic linking
2385
2386              --enable-profiling
2387              --disable-profiling
2388                     Executable and library profiling
2389
2390              --enable-executable-profiling
2391              --disable-executable-profiling
2392                     Executable profiling (DEPRECATED)
2393
2394              --profiling-detail level
2395                     Profiling   detail   level  for  executable  and  library
2396                     (default, none,  exported-functions,  toplevel-functions,
2397                     all-functions).
2398
2399              --library-profiling-detail level
2400                     Profiling detail level for libraries only.
2401
2402              -O, --enable-optimization, --enable-optimisation [n]
2403                     Build with optimization (n is 0--2, default is 1)
2404
2405              --disable-optimization, --disable-optimisation
2406                     Build without optimization
2407
2408              --enable-debug-info [n]
2409                     Emit debug info (n is 0--3, default is 0)
2410
2411              --disable-debug-info
2412                     Don't emit debug info
2413
2414              --enable-library-for-ghci
2415              --disable-library-for-ghci
2416                     compile library for use with GHCi
2417
2418              --enable-split-sections
2419              --disable-split-sections
2420                     compile  library  code such that unneeded definitions can
2421                     be dropped from the final executable (GHC 7.8+)
2422
2423              --enable-split-objs
2424              --disable-split-objs
2425                     split library into smaller objects to reduce binary sizes
2426                     (GHC 6.6+)
2427
2428              --enable-executable-stripping
2429              --disable-executable-stripping
2430                     strip  executables  upon  installation  to  reduce binary
2431                     sizes
2432
2433              --enable-library-stripping
2434              --disable-library-stripping
2435                     strip libraries upon installation to reduce binary sizes
2436
2437              --configure-option OPT
2438                     Extra option for configure
2439
2440              --user
2441              --global
2442                     doing a per-user installation
2443
2444              --package-db DB
2445                     Append the given package database to the list of  package
2446                     databases  used  (to  satisfy  dependencies  and register
2447                     into). May be a specific file, 'global'  or  'user'.  The
2448                     initial   list  is  ['global'],  ['global',  'user'],  or
2449                     ['global', $sandbox], depending on context.  Use  'clear'
2450                     to  reset  the  list  to  empty.  See  the user guide for
2451                     details.
2452
2453              -f, --flags FLAGS
2454                     Force values for the given flags in Cabal conditionals in
2455                     the  .cabal  file.  E.g., --flags="debug -usebytestrings"
2456                     forces the flag "debug" to true and  "usebytestrings"  to
2457                     false.
2458
2459              --extra-include-dirs PATH
2460                     A list of directories to search for header files
2461
2462              --enable-deterministic
2463              --disable-deterministic
2464                     Try  to be as deterministic as possible (used by the test
2465                     suite)
2466
2467              --ipid IPID
2468                     Installed package ID to compile this package as
2469
2470              --cid CID
2471                     Installed component ID to compile this component as
2472
2473              --extra-lib-dirs PATH
2474                     A list of directories to search for external libraries
2475
2476              --extra-framework-dirs PATH
2477                     A list of directories to search for  external  frameworks
2478                     (OS X only)
2479
2480              --extra-prog-path PATH
2481                     A list of directories to search for required programs (in
2482                     addition to the normal search locations)
2483
2484              --instantiate-with NAME=MOD
2485                     A mapping of signature names to concrete module instanti‐
2486                     ations.
2487
2488              --enable-tests
2489              --disable-tests
2490                     dependency  checking  and  compilation  for  test  suites
2491                     listed in the package description file.
2492
2493              --enable-coverage
2494              --disable-coverage
2495                     build package with Haskell Program Coverage. (GHC only)
2496
2497              --enable-library-coverage
2498              --disable-library-coverage
2499                     build package with Haskell Program Coverage.  (GHC  only)
2500                     (DEPRECATED)
2501
2502              --enable-benchmarks
2503              --disable-benchmarks
2504                     dependency checking and compilation for benchmarks listed
2505                     in the package description file.
2506
2507              --enable-relocatable
2508              --disable-relocatable
2509                     building a package that is relocatable. (GHC only)
2510
2511              --disable-response-files
2512                     enable workaround for old versions of programs like  "ar"
2513                     that do not support @file arguments
2514
2515              --with-alex PATH
2516                     give the path to alex
2517
2518              --with-ar PATH
2519                     give the path to ar
2520
2521              --with-c2hs PATH
2522                     give the path to c2hs
2523
2524              --with-cpphs PATH
2525                     give the path to cpphs
2526
2527              --with-doctest PATH
2528                     give the path to doctest
2529
2530              --with-gcc PATH
2531                     give the path to gcc
2532
2533              --with-ghc PATH
2534                     give the path to ghc
2535
2536              --with-ghc-pkg PATH
2537                     give the path to ghc-pkg
2538
2539              --with-ghcjs PATH
2540                     give the path to ghcjs
2541
2542              --with-ghcjs-pkg PATH
2543                     give the path to ghcjs-pkg
2544
2545              --with-greencard PATH
2546                     give the path to greencard
2547
2548              --with-haddock PATH
2549                     give the path to haddock
2550
2551              --with-happy PATH
2552                     give the path to happy
2553
2554              --with-haskell-suite PATH
2555                     give the path to haskell-suite
2556
2557              --with-haskell-suite-pkg PATH
2558                     give the path to haskell-suite-pkg
2559
2560              --with-hmake PATH
2561                     give the path to hmake
2562
2563              --with-hpc PATH
2564                     give the path to hpc
2565
2566              --with-hsc2hs PATH
2567                     give the path to hsc2hs
2568
2569              --with-hscolour PATH
2570                     give the path to hscolour
2571
2572              --with-jhc PATH
2573                     give the path to jhc
2574
2575              --with-ld PATH
2576                     give the path to ld
2577
2578              --with-lhc PATH
2579                     give the path to lhc
2580
2581              --with-lhc-pkg PATH
2582                     give the path to lhc-pkg
2583
2584              --with-pkg-config PATH
2585                     give the path to pkg-config
2586
2587              --with-runghc PATH
2588                     give the path to runghc
2589
2590              --with-strip PATH
2591                     give the path to strip
2592
2593              --with-tar PATH
2594                     give the path to tar
2595
2596              --with-uhc PATH
2597                     give the path to uhc
2598
2599              --alex-option OPT
2600                     give  an  extra  option to alex (no need to quote options
2601                     containing spaces)
2602
2603              --ar-option OPT
2604                     give an extra option to ar (no need to quote options con‐
2605                     taining spaces)
2606
2607              --c2hs-option OPT
2608                     give  an  extra  option to c2hs (no need to quote options
2609                     containing spaces)
2610
2611              --cpphs-option OPT
2612                     give an extra option to cpphs (no need to  quote  options
2613                     containing spaces)
2614
2615              --doctest-option OPT
2616                     give an extra option to doctest (no need to quote options
2617                     containing spaces)
2618
2619              --gcc-option OPT
2620                     give an extra option to gcc (no  need  to  quote  options
2621                     containing spaces)
2622
2623              --ghc-option OPT
2624                     give  an  extra  option  to ghc (no need to quote options
2625                     containing spaces)
2626
2627              --ghc-pkg-option OPT
2628                     give an extra option to ghc-pkg (no need to quote options
2629                     containing spaces)
2630
2631              --ghcjs-option OPT
2632                     give  an  extra option to ghcjs (no need to quote options
2633                     containing spaces)
2634
2635              --ghcjs-pkg-option OPT
2636                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
2637                     options containing spaces)
2638
2639              --greencard-option OPT
2640                     give  an  extra  option  to  greencard  (no need to quote
2641                     options containing spaces)
2642
2643              --haddock-option OPT
2644                     give an extra option to haddock (no need to quote options
2645                     containing spaces)
2646
2647              --happy-option OPT
2648                     give  an  extra option to happy (no need to quote options
2649                     containing spaces)
2650
2651              --haskell-suite-option OPT
2652                     give an extra option to haskell-suite (no need  to  quote
2653                     options containing spaces)
2654
2655              --haskell-suite-pkg-option OPT
2656                     give  an  extra  option  to haskell-suite-pkg (no need to
2657                     quote options containing spaces)
2658
2659              --hmake-option OPT
2660                     give an extra option to hmake (no need to  quote  options
2661                     containing spaces)
2662
2663              --hpc-option OPT
2664                     give  an  extra  option  to hpc (no need to quote options
2665                     containing spaces)
2666
2667              --hsc2hs-option OPT
2668                     give an extra option to hsc2hs (no need to quote  options
2669                     containing spaces)
2670
2671              --hscolour-option OPT
2672                     give  an  extra  option  to  hscolour  (no  need to quote
2673                     options containing spaces)
2674
2675              --jhc-option OPT
2676                     give an extra option to jhc (no  need  to  quote  options
2677                     containing spaces)
2678
2679              --ld-option OPT
2680                     give an extra option to ld (no need to quote options con‐
2681                     taining spaces)
2682
2683              --lhc-option OPT
2684                     give an extra option to lhc (no  need  to  quote  options
2685                     containing spaces)
2686
2687              --lhc-pkg-option OPT
2688                     give an extra option to lhc-pkg (no need to quote options
2689                     containing spaces)
2690
2691              --pkg-config-option OPT
2692                     give an extra option to  pkg-config  (no  need  to  quote
2693                     options containing spaces)
2694
2695              --runghc-option OPT
2696                     give  an extra option to runghc (no need to quote options
2697                     containing spaces)
2698
2699              --strip-option OPT
2700                     give an extra option to strip (no need to  quote  options
2701                     containing spaces)
2702
2703              --tar-option OPT
2704                     give  an  extra  option  to tar (no need to quote options
2705                     containing spaces)
2706
2707              --uhc-option OPT
2708                     give an extra option to uhc (no  need  to  quote  options
2709                     containing spaces)
2710
2711              --alex-options OPTS
2712                     give extra options to alex
2713
2714              --ar-options OPTS
2715                     give extra options to ar
2716
2717              --c2hs-options OPTS
2718                     give extra options to c2hs
2719
2720              --cpphs-options OPTS
2721                     give extra options to cpphs
2722
2723              --doctest-options OPTS
2724                     give extra options to doctest
2725
2726              --gcc-options OPTS
2727                     give extra options to gcc
2728
2729              --ghc-options OPTS
2730                     give extra options to ghc
2731
2732              --ghc-pkg-options OPTS
2733                     give extra options to ghc-pkg
2734
2735              --ghcjs-options OPTS
2736                     give extra options to ghcjs
2737
2738              --ghcjs-pkg-options OPTS
2739                     give extra options to ghcjs-pkg
2740
2741              --greencard-options OPTS
2742                     give extra options to greencard
2743
2744              --haddock-options OPTS
2745                     give extra options to haddock
2746
2747              --happy-options OPTS
2748                     give extra options to happy
2749
2750              --haskell-suite-options OPTS
2751                     give extra options to haskell-suite
2752
2753              --haskell-suite-pkg-options OPTS
2754                     give extra options to haskell-suite-pkg
2755
2756              --hmake-options OPTS
2757                     give extra options to hmake
2758
2759              --hpc-options OPTS
2760                     give extra options to hpc
2761
2762              --hsc2hs-options OPTS
2763                     give extra options to hsc2hs
2764
2765              --hscolour-options OPTS
2766                     give extra options to hscolour
2767
2768              --jhc-options OPTS
2769                     give extra options to jhc
2770
2771              --ld-options OPTS
2772                     give extra options to ld
2773
2774              --lhc-options OPTS
2775                     give extra options to lhc
2776
2777              --lhc-pkg-options OPTS
2778                     give extra options to lhc-pkg
2779
2780              --pkg-config-options OPTS
2781                     give extra options to pkg-config
2782
2783              --runghc-options OPTS
2784                     give extra options to runghc
2785
2786              --strip-options OPTS
2787                     give extra options to strip
2788
2789              --tar-options OPTS
2790                     give extra options to tar
2791
2792              --uhc-options OPTS
2793                     give extra options to uhc
2794
2795              --cabal-lib-version VERSION
2796                     Select  which  version  of  the Cabal lib to use to build
2797                     packages (useful for testing).
2798
2799              --constraint CONSTRAINT
2800                     Specify    constraints    on    a    package    (version,
2801                     installed/source, flags)
2802
2803              --preference CONSTRAINT
2804                     Specify  preferences (soft constraints) on the version of
2805                     a package
2806
2807              --solver SOLVER
2808                     Select  dependency  solver  to  use  (default:  modular).
2809                     Choices: modular.
2810
2811              --allow-older [DEPS]
2812                     Ignore lower bounds in all dependencies or DEPS
2813
2814              --allow-newer [DEPS]
2815                     Ignore upper bounds in all dependencies or DEPS
2816
2817
2818       cabal build
2819
2820       Usage: cabal build [FLAGS]
2821          or: cabal build COMPONENTS [FLAGS]
2822
2823
2824       Components encompass executables, tests, and benchmarks.
2825
2826       Affected by configuration options, see `configure`.
2827
2828
2829       Examples:
2830         cabal build               All the components in the package
2831         cabal build foo           A component (i.e. lib, exe, test suite)
2832
2833       The flags --with-PROG and --PROG-option(s) can be used with the follow‐
2834       ing programs:
2835         alex ar c2hs cpphs doctest gcc ghc ghc-pkg ghcjs ghcjs-pkg  greencard
2836       haddock
2837         happy  haskell-suite  haskell-suite-pkg hmake hpc hsc2hs hscolour jhc
2838       ld lhc
2839         lhc-pkg pkg-config runghc strip tar uhc
2840
2841
2842       Flags:
2843              -v, --verbose [n]
2844                     Control verbosity (n is 0--3, default verbosity level  is
2845                     1)
2846
2847              --builddir, --distdir, --distpref DIR
2848                     The  directory  where  Cabal  puts  generated build files
2849                     (default dist)
2850
2851              -j, --jobs [NUM]
2852                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
2853                     given).
2854
2855              --with-alex PATH
2856                     give the path to alex
2857
2858              --with-ar PATH
2859                     give the path to ar
2860
2861              --with-c2hs PATH
2862                     give the path to c2hs
2863
2864              --with-cpphs PATH
2865                     give the path to cpphs
2866
2867              --with-doctest PATH
2868                     give the path to doctest
2869
2870              --with-gcc PATH
2871                     give the path to gcc
2872
2873              --with-ghc PATH
2874                     give the path to ghc
2875
2876              --with-ghc-pkg PATH
2877                     give the path to ghc-pkg
2878
2879              --with-ghcjs PATH
2880                     give the path to ghcjs
2881
2882              --with-ghcjs-pkg PATH
2883                     give the path to ghcjs-pkg
2884
2885              --with-greencard PATH
2886                     give the path to greencard
2887
2888              --with-haddock PATH
2889                     give the path to haddock
2890
2891              --with-happy PATH
2892                     give the path to happy
2893
2894              --with-haskell-suite PATH
2895                     give the path to haskell-suite
2896
2897              --with-haskell-suite-pkg PATH
2898                     give the path to haskell-suite-pkg
2899
2900              --with-hmake PATH
2901                     give the path to hmake
2902
2903              --with-hpc PATH
2904                     give the path to hpc
2905
2906              --with-hsc2hs PATH
2907                     give the path to hsc2hs
2908
2909              --with-hscolour PATH
2910                     give the path to hscolour
2911
2912              --with-jhc PATH
2913                     give the path to jhc
2914
2915              --with-ld PATH
2916                     give the path to ld
2917
2918              --with-lhc PATH
2919                     give the path to lhc
2920
2921              --with-lhc-pkg PATH
2922                     give the path to lhc-pkg
2923
2924              --with-pkg-config PATH
2925                     give the path to pkg-config
2926
2927              --with-runghc PATH
2928                     give the path to runghc
2929
2930              --with-strip PATH
2931                     give the path to strip
2932
2933              --with-tar PATH
2934                     give the path to tar
2935
2936              --with-uhc PATH
2937                     give the path to uhc
2938
2939              --alex-option OPT
2940                     give  an  extra  option to alex (no need to quote options
2941                     containing spaces)
2942
2943              --ar-option OPT
2944                     give an extra option to ar (no need to quote options con‐
2945                     taining spaces)
2946
2947              --c2hs-option OPT
2948                     give  an  extra  option to c2hs (no need to quote options
2949                     containing spaces)
2950
2951              --cpphs-option OPT
2952                     give an extra option to cpphs (no need to  quote  options
2953                     containing spaces)
2954
2955              --doctest-option OPT
2956                     give an extra option to doctest (no need to quote options
2957                     containing spaces)
2958
2959              --gcc-option OPT
2960                     give an extra option to gcc (no  need  to  quote  options
2961                     containing spaces)
2962
2963              --ghc-option OPT
2964                     give  an  extra  option  to ghc (no need to quote options
2965                     containing spaces)
2966
2967              --ghc-pkg-option OPT
2968                     give an extra option to ghc-pkg (no need to quote options
2969                     containing spaces)
2970
2971              --ghcjs-option OPT
2972                     give  an  extra option to ghcjs (no need to quote options
2973                     containing spaces)
2974
2975              --ghcjs-pkg-option OPT
2976                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
2977                     options containing spaces)
2978
2979              --greencard-option OPT
2980                     give  an  extra  option  to  greencard  (no need to quote
2981                     options containing spaces)
2982
2983              --haddock-option OPT
2984                     give an extra option to haddock (no need to quote options
2985                     containing spaces)
2986
2987              --happy-option OPT
2988                     give  an  extra option to happy (no need to quote options
2989                     containing spaces)
2990
2991              --haskell-suite-option OPT
2992                     give an extra option to haskell-suite (no need  to  quote
2993                     options containing spaces)
2994
2995              --haskell-suite-pkg-option OPT
2996                     give  an  extra  option  to haskell-suite-pkg (no need to
2997                     quote options containing spaces)
2998
2999              --hmake-option OPT
3000                     give an extra option to hmake (no need to  quote  options
3001                     containing spaces)
3002
3003              --hpc-option OPT
3004                     give  an  extra  option  to hpc (no need to quote options
3005                     containing spaces)
3006
3007              --hsc2hs-option OPT
3008                     give an extra option to hsc2hs (no need to quote  options
3009                     containing spaces)
3010
3011              --hscolour-option OPT
3012                     give  an  extra  option  to  hscolour  (no  need to quote
3013                     options containing spaces)
3014
3015              --jhc-option OPT
3016                     give an extra option to jhc (no  need  to  quote  options
3017                     containing spaces)
3018
3019              --ld-option OPT
3020                     give an extra option to ld (no need to quote options con‐
3021                     taining spaces)
3022
3023              --lhc-option OPT
3024                     give an extra option to lhc (no  need  to  quote  options
3025                     containing spaces)
3026
3027              --lhc-pkg-option OPT
3028                     give an extra option to lhc-pkg (no need to quote options
3029                     containing spaces)
3030
3031              --pkg-config-option OPT
3032                     give an extra option to  pkg-config  (no  need  to  quote
3033                     options containing spaces)
3034
3035              --runghc-option OPT
3036                     give  an extra option to runghc (no need to quote options
3037                     containing spaces)
3038
3039              --strip-option OPT
3040                     give an extra option to strip (no need to  quote  options
3041                     containing spaces)
3042
3043              --tar-option OPT
3044                     give  an  extra  option  to tar (no need to quote options
3045                     containing spaces)
3046
3047              --uhc-option OPT
3048                     give an extra option to uhc (no  need  to  quote  options
3049                     containing spaces)
3050
3051              --alex-options OPTS
3052                     give extra options to alex
3053
3054              --ar-options OPTS
3055                     give extra options to ar
3056
3057              --c2hs-options OPTS
3058                     give extra options to c2hs
3059
3060              --cpphs-options OPTS
3061                     give extra options to cpphs
3062
3063              --doctest-options OPTS
3064                     give extra options to doctest
3065
3066              --gcc-options OPTS
3067                     give extra options to gcc
3068
3069              --ghc-options OPTS
3070                     give extra options to ghc
3071
3072              --ghc-pkg-options OPTS
3073                     give extra options to ghc-pkg
3074
3075              --ghcjs-options OPTS
3076                     give extra options to ghcjs
3077
3078              --ghcjs-pkg-options OPTS
3079                     give extra options to ghcjs-pkg
3080
3081              --greencard-options OPTS
3082                     give extra options to greencard
3083
3084              --haddock-options OPTS
3085                     give extra options to haddock
3086
3087              --happy-options OPTS
3088                     give extra options to happy
3089
3090              --haskell-suite-options OPTS
3091                     give extra options to haskell-suite
3092
3093              --haskell-suite-pkg-options OPTS
3094                     give extra options to haskell-suite-pkg
3095
3096              --hmake-options OPTS
3097                     give extra options to hmake
3098
3099              --hpc-options OPTS
3100                     give extra options to hpc
3101
3102              --hsc2hs-options OPTS
3103                     give extra options to hsc2hs
3104
3105              --hscolour-options OPTS
3106                     give extra options to hscolour
3107
3108              --jhc-options OPTS
3109                     give extra options to jhc
3110
3111              --ld-options OPTS
3112                     give extra options to ld
3113
3114              --lhc-options OPTS
3115                     give extra options to lhc
3116
3117              --lhc-pkg-options OPTS
3118                     give extra options to lhc-pkg
3119
3120              --pkg-config-options OPTS
3121                     give extra options to pkg-config
3122
3123              --runghc-options OPTS
3124                     give extra options to runghc
3125
3126              --strip-options OPTS
3127                     give extra options to strip
3128
3129              --tar-options OPTS
3130                     give extra options to tar
3131
3132              --uhc-options OPTS
3133                     give extra options to uhc
3134
3135              --only
3136                     Don't reinstall add-source dependencies (sandbox-only)
3137
3138
3139       cabal repl
3140
3141       Usage: cabal repl [COMPONENT] [FLAGS]
3142
3143
3144       If the current directory contains no package, ignores COMPONENT parame‐
3145       ters and opens an interactive interpreter  session;  if  a  sandbox  is
3146       present, its package database will be used.
3147
3148       Otherwise,  (re)configures  with  the given or default flags, and loads
3149       the interpreter with the relevant modules. For executables,  tests  and
3150       benchmarks, loads the main module (and its dependencies); for libraries
3151       all exposed/other modules.
3152
3153       The default component is the library itself, or the executable if  that
3154       is the only component.
3155
3156       Support  for  loading  specific  modules is planned but not implemented
3157       yet. For certain scenarios, `cabal exec -- ghci :l  Foo`  may  be  used
3158       instead.  Note  that `exec` will not (re)configure and you will have to
3159       specify the location of other modules, if required.
3160
3161
3162       Examples:
3163         cabal repl               The first component in the package
3164         cabal repl foo           A  named  component  (i.e.  lib,  exe,  test
3165       suite)
3166         cabal repl --ghc-options="-lstdc++"  Specifying flags for interpreter
3167
3168
3169       Flags:
3170              -v, --verbose [n]
3171                     Control  verbosity (n is 0--3, default verbosity level is
3172                     1)
3173
3174              --builddir, --distdir, --distpref DIR
3175                     The directory where  Cabal  puts  generated  build  files
3176                     (default dist)
3177
3178              --with-alex PATH
3179                     give the path to alex
3180
3181              --with-ar PATH
3182                     give the path to ar
3183
3184              --with-c2hs PATH
3185                     give the path to c2hs
3186
3187              --with-cpphs PATH
3188                     give the path to cpphs
3189
3190              --with-doctest PATH
3191                     give the path to doctest
3192
3193              --with-gcc PATH
3194                     give the path to gcc
3195
3196              --with-ghc PATH
3197                     give the path to ghc
3198
3199              --with-ghc-pkg PATH
3200                     give the path to ghc-pkg
3201
3202              --with-ghcjs PATH
3203                     give the path to ghcjs
3204
3205              --with-ghcjs-pkg PATH
3206                     give the path to ghcjs-pkg
3207
3208              --with-greencard PATH
3209                     give the path to greencard
3210
3211              --with-haddock PATH
3212                     give the path to haddock
3213
3214              --with-happy PATH
3215                     give the path to happy
3216
3217              --with-haskell-suite PATH
3218                     give the path to haskell-suite
3219
3220              --with-haskell-suite-pkg PATH
3221                     give the path to haskell-suite-pkg
3222
3223              --with-hmake PATH
3224                     give the path to hmake
3225
3226              --with-hpc PATH
3227                     give the path to hpc
3228
3229              --with-hsc2hs PATH
3230                     give the path to hsc2hs
3231
3232              --with-hscolour PATH
3233                     give the path to hscolour
3234
3235              --with-jhc PATH
3236                     give the path to jhc
3237
3238              --with-ld PATH
3239                     give the path to ld
3240
3241              --with-lhc PATH
3242                     give the path to lhc
3243
3244              --with-lhc-pkg PATH
3245                     give the path to lhc-pkg
3246
3247              --with-pkg-config PATH
3248                     give the path to pkg-config
3249
3250              --with-runghc PATH
3251                     give the path to runghc
3252
3253              --with-strip PATH
3254                     give the path to strip
3255
3256              --with-tar PATH
3257                     give the path to tar
3258
3259              --with-uhc PATH
3260                     give the path to uhc
3261
3262              --alex-option OPT
3263                     give  an  extra  option to alex (no need to quote options
3264                     containing spaces)
3265
3266              --ar-option OPT
3267                     give an extra option to ar (no need to quote options con‐
3268                     taining spaces)
3269
3270              --c2hs-option OPT
3271                     give  an  extra  option to c2hs (no need to quote options
3272                     containing spaces)
3273
3274              --cpphs-option OPT
3275                     give an extra option to cpphs (no need to  quote  options
3276                     containing spaces)
3277
3278              --doctest-option OPT
3279                     give an extra option to doctest (no need to quote options
3280                     containing spaces)
3281
3282              --gcc-option OPT
3283                     give an extra option to gcc (no  need  to  quote  options
3284                     containing spaces)
3285
3286              --ghc-option OPT
3287                     give  an  extra  option  to ghc (no need to quote options
3288                     containing spaces)
3289
3290              --ghc-pkg-option OPT
3291                     give an extra option to ghc-pkg (no need to quote options
3292                     containing spaces)
3293
3294              --ghcjs-option OPT
3295                     give  an  extra option to ghcjs (no need to quote options
3296                     containing spaces)
3297
3298              --ghcjs-pkg-option OPT
3299                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
3300                     options containing spaces)
3301
3302              --greencard-option OPT
3303                     give  an  extra  option  to  greencard  (no need to quote
3304                     options containing spaces)
3305
3306              --haddock-option OPT
3307                     give an extra option to haddock (no need to quote options
3308                     containing spaces)
3309
3310              --happy-option OPT
3311                     give  an  extra option to happy (no need to quote options
3312                     containing spaces)
3313
3314              --haskell-suite-option OPT
3315                     give an extra option to haskell-suite (no need  to  quote
3316                     options containing spaces)
3317
3318              --haskell-suite-pkg-option OPT
3319                     give  an  extra  option  to haskell-suite-pkg (no need to
3320                     quote options containing spaces)
3321
3322              --hmake-option OPT
3323                     give an extra option to hmake (no need to  quote  options
3324                     containing spaces)
3325
3326              --hpc-option OPT
3327                     give  an  extra  option  to hpc (no need to quote options
3328                     containing spaces)
3329
3330              --hsc2hs-option OPT
3331                     give an extra option to hsc2hs (no need to quote  options
3332                     containing spaces)
3333
3334              --hscolour-option OPT
3335                     give  an  extra  option  to  hscolour  (no  need to quote
3336                     options containing spaces)
3337
3338              --jhc-option OPT
3339                     give an extra option to jhc (no  need  to  quote  options
3340                     containing spaces)
3341
3342              --ld-option OPT
3343                     give an extra option to ld (no need to quote options con‐
3344                     taining spaces)
3345
3346              --lhc-option OPT
3347                     give an extra option to lhc (no  need  to  quote  options
3348                     containing spaces)
3349
3350              --lhc-pkg-option OPT
3351                     give an extra option to lhc-pkg (no need to quote options
3352                     containing spaces)
3353
3354              --pkg-config-option OPT
3355                     give an extra option to  pkg-config  (no  need  to  quote
3356                     options containing spaces)
3357
3358              --runghc-option OPT
3359                     give  an extra option to runghc (no need to quote options
3360                     containing spaces)
3361
3362              --strip-option OPT
3363                     give an extra option to strip (no need to  quote  options
3364                     containing spaces)
3365
3366              --tar-option OPT
3367                     give  an  extra  option  to tar (no need to quote options
3368                     containing spaces)
3369
3370              --uhc-option OPT
3371                     give an extra option to uhc (no  need  to  quote  options
3372                     containing spaces)
3373
3374              --alex-options OPTS
3375                     give extra options to alex
3376
3377              --ar-options OPTS
3378                     give extra options to ar
3379
3380              --c2hs-options OPTS
3381                     give extra options to c2hs
3382
3383              --cpphs-options OPTS
3384                     give extra options to cpphs
3385
3386              --doctest-options OPTS
3387                     give extra options to doctest
3388
3389              --gcc-options OPTS
3390                     give extra options to gcc
3391
3392              --ghc-options OPTS
3393                     give extra options to ghc
3394
3395              --ghc-pkg-options OPTS
3396                     give extra options to ghc-pkg
3397
3398              --ghcjs-options OPTS
3399                     give extra options to ghcjs
3400
3401              --ghcjs-pkg-options OPTS
3402                     give extra options to ghcjs-pkg
3403
3404              --greencard-options OPTS
3405                     give extra options to greencard
3406
3407              --haddock-options OPTS
3408                     give extra options to haddock
3409
3410              --happy-options OPTS
3411                     give extra options to happy
3412
3413              --haskell-suite-options OPTS
3414                     give extra options to haskell-suite
3415
3416              --haskell-suite-pkg-options OPTS
3417                     give extra options to haskell-suite-pkg
3418
3419              --hmake-options OPTS
3420                     give extra options to hmake
3421
3422              --hpc-options OPTS
3423                     give extra options to hpc
3424
3425              --hsc2hs-options OPTS
3426                     give extra options to hsc2hs
3427
3428              --hscolour-options OPTS
3429                     give extra options to hscolour
3430
3431              --jhc-options OPTS
3432                     give extra options to jhc
3433
3434              --ld-options OPTS
3435                     give extra options to ld
3436
3437              --lhc-options OPTS
3438                     give extra options to lhc
3439
3440              --lhc-pkg-options OPTS
3441                     give extra options to lhc-pkg
3442
3443              --pkg-config-options OPTS
3444                     give extra options to pkg-config
3445
3446              --runghc-options OPTS
3447                     give extra options to runghc
3448
3449              --strip-options OPTS
3450                     give extra options to strip
3451
3452              --tar-options OPTS
3453                     give extra options to tar
3454
3455              --uhc-options OPTS
3456                     give extra options to uhc
3457
3458              --reload
3459                     Used from within an interpreter to update files.
3460
3461              --only
3462                     Don't reinstall add-source dependencies (sandbox-only)
3463
3464
3465       cabal sandbox
3466
3467       Usage: cabal sandbox init          [FLAGS]
3468          or: cabal sandbox delete        [FLAGS]
3469          or: cabal sandbox add-source    [FLAGS] PATHS
3470          or: cabal sandbox delete-source [FLAGS] PATHS
3471          or: cabal sandbox list-sources  [FLAGS]
3472          or: cabal sandbox hc-pkg        [FLAGS] [--] COMMAND [--] [ARGS]
3473
3474
3475       Sandboxes  are  isolated  package databases that can be used to prevent
3476       dependency conflicts  that  arise  when  many  different  packages  are
3477       installed  in  the  same database (i.e. the user's database in the home
3478       directory).
3479
3480       A sandbox in the current directory (created by `sandbox init`) will  be
3481       used  instead of the user's database for commands such as `install` and
3482       `build`.  Note that (a directly invoked) GHC will not automatically  be
3483       aware of sandboxes; only if called via appropriate cabal commands, e.g.
3484       `repl`, `build`, `exec`.
3485
3486       Currently, cabal will not search for a sandbox  in  folders  above  the
3487       current  one,  so  cabal  will not see the sandbox if you are in a sub‐
3488       folder of a sandbox.
3489
3490       Subcommands:
3491
3492       init:
3493         Initialize a sandbox in the current directory.  An  existing  package
3494       database
3495         will not be modified, but settings (such as the location of the data‐
3496       base)
3497         can be modified this way.
3498
3499       delete:
3500         Remove the sandbox; deleting all the packages installed inside.
3501
3502       add-source:
3503         Make one or more local packages available in the sandbox.  PATHS  may
3504       be
3505         relative  or  absolute.  Typical  usecase  is when you need to make a
3506       (temporary)
3507         modification to a dependency: You download the package into a differ‐
3508       ent
3509         directory, make the modification, and add that directory to the sand‐
3510       box with
3511         `add-source`.
3512
3513         Unless given `--snapshot`, any add-source'd dependency that was modi‐
3514       fied
3515         since the last build will be re-installed automatically.
3516
3517       delete-source:
3518         Remove an add-source dependency; however, this will not delete the
3519         package(s)  that  have been installed in the sandbox from this depen‐
3520       dency. You
3521         can either unregister the package(s) via `cabal sandbox hc-pkg unreg‐
3522       ister`
3523         or re-create the sandbox (`sandbox delete; sandbox init`).
3524
3525       list-sources:
3526         List the directories of local packages made available via `cabal
3527         add-source`.
3528
3529       hc-pkg:
3530         Similar  to  `ghc-pkg`,  but for the sandbox package database. Can be
3531       used to
3532         list specific/all packages that are installed in the sandbox. For
3533         subcommands, see the help for ghc-pkg. Affected by the compiler  ver‐
3534       sion
3535         specified by `configure`.
3536
3537
3538
3539       Relevant global configuration keys:
3540         require-sandbox
3541         ignore-sandbox
3542
3543       Examples:
3544         Set up a sandbox with one local dependency, located at ../foo:
3545           cabal sandbox init
3546           cabal sandbox add-source ../foo
3547           cabal install --only-dependencies
3548         Reset the sandbox:
3549           cabal sandbox delete
3550           cabal sandbox init
3551           cabal install --only-dependencies
3552         List the packages in the sandbox:
3553           cabal sandbox hc-pkg list
3554         Unregister the `broken` package from the sandbox:
3555           cabal sandbox hc-pkg -- --force unregister broken
3556
3557
3558       Flags:
3559              -v, --verbose [n]
3560                     Control  verbosity (n is 0--3, default verbosity level is
3561                     1)
3562
3563              --snapshot
3564                     Take a snapshot instead of creating a link (only  applies
3565                     to 'add-source')
3566
3567              --sandbox DIR
3568                     Sandbox location (default: './.cabal-sandbox').
3569
3570
3571       cabal doctest
3572
3573       Usage: cabal doctest [FLAGS]
3574
3575
3576       Requires the program doctest, version 0.12.
3577
3578
3579       Flags:
3580              -v, --verbose [n]
3581                     Control  verbosity (n is 0--3, default verbosity level is
3582                     1)
3583
3584              --builddir, --distdir, --distpref DIR
3585                     The directory where  Cabal  puts  generated  build  files
3586                     (default dist)
3587
3588              --with-doctest PATH
3589                     give the path to doctest
3590
3591              --doctest-option OPT
3592                     give an extra option to doctest (no need to quote options
3593                     containing spaces)
3594
3595              --doctest-options OPTS
3596                     give extra options to doctest
3597
3598
3599       cabal haddock
3600
3601       Usage: cabal haddock [FLAGS]
3602
3603
3604       Requires the program haddock, version 2.x.
3605
3606
3607       Flags:
3608              -v, --verbose [n]
3609                     Control verbosity (n is 0--3, default verbosity level  is
3610                     1)
3611
3612              --builddir, --distdir, --distpref DIR
3613                     The  directory  where  Cabal  puts  generated build files
3614                     (default dist)
3615
3616              --keep-temp-files
3617                     Keep temporary files
3618
3619              --hoogle
3620                     Generate a hoogle database
3621
3622              --html
3623                     Generate HTML documentation (the default)
3624
3625              --html-location URL
3626                     Location of HTML documentation for pre-requisite packages
3627
3628              --for-hackage
3629                     Collection of flags to  generate  documentation  suitable
3630                     for upload to hackage
3631
3632              --executables
3633                     Run haddock for Executables targets
3634
3635              --tests
3636                     Run haddock for Test Suite targets
3637
3638              --benchmarks
3639                     Run haddock for Benchmark targets
3640
3641              --foreign-libraries
3642                     Run haddock for Foreign Library targets
3643
3644              --all
3645                     Run haddock for all targets
3646
3647              --internal
3648                     Run haddock for internal modules and include all symbols
3649
3650              --css PATH
3651                     Use PATH as the haddock stylesheet
3652
3653              --hyperlink-source, --hyperlink-sources
3654                     Hyperlink the documentation to the source code
3655
3656              --hscolour-css PATH
3657                     Use PATH as the HsColour stylesheet
3658
3659              --contents-location URL
3660                     Bake URL in as the location for the contents page
3661
3662              --with-ghc PATH
3663                     give the path to ghc
3664
3665              --with-haddock PATH
3666                     give the path to haddock
3667
3668              --ghc-option OPT
3669                     give  an  extra  option  to ghc (no need to quote options
3670                     containing spaces)
3671
3672              --haddock-option OPT
3673                     give an extra option to haddock (no need to quote options
3674                     containing spaces)
3675
3676              --ghc-options OPTS
3677                     give extra options to ghc
3678
3679              --haddock-options OPTS
3680                     give extra options to haddock
3681
3682
3683       cabal exec
3684
3685       Usage: cabal exec [FLAGS] [--] COMMAND [--] [ARGS]
3686
3687
3688       A  directly  invoked  GHC  will not automatically be aware of any sand‐
3689       boxes: the GHC_PACKAGE_PATH  environment  variable  controls  what  GHC
3690       uses. `cabal exec` can be used to modify this variable: COMMAND will be
3691       executed in a modified environment and thereby uses the sandbox package
3692       database.
3693
3694       If there is no sandbox, behaves as identity (executing COMMAND).
3695
3696       Note  that  other cabal commands change the environment variable appro‐
3697       priately already, so there is no need to wrap those  in  `cabal  exec`.
3698       But  with `cabal exec`, the user has more control and can, for example,
3699       execute custom scripts which indirectly execute GHC.
3700
3701       Note that `cabal repl` is different from `cabal exec --  ghci`  as  the
3702       latter will not forward any additional flags being defined in the local
3703       package to ghci.
3704
3705       See `cabal sandbox`.
3706
3707
3708       Examples:
3709         cabal exec -- ghci -Wall
3710           Start a repl session with sandbox packages and all warnings;
3711         cabal exec gitit -- -f gitit.cnf
3712           Give gitit access to the sandbox packages, and pass it a flag;
3713         cabal exec runghc Foo.hs
3714           Execute runghc on Foo.hs with runghc configured to use the
3715           sandbox package database (if a sandbox is being used).
3716
3717
3718       Flags:
3719              -v, --verbose [n]
3720                     Control verbosity (n is 0--3, default verbosity level  is
3721                     1)
3722
3723              --builddir, --distdir, --distpref DIR
3724                     The  directory  where  Cabal  puts  generated build files
3725                     (default dist)
3726
3727
3728       cabal user-config
3729
3730       Usage: cabal user-config init
3731          or: cabal user-config diff
3732          or: cabal user-config update
3733
3734
3735       When upgrading cabal, the set of configuration keys and  their  default
3736       values  may  change.  This command provides means to merge the existing
3737       config in ~/.cabal/config (i.e. all bindings that are actually  defined
3738       and not commented out) and the default config of the new version.
3739
3740       init:  Creates a new config file at either ~/.cabal/config or as speci‐
3741       fied by --config-file, if given. An existing file won't be  overwritten
3742       unless -f or --force is given.  diff: Shows a pseudo-diff of the user's
3743       ~/.cabal/config file and the default configuration that would  be  cre‐
3744       ated  by  cabal  if the config file did not exist.  update: Applies the
3745       pseudo-diff to the configuration that would be created by default,  and
3746       write the result back to ~/.cabal/config.
3747
3748
3749       Flags:
3750              -v, --verbose [n]
3751                     Control  verbosity (n is 0--3, default verbosity level is
3752                     1)
3753
3754              -f, --force
3755                     Overwrite the config file if it already exists.
3756
3757              -a, --augment CONFIGLINE
3758                     Additional setting to augment the config file  (replacing
3759                     a previous setting if it existed).
3760
3761
3762       cabal clean
3763
3764       Usage: cabal clean [FLAGS]
3765
3766
3767       Removes .hi, .o, preprocessed sources, etc.
3768
3769
3770       Flags:
3771              -v, --verbose [n]
3772                     Control  verbosity (n is 0--3, default verbosity level is
3773                     1)
3774
3775              --builddir, --distdir, --distpref DIR
3776                     The directory where  Cabal  puts  generated  build  files
3777                     (default dist)
3778
3779              -s, --save-configure
3780                     Do  not remove the configuration file (dist/setup-config)
3781                     during cleaning.  Saves need to reconfigure.
3782
3783
3784       cabal gen-bounds
3785
3786       Usage: cabal gen-bounds [FLAGS]
3787
3788
3789       Generates bounds for all dependencies that do not currently have  them.
3790       Generated  bounds  are  printed to stdout. You can then paste them into
3791       your
3792
3793
3794
3795       Flags:
3796              -v, --verbose [n]
3797                     Control verbosity (n is 0--3, default verbosity level  is
3798                     1)
3799
3800
3801       cabal outdated
3802
3803       Usage: cabal outdated [FLAGS]
3804
3805
3806       Checks  for  outdated  dependencies  in the package description file or
3807       freeze file
3808
3809
3810       Flags:
3811              -v, --verbose [n]
3812                     Control verbosity (n is 0--3, default verbosity level  is
3813                     1)
3814
3815              --freeze-file
3816                     Act on the freeze file
3817
3818              --new-freeze-file
3819                     Act on the new-style freeze file
3820
3821              --simple-output
3822                     Only print names of outdated dependencies, one per line
3823
3824              --exit-code
3825                     Exit with non-zero when there are outdated dependencies
3826
3827              -q, --quiet
3828                     Don't print any output. Implies '--exit-code' and '-v0'
3829
3830              --ignore PKGS
3831                     Packages to ignore
3832
3833              --minor [PKGS]
3834                     Ignore major version bumps for these packages
3835
3836
3837       cabal copy
3838
3839       Usage: cabal copy [FLAGS]
3840          or: cabal copy COMPONENTS [FLAGS]
3841
3842
3843       Components encompass executables and libraries. Does not call register,
3844       and allows a prefix at install time. Without the --destdir  flag,  con‐
3845       figure determines location.
3846
3847
3848       Examples:
3849         cabal build               All the components in the package
3850         cabal build foo           A component (i.e. lib, exe, test suite)
3851
3852       Flags:
3853              -v, --verbose [n]
3854                     Control  verbosity (n is 0--3, default verbosity level is
3855                     1)
3856
3857              --builddir, --distdir, --distpref DIR
3858                     The directory where  Cabal  puts  generated  build  files
3859                     (default dist)
3860
3861              --destdir DIR
3862                     directory  to  copy  files  to, prepended to installation
3863                     directories
3864
3865              --target-package-db DATABASE
3866                     package database to copy files into. Required when  using
3867                     ${pkgroot} prefix.
3868
3869
3870       cabal hscolour
3871
3872       Usage: cabal hscolour [FLAGS]
3873
3874
3875       Requires the hscolour program.
3876
3877
3878       Flags:
3879              -v, --verbose [n]
3880                     Control  verbosity (n is 0--3, default verbosity level is
3881                     1)
3882
3883              --builddir, --distdir, --distpref DIR
3884                     The directory where  Cabal  puts  generated  build  files
3885                     (default dist)
3886
3887              --executables
3888                     Run hscolour for Executables targets
3889
3890              --tests
3891                     Run hscolour for Test Suite targets
3892
3893              --benchmarks
3894                     Run hscolour for Benchmark targets
3895
3896              --foreign-libraries
3897                     Run hscolour for Foreign Library targets
3898
3899              --all
3900                     Run hscolour for all targets
3901
3902              --css PATH
3903                     Use a cascading style sheet
3904
3905
3906       cabal register
3907
3908       Usage: cabal register [FLAGS]
3909
3910
3911       Flags:
3912              -v, --verbose [n]
3913                     Control  verbosity (n is 0--3, default verbosity level is
3914                     1)
3915
3916              --builddir, --distdir, --distpref DIR
3917                     The directory where  Cabal  puts  generated  build  files
3918                     (default dist)
3919
3920              --user
3921                     upon  registration,  register  this package in the user's
3922                     local package database
3923
3924              --global
3925                     (default)upon registration, register this package in  the
3926                     system-wide package database
3927
3928              --inplace
3929                     register  the package in the build location, so it can be
3930                     used without being installed
3931
3932              --gen-script
3933                     instead of registering, generate  a  script  to  register
3934                     later
3935
3936              --gen-pkg-config [PKG]
3937                     instead  of  registering, generate a package registration
3938                     file/directory
3939
3940              --print-ipid
3941                     print the installed package ID calculated for this  pack‐
3942                     age
3943
3944
3945       cabal test
3946
3947       Usage: cabal test [FLAGS]
3948          or: cabal test TESTCOMPONENTS [FLAGS]
3949
3950
3951       If  necessary  (re)configures with `--enable-tests` flag and builds the
3952       test suite.
3953
3954       Remember that the tests' dependencies must be installed  if  there  are
3955       additional ones; e.g. with `cabal install --only-dependencies --enable-
3956       tests`.
3957
3958       By defining UserHooks in a custom  Setup.hs,  the  package  can  define
3959       actions to be executed before and after running tests.
3960
3961
3962       Flags:
3963              -v, --verbose [n]
3964                     Control  verbosity (n is 0--3, default verbosity level is
3965                     1)
3966
3967              --builddir, --distdir, --distpref DIR
3968                     The directory where  Cabal  puts  generated  build  files
3969                     (default dist)
3970
3971              --log TEMPLATE
3972                     Log all test suite results to file (name template can use
3973                     $pkgid, $compiler, $os, $arch, $test-suite, $result)
3974
3975              --machine-log TEMPLATE
3976                     Produce a machine-readable log file  (name  template  can
3977                     use $pkgid, $compiler, $os, $arch, $result)
3978
3979              --show-details FILTER
3980
3981              --keep-tix-files
3982                     keep .tix files for HPC between test runs
3983
3984              --test-options TEMPLATES
3985                     give  extra  options  to test executables (name templates
3986                     can use $pkgid, $compiler, $os, $arch, $test-suite)
3987
3988              --test-option TEMPLATE
3989                     give extra option to test executables (no need  to  quote
3990                     options  containing spaces, name template can use $pkgid,
3991                     $compiler, $os, $arch, $test-suite)
3992
3993              -j, --jobs [NUM]
3994                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
3995                     given).
3996
3997              --with-alex PATH
3998                     give the path to alex
3999
4000              --with-ar PATH
4001                     give the path to ar
4002
4003              --with-c2hs PATH
4004                     give the path to c2hs
4005
4006              --with-cpphs PATH
4007                     give the path to cpphs
4008
4009              --with-doctest PATH
4010                     give the path to doctest
4011
4012              --with-gcc PATH
4013                     give the path to gcc
4014
4015              --with-ghc PATH
4016                     give the path to ghc
4017
4018              --with-ghc-pkg PATH
4019                     give the path to ghc-pkg
4020
4021              --with-ghcjs PATH
4022                     give the path to ghcjs
4023
4024              --with-ghcjs-pkg PATH
4025                     give the path to ghcjs-pkg
4026
4027              --with-greencard PATH
4028                     give the path to greencard
4029
4030              --with-haddock PATH
4031                     give the path to haddock
4032
4033              --with-happy PATH
4034                     give the path to happy
4035
4036              --with-haskell-suite PATH
4037                     give the path to haskell-suite
4038
4039              --with-haskell-suite-pkg PATH
4040                     give the path to haskell-suite-pkg
4041
4042              --with-hmake PATH
4043                     give the path to hmake
4044
4045              --with-hpc PATH
4046                     give the path to hpc
4047
4048              --with-hsc2hs PATH
4049                     give the path to hsc2hs
4050
4051              --with-hscolour PATH
4052                     give the path to hscolour
4053
4054              --with-jhc PATH
4055                     give the path to jhc
4056
4057              --with-ld PATH
4058                     give the path to ld
4059
4060              --with-lhc PATH
4061                     give the path to lhc
4062
4063              --with-lhc-pkg PATH
4064                     give the path to lhc-pkg
4065
4066              --with-pkg-config PATH
4067                     give the path to pkg-config
4068
4069              --with-runghc PATH
4070                     give the path to runghc
4071
4072              --with-strip PATH
4073                     give the path to strip
4074
4075              --with-tar PATH
4076                     give the path to tar
4077
4078              --with-uhc PATH
4079                     give the path to uhc
4080
4081              --alex-option OPT
4082                     give  an  extra  option to alex (no need to quote options
4083                     containing spaces)
4084
4085              --ar-option OPT
4086                     give an extra option to ar (no need to quote options con‐
4087                     taining spaces)
4088
4089              --c2hs-option OPT
4090                     give  an  extra  option to c2hs (no need to quote options
4091                     containing spaces)
4092
4093              --cpphs-option OPT
4094                     give an extra option to cpphs (no need to  quote  options
4095                     containing spaces)
4096
4097              --doctest-option OPT
4098                     give an extra option to doctest (no need to quote options
4099                     containing spaces)
4100
4101              --gcc-option OPT
4102                     give an extra option to gcc (no  need  to  quote  options
4103                     containing spaces)
4104
4105              --ghc-option OPT
4106                     give  an  extra  option  to ghc (no need to quote options
4107                     containing spaces)
4108
4109              --ghc-pkg-option OPT
4110                     give an extra option to ghc-pkg (no need to quote options
4111                     containing spaces)
4112
4113              --ghcjs-option OPT
4114                     give  an  extra option to ghcjs (no need to quote options
4115                     containing spaces)
4116
4117              --ghcjs-pkg-option OPT
4118                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
4119                     options containing spaces)
4120
4121              --greencard-option OPT
4122                     give  an  extra  option  to  greencard  (no need to quote
4123                     options containing spaces)
4124
4125              --haddock-option OPT
4126                     give an extra option to haddock (no need to quote options
4127                     containing spaces)
4128
4129              --happy-option OPT
4130                     give  an  extra option to happy (no need to quote options
4131                     containing spaces)
4132
4133              --haskell-suite-option OPT
4134                     give an extra option to haskell-suite (no need  to  quote
4135                     options containing spaces)
4136
4137              --haskell-suite-pkg-option OPT
4138                     give  an  extra  option  to haskell-suite-pkg (no need to
4139                     quote options containing spaces)
4140
4141              --hmake-option OPT
4142                     give an extra option to hmake (no need to  quote  options
4143                     containing spaces)
4144
4145              --hpc-option OPT
4146                     give  an  extra  option  to hpc (no need to quote options
4147                     containing spaces)
4148
4149              --hsc2hs-option OPT
4150                     give an extra option to hsc2hs (no need to quote  options
4151                     containing spaces)
4152
4153              --hscolour-option OPT
4154                     give  an  extra  option  to  hscolour  (no  need to quote
4155                     options containing spaces)
4156
4157              --jhc-option OPT
4158                     give an extra option to jhc (no  need  to  quote  options
4159                     containing spaces)
4160
4161              --ld-option OPT
4162                     give an extra option to ld (no need to quote options con‐
4163                     taining spaces)
4164
4165              --lhc-option OPT
4166                     give an extra option to lhc (no  need  to  quote  options
4167                     containing spaces)
4168
4169              --lhc-pkg-option OPT
4170                     give an extra option to lhc-pkg (no need to quote options
4171                     containing spaces)
4172
4173              --pkg-config-option OPT
4174                     give an extra option to  pkg-config  (no  need  to  quote
4175                     options containing spaces)
4176
4177              --runghc-option OPT
4178                     give  an extra option to runghc (no need to quote options
4179                     containing spaces)
4180
4181              --strip-option OPT
4182                     give an extra option to strip (no need to  quote  options
4183                     containing spaces)
4184
4185              --tar-option OPT
4186                     give  an  extra  option  to tar (no need to quote options
4187                     containing spaces)
4188
4189              --uhc-option OPT
4190                     give an extra option to uhc (no  need  to  quote  options
4191                     containing spaces)
4192
4193              --alex-options OPTS
4194                     give extra options to alex
4195
4196              --ar-options OPTS
4197                     give extra options to ar
4198
4199              --c2hs-options OPTS
4200                     give extra options to c2hs
4201
4202              --cpphs-options OPTS
4203                     give extra options to cpphs
4204
4205              --doctest-options OPTS
4206                     give extra options to doctest
4207
4208              --gcc-options OPTS
4209                     give extra options to gcc
4210
4211              --ghc-options OPTS
4212                     give extra options to ghc
4213
4214              --ghc-pkg-options OPTS
4215                     give extra options to ghc-pkg
4216
4217              --ghcjs-options OPTS
4218                     give extra options to ghcjs
4219
4220              --ghcjs-pkg-options OPTS
4221                     give extra options to ghcjs-pkg
4222
4223              --greencard-options OPTS
4224                     give extra options to greencard
4225
4226              --haddock-options OPTS
4227                     give extra options to haddock
4228
4229              --happy-options OPTS
4230                     give extra options to happy
4231
4232              --haskell-suite-options OPTS
4233                     give extra options to haskell-suite
4234
4235              --haskell-suite-pkg-options OPTS
4236                     give extra options to haskell-suite-pkg
4237
4238              --hmake-options OPTS
4239                     give extra options to hmake
4240
4241              --hpc-options OPTS
4242                     give extra options to hpc
4243
4244              --hsc2hs-options OPTS
4245                     give extra options to hsc2hs
4246
4247              --hscolour-options OPTS
4248                     give extra options to hscolour
4249
4250              --jhc-options OPTS
4251                     give extra options to jhc
4252
4253              --ld-options OPTS
4254                     give extra options to ld
4255
4256              --lhc-options OPTS
4257                     give extra options to lhc
4258
4259              --lhc-pkg-options OPTS
4260                     give extra options to lhc-pkg
4261
4262              --pkg-config-options OPTS
4263                     give extra options to pkg-config
4264
4265              --runghc-options OPTS
4266                     give extra options to runghc
4267
4268              --strip-options OPTS
4269                     give extra options to strip
4270
4271              --tar-options OPTS
4272                     give extra options to tar
4273
4274              --uhc-options OPTS
4275                     give extra options to uhc
4276
4277              --only
4278                     Don't reinstall add-source dependencies (sandbox-only)
4279
4280
4281       cabal bench
4282
4283       Usage: cabal bench [FLAGS]
4284          or: cabal bench BENCHCOMPONENTS [FLAGS]
4285
4286
4287       If  necessary (re)configures with `--enable-benchmarks` flag and builds
4288       the benchmarks.
4289
4290       Remember that the benchmarks' dependencies must be installed  if  there
4291       are  additional  ones;  e.g.  with  `cabal  install --only-dependencies
4292       --enable-benchmarks`.
4293
4294       By defining UserHooks in a custom  Setup.hs,  the  package  can  define
4295       actions to be executed before and after running benchmarks.
4296
4297
4298       Flags:
4299              -v, --verbose [n]
4300                     Control  verbosity (n is 0--3, default verbosity level is
4301                     1)
4302
4303              --builddir, --distdir, --distpref DIR
4304                     The directory where  Cabal  puts  generated  build  files
4305                     (default dist)
4306
4307              --benchmark-options TEMPLATES
4308                     give  extra  options  to benchmark executables (name tem‐
4309                     plates can use $pkgid, $compiler, $os, $arch, $benchmark)
4310
4311              --benchmark-option TEMPLATE
4312                     give extra option to benchmark executables  (no  need  to
4313                     quote  options  containing  spaces, name template can use
4314                     $pkgid, $compiler, $os, $arch, $benchmark)
4315
4316              -j, --jobs [NUM]
4317                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
4318                     given).
4319
4320              --with-alex PATH
4321                     give the path to alex
4322
4323              --with-ar PATH
4324                     give the path to ar
4325
4326              --with-c2hs PATH
4327                     give the path to c2hs
4328
4329              --with-cpphs PATH
4330                     give the path to cpphs
4331
4332              --with-doctest PATH
4333                     give the path to doctest
4334
4335              --with-gcc PATH
4336                     give the path to gcc
4337
4338              --with-ghc PATH
4339                     give the path to ghc
4340
4341              --with-ghc-pkg PATH
4342                     give the path to ghc-pkg
4343
4344              --with-ghcjs PATH
4345                     give the path to ghcjs
4346
4347              --with-ghcjs-pkg PATH
4348                     give the path to ghcjs-pkg
4349
4350              --with-greencard PATH
4351                     give the path to greencard
4352
4353              --with-haddock PATH
4354                     give the path to haddock
4355
4356              --with-happy PATH
4357                     give the path to happy
4358
4359              --with-haskell-suite PATH
4360                     give the path to haskell-suite
4361
4362              --with-haskell-suite-pkg PATH
4363                     give the path to haskell-suite-pkg
4364
4365              --with-hmake PATH
4366                     give the path to hmake
4367
4368              --with-hpc PATH
4369                     give the path to hpc
4370
4371              --with-hsc2hs PATH
4372                     give the path to hsc2hs
4373
4374              --with-hscolour PATH
4375                     give the path to hscolour
4376
4377              --with-jhc PATH
4378                     give the path to jhc
4379
4380              --with-ld PATH
4381                     give the path to ld
4382
4383              --with-lhc PATH
4384                     give the path to lhc
4385
4386              --with-lhc-pkg PATH
4387                     give the path to lhc-pkg
4388
4389              --with-pkg-config PATH
4390                     give the path to pkg-config
4391
4392              --with-runghc PATH
4393                     give the path to runghc
4394
4395              --with-strip PATH
4396                     give the path to strip
4397
4398              --with-tar PATH
4399                     give the path to tar
4400
4401              --with-uhc PATH
4402                     give the path to uhc
4403
4404              --alex-option OPT
4405                     give  an  extra  option to alex (no need to quote options
4406                     containing spaces)
4407
4408              --ar-option OPT
4409                     give an extra option to ar (no need to quote options con‐
4410                     taining spaces)
4411
4412              --c2hs-option OPT
4413                     give  an  extra  option to c2hs (no need to quote options
4414                     containing spaces)
4415
4416              --cpphs-option OPT
4417                     give an extra option to cpphs (no need to  quote  options
4418                     containing spaces)
4419
4420              --doctest-option OPT
4421                     give an extra option to doctest (no need to quote options
4422                     containing spaces)
4423
4424              --gcc-option OPT
4425                     give an extra option to gcc (no  need  to  quote  options
4426                     containing spaces)
4427
4428              --ghc-option OPT
4429                     give  an  extra  option  to ghc (no need to quote options
4430                     containing spaces)
4431
4432              --ghc-pkg-option OPT
4433                     give an extra option to ghc-pkg (no need to quote options
4434                     containing spaces)
4435
4436              --ghcjs-option OPT
4437                     give  an  extra option to ghcjs (no need to quote options
4438                     containing spaces)
4439
4440              --ghcjs-pkg-option OPT
4441                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
4442                     options containing spaces)
4443
4444              --greencard-option OPT
4445                     give  an  extra  option  to  greencard  (no need to quote
4446                     options containing spaces)
4447
4448              --haddock-option OPT
4449                     give an extra option to haddock (no need to quote options
4450                     containing spaces)
4451
4452              --happy-option OPT
4453                     give  an  extra option to happy (no need to quote options
4454                     containing spaces)
4455
4456              --haskell-suite-option OPT
4457                     give an extra option to haskell-suite (no need  to  quote
4458                     options containing spaces)
4459
4460              --haskell-suite-pkg-option OPT
4461                     give  an  extra  option  to haskell-suite-pkg (no need to
4462                     quote options containing spaces)
4463
4464              --hmake-option OPT
4465                     give an extra option to hmake (no need to  quote  options
4466                     containing spaces)
4467
4468              --hpc-option OPT
4469                     give  an  extra  option  to hpc (no need to quote options
4470                     containing spaces)
4471
4472              --hsc2hs-option OPT
4473                     give an extra option to hsc2hs (no need to quote  options
4474                     containing spaces)
4475
4476              --hscolour-option OPT
4477                     give  an  extra  option  to  hscolour  (no  need to quote
4478                     options containing spaces)
4479
4480              --jhc-option OPT
4481                     give an extra option to jhc (no  need  to  quote  options
4482                     containing spaces)
4483
4484              --ld-option OPT
4485                     give an extra option to ld (no need to quote options con‐
4486                     taining spaces)
4487
4488              --lhc-option OPT
4489                     give an extra option to lhc (no  need  to  quote  options
4490                     containing spaces)
4491
4492              --lhc-pkg-option OPT
4493                     give an extra option to lhc-pkg (no need to quote options
4494                     containing spaces)
4495
4496              --pkg-config-option OPT
4497                     give an extra option to  pkg-config  (no  need  to  quote
4498                     options containing spaces)
4499
4500              --runghc-option OPT
4501                     give  an extra option to runghc (no need to quote options
4502                     containing spaces)
4503
4504              --strip-option OPT
4505                     give an extra option to strip (no need to  quote  options
4506                     containing spaces)
4507
4508              --tar-option OPT
4509                     give  an  extra  option  to tar (no need to quote options
4510                     containing spaces)
4511
4512              --uhc-option OPT
4513                     give an extra option to uhc (no  need  to  quote  options
4514                     containing spaces)
4515
4516              --alex-options OPTS
4517                     give extra options to alex
4518
4519              --ar-options OPTS
4520                     give extra options to ar
4521
4522              --c2hs-options OPTS
4523                     give extra options to c2hs
4524
4525              --cpphs-options OPTS
4526                     give extra options to cpphs
4527
4528              --doctest-options OPTS
4529                     give extra options to doctest
4530
4531              --gcc-options OPTS
4532                     give extra options to gcc
4533
4534              --ghc-options OPTS
4535                     give extra options to ghc
4536
4537              --ghc-pkg-options OPTS
4538                     give extra options to ghc-pkg
4539
4540              --ghcjs-options OPTS
4541                     give extra options to ghcjs
4542
4543              --ghcjs-pkg-options OPTS
4544                     give extra options to ghcjs-pkg
4545
4546              --greencard-options OPTS
4547                     give extra options to greencard
4548
4549              --haddock-options OPTS
4550                     give extra options to haddock
4551
4552              --happy-options OPTS
4553                     give extra options to happy
4554
4555              --haskell-suite-options OPTS
4556                     give extra options to haskell-suite
4557
4558              --haskell-suite-pkg-options OPTS
4559                     give extra options to haskell-suite-pkg
4560
4561              --hmake-options OPTS
4562                     give extra options to hmake
4563
4564              --hpc-options OPTS
4565                     give extra options to hpc
4566
4567              --hsc2hs-options OPTS
4568                     give extra options to hsc2hs
4569
4570              --hscolour-options OPTS
4571                     give extra options to hscolour
4572
4573              --jhc-options OPTS
4574                     give extra options to jhc
4575
4576              --ld-options OPTS
4577                     give extra options to ld
4578
4579              --lhc-options OPTS
4580                     give extra options to lhc
4581
4582              --lhc-pkg-options OPTS
4583                     give extra options to lhc-pkg
4584
4585              --pkg-config-options OPTS
4586                     give extra options to pkg-config
4587
4588              --runghc-options OPTS
4589                     give extra options to runghc
4590
4591              --strip-options OPTS
4592                     give extra options to strip
4593
4594              --tar-options OPTS
4595                     give extra options to tar
4596
4597              --uhc-options OPTS
4598                     give extra options to uhc
4599
4600              --only
4601                     Don't reinstall add-source dependencies (sandbox-only)
4602
4603
4604       cabal new-configure
4605
4606       Usage: cabal new-configure [FLAGS]
4607
4608
4609       Adjust how the project is built by setting additional package flags and
4610       other flags.
4611
4612       The configuration options are written to the 'cabal.project.local' file
4613       (or configuration from the 'cabal.project' file (if any). This combina‐
4614       tion is used as the project configuration for all other commands  (such
4615       as 'new-build',
4616
4617       The  new-configure  command  also checks that the project configuration
4618       will work. In particular it checks that there is a  consistent  set  of
4619       dependencies for the project as a whole.
4620
4621       The 'cabal.project.local' file persists across 'new-clean' but is over‐
4622       written on the next use of the 'new-configure' command.  The  intention
4623       is that the
4624
4625       It  is never necessary to use the 'new-configure' command. It is merely
4626       a convenience in cases where you do not want to specify flags to  'new-
4627       build' (and other commands) every time and yet do not want to alter the
4628
4629
4630       Examples:
4631         cabal new-configure --with-compiler ghc-7.10.3
4632           Adjust the project configuration to use the given compiler
4633           program and check the resulting configuration works.
4634         cabal new-configure
4635           Reset the local configuration to empty and check the overall
4636           project configuration works.
4637
4638       Note:  this  command  is part of the new project-based system (aka nix-
4639       style local builds). These features are currently in beta.  Please  see
4640       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
4641       details and advice on what you can expect to  work.  If  you  encounter
4642       problems  please file issues at https://github.com/haskell/cabal/issues
4643       and if you have any time to get involved and help with testing,  fixing
4644       bugs etc then that is very much appreciated.
4645
4646
4647       Flags:
4648              -v, --verbose [n]
4649                     Control  verbosity (n is 0--3, default verbosity level is
4650                     1)
4651
4652              --builddir, --distdir, --distpref DIR
4653                     The directory where  Cabal  puts  generated  build  files
4654                     (default dist)
4655
4656              -g, --ghc
4657                     compile with GHC
4658
4659              --ghcjs
4660                     compile with GHCJS
4661
4662              --jhc
4663                     compile with JHC
4664
4665              --lhc
4666                     compile with LHC
4667
4668              --uhc
4669                     compile with UHC
4670
4671              --haskell-suite
4672                     compile with a haskell-suite compiler
4673
4674              --cabal-file PATH
4675                     use this Cabal file
4676
4677              -w, --with-compiler PATH
4678                     give the path to a particular compiler
4679
4680              --with-hc-pkg PATH
4681                     give the path to the package tool
4682
4683              --prefix DIR
4684                     bake this prefix in preparation of installation
4685
4686              --bindir DIR
4687                     installation directory for executables
4688
4689              --libdir DIR
4690                     installation directory for libraries
4691
4692              --libsubdir DIR
4693                     subdirectory of libdir in which libs are installed
4694
4695              --dynlibdir DIR
4696                     installation directory for dynamic libraries
4697
4698              --libexecdir DIR
4699                     installation directory for program executables
4700
4701              --libexecsubdir DIR
4702                     subdirectory  of  libexecdir in which private executables
4703                     are installed
4704
4705              --datadir DIR
4706                     installation directory for read-only data
4707
4708              --datasubdir DIR
4709                     subdirectory of datadir in which data files are installed
4710
4711              --docdir DIR
4712                     installation directory for documentation
4713
4714              --htmldir DIR
4715                     installation directory for HTML documentation
4716
4717              --haddockdir DIR
4718                     installation directory for haddock interfaces
4719
4720              --sysconfdir DIR
4721                     installation directory for configuration files
4722
4723              --program-prefix PREFIX
4724                     prefix to be applied to installed executables
4725
4726              --program-suffix SUFFIX
4727                     suffix to be applied to installed executables
4728
4729              --enable-library-vanilla
4730              --disable-library-vanilla
4731                     Vanilla libraries
4732
4733              -p, --enable-library-profiling
4734              --disable-library-profiling
4735                     Library profiling
4736
4737              --enable-shared
4738              --disable-shared
4739                     Shared library
4740
4741              --enable-static
4742              --disable-static
4743                     Static library
4744
4745              --enable-executable-dynamic
4746              --disable-executable-dynamic
4747                     Executable dynamic linking
4748
4749              --enable-profiling
4750              --disable-profiling
4751                     Executable and library profiling
4752
4753              --enable-executable-profiling
4754              --disable-executable-profiling
4755                     Executable profiling (DEPRECATED)
4756
4757              --profiling-detail level
4758                     Profiling  detail  level  for  executable   and   library
4759                     (default,  none,  exported-functions, toplevel-functions,
4760                     all-functions).
4761
4762              --library-profiling-detail level
4763                     Profiling detail level for libraries only.
4764
4765              -O, --enable-optimization, --enable-optimisation [n]
4766                     Build with optimization (n is 0--2, default is 1)
4767
4768              --disable-optimization, --disable-optimisation
4769                     Build without optimization
4770
4771              --enable-debug-info [n]
4772                     Emit debug info (n is 0--3, default is 0)
4773
4774              --disable-debug-info
4775                     Don't emit debug info
4776
4777              --enable-library-for-ghci
4778              --disable-library-for-ghci
4779                     compile library for use with GHCi
4780
4781              --enable-split-sections
4782              --disable-split-sections
4783                     compile library code such that unneeded  definitions  can
4784                     be dropped from the final executable (GHC 7.8+)
4785
4786              --enable-split-objs
4787              --disable-split-objs
4788                     split library into smaller objects to reduce binary sizes
4789                     (GHC 6.6+)
4790
4791              --enable-executable-stripping
4792              --disable-executable-stripping
4793                     strip executables  upon  installation  to  reduce  binary
4794                     sizes
4795
4796              --enable-library-stripping
4797              --disable-library-stripping
4798                     strip libraries upon installation to reduce binary sizes
4799
4800              --configure-option OPT
4801                     Extra option for configure
4802
4803              --user
4804              --global
4805                     doing a per-user installation
4806
4807              --package-db DB
4808                     Append  the given package database to the list of package
4809                     databases used  (to  satisfy  dependencies  and  register
4810                     into).  May  be  a specific file, 'global' or 'user'. The
4811                     initial  list  is  ['global'],  ['global',  'user'],   or
4812                     ['global',  $sandbox],  depending on context. Use 'clear'
4813                     to reset the list  to  empty.  See  the  user  guide  for
4814                     details.
4815
4816              -f, --flags FLAGS
4817                     Force values for the given flags in Cabal conditionals in
4818                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
4819                     forces  the  flag "debug" to true and "usebytestrings" to
4820                     false.
4821
4822              --extra-include-dirs PATH
4823                     A list of directories to search for header files
4824
4825              --enable-deterministic
4826              --disable-deterministic
4827                     Try to be as deterministic as possible (used by the  test
4828                     suite)
4829
4830              --ipid IPID
4831                     Installed package ID to compile this package as
4832
4833              --cid CID
4834                     Installed component ID to compile this component as
4835
4836              --extra-lib-dirs PATH
4837                     A list of directories to search for external libraries
4838
4839              --extra-framework-dirs PATH
4840                     A  list  of directories to search for external frameworks
4841                     (OS X only)
4842
4843              --extra-prog-path PATH
4844                     A list of directories to search for required programs (in
4845                     addition to the normal search locations)
4846
4847              --instantiate-with NAME=MOD
4848                     A mapping of signature names to concrete module instanti‐
4849                     ations.
4850
4851              --enable-tests
4852              --disable-tests
4853                     dependency  checking  and  compilation  for  test  suites
4854                     listed in the package description file.
4855
4856              --enable-coverage
4857              --disable-coverage
4858                     build package with Haskell Program Coverage. (GHC only)
4859
4860              --enable-library-coverage
4861              --disable-library-coverage
4862                     build  package  with Haskell Program Coverage. (GHC only)
4863                     (DEPRECATED)
4864
4865              --enable-benchmarks
4866              --disable-benchmarks
4867                     dependency checking and compilation for benchmarks listed
4868                     in the package description file.
4869
4870              --enable-relocatable
4871              --disable-relocatable
4872                     building a package that is relocatable. (GHC only)
4873
4874              --disable-response-files
4875                     enable  workaround for old versions of programs like "ar"
4876                     that do not support @file arguments
4877
4878              --with-alex PATH
4879                     give the path to alex
4880
4881              --with-ar PATH
4882                     give the path to ar
4883
4884              --with-c2hs PATH
4885                     give the path to c2hs
4886
4887              --with-cpphs PATH
4888                     give the path to cpphs
4889
4890              --with-doctest PATH
4891                     give the path to doctest
4892
4893              --with-gcc PATH
4894                     give the path to gcc
4895
4896              --with-ghc PATH
4897                     give the path to ghc
4898
4899              --with-ghc-pkg PATH
4900                     give the path to ghc-pkg
4901
4902              --with-ghcjs PATH
4903                     give the path to ghcjs
4904
4905              --with-ghcjs-pkg PATH
4906                     give the path to ghcjs-pkg
4907
4908              --with-greencard PATH
4909                     give the path to greencard
4910
4911              --with-haddock PATH
4912                     give the path to haddock
4913
4914              --with-happy PATH
4915                     give the path to happy
4916
4917              --with-haskell-suite PATH
4918                     give the path to haskell-suite
4919
4920              --with-haskell-suite-pkg PATH
4921                     give the path to haskell-suite-pkg
4922
4923              --with-hmake PATH
4924                     give the path to hmake
4925
4926              --with-hpc PATH
4927                     give the path to hpc
4928
4929              --with-hsc2hs PATH
4930                     give the path to hsc2hs
4931
4932              --with-hscolour PATH
4933                     give the path to hscolour
4934
4935              --with-jhc PATH
4936                     give the path to jhc
4937
4938              --with-ld PATH
4939                     give the path to ld
4940
4941              --with-lhc PATH
4942                     give the path to lhc
4943
4944              --with-lhc-pkg PATH
4945                     give the path to lhc-pkg
4946
4947              --with-pkg-config PATH
4948                     give the path to pkg-config
4949
4950              --with-runghc PATH
4951                     give the path to runghc
4952
4953              --with-strip PATH
4954                     give the path to strip
4955
4956              --with-tar PATH
4957                     give the path to tar
4958
4959              --with-uhc PATH
4960                     give the path to uhc
4961
4962              --alex-option OPT
4963                     give an extra option to alex (no need  to  quote  options
4964                     containing spaces)
4965
4966              --ar-option OPT
4967                     give an extra option to ar (no need to quote options con‐
4968                     taining spaces)
4969
4970              --c2hs-option OPT
4971                     give an extra option to c2hs (no need  to  quote  options
4972                     containing spaces)
4973
4974              --cpphs-option OPT
4975                     give  an  extra option to cpphs (no need to quote options
4976                     containing spaces)
4977
4978              --doctest-option OPT
4979                     give an extra option to doctest (no need to quote options
4980                     containing spaces)
4981
4982              --gcc-option OPT
4983                     give  an  extra  option  to gcc (no need to quote options
4984                     containing spaces)
4985
4986              --ghc-option OPT
4987                     give an extra option to ghc (no  need  to  quote  options
4988                     containing spaces)
4989
4990              --ghc-pkg-option OPT
4991                     give an extra option to ghc-pkg (no need to quote options
4992                     containing spaces)
4993
4994              --ghcjs-option OPT
4995                     give an extra option to ghcjs (no need to  quote  options
4996                     containing spaces)
4997
4998              --ghcjs-pkg-option OPT
4999                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
5000                     options containing spaces)
5001
5002              --greencard-option OPT
5003                     give an extra option  to  greencard  (no  need  to  quote
5004                     options containing spaces)
5005
5006              --haddock-option OPT
5007                     give an extra option to haddock (no need to quote options
5008                     containing spaces)
5009
5010              --happy-option OPT
5011                     give an extra option to happy (no need to  quote  options
5012                     containing spaces)
5013
5014              --haskell-suite-option OPT
5015                     give  an  extra option to haskell-suite (no need to quote
5016                     options containing spaces)
5017
5018              --haskell-suite-pkg-option OPT
5019                     give an extra option to  haskell-suite-pkg  (no  need  to
5020                     quote options containing spaces)
5021
5022              --hmake-option OPT
5023                     give  an  extra option to hmake (no need to quote options
5024                     containing spaces)
5025
5026              --hpc-option OPT
5027                     give an extra option to hpc (no  need  to  quote  options
5028                     containing spaces)
5029
5030              --hsc2hs-option OPT
5031                     give  an extra option to hsc2hs (no need to quote options
5032                     containing spaces)
5033
5034              --hscolour-option OPT
5035                     give an extra  option  to  hscolour  (no  need  to  quote
5036                     options containing spaces)
5037
5038              --jhc-option OPT
5039                     give  an  extra  option  to jhc (no need to quote options
5040                     containing spaces)
5041
5042              --ld-option OPT
5043                     give an extra option to ld (no need to quote options con‐
5044                     taining spaces)
5045
5046              --lhc-option OPT
5047                     give  an  extra  option  to lhc (no need to quote options
5048                     containing spaces)
5049
5050              --lhc-pkg-option OPT
5051                     give an extra option to lhc-pkg (no need to quote options
5052                     containing spaces)
5053
5054              --pkg-config-option OPT
5055                     give  an  extra  option  to  pkg-config (no need to quote
5056                     options containing spaces)
5057
5058              --runghc-option OPT
5059                     give an extra option to runghc (no need to quote  options
5060                     containing spaces)
5061
5062              --strip-option OPT
5063                     give  an  extra option to strip (no need to quote options
5064                     containing spaces)
5065
5066              --tar-option OPT
5067                     give an extra option to tar (no  need  to  quote  options
5068                     containing spaces)
5069
5070              --uhc-option OPT
5071                     give  an  extra  option  to uhc (no need to quote options
5072                     containing spaces)
5073
5074              --alex-options OPTS
5075                     give extra options to alex
5076
5077              --ar-options OPTS
5078                     give extra options to ar
5079
5080              --c2hs-options OPTS
5081                     give extra options to c2hs
5082
5083              --cpphs-options OPTS
5084                     give extra options to cpphs
5085
5086              --doctest-options OPTS
5087                     give extra options to doctest
5088
5089              --gcc-options OPTS
5090                     give extra options to gcc
5091
5092              --ghc-options OPTS
5093                     give extra options to ghc
5094
5095              --ghc-pkg-options OPTS
5096                     give extra options to ghc-pkg
5097
5098              --ghcjs-options OPTS
5099                     give extra options to ghcjs
5100
5101              --ghcjs-pkg-options OPTS
5102                     give extra options to ghcjs-pkg
5103
5104              --greencard-options OPTS
5105                     give extra options to greencard
5106
5107              --haddock-options OPTS
5108                     give extra options to haddock
5109
5110              --happy-options OPTS
5111                     give extra options to happy
5112
5113              --haskell-suite-options OPTS
5114                     give extra options to haskell-suite
5115
5116              --haskell-suite-pkg-options OPTS
5117                     give extra options to haskell-suite-pkg
5118
5119              --hmake-options OPTS
5120                     give extra options to hmake
5121
5122              --hpc-options OPTS
5123                     give extra options to hpc
5124
5125              --hsc2hs-options OPTS
5126                     give extra options to hsc2hs
5127
5128              --hscolour-options OPTS
5129                     give extra options to hscolour
5130
5131              --jhc-options OPTS
5132                     give extra options to jhc
5133
5134              --ld-options OPTS
5135                     give extra options to ld
5136
5137              --lhc-options OPTS
5138                     give extra options to lhc
5139
5140              --lhc-pkg-options OPTS
5141                     give extra options to lhc-pkg
5142
5143              --pkg-config-options OPTS
5144                     give extra options to pkg-config
5145
5146              --runghc-options OPTS
5147                     give extra options to runghc
5148
5149              --strip-options OPTS
5150                     give extra options to strip
5151
5152              --tar-options OPTS
5153                     give extra options to tar
5154
5155              --uhc-options OPTS
5156                     give extra options to uhc
5157
5158              --cabal-lib-version VERSION
5159                     Select which version of the Cabal lib  to  use  to  build
5160                     packages (useful for testing).
5161
5162              --constraint CONSTRAINT
5163                     Specify    constraints    on    a    package    (version,
5164                     installed/source, flags)
5165
5166              --preference CONSTRAINT
5167                     Specify preferences (soft constraints) on the version  of
5168                     a package
5169
5170              --solver SOLVER
5171                     Select  dependency  solver  to  use  (default:  modular).
5172                     Choices: modular.
5173
5174              --allow-older [DEPS]
5175                     Ignore lower bounds in all dependencies or DEPS
5176
5177              --allow-newer [DEPS]
5178                     Ignore upper bounds in all dependencies or DEPS
5179
5180              --enable-documentation
5181              --disable-documentation
5182                     building of documentation
5183
5184              --doc-index-file TEMPLATE
5185                     A central index of haddock  API  documentation  (template
5186                     cannot use $pkgid)
5187
5188              --dry-run
5189                     Do  not  install  anything,  only  print  what  would  be
5190                     installed.
5191
5192              --max-backjumps NUM
5193                     Maximum  number  of  backjumps  allowed   while   solving
5194                     (default:  2000).  Use a negative number to enable unlim‐
5195                     ited backtracking. Use 0  to  disable  backtracking  com‐
5196                     pletely.
5197
5198              --reorder-goals
5199              --no-reorder-goals
5200                     Try  to  reorder  goals  according to certain heuristics.
5201                     Slows things down on average, but may  make  backtracking
5202                     faster for some packages.
5203
5204              --count-conflicts
5205              --no-count-conflicts
5206                     Try  to  speed  up  solving  by preferring goals that are
5207                     involved in a lot of conflicts (default).
5208
5209              --independent-goals
5210              --no-independent-goals
5211                     Treat several goals on the command line  as  independent.
5212                     If  several  goals  depend on the same package, different
5213                     versions can be chosen.
5214
5215              --shadow-installed-packages
5216              --no-shadow-installed-packages
5217                     If multiple package instances of  the  same  version  are
5218                     installed, treat all but one as shadowed.
5219
5220              --strong-flags
5221              --no-strong-flags
5222                     Do not defer flag choices (this used to be the default in
5223                     cabal-install <= 1.20).
5224
5225              --allow-boot-library-installs
5226              --no-allow-boot-library-installs
5227                     Allow cabal to install  base,  ghc-prim,  integer-simple,
5228                     integer-gmp, and template-haskell.
5229
5230              --reinstall
5231              --no-reinstall
5232                     Install  even  if  it  means  installing the same version
5233                     again.
5234
5235              --avoid-reinstalls
5236              --no-avoid-reinstalls
5237                     Do not select versions that would destructively overwrite
5238                     installed packages.
5239
5240              --force-reinstalls
5241              --no-force-reinstalls
5242                     Reinstall  packages  even  if they will most likely break
5243                     other installed packages.
5244
5245              --upgrade-dependencies
5246              --no-upgrade-dependencies
5247                     Pick the latest version for all dependencies, rather than
5248                     trying to pick an installed version.
5249
5250              --only-dependencies
5251              --no-only-dependencies
5252                     Install  only  the  dependencies  necessary  to build the
5253                     given packages
5254
5255              --dependencies-only
5256              --no-dependencies-only
5257                     A synonym for --only-dependencies
5258
5259              --index-state STATE
5260                     Use source package index state as it existed at a  previ‐
5261                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
5262                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
5263                     'HEAD' (default: 'HEAD').
5264
5265              --root-cmd COMMAND
5266                     (No longer supported, do not use.)
5267
5268              --symlink-bindir DIR
5269                     Add  symlinks  to  installed executables into this direc‐
5270                     tory.
5271
5272              --build-summary TEMPLATE
5273                     Save build summaries  to  file  (name  template  can  use
5274                     $pkgid, $compiler, $os, $arch)
5275
5276              --build-log TEMPLATE
5277                     Log  all  builds  to  file (name template can use $pkgid,
5278                     $compiler, $os, $arch)
5279
5280              --remote-build-reporting LEVEL
5281                     Generate build reports to send to a remote server  (none,
5282                     anonymous or detailed).
5283
5284              --report-planning-failure
5285                     Generate  build reports when the dependency solver fails.
5286                     This is used by the Hackage build bot.
5287
5288              --enable-per-component
5289              --disable-per-component
5290                     Per-component builds when possible
5291
5292              --one-shot
5293              --no-one-shot
5294                     Do not record the packages in the world file.
5295
5296              --run-tests
5297                     Run package test suites during installation.
5298
5299              -j, --jobs [NUM]
5300                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
5301                     given).
5302
5303              --keep-going
5304                     After a build failure, continue to build other unaffected
5305                     packages.
5306
5307              --offline
5308              --no-offline
5309                     Don't download packages from the Internet.
5310
5311              --project-file FILE
5312                     Set the name of the cabal.project file to search  for  in
5313                     parent directories
5314
5315              --only
5316                     Only installs the package in the current directory.
5317
5318              --haddock-hoogle
5319                     Generate a hoogle database
5320
5321              --haddock-html
5322                     Generate HTML documentation (the default)
5323
5324              --haddock-html-location URL
5325                     Location of HTML documentation for pre-requisite packages
5326
5327              --haddock-for-hackage
5328                     Collection  of  flags  to generate documentation suitable
5329                     for upload to hackage
5330
5331              --haddock-executables
5332                     Run haddock for Executables targets
5333
5334              --haddock-tests
5335                     Run haddock for Test Suite targets
5336
5337              --haddock-benchmarks
5338                     Run haddock for Benchmark targets
5339
5340              --haddock-all
5341                     Run haddock for all targets
5342
5343              --haddock-internal
5344                     Run haddock for internal modules and include all symbols
5345
5346              --haddock-css PATH
5347                     Use PATH as the haddock stylesheet
5348
5349              --haddock-hyperlink-source, --haddock-hyperlink-sources
5350                     Hyperlink the documentation to the source code
5351
5352              --haddock-hscolour-css PATH
5353                     Use PATH as the HsColour stylesheet
5354
5355              --haddock-contents-location URL
5356                     Bake URL in as the location for the contents page
5357
5358
5359       cabal new-update
5360
5361       Usage: cabal new-update [FLAGS] [REPOS]
5362
5363
5364       For all known remote repositories, download the package list.
5365
5366
5367       REPO has the format <repo-id>[,<index-state>] where index-state follows
5368       the same format and syntax that is supported by the --index-state flag.
5369
5370       Examples:
5371         cabal new-update
5372           Download the package list for all known remote repositories.
5373
5374         cabal new-update hackage.haskell.org,@1474732068
5375         cabal new-update hackage.haskell.org,2016-09-24T17:47:48Z
5376         cabal new-update hackage.haskell.org,HEAD
5377         cabal new-update hackage.haskell.org
5378           Download hackage.haskell.org at a specific index state.
5379
5380         cabal new update hackage.haskell.org head.hackage
5381           Download hackage.haskell.org and head.hackage
5382           head.hackage must be a known repo-id. E.g. from
5383           your cabal.project(.local) file.
5384
5385       Note:  this  command  is part of the new project-based system (aka nix-
5386       style local builds). These features are currently in beta.  Please  see
5387       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
5388       details and advice on what you can expect to  work.  If  you  encounter
5389       problems  please file issues at https://github.com/haskell/cabal/issues
5390       and if you have any time to get involved and help with testing,  fixing
5391       bugs etc then that is very much appreciated.
5392
5393
5394       Flags:
5395              -v, --verbose [n]
5396                     Control  verbosity (n is 0--3, default verbosity level is
5397                     1)
5398
5399              --builddir, --distdir, --distpref DIR
5400                     The directory where  Cabal  puts  generated  build  files
5401                     (default dist)
5402
5403              -g, --ghc
5404                     compile with GHC
5405
5406              --ghcjs
5407                     compile with GHCJS
5408
5409              --jhc
5410                     compile with JHC
5411
5412              --lhc
5413                     compile with LHC
5414
5415              --uhc
5416                     compile with UHC
5417
5418              --haskell-suite
5419                     compile with a haskell-suite compiler
5420
5421              --cabal-file PATH
5422                     use this Cabal file
5423
5424              -w, --with-compiler PATH
5425                     give the path to a particular compiler
5426
5427              --with-hc-pkg PATH
5428                     give the path to the package tool
5429
5430              --prefix DIR
5431                     bake this prefix in preparation of installation
5432
5433              --bindir DIR
5434                     installation directory for executables
5435
5436              --libdir DIR
5437                     installation directory for libraries
5438
5439              --libsubdir DIR
5440                     subdirectory of libdir in which libs are installed
5441
5442              --dynlibdir DIR
5443                     installation directory for dynamic libraries
5444
5445              --libexecdir DIR
5446                     installation directory for program executables
5447
5448              --libexecsubdir DIR
5449                     subdirectory  of  libexecdir in which private executables
5450                     are installed
5451
5452              --datadir DIR
5453                     installation directory for read-only data
5454
5455              --datasubdir DIR
5456                     subdirectory of datadir in which data files are installed
5457
5458              --docdir DIR
5459                     installation directory for documentation
5460
5461              --htmldir DIR
5462                     installation directory for HTML documentation
5463
5464              --haddockdir DIR
5465                     installation directory for haddock interfaces
5466
5467              --sysconfdir DIR
5468                     installation directory for configuration files
5469
5470              --program-prefix PREFIX
5471                     prefix to be applied to installed executables
5472
5473              --program-suffix SUFFIX
5474                     suffix to be applied to installed executables
5475
5476              --enable-library-vanilla
5477              --disable-library-vanilla
5478                     Vanilla libraries
5479
5480              -p, --enable-library-profiling
5481              --disable-library-profiling
5482                     Library profiling
5483
5484              --enable-shared
5485              --disable-shared
5486                     Shared library
5487
5488              --enable-static
5489              --disable-static
5490                     Static library
5491
5492              --enable-executable-dynamic
5493              --disable-executable-dynamic
5494                     Executable dynamic linking
5495
5496              --enable-profiling
5497              --disable-profiling
5498                     Executable and library profiling
5499
5500              --enable-executable-profiling
5501              --disable-executable-profiling
5502                     Executable profiling (DEPRECATED)
5503
5504              --profiling-detail level
5505                     Profiling  detail  level  for  executable   and   library
5506                     (default,  none,  exported-functions, toplevel-functions,
5507                     all-functions).
5508
5509              --library-profiling-detail level
5510                     Profiling detail level for libraries only.
5511
5512              -O, --enable-optimization, --enable-optimisation [n]
5513                     Build with optimization (n is 0--2, default is 1)
5514
5515              --disable-optimization, --disable-optimisation
5516                     Build without optimization
5517
5518              --enable-debug-info [n]
5519                     Emit debug info (n is 0--3, default is 0)
5520
5521              --disable-debug-info
5522                     Don't emit debug info
5523
5524              --enable-library-for-ghci
5525              --disable-library-for-ghci
5526                     compile library for use with GHCi
5527
5528              --enable-split-sections
5529              --disable-split-sections
5530                     compile library code such that unneeded  definitions  can
5531                     be dropped from the final executable (GHC 7.8+)
5532
5533              --enable-split-objs
5534              --disable-split-objs
5535                     split library into smaller objects to reduce binary sizes
5536                     (GHC 6.6+)
5537
5538              --enable-executable-stripping
5539              --disable-executable-stripping
5540                     strip executables  upon  installation  to  reduce  binary
5541                     sizes
5542
5543              --enable-library-stripping
5544              --disable-library-stripping
5545                     strip libraries upon installation to reduce binary sizes
5546
5547              --configure-option OPT
5548                     Extra option for configure
5549
5550              --user
5551              --global
5552                     doing a per-user installation
5553
5554              --package-db DB
5555                     Append  the given package database to the list of package
5556                     databases used  (to  satisfy  dependencies  and  register
5557                     into).  May  be  a specific file, 'global' or 'user'. The
5558                     initial  list  is  ['global'],  ['global',  'user'],   or
5559                     ['global',  $sandbox],  depending on context. Use 'clear'
5560                     to reset the list  to  empty.  See  the  user  guide  for
5561                     details.
5562
5563              -f, --flags FLAGS
5564                     Force values for the given flags in Cabal conditionals in
5565                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
5566                     forces  the  flag "debug" to true and "usebytestrings" to
5567                     false.
5568
5569              --extra-include-dirs PATH
5570                     A list of directories to search for header files
5571
5572              --enable-deterministic
5573              --disable-deterministic
5574                     Try to be as deterministic as possible (used by the  test
5575                     suite)
5576
5577              --ipid IPID
5578                     Installed package ID to compile this package as
5579
5580              --cid CID
5581                     Installed component ID to compile this component as
5582
5583              --extra-lib-dirs PATH
5584                     A list of directories to search for external libraries
5585
5586              --extra-framework-dirs PATH
5587                     A  list  of directories to search for external frameworks
5588                     (OS X only)
5589
5590              --extra-prog-path PATH
5591                     A list of directories to search for required programs (in
5592                     addition to the normal search locations)
5593
5594              --instantiate-with NAME=MOD
5595                     A mapping of signature names to concrete module instanti‐
5596                     ations.
5597
5598              --enable-tests
5599              --disable-tests
5600                     dependency  checking  and  compilation  for  test  suites
5601                     listed in the package description file.
5602
5603              --enable-coverage
5604              --disable-coverage
5605                     build package with Haskell Program Coverage. (GHC only)
5606
5607              --enable-library-coverage
5608              --disable-library-coverage
5609                     build  package  with Haskell Program Coverage. (GHC only)
5610                     (DEPRECATED)
5611
5612              --enable-benchmarks
5613              --disable-benchmarks
5614                     dependency checking and compilation for benchmarks listed
5615                     in the package description file.
5616
5617              --enable-relocatable
5618              --disable-relocatable
5619                     building a package that is relocatable. (GHC only)
5620
5621              --disable-response-files
5622                     enable  workaround for old versions of programs like "ar"
5623                     that do not support @file arguments
5624
5625              --with-alex PATH
5626                     give the path to alex
5627
5628              --with-ar PATH
5629                     give the path to ar
5630
5631              --with-c2hs PATH
5632                     give the path to c2hs
5633
5634              --with-cpphs PATH
5635                     give the path to cpphs
5636
5637              --with-doctest PATH
5638                     give the path to doctest
5639
5640              --with-gcc PATH
5641                     give the path to gcc
5642
5643              --with-ghc PATH
5644                     give the path to ghc
5645
5646              --with-ghc-pkg PATH
5647                     give the path to ghc-pkg
5648
5649              --with-ghcjs PATH
5650                     give the path to ghcjs
5651
5652              --with-ghcjs-pkg PATH
5653                     give the path to ghcjs-pkg
5654
5655              --with-greencard PATH
5656                     give the path to greencard
5657
5658              --with-haddock PATH
5659                     give the path to haddock
5660
5661              --with-happy PATH
5662                     give the path to happy
5663
5664              --with-haskell-suite PATH
5665                     give the path to haskell-suite
5666
5667              --with-haskell-suite-pkg PATH
5668                     give the path to haskell-suite-pkg
5669
5670              --with-hmake PATH
5671                     give the path to hmake
5672
5673              --with-hpc PATH
5674                     give the path to hpc
5675
5676              --with-hsc2hs PATH
5677                     give the path to hsc2hs
5678
5679              --with-hscolour PATH
5680                     give the path to hscolour
5681
5682              --with-jhc PATH
5683                     give the path to jhc
5684
5685              --with-ld PATH
5686                     give the path to ld
5687
5688              --with-lhc PATH
5689                     give the path to lhc
5690
5691              --with-lhc-pkg PATH
5692                     give the path to lhc-pkg
5693
5694              --with-pkg-config PATH
5695                     give the path to pkg-config
5696
5697              --with-runghc PATH
5698                     give the path to runghc
5699
5700              --with-strip PATH
5701                     give the path to strip
5702
5703              --with-tar PATH
5704                     give the path to tar
5705
5706              --with-uhc PATH
5707                     give the path to uhc
5708
5709              --alex-option OPT
5710                     give an extra option to alex (no need  to  quote  options
5711                     containing spaces)
5712
5713              --ar-option OPT
5714                     give an extra option to ar (no need to quote options con‐
5715                     taining spaces)
5716
5717              --c2hs-option OPT
5718                     give an extra option to c2hs (no need  to  quote  options
5719                     containing spaces)
5720
5721              --cpphs-option OPT
5722                     give  an  extra option to cpphs (no need to quote options
5723                     containing spaces)
5724
5725              --doctest-option OPT
5726                     give an extra option to doctest (no need to quote options
5727                     containing spaces)
5728
5729              --gcc-option OPT
5730                     give  an  extra  option  to gcc (no need to quote options
5731                     containing spaces)
5732
5733              --ghc-option OPT
5734                     give an extra option to ghc (no  need  to  quote  options
5735                     containing spaces)
5736
5737              --ghc-pkg-option OPT
5738                     give an extra option to ghc-pkg (no need to quote options
5739                     containing spaces)
5740
5741              --ghcjs-option OPT
5742                     give an extra option to ghcjs (no need to  quote  options
5743                     containing spaces)
5744
5745              --ghcjs-pkg-option OPT
5746                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
5747                     options containing spaces)
5748
5749              --greencard-option OPT
5750                     give an extra option  to  greencard  (no  need  to  quote
5751                     options containing spaces)
5752
5753              --haddock-option OPT
5754                     give an extra option to haddock (no need to quote options
5755                     containing spaces)
5756
5757              --happy-option OPT
5758                     give an extra option to happy (no need to  quote  options
5759                     containing spaces)
5760
5761              --haskell-suite-option OPT
5762                     give  an  extra option to haskell-suite (no need to quote
5763                     options containing spaces)
5764
5765              --haskell-suite-pkg-option OPT
5766                     give an extra option to  haskell-suite-pkg  (no  need  to
5767                     quote options containing spaces)
5768
5769              --hmake-option OPT
5770                     give  an  extra option to hmake (no need to quote options
5771                     containing spaces)
5772
5773              --hpc-option OPT
5774                     give an extra option to hpc (no  need  to  quote  options
5775                     containing spaces)
5776
5777              --hsc2hs-option OPT
5778                     give  an extra option to hsc2hs (no need to quote options
5779                     containing spaces)
5780
5781              --hscolour-option OPT
5782                     give an extra  option  to  hscolour  (no  need  to  quote
5783                     options containing spaces)
5784
5785              --jhc-option OPT
5786                     give  an  extra  option  to jhc (no need to quote options
5787                     containing spaces)
5788
5789              --ld-option OPT
5790                     give an extra option to ld (no need to quote options con‐
5791                     taining spaces)
5792
5793              --lhc-option OPT
5794                     give  an  extra  option  to lhc (no need to quote options
5795                     containing spaces)
5796
5797              --lhc-pkg-option OPT
5798                     give an extra option to lhc-pkg (no need to quote options
5799                     containing spaces)
5800
5801              --pkg-config-option OPT
5802                     give  an  extra  option  to  pkg-config (no need to quote
5803                     options containing spaces)
5804
5805              --runghc-option OPT
5806                     give an extra option to runghc (no need to quote  options
5807                     containing spaces)
5808
5809              --strip-option OPT
5810                     give  an  extra option to strip (no need to quote options
5811                     containing spaces)
5812
5813              --tar-option OPT
5814                     give an extra option to tar (no  need  to  quote  options
5815                     containing spaces)
5816
5817              --uhc-option OPT
5818                     give  an  extra  option  to uhc (no need to quote options
5819                     containing spaces)
5820
5821              --alex-options OPTS
5822                     give extra options to alex
5823
5824              --ar-options OPTS
5825                     give extra options to ar
5826
5827              --c2hs-options OPTS
5828                     give extra options to c2hs
5829
5830              --cpphs-options OPTS
5831                     give extra options to cpphs
5832
5833              --doctest-options OPTS
5834                     give extra options to doctest
5835
5836              --gcc-options OPTS
5837                     give extra options to gcc
5838
5839              --ghc-options OPTS
5840                     give extra options to ghc
5841
5842              --ghc-pkg-options OPTS
5843                     give extra options to ghc-pkg
5844
5845              --ghcjs-options OPTS
5846                     give extra options to ghcjs
5847
5848              --ghcjs-pkg-options OPTS
5849                     give extra options to ghcjs-pkg
5850
5851              --greencard-options OPTS
5852                     give extra options to greencard
5853
5854              --haddock-options OPTS
5855                     give extra options to haddock
5856
5857              --happy-options OPTS
5858                     give extra options to happy
5859
5860              --haskell-suite-options OPTS
5861                     give extra options to haskell-suite
5862
5863              --haskell-suite-pkg-options OPTS
5864                     give extra options to haskell-suite-pkg
5865
5866              --hmake-options OPTS
5867                     give extra options to hmake
5868
5869              --hpc-options OPTS
5870                     give extra options to hpc
5871
5872              --hsc2hs-options OPTS
5873                     give extra options to hsc2hs
5874
5875              --hscolour-options OPTS
5876                     give extra options to hscolour
5877
5878              --jhc-options OPTS
5879                     give extra options to jhc
5880
5881              --ld-options OPTS
5882                     give extra options to ld
5883
5884              --lhc-options OPTS
5885                     give extra options to lhc
5886
5887              --lhc-pkg-options OPTS
5888                     give extra options to lhc-pkg
5889
5890              --pkg-config-options OPTS
5891                     give extra options to pkg-config
5892
5893              --runghc-options OPTS
5894                     give extra options to runghc
5895
5896              --strip-options OPTS
5897                     give extra options to strip
5898
5899              --tar-options OPTS
5900                     give extra options to tar
5901
5902              --uhc-options OPTS
5903                     give extra options to uhc
5904
5905              --cabal-lib-version VERSION
5906                     Select which version of the Cabal lib  to  use  to  build
5907                     packages (useful for testing).
5908
5909              --constraint CONSTRAINT
5910                     Specify    constraints    on    a    package    (version,
5911                     installed/source, flags)
5912
5913              --preference CONSTRAINT
5914                     Specify preferences (soft constraints) on the version  of
5915                     a package
5916
5917              --solver SOLVER
5918                     Select  dependency  solver  to  use  (default:  modular).
5919                     Choices: modular.
5920
5921              --allow-older [DEPS]
5922                     Ignore lower bounds in all dependencies or DEPS
5923
5924              --allow-newer [DEPS]
5925                     Ignore upper bounds in all dependencies or DEPS
5926
5927              --enable-documentation
5928              --disable-documentation
5929                     building of documentation
5930
5931              --doc-index-file TEMPLATE
5932                     A central index of haddock  API  documentation  (template
5933                     cannot use $pkgid)
5934
5935              --dry-run
5936                     Do  not  install  anything,  only  print  what  would  be
5937                     installed.
5938
5939              --max-backjumps NUM
5940                     Maximum  number  of  backjumps  allowed   while   solving
5941                     (default:  2000).  Use a negative number to enable unlim‐
5942                     ited backtracking. Use 0  to  disable  backtracking  com‐
5943                     pletely.
5944
5945              --reorder-goals
5946              --no-reorder-goals
5947                     Try  to  reorder  goals  according to certain heuristics.
5948                     Slows things down on average, but may  make  backtracking
5949                     faster for some packages.
5950
5951              --count-conflicts
5952              --no-count-conflicts
5953                     Try  to  speed  up  solving  by preferring goals that are
5954                     involved in a lot of conflicts (default).
5955
5956              --independent-goals
5957              --no-independent-goals
5958                     Treat several goals on the command line  as  independent.
5959                     If  several  goals  depend on the same package, different
5960                     versions can be chosen.
5961
5962              --shadow-installed-packages
5963              --no-shadow-installed-packages
5964                     If multiple package instances of  the  same  version  are
5965                     installed, treat all but one as shadowed.
5966
5967              --strong-flags
5968              --no-strong-flags
5969                     Do not defer flag choices (this used to be the default in
5970                     cabal-install <= 1.20).
5971
5972              --allow-boot-library-installs
5973              --no-allow-boot-library-installs
5974                     Allow cabal to install  base,  ghc-prim,  integer-simple,
5975                     integer-gmp, and template-haskell.
5976
5977              --reinstall
5978              --no-reinstall
5979                     Install  even  if  it  means  installing the same version
5980                     again.
5981
5982              --avoid-reinstalls
5983              --no-avoid-reinstalls
5984                     Do not select versions that would destructively overwrite
5985                     installed packages.
5986
5987              --force-reinstalls
5988              --no-force-reinstalls
5989                     Reinstall  packages  even  if they will most likely break
5990                     other installed packages.
5991
5992              --upgrade-dependencies
5993              --no-upgrade-dependencies
5994                     Pick the latest version for all dependencies, rather than
5995                     trying to pick an installed version.
5996
5997              --only-dependencies
5998              --no-only-dependencies
5999                     Install  only  the  dependencies  necessary  to build the
6000                     given packages
6001
6002              --dependencies-only
6003              --no-dependencies-only
6004                     A synonym for --only-dependencies
6005
6006              --index-state STATE
6007                     Use source package index state as it existed at a  previ‐
6008                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
6009                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
6010                     'HEAD' (default: 'HEAD').
6011
6012              --root-cmd COMMAND
6013                     (No longer supported, do not use.)
6014
6015              --symlink-bindir DIR
6016                     Add  symlinks  to  installed executables into this direc‐
6017                     tory.
6018
6019              --build-summary TEMPLATE
6020                     Save build summaries  to  file  (name  template  can  use
6021                     $pkgid, $compiler, $os, $arch)
6022
6023              --build-log TEMPLATE
6024                     Log  all  builds  to  file (name template can use $pkgid,
6025                     $compiler, $os, $arch)
6026
6027              --remote-build-reporting LEVEL
6028                     Generate build reports to send to a remote server  (none,
6029                     anonymous or detailed).
6030
6031              --report-planning-failure
6032                     Generate  build reports when the dependency solver fails.
6033                     This is used by the Hackage build bot.
6034
6035              --enable-per-component
6036              --disable-per-component
6037                     Per-component builds when possible
6038
6039              --one-shot
6040              --no-one-shot
6041                     Do not record the packages in the world file.
6042
6043              --run-tests
6044                     Run package test suites during installation.
6045
6046              -j, --jobs [NUM]
6047                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
6048                     given).
6049
6050              --keep-going
6051                     After a build failure, continue to build other unaffected
6052                     packages.
6053
6054              --offline
6055              --no-offline
6056                     Don't download packages from the Internet.
6057
6058              --project-file FILE
6059                     Set the name of the cabal.project file to search  for  in
6060                     parent directories
6061
6062              --only
6063                     Only installs the package in the current directory.
6064
6065              --haddock-hoogle
6066                     Generate a hoogle database
6067
6068              --haddock-html
6069                     Generate HTML documentation (the default)
6070
6071              --haddock-html-location URL
6072                     Location of HTML documentation for pre-requisite packages
6073
6074              --haddock-for-hackage
6075                     Collection  of  flags  to generate documentation suitable
6076                     for upload to hackage
6077
6078              --haddock-executables
6079                     Run haddock for Executables targets
6080
6081              --haddock-tests
6082                     Run haddock for Test Suite targets
6083
6084              --haddock-benchmarks
6085                     Run haddock for Benchmark targets
6086
6087              --haddock-all
6088                     Run haddock for all targets
6089
6090              --haddock-internal
6091                     Run haddock for internal modules and include all symbols
6092
6093              --haddock-css PATH
6094                     Use PATH as the haddock stylesheet
6095
6096              --haddock-hyperlink-source, --haddock-hyperlink-sources
6097                     Hyperlink the documentation to the source code
6098
6099              --haddock-hscolour-css PATH
6100                     Use PATH as the HsColour stylesheet
6101
6102              --haddock-contents-location URL
6103                     Bake URL in as the location for the contents page
6104
6105
6106       cabal new-build
6107
6108       Usage: cabal new-build [TARGETS] [FLAGS]
6109
6110
6111       Build one or more targets from within the project. The  available  tar‐
6112       gets  are  the packages in the project as well as individual components
6113       within those packages, including libraries, executables, test-suites or
6114       benchmarks.  Targets can be specified by name or location. If no target
6115       is specified then the default is to build the package  in  the  current
6116       directory.
6117
6118       Dependencies  are  built or rebuilt as necessary. Additional configura‐
6119       tion flags can be specified on the command line and  these  extend  the
6120       project  configuration  from the 'cabal.project', 'cabal.project.local'
6121       and other files.
6122
6123
6124       Examples:
6125         cabal new-build
6126           Build the package in the current directory or all packages  in  the
6127       project
6128         cabal new-build pkgname
6129           Build the package named pkgname in the project
6130         cabal new-build ./pkgfoo
6131           Build the package in the ./pkgfoo directory
6132         cabal new-build cname
6133           Build the component named cname in the project
6134         cabal new-build cname --enable-profiling
6135           Build  the  component  in profiling mode (including dependencies as
6136       needed)
6137
6138       Note: this command is part of the new project-based  system  (aka  nix-
6139       style  local  builds). These features are currently in beta. Please see
6140       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
6141       details  and  advice  on  what you can expect to work. If you encounter
6142       problems please file issues at  https://github.com/haskell/cabal/issues
6143       and  if you have any time to get involved and help with testing, fixing
6144       bugs etc then that is very much appreciated.
6145
6146
6147       Flags:
6148              -v, --verbose [n]
6149                     Control verbosity (n is 0--3, default verbosity level  is
6150                     1)
6151
6152              --builddir, --distdir, --distpref DIR
6153                     The  directory  where  Cabal  puts  generated build files
6154                     (default dist)
6155
6156              -g, --ghc
6157                     compile with GHC
6158
6159              --ghcjs
6160                     compile with GHCJS
6161
6162              --jhc
6163                     compile with JHC
6164
6165              --lhc
6166                     compile with LHC
6167
6168              --uhc
6169                     compile with UHC
6170
6171              --haskell-suite
6172                     compile with a haskell-suite compiler
6173
6174              --cabal-file PATH
6175                     use this Cabal file
6176
6177              -w, --with-compiler PATH
6178                     give the path to a particular compiler
6179
6180              --with-hc-pkg PATH
6181                     give the path to the package tool
6182
6183              --prefix DIR
6184                     bake this prefix in preparation of installation
6185
6186              --bindir DIR
6187                     installation directory for executables
6188
6189              --libdir DIR
6190                     installation directory for libraries
6191
6192              --libsubdir DIR
6193                     subdirectory of libdir in which libs are installed
6194
6195              --dynlibdir DIR
6196                     installation directory for dynamic libraries
6197
6198              --libexecdir DIR
6199                     installation directory for program executables
6200
6201              --libexecsubdir DIR
6202                     subdirectory of libexecdir in which  private  executables
6203                     are installed
6204
6205              --datadir DIR
6206                     installation directory for read-only data
6207
6208              --datasubdir DIR
6209                     subdirectory of datadir in which data files are installed
6210
6211              --docdir DIR
6212                     installation directory for documentation
6213
6214              --htmldir DIR
6215                     installation directory for HTML documentation
6216
6217              --haddockdir DIR
6218                     installation directory for haddock interfaces
6219
6220              --sysconfdir DIR
6221                     installation directory for configuration files
6222
6223              --program-prefix PREFIX
6224                     prefix to be applied to installed executables
6225
6226              --program-suffix SUFFIX
6227                     suffix to be applied to installed executables
6228
6229              --enable-library-vanilla
6230              --disable-library-vanilla
6231                     Vanilla libraries
6232
6233              -p, --enable-library-profiling
6234              --disable-library-profiling
6235                     Library profiling
6236
6237              --enable-shared
6238              --disable-shared
6239                     Shared library
6240
6241              --enable-static
6242              --disable-static
6243                     Static library
6244
6245              --enable-executable-dynamic
6246              --disable-executable-dynamic
6247                     Executable dynamic linking
6248
6249              --enable-profiling
6250              --disable-profiling
6251                     Executable and library profiling
6252
6253              --enable-executable-profiling
6254              --disable-executable-profiling
6255                     Executable profiling (DEPRECATED)
6256
6257              --profiling-detail level
6258                     Profiling   detail   level  for  executable  and  library
6259                     (default, none,  exported-functions,  toplevel-functions,
6260                     all-functions).
6261
6262              --library-profiling-detail level
6263                     Profiling detail level for libraries only.
6264
6265              -O, --enable-optimization, --enable-optimisation [n]
6266                     Build with optimization (n is 0--2, default is 1)
6267
6268              --disable-optimization, --disable-optimisation
6269                     Build without optimization
6270
6271              --enable-debug-info [n]
6272                     Emit debug info (n is 0--3, default is 0)
6273
6274              --disable-debug-info
6275                     Don't emit debug info
6276
6277              --enable-library-for-ghci
6278              --disable-library-for-ghci
6279                     compile library for use with GHCi
6280
6281              --enable-split-sections
6282              --disable-split-sections
6283                     compile  library  code such that unneeded definitions can
6284                     be dropped from the final executable (GHC 7.8+)
6285
6286              --enable-split-objs
6287              --disable-split-objs
6288                     split library into smaller objects to reduce binary sizes
6289                     (GHC 6.6+)
6290
6291              --enable-executable-stripping
6292              --disable-executable-stripping
6293                     strip  executables  upon  installation  to  reduce binary
6294                     sizes
6295
6296              --enable-library-stripping
6297              --disable-library-stripping
6298                     strip libraries upon installation to reduce binary sizes
6299
6300              --configure-option OPT
6301                     Extra option for configure
6302
6303              --user
6304              --global
6305                     doing a per-user installation
6306
6307              --package-db DB
6308                     Append the given package database to the list of  package
6309                     databases  used  (to  satisfy  dependencies  and register
6310                     into). May be a specific file, 'global'  or  'user'.  The
6311                     initial   list  is  ['global'],  ['global',  'user'],  or
6312                     ['global', $sandbox], depending on context.  Use  'clear'
6313                     to  reset  the  list  to  empty.  See  the user guide for
6314                     details.
6315
6316              -f, --flags FLAGS
6317                     Force values for the given flags in Cabal conditionals in
6318                     the  .cabal  file.  E.g., --flags="debug -usebytestrings"
6319                     forces the flag "debug" to true and  "usebytestrings"  to
6320                     false.
6321
6322              --extra-include-dirs PATH
6323                     A list of directories to search for header files
6324
6325              --enable-deterministic
6326              --disable-deterministic
6327                     Try  to be as deterministic as possible (used by the test
6328                     suite)
6329
6330              --ipid IPID
6331                     Installed package ID to compile this package as
6332
6333              --cid CID
6334                     Installed component ID to compile this component as
6335
6336              --extra-lib-dirs PATH
6337                     A list of directories to search for external libraries
6338
6339              --extra-framework-dirs PATH
6340                     A list of directories to search for  external  frameworks
6341                     (OS X only)
6342
6343              --extra-prog-path PATH
6344                     A list of directories to search for required programs (in
6345                     addition to the normal search locations)
6346
6347              --instantiate-with NAME=MOD
6348                     A mapping of signature names to concrete module instanti‐
6349                     ations.
6350
6351              --enable-tests
6352              --disable-tests
6353                     dependency  checking  and  compilation  for  test  suites
6354                     listed in the package description file.
6355
6356              --enable-coverage
6357              --disable-coverage
6358                     build package with Haskell Program Coverage. (GHC only)
6359
6360              --enable-library-coverage
6361              --disable-library-coverage
6362                     build package with Haskell Program Coverage.  (GHC  only)
6363                     (DEPRECATED)
6364
6365              --enable-benchmarks
6366              --disable-benchmarks
6367                     dependency checking and compilation for benchmarks listed
6368                     in the package description file.
6369
6370              --enable-relocatable
6371              --disable-relocatable
6372                     building a package that is relocatable. (GHC only)
6373
6374              --disable-response-files
6375                     enable workaround for old versions of programs like  "ar"
6376                     that do not support @file arguments
6377
6378              --with-alex PATH
6379                     give the path to alex
6380
6381              --with-ar PATH
6382                     give the path to ar
6383
6384              --with-c2hs PATH
6385                     give the path to c2hs
6386
6387              --with-cpphs PATH
6388                     give the path to cpphs
6389
6390              --with-doctest PATH
6391                     give the path to doctest
6392
6393              --with-gcc PATH
6394                     give the path to gcc
6395
6396              --with-ghc PATH
6397                     give the path to ghc
6398
6399              --with-ghc-pkg PATH
6400                     give the path to ghc-pkg
6401
6402              --with-ghcjs PATH
6403                     give the path to ghcjs
6404
6405              --with-ghcjs-pkg PATH
6406                     give the path to ghcjs-pkg
6407
6408              --with-greencard PATH
6409                     give the path to greencard
6410
6411              --with-haddock PATH
6412                     give the path to haddock
6413
6414              --with-happy PATH
6415                     give the path to happy
6416
6417              --with-haskell-suite PATH
6418                     give the path to haskell-suite
6419
6420              --with-haskell-suite-pkg PATH
6421                     give the path to haskell-suite-pkg
6422
6423              --with-hmake PATH
6424                     give the path to hmake
6425
6426              --with-hpc PATH
6427                     give the path to hpc
6428
6429              --with-hsc2hs PATH
6430                     give the path to hsc2hs
6431
6432              --with-hscolour PATH
6433                     give the path to hscolour
6434
6435              --with-jhc PATH
6436                     give the path to jhc
6437
6438              --with-ld PATH
6439                     give the path to ld
6440
6441              --with-lhc PATH
6442                     give the path to lhc
6443
6444              --with-lhc-pkg PATH
6445                     give the path to lhc-pkg
6446
6447              --with-pkg-config PATH
6448                     give the path to pkg-config
6449
6450              --with-runghc PATH
6451                     give the path to runghc
6452
6453              --with-strip PATH
6454                     give the path to strip
6455
6456              --with-tar PATH
6457                     give the path to tar
6458
6459              --with-uhc PATH
6460                     give the path to uhc
6461
6462              --alex-option OPT
6463                     give  an  extra  option to alex (no need to quote options
6464                     containing spaces)
6465
6466              --ar-option OPT
6467                     give an extra option to ar (no need to quote options con‐
6468                     taining spaces)
6469
6470              --c2hs-option OPT
6471                     give  an  extra  option to c2hs (no need to quote options
6472                     containing spaces)
6473
6474              --cpphs-option OPT
6475                     give an extra option to cpphs (no need to  quote  options
6476                     containing spaces)
6477
6478              --doctest-option OPT
6479                     give an extra option to doctest (no need to quote options
6480                     containing spaces)
6481
6482              --gcc-option OPT
6483                     give an extra option to gcc (no  need  to  quote  options
6484                     containing spaces)
6485
6486              --ghc-option OPT
6487                     give  an  extra  option  to ghc (no need to quote options
6488                     containing spaces)
6489
6490              --ghc-pkg-option OPT
6491                     give an extra option to ghc-pkg (no need to quote options
6492                     containing spaces)
6493
6494              --ghcjs-option OPT
6495                     give  an  extra option to ghcjs (no need to quote options
6496                     containing spaces)
6497
6498              --ghcjs-pkg-option OPT
6499                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
6500                     options containing spaces)
6501
6502              --greencard-option OPT
6503                     give  an  extra  option  to  greencard  (no need to quote
6504                     options containing spaces)
6505
6506              --haddock-option OPT
6507                     give an extra option to haddock (no need to quote options
6508                     containing spaces)
6509
6510              --happy-option OPT
6511                     give  an  extra option to happy (no need to quote options
6512                     containing spaces)
6513
6514              --haskell-suite-option OPT
6515                     give an extra option to haskell-suite (no need  to  quote
6516                     options containing spaces)
6517
6518              --haskell-suite-pkg-option OPT
6519                     give  an  extra  option  to haskell-suite-pkg (no need to
6520                     quote options containing spaces)
6521
6522              --hmake-option OPT
6523                     give an extra option to hmake (no need to  quote  options
6524                     containing spaces)
6525
6526              --hpc-option OPT
6527                     give  an  extra  option  to hpc (no need to quote options
6528                     containing spaces)
6529
6530              --hsc2hs-option OPT
6531                     give an extra option to hsc2hs (no need to quote  options
6532                     containing spaces)
6533
6534              --hscolour-option OPT
6535                     give  an  extra  option  to  hscolour  (no  need to quote
6536                     options containing spaces)
6537
6538              --jhc-option OPT
6539                     give an extra option to jhc (no  need  to  quote  options
6540                     containing spaces)
6541
6542              --ld-option OPT
6543                     give an extra option to ld (no need to quote options con‐
6544                     taining spaces)
6545
6546              --lhc-option OPT
6547                     give an extra option to lhc (no  need  to  quote  options
6548                     containing spaces)
6549
6550              --lhc-pkg-option OPT
6551                     give an extra option to lhc-pkg (no need to quote options
6552                     containing spaces)
6553
6554              --pkg-config-option OPT
6555                     give an extra option to  pkg-config  (no  need  to  quote
6556                     options containing spaces)
6557
6558              --runghc-option OPT
6559                     give  an extra option to runghc (no need to quote options
6560                     containing spaces)
6561
6562              --strip-option OPT
6563                     give an extra option to strip (no need to  quote  options
6564                     containing spaces)
6565
6566              --tar-option OPT
6567                     give  an  extra  option  to tar (no need to quote options
6568                     containing spaces)
6569
6570              --uhc-option OPT
6571                     give an extra option to uhc (no  need  to  quote  options
6572                     containing spaces)
6573
6574              --alex-options OPTS
6575                     give extra options to alex
6576
6577              --ar-options OPTS
6578                     give extra options to ar
6579
6580              --c2hs-options OPTS
6581                     give extra options to c2hs
6582
6583              --cpphs-options OPTS
6584                     give extra options to cpphs
6585
6586              --doctest-options OPTS
6587                     give extra options to doctest
6588
6589              --gcc-options OPTS
6590                     give extra options to gcc
6591
6592              --ghc-options OPTS
6593                     give extra options to ghc
6594
6595              --ghc-pkg-options OPTS
6596                     give extra options to ghc-pkg
6597
6598              --ghcjs-options OPTS
6599                     give extra options to ghcjs
6600
6601              --ghcjs-pkg-options OPTS
6602                     give extra options to ghcjs-pkg
6603
6604              --greencard-options OPTS
6605                     give extra options to greencard
6606
6607              --haddock-options OPTS
6608                     give extra options to haddock
6609
6610              --happy-options OPTS
6611                     give extra options to happy
6612
6613              --haskell-suite-options OPTS
6614                     give extra options to haskell-suite
6615
6616              --haskell-suite-pkg-options OPTS
6617                     give extra options to haskell-suite-pkg
6618
6619              --hmake-options OPTS
6620                     give extra options to hmake
6621
6622              --hpc-options OPTS
6623                     give extra options to hpc
6624
6625              --hsc2hs-options OPTS
6626                     give extra options to hsc2hs
6627
6628              --hscolour-options OPTS
6629                     give extra options to hscolour
6630
6631              --jhc-options OPTS
6632                     give extra options to jhc
6633
6634              --ld-options OPTS
6635                     give extra options to ld
6636
6637              --lhc-options OPTS
6638                     give extra options to lhc
6639
6640              --lhc-pkg-options OPTS
6641                     give extra options to lhc-pkg
6642
6643              --pkg-config-options OPTS
6644                     give extra options to pkg-config
6645
6646              --runghc-options OPTS
6647                     give extra options to runghc
6648
6649              --strip-options OPTS
6650                     give extra options to strip
6651
6652              --tar-options OPTS
6653                     give extra options to tar
6654
6655              --uhc-options OPTS
6656                     give extra options to uhc
6657
6658              --cabal-lib-version VERSION
6659                     Select  which  version  of  the Cabal lib to use to build
6660                     packages (useful for testing).
6661
6662              --constraint CONSTRAINT
6663                     Specify    constraints    on    a    package    (version,
6664                     installed/source, flags)
6665
6666              --preference CONSTRAINT
6667                     Specify  preferences (soft constraints) on the version of
6668                     a package
6669
6670              --solver SOLVER
6671                     Select  dependency  solver  to  use  (default:  modular).
6672                     Choices: modular.
6673
6674              --allow-older [DEPS]
6675                     Ignore lower bounds in all dependencies or DEPS
6676
6677              --allow-newer [DEPS]
6678                     Ignore upper bounds in all dependencies or DEPS
6679
6680              --enable-documentation
6681              --disable-documentation
6682                     building of documentation
6683
6684              --doc-index-file TEMPLATE
6685                     A  central  index  of haddock API documentation (template
6686                     cannot use $pkgid)
6687
6688              --dry-run
6689                     Do  not  install  anything,  only  print  what  would  be
6690                     installed.
6691
6692              --max-backjumps NUM
6693                     Maximum   number   of  backjumps  allowed  while  solving
6694                     (default: 2000). Use a negative number to  enable  unlim‐
6695                     ited  backtracking.  Use  0  to disable backtracking com‐
6696                     pletely.
6697
6698              --reorder-goals
6699              --no-reorder-goals
6700                     Try to reorder goals  according  to  certain  heuristics.
6701                     Slows  things  down on average, but may make backtracking
6702                     faster for some packages.
6703
6704              --count-conflicts
6705              --no-count-conflicts
6706                     Try to speed up solving  by  preferring  goals  that  are
6707                     involved in a lot of conflicts (default).
6708
6709              --independent-goals
6710              --no-independent-goals
6711                     Treat  several  goals on the command line as independent.
6712                     If several goals depend on the  same  package,  different
6713                     versions can be chosen.
6714
6715              --shadow-installed-packages
6716              --no-shadow-installed-packages
6717                     If  multiple  package  instances  of the same version are
6718                     installed, treat all but one as shadowed.
6719
6720              --strong-flags
6721              --no-strong-flags
6722                     Do not defer flag choices (this used to be the default in
6723                     cabal-install <= 1.20).
6724
6725              --allow-boot-library-installs
6726              --no-allow-boot-library-installs
6727                     Allow  cabal  to  install base, ghc-prim, integer-simple,
6728                     integer-gmp, and template-haskell.
6729
6730              --reinstall
6731              --no-reinstall
6732                     Install even if it  means  installing  the  same  version
6733                     again.
6734
6735              --avoid-reinstalls
6736              --no-avoid-reinstalls
6737                     Do not select versions that would destructively overwrite
6738                     installed packages.
6739
6740              --force-reinstalls
6741              --no-force-reinstalls
6742                     Reinstall packages even if they will  most  likely  break
6743                     other installed packages.
6744
6745              --upgrade-dependencies
6746              --no-upgrade-dependencies
6747                     Pick the latest version for all dependencies, rather than
6748                     trying to pick an installed version.
6749
6750              --only-dependencies
6751              --no-only-dependencies
6752                     Install only the  dependencies  necessary  to  build  the
6753                     given packages
6754
6755              --dependencies-only
6756              --no-dependencies-only
6757                     A synonym for --only-dependencies
6758
6759              --index-state STATE
6760                     Use  source package index state as it existed at a previ‐
6761                     ous time. Accepts unix-timestamps  (e.g.  '@1474732068'),
6762                     ISO8601  UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or
6763                     'HEAD' (default: 'HEAD').
6764
6765              --root-cmd COMMAND
6766                     (No longer supported, do not use.)
6767
6768              --symlink-bindir DIR
6769                     Add symlinks to installed executables  into  this  direc‐
6770                     tory.
6771
6772              --build-summary TEMPLATE
6773                     Save  build  summaries  to  file  (name  template can use
6774                     $pkgid, $compiler, $os, $arch)
6775
6776              --build-log TEMPLATE
6777                     Log all builds to file (name  template  can  use  $pkgid,
6778                     $compiler, $os, $arch)
6779
6780              --remote-build-reporting LEVEL
6781                     Generate  build reports to send to a remote server (none,
6782                     anonymous or detailed).
6783
6784              --report-planning-failure
6785                     Generate build reports when the dependency solver  fails.
6786                     This is used by the Hackage build bot.
6787
6788              --enable-per-component
6789              --disable-per-component
6790                     Per-component builds when possible
6791
6792              --one-shot
6793              --no-one-shot
6794                     Do not record the packages in the world file.
6795
6796              --run-tests
6797                     Run package test suites during installation.
6798
6799              -j, --jobs [NUM]
6800                     Run  NUM  jobs  simultaneously  (or '$ncpus' if no NUM is
6801                     given).
6802
6803              --keep-going
6804                     After a build failure, continue to build other unaffected
6805                     packages.
6806
6807              --offline
6808              --no-offline
6809                     Don't download packages from the Internet.
6810
6811              --project-file FILE
6812                     Set  the  name of the cabal.project file to search for in
6813                     parent directories
6814
6815              --only
6816                     Only installs the package in the current directory.
6817
6818              --haddock-hoogle
6819                     Generate a hoogle database
6820
6821              --haddock-html
6822                     Generate HTML documentation (the default)
6823
6824              --haddock-html-location URL
6825                     Location of HTML documentation for pre-requisite packages
6826
6827              --haddock-for-hackage
6828                     Collection of flags to  generate  documentation  suitable
6829                     for upload to hackage
6830
6831              --haddock-executables
6832                     Run haddock for Executables targets
6833
6834              --haddock-tests
6835                     Run haddock for Test Suite targets
6836
6837              --haddock-benchmarks
6838                     Run haddock for Benchmark targets
6839
6840              --haddock-all
6841                     Run haddock for all targets
6842
6843              --haddock-internal
6844                     Run haddock for internal modules and include all symbols
6845
6846              --haddock-css PATH
6847                     Use PATH as the haddock stylesheet
6848
6849              --haddock-hyperlink-source, --haddock-hyperlink-sources
6850                     Hyperlink the documentation to the source code
6851
6852              --haddock-hscolour-css PATH
6853                     Use PATH as the HsColour stylesheet
6854
6855              --haddock-contents-location URL
6856                     Bake URL in as the location for the contents page
6857
6858
6859       cabal new-repl
6860
6861       Usage: cabal new-repl [TARGET] [FLAGS]
6862
6863
6864       Open  an  interactive  session  for a component within the project. The
6865       available targets are the same as for the 'new-build' command: individ‐
6866       ual  components  within  packages  in the project, including libraries,
6867       executables, test-suites or benchmarks. Packages can also be  specified
6868       in which case the library component in the package will be used, or the
6869       (first listed) executable in the package if there is no library.
6870
6871       Dependencies are built or rebuilt as necessary.  Additional  configura‐
6872       tion  flags  can  be specified on the command line and these extend the
6873       project configuration from the  'cabal.project',  'cabal.project.local'
6874       and other files.
6875
6876
6877       Examples, open an interactive session:
6878         cabal new-repl
6879           for the default component in the package in the current directory
6880         cabal new-repl pkgname
6881           for the default component in the package named 'pkgname'
6882         cabal new-repl ./pkgfoo
6883           for the default component in the package in the ./pkgfoo directory
6884         cabal new-repl cname
6885           for the component named 'cname'
6886         cabal new-repl pkgname:cname
6887           for the component 'cname' in the package 'pkgname'
6888
6889       Note:  this  command  is part of the new project-based system (aka nix-
6890       style local builds). These features are currently in beta.  Please  see
6891       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
6892       details and advice on what you can expect to  work.  If  you  encounter
6893       problems  please file issues at https://github.com/haskell/cabal/issues
6894       and if you have any time to get involved and help with testing,  fixing
6895       bugs etc then that is very much appreciated.
6896
6897
6898       Flags:
6899              -v, --verbose [n]
6900                     Control  verbosity (n is 0--3, default verbosity level is
6901                     1)
6902
6903              --builddir, --distdir, --distpref DIR
6904                     The directory where  Cabal  puts  generated  build  files
6905                     (default dist)
6906
6907              -g, --ghc
6908                     compile with GHC
6909
6910              --ghcjs
6911                     compile with GHCJS
6912
6913              --jhc
6914                     compile with JHC
6915
6916              --lhc
6917                     compile with LHC
6918
6919              --uhc
6920                     compile with UHC
6921
6922              --haskell-suite
6923                     compile with a haskell-suite compiler
6924
6925              --cabal-file PATH
6926                     use this Cabal file
6927
6928              -w, --with-compiler PATH
6929                     give the path to a particular compiler
6930
6931              --with-hc-pkg PATH
6932                     give the path to the package tool
6933
6934              --prefix DIR
6935                     bake this prefix in preparation of installation
6936
6937              --bindir DIR
6938                     installation directory for executables
6939
6940              --libdir DIR
6941                     installation directory for libraries
6942
6943              --libsubdir DIR
6944                     subdirectory of libdir in which libs are installed
6945
6946              --dynlibdir DIR
6947                     installation directory for dynamic libraries
6948
6949              --libexecdir DIR
6950                     installation directory for program executables
6951
6952              --libexecsubdir DIR
6953                     subdirectory  of  libexecdir in which private executables
6954                     are installed
6955
6956              --datadir DIR
6957                     installation directory for read-only data
6958
6959              --datasubdir DIR
6960                     subdirectory of datadir in which data files are installed
6961
6962              --docdir DIR
6963                     installation directory for documentation
6964
6965              --htmldir DIR
6966                     installation directory for HTML documentation
6967
6968              --haddockdir DIR
6969                     installation directory for haddock interfaces
6970
6971              --sysconfdir DIR
6972                     installation directory for configuration files
6973
6974              --program-prefix PREFIX
6975                     prefix to be applied to installed executables
6976
6977              --program-suffix SUFFIX
6978                     suffix to be applied to installed executables
6979
6980              --enable-library-vanilla
6981              --disable-library-vanilla
6982                     Vanilla libraries
6983
6984              -p, --enable-library-profiling
6985              --disable-library-profiling
6986                     Library profiling
6987
6988              --enable-shared
6989              --disable-shared
6990                     Shared library
6991
6992              --enable-static
6993              --disable-static
6994                     Static library
6995
6996              --enable-executable-dynamic
6997              --disable-executable-dynamic
6998                     Executable dynamic linking
6999
7000              --enable-profiling
7001              --disable-profiling
7002                     Executable and library profiling
7003
7004              --enable-executable-profiling
7005              --disable-executable-profiling
7006                     Executable profiling (DEPRECATED)
7007
7008              --profiling-detail level
7009                     Profiling  detail  level  for  executable   and   library
7010                     (default,  none,  exported-functions, toplevel-functions,
7011                     all-functions).
7012
7013              --library-profiling-detail level
7014                     Profiling detail level for libraries only.
7015
7016              -O, --enable-optimization, --enable-optimisation [n]
7017                     Build with optimization (n is 0--2, default is 1)
7018
7019              --disable-optimization, --disable-optimisation
7020                     Build without optimization
7021
7022              --enable-debug-info [n]
7023                     Emit debug info (n is 0--3, default is 0)
7024
7025              --disable-debug-info
7026                     Don't emit debug info
7027
7028              --enable-library-for-ghci
7029              --disable-library-for-ghci
7030                     compile library for use with GHCi
7031
7032              --enable-split-sections
7033              --disable-split-sections
7034                     compile library code such that unneeded  definitions  can
7035                     be dropped from the final executable (GHC 7.8+)
7036
7037              --enable-split-objs
7038              --disable-split-objs
7039                     split library into smaller objects to reduce binary sizes
7040                     (GHC 6.6+)
7041
7042              --enable-executable-stripping
7043              --disable-executable-stripping
7044                     strip executables  upon  installation  to  reduce  binary
7045                     sizes
7046
7047              --enable-library-stripping
7048              --disable-library-stripping
7049                     strip libraries upon installation to reduce binary sizes
7050
7051              --configure-option OPT
7052                     Extra option for configure
7053
7054              --user
7055              --global
7056                     doing a per-user installation
7057
7058              --package-db DB
7059                     Append  the given package database to the list of package
7060                     databases used  (to  satisfy  dependencies  and  register
7061                     into).  May  be  a specific file, 'global' or 'user'. The
7062                     initial  list  is  ['global'],  ['global',  'user'],   or
7063                     ['global',  $sandbox],  depending on context. Use 'clear'
7064                     to reset the list  to  empty.  See  the  user  guide  for
7065                     details.
7066
7067              -f, --flags FLAGS
7068                     Force values for the given flags in Cabal conditionals in
7069                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
7070                     forces  the  flag "debug" to true and "usebytestrings" to
7071                     false.
7072
7073              --extra-include-dirs PATH
7074                     A list of directories to search for header files
7075
7076              --enable-deterministic
7077              --disable-deterministic
7078                     Try to be as deterministic as possible (used by the  test
7079                     suite)
7080
7081              --ipid IPID
7082                     Installed package ID to compile this package as
7083
7084              --cid CID
7085                     Installed component ID to compile this component as
7086
7087              --extra-lib-dirs PATH
7088                     A list of directories to search for external libraries
7089
7090              --extra-framework-dirs PATH
7091                     A  list  of directories to search for external frameworks
7092                     (OS X only)
7093
7094              --extra-prog-path PATH
7095                     A list of directories to search for required programs (in
7096                     addition to the normal search locations)
7097
7098              --instantiate-with NAME=MOD
7099                     A mapping of signature names to concrete module instanti‐
7100                     ations.
7101
7102              --enable-tests
7103              --disable-tests
7104                     dependency  checking  and  compilation  for  test  suites
7105                     listed in the package description file.
7106
7107              --enable-coverage
7108              --disable-coverage
7109                     build package with Haskell Program Coverage. (GHC only)
7110
7111              --enable-library-coverage
7112              --disable-library-coverage
7113                     build  package  with Haskell Program Coverage. (GHC only)
7114                     (DEPRECATED)
7115
7116              --enable-benchmarks
7117              --disable-benchmarks
7118                     dependency checking and compilation for benchmarks listed
7119                     in the package description file.
7120
7121              --enable-relocatable
7122              --disable-relocatable
7123                     building a package that is relocatable. (GHC only)
7124
7125              --disable-response-files
7126                     enable  workaround for old versions of programs like "ar"
7127                     that do not support @file arguments
7128
7129              --with-alex PATH
7130                     give the path to alex
7131
7132              --with-ar PATH
7133                     give the path to ar
7134
7135              --with-c2hs PATH
7136                     give the path to c2hs
7137
7138              --with-cpphs PATH
7139                     give the path to cpphs
7140
7141              --with-doctest PATH
7142                     give the path to doctest
7143
7144              --with-gcc PATH
7145                     give the path to gcc
7146
7147              --with-ghc PATH
7148                     give the path to ghc
7149
7150              --with-ghc-pkg PATH
7151                     give the path to ghc-pkg
7152
7153              --with-ghcjs PATH
7154                     give the path to ghcjs
7155
7156              --with-ghcjs-pkg PATH
7157                     give the path to ghcjs-pkg
7158
7159              --with-greencard PATH
7160                     give the path to greencard
7161
7162              --with-haddock PATH
7163                     give the path to haddock
7164
7165              --with-happy PATH
7166                     give the path to happy
7167
7168              --with-haskell-suite PATH
7169                     give the path to haskell-suite
7170
7171              --with-haskell-suite-pkg PATH
7172                     give the path to haskell-suite-pkg
7173
7174              --with-hmake PATH
7175                     give the path to hmake
7176
7177              --with-hpc PATH
7178                     give the path to hpc
7179
7180              --with-hsc2hs PATH
7181                     give the path to hsc2hs
7182
7183              --with-hscolour PATH
7184                     give the path to hscolour
7185
7186              --with-jhc PATH
7187                     give the path to jhc
7188
7189              --with-ld PATH
7190                     give the path to ld
7191
7192              --with-lhc PATH
7193                     give the path to lhc
7194
7195              --with-lhc-pkg PATH
7196                     give the path to lhc-pkg
7197
7198              --with-pkg-config PATH
7199                     give the path to pkg-config
7200
7201              --with-runghc PATH
7202                     give the path to runghc
7203
7204              --with-strip PATH
7205                     give the path to strip
7206
7207              --with-tar PATH
7208                     give the path to tar
7209
7210              --with-uhc PATH
7211                     give the path to uhc
7212
7213              --alex-option OPT
7214                     give an extra option to alex (no need  to  quote  options
7215                     containing spaces)
7216
7217              --ar-option OPT
7218                     give an extra option to ar (no need to quote options con‐
7219                     taining spaces)
7220
7221              --c2hs-option OPT
7222                     give an extra option to c2hs (no need  to  quote  options
7223                     containing spaces)
7224
7225              --cpphs-option OPT
7226                     give  an  extra option to cpphs (no need to quote options
7227                     containing spaces)
7228
7229              --doctest-option OPT
7230                     give an extra option to doctest (no need to quote options
7231                     containing spaces)
7232
7233              --gcc-option OPT
7234                     give  an  extra  option  to gcc (no need to quote options
7235                     containing spaces)
7236
7237              --ghc-option OPT
7238                     give an extra option to ghc (no  need  to  quote  options
7239                     containing spaces)
7240
7241              --ghc-pkg-option OPT
7242                     give an extra option to ghc-pkg (no need to quote options
7243                     containing spaces)
7244
7245              --ghcjs-option OPT
7246                     give an extra option to ghcjs (no need to  quote  options
7247                     containing spaces)
7248
7249              --ghcjs-pkg-option OPT
7250                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
7251                     options containing spaces)
7252
7253              --greencard-option OPT
7254                     give an extra option  to  greencard  (no  need  to  quote
7255                     options containing spaces)
7256
7257              --haddock-option OPT
7258                     give an extra option to haddock (no need to quote options
7259                     containing spaces)
7260
7261              --happy-option OPT
7262                     give an extra option to happy (no need to  quote  options
7263                     containing spaces)
7264
7265              --haskell-suite-option OPT
7266                     give  an  extra option to haskell-suite (no need to quote
7267                     options containing spaces)
7268
7269              --haskell-suite-pkg-option OPT
7270                     give an extra option to  haskell-suite-pkg  (no  need  to
7271                     quote options containing spaces)
7272
7273              --hmake-option OPT
7274                     give  an  extra option to hmake (no need to quote options
7275                     containing spaces)
7276
7277              --hpc-option OPT
7278                     give an extra option to hpc (no  need  to  quote  options
7279                     containing spaces)
7280
7281              --hsc2hs-option OPT
7282                     give  an extra option to hsc2hs (no need to quote options
7283                     containing spaces)
7284
7285              --hscolour-option OPT
7286                     give an extra  option  to  hscolour  (no  need  to  quote
7287                     options containing spaces)
7288
7289              --jhc-option OPT
7290                     give  an  extra  option  to jhc (no need to quote options
7291                     containing spaces)
7292
7293              --ld-option OPT
7294                     give an extra option to ld (no need to quote options con‐
7295                     taining spaces)
7296
7297              --lhc-option OPT
7298                     give  an  extra  option  to lhc (no need to quote options
7299                     containing spaces)
7300
7301              --lhc-pkg-option OPT
7302                     give an extra option to lhc-pkg (no need to quote options
7303                     containing spaces)
7304
7305              --pkg-config-option OPT
7306                     give  an  extra  option  to  pkg-config (no need to quote
7307                     options containing spaces)
7308
7309              --runghc-option OPT
7310                     give an extra option to runghc (no need to quote  options
7311                     containing spaces)
7312
7313              --strip-option OPT
7314                     give  an  extra option to strip (no need to quote options
7315                     containing spaces)
7316
7317              --tar-option OPT
7318                     give an extra option to tar (no  need  to  quote  options
7319                     containing spaces)
7320
7321              --uhc-option OPT
7322                     give  an  extra  option  to uhc (no need to quote options
7323                     containing spaces)
7324
7325              --alex-options OPTS
7326                     give extra options to alex
7327
7328              --ar-options OPTS
7329                     give extra options to ar
7330
7331              --c2hs-options OPTS
7332                     give extra options to c2hs
7333
7334              --cpphs-options OPTS
7335                     give extra options to cpphs
7336
7337              --doctest-options OPTS
7338                     give extra options to doctest
7339
7340              --gcc-options OPTS
7341                     give extra options to gcc
7342
7343              --ghc-options OPTS
7344                     give extra options to ghc
7345
7346              --ghc-pkg-options OPTS
7347                     give extra options to ghc-pkg
7348
7349              --ghcjs-options OPTS
7350                     give extra options to ghcjs
7351
7352              --ghcjs-pkg-options OPTS
7353                     give extra options to ghcjs-pkg
7354
7355              --greencard-options OPTS
7356                     give extra options to greencard
7357
7358              --haddock-options OPTS
7359                     give extra options to haddock
7360
7361              --happy-options OPTS
7362                     give extra options to happy
7363
7364              --haskell-suite-options OPTS
7365                     give extra options to haskell-suite
7366
7367              --haskell-suite-pkg-options OPTS
7368                     give extra options to haskell-suite-pkg
7369
7370              --hmake-options OPTS
7371                     give extra options to hmake
7372
7373              --hpc-options OPTS
7374                     give extra options to hpc
7375
7376              --hsc2hs-options OPTS
7377                     give extra options to hsc2hs
7378
7379              --hscolour-options OPTS
7380                     give extra options to hscolour
7381
7382              --jhc-options OPTS
7383                     give extra options to jhc
7384
7385              --ld-options OPTS
7386                     give extra options to ld
7387
7388              --lhc-options OPTS
7389                     give extra options to lhc
7390
7391              --lhc-pkg-options OPTS
7392                     give extra options to lhc-pkg
7393
7394              --pkg-config-options OPTS
7395                     give extra options to pkg-config
7396
7397              --runghc-options OPTS
7398                     give extra options to runghc
7399
7400              --strip-options OPTS
7401                     give extra options to strip
7402
7403              --tar-options OPTS
7404                     give extra options to tar
7405
7406              --uhc-options OPTS
7407                     give extra options to uhc
7408
7409              --cabal-lib-version VERSION
7410                     Select which version of the Cabal lib  to  use  to  build
7411                     packages (useful for testing).
7412
7413              --constraint CONSTRAINT
7414                     Specify    constraints    on    a    package    (version,
7415                     installed/source, flags)
7416
7417              --preference CONSTRAINT
7418                     Specify preferences (soft constraints) on the version  of
7419                     a package
7420
7421              --solver SOLVER
7422                     Select  dependency  solver  to  use  (default:  modular).
7423                     Choices: modular.
7424
7425              --allow-older [DEPS]
7426                     Ignore lower bounds in all dependencies or DEPS
7427
7428              --allow-newer [DEPS]
7429                     Ignore upper bounds in all dependencies or DEPS
7430
7431              --enable-documentation
7432              --disable-documentation
7433                     building of documentation
7434
7435              --doc-index-file TEMPLATE
7436                     A central index of haddock  API  documentation  (template
7437                     cannot use $pkgid)
7438
7439              --dry-run
7440                     Do  not  install  anything,  only  print  what  would  be
7441                     installed.
7442
7443              --max-backjumps NUM
7444                     Maximum  number  of  backjumps  allowed   while   solving
7445                     (default:  2000).  Use a negative number to enable unlim‐
7446                     ited backtracking. Use 0  to  disable  backtracking  com‐
7447                     pletely.
7448
7449              --reorder-goals
7450              --no-reorder-goals
7451                     Try  to  reorder  goals  according to certain heuristics.
7452                     Slows things down on average, but may  make  backtracking
7453                     faster for some packages.
7454
7455              --count-conflicts
7456              --no-count-conflicts
7457                     Try  to  speed  up  solving  by preferring goals that are
7458                     involved in a lot of conflicts (default).
7459
7460              --independent-goals
7461              --no-independent-goals
7462                     Treat several goals on the command line  as  independent.
7463                     If  several  goals  depend on the same package, different
7464                     versions can be chosen.
7465
7466              --shadow-installed-packages
7467              --no-shadow-installed-packages
7468                     If multiple package instances of  the  same  version  are
7469                     installed, treat all but one as shadowed.
7470
7471              --strong-flags
7472              --no-strong-flags
7473                     Do not defer flag choices (this used to be the default in
7474                     cabal-install <= 1.20).
7475
7476              --allow-boot-library-installs
7477              --no-allow-boot-library-installs
7478                     Allow cabal to install  base,  ghc-prim,  integer-simple,
7479                     integer-gmp, and template-haskell.
7480
7481              --reinstall
7482              --no-reinstall
7483                     Install  even  if  it  means  installing the same version
7484                     again.
7485
7486              --avoid-reinstalls
7487              --no-avoid-reinstalls
7488                     Do not select versions that would destructively overwrite
7489                     installed packages.
7490
7491              --force-reinstalls
7492              --no-force-reinstalls
7493                     Reinstall  packages  even  if they will most likely break
7494                     other installed packages.
7495
7496              --upgrade-dependencies
7497              --no-upgrade-dependencies
7498                     Pick the latest version for all dependencies, rather than
7499                     trying to pick an installed version.
7500
7501              --only-dependencies
7502              --no-only-dependencies
7503                     Install  only  the  dependencies  necessary  to build the
7504                     given packages
7505
7506              --dependencies-only
7507              --no-dependencies-only
7508                     A synonym for --only-dependencies
7509
7510              --index-state STATE
7511                     Use source package index state as it existed at a  previ‐
7512                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
7513                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
7514                     'HEAD' (default: 'HEAD').
7515
7516              --root-cmd COMMAND
7517                     (No longer supported, do not use.)
7518
7519              --symlink-bindir DIR
7520                     Add  symlinks  to  installed executables into this direc‐
7521                     tory.
7522
7523              --build-summary TEMPLATE
7524                     Save build summaries  to  file  (name  template  can  use
7525                     $pkgid, $compiler, $os, $arch)
7526
7527              --build-log TEMPLATE
7528                     Log  all  builds  to  file (name template can use $pkgid,
7529                     $compiler, $os, $arch)
7530
7531              --remote-build-reporting LEVEL
7532                     Generate build reports to send to a remote server  (none,
7533                     anonymous or detailed).
7534
7535              --report-planning-failure
7536                     Generate  build reports when the dependency solver fails.
7537                     This is used by the Hackage build bot.
7538
7539              --enable-per-component
7540              --disable-per-component
7541                     Per-component builds when possible
7542
7543              --one-shot
7544              --no-one-shot
7545                     Do not record the packages in the world file.
7546
7547              --run-tests
7548                     Run package test suites during installation.
7549
7550              -j, --jobs [NUM]
7551                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
7552                     given).
7553
7554              --keep-going
7555                     After a build failure, continue to build other unaffected
7556                     packages.
7557
7558              --offline
7559              --no-offline
7560                     Don't download packages from the Internet.
7561
7562              --project-file FILE
7563                     Set the name of the cabal.project file to search  for  in
7564                     parent directories
7565
7566              --only
7567                     Only installs the package in the current directory.
7568
7569              --haddock-hoogle
7570                     Generate a hoogle database
7571
7572              --haddock-html
7573                     Generate HTML documentation (the default)
7574
7575              --haddock-html-location URL
7576                     Location of HTML documentation for pre-requisite packages
7577
7578              --haddock-for-hackage
7579                     Collection  of  flags  to generate documentation suitable
7580                     for upload to hackage
7581
7582              --haddock-executables
7583                     Run haddock for Executables targets
7584
7585              --haddock-tests
7586                     Run haddock for Test Suite targets
7587
7588              --haddock-benchmarks
7589                     Run haddock for Benchmark targets
7590
7591              --haddock-all
7592                     Run haddock for all targets
7593
7594              --haddock-internal
7595                     Run haddock for internal modules and include all symbols
7596
7597              --haddock-css PATH
7598                     Use PATH as the haddock stylesheet
7599
7600              --haddock-hyperlink-source, --haddock-hyperlink-sources
7601                     Hyperlink the documentation to the source code
7602
7603              --haddock-hscolour-css PATH
7604                     Use PATH as the HsColour stylesheet
7605
7606              --haddock-contents-location URL
7607                     Bake URL in as the location for the contents page
7608
7609
7610       cabal new-freeze
7611
7612       Usage: cabal new-freeze [FLAGS]
7613
7614
7615       The project configuration is frozen so that it will be reproducible  in
7616       future.
7617
7618       The  precise dependency configuration for the project is written to the
7619       specified).   This   file   extends   the   configuration   from    the
7620       'cabal.project'  file and thus is used as the project configuration for
7621       all other commands (such as
7622
7623       The freeze file can be kept in source control. To  make  small  adjust‐
7624       ments it may be edited manually, or to make bigger changes you may wish
7625       to delete the file and re-freeze. For more control, one approach is  to
7626       try variations using once you have a satisfactory solution to freeze it
7627       using the 'new-freeze' command with the same set of flags.
7628
7629
7630       Examples:
7631         cabal new-freeze
7632           Freeze the configuration of the current project
7633
7634         cabal new-build --dry-run --constraint="aeson < 1"
7635           Check what a solution with the given constraints would look like
7636         cabal new-freeze --constraint="aeson < 1"
7637           Freeze a solution using the given constraints
7638
7639       Note: this command is part of the new project-based  system  (aka  nix-
7640       style  local  builds). These features are currently in beta. Please see
7641       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
7642       details  and  advice  on  what you can expect to work. If you encounter
7643       problems please file issues at  https://github.com/haskell/cabal/issues
7644       and  if you have any time to get involved and help with testing, fixing
7645       bugs etc then that is very much appreciated.
7646
7647
7648       Flags:
7649              -v, --verbose [n]
7650                     Control verbosity (n is 0--3, default verbosity level  is
7651                     1)
7652
7653              --builddir, --distdir, --distpref DIR
7654                     The  directory  where  Cabal  puts  generated build files
7655                     (default dist)
7656
7657              -g, --ghc
7658                     compile with GHC
7659
7660              --ghcjs
7661                     compile with GHCJS
7662
7663              --jhc
7664                     compile with JHC
7665
7666              --lhc
7667                     compile with LHC
7668
7669              --uhc
7670                     compile with UHC
7671
7672              --haskell-suite
7673                     compile with a haskell-suite compiler
7674
7675              --cabal-file PATH
7676                     use this Cabal file
7677
7678              -w, --with-compiler PATH
7679                     give the path to a particular compiler
7680
7681              --with-hc-pkg PATH
7682                     give the path to the package tool
7683
7684              --prefix DIR
7685                     bake this prefix in preparation of installation
7686
7687              --bindir DIR
7688                     installation directory for executables
7689
7690              --libdir DIR
7691                     installation directory for libraries
7692
7693              --libsubdir DIR
7694                     subdirectory of libdir in which libs are installed
7695
7696              --dynlibdir DIR
7697                     installation directory for dynamic libraries
7698
7699              --libexecdir DIR
7700                     installation directory for program executables
7701
7702              --libexecsubdir DIR
7703                     subdirectory of libexecdir in which  private  executables
7704                     are installed
7705
7706              --datadir DIR
7707                     installation directory for read-only data
7708
7709              --datasubdir DIR
7710                     subdirectory of datadir in which data files are installed
7711
7712              --docdir DIR
7713                     installation directory for documentation
7714
7715              --htmldir DIR
7716                     installation directory for HTML documentation
7717
7718              --haddockdir DIR
7719                     installation directory for haddock interfaces
7720
7721              --sysconfdir DIR
7722                     installation directory for configuration files
7723
7724              --program-prefix PREFIX
7725                     prefix to be applied to installed executables
7726
7727              --program-suffix SUFFIX
7728                     suffix to be applied to installed executables
7729
7730              --enable-library-vanilla
7731              --disable-library-vanilla
7732                     Vanilla libraries
7733
7734              -p, --enable-library-profiling
7735              --disable-library-profiling
7736                     Library profiling
7737
7738              --enable-shared
7739              --disable-shared
7740                     Shared library
7741
7742              --enable-static
7743              --disable-static
7744                     Static library
7745
7746              --enable-executable-dynamic
7747              --disable-executable-dynamic
7748                     Executable dynamic linking
7749
7750              --enable-profiling
7751              --disable-profiling
7752                     Executable and library profiling
7753
7754              --enable-executable-profiling
7755              --disable-executable-profiling
7756                     Executable profiling (DEPRECATED)
7757
7758              --profiling-detail level
7759                     Profiling   detail   level  for  executable  and  library
7760                     (default, none,  exported-functions,  toplevel-functions,
7761                     all-functions).
7762
7763              --library-profiling-detail level
7764                     Profiling detail level for libraries only.
7765
7766              -O, --enable-optimization, --enable-optimisation [n]
7767                     Build with optimization (n is 0--2, default is 1)
7768
7769              --disable-optimization, --disable-optimisation
7770                     Build without optimization
7771
7772              --enable-debug-info [n]
7773                     Emit debug info (n is 0--3, default is 0)
7774
7775              --disable-debug-info
7776                     Don't emit debug info
7777
7778              --enable-library-for-ghci
7779              --disable-library-for-ghci
7780                     compile library for use with GHCi
7781
7782              --enable-split-sections
7783              --disable-split-sections
7784                     compile  library  code such that unneeded definitions can
7785                     be dropped from the final executable (GHC 7.8+)
7786
7787              --enable-split-objs
7788              --disable-split-objs
7789                     split library into smaller objects to reduce binary sizes
7790                     (GHC 6.6+)
7791
7792              --enable-executable-stripping
7793              --disable-executable-stripping
7794                     strip  executables  upon  installation  to  reduce binary
7795                     sizes
7796
7797              --enable-library-stripping
7798              --disable-library-stripping
7799                     strip libraries upon installation to reduce binary sizes
7800
7801              --configure-option OPT
7802                     Extra option for configure
7803
7804              --user
7805              --global
7806                     doing a per-user installation
7807
7808              --package-db DB
7809                     Append the given package database to the list of  package
7810                     databases  used  (to  satisfy  dependencies  and register
7811                     into). May be a specific file, 'global'  or  'user'.  The
7812                     initial   list  is  ['global'],  ['global',  'user'],  or
7813                     ['global', $sandbox], depending on context.  Use  'clear'
7814                     to  reset  the  list  to  empty.  See  the user guide for
7815                     details.
7816
7817              -f, --flags FLAGS
7818                     Force values for the given flags in Cabal conditionals in
7819                     the  .cabal  file.  E.g., --flags="debug -usebytestrings"
7820                     forces the flag "debug" to true and  "usebytestrings"  to
7821                     false.
7822
7823              --extra-include-dirs PATH
7824                     A list of directories to search for header files
7825
7826              --enable-deterministic
7827              --disable-deterministic
7828                     Try  to be as deterministic as possible (used by the test
7829                     suite)
7830
7831              --ipid IPID
7832                     Installed package ID to compile this package as
7833
7834              --cid CID
7835                     Installed component ID to compile this component as
7836
7837              --extra-lib-dirs PATH
7838                     A list of directories to search for external libraries
7839
7840              --extra-framework-dirs PATH
7841                     A list of directories to search for  external  frameworks
7842                     (OS X only)
7843
7844              --extra-prog-path PATH
7845                     A list of directories to search for required programs (in
7846                     addition to the normal search locations)
7847
7848              --instantiate-with NAME=MOD
7849                     A mapping of signature names to concrete module instanti‐
7850                     ations.
7851
7852              --enable-tests
7853              --disable-tests
7854                     dependency  checking  and  compilation  for  test  suites
7855                     listed in the package description file.
7856
7857              --enable-coverage
7858              --disable-coverage
7859                     build package with Haskell Program Coverage. (GHC only)
7860
7861              --enable-library-coverage
7862              --disable-library-coverage
7863                     build package with Haskell Program Coverage.  (GHC  only)
7864                     (DEPRECATED)
7865
7866              --enable-benchmarks
7867              --disable-benchmarks
7868                     dependency checking and compilation for benchmarks listed
7869                     in the package description file.
7870
7871              --enable-relocatable
7872              --disable-relocatable
7873                     building a package that is relocatable. (GHC only)
7874
7875              --disable-response-files
7876                     enable workaround for old versions of programs like  "ar"
7877                     that do not support @file arguments
7878
7879              --with-alex PATH
7880                     give the path to alex
7881
7882              --with-ar PATH
7883                     give the path to ar
7884
7885              --with-c2hs PATH
7886                     give the path to c2hs
7887
7888              --with-cpphs PATH
7889                     give the path to cpphs
7890
7891              --with-doctest PATH
7892                     give the path to doctest
7893
7894              --with-gcc PATH
7895                     give the path to gcc
7896
7897              --with-ghc PATH
7898                     give the path to ghc
7899
7900              --with-ghc-pkg PATH
7901                     give the path to ghc-pkg
7902
7903              --with-ghcjs PATH
7904                     give the path to ghcjs
7905
7906              --with-ghcjs-pkg PATH
7907                     give the path to ghcjs-pkg
7908
7909              --with-greencard PATH
7910                     give the path to greencard
7911
7912              --with-haddock PATH
7913                     give the path to haddock
7914
7915              --with-happy PATH
7916                     give the path to happy
7917
7918              --with-haskell-suite PATH
7919                     give the path to haskell-suite
7920
7921              --with-haskell-suite-pkg PATH
7922                     give the path to haskell-suite-pkg
7923
7924              --with-hmake PATH
7925                     give the path to hmake
7926
7927              --with-hpc PATH
7928                     give the path to hpc
7929
7930              --with-hsc2hs PATH
7931                     give the path to hsc2hs
7932
7933              --with-hscolour PATH
7934                     give the path to hscolour
7935
7936              --with-jhc PATH
7937                     give the path to jhc
7938
7939              --with-ld PATH
7940                     give the path to ld
7941
7942              --with-lhc PATH
7943                     give the path to lhc
7944
7945              --with-lhc-pkg PATH
7946                     give the path to lhc-pkg
7947
7948              --with-pkg-config PATH
7949                     give the path to pkg-config
7950
7951              --with-runghc PATH
7952                     give the path to runghc
7953
7954              --with-strip PATH
7955                     give the path to strip
7956
7957              --with-tar PATH
7958                     give the path to tar
7959
7960              --with-uhc PATH
7961                     give the path to uhc
7962
7963              --alex-option OPT
7964                     give  an  extra  option to alex (no need to quote options
7965                     containing spaces)
7966
7967              --ar-option OPT
7968                     give an extra option to ar (no need to quote options con‐
7969                     taining spaces)
7970
7971              --c2hs-option OPT
7972                     give  an  extra  option to c2hs (no need to quote options
7973                     containing spaces)
7974
7975              --cpphs-option OPT
7976                     give an extra option to cpphs (no need to  quote  options
7977                     containing spaces)
7978
7979              --doctest-option OPT
7980                     give an extra option to doctest (no need to quote options
7981                     containing spaces)
7982
7983              --gcc-option OPT
7984                     give an extra option to gcc (no  need  to  quote  options
7985                     containing spaces)
7986
7987              --ghc-option OPT
7988                     give  an  extra  option  to ghc (no need to quote options
7989                     containing spaces)
7990
7991              --ghc-pkg-option OPT
7992                     give an extra option to ghc-pkg (no need to quote options
7993                     containing spaces)
7994
7995              --ghcjs-option OPT
7996                     give  an  extra option to ghcjs (no need to quote options
7997                     containing spaces)
7998
7999              --ghcjs-pkg-option OPT
8000                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
8001                     options containing spaces)
8002
8003              --greencard-option OPT
8004                     give  an  extra  option  to  greencard  (no need to quote
8005                     options containing spaces)
8006
8007              --haddock-option OPT
8008                     give an extra option to haddock (no need to quote options
8009                     containing spaces)
8010
8011              --happy-option OPT
8012                     give  an  extra option to happy (no need to quote options
8013                     containing spaces)
8014
8015              --haskell-suite-option OPT
8016                     give an extra option to haskell-suite (no need  to  quote
8017                     options containing spaces)
8018
8019              --haskell-suite-pkg-option OPT
8020                     give  an  extra  option  to haskell-suite-pkg (no need to
8021                     quote options containing spaces)
8022
8023              --hmake-option OPT
8024                     give an extra option to hmake (no need to  quote  options
8025                     containing spaces)
8026
8027              --hpc-option OPT
8028                     give  an  extra  option  to hpc (no need to quote options
8029                     containing spaces)
8030
8031              --hsc2hs-option OPT
8032                     give an extra option to hsc2hs (no need to quote  options
8033                     containing spaces)
8034
8035              --hscolour-option OPT
8036                     give  an  extra  option  to  hscolour  (no  need to quote
8037                     options containing spaces)
8038
8039              --jhc-option OPT
8040                     give an extra option to jhc (no  need  to  quote  options
8041                     containing spaces)
8042
8043              --ld-option OPT
8044                     give an extra option to ld (no need to quote options con‐
8045                     taining spaces)
8046
8047              --lhc-option OPT
8048                     give an extra option to lhc (no  need  to  quote  options
8049                     containing spaces)
8050
8051              --lhc-pkg-option OPT
8052                     give an extra option to lhc-pkg (no need to quote options
8053                     containing spaces)
8054
8055              --pkg-config-option OPT
8056                     give an extra option to  pkg-config  (no  need  to  quote
8057                     options containing spaces)
8058
8059              --runghc-option OPT
8060                     give  an extra option to runghc (no need to quote options
8061                     containing spaces)
8062
8063              --strip-option OPT
8064                     give an extra option to strip (no need to  quote  options
8065                     containing spaces)
8066
8067              --tar-option OPT
8068                     give  an  extra  option  to tar (no need to quote options
8069                     containing spaces)
8070
8071              --uhc-option OPT
8072                     give an extra option to uhc (no  need  to  quote  options
8073                     containing spaces)
8074
8075              --alex-options OPTS
8076                     give extra options to alex
8077
8078              --ar-options OPTS
8079                     give extra options to ar
8080
8081              --c2hs-options OPTS
8082                     give extra options to c2hs
8083
8084              --cpphs-options OPTS
8085                     give extra options to cpphs
8086
8087              --doctest-options OPTS
8088                     give extra options to doctest
8089
8090              --gcc-options OPTS
8091                     give extra options to gcc
8092
8093              --ghc-options OPTS
8094                     give extra options to ghc
8095
8096              --ghc-pkg-options OPTS
8097                     give extra options to ghc-pkg
8098
8099              --ghcjs-options OPTS
8100                     give extra options to ghcjs
8101
8102              --ghcjs-pkg-options OPTS
8103                     give extra options to ghcjs-pkg
8104
8105              --greencard-options OPTS
8106                     give extra options to greencard
8107
8108              --haddock-options OPTS
8109                     give extra options to haddock
8110
8111              --happy-options OPTS
8112                     give extra options to happy
8113
8114              --haskell-suite-options OPTS
8115                     give extra options to haskell-suite
8116
8117              --haskell-suite-pkg-options OPTS
8118                     give extra options to haskell-suite-pkg
8119
8120              --hmake-options OPTS
8121                     give extra options to hmake
8122
8123              --hpc-options OPTS
8124                     give extra options to hpc
8125
8126              --hsc2hs-options OPTS
8127                     give extra options to hsc2hs
8128
8129              --hscolour-options OPTS
8130                     give extra options to hscolour
8131
8132              --jhc-options OPTS
8133                     give extra options to jhc
8134
8135              --ld-options OPTS
8136                     give extra options to ld
8137
8138              --lhc-options OPTS
8139                     give extra options to lhc
8140
8141              --lhc-pkg-options OPTS
8142                     give extra options to lhc-pkg
8143
8144              --pkg-config-options OPTS
8145                     give extra options to pkg-config
8146
8147              --runghc-options OPTS
8148                     give extra options to runghc
8149
8150              --strip-options OPTS
8151                     give extra options to strip
8152
8153              --tar-options OPTS
8154                     give extra options to tar
8155
8156              --uhc-options OPTS
8157                     give extra options to uhc
8158
8159              --cabal-lib-version VERSION
8160                     Select  which  version  of  the Cabal lib to use to build
8161                     packages (useful for testing).
8162
8163              --constraint CONSTRAINT
8164                     Specify    constraints    on    a    package    (version,
8165                     installed/source, flags)
8166
8167              --preference CONSTRAINT
8168                     Specify  preferences (soft constraints) on the version of
8169                     a package
8170
8171              --solver SOLVER
8172                     Select  dependency  solver  to  use  (default:  modular).
8173                     Choices: modular.
8174
8175              --allow-older [DEPS]
8176                     Ignore lower bounds in all dependencies or DEPS
8177
8178              --allow-newer [DEPS]
8179                     Ignore upper bounds in all dependencies or DEPS
8180
8181              --enable-documentation
8182              --disable-documentation
8183                     building of documentation
8184
8185              --doc-index-file TEMPLATE
8186                     A  central  index  of haddock API documentation (template
8187                     cannot use $pkgid)
8188
8189              --dry-run
8190                     Do  not  install  anything,  only  print  what  would  be
8191                     installed.
8192
8193              --max-backjumps NUM
8194                     Maximum   number   of  backjumps  allowed  while  solving
8195                     (default: 2000). Use a negative number to  enable  unlim‐
8196                     ited  backtracking.  Use  0  to disable backtracking com‐
8197                     pletely.
8198
8199              --reorder-goals
8200              --no-reorder-goals
8201                     Try to reorder goals  according  to  certain  heuristics.
8202                     Slows  things  down on average, but may make backtracking
8203                     faster for some packages.
8204
8205              --count-conflicts
8206              --no-count-conflicts
8207                     Try to speed up solving  by  preferring  goals  that  are
8208                     involved in a lot of conflicts (default).
8209
8210              --independent-goals
8211              --no-independent-goals
8212                     Treat  several  goals on the command line as independent.
8213                     If several goals depend on the  same  package,  different
8214                     versions can be chosen.
8215
8216              --shadow-installed-packages
8217              --no-shadow-installed-packages
8218                     If  multiple  package  instances  of the same version are
8219                     installed, treat all but one as shadowed.
8220
8221              --strong-flags
8222              --no-strong-flags
8223                     Do not defer flag choices (this used to be the default in
8224                     cabal-install <= 1.20).
8225
8226              --allow-boot-library-installs
8227              --no-allow-boot-library-installs
8228                     Allow  cabal  to  install base, ghc-prim, integer-simple,
8229                     integer-gmp, and template-haskell.
8230
8231              --reinstall
8232              --no-reinstall
8233                     Install even if it  means  installing  the  same  version
8234                     again.
8235
8236              --avoid-reinstalls
8237              --no-avoid-reinstalls
8238                     Do not select versions that would destructively overwrite
8239                     installed packages.
8240
8241              --force-reinstalls
8242              --no-force-reinstalls
8243                     Reinstall packages even if they will  most  likely  break
8244                     other installed packages.
8245
8246              --upgrade-dependencies
8247              --no-upgrade-dependencies
8248                     Pick the latest version for all dependencies, rather than
8249                     trying to pick an installed version.
8250
8251              --only-dependencies
8252              --no-only-dependencies
8253                     Install only the  dependencies  necessary  to  build  the
8254                     given packages
8255
8256              --dependencies-only
8257              --no-dependencies-only
8258                     A synonym for --only-dependencies
8259
8260              --index-state STATE
8261                     Use  source package index state as it existed at a previ‐
8262                     ous time. Accepts unix-timestamps  (e.g.  '@1474732068'),
8263                     ISO8601  UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or
8264                     'HEAD' (default: 'HEAD').
8265
8266              --root-cmd COMMAND
8267                     (No longer supported, do not use.)
8268
8269              --symlink-bindir DIR
8270                     Add symlinks to installed executables  into  this  direc‐
8271                     tory.
8272
8273              --build-summary TEMPLATE
8274                     Save  build  summaries  to  file  (name  template can use
8275                     $pkgid, $compiler, $os, $arch)
8276
8277              --build-log TEMPLATE
8278                     Log all builds to file (name  template  can  use  $pkgid,
8279                     $compiler, $os, $arch)
8280
8281              --remote-build-reporting LEVEL
8282                     Generate  build reports to send to a remote server (none,
8283                     anonymous or detailed).
8284
8285              --report-planning-failure
8286                     Generate build reports when the dependency solver  fails.
8287                     This is used by the Hackage build bot.
8288
8289              --enable-per-component
8290              --disable-per-component
8291                     Per-component builds when possible
8292
8293              --one-shot
8294              --no-one-shot
8295                     Do not record the packages in the world file.
8296
8297              --run-tests
8298                     Run package test suites during installation.
8299
8300              -j, --jobs [NUM]
8301                     Run  NUM  jobs  simultaneously  (or '$ncpus' if no NUM is
8302                     given).
8303
8304              --keep-going
8305                     After a build failure, continue to build other unaffected
8306                     packages.
8307
8308              --offline
8309              --no-offline
8310                     Don't download packages from the Internet.
8311
8312              --project-file FILE
8313                     Set  the  name of the cabal.project file to search for in
8314                     parent directories
8315
8316              --only
8317                     Only installs the package in the current directory.
8318
8319              --haddock-hoogle
8320                     Generate a hoogle database
8321
8322              --haddock-html
8323                     Generate HTML documentation (the default)
8324
8325              --haddock-html-location URL
8326                     Location of HTML documentation for pre-requisite packages
8327
8328              --haddock-for-hackage
8329                     Collection of flags to  generate  documentation  suitable
8330                     for upload to hackage
8331
8332              --haddock-executables
8333                     Run haddock for Executables targets
8334
8335              --haddock-tests
8336                     Run haddock for Test Suite targets
8337
8338              --haddock-benchmarks
8339                     Run haddock for Benchmark targets
8340
8341              --haddock-all
8342                     Run haddock for all targets
8343
8344              --haddock-internal
8345                     Run haddock for internal modules and include all symbols
8346
8347              --haddock-css PATH
8348                     Use PATH as the haddock stylesheet
8349
8350              --haddock-hyperlink-source, --haddock-hyperlink-sources
8351                     Hyperlink the documentation to the source code
8352
8353              --haddock-hscolour-css PATH
8354                     Use PATH as the HsColour stylesheet
8355
8356              --haddock-contents-location URL
8357                     Bake URL in as the location for the contents page
8358
8359
8360       cabal new-haddock
8361
8362       Usage: cabal new-haddock [FLAGS] TARGET
8363
8364
8365       Build  Haddock  documentation  for  the  specified  packages within the
8366       project.
8367
8368       Any package in the project can be specified. If no  package  is  speci‐
8369       fied,  the default is to build the documentation for the package in the
8370       current directory. The default behaviour is to build documentation  for
8371       the  exposed  modules  of  the  library component (if any). This can be
8372       changed with the
8373
8374       Currently, documentation for dependencies is NOT built.  This  behavior
8375       may change in future.
8376
8377       Additional configuration flags can be specified on the command line and
8378       these extend the project configuration from the 'cabal.project',
8379
8380
8381       Examples:
8382         cabal new-haddock pkgname     Build  documentation  for  the  package
8383       named pkgname
8384
8385       Note:  this  command  is part of the new project-based system (aka nix-
8386       style local builds). These features are currently in beta.  Please  see
8387       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
8388       details and advice on what you can expect to  work.  If  you  encounter
8389       problems  please file issues at https://github.com/haskell/cabal/issues
8390       and if you have any time to get involved and help with testing,  fixing
8391       bugs etc then that is very much appreciated.
8392
8393
8394       Flags:
8395              -v, --verbose [n]
8396                     Control  verbosity (n is 0--3, default verbosity level is
8397                     1)
8398
8399              --builddir, --distdir, --distpref DIR
8400                     The directory where  Cabal  puts  generated  build  files
8401                     (default dist)
8402
8403              -g, --ghc
8404                     compile with GHC
8405
8406              --ghcjs
8407                     compile with GHCJS
8408
8409              --jhc
8410                     compile with JHC
8411
8412              --lhc
8413                     compile with LHC
8414
8415              --uhc
8416                     compile with UHC
8417
8418              --haskell-suite
8419                     compile with a haskell-suite compiler
8420
8421              --cabal-file PATH
8422                     use this Cabal file
8423
8424              -w, --with-compiler PATH
8425                     give the path to a particular compiler
8426
8427              --with-hc-pkg PATH
8428                     give the path to the package tool
8429
8430              --prefix DIR
8431                     bake this prefix in preparation of installation
8432
8433              --bindir DIR
8434                     installation directory for executables
8435
8436              --libdir DIR
8437                     installation directory for libraries
8438
8439              --libsubdir DIR
8440                     subdirectory of libdir in which libs are installed
8441
8442              --dynlibdir DIR
8443                     installation directory for dynamic libraries
8444
8445              --libexecdir DIR
8446                     installation directory for program executables
8447
8448              --libexecsubdir DIR
8449                     subdirectory  of  libexecdir in which private executables
8450                     are installed
8451
8452              --datadir DIR
8453                     installation directory for read-only data
8454
8455              --datasubdir DIR
8456                     subdirectory of datadir in which data files are installed
8457
8458              --docdir DIR
8459                     installation directory for documentation
8460
8461              --htmldir DIR
8462                     installation directory for HTML documentation
8463
8464              --haddockdir DIR
8465                     installation directory for haddock interfaces
8466
8467              --sysconfdir DIR
8468                     installation directory for configuration files
8469
8470              --program-prefix PREFIX
8471                     prefix to be applied to installed executables
8472
8473              --program-suffix SUFFIX
8474                     suffix to be applied to installed executables
8475
8476              --enable-library-vanilla
8477              --disable-library-vanilla
8478                     Vanilla libraries
8479
8480              -p, --enable-library-profiling
8481              --disable-library-profiling
8482                     Library profiling
8483
8484              --enable-shared
8485              --disable-shared
8486                     Shared library
8487
8488              --enable-static
8489              --disable-static
8490                     Static library
8491
8492              --enable-executable-dynamic
8493              --disable-executable-dynamic
8494                     Executable dynamic linking
8495
8496              --enable-profiling
8497              --disable-profiling
8498                     Executable and library profiling
8499
8500              --enable-executable-profiling
8501              --disable-executable-profiling
8502                     Executable profiling (DEPRECATED)
8503
8504              --profiling-detail level
8505                     Profiling  detail  level  for  executable   and   library
8506                     (default,  none,  exported-functions, toplevel-functions,
8507                     all-functions).
8508
8509              --library-profiling-detail level
8510                     Profiling detail level for libraries only.
8511
8512              -O, --enable-optimization, --enable-optimisation [n]
8513                     Build with optimization (n is 0--2, default is 1)
8514
8515              --disable-optimization, --disable-optimisation
8516                     Build without optimization
8517
8518              --enable-debug-info [n]
8519                     Emit debug info (n is 0--3, default is 0)
8520
8521              --disable-debug-info
8522                     Don't emit debug info
8523
8524              --enable-library-for-ghci
8525              --disable-library-for-ghci
8526                     compile library for use with GHCi
8527
8528              --enable-split-sections
8529              --disable-split-sections
8530                     compile library code such that unneeded  definitions  can
8531                     be dropped from the final executable (GHC 7.8+)
8532
8533              --enable-split-objs
8534              --disable-split-objs
8535                     split library into smaller objects to reduce binary sizes
8536                     (GHC 6.6+)
8537
8538              --enable-executable-stripping
8539              --disable-executable-stripping
8540                     strip executables  upon  installation  to  reduce  binary
8541                     sizes
8542
8543              --enable-library-stripping
8544              --disable-library-stripping
8545                     strip libraries upon installation to reduce binary sizes
8546
8547              --configure-option OPT
8548                     Extra option for configure
8549
8550              --user
8551              --global
8552                     doing a per-user installation
8553
8554              --package-db DB
8555                     Append  the given package database to the list of package
8556                     databases used  (to  satisfy  dependencies  and  register
8557                     into).  May  be  a specific file, 'global' or 'user'. The
8558                     initial  list  is  ['global'],  ['global',  'user'],   or
8559                     ['global',  $sandbox],  depending on context. Use 'clear'
8560                     to reset the list  to  empty.  See  the  user  guide  for
8561                     details.
8562
8563              -f, --flags FLAGS
8564                     Force values for the given flags in Cabal conditionals in
8565                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
8566                     forces  the  flag "debug" to true and "usebytestrings" to
8567                     false.
8568
8569              --extra-include-dirs PATH
8570                     A list of directories to search for header files
8571
8572              --enable-deterministic
8573              --disable-deterministic
8574                     Try to be as deterministic as possible (used by the  test
8575                     suite)
8576
8577              --ipid IPID
8578                     Installed package ID to compile this package as
8579
8580              --cid CID
8581                     Installed component ID to compile this component as
8582
8583              --extra-lib-dirs PATH
8584                     A list of directories to search for external libraries
8585
8586              --extra-framework-dirs PATH
8587                     A  list  of directories to search for external frameworks
8588                     (OS X only)
8589
8590              --extra-prog-path PATH
8591                     A list of directories to search for required programs (in
8592                     addition to the normal search locations)
8593
8594              --instantiate-with NAME=MOD
8595                     A mapping of signature names to concrete module instanti‐
8596                     ations.
8597
8598              --enable-tests
8599              --disable-tests
8600                     dependency  checking  and  compilation  for  test  suites
8601                     listed in the package description file.
8602
8603              --enable-coverage
8604              --disable-coverage
8605                     build package with Haskell Program Coverage. (GHC only)
8606
8607              --enable-library-coverage
8608              --disable-library-coverage
8609                     build  package  with Haskell Program Coverage. (GHC only)
8610                     (DEPRECATED)
8611
8612              --enable-benchmarks
8613              --disable-benchmarks
8614                     dependency checking and compilation for benchmarks listed
8615                     in the package description file.
8616
8617              --enable-relocatable
8618              --disable-relocatable
8619                     building a package that is relocatable. (GHC only)
8620
8621              --disable-response-files
8622                     enable  workaround for old versions of programs like "ar"
8623                     that do not support @file arguments
8624
8625              --with-alex PATH
8626                     give the path to alex
8627
8628              --with-ar PATH
8629                     give the path to ar
8630
8631              --with-c2hs PATH
8632                     give the path to c2hs
8633
8634              --with-cpphs PATH
8635                     give the path to cpphs
8636
8637              --with-doctest PATH
8638                     give the path to doctest
8639
8640              --with-gcc PATH
8641                     give the path to gcc
8642
8643              --with-ghc PATH
8644                     give the path to ghc
8645
8646              --with-ghc-pkg PATH
8647                     give the path to ghc-pkg
8648
8649              --with-ghcjs PATH
8650                     give the path to ghcjs
8651
8652              --with-ghcjs-pkg PATH
8653                     give the path to ghcjs-pkg
8654
8655              --with-greencard PATH
8656                     give the path to greencard
8657
8658              --with-haddock PATH
8659                     give the path to haddock
8660
8661              --with-happy PATH
8662                     give the path to happy
8663
8664              --with-haskell-suite PATH
8665                     give the path to haskell-suite
8666
8667              --with-haskell-suite-pkg PATH
8668                     give the path to haskell-suite-pkg
8669
8670              --with-hmake PATH
8671                     give the path to hmake
8672
8673              --with-hpc PATH
8674                     give the path to hpc
8675
8676              --with-hsc2hs PATH
8677                     give the path to hsc2hs
8678
8679              --with-hscolour PATH
8680                     give the path to hscolour
8681
8682              --with-jhc PATH
8683                     give the path to jhc
8684
8685              --with-ld PATH
8686                     give the path to ld
8687
8688              --with-lhc PATH
8689                     give the path to lhc
8690
8691              --with-lhc-pkg PATH
8692                     give the path to lhc-pkg
8693
8694              --with-pkg-config PATH
8695                     give the path to pkg-config
8696
8697              --with-runghc PATH
8698                     give the path to runghc
8699
8700              --with-strip PATH
8701                     give the path to strip
8702
8703              --with-tar PATH
8704                     give the path to tar
8705
8706              --with-uhc PATH
8707                     give the path to uhc
8708
8709              --alex-option OPT
8710                     give an extra option to alex (no need  to  quote  options
8711                     containing spaces)
8712
8713              --ar-option OPT
8714                     give an extra option to ar (no need to quote options con‐
8715                     taining spaces)
8716
8717              --c2hs-option OPT
8718                     give an extra option to c2hs (no need  to  quote  options
8719                     containing spaces)
8720
8721              --cpphs-option OPT
8722                     give  an  extra option to cpphs (no need to quote options
8723                     containing spaces)
8724
8725              --doctest-option OPT
8726                     give an extra option to doctest (no need to quote options
8727                     containing spaces)
8728
8729              --gcc-option OPT
8730                     give  an  extra  option  to gcc (no need to quote options
8731                     containing spaces)
8732
8733              --ghc-option OPT
8734                     give an extra option to ghc (no  need  to  quote  options
8735                     containing spaces)
8736
8737              --ghc-pkg-option OPT
8738                     give an extra option to ghc-pkg (no need to quote options
8739                     containing spaces)
8740
8741              --ghcjs-option OPT
8742                     give an extra option to ghcjs (no need to  quote  options
8743                     containing spaces)
8744
8745              --ghcjs-pkg-option OPT
8746                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
8747                     options containing spaces)
8748
8749              --greencard-option OPT
8750                     give an extra option  to  greencard  (no  need  to  quote
8751                     options containing spaces)
8752
8753              --haddock-option OPT
8754                     give an extra option to haddock (no need to quote options
8755                     containing spaces)
8756
8757              --happy-option OPT
8758                     give an extra option to happy (no need to  quote  options
8759                     containing spaces)
8760
8761              --haskell-suite-option OPT
8762                     give  an  extra option to haskell-suite (no need to quote
8763                     options containing spaces)
8764
8765              --haskell-suite-pkg-option OPT
8766                     give an extra option to  haskell-suite-pkg  (no  need  to
8767                     quote options containing spaces)
8768
8769              --hmake-option OPT
8770                     give  an  extra option to hmake (no need to quote options
8771                     containing spaces)
8772
8773              --hpc-option OPT
8774                     give an extra option to hpc (no  need  to  quote  options
8775                     containing spaces)
8776
8777              --hsc2hs-option OPT
8778                     give  an extra option to hsc2hs (no need to quote options
8779                     containing spaces)
8780
8781              --hscolour-option OPT
8782                     give an extra  option  to  hscolour  (no  need  to  quote
8783                     options containing spaces)
8784
8785              --jhc-option OPT
8786                     give  an  extra  option  to jhc (no need to quote options
8787                     containing spaces)
8788
8789              --ld-option OPT
8790                     give an extra option to ld (no need to quote options con‐
8791                     taining spaces)
8792
8793              --lhc-option OPT
8794                     give  an  extra  option  to lhc (no need to quote options
8795                     containing spaces)
8796
8797              --lhc-pkg-option OPT
8798                     give an extra option to lhc-pkg (no need to quote options
8799                     containing spaces)
8800
8801              --pkg-config-option OPT
8802                     give  an  extra  option  to  pkg-config (no need to quote
8803                     options containing spaces)
8804
8805              --runghc-option OPT
8806                     give an extra option to runghc (no need to quote  options
8807                     containing spaces)
8808
8809              --strip-option OPT
8810                     give  an  extra option to strip (no need to quote options
8811                     containing spaces)
8812
8813              --tar-option OPT
8814                     give an extra option to tar (no  need  to  quote  options
8815                     containing spaces)
8816
8817              --uhc-option OPT
8818                     give  an  extra  option  to uhc (no need to quote options
8819                     containing spaces)
8820
8821              --alex-options OPTS
8822                     give extra options to alex
8823
8824              --ar-options OPTS
8825                     give extra options to ar
8826
8827              --c2hs-options OPTS
8828                     give extra options to c2hs
8829
8830              --cpphs-options OPTS
8831                     give extra options to cpphs
8832
8833              --doctest-options OPTS
8834                     give extra options to doctest
8835
8836              --gcc-options OPTS
8837                     give extra options to gcc
8838
8839              --ghc-options OPTS
8840                     give extra options to ghc
8841
8842              --ghc-pkg-options OPTS
8843                     give extra options to ghc-pkg
8844
8845              --ghcjs-options OPTS
8846                     give extra options to ghcjs
8847
8848              --ghcjs-pkg-options OPTS
8849                     give extra options to ghcjs-pkg
8850
8851              --greencard-options OPTS
8852                     give extra options to greencard
8853
8854              --haddock-options OPTS
8855                     give extra options to haddock
8856
8857              --happy-options OPTS
8858                     give extra options to happy
8859
8860              --haskell-suite-options OPTS
8861                     give extra options to haskell-suite
8862
8863              --haskell-suite-pkg-options OPTS
8864                     give extra options to haskell-suite-pkg
8865
8866              --hmake-options OPTS
8867                     give extra options to hmake
8868
8869              --hpc-options OPTS
8870                     give extra options to hpc
8871
8872              --hsc2hs-options OPTS
8873                     give extra options to hsc2hs
8874
8875              --hscolour-options OPTS
8876                     give extra options to hscolour
8877
8878              --jhc-options OPTS
8879                     give extra options to jhc
8880
8881              --ld-options OPTS
8882                     give extra options to ld
8883
8884              --lhc-options OPTS
8885                     give extra options to lhc
8886
8887              --lhc-pkg-options OPTS
8888                     give extra options to lhc-pkg
8889
8890              --pkg-config-options OPTS
8891                     give extra options to pkg-config
8892
8893              --runghc-options OPTS
8894                     give extra options to runghc
8895
8896              --strip-options OPTS
8897                     give extra options to strip
8898
8899              --tar-options OPTS
8900                     give extra options to tar
8901
8902              --uhc-options OPTS
8903                     give extra options to uhc
8904
8905              --cabal-lib-version VERSION
8906                     Select which version of the Cabal lib  to  use  to  build
8907                     packages (useful for testing).
8908
8909              --constraint CONSTRAINT
8910                     Specify    constraints    on    a    package    (version,
8911                     installed/source, flags)
8912
8913              --preference CONSTRAINT
8914                     Specify preferences (soft constraints) on the version  of
8915                     a package
8916
8917              --solver SOLVER
8918                     Select  dependency  solver  to  use  (default:  modular).
8919                     Choices: modular.
8920
8921              --allow-older [DEPS]
8922                     Ignore lower bounds in all dependencies or DEPS
8923
8924              --allow-newer [DEPS]
8925                     Ignore upper bounds in all dependencies or DEPS
8926
8927              --enable-documentation
8928              --disable-documentation
8929                     building of documentation
8930
8931              --doc-index-file TEMPLATE
8932                     A central index of haddock  API  documentation  (template
8933                     cannot use $pkgid)
8934
8935              --dry-run
8936                     Do  not  install  anything,  only  print  what  would  be
8937                     installed.
8938
8939              --max-backjumps NUM
8940                     Maximum  number  of  backjumps  allowed   while   solving
8941                     (default:  2000).  Use a negative number to enable unlim‐
8942                     ited backtracking. Use 0  to  disable  backtracking  com‐
8943                     pletely.
8944
8945              --reorder-goals
8946              --no-reorder-goals
8947                     Try  to  reorder  goals  according to certain heuristics.
8948                     Slows things down on average, but may  make  backtracking
8949                     faster for some packages.
8950
8951              --count-conflicts
8952              --no-count-conflicts
8953                     Try  to  speed  up  solving  by preferring goals that are
8954                     involved in a lot of conflicts (default).
8955
8956              --independent-goals
8957              --no-independent-goals
8958                     Treat several goals on the command line  as  independent.
8959                     If  several  goals  depend on the same package, different
8960                     versions can be chosen.
8961
8962              --shadow-installed-packages
8963              --no-shadow-installed-packages
8964                     If multiple package instances of  the  same  version  are
8965                     installed, treat all but one as shadowed.
8966
8967              --strong-flags
8968              --no-strong-flags
8969                     Do not defer flag choices (this used to be the default in
8970                     cabal-install <= 1.20).
8971
8972              --allow-boot-library-installs
8973              --no-allow-boot-library-installs
8974                     Allow cabal to install  base,  ghc-prim,  integer-simple,
8975                     integer-gmp, and template-haskell.
8976
8977              --reinstall
8978              --no-reinstall
8979                     Install  even  if  it  means  installing the same version
8980                     again.
8981
8982              --avoid-reinstalls
8983              --no-avoid-reinstalls
8984                     Do not select versions that would destructively overwrite
8985                     installed packages.
8986
8987              --force-reinstalls
8988              --no-force-reinstalls
8989                     Reinstall  packages  even  if they will most likely break
8990                     other installed packages.
8991
8992              --upgrade-dependencies
8993              --no-upgrade-dependencies
8994                     Pick the latest version for all dependencies, rather than
8995                     trying to pick an installed version.
8996
8997              --only-dependencies
8998              --no-only-dependencies
8999                     Install  only  the  dependencies  necessary  to build the
9000                     given packages
9001
9002              --dependencies-only
9003              --no-dependencies-only
9004                     A synonym for --only-dependencies
9005
9006              --index-state STATE
9007                     Use source package index state as it existed at a  previ‐
9008                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
9009                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
9010                     'HEAD' (default: 'HEAD').
9011
9012              --root-cmd COMMAND
9013                     (No longer supported, do not use.)
9014
9015              --symlink-bindir DIR
9016                     Add  symlinks  to  installed executables into this direc‐
9017                     tory.
9018
9019              --build-summary TEMPLATE
9020                     Save build summaries  to  file  (name  template  can  use
9021                     $pkgid, $compiler, $os, $arch)
9022
9023              --build-log TEMPLATE
9024                     Log  all  builds  to  file (name template can use $pkgid,
9025                     $compiler, $os, $arch)
9026
9027              --remote-build-reporting LEVEL
9028                     Generate build reports to send to a remote server  (none,
9029                     anonymous or detailed).
9030
9031              --report-planning-failure
9032                     Generate  build reports when the dependency solver fails.
9033                     This is used by the Hackage build bot.
9034
9035              --enable-per-component
9036              --disable-per-component
9037                     Per-component builds when possible
9038
9039              --one-shot
9040              --no-one-shot
9041                     Do not record the packages in the world file.
9042
9043              --run-tests
9044                     Run package test suites during installation.
9045
9046              -j, --jobs [NUM]
9047                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
9048                     given).
9049
9050              --keep-going
9051                     After a build failure, continue to build other unaffected
9052                     packages.
9053
9054              --offline
9055              --no-offline
9056                     Don't download packages from the Internet.
9057
9058              --project-file FILE
9059                     Set the name of the cabal.project file to search  for  in
9060                     parent directories
9061
9062              --only
9063                     Only installs the package in the current directory.
9064
9065              --haddock-hoogle
9066                     Generate a hoogle database
9067
9068              --haddock-html
9069                     Generate HTML documentation (the default)
9070
9071              --haddock-html-location URL
9072                     Location of HTML documentation for pre-requisite packages
9073
9074              --haddock-for-hackage
9075                     Collection  of  flags  to generate documentation suitable
9076                     for upload to hackage
9077
9078              --haddock-executables
9079                     Run haddock for Executables targets
9080
9081              --haddock-tests
9082                     Run haddock for Test Suite targets
9083
9084              --haddock-benchmarks
9085                     Run haddock for Benchmark targets
9086
9087              --haddock-all
9088                     Run haddock for all targets
9089
9090              --haddock-internal
9091                     Run haddock for internal modules and include all symbols
9092
9093              --haddock-css PATH
9094                     Use PATH as the haddock stylesheet
9095
9096              --haddock-hyperlink-source, --haddock-hyperlink-sources
9097                     Hyperlink the documentation to the source code
9098
9099              --haddock-hscolour-css PATH
9100                     Use PATH as the HsColour stylesheet
9101
9102              --haddock-contents-location URL
9103                     Bake URL in as the location for the contents page
9104
9105
9106       cabal new-install
9107
9108       Usage: cabal new-install [TARGETS] [FLAGS]
9109
9110
9111       Installs one or more packages. This is done by installing them  in  the
9112       store  and symlinking the executables in the directory specified by the
9113       --symlink-bindir flag (`~/.cabal/bin/` by default).  If  you  want  the
9114       installed executables to be available globally, make sure that the PATH
9115       environment variable contains that directory.
9116
9117       If TARGET is a library, it will be added  to  the  global  environment.
9118       When  doing  this, cabal will try to build a plan that includes all the
9119       previously installed libraries. This is currently not implemented.
9120
9121
9122       Examples:
9123         cabal new-install
9124           Install the package in the current directory
9125         cabal new-install pkgname
9126           Install the package named pkgname (fetching it from hackage if nec‐
9127       essary)
9128         cabal new-install ./pkgfoo
9129           Install the package in the ./pkgfoo directory Note: this command is
9130       part of the new project-based  system  (aka  nix-style  local  builds).
9131       These  features are currently in beta. Please see http://cabal.readthe
9132       docs.io/en/latest/nix-local-build-overview.html for details and  advice
9133       on  what  you can expect to work. If you encounter problems please file
9134       issues at https://github.com/haskell/cabal/issues and if you  have  any
9135       time  to  get involved and help with testing, fixing bugs etc then that
9136       is very much appreciated.
9137
9138
9139       Flags:
9140              -v, --verbose [n]
9141                     Control verbosity (n is 0--3, default verbosity level  is
9142                     1)
9143
9144              --builddir, --distdir, --distpref DIR
9145                     The  directory  where  Cabal  puts  generated build files
9146                     (default dist)
9147
9148              -g, --ghc
9149                     compile with GHC
9150
9151              --ghcjs
9152                     compile with GHCJS
9153
9154              --jhc
9155                     compile with JHC
9156
9157              --lhc
9158                     compile with LHC
9159
9160              --uhc
9161                     compile with UHC
9162
9163              --haskell-suite
9164                     compile with a haskell-suite compiler
9165
9166              --cabal-file PATH
9167                     use this Cabal file
9168
9169              -w, --with-compiler PATH
9170                     give the path to a particular compiler
9171
9172              --with-hc-pkg PATH
9173                     give the path to the package tool
9174
9175              --prefix DIR
9176                     bake this prefix in preparation of installation
9177
9178              --bindir DIR
9179                     installation directory for executables
9180
9181              --libdir DIR
9182                     installation directory for libraries
9183
9184              --libsubdir DIR
9185                     subdirectory of libdir in which libs are installed
9186
9187              --dynlibdir DIR
9188                     installation directory for dynamic libraries
9189
9190              --libexecdir DIR
9191                     installation directory for program executables
9192
9193              --libexecsubdir DIR
9194                     subdirectory of libexecdir in which  private  executables
9195                     are installed
9196
9197              --datadir DIR
9198                     installation directory for read-only data
9199
9200              --datasubdir DIR
9201                     subdirectory of datadir in which data files are installed
9202
9203              --docdir DIR
9204                     installation directory for documentation
9205
9206              --htmldir DIR
9207                     installation directory for HTML documentation
9208
9209              --haddockdir DIR
9210                     installation directory for haddock interfaces
9211
9212              --sysconfdir DIR
9213                     installation directory for configuration files
9214
9215              --program-prefix PREFIX
9216                     prefix to be applied to installed executables
9217
9218              --program-suffix SUFFIX
9219                     suffix to be applied to installed executables
9220
9221              --enable-library-vanilla
9222              --disable-library-vanilla
9223                     Vanilla libraries
9224
9225              -p, --enable-library-profiling
9226              --disable-library-profiling
9227                     Library profiling
9228
9229              --enable-shared
9230              --disable-shared
9231                     Shared library
9232
9233              --enable-static
9234              --disable-static
9235                     Static library
9236
9237              --enable-executable-dynamic
9238              --disable-executable-dynamic
9239                     Executable dynamic linking
9240
9241              --enable-profiling
9242              --disable-profiling
9243                     Executable and library profiling
9244
9245              --enable-executable-profiling
9246              --disable-executable-profiling
9247                     Executable profiling (DEPRECATED)
9248
9249              --profiling-detail level
9250                     Profiling   detail   level  for  executable  and  library
9251                     (default, none,  exported-functions,  toplevel-functions,
9252                     all-functions).
9253
9254              --library-profiling-detail level
9255                     Profiling detail level for libraries only.
9256
9257              -O, --enable-optimization, --enable-optimisation [n]
9258                     Build with optimization (n is 0--2, default is 1)
9259
9260              --disable-optimization, --disable-optimisation
9261                     Build without optimization
9262
9263              --enable-debug-info [n]
9264                     Emit debug info (n is 0--3, default is 0)
9265
9266              --disable-debug-info
9267                     Don't emit debug info
9268
9269              --enable-library-for-ghci
9270              --disable-library-for-ghci
9271                     compile library for use with GHCi
9272
9273              --enable-split-sections
9274              --disable-split-sections
9275                     compile  library  code such that unneeded definitions can
9276                     be dropped from the final executable (GHC 7.8+)
9277
9278              --enable-split-objs
9279              --disable-split-objs
9280                     split library into smaller objects to reduce binary sizes
9281                     (GHC 6.6+)
9282
9283              --enable-executable-stripping
9284              --disable-executable-stripping
9285                     strip  executables  upon  installation  to  reduce binary
9286                     sizes
9287
9288              --enable-library-stripping
9289              --disable-library-stripping
9290                     strip libraries upon installation to reduce binary sizes
9291
9292              --configure-option OPT
9293                     Extra option for configure
9294
9295              --user
9296              --global
9297                     doing a per-user installation
9298
9299              --package-db DB
9300                     Append the given package database to the list of  package
9301                     databases  used  (to  satisfy  dependencies  and register
9302                     into). May be a specific file, 'global'  or  'user'.  The
9303                     initial   list  is  ['global'],  ['global',  'user'],  or
9304                     ['global', $sandbox], depending on context.  Use  'clear'
9305                     to  reset  the  list  to  empty.  See  the user guide for
9306                     details.
9307
9308              -f, --flags FLAGS
9309                     Force values for the given flags in Cabal conditionals in
9310                     the  .cabal  file.  E.g., --flags="debug -usebytestrings"
9311                     forces the flag "debug" to true and  "usebytestrings"  to
9312                     false.
9313
9314              --extra-include-dirs PATH
9315                     A list of directories to search for header files
9316
9317              --enable-deterministic
9318              --disable-deterministic
9319                     Try  to be as deterministic as possible (used by the test
9320                     suite)
9321
9322              --ipid IPID
9323                     Installed package ID to compile this package as
9324
9325              --cid CID
9326                     Installed component ID to compile this component as
9327
9328              --extra-lib-dirs PATH
9329                     A list of directories to search for external libraries
9330
9331              --extra-framework-dirs PATH
9332                     A list of directories to search for  external  frameworks
9333                     (OS X only)
9334
9335              --extra-prog-path PATH
9336                     A list of directories to search for required programs (in
9337                     addition to the normal search locations)
9338
9339              --instantiate-with NAME=MOD
9340                     A mapping of signature names to concrete module instanti‐
9341                     ations.
9342
9343              --enable-tests
9344              --disable-tests
9345                     dependency  checking  and  compilation  for  test  suites
9346                     listed in the package description file.
9347
9348              --enable-coverage
9349              --disable-coverage
9350                     build package with Haskell Program Coverage. (GHC only)
9351
9352              --enable-library-coverage
9353              --disable-library-coverage
9354                     build package with Haskell Program Coverage.  (GHC  only)
9355                     (DEPRECATED)
9356
9357              --enable-benchmarks
9358              --disable-benchmarks
9359                     dependency checking and compilation for benchmarks listed
9360                     in the package description file.
9361
9362              --enable-relocatable
9363              --disable-relocatable
9364                     building a package that is relocatable. (GHC only)
9365
9366              --disable-response-files
9367                     enable workaround for old versions of programs like  "ar"
9368                     that do not support @file arguments
9369
9370              --with-alex PATH
9371                     give the path to alex
9372
9373              --with-ar PATH
9374                     give the path to ar
9375
9376              --with-c2hs PATH
9377                     give the path to c2hs
9378
9379              --with-cpphs PATH
9380                     give the path to cpphs
9381
9382              --with-doctest PATH
9383                     give the path to doctest
9384
9385              --with-gcc PATH
9386                     give the path to gcc
9387
9388              --with-ghc PATH
9389                     give the path to ghc
9390
9391              --with-ghc-pkg PATH
9392                     give the path to ghc-pkg
9393
9394              --with-ghcjs PATH
9395                     give the path to ghcjs
9396
9397              --with-ghcjs-pkg PATH
9398                     give the path to ghcjs-pkg
9399
9400              --with-greencard PATH
9401                     give the path to greencard
9402
9403              --with-haddock PATH
9404                     give the path to haddock
9405
9406              --with-happy PATH
9407                     give the path to happy
9408
9409              --with-haskell-suite PATH
9410                     give the path to haskell-suite
9411
9412              --with-haskell-suite-pkg PATH
9413                     give the path to haskell-suite-pkg
9414
9415              --with-hmake PATH
9416                     give the path to hmake
9417
9418              --with-hpc PATH
9419                     give the path to hpc
9420
9421              --with-hsc2hs PATH
9422                     give the path to hsc2hs
9423
9424              --with-hscolour PATH
9425                     give the path to hscolour
9426
9427              --with-jhc PATH
9428                     give the path to jhc
9429
9430              --with-ld PATH
9431                     give the path to ld
9432
9433              --with-lhc PATH
9434                     give the path to lhc
9435
9436              --with-lhc-pkg PATH
9437                     give the path to lhc-pkg
9438
9439              --with-pkg-config PATH
9440                     give the path to pkg-config
9441
9442              --with-runghc PATH
9443                     give the path to runghc
9444
9445              --with-strip PATH
9446                     give the path to strip
9447
9448              --with-tar PATH
9449                     give the path to tar
9450
9451              --with-uhc PATH
9452                     give the path to uhc
9453
9454              --alex-option OPT
9455                     give  an  extra  option to alex (no need to quote options
9456                     containing spaces)
9457
9458              --ar-option OPT
9459                     give an extra option to ar (no need to quote options con‐
9460                     taining spaces)
9461
9462              --c2hs-option OPT
9463                     give  an  extra  option to c2hs (no need to quote options
9464                     containing spaces)
9465
9466              --cpphs-option OPT
9467                     give an extra option to cpphs (no need to  quote  options
9468                     containing spaces)
9469
9470              --doctest-option OPT
9471                     give an extra option to doctest (no need to quote options
9472                     containing spaces)
9473
9474              --gcc-option OPT
9475                     give an extra option to gcc (no  need  to  quote  options
9476                     containing spaces)
9477
9478              --ghc-option OPT
9479                     give  an  extra  option  to ghc (no need to quote options
9480                     containing spaces)
9481
9482              --ghc-pkg-option OPT
9483                     give an extra option to ghc-pkg (no need to quote options
9484                     containing spaces)
9485
9486              --ghcjs-option OPT
9487                     give  an  extra option to ghcjs (no need to quote options
9488                     containing spaces)
9489
9490              --ghcjs-pkg-option OPT
9491                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
9492                     options containing spaces)
9493
9494              --greencard-option OPT
9495                     give  an  extra  option  to  greencard  (no need to quote
9496                     options containing spaces)
9497
9498              --haddock-option OPT
9499                     give an extra option to haddock (no need to quote options
9500                     containing spaces)
9501
9502              --happy-option OPT
9503                     give  an  extra option to happy (no need to quote options
9504                     containing spaces)
9505
9506              --haskell-suite-option OPT
9507                     give an extra option to haskell-suite (no need  to  quote
9508                     options containing spaces)
9509
9510              --haskell-suite-pkg-option OPT
9511                     give  an  extra  option  to haskell-suite-pkg (no need to
9512                     quote options containing spaces)
9513
9514              --hmake-option OPT
9515                     give an extra option to hmake (no need to  quote  options
9516                     containing spaces)
9517
9518              --hpc-option OPT
9519                     give  an  extra  option  to hpc (no need to quote options
9520                     containing spaces)
9521
9522              --hsc2hs-option OPT
9523                     give an extra option to hsc2hs (no need to quote  options
9524                     containing spaces)
9525
9526              --hscolour-option OPT
9527                     give  an  extra  option  to  hscolour  (no  need to quote
9528                     options containing spaces)
9529
9530              --jhc-option OPT
9531                     give an extra option to jhc (no  need  to  quote  options
9532                     containing spaces)
9533
9534              --ld-option OPT
9535                     give an extra option to ld (no need to quote options con‐
9536                     taining spaces)
9537
9538              --lhc-option OPT
9539                     give an extra option to lhc (no  need  to  quote  options
9540                     containing spaces)
9541
9542              --lhc-pkg-option OPT
9543                     give an extra option to lhc-pkg (no need to quote options
9544                     containing spaces)
9545
9546              --pkg-config-option OPT
9547                     give an extra option to  pkg-config  (no  need  to  quote
9548                     options containing spaces)
9549
9550              --runghc-option OPT
9551                     give  an extra option to runghc (no need to quote options
9552                     containing spaces)
9553
9554              --strip-option OPT
9555                     give an extra option to strip (no need to  quote  options
9556                     containing spaces)
9557
9558              --tar-option OPT
9559                     give  an  extra  option  to tar (no need to quote options
9560                     containing spaces)
9561
9562              --uhc-option OPT
9563                     give an extra option to uhc (no  need  to  quote  options
9564                     containing spaces)
9565
9566              --alex-options OPTS
9567                     give extra options to alex
9568
9569              --ar-options OPTS
9570                     give extra options to ar
9571
9572              --c2hs-options OPTS
9573                     give extra options to c2hs
9574
9575              --cpphs-options OPTS
9576                     give extra options to cpphs
9577
9578              --doctest-options OPTS
9579                     give extra options to doctest
9580
9581              --gcc-options OPTS
9582                     give extra options to gcc
9583
9584              --ghc-options OPTS
9585                     give extra options to ghc
9586
9587              --ghc-pkg-options OPTS
9588                     give extra options to ghc-pkg
9589
9590              --ghcjs-options OPTS
9591                     give extra options to ghcjs
9592
9593              --ghcjs-pkg-options OPTS
9594                     give extra options to ghcjs-pkg
9595
9596              --greencard-options OPTS
9597                     give extra options to greencard
9598
9599              --haddock-options OPTS
9600                     give extra options to haddock
9601
9602              --happy-options OPTS
9603                     give extra options to happy
9604
9605              --haskell-suite-options OPTS
9606                     give extra options to haskell-suite
9607
9608              --haskell-suite-pkg-options OPTS
9609                     give extra options to haskell-suite-pkg
9610
9611              --hmake-options OPTS
9612                     give extra options to hmake
9613
9614              --hpc-options OPTS
9615                     give extra options to hpc
9616
9617              --hsc2hs-options OPTS
9618                     give extra options to hsc2hs
9619
9620              --hscolour-options OPTS
9621                     give extra options to hscolour
9622
9623              --jhc-options OPTS
9624                     give extra options to jhc
9625
9626              --ld-options OPTS
9627                     give extra options to ld
9628
9629              --lhc-options OPTS
9630                     give extra options to lhc
9631
9632              --lhc-pkg-options OPTS
9633                     give extra options to lhc-pkg
9634
9635              --pkg-config-options OPTS
9636                     give extra options to pkg-config
9637
9638              --runghc-options OPTS
9639                     give extra options to runghc
9640
9641              --strip-options OPTS
9642                     give extra options to strip
9643
9644              --tar-options OPTS
9645                     give extra options to tar
9646
9647              --uhc-options OPTS
9648                     give extra options to uhc
9649
9650              --cabal-lib-version VERSION
9651                     Select  which  version  of  the Cabal lib to use to build
9652                     packages (useful for testing).
9653
9654              --constraint CONSTRAINT
9655                     Specify    constraints    on    a    package    (version,
9656                     installed/source, flags)
9657
9658              --preference CONSTRAINT
9659                     Specify  preferences (soft constraints) on the version of
9660                     a package
9661
9662              --solver SOLVER
9663                     Select  dependency  solver  to  use  (default:  modular).
9664                     Choices: modular.
9665
9666              --allow-older [DEPS]
9667                     Ignore lower bounds in all dependencies or DEPS
9668
9669              --allow-newer [DEPS]
9670                     Ignore upper bounds in all dependencies or DEPS
9671
9672              --enable-documentation
9673              --disable-documentation
9674                     building of documentation
9675
9676              --doc-index-file TEMPLATE
9677                     A  central  index  of haddock API documentation (template
9678                     cannot use $pkgid)
9679
9680              --dry-run
9681                     Do  not  install  anything,  only  print  what  would  be
9682                     installed.
9683
9684              --max-backjumps NUM
9685                     Maximum   number   of  backjumps  allowed  while  solving
9686                     (default: 2000). Use a negative number to  enable  unlim‐
9687                     ited  backtracking.  Use  0  to disable backtracking com‐
9688                     pletely.
9689
9690              --reorder-goals
9691              --no-reorder-goals
9692                     Try to reorder goals  according  to  certain  heuristics.
9693                     Slows  things  down on average, but may make backtracking
9694                     faster for some packages.
9695
9696              --count-conflicts
9697              --no-count-conflicts
9698                     Try to speed up solving  by  preferring  goals  that  are
9699                     involved in a lot of conflicts (default).
9700
9701              --independent-goals
9702              --no-independent-goals
9703                     Treat  several  goals on the command line as independent.
9704                     If several goals depend on the  same  package,  different
9705                     versions can be chosen.
9706
9707              --shadow-installed-packages
9708              --no-shadow-installed-packages
9709                     If  multiple  package  instances  of the same version are
9710                     installed, treat all but one as shadowed.
9711
9712              --strong-flags
9713              --no-strong-flags
9714                     Do not defer flag choices (this used to be the default in
9715                     cabal-install <= 1.20).
9716
9717              --allow-boot-library-installs
9718              --no-allow-boot-library-installs
9719                     Allow  cabal  to  install base, ghc-prim, integer-simple,
9720                     integer-gmp, and template-haskell.
9721
9722              --reinstall
9723              --no-reinstall
9724                     Install even if it  means  installing  the  same  version
9725                     again.
9726
9727              --avoid-reinstalls
9728              --no-avoid-reinstalls
9729                     Do not select versions that would destructively overwrite
9730                     installed packages.
9731
9732              --force-reinstalls
9733              --no-force-reinstalls
9734                     Reinstall packages even if they will  most  likely  break
9735                     other installed packages.
9736
9737              --upgrade-dependencies
9738              --no-upgrade-dependencies
9739                     Pick the latest version for all dependencies, rather than
9740                     trying to pick an installed version.
9741
9742              --only-dependencies
9743              --no-only-dependencies
9744                     Install only the  dependencies  necessary  to  build  the
9745                     given packages
9746
9747              --dependencies-only
9748              --no-dependencies-only
9749                     A synonym for --only-dependencies
9750
9751              --index-state STATE
9752                     Use  source package index state as it existed at a previ‐
9753                     ous time. Accepts unix-timestamps  (e.g.  '@1474732068'),
9754                     ISO8601  UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or
9755                     'HEAD' (default: 'HEAD').
9756
9757              --root-cmd COMMAND
9758                     (No longer supported, do not use.)
9759
9760              --symlink-bindir DIR
9761                     Add symlinks to installed executables  into  this  direc‐
9762                     tory.
9763
9764              --build-summary TEMPLATE
9765                     Save  build  summaries  to  file  (name  template can use
9766                     $pkgid, $compiler, $os, $arch)
9767
9768              --build-log TEMPLATE
9769                     Log all builds to file (name  template  can  use  $pkgid,
9770                     $compiler, $os, $arch)
9771
9772              --remote-build-reporting LEVEL
9773                     Generate  build reports to send to a remote server (none,
9774                     anonymous or detailed).
9775
9776              --report-planning-failure
9777                     Generate build reports when the dependency solver  fails.
9778                     This is used by the Hackage build bot.
9779
9780              --enable-per-component
9781              --disable-per-component
9782                     Per-component builds when possible
9783
9784              --one-shot
9785              --no-one-shot
9786                     Do not record the packages in the world file.
9787
9788              --run-tests
9789                     Run package test suites during installation.
9790
9791              -j, --jobs [NUM]
9792                     Run  NUM  jobs  simultaneously  (or '$ncpus' if no NUM is
9793                     given).
9794
9795              --keep-going
9796                     After a build failure, continue to build other unaffected
9797                     packages.
9798
9799              --offline
9800              --no-offline
9801                     Don't download packages from the Internet.
9802
9803              --project-file FILE
9804                     Set  the  name of the cabal.project file to search for in
9805                     parent directories
9806
9807              --only
9808                     Only installs the package in the current directory.
9809
9810              --haddock-hoogle
9811                     Generate a hoogle database
9812
9813              --haddock-html
9814                     Generate HTML documentation (the default)
9815
9816              --haddock-html-location URL
9817                     Location of HTML documentation for pre-requisite packages
9818
9819              --haddock-for-hackage
9820                     Collection of flags to  generate  documentation  suitable
9821                     for upload to hackage
9822
9823              --haddock-executables
9824                     Run haddock for Executables targets
9825
9826              --haddock-tests
9827                     Run haddock for Test Suite targets
9828
9829              --haddock-benchmarks
9830                     Run haddock for Benchmark targets
9831
9832              --haddock-all
9833                     Run haddock for all targets
9834
9835              --haddock-internal
9836                     Run haddock for internal modules and include all symbols
9837
9838              --haddock-css PATH
9839                     Use PATH as the haddock stylesheet
9840
9841              --haddock-hyperlink-source, --haddock-hyperlink-sources
9842                     Hyperlink the documentation to the source code
9843
9844              --haddock-hscolour-css PATH
9845                     Use PATH as the HsColour stylesheet
9846
9847              --haddock-contents-location URL
9848                     Bake URL in as the location for the contents page
9849
9850
9851       cabal new-run
9852
9853       Usage: cabal new-run [TARGET] [FLAGS] [-- EXECUTABLE_FLAGS]
9854
9855
9856       Runs the specified executable-like component (an executable, a test, or
9857       a benchmark), first ensuring it is up to date.
9858
9859       Any executable-like component in any package  in  the  project  can  be
9860       specified.  A package can be specified if contains just one executable-
9861       like. The default is to use the package in the current directory if  it
9862       contains just one executable-like.
9863
9864       Extra  arguments can be passed to the program, but use '--' to separate
9865       arguments for the program from arguments for cabal. The  executable  is
9866       run  in  an environment where it can find its data files inplace in the
9867       build tree.
9868
9869       Dependencies are built or rebuilt as necessary.  Additional  configura‐
9870       tion  flags  can  be specified on the command line and these extend the
9871       project configuration from the  'cabal.project',  'cabal.project.local'
9872       and other files.
9873
9874
9875       Examples:
9876         cabal new-run
9877           Run the executable-like in the package in the current directory
9878         cabal new-run foo-tool
9879           Run the named executable-like (in any package in the project)
9880         cabal new-run pkgfoo:foo-tool
9881           Run the executable-like 'foo-tool' in the package 'pkgfoo'
9882         cabal new-run foo -O2 -- dothing --fooflag
9883           Build with '-O2' and run the program, passing it extra arguments.
9884
9885       Note:  this  command  is part of the new project-based system (aka nix-
9886       style local builds). These features are currently in beta.  Please  see
9887       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
9888       details and advice on what you can expect to  work.  If  you  encounter
9889       problems  please file issues at https://github.com/haskell/cabal/issues
9890       and if you have any time to get involved and help with testing,  fixing
9891       bugs etc then that is very much appreciated.
9892
9893
9894       Flags:
9895              -v, --verbose [n]
9896                     Control  verbosity (n is 0--3, default verbosity level is
9897                     1)
9898
9899              --builddir, --distdir, --distpref DIR
9900                     The directory where  Cabal  puts  generated  build  files
9901                     (default dist)
9902
9903              -g, --ghc
9904                     compile with GHC
9905
9906              --ghcjs
9907                     compile with GHCJS
9908
9909              --jhc
9910                     compile with JHC
9911
9912              --lhc
9913                     compile with LHC
9914
9915              --uhc
9916                     compile with UHC
9917
9918              --haskell-suite
9919                     compile with a haskell-suite compiler
9920
9921              --cabal-file PATH
9922                     use this Cabal file
9923
9924              -w, --with-compiler PATH
9925                     give the path to a particular compiler
9926
9927              --with-hc-pkg PATH
9928                     give the path to the package tool
9929
9930              --prefix DIR
9931                     bake this prefix in preparation of installation
9932
9933              --bindir DIR
9934                     installation directory for executables
9935
9936              --libdir DIR
9937                     installation directory for libraries
9938
9939              --libsubdir DIR
9940                     subdirectory of libdir in which libs are installed
9941
9942              --dynlibdir DIR
9943                     installation directory for dynamic libraries
9944
9945              --libexecdir DIR
9946                     installation directory for program executables
9947
9948              --libexecsubdir DIR
9949                     subdirectory  of  libexecdir in which private executables
9950                     are installed
9951
9952              --datadir DIR
9953                     installation directory for read-only data
9954
9955              --datasubdir DIR
9956                     subdirectory of datadir in which data files are installed
9957
9958              --docdir DIR
9959                     installation directory for documentation
9960
9961              --htmldir DIR
9962                     installation directory for HTML documentation
9963
9964              --haddockdir DIR
9965                     installation directory for haddock interfaces
9966
9967              --sysconfdir DIR
9968                     installation directory for configuration files
9969
9970              --program-prefix PREFIX
9971                     prefix to be applied to installed executables
9972
9973              --program-suffix SUFFIX
9974                     suffix to be applied to installed executables
9975
9976              --enable-library-vanilla
9977              --disable-library-vanilla
9978                     Vanilla libraries
9979
9980              -p, --enable-library-profiling
9981              --disable-library-profiling
9982                     Library profiling
9983
9984              --enable-shared
9985              --disable-shared
9986                     Shared library
9987
9988              --enable-static
9989              --disable-static
9990                     Static library
9991
9992              --enable-executable-dynamic
9993              --disable-executable-dynamic
9994                     Executable dynamic linking
9995
9996              --enable-profiling
9997              --disable-profiling
9998                     Executable and library profiling
9999
10000              --enable-executable-profiling
10001              --disable-executable-profiling
10002                     Executable profiling (DEPRECATED)
10003
10004              --profiling-detail level
10005                     Profiling  detail  level  for  executable   and   library
10006                     (default,  none,  exported-functions, toplevel-functions,
10007                     all-functions).
10008
10009              --library-profiling-detail level
10010                     Profiling detail level for libraries only.
10011
10012              -O, --enable-optimization, --enable-optimisation [n]
10013                     Build with optimization (n is 0--2, default is 1)
10014
10015              --disable-optimization, --disable-optimisation
10016                     Build without optimization
10017
10018              --enable-debug-info [n]
10019                     Emit debug info (n is 0--3, default is 0)
10020
10021              --disable-debug-info
10022                     Don't emit debug info
10023
10024              --enable-library-for-ghci
10025              --disable-library-for-ghci
10026                     compile library for use with GHCi
10027
10028              --enable-split-sections
10029              --disable-split-sections
10030                     compile library code such that unneeded  definitions  can
10031                     be dropped from the final executable (GHC 7.8+)
10032
10033              --enable-split-objs
10034              --disable-split-objs
10035                     split library into smaller objects to reduce binary sizes
10036                     (GHC 6.6+)
10037
10038              --enable-executable-stripping
10039              --disable-executable-stripping
10040                     strip executables  upon  installation  to  reduce  binary
10041                     sizes
10042
10043              --enable-library-stripping
10044              --disable-library-stripping
10045                     strip libraries upon installation to reduce binary sizes
10046
10047              --configure-option OPT
10048                     Extra option for configure
10049
10050              --user
10051              --global
10052                     doing a per-user installation
10053
10054              --package-db DB
10055                     Append  the given package database to the list of package
10056                     databases used  (to  satisfy  dependencies  and  register
10057                     into).  May  be  a specific file, 'global' or 'user'. The
10058                     initial  list  is  ['global'],  ['global',  'user'],   or
10059                     ['global',  $sandbox],  depending on context. Use 'clear'
10060                     to reset the list  to  empty.  See  the  user  guide  for
10061                     details.
10062
10063              -f, --flags FLAGS
10064                     Force values for the given flags in Cabal conditionals in
10065                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
10066                     forces  the  flag "debug" to true and "usebytestrings" to
10067                     false.
10068
10069              --extra-include-dirs PATH
10070                     A list of directories to search for header files
10071
10072              --enable-deterministic
10073              --disable-deterministic
10074                     Try to be as deterministic as possible (used by the  test
10075                     suite)
10076
10077              --ipid IPID
10078                     Installed package ID to compile this package as
10079
10080              --cid CID
10081                     Installed component ID to compile this component as
10082
10083              --extra-lib-dirs PATH
10084                     A list of directories to search for external libraries
10085
10086              --extra-framework-dirs PATH
10087                     A  list  of directories to search for external frameworks
10088                     (OS X only)
10089
10090              --extra-prog-path PATH
10091                     A list of directories to search for required programs (in
10092                     addition to the normal search locations)
10093
10094              --instantiate-with NAME=MOD
10095                     A mapping of signature names to concrete module instanti‐
10096                     ations.
10097
10098              --enable-tests
10099              --disable-tests
10100                     dependency  checking  and  compilation  for  test  suites
10101                     listed in the package description file.
10102
10103              --enable-coverage
10104              --disable-coverage
10105                     build package with Haskell Program Coverage. (GHC only)
10106
10107              --enable-library-coverage
10108              --disable-library-coverage
10109                     build  package  with Haskell Program Coverage. (GHC only)
10110                     (DEPRECATED)
10111
10112              --enable-benchmarks
10113              --disable-benchmarks
10114                     dependency checking and compilation for benchmarks listed
10115                     in the package description file.
10116
10117              --enable-relocatable
10118              --disable-relocatable
10119                     building a package that is relocatable. (GHC only)
10120
10121              --disable-response-files
10122                     enable  workaround for old versions of programs like "ar"
10123                     that do not support @file arguments
10124
10125              --with-alex PATH
10126                     give the path to alex
10127
10128              --with-ar PATH
10129                     give the path to ar
10130
10131              --with-c2hs PATH
10132                     give the path to c2hs
10133
10134              --with-cpphs PATH
10135                     give the path to cpphs
10136
10137              --with-doctest PATH
10138                     give the path to doctest
10139
10140              --with-gcc PATH
10141                     give the path to gcc
10142
10143              --with-ghc PATH
10144                     give the path to ghc
10145
10146              --with-ghc-pkg PATH
10147                     give the path to ghc-pkg
10148
10149              --with-ghcjs PATH
10150                     give the path to ghcjs
10151
10152              --with-ghcjs-pkg PATH
10153                     give the path to ghcjs-pkg
10154
10155              --with-greencard PATH
10156                     give the path to greencard
10157
10158              --with-haddock PATH
10159                     give the path to haddock
10160
10161              --with-happy PATH
10162                     give the path to happy
10163
10164              --with-haskell-suite PATH
10165                     give the path to haskell-suite
10166
10167              --with-haskell-suite-pkg PATH
10168                     give the path to haskell-suite-pkg
10169
10170              --with-hmake PATH
10171                     give the path to hmake
10172
10173              --with-hpc PATH
10174                     give the path to hpc
10175
10176              --with-hsc2hs PATH
10177                     give the path to hsc2hs
10178
10179              --with-hscolour PATH
10180                     give the path to hscolour
10181
10182              --with-jhc PATH
10183                     give the path to jhc
10184
10185              --with-ld PATH
10186                     give the path to ld
10187
10188              --with-lhc PATH
10189                     give the path to lhc
10190
10191              --with-lhc-pkg PATH
10192                     give the path to lhc-pkg
10193
10194              --with-pkg-config PATH
10195                     give the path to pkg-config
10196
10197              --with-runghc PATH
10198                     give the path to runghc
10199
10200              --with-strip PATH
10201                     give the path to strip
10202
10203              --with-tar PATH
10204                     give the path to tar
10205
10206              --with-uhc PATH
10207                     give the path to uhc
10208
10209              --alex-option OPT
10210                     give an extra option to alex (no need  to  quote  options
10211                     containing spaces)
10212
10213              --ar-option OPT
10214                     give an extra option to ar (no need to quote options con‐
10215                     taining spaces)
10216
10217              --c2hs-option OPT
10218                     give an extra option to c2hs (no need  to  quote  options
10219                     containing spaces)
10220
10221              --cpphs-option OPT
10222                     give  an  extra option to cpphs (no need to quote options
10223                     containing spaces)
10224
10225              --doctest-option OPT
10226                     give an extra option to doctest (no need to quote options
10227                     containing spaces)
10228
10229              --gcc-option OPT
10230                     give  an  extra  option  to gcc (no need to quote options
10231                     containing spaces)
10232
10233              --ghc-option OPT
10234                     give an extra option to ghc (no  need  to  quote  options
10235                     containing spaces)
10236
10237              --ghc-pkg-option OPT
10238                     give an extra option to ghc-pkg (no need to quote options
10239                     containing spaces)
10240
10241              --ghcjs-option OPT
10242                     give an extra option to ghcjs (no need to  quote  options
10243                     containing spaces)
10244
10245              --ghcjs-pkg-option OPT
10246                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
10247                     options containing spaces)
10248
10249              --greencard-option OPT
10250                     give an extra option  to  greencard  (no  need  to  quote
10251                     options containing spaces)
10252
10253              --haddock-option OPT
10254                     give an extra option to haddock (no need to quote options
10255                     containing spaces)
10256
10257              --happy-option OPT
10258                     give an extra option to happy (no need to  quote  options
10259                     containing spaces)
10260
10261              --haskell-suite-option OPT
10262                     give  an  extra option to haskell-suite (no need to quote
10263                     options containing spaces)
10264
10265              --haskell-suite-pkg-option OPT
10266                     give an extra option to  haskell-suite-pkg  (no  need  to
10267                     quote options containing spaces)
10268
10269              --hmake-option OPT
10270                     give  an  extra option to hmake (no need to quote options
10271                     containing spaces)
10272
10273              --hpc-option OPT
10274                     give an extra option to hpc (no  need  to  quote  options
10275                     containing spaces)
10276
10277              --hsc2hs-option OPT
10278                     give  an extra option to hsc2hs (no need to quote options
10279                     containing spaces)
10280
10281              --hscolour-option OPT
10282                     give an extra  option  to  hscolour  (no  need  to  quote
10283                     options containing spaces)
10284
10285              --jhc-option OPT
10286                     give  an  extra  option  to jhc (no need to quote options
10287                     containing spaces)
10288
10289              --ld-option OPT
10290                     give an extra option to ld (no need to quote options con‐
10291                     taining spaces)
10292
10293              --lhc-option OPT
10294                     give  an  extra  option  to lhc (no need to quote options
10295                     containing spaces)
10296
10297              --lhc-pkg-option OPT
10298                     give an extra option to lhc-pkg (no need to quote options
10299                     containing spaces)
10300
10301              --pkg-config-option OPT
10302                     give  an  extra  option  to  pkg-config (no need to quote
10303                     options containing spaces)
10304
10305              --runghc-option OPT
10306                     give an extra option to runghc (no need to quote  options
10307                     containing spaces)
10308
10309              --strip-option OPT
10310                     give  an  extra option to strip (no need to quote options
10311                     containing spaces)
10312
10313              --tar-option OPT
10314                     give an extra option to tar (no  need  to  quote  options
10315                     containing spaces)
10316
10317              --uhc-option OPT
10318                     give  an  extra  option  to uhc (no need to quote options
10319                     containing spaces)
10320
10321              --alex-options OPTS
10322                     give extra options to alex
10323
10324              --ar-options OPTS
10325                     give extra options to ar
10326
10327              --c2hs-options OPTS
10328                     give extra options to c2hs
10329
10330              --cpphs-options OPTS
10331                     give extra options to cpphs
10332
10333              --doctest-options OPTS
10334                     give extra options to doctest
10335
10336              --gcc-options OPTS
10337                     give extra options to gcc
10338
10339              --ghc-options OPTS
10340                     give extra options to ghc
10341
10342              --ghc-pkg-options OPTS
10343                     give extra options to ghc-pkg
10344
10345              --ghcjs-options OPTS
10346                     give extra options to ghcjs
10347
10348              --ghcjs-pkg-options OPTS
10349                     give extra options to ghcjs-pkg
10350
10351              --greencard-options OPTS
10352                     give extra options to greencard
10353
10354              --haddock-options OPTS
10355                     give extra options to haddock
10356
10357              --happy-options OPTS
10358                     give extra options to happy
10359
10360              --haskell-suite-options OPTS
10361                     give extra options to haskell-suite
10362
10363              --haskell-suite-pkg-options OPTS
10364                     give extra options to haskell-suite-pkg
10365
10366              --hmake-options OPTS
10367                     give extra options to hmake
10368
10369              --hpc-options OPTS
10370                     give extra options to hpc
10371
10372              --hsc2hs-options OPTS
10373                     give extra options to hsc2hs
10374
10375              --hscolour-options OPTS
10376                     give extra options to hscolour
10377
10378              --jhc-options OPTS
10379                     give extra options to jhc
10380
10381              --ld-options OPTS
10382                     give extra options to ld
10383
10384              --lhc-options OPTS
10385                     give extra options to lhc
10386
10387              --lhc-pkg-options OPTS
10388                     give extra options to lhc-pkg
10389
10390              --pkg-config-options OPTS
10391                     give extra options to pkg-config
10392
10393              --runghc-options OPTS
10394                     give extra options to runghc
10395
10396              --strip-options OPTS
10397                     give extra options to strip
10398
10399              --tar-options OPTS
10400                     give extra options to tar
10401
10402              --uhc-options OPTS
10403                     give extra options to uhc
10404
10405              --cabal-lib-version VERSION
10406                     Select which version of the Cabal lib  to  use  to  build
10407                     packages (useful for testing).
10408
10409              --constraint CONSTRAINT
10410                     Specify    constraints    on    a    package    (version,
10411                     installed/source, flags)
10412
10413              --preference CONSTRAINT
10414                     Specify preferences (soft constraints) on the version  of
10415                     a package
10416
10417              --solver SOLVER
10418                     Select  dependency  solver  to  use  (default:  modular).
10419                     Choices: modular.
10420
10421              --allow-older [DEPS]
10422                     Ignore lower bounds in all dependencies or DEPS
10423
10424              --allow-newer [DEPS]
10425                     Ignore upper bounds in all dependencies or DEPS
10426
10427              --enable-documentation
10428              --disable-documentation
10429                     building of documentation
10430
10431              --doc-index-file TEMPLATE
10432                     A central index of haddock  API  documentation  (template
10433                     cannot use $pkgid)
10434
10435              --dry-run
10436                     Do  not  install  anything,  only  print  what  would  be
10437                     installed.
10438
10439              --max-backjumps NUM
10440                     Maximum  number  of  backjumps  allowed   while   solving
10441                     (default:  2000).  Use a negative number to enable unlim‐
10442                     ited backtracking. Use 0  to  disable  backtracking  com‐
10443                     pletely.
10444
10445              --reorder-goals
10446              --no-reorder-goals
10447                     Try  to  reorder  goals  according to certain heuristics.
10448                     Slows things down on average, but may  make  backtracking
10449                     faster for some packages.
10450
10451              --count-conflicts
10452              --no-count-conflicts
10453                     Try  to  speed  up  solving  by preferring goals that are
10454                     involved in a lot of conflicts (default).
10455
10456              --independent-goals
10457              --no-independent-goals
10458                     Treat several goals on the command line  as  independent.
10459                     If  several  goals  depend on the same package, different
10460                     versions can be chosen.
10461
10462              --shadow-installed-packages
10463              --no-shadow-installed-packages
10464                     If multiple package instances of  the  same  version  are
10465                     installed, treat all but one as shadowed.
10466
10467              --strong-flags
10468              --no-strong-flags
10469                     Do not defer flag choices (this used to be the default in
10470                     cabal-install <= 1.20).
10471
10472              --allow-boot-library-installs
10473              --no-allow-boot-library-installs
10474                     Allow cabal to install  base,  ghc-prim,  integer-simple,
10475                     integer-gmp, and template-haskell.
10476
10477              --reinstall
10478              --no-reinstall
10479                     Install  even  if  it  means  installing the same version
10480                     again.
10481
10482              --avoid-reinstalls
10483              --no-avoid-reinstalls
10484                     Do not select versions that would destructively overwrite
10485                     installed packages.
10486
10487              --force-reinstalls
10488              --no-force-reinstalls
10489                     Reinstall  packages  even  if they will most likely break
10490                     other installed packages.
10491
10492              --upgrade-dependencies
10493              --no-upgrade-dependencies
10494                     Pick the latest version for all dependencies, rather than
10495                     trying to pick an installed version.
10496
10497              --only-dependencies
10498              --no-only-dependencies
10499                     Install  only  the  dependencies  necessary  to build the
10500                     given packages
10501
10502              --dependencies-only
10503              --no-dependencies-only
10504                     A synonym for --only-dependencies
10505
10506              --index-state STATE
10507                     Use source package index state as it existed at a  previ‐
10508                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
10509                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
10510                     'HEAD' (default: 'HEAD').
10511
10512              --root-cmd COMMAND
10513                     (No longer supported, do not use.)
10514
10515              --symlink-bindir DIR
10516                     Add  symlinks  to  installed executables into this direc‐
10517                     tory.
10518
10519              --build-summary TEMPLATE
10520                     Save build summaries  to  file  (name  template  can  use
10521                     $pkgid, $compiler, $os, $arch)
10522
10523              --build-log TEMPLATE
10524                     Log  all  builds  to  file (name template can use $pkgid,
10525                     $compiler, $os, $arch)
10526
10527              --remote-build-reporting LEVEL
10528                     Generate build reports to send to a remote server  (none,
10529                     anonymous or detailed).
10530
10531              --report-planning-failure
10532                     Generate  build reports when the dependency solver fails.
10533                     This is used by the Hackage build bot.
10534
10535              --enable-per-component
10536              --disable-per-component
10537                     Per-component builds when possible
10538
10539              --one-shot
10540              --no-one-shot
10541                     Do not record the packages in the world file.
10542
10543              --run-tests
10544                     Run package test suites during installation.
10545
10546              -j, --jobs [NUM]
10547                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
10548                     given).
10549
10550              --keep-going
10551                     After a build failure, continue to build other unaffected
10552                     packages.
10553
10554              --offline
10555              --no-offline
10556                     Don't download packages from the Internet.
10557
10558              --project-file FILE
10559                     Set the name of the cabal.project file to search  for  in
10560                     parent directories
10561
10562              --only
10563                     Only installs the package in the current directory.
10564
10565              --haddock-hoogle
10566                     Generate a hoogle database
10567
10568              --haddock-html
10569                     Generate HTML documentation (the default)
10570
10571              --haddock-html-location URL
10572                     Location of HTML documentation for pre-requisite packages
10573
10574              --haddock-for-hackage
10575                     Collection  of  flags  to generate documentation suitable
10576                     for upload to hackage
10577
10578              --haddock-executables
10579                     Run haddock for Executables targets
10580
10581              --haddock-tests
10582                     Run haddock for Test Suite targets
10583
10584              --haddock-benchmarks
10585                     Run haddock for Benchmark targets
10586
10587              --haddock-all
10588                     Run haddock for all targets
10589
10590              --haddock-internal
10591                     Run haddock for internal modules and include all symbols
10592
10593              --haddock-css PATH
10594                     Use PATH as the haddock stylesheet
10595
10596              --haddock-hyperlink-source, --haddock-hyperlink-sources
10597                     Hyperlink the documentation to the source code
10598
10599              --haddock-hscolour-css PATH
10600                     Use PATH as the HsColour stylesheet
10601
10602              --haddock-contents-location URL
10603                     Bake URL in as the location for the contents page
10604
10605
10606       cabal new-test
10607
10608       Usage: cabal new-test [TARGETS] [FLAGS]
10609
10610
10611       Runs the specified test-suites, first ensuring they are up to date.
10612
10613       Any test-suite in any package in the project can be specified. A  pack‐
10614       age  can  be specified in which case all the test-suites in the package
10615       are run. The default is to run all the test-suites in  the  package  in
10616       the current directory.
10617
10618       Dependencies  are  built or rebuilt as necessary. Additional configura‐
10619       tion flags can be specified on the command line and  these  extend  the
10620       project  configuration  from the 'cabal.project', 'cabal.project.local'
10621       and other files.
10622
10623
10624       Examples:
10625         cabal new-test
10626           Run all the test-suites in the package in the current directory
10627         cabal new-test pkgname
10628           Run all the test-suites in the package named pkgname
10629         cabal new-test cname
10630           Run the test-suite named cname
10631         cabal new-test cname --enable-coverage
10632           Run the test-suite built with code coverage (including  local  libs
10633       used)
10634
10635       Note:  this  command  is part of the new project-based system (aka nix-
10636       style local builds). These features are currently in beta.  Please  see
10637       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
10638       details and advice on what you can expect to  work.  If  you  encounter
10639       problems  please file issues at https://github.com/haskell/cabal/issues
10640       and if you have any time to get involved and help with testing,  fixing
10641       bugs etc then that is very much appreciated.
10642
10643
10644       Flags:
10645              -v, --verbose [n]
10646                     Control  verbosity (n is 0--3, default verbosity level is
10647                     1)
10648
10649              --builddir, --distdir, --distpref DIR
10650                     The directory where  Cabal  puts  generated  build  files
10651                     (default dist)
10652
10653              -g, --ghc
10654                     compile with GHC
10655
10656              --ghcjs
10657                     compile with GHCJS
10658
10659              --jhc
10660                     compile with JHC
10661
10662              --lhc
10663                     compile with LHC
10664
10665              --uhc
10666                     compile with UHC
10667
10668              --haskell-suite
10669                     compile with a haskell-suite compiler
10670
10671              --cabal-file PATH
10672                     use this Cabal file
10673
10674              -w, --with-compiler PATH
10675                     give the path to a particular compiler
10676
10677              --with-hc-pkg PATH
10678                     give the path to the package tool
10679
10680              --prefix DIR
10681                     bake this prefix in preparation of installation
10682
10683              --bindir DIR
10684                     installation directory for executables
10685
10686              --libdir DIR
10687                     installation directory for libraries
10688
10689              --libsubdir DIR
10690                     subdirectory of libdir in which libs are installed
10691
10692              --dynlibdir DIR
10693                     installation directory for dynamic libraries
10694
10695              --libexecdir DIR
10696                     installation directory for program executables
10697
10698              --libexecsubdir DIR
10699                     subdirectory  of  libexecdir in which private executables
10700                     are installed
10701
10702              --datadir DIR
10703                     installation directory for read-only data
10704
10705              --datasubdir DIR
10706                     subdirectory of datadir in which data files are installed
10707
10708              --docdir DIR
10709                     installation directory for documentation
10710
10711              --htmldir DIR
10712                     installation directory for HTML documentation
10713
10714              --haddockdir DIR
10715                     installation directory for haddock interfaces
10716
10717              --sysconfdir DIR
10718                     installation directory for configuration files
10719
10720              --program-prefix PREFIX
10721                     prefix to be applied to installed executables
10722
10723              --program-suffix SUFFIX
10724                     suffix to be applied to installed executables
10725
10726              --enable-library-vanilla
10727              --disable-library-vanilla
10728                     Vanilla libraries
10729
10730              -p, --enable-library-profiling
10731              --disable-library-profiling
10732                     Library profiling
10733
10734              --enable-shared
10735              --disable-shared
10736                     Shared library
10737
10738              --enable-static
10739              --disable-static
10740                     Static library
10741
10742              --enable-executable-dynamic
10743              --disable-executable-dynamic
10744                     Executable dynamic linking
10745
10746              --enable-profiling
10747              --disable-profiling
10748                     Executable and library profiling
10749
10750              --enable-executable-profiling
10751              --disable-executable-profiling
10752                     Executable profiling (DEPRECATED)
10753
10754              --profiling-detail level
10755                     Profiling  detail  level  for  executable   and   library
10756                     (default,  none,  exported-functions, toplevel-functions,
10757                     all-functions).
10758
10759              --library-profiling-detail level
10760                     Profiling detail level for libraries only.
10761
10762              -O, --enable-optimization, --enable-optimisation [n]
10763                     Build with optimization (n is 0--2, default is 1)
10764
10765              --disable-optimization, --disable-optimisation
10766                     Build without optimization
10767
10768              --enable-debug-info [n]
10769                     Emit debug info (n is 0--3, default is 0)
10770
10771              --disable-debug-info
10772                     Don't emit debug info
10773
10774              --enable-library-for-ghci
10775              --disable-library-for-ghci
10776                     compile library for use with GHCi
10777
10778              --enable-split-sections
10779              --disable-split-sections
10780                     compile library code such that unneeded  definitions  can
10781                     be dropped from the final executable (GHC 7.8+)
10782
10783              --enable-split-objs
10784              --disable-split-objs
10785                     split library into smaller objects to reduce binary sizes
10786                     (GHC 6.6+)
10787
10788              --enable-executable-stripping
10789              --disable-executable-stripping
10790                     strip executables  upon  installation  to  reduce  binary
10791                     sizes
10792
10793              --enable-library-stripping
10794              --disable-library-stripping
10795                     strip libraries upon installation to reduce binary sizes
10796
10797              --configure-option OPT
10798                     Extra option for configure
10799
10800              --user
10801              --global
10802                     doing a per-user installation
10803
10804              --package-db DB
10805                     Append  the given package database to the list of package
10806                     databases used  (to  satisfy  dependencies  and  register
10807                     into).  May  be  a specific file, 'global' or 'user'. The
10808                     initial  list  is  ['global'],  ['global',  'user'],   or
10809                     ['global',  $sandbox],  depending on context. Use 'clear'
10810                     to reset the list  to  empty.  See  the  user  guide  for
10811                     details.
10812
10813              -f, --flags FLAGS
10814                     Force values for the given flags in Cabal conditionals in
10815                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
10816                     forces  the  flag "debug" to true and "usebytestrings" to
10817                     false.
10818
10819              --extra-include-dirs PATH
10820                     A list of directories to search for header files
10821
10822              --enable-deterministic
10823              --disable-deterministic
10824                     Try to be as deterministic as possible (used by the  test
10825                     suite)
10826
10827              --ipid IPID
10828                     Installed package ID to compile this package as
10829
10830              --cid CID
10831                     Installed component ID to compile this component as
10832
10833              --extra-lib-dirs PATH
10834                     A list of directories to search for external libraries
10835
10836              --extra-framework-dirs PATH
10837                     A  list  of directories to search for external frameworks
10838                     (OS X only)
10839
10840              --extra-prog-path PATH
10841                     A list of directories to search for required programs (in
10842                     addition to the normal search locations)
10843
10844              --instantiate-with NAME=MOD
10845                     A mapping of signature names to concrete module instanti‐
10846                     ations.
10847
10848              --enable-tests
10849              --disable-tests
10850                     dependency  checking  and  compilation  for  test  suites
10851                     listed in the package description file.
10852
10853              --enable-coverage
10854              --disable-coverage
10855                     build package with Haskell Program Coverage. (GHC only)
10856
10857              --enable-library-coverage
10858              --disable-library-coverage
10859                     build  package  with Haskell Program Coverage. (GHC only)
10860                     (DEPRECATED)
10861
10862              --enable-benchmarks
10863              --disable-benchmarks
10864                     dependency checking and compilation for benchmarks listed
10865                     in the package description file.
10866
10867              --enable-relocatable
10868              --disable-relocatable
10869                     building a package that is relocatable. (GHC only)
10870
10871              --disable-response-files
10872                     enable  workaround for old versions of programs like "ar"
10873                     that do not support @file arguments
10874
10875              --with-alex PATH
10876                     give the path to alex
10877
10878              --with-ar PATH
10879                     give the path to ar
10880
10881              --with-c2hs PATH
10882                     give the path to c2hs
10883
10884              --with-cpphs PATH
10885                     give the path to cpphs
10886
10887              --with-doctest PATH
10888                     give the path to doctest
10889
10890              --with-gcc PATH
10891                     give the path to gcc
10892
10893              --with-ghc PATH
10894                     give the path to ghc
10895
10896              --with-ghc-pkg PATH
10897                     give the path to ghc-pkg
10898
10899              --with-ghcjs PATH
10900                     give the path to ghcjs
10901
10902              --with-ghcjs-pkg PATH
10903                     give the path to ghcjs-pkg
10904
10905              --with-greencard PATH
10906                     give the path to greencard
10907
10908              --with-haddock PATH
10909                     give the path to haddock
10910
10911              --with-happy PATH
10912                     give the path to happy
10913
10914              --with-haskell-suite PATH
10915                     give the path to haskell-suite
10916
10917              --with-haskell-suite-pkg PATH
10918                     give the path to haskell-suite-pkg
10919
10920              --with-hmake PATH
10921                     give the path to hmake
10922
10923              --with-hpc PATH
10924                     give the path to hpc
10925
10926              --with-hsc2hs PATH
10927                     give the path to hsc2hs
10928
10929              --with-hscolour PATH
10930                     give the path to hscolour
10931
10932              --with-jhc PATH
10933                     give the path to jhc
10934
10935              --with-ld PATH
10936                     give the path to ld
10937
10938              --with-lhc PATH
10939                     give the path to lhc
10940
10941              --with-lhc-pkg PATH
10942                     give the path to lhc-pkg
10943
10944              --with-pkg-config PATH
10945                     give the path to pkg-config
10946
10947              --with-runghc PATH
10948                     give the path to runghc
10949
10950              --with-strip PATH
10951                     give the path to strip
10952
10953              --with-tar PATH
10954                     give the path to tar
10955
10956              --with-uhc PATH
10957                     give the path to uhc
10958
10959              --alex-option OPT
10960                     give an extra option to alex (no need  to  quote  options
10961                     containing spaces)
10962
10963              --ar-option OPT
10964                     give an extra option to ar (no need to quote options con‐
10965                     taining spaces)
10966
10967              --c2hs-option OPT
10968                     give an extra option to c2hs (no need  to  quote  options
10969                     containing spaces)
10970
10971              --cpphs-option OPT
10972                     give  an  extra option to cpphs (no need to quote options
10973                     containing spaces)
10974
10975              --doctest-option OPT
10976                     give an extra option to doctest (no need to quote options
10977                     containing spaces)
10978
10979              --gcc-option OPT
10980                     give  an  extra  option  to gcc (no need to quote options
10981                     containing spaces)
10982
10983              --ghc-option OPT
10984                     give an extra option to ghc (no  need  to  quote  options
10985                     containing spaces)
10986
10987              --ghc-pkg-option OPT
10988                     give an extra option to ghc-pkg (no need to quote options
10989                     containing spaces)
10990
10991              --ghcjs-option OPT
10992                     give an extra option to ghcjs (no need to  quote  options
10993                     containing spaces)
10994
10995              --ghcjs-pkg-option OPT
10996                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
10997                     options containing spaces)
10998
10999              --greencard-option OPT
11000                     give an extra option  to  greencard  (no  need  to  quote
11001                     options containing spaces)
11002
11003              --haddock-option OPT
11004                     give an extra option to haddock (no need to quote options
11005                     containing spaces)
11006
11007              --happy-option OPT
11008                     give an extra option to happy (no need to  quote  options
11009                     containing spaces)
11010
11011              --haskell-suite-option OPT
11012                     give  an  extra option to haskell-suite (no need to quote
11013                     options containing spaces)
11014
11015              --haskell-suite-pkg-option OPT
11016                     give an extra option to  haskell-suite-pkg  (no  need  to
11017                     quote options containing spaces)
11018
11019              --hmake-option OPT
11020                     give  an  extra option to hmake (no need to quote options
11021                     containing spaces)
11022
11023              --hpc-option OPT
11024                     give an extra option to hpc (no  need  to  quote  options
11025                     containing spaces)
11026
11027              --hsc2hs-option OPT
11028                     give  an extra option to hsc2hs (no need to quote options
11029                     containing spaces)
11030
11031              --hscolour-option OPT
11032                     give an extra  option  to  hscolour  (no  need  to  quote
11033                     options containing spaces)
11034
11035              --jhc-option OPT
11036                     give  an  extra  option  to jhc (no need to quote options
11037                     containing spaces)
11038
11039              --ld-option OPT
11040                     give an extra option to ld (no need to quote options con‐
11041                     taining spaces)
11042
11043              --lhc-option OPT
11044                     give  an  extra  option  to lhc (no need to quote options
11045                     containing spaces)
11046
11047              --lhc-pkg-option OPT
11048                     give an extra option to lhc-pkg (no need to quote options
11049                     containing spaces)
11050
11051              --pkg-config-option OPT
11052                     give  an  extra  option  to  pkg-config (no need to quote
11053                     options containing spaces)
11054
11055              --runghc-option OPT
11056                     give an extra option to runghc (no need to quote  options
11057                     containing spaces)
11058
11059              --strip-option OPT
11060                     give  an  extra option to strip (no need to quote options
11061                     containing spaces)
11062
11063              --tar-option OPT
11064                     give an extra option to tar (no  need  to  quote  options
11065                     containing spaces)
11066
11067              --uhc-option OPT
11068                     give  an  extra  option  to uhc (no need to quote options
11069                     containing spaces)
11070
11071              --alex-options OPTS
11072                     give extra options to alex
11073
11074              --ar-options OPTS
11075                     give extra options to ar
11076
11077              --c2hs-options OPTS
11078                     give extra options to c2hs
11079
11080              --cpphs-options OPTS
11081                     give extra options to cpphs
11082
11083              --doctest-options OPTS
11084                     give extra options to doctest
11085
11086              --gcc-options OPTS
11087                     give extra options to gcc
11088
11089              --ghc-options OPTS
11090                     give extra options to ghc
11091
11092              --ghc-pkg-options OPTS
11093                     give extra options to ghc-pkg
11094
11095              --ghcjs-options OPTS
11096                     give extra options to ghcjs
11097
11098              --ghcjs-pkg-options OPTS
11099                     give extra options to ghcjs-pkg
11100
11101              --greencard-options OPTS
11102                     give extra options to greencard
11103
11104              --haddock-options OPTS
11105                     give extra options to haddock
11106
11107              --happy-options OPTS
11108                     give extra options to happy
11109
11110              --haskell-suite-options OPTS
11111                     give extra options to haskell-suite
11112
11113              --haskell-suite-pkg-options OPTS
11114                     give extra options to haskell-suite-pkg
11115
11116              --hmake-options OPTS
11117                     give extra options to hmake
11118
11119              --hpc-options OPTS
11120                     give extra options to hpc
11121
11122              --hsc2hs-options OPTS
11123                     give extra options to hsc2hs
11124
11125              --hscolour-options OPTS
11126                     give extra options to hscolour
11127
11128              --jhc-options OPTS
11129                     give extra options to jhc
11130
11131              --ld-options OPTS
11132                     give extra options to ld
11133
11134              --lhc-options OPTS
11135                     give extra options to lhc
11136
11137              --lhc-pkg-options OPTS
11138                     give extra options to lhc-pkg
11139
11140              --pkg-config-options OPTS
11141                     give extra options to pkg-config
11142
11143              --runghc-options OPTS
11144                     give extra options to runghc
11145
11146              --strip-options OPTS
11147                     give extra options to strip
11148
11149              --tar-options OPTS
11150                     give extra options to tar
11151
11152              --uhc-options OPTS
11153                     give extra options to uhc
11154
11155              --cabal-lib-version VERSION
11156                     Select which version of the Cabal lib  to  use  to  build
11157                     packages (useful for testing).
11158
11159              --constraint CONSTRAINT
11160                     Specify    constraints    on    a    package    (version,
11161                     installed/source, flags)
11162
11163              --preference CONSTRAINT
11164                     Specify preferences (soft constraints) on the version  of
11165                     a package
11166
11167              --solver SOLVER
11168                     Select  dependency  solver  to  use  (default:  modular).
11169                     Choices: modular.
11170
11171              --allow-older [DEPS]
11172                     Ignore lower bounds in all dependencies or DEPS
11173
11174              --allow-newer [DEPS]
11175                     Ignore upper bounds in all dependencies or DEPS
11176
11177              --enable-documentation
11178              --disable-documentation
11179                     building of documentation
11180
11181              --doc-index-file TEMPLATE
11182                     A central index of haddock  API  documentation  (template
11183                     cannot use $pkgid)
11184
11185              --dry-run
11186                     Do  not  install  anything,  only  print  what  would  be
11187                     installed.
11188
11189              --max-backjumps NUM
11190                     Maximum  number  of  backjumps  allowed   while   solving
11191                     (default:  2000).  Use a negative number to enable unlim‐
11192                     ited backtracking. Use 0  to  disable  backtracking  com‐
11193                     pletely.
11194
11195              --reorder-goals
11196              --no-reorder-goals
11197                     Try  to  reorder  goals  according to certain heuristics.
11198                     Slows things down on average, but may  make  backtracking
11199                     faster for some packages.
11200
11201              --count-conflicts
11202              --no-count-conflicts
11203                     Try  to  speed  up  solving  by preferring goals that are
11204                     involved in a lot of conflicts (default).
11205
11206              --independent-goals
11207              --no-independent-goals
11208                     Treat several goals on the command line  as  independent.
11209                     If  several  goals  depend on the same package, different
11210                     versions can be chosen.
11211
11212              --shadow-installed-packages
11213              --no-shadow-installed-packages
11214                     If multiple package instances of  the  same  version  are
11215                     installed, treat all but one as shadowed.
11216
11217              --strong-flags
11218              --no-strong-flags
11219                     Do not defer flag choices (this used to be the default in
11220                     cabal-install <= 1.20).
11221
11222              --allow-boot-library-installs
11223              --no-allow-boot-library-installs
11224                     Allow cabal to install  base,  ghc-prim,  integer-simple,
11225                     integer-gmp, and template-haskell.
11226
11227              --reinstall
11228              --no-reinstall
11229                     Install  even  if  it  means  installing the same version
11230                     again.
11231
11232              --avoid-reinstalls
11233              --no-avoid-reinstalls
11234                     Do not select versions that would destructively overwrite
11235                     installed packages.
11236
11237              --force-reinstalls
11238              --no-force-reinstalls
11239                     Reinstall  packages  even  if they will most likely break
11240                     other installed packages.
11241
11242              --upgrade-dependencies
11243              --no-upgrade-dependencies
11244                     Pick the latest version for all dependencies, rather than
11245                     trying to pick an installed version.
11246
11247              --only-dependencies
11248              --no-only-dependencies
11249                     Install  only  the  dependencies  necessary  to build the
11250                     given packages
11251
11252              --dependencies-only
11253              --no-dependencies-only
11254                     A synonym for --only-dependencies
11255
11256              --index-state STATE
11257                     Use source package index state as it existed at a  previ‐
11258                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
11259                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
11260                     'HEAD' (default: 'HEAD').
11261
11262              --root-cmd COMMAND
11263                     (No longer supported, do not use.)
11264
11265              --symlink-bindir DIR
11266                     Add  symlinks  to  installed executables into this direc‐
11267                     tory.
11268
11269              --build-summary TEMPLATE
11270                     Save build summaries  to  file  (name  template  can  use
11271                     $pkgid, $compiler, $os, $arch)
11272
11273              --build-log TEMPLATE
11274                     Log  all  builds  to  file (name template can use $pkgid,
11275                     $compiler, $os, $arch)
11276
11277              --remote-build-reporting LEVEL
11278                     Generate build reports to send to a remote server  (none,
11279                     anonymous or detailed).
11280
11281              --report-planning-failure
11282                     Generate  build reports when the dependency solver fails.
11283                     This is used by the Hackage build bot.
11284
11285              --enable-per-component
11286              --disable-per-component
11287                     Per-component builds when possible
11288
11289              --one-shot
11290              --no-one-shot
11291                     Do not record the packages in the world file.
11292
11293              --run-tests
11294                     Run package test suites during installation.
11295
11296              -j, --jobs [NUM]
11297                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
11298                     given).
11299
11300              --keep-going
11301                     After a build failure, continue to build other unaffected
11302                     packages.
11303
11304              --offline
11305              --no-offline
11306                     Don't download packages from the Internet.
11307
11308              --project-file FILE
11309                     Set the name of the cabal.project file to search  for  in
11310                     parent directories
11311
11312              --only
11313                     Only installs the package in the current directory.
11314
11315              --haddock-hoogle
11316                     Generate a hoogle database
11317
11318              --haddock-html
11319                     Generate HTML documentation (the default)
11320
11321              --haddock-html-location URL
11322                     Location of HTML documentation for pre-requisite packages
11323
11324              --haddock-for-hackage
11325                     Collection  of  flags  to generate documentation suitable
11326                     for upload to hackage
11327
11328              --haddock-executables
11329                     Run haddock for Executables targets
11330
11331              --haddock-tests
11332                     Run haddock for Test Suite targets
11333
11334              --haddock-benchmarks
11335                     Run haddock for Benchmark targets
11336
11337              --haddock-all
11338                     Run haddock for all targets
11339
11340              --haddock-internal
11341                     Run haddock for internal modules and include all symbols
11342
11343              --haddock-css PATH
11344                     Use PATH as the haddock stylesheet
11345
11346              --haddock-hyperlink-source, --haddock-hyperlink-sources
11347                     Hyperlink the documentation to the source code
11348
11349              --haddock-hscolour-css PATH
11350                     Use PATH as the HsColour stylesheet
11351
11352              --haddock-contents-location URL
11353                     Bake URL in as the location for the contents page
11354
11355
11356       cabal new-bench
11357
11358       Usage: cabal new-bench [TARGETS] [FLAGS]
11359
11360
11361       Runs the specified benchmarks, first ensuring they are up to date.
11362
11363       Any benchmark in any package in the project can be specified. A package
11364       can  be  specified  in which case all the benchmarks in the package are
11365       run. The default is to run all the benchmarks in  the  package  in  the
11366       current directory.
11367
11368       Dependencies  are  built or rebuilt as necessary. Additional configura‐
11369       tion flags can be specified on the command line and  these  extend  the
11370       project  configuration  from the 'cabal.project', 'cabal.project.local'
11371       and other files.
11372
11373
11374       Examples:
11375         cabal new-bench
11376           Run all the benchmarks in the package in the current directory
11377         cabal new-bench pkgname
11378           Run all the benchmarks in the package named pkgname
11379         cabal new-bench cname
11380           Run the benchmark named cname
11381         cabal new-bench cname -O2
11382           Run the benchmark built with '-O2' (including local libs used)
11383
11384       Note: this command is part of the new project-based  system  (aka  nix-
11385       style  local  builds). These features are currently in beta. Please see
11386       http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for
11387       details  and  advice  on  what you can expect to work. If you encounter
11388       problems please file issues at  https://github.com/haskell/cabal/issues
11389       and  if you have any time to get involved and help with testing, fixing
11390       bugs etc then that is very much appreciated.
11391
11392
11393       Flags:
11394              -v, --verbose [n]
11395                     Control verbosity (n is 0--3, default verbosity level  is
11396                     1)
11397
11398              --builddir, --distdir, --distpref DIR
11399                     The  directory  where  Cabal  puts  generated build files
11400                     (default dist)
11401
11402              -g, --ghc
11403                     compile with GHC
11404
11405              --ghcjs
11406                     compile with GHCJS
11407
11408              --jhc
11409                     compile with JHC
11410
11411              --lhc
11412                     compile with LHC
11413
11414              --uhc
11415                     compile with UHC
11416
11417              --haskell-suite
11418                     compile with a haskell-suite compiler
11419
11420              --cabal-file PATH
11421                     use this Cabal file
11422
11423              -w, --with-compiler PATH
11424                     give the path to a particular compiler
11425
11426              --with-hc-pkg PATH
11427                     give the path to the package tool
11428
11429              --prefix DIR
11430                     bake this prefix in preparation of installation
11431
11432              --bindir DIR
11433                     installation directory for executables
11434
11435              --libdir DIR
11436                     installation directory for libraries
11437
11438              --libsubdir DIR
11439                     subdirectory of libdir in which libs are installed
11440
11441              --dynlibdir DIR
11442                     installation directory for dynamic libraries
11443
11444              --libexecdir DIR
11445                     installation directory for program executables
11446
11447              --libexecsubdir DIR
11448                     subdirectory of libexecdir in which  private  executables
11449                     are installed
11450
11451              --datadir DIR
11452                     installation directory for read-only data
11453
11454              --datasubdir DIR
11455                     subdirectory of datadir in which data files are installed
11456
11457              --docdir DIR
11458                     installation directory for documentation
11459
11460              --htmldir DIR
11461                     installation directory for HTML documentation
11462
11463              --haddockdir DIR
11464                     installation directory for haddock interfaces
11465
11466              --sysconfdir DIR
11467                     installation directory for configuration files
11468
11469              --program-prefix PREFIX
11470                     prefix to be applied to installed executables
11471
11472              --program-suffix SUFFIX
11473                     suffix to be applied to installed executables
11474
11475              --enable-library-vanilla
11476              --disable-library-vanilla
11477                     Vanilla libraries
11478
11479              -p, --enable-library-profiling
11480              --disable-library-profiling
11481                     Library profiling
11482
11483              --enable-shared
11484              --disable-shared
11485                     Shared library
11486
11487              --enable-static
11488              --disable-static
11489                     Static library
11490
11491              --enable-executable-dynamic
11492              --disable-executable-dynamic
11493                     Executable dynamic linking
11494
11495              --enable-profiling
11496              --disable-profiling
11497                     Executable and library profiling
11498
11499              --enable-executable-profiling
11500              --disable-executable-profiling
11501                     Executable profiling (DEPRECATED)
11502
11503              --profiling-detail level
11504                     Profiling   detail   level  for  executable  and  library
11505                     (default, none,  exported-functions,  toplevel-functions,
11506                     all-functions).
11507
11508              --library-profiling-detail level
11509                     Profiling detail level for libraries only.
11510
11511              -O, --enable-optimization, --enable-optimisation [n]
11512                     Build with optimization (n is 0--2, default is 1)
11513
11514              --disable-optimization, --disable-optimisation
11515                     Build without optimization
11516
11517              --enable-debug-info [n]
11518                     Emit debug info (n is 0--3, default is 0)
11519
11520              --disable-debug-info
11521                     Don't emit debug info
11522
11523              --enable-library-for-ghci
11524              --disable-library-for-ghci
11525                     compile library for use with GHCi
11526
11527              --enable-split-sections
11528              --disable-split-sections
11529                     compile  library  code such that unneeded definitions can
11530                     be dropped from the final executable (GHC 7.8+)
11531
11532              --enable-split-objs
11533              --disable-split-objs
11534                     split library into smaller objects to reduce binary sizes
11535                     (GHC 6.6+)
11536
11537              --enable-executable-stripping
11538              --disable-executable-stripping
11539                     strip  executables  upon  installation  to  reduce binary
11540                     sizes
11541
11542              --enable-library-stripping
11543              --disable-library-stripping
11544                     strip libraries upon installation to reduce binary sizes
11545
11546              --configure-option OPT
11547                     Extra option for configure
11548
11549              --user
11550              --global
11551                     doing a per-user installation
11552
11553              --package-db DB
11554                     Append the given package database to the list of  package
11555                     databases  used  (to  satisfy  dependencies  and register
11556                     into). May be a specific file, 'global'  or  'user'.  The
11557                     initial   list  is  ['global'],  ['global',  'user'],  or
11558                     ['global', $sandbox], depending on context.  Use  'clear'
11559                     to  reset  the  list  to  empty.  See  the user guide for
11560                     details.
11561
11562              -f, --flags FLAGS
11563                     Force values for the given flags in Cabal conditionals in
11564                     the  .cabal  file.  E.g., --flags="debug -usebytestrings"
11565                     forces the flag "debug" to true and  "usebytestrings"  to
11566                     false.
11567
11568              --extra-include-dirs PATH
11569                     A list of directories to search for header files
11570
11571              --enable-deterministic
11572              --disable-deterministic
11573                     Try  to be as deterministic as possible (used by the test
11574                     suite)
11575
11576              --ipid IPID
11577                     Installed package ID to compile this package as
11578
11579              --cid CID
11580                     Installed component ID to compile this component as
11581
11582              --extra-lib-dirs PATH
11583                     A list of directories to search for external libraries
11584
11585              --extra-framework-dirs PATH
11586                     A list of directories to search for  external  frameworks
11587                     (OS X only)
11588
11589              --extra-prog-path PATH
11590                     A list of directories to search for required programs (in
11591                     addition to the normal search locations)
11592
11593              --instantiate-with NAME=MOD
11594                     A mapping of signature names to concrete module instanti‐
11595                     ations.
11596
11597              --enable-tests
11598              --disable-tests
11599                     dependency  checking  and  compilation  for  test  suites
11600                     listed in the package description file.
11601
11602              --enable-coverage
11603              --disable-coverage
11604                     build package with Haskell Program Coverage. (GHC only)
11605
11606              --enable-library-coverage
11607              --disable-library-coverage
11608                     build package with Haskell Program Coverage.  (GHC  only)
11609                     (DEPRECATED)
11610
11611              --enable-benchmarks
11612              --disable-benchmarks
11613                     dependency checking and compilation for benchmarks listed
11614                     in the package description file.
11615
11616              --enable-relocatable
11617              --disable-relocatable
11618                     building a package that is relocatable. (GHC only)
11619
11620              --disable-response-files
11621                     enable workaround for old versions of programs like  "ar"
11622                     that do not support @file arguments
11623
11624              --with-alex PATH
11625                     give the path to alex
11626
11627              --with-ar PATH
11628                     give the path to ar
11629
11630              --with-c2hs PATH
11631                     give the path to c2hs
11632
11633              --with-cpphs PATH
11634                     give the path to cpphs
11635
11636              --with-doctest PATH
11637                     give the path to doctest
11638
11639              --with-gcc PATH
11640                     give the path to gcc
11641
11642              --with-ghc PATH
11643                     give the path to ghc
11644
11645              --with-ghc-pkg PATH
11646                     give the path to ghc-pkg
11647
11648              --with-ghcjs PATH
11649                     give the path to ghcjs
11650
11651              --with-ghcjs-pkg PATH
11652                     give the path to ghcjs-pkg
11653
11654              --with-greencard PATH
11655                     give the path to greencard
11656
11657              --with-haddock PATH
11658                     give the path to haddock
11659
11660              --with-happy PATH
11661                     give the path to happy
11662
11663              --with-haskell-suite PATH
11664                     give the path to haskell-suite
11665
11666              --with-haskell-suite-pkg PATH
11667                     give the path to haskell-suite-pkg
11668
11669              --with-hmake PATH
11670                     give the path to hmake
11671
11672              --with-hpc PATH
11673                     give the path to hpc
11674
11675              --with-hsc2hs PATH
11676                     give the path to hsc2hs
11677
11678              --with-hscolour PATH
11679                     give the path to hscolour
11680
11681              --with-jhc PATH
11682                     give the path to jhc
11683
11684              --with-ld PATH
11685                     give the path to ld
11686
11687              --with-lhc PATH
11688                     give the path to lhc
11689
11690              --with-lhc-pkg PATH
11691                     give the path to lhc-pkg
11692
11693              --with-pkg-config PATH
11694                     give the path to pkg-config
11695
11696              --with-runghc PATH
11697                     give the path to runghc
11698
11699              --with-strip PATH
11700                     give the path to strip
11701
11702              --with-tar PATH
11703                     give the path to tar
11704
11705              --with-uhc PATH
11706                     give the path to uhc
11707
11708              --alex-option OPT
11709                     give  an  extra  option to alex (no need to quote options
11710                     containing spaces)
11711
11712              --ar-option OPT
11713                     give an extra option to ar (no need to quote options con‐
11714                     taining spaces)
11715
11716              --c2hs-option OPT
11717                     give  an  extra  option to c2hs (no need to quote options
11718                     containing spaces)
11719
11720              --cpphs-option OPT
11721                     give an extra option to cpphs (no need to  quote  options
11722                     containing spaces)
11723
11724              --doctest-option OPT
11725                     give an extra option to doctest (no need to quote options
11726                     containing spaces)
11727
11728              --gcc-option OPT
11729                     give an extra option to gcc (no  need  to  quote  options
11730                     containing spaces)
11731
11732              --ghc-option OPT
11733                     give  an  extra  option  to ghc (no need to quote options
11734                     containing spaces)
11735
11736              --ghc-pkg-option OPT
11737                     give an extra option to ghc-pkg (no need to quote options
11738                     containing spaces)
11739
11740              --ghcjs-option OPT
11741                     give  an  extra option to ghcjs (no need to quote options
11742                     containing spaces)
11743
11744              --ghcjs-pkg-option OPT
11745                     give an extra option  to  ghcjs-pkg  (no  need  to  quote
11746                     options containing spaces)
11747
11748              --greencard-option OPT
11749                     give  an  extra  option  to  greencard  (no need to quote
11750                     options containing spaces)
11751
11752              --haddock-option OPT
11753                     give an extra option to haddock (no need to quote options
11754                     containing spaces)
11755
11756              --happy-option OPT
11757                     give  an  extra option to happy (no need to quote options
11758                     containing spaces)
11759
11760              --haskell-suite-option OPT
11761                     give an extra option to haskell-suite (no need  to  quote
11762                     options containing spaces)
11763
11764              --haskell-suite-pkg-option OPT
11765                     give  an  extra  option  to haskell-suite-pkg (no need to
11766                     quote options containing spaces)
11767
11768              --hmake-option OPT
11769                     give an extra option to hmake (no need to  quote  options
11770                     containing spaces)
11771
11772              --hpc-option OPT
11773                     give  an  extra  option  to hpc (no need to quote options
11774                     containing spaces)
11775
11776              --hsc2hs-option OPT
11777                     give an extra option to hsc2hs (no need to quote  options
11778                     containing spaces)
11779
11780              --hscolour-option OPT
11781                     give  an  extra  option  to  hscolour  (no  need to quote
11782                     options containing spaces)
11783
11784              --jhc-option OPT
11785                     give an extra option to jhc (no  need  to  quote  options
11786                     containing spaces)
11787
11788              --ld-option OPT
11789                     give an extra option to ld (no need to quote options con‐
11790                     taining spaces)
11791
11792              --lhc-option OPT
11793                     give an extra option to lhc (no  need  to  quote  options
11794                     containing spaces)
11795
11796              --lhc-pkg-option OPT
11797                     give an extra option to lhc-pkg (no need to quote options
11798                     containing spaces)
11799
11800              --pkg-config-option OPT
11801                     give an extra option to  pkg-config  (no  need  to  quote
11802                     options containing spaces)
11803
11804              --runghc-option OPT
11805                     give  an extra option to runghc (no need to quote options
11806                     containing spaces)
11807
11808              --strip-option OPT
11809                     give an extra option to strip (no need to  quote  options
11810                     containing spaces)
11811
11812              --tar-option OPT
11813                     give  an  extra  option  to tar (no need to quote options
11814                     containing spaces)
11815
11816              --uhc-option OPT
11817                     give an extra option to uhc (no  need  to  quote  options
11818                     containing spaces)
11819
11820              --alex-options OPTS
11821                     give extra options to alex
11822
11823              --ar-options OPTS
11824                     give extra options to ar
11825
11826              --c2hs-options OPTS
11827                     give extra options to c2hs
11828
11829              --cpphs-options OPTS
11830                     give extra options to cpphs
11831
11832              --doctest-options OPTS
11833                     give extra options to doctest
11834
11835              --gcc-options OPTS
11836                     give extra options to gcc
11837
11838              --ghc-options OPTS
11839                     give extra options to ghc
11840
11841              --ghc-pkg-options OPTS
11842                     give extra options to ghc-pkg
11843
11844              --ghcjs-options OPTS
11845                     give extra options to ghcjs
11846
11847              --ghcjs-pkg-options OPTS
11848                     give extra options to ghcjs-pkg
11849
11850              --greencard-options OPTS
11851                     give extra options to greencard
11852
11853              --haddock-options OPTS
11854                     give extra options to haddock
11855
11856              --happy-options OPTS
11857                     give extra options to happy
11858
11859              --haskell-suite-options OPTS
11860                     give extra options to haskell-suite
11861
11862              --haskell-suite-pkg-options OPTS
11863                     give extra options to haskell-suite-pkg
11864
11865              --hmake-options OPTS
11866                     give extra options to hmake
11867
11868              --hpc-options OPTS
11869                     give extra options to hpc
11870
11871              --hsc2hs-options OPTS
11872                     give extra options to hsc2hs
11873
11874              --hscolour-options OPTS
11875                     give extra options to hscolour
11876
11877              --jhc-options OPTS
11878                     give extra options to jhc
11879
11880              --ld-options OPTS
11881                     give extra options to ld
11882
11883              --lhc-options OPTS
11884                     give extra options to lhc
11885
11886              --lhc-pkg-options OPTS
11887                     give extra options to lhc-pkg
11888
11889              --pkg-config-options OPTS
11890                     give extra options to pkg-config
11891
11892              --runghc-options OPTS
11893                     give extra options to runghc
11894
11895              --strip-options OPTS
11896                     give extra options to strip
11897
11898              --tar-options OPTS
11899                     give extra options to tar
11900
11901              --uhc-options OPTS
11902                     give extra options to uhc
11903
11904              --cabal-lib-version VERSION
11905                     Select  which  version  of  the Cabal lib to use to build
11906                     packages (useful for testing).
11907
11908              --constraint CONSTRAINT
11909                     Specify    constraints    on    a    package    (version,
11910                     installed/source, flags)
11911
11912              --preference CONSTRAINT
11913                     Specify  preferences (soft constraints) on the version of
11914                     a package
11915
11916              --solver SOLVER
11917                     Select  dependency  solver  to  use  (default:  modular).
11918                     Choices: modular.
11919
11920              --allow-older [DEPS]
11921                     Ignore lower bounds in all dependencies or DEPS
11922
11923              --allow-newer [DEPS]
11924                     Ignore upper bounds in all dependencies or DEPS
11925
11926              --enable-documentation
11927              --disable-documentation
11928                     building of documentation
11929
11930              --doc-index-file TEMPLATE
11931                     A  central  index  of haddock API documentation (template
11932                     cannot use $pkgid)
11933
11934              --dry-run
11935                     Do  not  install  anything,  only  print  what  would  be
11936                     installed.
11937
11938              --max-backjumps NUM
11939                     Maximum   number   of  backjumps  allowed  while  solving
11940                     (default: 2000). Use a negative number to  enable  unlim‐
11941                     ited  backtracking.  Use  0  to disable backtracking com‐
11942                     pletely.
11943
11944              --reorder-goals
11945              --no-reorder-goals
11946                     Try to reorder goals  according  to  certain  heuristics.
11947                     Slows  things  down on average, but may make backtracking
11948                     faster for some packages.
11949
11950              --count-conflicts
11951              --no-count-conflicts
11952                     Try to speed up solving  by  preferring  goals  that  are
11953                     involved in a lot of conflicts (default).
11954
11955              --independent-goals
11956              --no-independent-goals
11957                     Treat  several  goals on the command line as independent.
11958                     If several goals depend on the  same  package,  different
11959                     versions can be chosen.
11960
11961              --shadow-installed-packages
11962              --no-shadow-installed-packages
11963                     If  multiple  package  instances  of the same version are
11964                     installed, treat all but one as shadowed.
11965
11966              --strong-flags
11967              --no-strong-flags
11968                     Do not defer flag choices (this used to be the default in
11969                     cabal-install <= 1.20).
11970
11971              --allow-boot-library-installs
11972              --no-allow-boot-library-installs
11973                     Allow  cabal  to  install base, ghc-prim, integer-simple,
11974                     integer-gmp, and template-haskell.
11975
11976              --reinstall
11977              --no-reinstall
11978                     Install even if it  means  installing  the  same  version
11979                     again.
11980
11981              --avoid-reinstalls
11982              --no-avoid-reinstalls
11983                     Do not select versions that would destructively overwrite
11984                     installed packages.
11985
11986              --force-reinstalls
11987              --no-force-reinstalls
11988                     Reinstall packages even if they will  most  likely  break
11989                     other installed packages.
11990
11991              --upgrade-dependencies
11992              --no-upgrade-dependencies
11993                     Pick the latest version for all dependencies, rather than
11994                     trying to pick an installed version.
11995
11996              --only-dependencies
11997              --no-only-dependencies
11998                     Install only the  dependencies  necessary  to  build  the
11999                     given packages
12000
12001              --dependencies-only
12002              --no-dependencies-only
12003                     A synonym for --only-dependencies
12004
12005              --index-state STATE
12006                     Use  source package index state as it existed at a previ‐
12007                     ous time. Accepts unix-timestamps  (e.g.  '@1474732068'),
12008                     ISO8601  UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or
12009                     'HEAD' (default: 'HEAD').
12010
12011              --root-cmd COMMAND
12012                     (No longer supported, do not use.)
12013
12014              --symlink-bindir DIR
12015                     Add symlinks to installed executables  into  this  direc‐
12016                     tory.
12017
12018              --build-summary TEMPLATE
12019                     Save  build  summaries  to  file  (name  template can use
12020                     $pkgid, $compiler, $os, $arch)
12021
12022              --build-log TEMPLATE
12023                     Log all builds to file (name  template  can  use  $pkgid,
12024                     $compiler, $os, $arch)
12025
12026              --remote-build-reporting LEVEL
12027                     Generate  build reports to send to a remote server (none,
12028                     anonymous or detailed).
12029
12030              --report-planning-failure
12031                     Generate build reports when the dependency solver  fails.
12032                     This is used by the Hackage build bot.
12033
12034              --enable-per-component
12035              --disable-per-component
12036                     Per-component builds when possible
12037
12038              --one-shot
12039              --no-one-shot
12040                     Do not record the packages in the world file.
12041
12042              --run-tests
12043                     Run package test suites during installation.
12044
12045              -j, --jobs [NUM]
12046                     Run  NUM  jobs  simultaneously  (or '$ncpus' if no NUM is
12047                     given).
12048
12049              --keep-going
12050                     After a build failure, continue to build other unaffected
12051                     packages.
12052
12053              --offline
12054              --no-offline
12055                     Don't download packages from the Internet.
12056
12057              --project-file FILE
12058                     Set  the  name of the cabal.project file to search for in
12059                     parent directories
12060
12061              --only
12062                     Only installs the package in the current directory.
12063
12064              --haddock-hoogle
12065                     Generate a hoogle database
12066
12067              --haddock-html
12068                     Generate HTML documentation (the default)
12069
12070              --haddock-html-location URL
12071                     Location of HTML documentation for pre-requisite packages
12072
12073              --haddock-for-hackage
12074                     Collection of flags to  generate  documentation  suitable
12075                     for upload to hackage
12076
12077              --haddock-executables
12078                     Run haddock for Executables targets
12079
12080              --haddock-tests
12081                     Run haddock for Test Suite targets
12082
12083              --haddock-benchmarks
12084                     Run haddock for Benchmark targets
12085
12086              --haddock-all
12087                     Run haddock for all targets
12088
12089              --haddock-internal
12090                     Run haddock for internal modules and include all symbols
12091
12092              --haddock-css PATH
12093                     Use PATH as the haddock stylesheet
12094
12095              --haddock-hyperlink-source, --haddock-hyperlink-sources
12096                     Hyperlink the documentation to the source code
12097
12098              --haddock-hscolour-css PATH
12099                     Use PATH as the HsColour stylesheet
12100
12101              --haddock-contents-location URL
12102                     Bake URL in as the location for the contents page
12103
12104
12105       cabal new-exec
12106
12107       Usage: cabal new-exec [FLAGS] [--] COMMAND [--] [ARGS]
12108
12109
12110       During  development  it  is often useful to run build tasks and perform
12111       one-off program executions to experiment with  the  behavior  of  build
12112       tools. It is convenient to run these tools in the same way cabal itself
12113       would. The `cabal new-exec` command provides a way to do so.
12114
12115       Compiler tools will be configured to see the same subset of  the  store
12116       that  builds would see. The PATH is modified to make all executables in
12117       the dependency tree available (provided they have been built  already).
12118       Commands are also rewritten in the way cabal itself would. For example,
12119       `cabal new-exec ghc` will consult the configuration to choose an appro‐
12120       priate version of ghc and to include any ghc-specific flags requested.
12121
12122
12123       Flags:
12124              -v, --verbose [n]
12125                     Control  verbosity (n is 0--3, default verbosity level is
12126                     1)
12127
12128              --builddir, --distdir, --distpref DIR
12129                     The directory where  Cabal  puts  generated  build  files
12130                     (default dist)
12131
12132              -g, --ghc
12133                     compile with GHC
12134
12135              --ghcjs
12136                     compile with GHCJS
12137
12138              --jhc
12139                     compile with JHC
12140
12141              --lhc
12142                     compile with LHC
12143
12144              --uhc
12145                     compile with UHC
12146
12147              --haskell-suite
12148                     compile with a haskell-suite compiler
12149
12150              --cabal-file PATH
12151                     use this Cabal file
12152
12153              -w, --with-compiler PATH
12154                     give the path to a particular compiler
12155
12156              --with-hc-pkg PATH
12157                     give the path to the package tool
12158
12159              --prefix DIR
12160                     bake this prefix in preparation of installation
12161
12162              --bindir DIR
12163                     installation directory for executables
12164
12165              --libdir DIR
12166                     installation directory for libraries
12167
12168              --libsubdir DIR
12169                     subdirectory of libdir in which libs are installed
12170
12171              --dynlibdir DIR
12172                     installation directory for dynamic libraries
12173
12174              --libexecdir DIR
12175                     installation directory for program executables
12176
12177              --libexecsubdir DIR
12178                     subdirectory  of  libexecdir in which private executables
12179                     are installed
12180
12181              --datadir DIR
12182                     installation directory for read-only data
12183
12184              --datasubdir DIR
12185                     subdirectory of datadir in which data files are installed
12186
12187              --docdir DIR
12188                     installation directory for documentation
12189
12190              --htmldir DIR
12191                     installation directory for HTML documentation
12192
12193              --haddockdir DIR
12194                     installation directory for haddock interfaces
12195
12196              --sysconfdir DIR
12197                     installation directory for configuration files
12198
12199              --program-prefix PREFIX
12200                     prefix to be applied to installed executables
12201
12202              --program-suffix SUFFIX
12203                     suffix to be applied to installed executables
12204
12205              --enable-library-vanilla
12206              --disable-library-vanilla
12207                     Vanilla libraries
12208
12209              -p, --enable-library-profiling
12210              --disable-library-profiling
12211                     Library profiling
12212
12213              --enable-shared
12214              --disable-shared
12215                     Shared library
12216
12217              --enable-static
12218              --disable-static
12219                     Static library
12220
12221              --enable-executable-dynamic
12222              --disable-executable-dynamic
12223                     Executable dynamic linking
12224
12225              --enable-profiling
12226              --disable-profiling
12227                     Executable and library profiling
12228
12229              --enable-executable-profiling
12230              --disable-executable-profiling
12231                     Executable profiling (DEPRECATED)
12232
12233              --profiling-detail level
12234                     Profiling  detail  level  for  executable   and   library
12235                     (default,  none,  exported-functions, toplevel-functions,
12236                     all-functions).
12237
12238              --library-profiling-detail level
12239                     Profiling detail level for libraries only.
12240
12241              -O, --enable-optimization, --enable-optimisation [n]
12242                     Build with optimization (n is 0--2, default is 1)
12243
12244              --disable-optimization, --disable-optimisation
12245                     Build without optimization
12246
12247              --enable-debug-info [n]
12248                     Emit debug info (n is 0--3, default is 0)
12249
12250              --disable-debug-info
12251                     Don't emit debug info
12252
12253              --enable-library-for-ghci
12254              --disable-library-for-ghci
12255                     compile library for use with GHCi
12256
12257              --enable-split-sections
12258              --disable-split-sections
12259                     compile library code such that unneeded  definitions  can
12260                     be dropped from the final executable (GHC 7.8+)
12261
12262              --enable-split-objs
12263              --disable-split-objs
12264                     split library into smaller objects to reduce binary sizes
12265                     (GHC 6.6+)
12266
12267              --enable-executable-stripping
12268              --disable-executable-stripping
12269                     strip executables  upon  installation  to  reduce  binary
12270                     sizes
12271
12272              --enable-library-stripping
12273              --disable-library-stripping
12274                     strip libraries upon installation to reduce binary sizes
12275
12276              --configure-option OPT
12277                     Extra option for configure
12278
12279              --user
12280              --global
12281                     doing a per-user installation
12282
12283              --package-db DB
12284                     Append  the given package database to the list of package
12285                     databases used  (to  satisfy  dependencies  and  register
12286                     into).  May  be  a specific file, 'global' or 'user'. The
12287                     initial  list  is  ['global'],  ['global',  'user'],   or
12288                     ['global',  $sandbox],  depending on context. Use 'clear'
12289                     to reset the list  to  empty.  See  the  user  guide  for
12290                     details.
12291
12292              -f, --flags FLAGS
12293                     Force values for the given flags in Cabal conditionals in
12294                     the .cabal file.  E.g.,  --flags="debug  -usebytestrings"
12295                     forces  the  flag "debug" to true and "usebytestrings" to
12296                     false.
12297
12298              --extra-include-dirs PATH
12299                     A list of directories to search for header files
12300
12301              --enable-deterministic
12302              --disable-deterministic
12303                     Try to be as deterministic as possible (used by the  test
12304                     suite)
12305
12306              --ipid IPID
12307                     Installed package ID to compile this package as
12308
12309              --cid CID
12310                     Installed component ID to compile this component as
12311
12312              --extra-lib-dirs PATH
12313                     A list of directories to search for external libraries
12314
12315              --extra-framework-dirs PATH
12316                     A  list  of directories to search for external frameworks
12317                     (OS X only)
12318
12319              --extra-prog-path PATH
12320                     A list of directories to search for required programs (in
12321                     addition to the normal search locations)
12322
12323              --instantiate-with NAME=MOD
12324                     A mapping of signature names to concrete module instanti‐
12325                     ations.
12326
12327              --enable-tests
12328              --disable-tests
12329                     dependency  checking  and  compilation  for  test  suites
12330                     listed in the package description file.
12331
12332              --enable-coverage
12333              --disable-coverage
12334                     build package with Haskell Program Coverage. (GHC only)
12335
12336              --enable-library-coverage
12337              --disable-library-coverage
12338                     build  package  with Haskell Program Coverage. (GHC only)
12339                     (DEPRECATED)
12340
12341              --enable-benchmarks
12342              --disable-benchmarks
12343                     dependency checking and compilation for benchmarks listed
12344                     in the package description file.
12345
12346              --enable-relocatable
12347              --disable-relocatable
12348                     building a package that is relocatable. (GHC only)
12349
12350              --disable-response-files
12351                     enable  workaround for old versions of programs like "ar"
12352                     that do not support @file arguments
12353
12354              --with-alex PATH
12355                     give the path to alex
12356
12357              --with-ar PATH
12358                     give the path to ar
12359
12360              --with-c2hs PATH
12361                     give the path to c2hs
12362
12363              --with-cpphs PATH
12364                     give the path to cpphs
12365
12366              --with-doctest PATH
12367                     give the path to doctest
12368
12369              --with-gcc PATH
12370                     give the path to gcc
12371
12372              --with-ghc PATH
12373                     give the path to ghc
12374
12375              --with-ghc-pkg PATH
12376                     give the path to ghc-pkg
12377
12378              --with-ghcjs PATH
12379                     give the path to ghcjs
12380
12381              --with-ghcjs-pkg PATH
12382                     give the path to ghcjs-pkg
12383
12384              --with-greencard PATH
12385                     give the path to greencard
12386
12387              --with-haddock PATH
12388                     give the path to haddock
12389
12390              --with-happy PATH
12391                     give the path to happy
12392
12393              --with-haskell-suite PATH
12394                     give the path to haskell-suite
12395
12396              --with-haskell-suite-pkg PATH
12397                     give the path to haskell-suite-pkg
12398
12399              --with-hmake PATH
12400                     give the path to hmake
12401
12402              --with-hpc PATH
12403                     give the path to hpc
12404
12405              --with-hsc2hs PATH
12406                     give the path to hsc2hs
12407
12408              --with-hscolour PATH
12409                     give the path to hscolour
12410
12411              --with-jhc PATH
12412                     give the path to jhc
12413
12414              --with-ld PATH
12415                     give the path to ld
12416
12417              --with-lhc PATH
12418                     give the path to lhc
12419
12420              --with-lhc-pkg PATH
12421                     give the path to lhc-pkg
12422
12423              --with-pkg-config PATH
12424                     give the path to pkg-config
12425
12426              --with-runghc PATH
12427                     give the path to runghc
12428
12429              --with-strip PATH
12430                     give the path to strip
12431
12432              --with-tar PATH
12433                     give the path to tar
12434
12435              --with-uhc PATH
12436                     give the path to uhc
12437
12438              --alex-option OPT
12439                     give an extra option to alex (no need  to  quote  options
12440                     containing spaces)
12441
12442              --ar-option OPT
12443                     give an extra option to ar (no need to quote options con‐
12444                     taining spaces)
12445
12446              --c2hs-option OPT
12447                     give an extra option to c2hs (no need  to  quote  options
12448                     containing spaces)
12449
12450              --cpphs-option OPT
12451                     give  an  extra option to cpphs (no need to quote options
12452                     containing spaces)
12453
12454              --doctest-option OPT
12455                     give an extra option to doctest (no need to quote options
12456                     containing spaces)
12457
12458              --gcc-option OPT
12459                     give  an  extra  option  to gcc (no need to quote options
12460                     containing spaces)
12461
12462              --ghc-option OPT
12463                     give an extra option to ghc (no  need  to  quote  options
12464                     containing spaces)
12465
12466              --ghc-pkg-option OPT
12467                     give an extra option to ghc-pkg (no need to quote options
12468                     containing spaces)
12469
12470              --ghcjs-option OPT
12471                     give an extra option to ghcjs (no need to  quote  options
12472                     containing spaces)
12473
12474              --ghcjs-pkg-option OPT
12475                     give  an  extra  option  to  ghcjs-pkg  (no need to quote
12476                     options containing spaces)
12477
12478              --greencard-option OPT
12479                     give an extra option  to  greencard  (no  need  to  quote
12480                     options containing spaces)
12481
12482              --haddock-option OPT
12483                     give an extra option to haddock (no need to quote options
12484                     containing spaces)
12485
12486              --happy-option OPT
12487                     give an extra option to happy (no need to  quote  options
12488                     containing spaces)
12489
12490              --haskell-suite-option OPT
12491                     give  an  extra option to haskell-suite (no need to quote
12492                     options containing spaces)
12493
12494              --haskell-suite-pkg-option OPT
12495                     give an extra option to  haskell-suite-pkg  (no  need  to
12496                     quote options containing spaces)
12497
12498              --hmake-option OPT
12499                     give  an  extra option to hmake (no need to quote options
12500                     containing spaces)
12501
12502              --hpc-option OPT
12503                     give an extra option to hpc (no  need  to  quote  options
12504                     containing spaces)
12505
12506              --hsc2hs-option OPT
12507                     give  an extra option to hsc2hs (no need to quote options
12508                     containing spaces)
12509
12510              --hscolour-option OPT
12511                     give an extra  option  to  hscolour  (no  need  to  quote
12512                     options containing spaces)
12513
12514              --jhc-option OPT
12515                     give  an  extra  option  to jhc (no need to quote options
12516                     containing spaces)
12517
12518              --ld-option OPT
12519                     give an extra option to ld (no need to quote options con‐
12520                     taining spaces)
12521
12522              --lhc-option OPT
12523                     give  an  extra  option  to lhc (no need to quote options
12524                     containing spaces)
12525
12526              --lhc-pkg-option OPT
12527                     give an extra option to lhc-pkg (no need to quote options
12528                     containing spaces)
12529
12530              --pkg-config-option OPT
12531                     give  an  extra  option  to  pkg-config (no need to quote
12532                     options containing spaces)
12533
12534              --runghc-option OPT
12535                     give an extra option to runghc (no need to quote  options
12536                     containing spaces)
12537
12538              --strip-option OPT
12539                     give  an  extra option to strip (no need to quote options
12540                     containing spaces)
12541
12542              --tar-option OPT
12543                     give an extra option to tar (no  need  to  quote  options
12544                     containing spaces)
12545
12546              --uhc-option OPT
12547                     give  an  extra  option  to uhc (no need to quote options
12548                     containing spaces)
12549
12550              --alex-options OPTS
12551                     give extra options to alex
12552
12553              --ar-options OPTS
12554                     give extra options to ar
12555
12556              --c2hs-options OPTS
12557                     give extra options to c2hs
12558
12559              --cpphs-options OPTS
12560                     give extra options to cpphs
12561
12562              --doctest-options OPTS
12563                     give extra options to doctest
12564
12565              --gcc-options OPTS
12566                     give extra options to gcc
12567
12568              --ghc-options OPTS
12569                     give extra options to ghc
12570
12571              --ghc-pkg-options OPTS
12572                     give extra options to ghc-pkg
12573
12574              --ghcjs-options OPTS
12575                     give extra options to ghcjs
12576
12577              --ghcjs-pkg-options OPTS
12578                     give extra options to ghcjs-pkg
12579
12580              --greencard-options OPTS
12581                     give extra options to greencard
12582
12583              --haddock-options OPTS
12584                     give extra options to haddock
12585
12586              --happy-options OPTS
12587                     give extra options to happy
12588
12589              --haskell-suite-options OPTS
12590                     give extra options to haskell-suite
12591
12592              --haskell-suite-pkg-options OPTS
12593                     give extra options to haskell-suite-pkg
12594
12595              --hmake-options OPTS
12596                     give extra options to hmake
12597
12598              --hpc-options OPTS
12599                     give extra options to hpc
12600
12601              --hsc2hs-options OPTS
12602                     give extra options to hsc2hs
12603
12604              --hscolour-options OPTS
12605                     give extra options to hscolour
12606
12607              --jhc-options OPTS
12608                     give extra options to jhc
12609
12610              --ld-options OPTS
12611                     give extra options to ld
12612
12613              --lhc-options OPTS
12614                     give extra options to lhc
12615
12616              --lhc-pkg-options OPTS
12617                     give extra options to lhc-pkg
12618
12619              --pkg-config-options OPTS
12620                     give extra options to pkg-config
12621
12622              --runghc-options OPTS
12623                     give extra options to runghc
12624
12625              --strip-options OPTS
12626                     give extra options to strip
12627
12628              --tar-options OPTS
12629                     give extra options to tar
12630
12631              --uhc-options OPTS
12632                     give extra options to uhc
12633
12634              --cabal-lib-version VERSION
12635                     Select which version of the Cabal lib  to  use  to  build
12636                     packages (useful for testing).
12637
12638              --constraint CONSTRAINT
12639                     Specify    constraints    on    a    package    (version,
12640                     installed/source, flags)
12641
12642              --preference CONSTRAINT
12643                     Specify preferences (soft constraints) on the version  of
12644                     a package
12645
12646              --solver SOLVER
12647                     Select  dependency  solver  to  use  (default:  modular).
12648                     Choices: modular.
12649
12650              --allow-older [DEPS]
12651                     Ignore lower bounds in all dependencies or DEPS
12652
12653              --allow-newer [DEPS]
12654                     Ignore upper bounds in all dependencies or DEPS
12655
12656              --enable-documentation
12657              --disable-documentation
12658                     building of documentation
12659
12660              --doc-index-file TEMPLATE
12661                     A central index of haddock  API  documentation  (template
12662                     cannot use $pkgid)
12663
12664              --dry-run
12665                     Do  not  install  anything,  only  print  what  would  be
12666                     installed.
12667
12668              --max-backjumps NUM
12669                     Maximum  number  of  backjumps  allowed   while   solving
12670                     (default:  2000).  Use a negative number to enable unlim‐
12671                     ited backtracking. Use 0  to  disable  backtracking  com‐
12672                     pletely.
12673
12674              --reorder-goals
12675              --no-reorder-goals
12676                     Try  to  reorder  goals  according to certain heuristics.
12677                     Slows things down on average, but may  make  backtracking
12678                     faster for some packages.
12679
12680              --count-conflicts
12681              --no-count-conflicts
12682                     Try  to  speed  up  solving  by preferring goals that are
12683                     involved in a lot of conflicts (default).
12684
12685              --independent-goals
12686              --no-independent-goals
12687                     Treat several goals on the command line  as  independent.
12688                     If  several  goals  depend on the same package, different
12689                     versions can be chosen.
12690
12691              --shadow-installed-packages
12692              --no-shadow-installed-packages
12693                     If multiple package instances of  the  same  version  are
12694                     installed, treat all but one as shadowed.
12695
12696              --strong-flags
12697              --no-strong-flags
12698                     Do not defer flag choices (this used to be the default in
12699                     cabal-install <= 1.20).
12700
12701              --allow-boot-library-installs
12702              --no-allow-boot-library-installs
12703                     Allow cabal to install  base,  ghc-prim,  integer-simple,
12704                     integer-gmp, and template-haskell.
12705
12706              --reinstall
12707              --no-reinstall
12708                     Install  even  if  it  means  installing the same version
12709                     again.
12710
12711              --avoid-reinstalls
12712              --no-avoid-reinstalls
12713                     Do not select versions that would destructively overwrite
12714                     installed packages.
12715
12716              --force-reinstalls
12717              --no-force-reinstalls
12718                     Reinstall  packages  even  if they will most likely break
12719                     other installed packages.
12720
12721              --upgrade-dependencies
12722              --no-upgrade-dependencies
12723                     Pick the latest version for all dependencies, rather than
12724                     trying to pick an installed version.
12725
12726              --only-dependencies
12727              --no-only-dependencies
12728                     Install  only  the  dependencies  necessary  to build the
12729                     given packages
12730
12731              --dependencies-only
12732              --no-dependencies-only
12733                     A synonym for --only-dependencies
12734
12735              --index-state STATE
12736                     Use source package index state as it existed at a  previ‐
12737                     ous  time.  Accepts unix-timestamps (e.g. '@1474732068'),
12738                     ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'),  or
12739                     'HEAD' (default: 'HEAD').
12740
12741              --root-cmd COMMAND
12742                     (No longer supported, do not use.)
12743
12744              --symlink-bindir DIR
12745                     Add  symlinks  to  installed executables into this direc‐
12746                     tory.
12747
12748              --build-summary TEMPLATE
12749                     Save build summaries  to  file  (name  template  can  use
12750                     $pkgid, $compiler, $os, $arch)
12751
12752              --build-log TEMPLATE
12753                     Log  all  builds  to  file (name template can use $pkgid,
12754                     $compiler, $os, $arch)
12755
12756              --remote-build-reporting LEVEL
12757                     Generate build reports to send to a remote server  (none,
12758                     anonymous or detailed).
12759
12760              --report-planning-failure
12761                     Generate  build reports when the dependency solver fails.
12762                     This is used by the Hackage build bot.
12763
12764              --enable-per-component
12765              --disable-per-component
12766                     Per-component builds when possible
12767
12768              --one-shot
12769              --no-one-shot
12770                     Do not record the packages in the world file.
12771
12772              --run-tests
12773                     Run package test suites during installation.
12774
12775              -j, --jobs [NUM]
12776                     Run NUM jobs simultaneously (or '$ncpus'  if  no  NUM  is
12777                     given).
12778
12779              --keep-going
12780                     After a build failure, continue to build other unaffected
12781                     packages.
12782
12783              --offline
12784              --no-offline
12785                     Don't download packages from the Internet.
12786
12787              --project-file FILE
12788                     Set the name of the cabal.project file to search  for  in
12789                     parent directories
12790
12791              --only
12792                     Only installs the package in the current directory.
12793
12794              --haddock-hoogle
12795                     Generate a hoogle database
12796
12797              --haddock-html
12798                     Generate HTML documentation (the default)
12799
12800              --haddock-html-location URL
12801                     Location of HTML documentation for pre-requisite packages
12802
12803              --haddock-for-hackage
12804                     Collection  of  flags  to generate documentation suitable
12805                     for upload to hackage
12806
12807              --haddock-executables
12808                     Run haddock for Executables targets
12809
12810              --haddock-tests
12811                     Run haddock for Test Suite targets
12812
12813              --haddock-benchmarks
12814                     Run haddock for Benchmark targets
12815
12816              --haddock-all
12817                     Run haddock for all targets
12818
12819              --haddock-internal
12820                     Run haddock for internal modules and include all symbols
12821
12822              --haddock-css PATH
12823                     Use PATH as the haddock stylesheet
12824
12825              --haddock-hyperlink-source, --haddock-hyperlink-sources
12826                     Hyperlink the documentation to the source code
12827
12828              --haddock-hscolour-css PATH
12829                     Use PATH as the HsColour stylesheet
12830
12831              --haddock-contents-location URL
12832                     Bake URL in as the location for the contents page
12833
12834
12835

FILES

12837       ~/.cabal/config
12838              The defaults that can be overridden with command-line options.
12839
12840       ~/.cabal/world
12841              A list of all packages whose installation  has  been  explicitly
12842              requested.
12843
12844

BUGS

12846       To  browse  the  list  of  known  issues or report a new one please see
12847       https://github.com/haskell/cabal/labels/cabal-install.
12848
12849
12850
12851
12852                                                                      CABAL(1)
Impressum