€cdocutils.nodes document q)q}q(U nametypesq}q(X%configuring builds with cabal.projectqNX)how can i profile my library/application?qNX quickstartqNXis the first versionq ˆXcmdoption-project-fileq ˆXcmdoption--store-dirq ˆX cabal v2-testq NXpackage versioning policyq ˆXsolver configuration optionsqNXhoogleqˆXcabal v2-benchqNXhscolourqˆXcabal v2-buildqNXcabal v2-updateqNX%advanced global configuration optionsqNXbackpackqˆX cabal v2-runqNXcmdoption--project-fileqˆX cabal v2-execqNXhackageqˆXspecifying the local packagesqNXghc package environment fileqˆX cabal v2-replqNXcpphsqˆXcabal v2-configureqNXhappyqˆXcabal v2-installq NXhaskellq!ˆXcmdoption--builddirq"ˆXcabal v2-haddockq#NX how it worksq$NXpvpq%ˆX9specifying packages from remote version control locationsq&NXcabal v2-cleanq'NXdeveloping multiple packagesq(NXabnfq)ˆXcabal v2-sdistq*NXcommandsq+NXthis section of the ghc manualq,ˆXalexq-ˆXcabal v2-freezeq.NXglobal configuration optionsq/NXwhere are my build products?q0NXhaddockq1ˆXlocal versus external packagesq2NXpackage configuration optionsq3NXcachingq4NXcookbookq5NuUsubstitution_defsq6}q7Uparse_messagesq8]q9(cdocutils.nodes system_message q:)q;}q<(U rawsourceq=UUparentq>cdocutils.nodes section q?)q@}qA(h=Uh>h?)qB}qC(h=Uh>hUsourceqDXA/home/refold/code/haskell/cabal-3.0/Cabal/doc/nix-local-build.rstqEUtagnameqFUsectionqGU attributesqH}qI(UdupnamesqJ]UclassesqK]UbackrefsqL]UidsqM]qNU how-it-worksqOaUnamesqP]qQh$auUlineqRKlUdocumentqShUchildrenqT]qU(cdocutils.nodes title qV)qW}qX(h=X How it worksqYh>hBhDhEhFUtitleqZhH}q[(hJ]hK]hL]hM]hP]uhRKlhShhT]q\cdocutils.nodes Text q]X How it worksq^…q_}q`(h=hYhDNhRNhShh>hWubaubh@h?)qa}qb(h=Uh>hBhDhEhFhGhH}qc(hJ]hK]hL]hM]qdUwhere-are-my-build-productsqeahP]qfh0auhRK¦hShhT]qg(hV)qh}qi(h=XWhere are my build products?qjh>hahDhEhFhZhH}qk(hJ]hK]hL]hM]hP]uhRK¦hShhT]qlh]XWhere are my build products?qm…qn}qo(h=hjhDNhRNhShh>hhubaubcdocutils.nodes paragraph qp)qq}qr(h=XrA major deficiency in the current implementation of v2-build is that there is no programmatic way to access the location of build products. The location of the build products is intended to be an internal implementation detail of v2-build, but we also understand that many unimplemented features can only be reasonably worked around by accessing build products directly.qsh>hahDhEhFU paragraphqthH}qu(hJ]hK]hL]hM]hP]uhRK¨hShhT]qvh]XrA major deficiency in the current implementation of v2-build is that there is no programmatic way to access the location of build products. The location of the build products is intended to be an internal implementation detail of v2-build, but we also understand that many unimplemented features can only be reasonably worked around by accessing build products directly.qw…qx}qy(h=hshDNhRNhShh>hqubaubhp)qz}q{(h=X`The location where build products can be found varies depending on the version of cabal-install:q|h>hahDhEhFhthH}q}(hJ]hK]hL]hM]hP]uhRK¯hShhT]q~h]X`The location where build products can be found varies depending on the version of cabal-install:q…q€}q(h=h|hDNhRNhShh>hzubaubcdocutils.nodes bullet_list q‚)qƒ}q„(h=Uh>hahDhEhFU bullet_listq…hH}q†(Ubulletq‡X-hM]hL]hJ]hK]hP]uhRK²hShhT]qˆ(cdocutils.nodes list_item q‰)qŠ}q‹(h=XúIn cabal-install-1.24, the dist directory for a package ``p-0.1`` is stored in ``dist-newstyle/build/p-0.1``. For example, if you built an executable or test suite named ``pexe``, it would be located at ``dist-newstyle/build/p-0.1/build/pexe/pexe``. h>hƒhDhEhFU list_itemqŒhH}q(hJ]hK]hL]hM]hP]uhRNhShhT]qŽhp)q}q(h=XùIn cabal-install-1.24, the dist directory for a package ``p-0.1`` is stored in ``dist-newstyle/build/p-0.1``. For example, if you built an executable or test suite named ``pexe``, it would be located at ``dist-newstyle/build/p-0.1/build/pexe/pexe``.h>hŠhDhEhFhthH}q‘(hJ]hK]hL]hM]hP]uhRK²hT]q’(h]X8In cabal-install-1.24, the dist directory for a package q“…q”}q•(h=X8In cabal-install-1.24, the dist directory for a package h>hubcdocutils.nodes literal q–)q—}q˜(h=X ``p-0.1``hH}q™(hJ]hK]hL]hM]hP]uh>hhT]qšh]Xp-0.1q›…qœ}q(h=Xp-0.1h>h—ubahFUliteralqžubh]X is stored in qŸ…q }q¡(h=X is stored in h>hubh–)q¢}q£(h=X``dist-newstyle/build/p-0.1``hH}q¤(hJ]hK]hL]hM]hP]uh>hhT]q¥h]Xdist-newstyle/build/p-0.1q¦…q§}q¨(h=Xdist-newstyle/build/p-0.1h>h¢ubahFhžubh]X>. For example, if you built an executable or test suite named q©…qª}q«(h=X>. For example, if you built an executable or test suite named h>hubh–)q¬}q­(h=X``pexe``hH}q®(hJ]hK]hL]hM]hP]uh>hhT]q¯h]Xpexeq°…q±}q²(h=Xpexeh>h¬ubahFhžubh]X, it would be located at q³…q´}qµ(h=X, it would be located at h>hubh–)q¶}q·(h=X-``dist-newstyle/build/p-0.1/build/pexe/pexe``hH}q¸(hJ]hK]hL]hM]hP]uh>hhT]q¹h]X)dist-newstyle/build/p-0.1/build/pexe/pexeqº…q»}q¼(h=X)dist-newstyle/build/p-0.1/build/pexe/pexeh>h¶ubahFhžubh]X.…q½}q¾(h=X.h>hubeubaubh‰)q¿}qÀ(h=X4In cabal-install-2.0, the dist directory for a package ``p-0.1`` defining a library built with GHC 8.0.1 on 64-bit Linux is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1``. When per-component builds are enabled (any non-Custom package), a subcomponent like an executable or test suite named ``pexe`` will be stored at ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe``; thus, the full path of the executable is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexe`` (you can see why we want this to be an implementation detail!) h>hƒhDhEhFhŒhH}qÁ(hJ]hK]hL]hM]hP]uhRNhShhT]qÂhp)qÃ}qÄ(h=X3In cabal-install-2.0, the dist directory for a package ``p-0.1`` defining a library built with GHC 8.0.1 on 64-bit Linux is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1``. When per-component builds are enabled (any non-Custom package), a subcomponent like an executable or test suite named ``pexe`` will be stored at ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe``; thus, the full path of the executable is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexe`` (you can see why we want this to be an implementation detail!)h>h¿hDhEhFhthH}qÅ(hJ]hK]hL]hM]hP]uhRK·hT]qÆ(h]X7In cabal-install-2.0, the dist directory for a package qÇ…qÈ}qÉ(h=X7In cabal-install-2.0, the dist directory for a package h>hÃubh–)qÊ}qË(h=X ``p-0.1``hH}qÌ(hJ]hK]hL]hM]hP]uh>hÃhT]qÍh]Xp-0.1qÎ…qÏ}qÐ(h=Xp-0.1h>hÊubahFhžubh]X< defining a library built with GHC 8.0.1 on 64-bit Linux is qÑ…qÒ}qÓ(h=X< defining a library built with GHC 8.0.1 on 64-bit Linux is h>hÃubh–)qÔ}qÕ(h=X4``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1``hH}qÖ(hJ]hK]hL]hM]hP]uh>hÃhT]q×h]X0dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1qØ…qÙ}qÚ(h=X0dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1h>hÔubahFhžubh]Xx. When per-component builds are enabled (any non-Custom package), a subcomponent like an executable or test suite named qÛ…qÜ}qÝ(h=Xx. When per-component builds are enabled (any non-Custom package), a subcomponent like an executable or test suite named h>hÃubh–)qÞ}qß(h=X``pexe``hH}qà(hJ]hK]hL]hM]hP]uh>hÃhT]qáh]Xpexeqâ…qã}qä(h=Xpexeh>hÞubahFhžubh]X will be stored at qå…qæ}qç(h=X will be stored at h>hÃubh–)qè}qé(h=X;``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe``hH}qê(hJ]hK]hL]hM]hP]uh>hÃhT]qëh]X7dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexeqì…qí}qî(h=X7dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexeh>hèubahFhžubh]X+; thus, the full path of the executable is qï…qð}qñ(h=X+; thus, the full path of the executable is h>hÃubh–)qò}qó(h=XK``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexe``hH}qô(hJ]hK]hL]hM]hP]uh>hÃhT]qõh]XGdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexeqö…q÷}qø(h=XGdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexeh>hòubahFhžubh]X? (you can see why we want this to be an implementation detail!)qù…qú}qû(h=X? (you can see why we want this to be an implementation detail!)h>hÃubeubaubh‰)qü}qý(h=X6In cabal-install-2.2 and above, the ``/c/`` part of the above path is replaced with one of ``/l/``, ``/x/``, ``/f/``, ``/t/``, or ``/b/``, depending on the type of component (sublibrary, executable, foreign library, test suite, or benchmark respectively). So the full path to an executable named ``pexe`` compiled with GHC 8.0.1 on a 64-bit Linux is now ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/x/pexe/build/pexe/pexe``; for a benchmark named ``pbench`` it now is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/b/pbench/build/pbench/pbench``; h>hƒhDNhFhŒhH}qþ(hJ]hK]hL]hM]hP]uhRNhShhT]qÿcdocutils.nodes definition_list r)r}r(h=UhH}r(hJ]hK]hL]hM]hP]uh>hühT]rcdocutils.nodes definition_list_item r)r}r(h=X.In cabal-install-2.2 and above, the ``/c/`` part of the above path is replaced with one of ``/l/``, ``/x/``, ``/f/``, ``/t/``, or ``/b/``, depending on the type of component (sublibrary, executable, foreign library, test suite, or benchmark respectively). So the full path to an executable named ``pexe`` compiled with GHC 8.0.1 on a 64-bit Linux is now ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/x/pexe/build/pexe/pexe``; for a benchmark named ``pbench`` it now is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/b/pbench/build/pbench/pbench``; h>jhDhEhFUdefinition_list_itemrhH}r (hJ]hK]hL]hM]hP]uhRKËhT]r (cdocutils.nodes term r )r }r (h=XBIn cabal-install-2.2 and above, the ``/c/`` part of the above pathh>jhDhEhFUtermrhH}r(hJ]hK]hL]hM]hP]uhRKËhT]r(h]X$In cabal-install-2.2 and above, the r…r}r(h=X$In cabal-install-2.2 and above, the h>j ubh–)r}r(h=X``/c/``hH}r(hJ]hK]hL]hM]hP]uh>j hT]rh]X/c/r…r}r(h=X/c/h>jubahFhžubh]X part of the above pathr…r}r(h=X part of the above pathh>j ubeubcdocutils.nodes definition r)r}r (h=UhH}r!(hJ]hK]hL]hM]hP]uh>jhT]r"hp)r#}r$(h=Xéis replaced with one of ``/l/``, ``/x/``, ``/f/``, ``/t/``, or ``/b/``, depending on the type of component (sublibrary, executable, foreign library, test suite, or benchmark respectively). So the full path to an executable named ``pexe`` compiled with GHC 8.0.1 on a 64-bit Linux is now ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/x/pexe/build/pexe/pexe``; for a benchmark named ``pbench`` it now is ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/b/pbench/build/pbench/pbench``;h>jhDhEhFhthH}r%(hJ]hK]hL]hM]hP]uhRKÃhT]r&(h]Xis replaced with one of r'…r(}r)(h=Xis replaced with one of h>j#ubh–)r*}r+(h=X``/l/``hH}r,(hJ]hK]hL]hM]hP]uh>j#hT]r-h]X/l/r.…r/}r0(h=X/l/h>j*ubahFhžubh]X, r1…r2}r3(h=X, r4h>j#ubh–)r5}r6(h=X``/x/``hH}r7(hJ]hK]hL]hM]hP]uh>j#hT]r8h]X/x/r9…r:}r;(h=X/x/h>j5ubahFhžubh]X, r<…r=}r>(h=X, h>j#ubh–)r?}r@(h=X``/f/``hH}rA(hJ]hK]hL]hM]hP]uh>j#hT]rBh]X/f/rC…rD}rE(h=X/f/h>j?ubahFhžubh]X, rF…rG}rH(h=j4h>j#ubh–)rI}rJ(h=X``/t/``hH}rK(hJ]hK]hL]hM]hP]uh>j#hT]rLh]X/t/rM…rN}rO(h=X/t/h>jIubahFhžubh]X, or rP…rQ}rR(h=X, or h>j#ubh–)rS}rT(h=X``/b/``hH}rU(hJ]hK]hL]hM]hP]uh>j#hT]rVh]X/b/rW…rX}rY(h=X/b/h>jSubahFhžubh]XŸ, depending on the type of component (sublibrary, executable, foreign library, test suite, or benchmark respectively). So the full path to an executable named rZ…r[}r\(h=XŸ, depending on the type of component (sublibrary, executable, foreign library, test suite, or benchmark respectively). So the full path to an executable named h>j#ubh–)r]}r^(h=X``pexe``hH}r_(hJ]hK]hL]hM]hP]uh>j#hT]r`h]Xpexera…rb}rc(h=Xpexeh>j]ubahFhžubh]X2 compiled with GHC 8.0.1 on a 64-bit Linux is now rd…re}rf(h=X2 compiled with GHC 8.0.1 on a 64-bit Linux is now h>j#ubh–)rg}rh(h=XK``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/x/pexe/build/pexe/pexe``hH}ri(hJ]hK]hL]hM]hP]uh>j#hT]rjh]XGdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/x/pexe/build/pexe/pexerk…rl}rm(h=XGdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/x/pexe/build/pexe/pexeh>jgubahFhžubh]X; for a benchmark named rn…ro}rp(h=X; for a benchmark named h>j#ubh–)rq}rr(h=X ``pbench``hH}rs(hJ]hK]hL]hM]hP]uh>j#hT]rth]Xpbenchru…rv}rw(h=Xpbenchh>jqubahFhžubh]X it now is rx…ry}rz(h=X it now is h>j#ubh–)r{}r|(h=XQ``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/b/pbench/build/pbench/pbench``hH}r}(hJ]hK]hL]hM]hP]uh>j#hT]r~h]XMdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/b/pbench/build/pbench/pbenchr…r€}r(h=XMdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/b/pbench/build/pbench/pbenchh>j{ubahFhžubh]X;…r‚}rƒ(h=X;h>j#ubeubahFU definitionr„ubeubahFUdefinition_listr…ubaubeubhp)r†}r‡(h=X6The paths are a bit longer in 2.0 and above but the benefit is that you can transparently have multiple builds with different versions of GHC. We plan to add the ability to create aliases for certain build configurations, and more convenient paths to access particularly useful build products like executables.rˆh>hahDhEhFhthH}r‰(hJ]hK]hL]hM]hP]uhRKÍhShhT]rŠh]X6The paths are a bit longer in 2.0 and above but the benefit is that you can transparently have multiple builds with different versions of GHC. We plan to add the ability to create aliases for certain build configurations, and more convenient paths to access particularly useful build products like executables.r‹…rŒ}r(h=jˆhDNhRNhShh>j†ubaubeubh?)rŽ}r(h=Uh>hBhDhEhFhGhH}r(hJ]hK]hL]hM]r‘Ucachingr’ahP]r“h4auhRKÔhShhT]r”(hV)r•}r–(h=XCachingr—h>jŽhDhEhFhZhH}r˜(hJ]hK]hL]hM]hP]uhRKÔhShhT]r™h]XCachingrš…r›}rœ(h=j—hDNhRNhShh>j•ubaubhp)r}rž(h=XÚNix-style local builds sport a robust caching system which help reduce the time it takes to execute a rebuild cycle. While the details of how ``cabal-install`` does caching are an implementation detail and may change in the future, knowing what gets cached is helpful for understanding the performance characteristics of invocations to ``v2-build``. The cached intermediate results are stored in ``dist-newstyle/cache``; this folder can be safely deleted to clear the cache.h>jŽhDhEhFhthH}rŸ(hJ]hK]hL]hM]hP]uhRKÖhShhT]r (h]XŽNix-style local builds sport a robust caching system which help reduce the time it takes to execute a rebuild cycle. While the details of how r¡…r¢}r£(h=XŽNix-style local builds sport a robust caching system which help reduce the time it takes to execute a rebuild cycle. While the details of how hDNhRNhShh>jubh–)r¤}r¥(h=X``cabal-install``hH}r¦(hJ]hK]hL]hM]hP]uh>jhT]r§h]X cabal-installr¨…r©}rª(h=X cabal-installh>j¤ubahFhžubh]X± does caching are an implementation detail and may change in the future, knowing what gets cached is helpful for understanding the performance characteristics of invocations to r«…r¬}r­(h=X± does caching are an implementation detail and may change in the future, knowing what gets cached is helpful for understanding the performance characteristics of invocations to hDNhRNhShh>jubh–)r®}r¯(h=X ``v2-build``hH}r°(hJ]hK]hL]hM]hP]uh>jhT]r±h]Xv2-buildr²…r³}r´(h=Xv2-buildh>j®ubahFhžubh]X0. The cached intermediate results are stored in rµ…r¶}r·(h=X0. The cached intermediate results are stored in hDNhRNhShh>jubh–)r¸}r¹(h=X``dist-newstyle/cache``hH}rº(hJ]hK]hL]hM]hP]uh>jhT]r»h]Xdist-newstyle/cacher¼…r½}r¾(h=Xdist-newstyle/cacheh>j¸ubahFhžubh]X7; this folder can be safely deleted to clear the cache.r¿…rÀ}rÁ(h=X7; this folder can be safely deleted to clear the cache.hDNhRNhShh>jubeubhp)rÂ}rÃ(h=XwThe following intermediate results are cached in the following files in this folder (the most important two are first):rÄh>jŽhDhEhFhthH}rÅ(hJ]hK]hL]hM]hP]uhRKßhShhT]rÆh]XwThe following intermediate results are cached in the following files in this folder (the most important two are first):rÇ…rÈ}rÉ(h=jÄhDNhRNhShh>jÂubaubj)rÊ}rË(h=Uh>jŽhDhEhFj…hH}rÌ(hJ]hK]hL]hM]hP]uhRNhShhT]rÍ(j)rÎ}rÏ(h=Xz``solver-plan`` (binary) The result of calling the dependency solver, assuming that the Hackage index, local ``cabal.project`` file, and local ``cabal`` files are unmodified. (Notably, we do NOT have to dependency solve again if new build products are stored in the global store; the invocation of the dependency solver is independent of what is already available in the store.)h>jÊhDhEhFjhH}rÐ(hJ]hK]hL]hM]hP]uhRKçhT]rÑ(j )rÒ}rÓ(h=X``solver-plan`` (binary)rÔh>jÎhDhEhFjhH}rÕ(hJ]hK]hL]hM]hP]uhRKçhT]rÖ(h–)r×}rØ(h=X``solver-plan``hH}rÙ(hJ]hK]hL]hM]hP]uh>jÒhT]rÚh]X solver-planrÛ…rÜ}rÝ(h=X solver-planh>j×ubahFhžubh]X (binary)rÞ…rß}rà(h=X (binary)h>jÒubeubj)rá}râ(h=UhH}rã(hJ]hK]hL]hM]hP]uh>jÎhT]rähp)rå}ræ(h=XaThe result of calling the dependency solver, assuming that the Hackage index, local ``cabal.project`` file, and local ``cabal`` files are unmodified. (Notably, we do NOT have to dependency solve again if new build products are stored in the global store; the invocation of the dependency solver is independent of what is already available in the store.)h>jáhDhEhFhthH}rç(hJ]hK]hL]hM]hP]uhRKãhT]rè(h]XTThe result of calling the dependency solver, assuming that the Hackage index, local ré…rê}rë(h=XTThe result of calling the dependency solver, assuming that the Hackage index, local h>jåubh–)rì}rí(h=X``cabal.project``hH}rî(hJ]hK]hL]hM]hP]uh>jåhT]rïh]X cabal.projectrð…rñ}rò(h=X cabal.projecth>jìubahFhžubh]X file, and local ró…rô}rõ(h=X file, and local h>jåubh–)rö}r÷(h=X ``cabal``hH}rø(hJ]hK]hL]hM]hP]uh>jåhT]rùh]Xcabalrú…rû}rü(h=Xcabalh>jöubahFhžubh]Xâ files are unmodified. (Notably, we do NOT have to dependency solve again if new build products are stored in the global store; the invocation of the dependency solver is independent of what is already available in the store.)rý…rþ}rÿ(h=Xâ files are unmodified. (Notably, we do NOT have to dependency solve again if new build products are stored in the global store; the invocation of the dependency solver is independent of what is already available in the store.)h>jåubeubahFj„ubeubj)r}r(h=XÚ``source-hashes`` (binary) The hashes of all local source files. When all local source files of a local package are unchanged, ``cabal v2-build`` will skip invoking ``setup build`` entirely (saving us from a possibly expensive call to ``ghc --make``). The full list of source files participating in compilation are determined using ``setup sdist --list-sources`` (thus, if you do not list all your source files in a Cabal file, you may fail to recompile when you edit them.)h>jÊhDhEhFjhH}r(hJ]hK]hL]hM]hP]uhRKðhShhT]r(j )r}r(h=X``source-hashes`` (binary)rh>jhDhEhFjhH}r(hJ]hK]hL]hM]hP]uhRKðhT]r(h–)r }r (h=X``source-hashes``hH}r (hJ]hK]hL]hM]hP]uh>jhT]r h]X source-hashesr …r}r(h=X source-hashesh>j ubahFhžubh]X (binary)r…r}r(h=X (binary)h>jubeubj)r}r(h=UhH}r(hJ]hK]hL]hM]hP]uh>jhT]rhp)r}r(h=X¿The hashes of all local source files. When all local source files of a local package are unchanged, ``cabal v2-build`` will skip invoking ``setup build`` entirely (saving us from a possibly expensive call to ``ghc --make``). The full list of source files participating in compilation are determined using ``setup sdist --list-sources`` (thus, if you do not list all your source files in a Cabal file, you may fail to recompile when you edit them.)h>jhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRKêhT]r(h]XdThe hashes of all local source files. When all local source files of a local package are unchanged, r…r}r(h=XdThe hashes of all local source files. When all local source files of a local package are unchanged, h>jubh–)r}r(h=X``cabal v2-build``hH}r (hJ]hK]hL]hM]hP]uh>jhT]r!h]Xcabal v2-buildr"…r#}r$(h=Xcabal v2-buildh>jubahFhžubh]X will skip invoking r%…r&}r'(h=X will skip invoking h>jubh–)r(}r)(h=X``setup build``hH}r*(hJ]hK]hL]hM]hP]uh>jhT]r+h]X setup buildr,…r-}r.(h=X setup buildh>j(ubahFhžubh]X7 entirely (saving us from a possibly expensive call to r/…r0}r1(h=X7 entirely (saving us from a possibly expensive call to h>jubh–)r2}r3(h=X``ghc --make``hH}r4(hJ]hK]hL]hM]hP]uh>jhT]r5h]X ghc --maker6…r7}r8(h=X ghc --makeh>j2ubahFhžubh]XS). The full list of source files participating in compilation are determined using r9…r:}r;(h=XS). The full list of source files participating in compilation are determined using h>jubh–)r<}r=(h=X``setup sdist --list-sources``hH}r>(hJ]hK]hL]hM]hP]uh>jhT]r?h]Xsetup sdist --list-sourcesr@…rA}rB(h=Xsetup sdist --list-sourcesh>j<ubahFhžubh]Xp (thus, if you do not list all your source files in a Cabal file, you may fail to recompile when you edit them.)rC…rD}rE(h=Xp (thus, if you do not list all your source files in a Cabal file, you may fail to recompile when you edit them.)h>jubeubahFj„ubeubj)rF}rG(h=X ``config`` (same format as ``cabal.project``) The full project configuration, merged from ``cabal.project`` (and friends) as well as the command line arguments.h>jÊhDhEhFjhH}rH(hJ]hK]hL]hM]hP]uhRKóhShhT]rI(j )rJ}rK(h=X-``config`` (same format as ``cabal.project``)rLh>jFhDhEhFjhH}rM(hJ]hK]hL]hM]hP]uhRKóhT]rN(h–)rO}rP(h=X ``config``hH}rQ(hJ]hK]hL]hM]hP]uh>jJhT]rRh]XconfigrS…rT}rU(h=Xconfigh>jOubahFhžubh]X (same format as rV…rW}rX(h=X (same format as h>jJubh–)rY}rZ(h=X``cabal.project``hH}r[(hJ]hK]hL]hM]hP]uh>jJhT]r\h]X cabal.projectr]…r^}r_(h=X cabal.projecth>jYubahFhžubh]X)…r`}ra(h=X)h>jJubeubj)rb}rc(h=UhH}rd(hJ]hK]hL]hM]hP]uh>jFhT]rehp)rf}rg(h=XrThe full project configuration, merged from ``cabal.project`` (and friends) as well as the command line arguments.h>jbhDhEhFhthH}rh(hJ]hK]hL]hM]hP]uhRKóhT]ri(h]X,The full project configuration, merged from rj…rk}rl(h=X,The full project configuration, merged from h>jfubh–)rm}rn(h=X``cabal.project``hH}ro(hJ]hK]hL]hM]hP]uh>jfhT]rph]X cabal.projectrq…rr}rs(h=X cabal.projecth>jmubahFhžubh]X5 (and friends) as well as the command line arguments.rt…ru}rv(h=X5 (and friends) as well as the command line arguments.h>jfubeubahFj„ubeubj)rw}rx(h=XX``compiler`` (binary) The configuration of the compiler being used to build the project.h>jÊhDhEhFjhH}ry(hJ]hK]hL]hM]hP]uhRKõhShhT]rz(j )r{}r|(h=X``compiler`` (binary)r}h>jwhDhEhFjhH}r~(hJ]hK]hL]hM]hP]uhRKõhT]r(h–)r€}r(h=X ``compiler``hH}r‚(hJ]hK]hL]hM]hP]uh>j{hT]rƒh]Xcompilerr„…r…}r†(h=Xcompilerh>j€ubahFhžubh]X (binary)r‡…rˆ}r‰(h=X (binary)h>j{ubeubj)rŠ}r‹(h=UhH}rŒ(hJ]hK]hL]hM]hP]uh>jwhT]rhp)rŽ}r(h=XBThe configuration of the compiler being used to build the project.rh>jŠhDhEhFhthH}r‘(hJ]hK]hL]hM]hP]uhRKöhT]r’h]XBThe configuration of the compiler being used to build the project.r“…r”}r•(h=jh>jŽubaubahFj„ubeubj)r–}r—(h=X„``improved-plan`` (binary) Like ``solver-plan``, but with all non-inplace packages improved into pre-existing copies from the store.h>jÊhDhEhFjhH}r˜(hJ]hK]hL]hM]hP]uhRKøhShhT]r™(j )rš}r›(h=X``improved-plan`` (binary)rœh>j–hDhEhFjhH}r(hJ]hK]hL]hM]hP]uhRKøhT]rž(h–)rŸ}r (h=X``improved-plan``hH}r¡(hJ]hK]hL]hM]hP]uh>jšhT]r¢h]X improved-planr£…r¤}r¥(h=X improved-planh>jŸubahFhžubh]X (binary)r¦…r§}r¨(h=X (binary)h>jšubeubj)r©}rª(h=UhH}r«(hJ]hK]hL]hM]hP]uh>j–hT]r¬hp)r­}r®(h=XiLike ``solver-plan``, but with all non-inplace packages improved into pre-existing copies from the store.h>j©hDhEhFhthH}r¯(hJ]hK]hL]hM]hP]uhRKøhT]r°(h]XLike r±…r²}r³(h=XLike h>j­ubh–)r´}rµ(h=X``solver-plan``hH}r¶(hJ]hK]hL]hM]hP]uh>j­hT]r·h]X solver-planr¸…r¹}rº(h=X solver-planh>j´ubahFhžubh]XU, but with all non-inplace packages improved into pre-existing copies from the store.r»…r¼}r½(h=XU, but with all non-inplace packages improved into pre-existing copies from the store.h>j­ubeubahFj„ubeubj)r¾}r¿(h=X£``plan.json`` (JSON) A JSON serialization of the computed install plan intended for integrating ``cabal`` with external tooling. The `cabal-plan `__ package provides a library for parsing ``plan.json`` files into a Haskell data structure as well as an example tool showing possible applications. .. todo:: Document JSON schema (including version history of schema) h>jÊhDhEhFjhH}rÀ(hJ]hK]hL]hM]hP]uhRMhShhT]rÁ(j )rÂ}rÃ(h=X``plan.json`` (JSON)rÄh>j¾hDhEhFjhH}rÅ(hJ]hK]hL]hM]hP]uhRMhT]rÆ(h–)rÇ}rÈ(h=X ``plan.json``hH}rÉ(hJ]hK]hL]hM]hP]uh>jÂhT]rÊh]X plan.jsonrË…rÌ}rÍ(h=X plan.jsonh>jÇubahFhžubh]X (JSON)rÎ…rÏ}rÐ(h=X (JSON)h>jÂubeubj)rÑ}rÒ(h=UhH}rÓ(hJ]hK]hL]hM]hP]uh>j¾hT]rÔ(hp)rÕ}rÖ(h=XAA JSON serialization of the computed install plan intended for integrating ``cabal`` with external tooling. The `cabal-plan `__ package provides a library for parsing ``plan.json`` files into a Haskell data structure as well as an example tool showing possible applications.h>jÑhDhEhFhthH}r×(hJ]hK]hL]hM]hP]uhRKûhT]rØ(h]XKA JSON serialization of the computed install plan intended for integrating rÙ…rÚ}rÛ(h=XKA JSON serialization of the computed install plan intended for integrating h>jÕubh–)rÜ}rÝ(h=X ``cabal``hH}rÞ(hJ]hK]hL]hM]hP]uh>jÕhT]rßh]Xcabalrà…rá}râ(h=Xcabalh>jÜubahFhžubh]X with external tooling. The rã…rä}rå(h=X with external tooling. The h>jÕubcdocutils.nodes reference ræ)rç}rè(h=X>`cabal-plan `__hH}ré(UnameX cabal-planUrefurirêX-http://hackage.haskell.org/package/cabal-planhM]hL]hJ]hK]hP]uh>jÕhT]rëh]X cabal-planrì…rí}rî(h=X cabal-planh>jçubahFU referencerïubh]X( package provides a library for parsing rð…rñ}rò(h=X( package provides a library for parsing h>jÕubh–)ró}rô(h=X ``plan.json``hH}rõ(hJ]hK]hL]hM]hP]uh>jÕhT]röh]X plan.jsonr÷…rø}rù(h=X plan.jsonh>jóubahFhžubh]X^ files into a Haskell data structure as well as an example tool showing possible applications.rú…rû}rü(h=X^ files into a Haskell data structure as well as an example tool showing possible applications.h>jÕubeubcdocutils.nodes target rý)rþ}rÿ(h=UhH}r(hM]hL]hJ]hK]hP]UrefidrUindex-0ruh>jÑhT]hFUtargetrubcsphinx.ext.todo todo_node r)r}r(h=X:Document JSON schema (including version history of schema)rh>jÑhDhEUexpect_referenced_by_namer}hFU todo_noder hH}r (U targetrefr Xnix-local-build:index-0r hM]r jahL]hJ]hK]rUadmonition-todorahP]uhRMUexpect_referenced_by_idr}rjjþshT]r(hV)r}r(h=XTodorh>jhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRMhT]rh]XTodor…r}r(h=Uh>jubaubhp)r}r(h=jh>jhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMhT]rh]X:Document JSON schema (including version history of schema)r…r }r!(h=jh>jubaubeubehFj„ubeubeubhp)r"}r#(h=XnNote that every package also has a local cache managed by the Cabal build system, e.g., in ``$distdir/cache``.h>jŽhDhEhFhthH}r$(hJ]hK]hL]hM]hP]uhRMhShhT]r%(h]X[Note that every package also has a local cache managed by the Cabal build system, e.g., in r&…r'}r((h=X[Note that every package also has a local cache managed by the Cabal build system, e.g., in hDNhRNhShh>j"ubh–)r)}r*(h=X``$distdir/cache``hH}r+(hJ]hK]hL]hM]hP]uh>j"hT]r,h]X$distdir/cacher-…r.}r/(h=X$distdir/cacheh>j)ubahFhžubh]X.…r0}r1(h=X.hDNhRNhShh>j"ubeubhp)r2}r3(h=X¹There is another useful file in ``dist-newstyle/cache``, ``plan.json``, which is a JSON serialization of the computed install plan and is intended for integrating with external tooling.h>jŽhDhEhFhthH}r4(hJ]hK]hL]hM]hP]uhRM hShhT]r5(h]X There is another useful file in r6…r7}r8(h=X There is another useful file in hDNhRNhShh>j2ubh–)r9}r:(h=X``dist-newstyle/cache``hH}r;(hJ]hK]hL]hM]hP]uh>j2hT]r<h]Xdist-newstyle/cacher=…r>}r?(h=Xdist-newstyle/cacheh>j9ubahFhžubh]X, r@…rA}rB(h=X, hDNhRNhShh>j2ubh–)rC}rD(h=X ``plan.json``hH}rE(hJ]hK]hL]hM]hP]uh>j2hT]rFh]X plan.jsonrG…rH}rI(h=X plan.jsonh>jCubahFhžubh]Xs, which is a JSON serialization of the computed install plan and is intended for integrating with external tooling.rJ…rK}rL(h=Xs, which is a JSON serialization of the computed install plan and is intended for integrating with external tooling.hDNhRNhShh>j2ubeubeubeubhDhEhFhGhH}rM(hJ]hK]hL]hM]rNUlocal-versus-external-packagesrOahP]rPh2auhRKohShhT]rQ(hV)rR}rS(h=XLocal versus external packagesrTh>h@hDhEhFhZhH}rU(hJ]hK]hL]hM]hP]uhRKohShhT]rVh]XLocal versus external packagesrW…rX}rY(h=jThDNhRNhShh>jRubaubhp)rZ}r[(h=XôOne of the primary innovations of Nix-style local builds is the distinction between local packages, which users edit and recompile and must be built per-project, versus external packages, which can be cached across projects. To be more precise:r\h>h@hDhEhFhthH}r](hJ]hK]hL]hM]hP]uhRKqhShhT]r^h]XôOne of the primary innovations of Nix-style local builds is the distinction between local packages, which users edit and recompile and must be built per-project, versus external packages, which can be cached across projects. To be more precise:r_…r`}ra(h=j\hDNhRNhShh>jZubaubcdocutils.nodes enumerated_list rb)rc}rd(h=Uh>h@hDhEhFUenumerated_listrehH}rf(UsuffixrgU.hM]hL]hJ]UprefixrhUhK]hP]UenumtyperiUarabicrjuhRKvhShhT]rkh‰)rl}rm(h=XXA **local package** is one that is listed explicitly in the ``packages``, ``optional-packages`` or ``extra-packages`` field of a project. Usually, these refer to packages whose source code lives directly in a folder in your project (although, you can list an arbitrary Hackage package in ``extra-packages`` to force it to be treated as local). h>jchDhEhFhŒhH}rn(hJ]hK]hL]hM]hP]uhRNhShhT]rohp)rp}rq(h=XWA **local package** is one that is listed explicitly in the ``packages``, ``optional-packages`` or ``extra-packages`` field of a project. Usually, these refer to packages whose source code lives directly in a folder in your project (although, you can list an arbitrary Hackage package in ``extra-packages`` to force it to be treated as local).h>jlhDhEhFhthH}rr(hJ]hK]hL]hM]hP]uhRKvhT]rs(h]XA rt…ru}rv(h=XA h>jpubcdocutils.nodes strong rw)rx}ry(h=X**local package**hH}rz(hJ]hK]hL]hM]hP]uh>jphT]r{h]X local packager|…r}}r~(h=X local packageh>jxubahFUstrongrubh]X) is one that is listed explicitly in the r€…r}r‚(h=X) is one that is listed explicitly in the h>jpubh–)rƒ}r„(h=X ``packages``hH}r…(hJ]hK]hL]hM]hP]uh>jphT]r†h]Xpackagesr‡…rˆ}r‰(h=Xpackagesh>jƒubahFhžubh]X, rŠ…r‹}rŒ(h=X, h>jpubh–)r}rŽ(h=X``optional-packages``hH}r(hJ]hK]hL]hM]hP]uh>jphT]rh]Xoptional-packagesr‘…r’}r“(h=Xoptional-packagesh>jubahFhžubh]X or r”…r•}r–(h=X or h>jpubh–)r—}r˜(h=X``extra-packages``hH}r™(hJ]hK]hL]hM]hP]uh>jphT]ršh]Xextra-packagesr›…rœ}r(h=Xextra-packagesh>j—ubahFhžubh]X« field of a project. Usually, these refer to packages whose source code lives directly in a folder in your project (although, you can list an arbitrary Hackage package in rž…rŸ}r (h=X« field of a project. Usually, these refer to packages whose source code lives directly in a folder in your project (although, you can list an arbitrary Hackage package in h>jpubh–)r¡}r¢(h=X``extra-packages``hH}r£(hJ]hK]hL]hM]hP]uh>jphT]r¤h]Xextra-packagesr¥…r¦}r§(h=Xextra-packagesh>j¡ubahFhžubh]X% to force it to be treated as local).r¨…r©}rª(h=X% to force it to be treated as local).h>jpubeubaubaubhp)r«}r¬(h=XOLocal packages, as well as the external packages (below) which depend on them, are built **inplace**, meaning that they are always built specifically for the project and are not installed globally. Inplace packages are not cached and not given unique hashes, which makes them suitable for packages which you want to edit and recompile.h>h@hDhEhFhthH}r­(hJ]hK]hL]hM]hP]uhRK}hShhT]r®(h]XYLocal packages, as well as the external packages (below) which depend on them, are built r¯…r°}r±(h=XYLocal packages, as well as the external packages (below) which depend on them, are built hDNhRNhShh>j«ubjw)r²}r³(h=X **inplace**hH}r´(hJ]hK]hL]hM]hP]uh>j«hT]rµh]Xinplacer¶…r·}r¸(h=Xinplaceh>j²ubahFjubh]Xë, meaning that they are always built specifically for the project and are not installed globally. Inplace packages are not cached and not given unique hashes, which makes them suitable for packages which you want to edit and recompile.r¹…rº}r»(h=Xë, meaning that they are always built specifically for the project and are not installed globally. Inplace packages are not cached and not given unique hashes, which makes them suitable for packages which you want to edit and recompile.hDNhRNhShh>j«ubeubjb)r¼}r½(h=Uh>h@hDhEhFjehH}r¾(jgU.Ustartr¿KhM]hL]hJ]jhUhK]hP]jijjuhRKƒhShhT]rÀh‰)rÁ}rÂ(h=XŸAn **external package** is any package which is not listed in the ``packages`` field. The source code for external packages is usually retrieved from Hackage. h>j¼hDhEhFhŒhH}rÃ(hJ]hK]hL]hM]hP]uhRNhShhT]rÄhp)rÅ}rÆ(h=XžAn **external package** is any package which is not listed in the ``packages`` field. The source code for external packages is usually retrieved from Hackage.h>jÁhDhEhFhthH}rÇ(hJ]hK]hL]hM]hP]uhRKƒhT]rÈ(h]XAn rÉ…rÊ}rË(h=XAn h>jÅubjw)rÌ}rÍ(h=X**external package**hH}rÎ(hJ]hK]hL]hM]hP]uh>jÅhT]rÏh]Xexternal packagerÐ…rÑ}rÒ(h=Xexternal packageh>jÌubahFjubh]X+ is any package which is not listed in the rÓ…rÔ}rÕ(h=X+ is any package which is not listed in the h>jÅubh–)rÖ}r×(h=X ``packages``hH}rØ(hJ]hK]hL]hM]hP]uh>jÅhT]rÙh]XpackagesrÚ…rÛ}rÜ(h=Xpackagesh>jÖubahFhžubh]XP field. The source code for external packages is usually retrieved from Hackage.rÝ…rÞ}rß(h=XP field. The source code for external packages is usually retrieved from Hackage.h>jÅubeubaubaubhp)rà}rá(h=XúWhen an external package does not depend on an inplace package, it can be built and installed to a **global** store, which can be shared across projects. These build products are identified by a hash that over all of the inputs which would influence the compilation of a package (flags, dependency selection, etc.). Just as in Nix, these hashes uniquely identify the result of a build; if we compute this identifier and we find that we already have this ID built, we can just use the already built version.h>h@hDhEhFhthH}râ(hJ]hK]hL]hM]hP]uhRK‡hShhT]rã(h]XcWhen an external package does not depend on an inplace package, it can be built and installed to a rä…rå}ræ(h=XcWhen an external package does not depend on an inplace package, it can be built and installed to a hDNhRNhShh>jàubjw)rç}rè(h=X **global**hH}ré(hJ]hK]hL]hM]hP]uh>jàhT]rêh]Xglobalrë…rì}rí(h=Xglobalh>jçubahFjubh]X store, which can be shared across projects. These build products are identified by a hash that over all of the inputs which would influence the compilation of a package (flags, dependency selection, etc.). Just as in Nix, these hashes uniquely identify the result of a build; if we compute this identifier and we find that we already have this ID built, we can just use the already built version.rî…rï}rð(h=X store, which can be shared across projects. These build products are identified by a hash that over all of the inputs which would influence the compilation of a package (flags, dependency selection, etc.). Just as in Nix, these hashes uniquely identify the result of a build; if we compute this identifier and we find that we already have this ID built, we can just use the already built version.hDNhRNhShh>jàubeubhp)rñ}rò(h=XEThe global package store is ``~/.cabal/store`` (configurable via global `store-dir` option); if you need to clear your store for whatever reason (e.g., to reclaim disk space or because the global store is corrupted), deleting this directory is safe (``v2-build`` will just rebuild everything it needs on its next invocation).h>h@hDhEhFhthH}ró(hJ]hK]hL]hM]hP]uhRKhShhT]rô(h]XThe global package store is rõ…rö}r÷(h=XThe global package store is hDNhRNhShh>jñubh–)rø}rù(h=X``~/.cabal/store``hH}rú(hJ]hK]hL]hM]hP]uh>jñhT]rûh]X~/.cabal/storerü…rý}rþ(h=X~/.cabal/storeh>jøubahFhžubh]X (configurable via global rÿ…r}r(h=X (configurable via global hDNhRNhShh>jñubcdocutils.nodes title_reference r)r}r(h=X `store-dir`hH}r(hJ]hK]hL]hM]hP]uh>jñhT]rh]X store-dirr…r}r (h=X store-dirh>jubahFUtitle_referencer ubh]X§ option); if you need to clear your store for whatever reason (e.g., to reclaim disk space or because the global store is corrupted), deleting this directory is safe (r …r }r (h=X§ option); if you need to clear your store for whatever reason (e.g., to reclaim disk space or because the global store is corrupted), deleting this directory is safe (hDNhRNhShh>jñubh–)r}r(h=X ``v2-build``hH}r(hJ]hK]hL]hM]hP]uh>jñhT]rh]Xv2-buildr…r}r(h=Xv2-buildh>jubahFhžubh]X? will just rebuild everything it needs on its next invocation).r…r}r(h=X? will just rebuild everything it needs on its next invocation).hDNhRNhShh>jñubeubhp)r}r(h=X-This split motivates some of the UI choices for Nix-style local build commands. For example, flags passed to ``cabal v2-build`` are only applied to *local* packages, so that adding a flag to ``cabal v2-build`` doesn't necessitate a rebuild of *every* transitive dependency in the global package store.h>h@hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRK–hShhT]r(h]XmThis split motivates some of the UI choices for Nix-style local build commands. For example, flags passed to r…r}r(h=XmThis split motivates some of the UI choices for Nix-style local build commands. For example, flags passed to hDNhRNhShh>jubh–)r}r (h=X``cabal v2-build``hH}r!(hJ]hK]hL]hM]hP]uh>jhT]r"h]Xcabal v2-buildr#…r$}r%(h=Xcabal v2-buildh>jubahFhžubh]X are only applied to r&…r'}r((h=X are only applied to hDNhRNhShh>jubcdocutils.nodes emphasis r))r*}r+(h=X*local*hH}r,(hJ]hK]hL]hM]hP]uh>jhT]r-h]Xlocalr.…r/}r0(h=Xlocalh>j*ubahFUemphasisr1ubh]X$ packages, so that adding a flag to r2…r3}r4(h=X$ packages, so that adding a flag to hDNhRNhShh>jubh–)r5}r6(h=X``cabal v2-build``hH}r7(hJ]hK]hL]hM]hP]uh>jhT]r8h]Xcabal v2-buildr9…r:}r;(h=Xcabal v2-buildh>j5ubahFhžubh]X$ doesn’t necessitate a rebuild of r<…r=}r>(h=X" doesn't necessitate a rebuild of hDNhRNhShh>jubj))r?}r@(h=X*every*hH}rA(hJ]hK]hL]hM]hP]uh>jhT]rBh]XeveryrC…rD}rE(h=Xeveryh>j?ubahFj1ubh]X3 transitive dependency in the global package store.rF…rG}rH(h=X3 transitive dependency in the global package store.hDNhRNhShh>jubeubhp)rI}rJ(h=X*In cabal-install 2.0 and above, Nix-style local builds also take advantage of a new Cabal library feature, `per-component builds `__, where each component of a package is configured and built separately. This can massively speed up rebuilds of packages with lots of components (e.g., a package that defines multiple executables), as only one executable needs to be rebuilt. Packages that use Custom setup scripts are not currently built on a per-component basis.h>h@hDhEhFhthH}rK(hJ]hK]hL]hM]hP]uhRKœhShhT]rL(h]XkIn cabal-install 2.0 and above, Nix-style local builds also take advantage of a new Cabal library feature, rM…rN}rO(h=XkIn cabal-install 2.0 and above, Nix-style local builds also take advantage of a new Cabal library feature, hDNhRNhShh>jIubjæ)rP}rQ(h=Xu`per-component builds `__hH}rR(UnameXper-component buildsjêXZhttps://github.com/ezyang/ghc-proposals/blob/master/proposals/0000-componentized-cabal.rsthM]hL]hJ]hK]hP]uh>jIhT]rSh]Xper-component buildsrT…rU}rV(h=Xper-component buildsh>jPubahFjïubh]XJ, where each component of a package is configured and built separately. This can massively speed up rebuilds of packages with lots of components (e.g., a package that defines multiple executables), as only one executable needs to be rebuilt. Packages that use Custom setup scripts are not currently built on a per-component basis.rW…rX}rY(h=XJ, where each component of a package is configured and built separately. This can massively speed up rebuilds of packages with lots of components (e.g., a package that defines multiple executables), as only one executable needs to be rebuilt. Packages that use Custom setup scripts are not currently built on a per-component basis.hDNhRNhShh>jIubeubeubhDhEhFUsystem_messagerZhH}r[(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineKlUtypeUINFOr\uhRKƒhShhT]r]hp)r^}r_(h=X:Enumerated list start value not ordinal-1: "2" (ordinal 2)hH}r`(hJ]hK]hL]hM]hP]uh>h;hT]rah]X>Enumerated list start value not ordinal-1: “2†(ordinal 2)rb…rc}rd(h=Uh>j^ubahFhtubaubh:)re}rf(h=UhH}rg(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMbUtypeUERRORrhuh>h‰)ri}rj(h=X%Components of a particular type: ``package:ctypes``, ``all:ctypes``: which specifies all components of the given type. Where valid ``ctypes`` are: - ``libs``, ``libraries``, - ``flibs``, ``foreign-libraries``, - ``exes``, ``executables``, - ``tests``, - ``benches``, ``benchmarks``. h>h‚)rk}rl(h=Uh>h?)rm}rn(h=Uh>h?)ro}rp(h=Uh>hhDhEhFhGhH}rq(hJ]hK]hL]hM]rrUcommandsrsahP]rth+auhRMhShhT]ru(hV)rv}rw(h=XCommandsrxh>johDhEhFhZhH}ry(hJ]hK]hL]hM]hP]uhRMhShhT]rzh]XCommandsr{…r|}r}(h=jxhDNhRNhShh>jvubaubhp)r~}r(h=XhWe now give an in-depth description of all the commands, describing the arguments and flags they accept.r€h>johDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMhShhT]r‚h]XhWe now give an in-depth description of all the commands, describing the arguments and flags they accept.rƒ…r„}r…(h=j€hDNhRNhShh>j~ubaubh?)r†}r‡(h=Uh>johDhEhFhGhH}rˆ(hJ]hK]hL]hM]r‰Ucabal-v2-configurerŠahP]r‹hauhRMhShhT]rŒ(hV)r}rŽ(h=Xcabal v2-configurerh>j†hDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRMhShhT]r‘h]Xcabal v2-configurer’…r“}r”(h=jhDNhRNhShh>jubaubhp)r•}r–(h=XI``cabal v2-configure`` takes a set of arguments and writes a ``cabal.project.local`` file based on the flags passed to this command. ``cabal v2-configure FLAGS; cabal new-build`` is roughly equivalent to ``cabal v2-build FLAGS``, except that with ``new-configure`` the flags are persisted to all subsequent calls to ``v2-build``.h>j†hDhEhFhthH}r—(hJ]hK]hL]hM]hP]uhRMhShhT]r˜(h–)r™}rš(h=X``cabal v2-configure``hH}r›(hJ]hK]hL]hM]hP]uh>j•hT]rœh]Xcabal v2-configurer…rž}rŸ(h=Xcabal v2-configureh>j™ubahFhžubh]X' takes a set of arguments and writes a r …r¡}r¢(h=X' takes a set of arguments and writes a hDNhRNhShh>j•ubh–)r£}r¤(h=X``cabal.project.local``hH}r¥(hJ]hK]hL]hM]hP]uh>j•hT]r¦h]Xcabal.project.localr§…r¨}r©(h=Xcabal.project.localh>j£ubahFhžubh]X1 file based on the flags passed to this command. rª…r«}r¬(h=X1 file based on the flags passed to this command. hDNhRNhShh>j•ubh–)r­}r®(h=X-``cabal v2-configure FLAGS; cabal new-build``hH}r¯(hJ]hK]hL]hM]hP]uh>j•hT]r°h]X)cabal v2-configure FLAGS; cabal new-buildr±…r²}r³(h=X)cabal v2-configure FLAGS; cabal new-buildh>j­ubahFhžubh]X is roughly equivalent to r´…rµ}r¶(h=X is roughly equivalent to hDNhRNhShh>j•ubh–)r·}r¸(h=X``cabal v2-build FLAGS``hH}r¹(hJ]hK]hL]hM]hP]uh>j•hT]rºh]Xcabal v2-build FLAGSr»…r¼}r½(h=Xcabal v2-build FLAGSh>j·ubahFhžubh]X, except that with r¾…r¿}rÀ(h=X, except that with hDNhRNhShh>j•ubh–)rÁ}rÂ(h=X``new-configure``hH}rÃ(hJ]hK]hL]hM]hP]uh>j•hT]rÄh]X new-configurerÅ…rÆ}rÇ(h=X new-configureh>jÁubahFhžubh]X4 the flags are persisted to all subsequent calls to rÈ…rÉ}rÊ(h=X4 the flags are persisted to all subsequent calls to hDNhRNhShh>j•ubh–)rË}rÌ(h=X ``v2-build``hH}rÍ(hJ]hK]hL]hM]hP]uh>j•hT]rÎh]Xv2-buildrÏ…rÐ}rÑ(h=Xv2-buildh>jËubahFhžubh]X.…rÒ}rÓ(h=X.hDNhRNhShh>j•ubeubhp)rÔ}rÕ(h=X•``cabal v2-configure`` is intended to be a convenient way to write out a ``cabal.project.local`` for simple configurations; e.g., ``cabal v2-configure -w ghc-7.8`` would ensure that all subsequent builds with ``cabal v2-build`` are performed with the compiler ``ghc-7.8``. For more complex configuration, we recommend writing the ``cabal.project.local`` file directly (or placing it in ``cabal.project``!)h>j†hDhEhFhthH}rÖ(hJ]hK]hL]hM]hP]uhRM hShhT]r×(h–)rØ}rÙ(h=X``cabal v2-configure``hH}rÚ(hJ]hK]hL]hM]hP]uh>jÔhT]rÛh]Xcabal v2-configurerÜ…rÝ}rÞ(h=Xcabal v2-configureh>jØubahFhžubh]X3 is intended to be a convenient way to write out a rß…rà}rá(h=X3 is intended to be a convenient way to write out a hDNhRNhShh>jÔubh–)râ}rã(h=X``cabal.project.local``hH}rä(hJ]hK]hL]hM]hP]uh>jÔhT]råh]Xcabal.project.localræ…rç}rè(h=Xcabal.project.localh>jâubahFhžubh]X" for simple configurations; e.g., ré…rê}rë(h=X" for simple configurations; e.g., hDNhRNhShh>jÔubh–)rì}rí(h=X!``cabal v2-configure -w ghc-7.8``hH}rî(hJ]hK]hL]hM]hP]uh>jÔhT]rïh]Xcabal v2-configure -w ghc-7.8rð…rñ}rò(h=Xcabal v2-configure -w ghc-7.8h>jìubahFhžubh]X. would ensure that all subsequent builds with ró…rô}rõ(h=X. would ensure that all subsequent builds with hDNhRNhShh>jÔubh–)rö}r÷(h=X``cabal v2-build``hH}rø(hJ]hK]hL]hM]hP]uh>jÔhT]rùh]Xcabal v2-buildrú…rû}rü(h=Xcabal v2-buildh>jöubahFhžubh]X! are performed with the compiler rý…rþ}rÿ(h=X! are performed with the compiler hDNhRNhShh>jÔubh–)r}r(h=X ``ghc-7.8``hH}r(hJ]hK]hL]hM]hP]uh>jÔhT]rh]Xghc-7.8r…r}r(h=Xghc-7.8h>jubahFhžubh]X;. For more complex configuration, we recommend writing the r…r}r (h=X;. For more complex configuration, we recommend writing the hDNhRNhShh>jÔubh–)r }r (h=X``cabal.project.local``hH}r (hJ]hK]hL]hM]hP]uh>jÔhT]r h]Xcabal.project.localr…r}r(h=Xcabal.project.localh>j ubahFhžubh]X! file directly (or placing it in r…r}r(h=X! file directly (or placing it in hDNhRNhShh>jÔubh–)r}r(h=X``cabal.project``hH}r(hJ]hK]hL]hM]hP]uh>jÔhT]rh]X cabal.projectr…r}r(h=X cabal.projecth>jubahFhžubh]X!)r…r}r(h=X!)hDNhRNhShh>jÔubeubhp)r}r(h=XB``cabal v2-configure`` inherits options from ``Cabal``. semantics:r h>j†hDhEhFhthH}r!(hJ]hK]hL]hM]hP]uhRM(hShhT]r"(h–)r#}r$(h=X``cabal v2-configure``hH}r%(hJ]hK]hL]hM]hP]uh>jhT]r&h]Xcabal v2-configurer'…r(}r)(h=Xcabal v2-configureh>j#ubahFhžubh]X inherits options from r*…r+}r,(h=X inherits options from hDNhRNhShh>jubh–)r-}r.(h=X ``Cabal``hH}r/(hJ]hK]hL]hM]hP]uh>jhT]r0h]XCabalr1…r2}r3(h=XCabalh>j-ubahFhžubh]X . semantics:r4…r5}r6(h=X . semantics:hDNhRNhShh>jubeubh‚)r7}r8(h=Uh>j†hDhEhFh…hH}r9(h‡X-hM]hL]hJ]hK]hP]uhRM*hShhT]r:(h‰)r;}r<(h=X,Any flag accepted by ``./Setup configure``. h>j7hDhEhFhŒhH}r=(hJ]hK]hL]hM]hP]uhRNhShhT]r>hp)r?}r@(h=X+Any flag accepted by ``./Setup configure``.h>j;hDhEhFhthH}rA(hJ]hK]hL]hM]hP]uhRM*hT]rB(h]XAny flag accepted by rC…rD}rE(h=XAny flag accepted by h>j?ubh–)rF}rG(h=X``./Setup configure``hH}rH(hJ]hK]hL]hM]hP]uh>j?hT]rIh]X./Setup configurerJ…rK}rL(h=X./Setup configureh>jFubahFhžubh]X.…rM}rN(h=X.h>j?ubeubaubh‰)rO}rP(h=XœAny flag accepted by ``cabal configure`` beyond ``./Setup configure``, namely ``--cabal-lib-version``, ``--constraint``, ``--preference`` and ``--solver.`` h>j7hDhEhFhŒhH}rQ(hJ]hK]hL]hM]hP]uhRNhShhT]rRhp)rS}rT(h=X›Any flag accepted by ``cabal configure`` beyond ``./Setup configure``, namely ``--cabal-lib-version``, ``--constraint``, ``--preference`` and ``--solver.``h>jOhDhEhFhthH}rU(hJ]hK]hL]hM]hP]uhRM,hT]rV(h]XAny flag accepted by rW…rX}rY(h=XAny flag accepted by h>jSubh–)rZ}r[(h=X``cabal configure``hH}r\(hJ]hK]hL]hM]hP]uh>jShT]r]h]Xcabal configurer^…r_}r`(h=Xcabal configureh>jZubahFhžubh]X beyond ra…rb}rc(h=X beyond h>jSubh–)rd}re(h=X``./Setup configure``hH}rf(hJ]hK]hL]hM]hP]uh>jShT]rgh]X./Setup configurerh…ri}rj(h=X./Setup configureh>jdubahFhžubh]X , namely rk…rl}rm(h=X , namely h>jSubh–)rn}ro(h=X``--cabal-lib-version``hH}rp(hJ]hK]hL]hM]hP]uh>jShT]rqh]X--cabal-lib-versionrr…rs}rt(h=X--cabal-lib-versionh>jnubahFhžubh]X, ru…rv}rw(h=X, h>jSubh–)rx}ry(h=X``--constraint``hH}rz(hJ]hK]hL]hM]hP]uh>jShT]r{h]X --constraintr|…r}}r~(h=X --constrainth>jxubahFhžubh]X, r…r€}r(h=X, h>jSubh–)r‚}rƒ(h=X``--preference``hH}r„(hJ]hK]hL]hM]hP]uh>jShT]r…h]X --preferencer†…r‡}rˆ(h=X --preferenceh>j‚ubahFhžubh]X and r‰…rŠ}r‹(h=X and h>jSubh–)rŒ}r(h=X ``--solver.``hH}rŽ(hJ]hK]hL]hM]hP]uh>jShT]rh]X --solver.r…r‘}r’(h=X --solver.h>jŒubahFhžubeubaubh‰)r“}r”(h=XEAny flag accepted by ``cabal install`` beyond ``./Setup configure``. h>j7hDhEhFhŒhH}r•(hJ]hK]hL]hM]hP]uhRNhShhT]r–hp)r—}r˜(h=XDAny flag accepted by ``cabal install`` beyond ``./Setup configure``.h>j“hDhEhFhthH}r™(hJ]hK]hL]hM]hP]uhRM0hT]rš(h]XAny flag accepted by r›…rœ}r(h=XAny flag accepted by h>j—ubh–)rž}rŸ(h=X``cabal install``hH}r (hJ]hK]hL]hM]hP]uh>j—hT]r¡h]X cabal installr¢…r£}r¤(h=X cabal installh>jžubahFhžubh]X beyond r¥…r¦}r§(h=X beyond h>j—ubh–)r¨}r©(h=X``./Setup configure``hH}rª(hJ]hK]hL]hM]hP]uh>j—hT]r«h]X./Setup configurer¬…r­}r®(h=X./Setup configureh>j¨ubahFhžubh]X.…r¯}r°(h=X.h>j—ubeubaubh‰)r±}r²(h=X*Any flag accepted by ``./Setup haddock``. h>j7hDhEhFhŒhH}r³(hJ]hK]hL]hM]hP]uhRNhShhT]r´hp)rµ}r¶(h=X)Any flag accepted by ``./Setup haddock``.h>j±hDhEhFhthH}r·(hJ]hK]hL]hM]hP]uhRM2hT]r¸(h]XAny flag accepted by r¹…rº}r»(h=XAny flag accepted by h>jµubh–)r¼}r½(h=X``./Setup haddock``hH}r¾(hJ]hK]hL]hM]hP]uh>jµhT]r¿h]X./Setup haddockrÀ…rÁ}rÂ(h=X./Setup haddockh>j¼ubahFhžubh]X.…rÃ}rÄ(h=X.h>jµubeubaubeubhp)rÅ}rÆ(h=XThe options of all of these flags apply only to *local* packages in a project; this behavior is different than that of ``cabal install``, which applies flags to every package that would be built. The motivation for this is to avoid an innocuous addition to the flags of a package resulting in a rebuild of every package in the store (which might need to happen if a flag actually applied to every transitive dependency). To apply options to an external package, use a ``package`` stanza in a ``cabal.project`` file.h>j†hDhEhFhthH}rÇ(hJ]hK]hL]hM]hP]uhRM4hShhT]rÈ(h]X0The options of all of these flags apply only to rÉ…rÊ}rË(h=X0The options of all of these flags apply only to hDNhRNhShh>jÅubj))rÌ}rÍ(h=X*local*hH}rÎ(hJ]hK]hL]hM]hP]uh>jÅhT]rÏh]XlocalrÐ…rÑ}rÒ(h=Xlocalh>jÌubahFj1ubh]X@ packages in a project; this behavior is different than that of rÓ…rÔ}rÕ(h=X@ packages in a project; this behavior is different than that of hDNhRNhShh>jÅubh–)rÖ}r×(h=X``cabal install``hH}rØ(hJ]hK]hL]hM]hP]uh>jÅhT]rÙh]X cabal installrÚ…rÛ}rÜ(h=X cabal installh>jÖubahFhžubh]XL, which applies flags to every package that would be built. The motivation for this is to avoid an innocuous addition to the flags of a package resulting in a rebuild of every package in the store (which might need to happen if a flag actually applied to every transitive dependency). To apply options to an external package, use a rÝ…rÞ}rß(h=XL, which applies flags to every package that would be built. The motivation for this is to avoid an innocuous addition to the flags of a package resulting in a rebuild of every package in the store (which might need to happen if a flag actually applied to every transitive dependency). To apply options to an external package, use a hDNhRNhShh>jÅubh–)rà}rá(h=X ``package``hH}râ(hJ]hK]hL]hM]hP]uh>jÅhT]rãh]Xpackagerä…rå}ræ(h=Xpackageh>jàubahFhžubh]X stanza in a rç…rè}ré(h=X stanza in a hDNhRNhShh>jÅubh–)rê}rë(h=X``cabal.project``hH}rì(hJ]hK]hL]hM]hP]uh>jÅhT]ríh]X cabal.projectrî…rï}rð(h=X cabal.projecth>jêubahFhžubh]X file.rñ…rò}ró(h=X file.hDNhRNhShh>jÅubeubeubh?)rô}rõ(h=Uh>johDhEhFhGhH}rö(hJ]hK]hL]hM]r÷Ucabal-v2-updaterøahP]rùhauhRM>hShhT]rú(hV)rû}rü(h=Xcabal v2-updaterýh>jôhDhEhFhZhH}rþ(hJ]hK]hL]hM]hP]uhRM>hShhT]rÿh]Xcabal v2-updater…r}r(h=jýhDNhRNhShh>jûubaubhp)r}r(h=X¼``cabal v2-update`` updates the state of the package index. If the project contains multiple remote package repositories it will update the index of all of them (e.g. when using overlays).h>jôhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM@hShhT]r(h–)r}r(h=X``cabal v2-update``hH}r (hJ]hK]hL]hM]hP]uh>jhT]r h]Xcabal v2-updater …r }r (h=Xcabal v2-updateh>jubahFhžubh]X© updates the state of the package index. If the project contains multiple remote package repositories it will update the index of all of them (e.g. when using overlays).r…r}r(h=X© updates the state of the package index. If the project contains multiple remote package repositories it will update the index of all of them (e.g. when using overlays).hDNhRNhShh>jubeubhp)r}r(h=XSome examples:rh>jôhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMDhShhT]rh]XSome examples:r…r}r(h=jhDNhRNhShh>jubaubcdocutils.nodes literal_block r)r}r(h=Xz$ cabal v2-update # update all remote repos $ cabal v2-update head.hackage # update only head.hackageh>jôhDhEhFU literal_blockrhH}r(U xml:spacerUpreserverhM]hL]hJ]hK]hP]uhRMHhShhT]r h]Xz$ cabal v2-update # update all remote repos $ cabal v2-update head.hackage # update only head.hackager!…r"}r#(h=Uh>jubaubeubjmh?)r$}r%(h=Uh>johDhEhFhGhH}r&(hJ]hK]hL]hM]r'U cabal-v2-replr(ahP]r)hauhRM‡hShhT]r*(hV)r+}r,(h=X cabal v2-replr-h>j$hDhEhFhZhH}r.(hJ]hK]hL]hM]hP]uhRM‡hShhT]r/h]X cabal v2-replr0…r1}r2(h=j-hDNhRNhShh>j+ubaubhp)r3}r4(h=X½``cabal v2-repl TARGET`` loads all of the modules of the target into GHCi as interpreted bytecode. In addition to ``cabal v2-build``'s flags, it takes an additional ``--repl-options`` flag.h>j$hDhEhFhthH}r5(hJ]hK]hL]hM]hP]uhRM‰hShhT]r6(h–)r7}r8(h=X``cabal v2-repl TARGET``hH}r9(hJ]hK]hL]hM]hP]uh>j3hT]r:h]Xcabal v2-repl TARGETr;…r<}r=(h=Xcabal v2-repl TARGETh>j7ubahFhžubh]XZ loads all of the modules of the target into GHCi as interpreted bytecode. In addition to r>…r?}r@(h=XZ loads all of the modules of the target into GHCi as interpreted bytecode. In addition to hDNhRNhShh>j3ubh–)rA}rB(h=X``cabal v2-build``hH}rC(hJ]hK]hL]hM]hP]uh>j3hT]rDh]Xcabal v2-buildrE…rF}rG(h=Xcabal v2-buildh>jAubahFhžubh]X#’s flags, it takes an additional rH…rI}rJ(h=X!'s flags, it takes an additional hDNhRNhShh>j3ubh–)rK}rL(h=X``--repl-options``hH}rM(hJ]hK]hL]hM]hP]uh>j3hT]rNh]X--repl-optionsrO…rP}rQ(h=X--repl-optionsh>jKubahFhžubh]X flag.rR…rS}rT(h=X flag.hDNhRNhShh>j3ubeubhp)rU}rV(h=X¹To avoid ``ghci`` specific flags from triggering unneeded global rebuilds these flags are now stripped from the internal configuration. As a result ``--ghc-options`` will no longer (reliably) work to pass flags to ``ghci`` (or other repls). Instead, you should use the new ``--repl-options`` flag to specify these options to the invoked repl. (This flag also works on ``cabal repl`` and ``Setup repl`` on sufficiently new versions of Cabal.)h>j$hDhEhFhthH}rW(hJ]hK]hL]hM]hP]uhRMhShhT]rX(h]X To avoid rY…rZ}r[(h=X To avoid hDNhRNhShh>jUubh–)r\}r](h=X``ghci``hH}r^(hJ]hK]hL]hM]hP]uh>jUhT]r_h]Xghcir`…ra}rb(h=Xghcih>j\ubahFhžubh]Xƒ specific flags from triggering unneeded global rebuilds these flags are now stripped from the internal configuration. As a result rc…rd}re(h=Xƒ specific flags from triggering unneeded global rebuilds these flags are now stripped from the internal configuration. As a result hDNhRNhShh>jUubh–)rf}rg(h=X``--ghc-options``hH}rh(hJ]hK]hL]hM]hP]uh>jUhT]rih]X --ghc-optionsrj…rk}rl(h=X --ghc-optionsh>jfubahFhžubh]X1 will no longer (reliably) work to pass flags to rm…rn}ro(h=X1 will no longer (reliably) work to pass flags to hDNhRNhShh>jUubh–)rp}rq(h=X``ghci``hH}rr(hJ]hK]hL]hM]hP]uh>jUhT]rsh]Xghcirt…ru}rv(h=Xghcih>jpubahFhžubh]X3 (or other repls). Instead, you should use the new rw…rx}ry(h=X3 (or other repls). Instead, you should use the new hDNhRNhShh>jUubh–)rz}r{(h=X``--repl-options``hH}r|(hJ]hK]hL]hM]hP]uh>jUhT]r}h]X--repl-optionsr~…r}r€(h=X--repl-optionsh>jzubahFhžubh]XM flag to specify these options to the invoked repl. (This flag also works on r…r‚}rƒ(h=XM flag to specify these options to the invoked repl. (This flag also works on hDNhRNhShh>jUubh–)r„}r…(h=X``cabal repl``hH}r†(hJ]hK]hL]hM]hP]uh>jUhT]r‡h]X cabal replrˆ…r‰}rŠ(h=X cabal replh>j„ubahFhžubh]X and r‹…rŒ}r(h=X and hDNhRNhShh>jUubh–)rŽ}r(h=X``Setup repl``hH}r(hJ]hK]hL]hM]hP]uh>jUhT]r‘h]X Setup replr’…r“}r”(h=X Setup replh>jŽubahFhžubh]X( on sufficiently new versions of Cabal.)r•…r–}r—(h=X( on sufficiently new versions of Cabal.)hDNhRNhShh>jUubeubhp)r˜}r™(h=X™Currently, it is not supported to pass multiple targets to ``v2-repl`` (``v2-repl`` will just successively open a separate GHCi session for each target.)h>j$hDhEhFhthH}rš(hJ]hK]hL]hM]hP]uhRM”hShhT]r›(h]X;Currently, it is not supported to pass multiple targets to rœ…r}rž(h=X;Currently, it is not supported to pass multiple targets to hDNhRNhShh>j˜ubh–)rŸ}r (h=X ``v2-repl``hH}r¡(hJ]hK]hL]hM]hP]uh>j˜hT]r¢h]Xv2-replr£…r¤}r¥(h=Xv2-replh>jŸubahFhžubh]X (r¦…r§}r¨(h=X (hDNhRNhShh>j˜ubh–)r©}rª(h=X ``v2-repl``hH}r«(hJ]hK]hL]hM]hP]uh>j˜hT]r¬h]Xv2-replr­…r®}r¯(h=Xv2-replh>j©ubahFhžubh]XF will just successively open a separate GHCi session for each target.)r°…r±}r²(h=XF will just successively open a separate GHCi session for each target.)hDNhRNhShh>j˜ubeubhp)r³}r´(h=XzIt also provides a way to experiment with libraries without needing to download them manually or to install them globally.rµh>j$hDhEhFhthH}r¶(hJ]hK]hL]hM]hP]uhRM˜hShhT]r·h]XzIt also provides a way to experiment with libraries without needing to download them manually or to install them globally.r¸…r¹}rº(h=jµhDNhRNhShh>j³ubaubhp)r»}r¼(h=XŽThis command opens a REPL with the current default target loaded, and a version of the ``vector`` package matching that specification exposed.h>j$hDhEhFhthH}r½(hJ]hK]hL]hM]hP]uhRM›hShhT]r¾(h]XWThis command opens a REPL with the current default target loaded, and a version of the r¿…rÀ}rÁ(h=XWThis command opens a REPL with the current default target loaded, and a version of the hDNhRNhShh>j»ubh–)rÂ}rÃ(h=X ``vector``hH}rÄ(hJ]hK]hL]hM]hP]uh>j»hT]rÅh]XvectorrÆ…rÇ}rÈ(h=Xvectorh>jÂubahFhžubh]X- package matching that specification exposed.rÉ…rÊ}rË(h=X- package matching that specification exposed.hDNhRNhShh>j»ubeubj)rÌ}rÍ(h=X:$ cabal v2-repl --build-depends "vector >= 0.12 && < 0.13"h>j$hDhEhFjhH}rÎ(jjhM]hL]hJ]hK]hP]uhRM hShhT]rÏh]X:$ cabal v2-repl --build-depends "vector >= 0.12 && < 0.13"rÐ…rÑ}rÒ(h=Uh>jÌubaubhp)rÓ}rÔ(h=X¼Both of these commands do the same thing as the above, but only exposes ``base``, ``vector``, and the ``vector`` package's transitive dependencies even if the user is in a project context.h>j$hDhEhFhthH}rÕ(hJ]hK]hL]hM]hP]uhRM¢hShhT]rÖ(h]XHBoth of these commands do the same thing as the above, but only exposes r×…rØ}rÙ(h=XHBoth of these commands do the same thing as the above, but only exposes hDNhRNhShh>jÓubh–)rÚ}rÛ(h=X``base``hH}rÜ(hJ]hK]hL]hM]hP]uh>jÓhT]rÝh]XbaserÞ…rß}rà(h=Xbaseh>jÚubahFhžubh]X, rá…râ}rã(h=X, hDNhRNhShh>jÓubh–)rä}rå(h=X ``vector``hH}ræ(hJ]hK]hL]hM]hP]uh>jÓhT]rçh]Xvectorrè…ré}rê(h=Xvectorh>jäubahFhžubh]X , and the rë…rì}rí(h=X , and the hDNhRNhShh>jÓubh–)rî}rï(h=X ``vector``hH}rð(hJ]hK]hL]hM]hP]uh>jÓhT]rñh]Xvectorrò…ró}rô(h=Xvectorh>jîubahFhžubh]XN package’s transitive dependencies even if the user is in a project context.rõ…rö}r÷(h=XL package's transitive dependencies even if the user is in a project context.hDNhRNhShh>jÓubeubj)rø}rù(h=X“$ cabal v2-repl --ignore-project --build-depends "vector >= 0.12 && < 0.13" $ cabal v2-repl --project='' --build-depends "vector >= 0.12 && < 0.13"h>j$hDhEhFjhH}rú(jjhM]hL]hJ]hK]hP]uhRM¨hShhT]rûh]X“$ cabal v2-repl --ignore-project --build-depends "vector >= 0.12 && < 0.13" $ cabal v2-repl --project='' --build-depends "vector >= 0.12 && < 0.13"rü…rý}rþ(h=Uh>jøubaubhp)rÿ}r(h=XËThis command would add ``vector``, but not (for example) ``primitive``, because it only includes the packages specified on the command line (and ``base``, which cannot be excluded for technical reasons).h>j$hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM«hShhT]r(h]XThis command would add r…r}r(h=XThis command would add hDNhRNhShh>jÿubh–)r}r(h=X ``vector``hH}r(hJ]hK]hL]hM]hP]uh>jÿhT]r h]Xvectorr …r }r (h=Xvectorh>jubahFhžubh]X, but not (for example) r …r}r(h=X, but not (for example) hDNhRNhShh>jÿubh–)r}r(h=X ``primitive``hH}r(hJ]hK]hL]hM]hP]uh>jÿhT]rh]X primitiver…r}r(h=X primitiveh>jubahFhžubh]XK, because it only includes the packages specified on the command line (and r…r}r(h=XK, because it only includes the packages specified on the command line (and hDNhRNhShh>jÿubh–)r}r(h=X``base``hH}r(hJ]hK]hL]hM]hP]uh>jÿhT]rh]Xbaser…r}r (h=Xbaseh>jubahFhžubh]X2, which cannot be excluded for technical reasons).r!…r"}r#(h=X2, which cannot be excluded for technical reasons).hDNhRNhShh>jÿubeubj)r$}r%(h=X;$ cabal v2-repl --build-depends vector --no-transitive-depsh>j$hDhEhFjhH}r&(jjhM]hL]hJ]hK]hP]uhRM±hShhT]r'h]X;$ cabal v2-repl --build-depends vector --no-transitive-depsr(…r)}r*(h=Uh>j$ubaubeubh?)r+}r,(h=Uh>johDhEhFhGhH}r-(hJ]hK]hL]hM]r.U cabal-v2-runr/ahP]r0hauhRM´hShhT]r1(hV)r2}r3(h=X cabal v2-runr4h>j+hDhEhFhZhH}r5(hJ]hK]hL]hM]hP]uhRM´hShhT]r6h]X cabal v2-runr7…r8}r9(h=j4hDNhRNhShh>j2ubaubhp)r:}r;(h=X``cabal v2-run [TARGET [ARGS]]`` runs the executable specified by the target, which can be a component, a package or can be left blank, as long as it can uniquely identify an executable within the project. Tests and benchmarks are also treated as executables.h>j+hDhEhFhthH}r<(hJ]hK]hL]hM]hP]uhRM¶hShhT]r=(h–)r>}r?(h=X ``cabal v2-run [TARGET [ARGS]]``hH}r@(hJ]hK]hL]hM]hP]uh>j:hT]rAh]Xcabal v2-run [TARGET [ARGS]]rB…rC}rD(h=Xcabal v2-run [TARGET [ARGS]]h>j>ubahFhžubh]Xã runs the executable specified by the target, which can be a component, a package or can be left blank, as long as it can uniquely identify an executable within the project. Tests and benchmarks are also treated as executables.rE…rF}rG(h=Xã runs the executable specified by the target, which can be a component, a package or can be left blank, as long as it can uniquely identify an executable within the project. Tests and benchmarks are also treated as executables.hDNhRNhShh>j:ubeubhp)rH}rI(h=XFSee `the v2-build section <#cabal-new-build>`__ for the target syntax.rJh>j+hDhEhFhthH}rK(hJ]hK]hL]hM]hP]uhRM»hShhT]rL(h]XSee rM…rN}rO(h=XSee hDNhRNhShh>jHubjæ)rP}rQ(h=X+`the v2-build section <#cabal-new-build>`__hH}rR(UnameXthe v2-build sectionjêX#cabal-new-buildhM]hL]hJ]hK]hP]uh>jHhT]rSh]Xthe v2-build sectionrT…rU}rV(h=Xthe v2-build sectionh>jPubahFjïubh]X for the target syntax.rW…rX}rY(h=X for the target syntax.hDNhRNhShh>jHubeubhp)rZ}r[(h=XkExcept in the case of the empty target, the strings after it will be passed to the executable as arguments.r\h>j+hDhEhFhthH}r](hJ]hK]hL]hM]hP]uhRM½hShhT]r^h]XkExcept in the case of the empty target, the strings after it will be passed to the executable as arguments.r_…r`}ra(h=j\hDNhRNhShh>jZubaubhp)rb}rc(h=X§If one of the arguments starts with ``-`` it will be interpreted as a cabal flag, so if you need to pass flags to the executable you have to separate them with ``--``.h>j+hDhEhFhthH}rd(hJ]hK]hL]hM]hP]uhRMÀhShhT]re(h]X$If one of the arguments starts with rf…rg}rh(h=X$If one of the arguments starts with hDNhRNhShh>jbubh–)ri}rj(h=X``-``hH}rk(hJ]hK]hL]hM]hP]uh>jbhT]rlh]X-…rm}rn(h=X-h>jiubahFhžubh]Xw it will be interpreted as a cabal flag, so if you need to pass flags to the executable you have to separate them with ro…rp}rq(h=Xw it will be interpreted as a cabal flag, so if you need to pass flags to the executable you have to separate them with hDNhRNhShh>jbubh–)rr}rs(h=X``--``hH}rt(hJ]hK]hL]hM]hP]uh>jbhT]ruh]X--rv…rw}rx(h=X--h>jrubahFhžubh]X.…ry}rz(h=X.hDNhRNhShh>jbubeubj)r{}r|(h=X+$ cabal v2-run target -- -a -bcd --argumenth>j+hDhEhFjhH}r}(jjhM]hL]hJ]hK]hP]uhRMÆhShhT]r~h]X+$ cabal v2-run target -- -a -bcd --argumentr…r€}r(h=Uh>j{ubaubhp)r‚}rƒ(h=Xe'v2-run' also supports running script files that use a certain format. With a script that looks like:r„h>j+hDhEhFhthH}r…(hJ]hK]hL]hM]hP]uhRMÈhShhT]r†h]Xi‘v2-run’ also supports running script files that use a certain format. With a script that looks like:r‡…rˆ}r‰(h=j„hDNhRNhShh>j‚ubaubj)rŠ}r‹(h=X~#!/usr/bin/env cabal {- cabal: build-depends: base ^>= 4.11 , shelly ^>= 1.8.1 -} main :: IO () main = do ...h>j+hDhEhFjhH}rŒ(jjhM]hL]hJ]hK]hP]uhRMÍhShhT]rh]X~#!/usr/bin/env cabal {- cabal: build-depends: base ^>= 4.11 , shelly ^>= 1.8.1 -} main :: IO () main = do ...rŽ…r}r(h=Uh>jŠubaubhp)r‘}r’(h=XlIt can either be executed like any other script, using ``cabal`` as an interpreter, or through this command:h>j+hDhEhFhthH}r“(hJ]hK]hL]hM]hP]uhRM×hShhT]r”(h]X7It can either be executed like any other script, using r•…r–}r—(h=X7It can either be executed like any other script, using hDNhRNhShh>j‘ubh–)r˜}r™(h=X ``cabal``hH}rš(hJ]hK]hL]hM]hP]uh>j‘hT]r›h]Xcabalrœ…r}rž(h=Xcabalh>j˜ubahFhžubh]X, as an interpreter, or through this command:rŸ…r }r¡(h=X, as an interpreter, or through this command:hDNhRNhShh>j‘ubeubj)r¢}r£(h=XW$ cabal v2-run script.hs $ cabal v2-run script.hs -- --arg1 # args are passed like thish>j+hDhEhFjhH}r¤(jjhM]hL]hJ]hK]hP]uhRMÜhShhT]r¥h]XW$ cabal v2-run script.hs $ cabal v2-run script.hs -- --arg1 # args are passed like thisr¦…r§}r¨(h=Uh>j¢ubaubeubh?)r©}rª(h=Uh>johDhEhFhGhH}r«(hJ]hK]hL]hM]r¬Ucabal-v2-freezer­ahP]r®h.auhRMàhShhT]r¯(hV)r°}r±(h=Xcabal v2-freezer²h>j©hDhEhFhZhH}r³(hJ]hK]hL]hM]hP]uhRMàhShhT]r´h]Xcabal v2-freezerµ…r¶}r·(h=j²hDNhRNhShh>j°ubaubhp)r¸}r¹(h=XÈ``cabal v2-freeze`` writes out a **freeze file** which records all of the versions and flags which that are picked by the solver under the current index and flags. Default name of this file is ``cabal.project.freeze`` but in combination with a ``--project-file=my.project`` flag (see :ref:`project-file `) the name will be ``my.project.freeze``. A freeze file has the same syntax as ``cabal.project`` and looks something like this:h>j©hDhEhFhthH}rº(hJ]hK]hL]hM]hP]uhRMâhShhT]r»(h–)r¼}r½(h=X``cabal v2-freeze``hH}r¾(hJ]hK]hL]hM]hP]uh>j¸hT]r¿h]Xcabal v2-freezerÀ…rÁ}rÂ(h=Xcabal v2-freezeh>j¼ubahFhžubh]X writes out a rÃ…rÄ}rÅ(h=X writes out a hDNhRNhShh>j¸ubjw)rÆ}rÇ(h=X**freeze file**hH}rÈ(hJ]hK]hL]hM]hP]uh>j¸hT]rÉh]X freeze filerÊ…rË}rÌ(h=X freeze fileh>jÆubahFjubh]X’ which records all of the versions and flags which that are picked by the solver under the current index and flags. Default name of this file is rÍ…rÎ}rÏ(h=X’ which records all of the versions and flags which that are picked by the solver under the current index and flags. Default name of this file is hDNhRNhShh>j¸ubh–)rÐ}rÑ(h=X``cabal.project.freeze``hH}rÒ(hJ]hK]hL]hM]hP]uh>j¸hT]rÓh]Xcabal.project.freezerÔ…rÕ}rÖ(h=Xcabal.project.freezeh>jÐubahFhžubh]X but in combination with a r×…rØ}rÙ(h=X but in combination with a hDNhRNhShh>j¸ubh–)rÚ}rÛ(h=X``--project-file=my.project``hH}rÜ(hJ]hK]hL]hM]hP]uh>j¸hT]rÝh]X--project-file=my.projectrÞ…rß}rà(h=X--project-file=my.projecth>jÚubahFhžubh]X flag (see rá…râ}rã(h=X flag (see hDNhRNhShh>j¸ubcsphinx.addnodes pending_xref rä)rå}ræ(h=X,:ref:`project-file `h>j¸hDhEhFU pending_xrefrçhH}rè(UreftypeXrefUrefwarnréˆU reftargetrêXcmdoption-project-fileU refdomainXstdrëhM]hL]U refexplicitˆhJ]hK]hP]UrefdocrìXnix-local-buildríuhRMâhT]rîcdocutils.nodes inline rï)rð}rñ(h=X%project-file hH}rò(hJ]hK]ró(UxrefrôjëXstd-refrõehL]hM]hP]uh>jåhT]röh]X project-filer÷…rø}rù(h=Uh>jðubahFUinlinerúubaubh]X) the name will be rû…rü}rý(h=X) the name will be hDNhRNhShh>j¸ubh–)rþ}rÿ(h=X``my.project.freeze``hH}r(hJ]hK]hL]hM]hP]uh>j¸hT]rh]Xmy.project.freezer…r}r(h=Xmy.project.freezeh>jþubahFhžubh]X'. A freeze file has the same syntax as r…r}r(h=X'. A freeze file has the same syntax as hDNhRNhShh>j¸ubh–)r}r (h=X``cabal.project``hH}r (hJ]hK]hL]hM]hP]uh>j¸hT]r h]X cabal.projectr …r }r(h=X cabal.projecth>jubahFhžubh]X and looks something like this:r…r}r(h=X and looks something like this:hDNhRNhShh>j¸ubeubcsphinx.addnodes highlightlang r)r}r(h=Uh>j©hDhEhFU highlightlangrhH}r(UlangXcabalUlinenothresholdI9223372036854775807 hM]hL]hJ]hK]hP]uhRMíhShhT]ubj)r}r(h=XÖconstraints: HTTP ==4000.3.3, HTTP +warp-tests -warn-as-error -network23 +network-uri -mtl1 -conduit10, QuickCheck ==2.9.1, QuickCheck +templatehaskell, -- etc...h>j©hDhEhFjhH}r(jjhM]hL]hJ]hK]hP]uhRMðhShhT]rh]XÖconstraints: HTTP ==4000.3.3, HTTP +warp-tests -warn-as-error -network23 +network-uri -mtl1 -conduit10, QuickCheck ==2.9.1, QuickCheck +templatehaskell, -- etc...r…r}r(h=Uh>jubaubhp)r}r(h=X>For end-user executables, it is recommended that you distribute the ``cabal.project.freeze`` file in your source repository so that all users see a consistent set of dependencies. For libraries, this is not recommended: users often need to build against different versions of libraries than what you developed against.h>j©hDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRM÷hShhT]r!(h]XDFor end-user executables, it is recommended that you distribute the r"…r#}r$(h=XDFor end-user executables, it is recommended that you distribute the hDNhRNhShh>jubh–)r%}r&(h=X``cabal.project.freeze``hH}r'(hJ]hK]hL]hM]hP]uh>jhT]r(h]Xcabal.project.freezer)…r*}r+(h=Xcabal.project.freezeh>j%ubahFhžubh]Xâ file in your source repository so that all users see a consistent set of dependencies. For libraries, this is not recommended: users often need to build against different versions of libraries than what you developed against.r,…r-}r.(h=Xâ file in your source repository so that all users see a consistent set of dependencies. For libraries, this is not recommended: users often need to build against different versions of libraries than what you developed against.hDNhRNhShh>jubeubeubh?)r/}r0(h=Uh>johDhEhFhGhH}r1(hJ]hK]hL]hM]r2Ucabal-v2-benchr3ahP]r4hauhRMþhShhT]r5(hV)r6}r7(h=Xcabal v2-benchr8h>j/hDhEhFhZhH}r9(hJ]hK]hL]hM]hP]uhRMþhShhT]r:h]Xcabal v2-benchr;…r<}r=(h=j8hDNhRNhShh>j6ubaubhp)r>}r?(h=X ``cabal v2-bench [TARGETS] [OPTIONS]`` runs the specified benchmarks (all the benchmarks in the current package by default), first ensuring they are up to date.h>j/hDhEhFhthH}r@(hJ]hK]hL]hM]hP]uhRMhShhT]rA(h–)rB}rC(h=X&``cabal v2-bench [TARGETS] [OPTIONS]``hH}rD(hJ]hK]hL]hM]hP]uh>j>hT]rEh]X"cabal v2-bench [TARGETS] [OPTIONS]rF…rG}rH(h=X"cabal v2-bench [TARGETS] [OPTIONS]h>jBubahFhžubh]Xz runs the specified benchmarks (all the benchmarks in the current package by default), first ensuring they are up to date.rI…rJ}rK(h=Xz runs the specified benchmarks (all the benchmarks in the current package by default), first ensuring they are up to date.hDNhRNhShh>j>ubeubeubh?)rL}rM(h=Uh>johDhEhFhGhH}rN(hJ]hK]hL]hM]rOU cabal-v2-testrPahP]rQh auhRMhShhT]rR(hV)rS}rT(h=X cabal v2-testrUh>jLhDhEhFhZhH}rV(hJ]hK]hL]hM]hP]uhRMhShhT]rWh]X cabal v2-testrX…rY}rZ(h=jUhDNhRNhShh>jSubaubhp)r[}r\(h=X¡``cabal v2-test [TARGETS] [OPTIONS]`` runs the specified test suites (all the test suites in the current package by default), first ensuring they are up to date.h>jLhDhEhFhthH}r](hJ]hK]hL]hM]hP]uhRMhShhT]r^(h–)r_}r`(h=X%``cabal v2-test [TARGETS] [OPTIONS]``hH}ra(hJ]hK]hL]hM]hP]uh>j[hT]rbh]X!cabal v2-test [TARGETS] [OPTIONS]rc…rd}re(h=X!cabal v2-test [TARGETS] [OPTIONS]h>j_ubahFhžubh]X| runs the specified test suites (all the test suites in the current package by default), first ensuring they are up to date.rf…rg}rh(h=X| runs the specified test suites (all the test suites in the current package by default), first ensuring they are up to date.hDNhRNhShh>j[ubeubeubh?)ri}rj(h=Uh>johDhEhFhGhH}rk(hJ]hK]hL]hM]rlUcabal-v2-haddockrmahP]rnh#auhRM hShhT]ro(hV)rp}rq(h=Xcabal v2-haddockrrh>jihDhEhFhZhH}rs(hJ]hK]hL]hM]hP]uhRM hShhT]rth]Xcabal v2-haddockru…rv}rw(h=jrhDNhRNhShh>jpubaubhp)rx}ry(h=Xq``cabal v2-haddock [FLAGS] [TARGET]`` builds Haddock documentation for the specified packages within the project.h>jihDhEhFhthH}rz(hJ]hK]hL]hM]hP]uhRMhShhT]r{(h–)r|}r}(h=X%``cabal v2-haddock [FLAGS] [TARGET]``hH}r~(hJ]hK]hL]hM]hP]uh>jxhT]rh]X!cabal v2-haddock [FLAGS] [TARGET]r€…r}r‚(h=X!cabal v2-haddock [FLAGS] [TARGET]h>j|ubahFhžubh]XL builds Haddock documentation for the specified packages within the project.rƒ…r„}r…(h=XL builds Haddock documentation for the specified packages within the project.hDNhRNhShh>jxubeubhp)r†}r‡(h=X·If a target is not a library :cfg-field:`haddock-benchmarks`, :cfg-field:`haddock-executables`, :cfg-field:`haddock-internal`, :cfg-field:`haddock-tests` will be implied as necessary.h>jihDhEhFhthH}rˆ(hJ]hK]hL]hM]hP]uhRMhShhT]r‰(h]XIf a target is not a library rŠ…r‹}rŒ(h=XIf a target is not a library hDNhRNhShh>j†ubjä)r}rŽ(h=X:cfg-field:`haddock-benchmarks`h>j†hDhEhFjçhH}r(UreftypeX cfg-fieldjéˆjêXhaddock-benchmarksrU refdomainXcabalr‘hM]hL]U refexplicit‰hJ]hK]hP]jìjíUcabal:cfg-sectionr’NuhRMhT]r“h–)r”}r•(h=jhH}r–(hJ]hK]r—(jôj‘Xcabal-cfg-fieldr˜ehL]hM]hP]uh>jhT]r™h]Xhaddock-benchmarksrš…r›}rœ(h=Uh>j”ubahFhžubaubh]X, r…rž}rŸ(h=X, r hDNhRNhShh>j†ubjä)r¡}r¢(h=X :cfg-field:`haddock-executables`h>j†hDhEhFjçhH}r£(UreftypeX cfg-fieldjéˆjêXhaddock-executablesr¤U refdomainXcabalr¥hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMhT]r¦h–)r§}r¨(h=j¤hH}r©(hJ]hK]rª(jôj¥Xcabal-cfg-fieldr«ehL]hM]hP]uh>j¡hT]r¬h]Xhaddock-executablesr­…r®}r¯(h=Uh>j§ubahFhžubaubh]X, r°…r±}r²(h=X, hDNhRNhShh>j†ubjä)r³}r´(h=X:cfg-field:`haddock-internal`h>j†hDhEhFjçhH}rµ(UreftypeX cfg-fieldjéˆjêXhaddock-internalr¶U refdomainXcabalr·hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMhT]r¸h–)r¹}rº(h=j¶hH}r»(hJ]hK]r¼(jôj·Xcabal-cfg-fieldr½ehL]hM]hP]uh>j³hT]r¾h]Xhaddock-internalr¿…rÀ}rÁ(h=Uh>j¹ubahFhžubaubh]X, rÂ…rÃ}rÄ(h=j h>j†ubjä)rÅ}rÆ(h=X:cfg-field:`haddock-tests`h>j†hDhEhFjçhH}rÇ(UreftypeX cfg-fieldjéˆjêX haddock-testsrÈU refdomainXcabalrÉhM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMhT]rÊh–)rË}rÌ(h=jÈhH}rÍ(hJ]hK]rÎ(jôjÉXcabal-cfg-fieldrÏehL]hM]hP]uh>jÅhT]rÐh]X haddock-testsrÑ…rÒ}rÓ(h=Uh>jËubahFhžubaubh]X will be implied as necessary.rÔ…rÕ}rÖ(h=X will be implied as necessary.hDNhRNhShh>j†ubeubeubh?)r×}rØ(h=Uh>johDhEhFhGhH}rÙ(hJ]hK]hL]hM]rÚU cabal-v2-execrÛahP]rÜhauhRMhShhT]rÝ(hV)rÞ}rß(h=X cabal v2-execràh>j×hDhEhFhZhH}rá(hJ]hK]hL]hM]hP]uhRMhShhT]râh]X cabal v2-execrã…rä}rå(h=jàhDNhRNhShh>jÞubaubhp)ræ}rç(h=XÚ``cabal v2-exec [FLAGS] [--] COMMAND [--] [ARGS]`` runs the specified command using the project's environment. That is, passing the right flags to compiler invocations and bringing the project's executables into scope.h>j×hDhEhFhthH}rè(hJ]hK]hL]hM]hP]uhRMhShhT]ré(h–)rê}rë(h=X2``cabal v2-exec [FLAGS] [--] COMMAND [--] [ARGS]``hH}rì(hJ]hK]hL]hM]hP]uh>jæhT]ríh]X.cabal v2-exec [FLAGS] [--] COMMAND [--] [ARGS]rî…rï}rð(h=X.cabal v2-exec [FLAGS] [--] COMMAND [--] [ARGS]h>jêubahFhžubh]X¬ runs the specified command using the project’s environment. That is, passing the right flags to compiler invocations and bringing the project’s executables into scope.rñ…rò}ró(h=X¨ runs the specified command using the project's environment. That is, passing the right flags to compiler invocations and bringing the project's executables into scope.hDNhRNhShh>jæubeubeubh?)rô}rõ(h=Uh>johDhEhFhGhH}rö(hJ]hK]hL]hM]r÷Ucabal-v2-installrøahP]rùh auhRMhShhT]rú(hV)rû}rü(h=Xcabal v2-installrýh>jôhDhEhFhZhH}rþ(hJ]hK]hL]hM]hP]uhRMhShhT]rÿh]Xcabal v2-installr …r }r (h=jýhDNhRNhShh>jûubaubhp)r }r (h=X—``cabal v2-install [FLAGS] PACKAGES`` builds the specified packages and symlinks/copies their executables in ``installdir`` (usually ``~/.cabal/bin``).h>jôhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRMhShhT]r (h–)r }r (h=X%``cabal v2-install [FLAGS] PACKAGES``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]X!cabal v2-install [FLAGS] PACKAGESr …r }r (h=X!cabal v2-install [FLAGS] PACKAGESh>j ubahFhžubh]XH builds the specified packages and symlinks/copies their executables in r …r }r (h=XH builds the specified packages and symlinks/copies their executables in hDNhRNhShh>j ubh–)r }r (h=X``installdir``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]X installdirr …r }r (h=X installdirh>j ubahFhžubh]X (usually r …r }r (h=X (usually hDNhRNhShh>j ubh–)r }r (h=X``~/.cabal/bin``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]X ~/.cabal/binr …r }r! (h=X ~/.cabal/binh>j ubahFhžubh]X).r" …r# }r$ (h=X).hDNhRNhShh>j ubeubhp)r% }r& (h=XfFor example this command will build the latest ``cabal-install`` and symlink its ``cabal`` executable:h>jôhDhEhFhthH}r' (hJ]hK]hL]hM]hP]uhRM"hShhT]r( (h]X/For example this command will build the latest r) …r* }r+ (h=X/For example this command will build the latest hDNhRNhShh>j% ubh–)r, }r- (h=X``cabal-install``hH}r. (hJ]hK]hL]hM]hP]uh>j% hT]r/ h]X cabal-installr0 …r1 }r2 (h=X cabal-installh>j, ubahFhžubh]X and symlink its r3 …r4 }r5 (h=X and symlink its hDNhRNhShh>j% ubh–)r6 }r7 (h=X ``cabal``hH}r8 (hJ]hK]hL]hM]hP]uh>j% hT]r9 h]Xcabalr: …r; }r< (h=Xcabalh>j6 ubahFhžubh]X executable:r= …r> }r? (h=X executable:hDNhRNhShh>j% ubeubj)r@ }rA (h=X $ cabal v2-install cabal-installh>jôhDhEhFjhH}rB (jjhM]hL]hJ]hK]hP]uhRM'hShhT]rC h]X $ cabal v2-install cabal-installrD …rE }rF (h=Uh>j@ ubaubhp)rG }rH (h=XôIn addition, it's possible to use ``cabal v2-install`` to install components of a local project. For example, with an up-to-date Git clone of the Cabal repository, this command will build cabal-install HEAD and symlink the ``cabal`` executable:h>jôhDhEhFhthH}rI (hJ]hK]hL]hM]hP]uhRM)hShhT]rJ (h]X$In addition, it’s possible to use rK …rL }rM (h=X"In addition, it's possible to use hDNhRNhShh>jG ubh–)rN }rO (h=X``cabal v2-install``hH}rP (hJ]hK]hL]hM]hP]uh>jG hT]rQ h]Xcabal v2-installrR …rS }rT (h=Xcabal v2-installh>jN ubahFhžubh]X© to install components of a local project. For example, with an up-to-date Git clone of the Cabal repository, this command will build cabal-install HEAD and symlink the rU …rV }rW (h=X© to install components of a local project. For example, with an up-to-date Git clone of the Cabal repository, this command will build cabal-install HEAD and symlink the hDNhRNhShh>jG ubh–)rX }rY (h=X ``cabal``hH}rZ (hJ]hK]hL]hM]hP]uh>jG hT]r[ h]Xcabalr\ …r] }r^ (h=Xcabalh>jX ubahFhžubh]X executable:r_ …r` }ra (h=X executable:hDNhRNhShh>jG ubeubj)rb }rc (h=X$ cabal v2-install exe:cabalh>jôhDhEhFjhH}rd (jjhM]hL]hJ]hK]hP]uhRM0hShhT]re h]X$ cabal v2-install exe:cabalrf …rg }rh (h=Uh>jb ubaubhp)ri }rj (h=XYWhere symlinking is not possible (eg. on Windows), ``--install-method=copy`` can be used:h>jôhDhEhFhthH}rk (hJ]hK]hL]hM]hP]uhRM2hShhT]rl (h]X3Where symlinking is not possible (eg. on Windows), rm …rn }ro (h=X3Where symlinking is not possible (eg. on Windows), hDNhRNhShh>ji ubh–)rp }rq (h=X``--install-method=copy``hH}rr (hJ]hK]hL]hM]hP]uh>ji hT]rs h]X--install-method=copyrt …ru }rv (h=X--install-method=copyh>jp ubahFhžubh]X can be used:rw …rx }ry (h=X can be used:hDNhRNhShh>ji ubeubj)rz }r{ (h=XE$ cabal v2-install exe:cabal --install-method=copy --installdir=~/binh>jôhDhEhFjhH}r| (jjhM]hL]hJ]hK]hP]uhRM7hShhT]r} h]XE$ cabal v2-install exe:cabal --install-method=copy --installdir=~/binr~ …r }r€ (h=Uh>jz ubaubhp)r }r‚ (h=XdNote that copied executables are not self-contained, since they might use data-files from the store.rƒ h>jôhDhEhFhthH}r„ (hJ]hK]hL]hM]hP]uhRM9hShhT]r… h]XdNote that copied executables are not self-contained, since they might use data-files from the store.r† …r‡ }rˆ (h=jƒ hDNhRNhShh>j ubaubhp)r‰ }rŠ (h=X’It is also possible to "install" libraries using the ``--lib`` flag. For example, this command will build the latest Cabal library and install it:h>jôhDhEhFhthH}r‹ (hJ]hK]hL]hM]hP]uhRM<hShhT]rŒ (h]X9It is also possible to “install†libraries using the r …rŽ }r (h=X5It is also possible to "install" libraries using the hDNhRNhShh>j‰ ubh–)r }r‘ (h=X ``--lib``hH}r’ (hJ]hK]hL]hM]hP]uh>j‰ hT]r“ h]X--libr” …r• }r– (h=X--libh>j ubahFhžubh]XT flag. For example, this command will build the latest Cabal library and install it:r— …r˜ }r™ (h=XT flag. For example, this command will build the latest Cabal library and install it:hDNhRNhShh>j‰ ubeubj)rš }r› (h=X$ cabal v2-install --lib Cabalh>jôhDhEhFjhH}rœ (jjhM]hL]hJ]hK]hP]uhRMAhShhT]r h]X$ cabal v2-install --lib Cabalrž …rŸ }r  (h=Uh>jš ubaubhp)r¡ }r¢ (h=XùThis works by managing GHC environments. By default, it is writing to the global environment in ``~/.ghc/$ARCH-$OS-$GHCVER/environments/default``. ``v2-install`` provides the ``--package-env`` flag to control which of these environments is modified.h>jôhDhEhFhthH}r£ (hJ]hK]hL]hM]hP]uhRMChShhT]r¤ (h]X`This works by managing GHC environments. By default, it is writing to the global environment in r¥ …r¦ }r§ (h=X`This works by managing GHC environments. By default, it is writing to the global environment in hDNhRNhShh>j¡ ubh–)r¨ }r© (h=X1``~/.ghc/$ARCH-$OS-$GHCVER/environments/default``hH}rª (hJ]hK]hL]hM]hP]uh>j¡ hT]r« h]X-~/.ghc/$ARCH-$OS-$GHCVER/environments/defaultr¬ …r­ }r® (h=X-~/.ghc/$ARCH-$OS-$GHCVER/environments/defaulth>j¨ ubahFhžubh]X. r¯ …r° }r± (h=X. hDNhRNhShh>j¡ ubh–)r² }r³ (h=X``v2-install``hH}r´ (hJ]hK]hL]hM]hP]uh>j¡ hT]rµ h]X v2-installr¶ …r· }r¸ (h=X v2-installh>j² ubahFhžubh]X provides the r¹ …rº }r» (h=X provides the hDNhRNhShh>j¡ ubh–)r¼ }r½ (h=X``--package-env``hH}r¾ (hJ]hK]hL]hM]hP]uh>j¡ hT]r¿ h]X --package-envrÀ …rÁ }r (h=X --package-envh>j¼ ubahFhžubh]X9 flag to control which of these environments is modified.rà …rÄ }rÅ (h=X9 flag to control which of these environments is modified.hDNhRNhShh>j¡ ubeubhp)rÆ }rÇ (h=XGThis command will modify the environment file in the current directory:rÈ h>jôhDhEhFhthH}rÉ (hJ]hK]hL]hM]hP]uhRMHhShhT]rÊ h]XGThis command will modify the environment file in the current directory:rË …rÌ }rÍ (h=jÈ hDNhRNhShh>jÆ ubaubj)rÎ }rÏ (h=X.$ cabal v2-install --lib Cabal --package-env .h>jôhDhEhFjhH}rÐ (jjhM]hL]hJ]hK]hP]uhRMLhShhT]rÑ h]X.$ cabal v2-install --lib Cabal --package-env .rÒ …rÓ }rÔ (h=Uh>jÎ ubaubhp)rÕ }rÖ (h=XIThis command will modify the environment file in the ``~/foo`` directory:r× h>jôhDhEhFhthH}rØ (hJ]hK]hL]hM]hP]uhRMNhShhT]rÙ (h]X5This command will modify the environment file in the rÚ …rÛ }rÜ (h=X5This command will modify the environment file in the hDNhRNhShh>jÕ ubh–)rÝ }rÞ (h=X ``~/foo``hH}rß (hJ]hK]hL]hM]hP]uh>jÕ hT]rà h]X~/foorá …râ }rã (h=X~/fooh>jÝ ubahFhžubh]X directory:rä …rå }ræ (h=X directory:hDNhRNhShh>jÕ ubeubj)rç }rè (h=X1$ cabal v2-install --lib Cabal --package-env foo/h>jôhDhEhFjhH}ré (jjhM]hL]hJ]hK]hP]uhRMRhShhT]rê h]X1$ cabal v2-install --lib Cabal --package-env foo/rë …rì }rí (h=Uh>jç ubaubhp)rî }rï (h=X±Do note that the results of the previous two commands will be overwritten by the use of other v2-style commands, so it is not recommended to use them inside a project directory.rð h>jôhDhEhFhthH}rñ (hJ]hK]hL]hM]hP]uhRMThShhT]rò h]X±Do note that the results of the previous two commands will be overwritten by the use of other v2-style commands, so it is not recommended to use them inside a project directory.ró …rô }rõ (h=jð hDNhRNhShh>jî ubaubhp)rö }r÷ (h=XZThis command will modify the environment in the "local.env" file in the current directory:rø h>jôhDhEhFhthH}rù (hJ]hK]hL]hM]hP]uhRMXhShhT]rú h]X^This command will modify the environment in the “local.env†file in the current directory:rû …rü }rý (h=jø hDNhRNhShh>jö ubaubj)rþ }rÿ (h=X6$ cabal v2-install --lib Cabal --package-env local.envh>jôhDhEhFjhH}r (jjhM]hL]hJ]hK]hP]uhRM]hShhT]r h]X6$ cabal v2-install --lib Cabal --package-env local.envr …r }r (h=Uh>jþ ubaubhp)r }r (h=X@This command will modify the ``myenv`` named global environment:r h>jôhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRM_hShhT]r (h]XThis command will modify the r …r }r (h=XThis command will modify the hDNhRNhShh>j ubh–)r }r (h=X ``myenv``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]Xmyenvr …r }r (h=Xmyenvh>j ubahFhžubh]X named global environment:r …r }r (h=X named global environment:hDNhRNhShh>j ubeubj)r }r (h=X2$ cabal v2-install --lib Cabal --package-env myenvh>jôhDhEhFjhH}r (jjhM]hL]hJ]hK]hP]uhRMchShhT]r h]X2$ cabal v2-install --lib Cabal --package-env myenvr …r }r (h=Uh>j ubaubhp)r }r (h=X›If you wish to create a named environment file in the current directory where the name does not contain an extension, you must reference it as ``./myenv``.h>jôhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRMehShhT]r! (h]XIf you wish to create a named environment file in the current directory where the name does not contain an extension, you must reference it as r" …r# }r$ (h=XIf you wish to create a named environment file in the current directory where the name does not contain an extension, you must reference it as hDNhRNhShh>j ubh–)r% }r& (h=X ``./myenv``hH}r' (hJ]hK]hL]hM]hP]uh>j hT]r( h]X./myenvr) …r* }r+ (h=X./myenvh>j% ubahFhžubh]X.…r, }r- (h=X.hDNhRNhShh>j ubeubhp)r. }r/ (h=XÁYou can learn more about how to use these environments in `this section of the GHC manual `_.h>jôhDhEhFhthH}r0 (hJ]hK]hL]hM]hP]uhRMhhShhT]r1 (h]X:You can learn more about how to use these environments in r2 …r3 }r4 (h=X:You can learn more about how to use these environments in hDNhRNhShh>j. ubjæ)r5 }r6 (h=X†`this section of the GHC manual `_hH}r7 (UnameXthis section of the GHC manualjêXbhttps://downloads.haskell.org/~ghc/latest/docs/html/users_guide/packages.html#package-environmentsr8 hM]hL]hJ]hK]hP]uh>j. hT]r9 h]Xthis section of the GHC manualr: …r; }r< (h=Xthis section of the GHC manualh>j5 ubahFjïubjý)r= }r> (h=Xe U referencedr? Kh>j. hFjhH}r@ (Urefurij8 hM]rA Uthis-section-of-the-ghc-manualrB ahL]hJ]hK]hP]rC h,auhT]ubh]X.…rD }rE (h=X.hDNhRNhShh>j. ubeubeubh?)rF }rG (h=Uh>johDhEhFhGhH}rH (hJ]hK]hL]hM]rI Ucabal-v2-cleanrJ ahP]rK h'auhRMlhShhT]rL (hV)rM }rN (h=Xcabal v2-cleanrO h>jF hDhEhFhZhH}rP (hJ]hK]hL]hM]hP]uhRMlhShhT]rQ h]Xcabal v2-cleanrR …rS }rT (h=jO hDNhRNhShh>jM ubaubhp)rU }rV (h=Xt``cabal v2-clean [FLAGS]`` cleans up the temporary files and build artifacts stored in the ``dist-newstyle`` folder.h>jF hDhEhFhthH}rW (hJ]hK]hL]hM]hP]uhRMnhShhT]rX (h–)rY }rZ (h=X``cabal v2-clean [FLAGS]``hH}r[ (hJ]hK]hL]hM]hP]uh>jU hT]r\ h]Xcabal v2-clean [FLAGS]r] …r^ }r_ (h=Xcabal v2-clean [FLAGS]h>jY ubahFhžubh]XA cleans up the temporary files and build artifacts stored in the r` …ra }rb (h=XA cleans up the temporary files and build artifacts stored in the hDNhRNhShh>jU ubh–)rc }rd (h=X``dist-newstyle``hH}re (hJ]hK]hL]hM]hP]uh>jU hT]rf h]X dist-newstylerg …rh }ri (h=X dist-newstyleh>jc ubahFhžubh]X folder.rj …rk }rl (h=X folder.hDNhRNhShh>jU ubeubhp)rm }rn (h=X'By default, it removes the entire folder, but it can also spare the configuration and caches if the ``--save-config`` option is given, in which case it only removes the build artefacts (``.hi``, ``.o`` along with any other temporary files generated by the compiler, along with the build output).h>jF hDhEhFhthH}ro (hJ]hK]hL]hM]hP]uhRMqhShhT]rp (h]XdBy default, it removes the entire folder, but it can also spare the configuration and caches if the rq …rr }rs (h=XdBy default, it removes the entire folder, but it can also spare the configuration and caches if the hDNhRNhShh>jm ubh–)rt }ru (h=X``--save-config``hH}rv (hJ]hK]hL]hM]hP]uh>jm hT]rw h]X --save-configrx …ry }rz (h=X --save-configh>jt ubahFhžubh]XE option is given, in which case it only removes the build artefacts (r{ …r| }r} (h=XE option is given, in which case it only removes the build artefacts (hDNhRNhShh>jm ubh–)r~ }r (h=X``.hi``hH}r€ (hJ]hK]hL]hM]hP]uh>jm hT]r h]X.hir‚ …rƒ }r„ (h=X.hih>j~ ubahFhžubh]X, r… …r† }r‡ (h=X, hDNhRNhShh>jm ubh–)rˆ }r‰ (h=X``.o``hH}rŠ (hJ]hK]hL]hM]hP]uh>jm hT]r‹ h]X.orŒ …r }rŽ (h=X.oh>jˆ ubahFhžubh]X^ along with any other temporary files generated by the compiler, along with the build output).r …r }r‘ (h=X^ along with any other temporary files generated by the compiler, along with the build output).hDNhRNhShh>jm ubeubeubh?)r’ }r“ (h=Uh>johDhEhFhGhH}r” (hJ]hK]hL]hM]r• Ucabal-v2-sdistr– ahP]r— h*auhRMwhShhT]r˜ (hV)r™ }rš (h=Xcabal v2-sdistr› h>j’ hDhEhFhZhH}rœ (hJ]hK]hL]hM]hP]uhRMwhShhT]r h]Xcabal v2-sdistrž …rŸ }r  (h=j› hDNhRNhShh>j™ ubaubhp)r¡ }r¢ (h=X``cabal v2-sdist [FLAGS] [TARGETS]`` takes the crucial files needed to build ``TARGETS`` and puts them into an archive format ready for upload to Hackage. These archives are stable and two archives of the same format built from the same source will hash to the same value.h>j’ hDhEhFhthH}r£ (hJ]hK]hL]hM]hP]uhRMyhShhT]r¤ (h–)r¥ }r¦ (h=X$``cabal v2-sdist [FLAGS] [TARGETS]``hH}r§ (hJ]hK]hL]hM]hP]uh>j¡ hT]r¨ h]X cabal v2-sdist [FLAGS] [TARGETS]r© …rª }r« (h=X cabal v2-sdist [FLAGS] [TARGETS]h>j¥ ubahFhžubh]X) takes the crucial files needed to build r¬ …r­ }r® (h=X) takes the crucial files needed to build hDNhRNhShh>j¡ ubh–)r¯ }r° (h=X ``TARGETS``hH}r± (hJ]hK]hL]hM]hP]uh>j¡ hT]r² h]XTARGETSr³ …r´ }rµ (h=XTARGETSh>j¯ ubahFhžubh]X¸ and puts them into an archive format ready for upload to Hackage. These archives are stable and two archives of the same format built from the same source will hash to the same value.r¶ …r· }r¸ (h=X¸ and puts them into an archive format ready for upload to Hackage. These archives are stable and two archives of the same format built from the same source will hash to the same value.hDNhRNhShh>j¡ ubeubhp)r¹ }rº (h=X-``cabal v2-sdist`` takes the following flags:r» h>j’ hDhEhFhthH}r¼ (hJ]hK]hL]hM]hP]uhRM}hShhT]r½ (h–)r¾ }r¿ (h=X``cabal v2-sdist``hH}rÀ (hJ]hK]hL]hM]hP]uh>j¹ hT]rÁ h]Xcabal v2-sdistr …rà }rÄ (h=Xcabal v2-sdisth>j¾ ubahFhžubh]X takes the following flags:rÅ …rÆ }rÇ (h=X takes the following flags:hDNhRNhShh>j¹ ubeubh‚)rÈ }rÉ (h=Uh>j’ hDhEhFh…hH}rÊ (h‡X-hM]hL]hJ]hK]hP]uhRMhShhT]rË (h‰)rÌ }rÍ (h=X¿``-l``, ``--list-only``: Rather than creating an archive, lists files that would be included. Output is to ``stdout`` by default. The file paths are relative to the project's root directory. h>jÈ hDhEhFhŒhH}rÎ (hJ]hK]hL]hM]hP]uhRNhShhT]rÏ hp)rÐ }rÑ (h=X¾``-l``, ``--list-only``: Rather than creating an archive, lists files that would be included. Output is to ``stdout`` by default. The file paths are relative to the project's root directory.h>jÌ hDhEhFhthH}rÒ (hJ]hK]hL]hM]hP]uhRMhT]rÓ (h–)rÔ }rÕ (h=X``-l``hH}rÖ (hJ]hK]hL]hM]hP]uh>jÐ hT]r× h]X-lrØ …rÙ }rÚ (h=X-lh>jÔ ubahFhžubh]X, rÛ …rÜ }rÝ (h=X, h>jÐ ubh–)rÞ }rß (h=X``--list-only``hH}rà (hJ]hK]hL]hM]hP]uh>jÐ hT]rá h]X --list-onlyrâ …rã }rä (h=X --list-onlyh>jÞ ubahFhžubh]XT: Rather than creating an archive, lists files that would be included. Output is to rå …ræ }rç (h=XT: Rather than creating an archive, lists files that would be included. Output is to h>jÐ ubh–)rè }ré (h=X ``stdout``hH}rê (hJ]hK]hL]hM]hP]uh>jÐ hT]rë h]Xstdoutrì …rí }rî (h=Xstdouth>jè ubahFhžubh]XK by default. The file paths are relative to the project’s root directory.rï …rð }rñ (h=XI by default. The file paths are relative to the project's root directory.h>jÐ ubeubaubh‰)rò }ró (h=X×``-o``, ``--output-dir``: Sets the output dir, if a non-default one is desired. The default is ``dist-newstyle/sdist/``. ``--output-dir -`` will send output to ``stdout`` unless multiple archives are being created. h>jÈ hDhEhFhŒhH}rô (hJ]hK]hL]hM]hP]uhRNhShhT]rõ hp)rö }r÷ (h=XÖ``-o``, ``--output-dir``: Sets the output dir, if a non-default one is desired. The default is ``dist-newstyle/sdist/``. ``--output-dir -`` will send output to ``stdout`` unless multiple archives are being created.h>jò hDhEhFhthH}rø (hJ]hK]hL]hM]hP]uhRMƒhT]rù (h–)rú }rû (h=X``-o``hH}rü (hJ]hK]hL]hM]hP]uh>jö hT]rý h]X-orþ …rÿ }r (h=X-oh>jú ubahFhžubh]X, r …r }r (h=X, h>jö ubh–)r }r (h=X``--output-dir``hH}r (hJ]hK]hL]hM]hP]uh>jö hT]r h]X --output-dirr …r }r (h=X --output-dirh>j ubahFhžubh]XG: Sets the output dir, if a non-default one is desired. The default is r …r }r (h=XG: Sets the output dir, if a non-default one is desired. The default is h>jö ubh–)r }r (h=X``dist-newstyle/sdist/``hH}r (hJ]hK]hL]hM]hP]uh>jö hT]r h]Xdist-newstyle/sdist/r …r }r (h=Xdist-newstyle/sdist/h>j ubahFhžubh]X. r …r }r (h=X. h>jö ubh–)r }r (h=X``--output-dir -``hH}r (hJ]hK]hL]hM]hP]uh>jö hT]r h]X--output-dir -r …r }r (h=X--output-dir -h>j ubahFhžubh]X will send output to r …r }r! (h=X will send output to h>jö ubh–)r" }r# (h=X ``stdout``hH}r$ (hJ]hK]hL]hM]hP]uh>jö hT]r% h]Xstdoutr& …r' }r( (h=Xstdouth>j" ubahFhžubh]X, unless multiple archives are being created.r) …r* }r+ (h=X, unless multiple archives are being created.h>jö ubeubaubh‰)r, }r- (h=Xm``-z``, ``--null``: Only used with ``--list-only``. Separates filenames with a NUL byte instead of newlines. h>jÈ hDhEhFhŒhH}r. (hJ]hK]hL]hM]hP]uhRNhShhT]r/ hp)r0 }r1 (h=Xl``-z``, ``--null``: Only used with ``--list-only``. Separates filenames with a NUL byte instead of newlines.h>j, hDhEhFhthH}r2 (hJ]hK]hL]hM]hP]uhRM‡hT]r3 (h–)r4 }r5 (h=X``-z``hH}r6 (hJ]hK]hL]hM]hP]uh>j0 hT]r7 h]X-zr8 …r9 }r: (h=X-zh>j4 ubahFhžubh]X, r; …r< }r= (h=X, h>j0 ubh–)r> }r? (h=X ``--null``hH}r@ (hJ]hK]hL]hM]hP]uh>j0 hT]rA h]X--nullrB …rC }rD (h=X--nullh>j> ubahFhžubh]X: Only used with rE …rF }rG (h=X: Only used with h>j0 ubh–)rH }rI (h=X``--list-only``hH}rJ (hJ]hK]hL]hM]hP]uh>j0 hT]rK h]X --list-onlyrL …rM }rN (h=X --list-onlyh>jH ubahFhžubh]X:. Separates filenames with a NUL byte instead of newlines.rO …rP }rQ (h=X:. Separates filenames with a NUL byte instead of newlines.h>j0 ubeubaubeubhp)rR }rS (h=X­``v2-sdist`` is inherently incompatible with sdist hooks, not due to implementation but due to fundamental core invariants (same source code should result in the same tarball, byte for byte) that must be satisfied for it to function correctly in the larger v2-build ecosystem. ``autogen-modules`` is able to replace uses of the hooks to add generated modules, along with the custom publishing of Haddock documentation to Hackage.h>j’ hDhEhFhthH}rT (hJ]hK]hL]hM]hP]uhRMŠhShhT]rU (h–)rV }rW (h=X ``v2-sdist``hH}rX (hJ]hK]hL]hM]hP]uh>jR hT]rY h]Xv2-sdistrZ …r[ }r\ (h=Xv2-sdisth>jV ubahFhžubh]X  is inherently incompatible with sdist hooks, not due to implementation but due to fundamental core invariants (same source code should result in the same tarball, byte for byte) that must be satisfied for it to function correctly in the larger v2-build ecosystem. r] …r^ }r_ (h=X  is inherently incompatible with sdist hooks, not due to implementation but due to fundamental core invariants (same source code should result in the same tarball, byte for byte) that must be satisfied for it to function correctly in the larger v2-build ecosystem. hDNhRNhShh>jR ubh–)r` }ra (h=X``autogen-modules``hH}rb (hJ]hK]hL]hM]hP]uh>jR hT]rc h]Xautogen-modulesrd …re }rf (h=Xautogen-modulesh>j` ubahFhžubh]X… is able to replace uses of the hooks to add generated modules, along with the custom publishing of Haddock documentation to Hackage.rg …rh }ri (h=X… is able to replace uses of the hooks to add generated modules, along with the custom publishing of Haddock documentation to Hackage.hDNhRNhShh>jR ubeubeubeubhDhEhFhGhH}rj (hJ]hK]hL]hM]rk Ucabal-v2-buildrl ahP]rm hauhRMLhShhT]rn (hV)ro }rp (h=Xcabal v2-buildrq h>jmhDhEhFhZhH}rr (hJ]hK]hL]hM]hP]uhRMLhShhT]rs h]Xcabal v2-buildrt …ru }rv (h=jq hDNhRNhShh>jo ubaubhp)rw }rx (h=XŽ``cabal v2-build`` takes a set of targets and builds them. It automatically handles building and installing any dependencies of these targets.h>jmhDhEhFhthH}ry (hJ]hK]hL]hM]hP]uhRMNhShhT]rz (h–)r{ }r| (h=X``cabal v2-build``hH}r} (hJ]hK]hL]hM]hP]uh>jw hT]r~ h]Xcabal v2-buildr …r€ }r (h=Xcabal v2-buildh>j{ ubahFhžubh]X| takes a set of targets and builds them. It automatically handles building and installing any dependencies of these targets.r‚ …rƒ }r„ (h=X| takes a set of targets and builds them. It automatically handles building and installing any dependencies of these targets.hDNhRNhShh>jw ubeubhp)r… }r† (h=X-A target can take any of the following forms:r‡ h>jmhDhEhFhthH}rˆ (hJ]hK]hL]hM]hP]uhRMRhShhT]r‰ h]X-A target can take any of the following forms:rŠ …r‹ }rŒ (h=j‡ hDNhRNhShh>j… ubaubjkhp)r }rŽ (h=X¨In component targets, ``package:`` and ``ctype:`` (valid component types are ``lib``, ``flib``, ``exe``, ``test`` and ``bench``) can be used to disambiguate when multiple packages define the same component, or the same component name is used in a package (e.g., a package ``foo`` defines both an executable and library named ``foo``). We always prefer interpreting a target as a package name rather than as a component name.h>jmhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRMhhShhT]r (h]XIn component targets, r‘ …r’ }r“ (h=XIn component targets, hDNhRNhShh>j ubh–)r” }r• (h=X ``package:``hH}r– (hJ]hK]hL]hM]hP]uh>j hT]r— h]Xpackage:r˜ …r™ }rš (h=Xpackage:h>j” ubahFhžubh]X and r› …rœ }r (h=X and rž hDNhRNhShh>j ubh–)rŸ }r  (h=X ``ctype:``hH}r¡ (hJ]hK]hL]hM]hP]uh>j hT]r¢ h]Xctype:r£ …r¤ }r¥ (h=Xctype:h>jŸ ubahFhžubh]X (valid component types are r¦ …r§ }r¨ (h=X (valid component types are hDNhRNhShh>j ubh–)r© }rª (h=X``lib``hH}r« (hJ]hK]hL]hM]hP]uh>j hT]r¬ h]Xlibr­ …r® }r¯ (h=Xlibh>j© ubahFhžubh]X, r° …r± }r² (h=X, r³ hDNhRNhShh>j ubh–)r´ }rµ (h=X``flib``hH}r¶ (hJ]hK]hL]hM]hP]uh>j hT]r· h]Xflibr¸ …r¹ }rº (h=Xflibh>j´ ubahFhžubh]X, r» …r¼ }r½ (h=X, h>j ubh–)r¾ }r¿ (h=X``exe``hH}rÀ (hJ]hK]hL]hM]hP]uh>j hT]rÁ h]Xexer …rà }rÄ (h=Xexeh>j¾ ubahFhžubh]X, rÅ …rÆ }rÇ (h=j³ h>j ubh–)rÈ }rÉ (h=X``test``hH}rÊ (hJ]hK]hL]hM]hP]uh>j hT]rË h]XtestrÌ …rÍ }rÎ (h=Xtesth>jÈ ubahFhžubh]X and rÏ …rÐ }rÑ (h=jž h>j ubh–)rÒ }rÓ (h=X ``bench``hH}rÔ (hJ]hK]hL]hM]hP]uh>j hT]rÕ h]XbenchrÖ …r× }rØ (h=Xbenchh>jÒ ubahFhžubh]X‘) can be used to disambiguate when multiple packages define the same component, or the same component name is used in a package (e.g., a package rÙ …rÚ }rÛ (h=X‘) can be used to disambiguate when multiple packages define the same component, or the same component name is used in a package (e.g., a package hDNhRNhShh>j ubh–)rÜ }rÝ (h=X``foo``hH}rÞ (hJ]hK]hL]hM]hP]uh>j hT]rß h]Xfoorà …rá }râ (h=Xfooh>jÜ ubahFhžubh]X. defines both an executable and library named rã …rä }rå (h=X. defines both an executable and library named hDNhRNhShh>j ubh–)ræ }rç (h=X``foo``hH}rè (hJ]hK]hL]hM]hP]uh>j hT]ré h]Xfoorê …rë }rì (h=Xfooh>jæ ubahFhžubh]X\). We always prefer interpreting a target as a package name rather than as a component name.rí …rî }rï (h=X\). We always prefer interpreting a target as a package name rather than as a component name.hDNhRNhShh>j ubeubhp)rð }rñ (h=XSome example targets:rò h>jmhDhEhFhthH}ró (hJ]hK]hL]hM]hP]uhRMohShhT]rô h]XSome example targets:rõ …rö }r÷ (h=jò hDNhRNhShh>jð ubaubj)rø }rù (h=X„$ cabal v2-build lib:foo-pkg # build the library named foo-pkg $ cabal v2-build foo-pkg:foo-tests # build foo-tests in foo-pkgh>jmhDhEhFjhH}rú (jjhM]hL]hJ]hK]hP]uhRMshShhT]rû h]X„$ cabal v2-build lib:foo-pkg # build the library named foo-pkg $ cabal v2-build foo-pkg:foo-tests # build foo-tests in foo-pkgrü …rý }rþ (h=Uh>jø ubaubhp)rÿ }r (h=Xd(There is also syntax for specifying module and file targets, but it doesn't currently do anything.)r h>jmhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRMvhShhT]r h]Xf(There is also syntax for specifying module and file targets, but it doesn’t currently do anything.)r …r }r (h=j hDNhRNhShh>jÿ ubaubhp)r }r (h=XˆBeyond a list of targets, ``cabal v2-build`` accepts all the flags that ``cabal v2-configure`` takes. Most of these flags are only taken into consideration when building local packages; however, some flags may cause extra store packages to be built (for example, ``--enable-profiling`` will automatically make sure profiling libraries for all transitive dependencies are built and installed.)h>jmhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRMyhShhT]r (h]XBeyond a list of targets, r …r }r (h=XBeyond a list of targets, hDNhRNhShh>j ubh–)r }r (h=X``cabal v2-build``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]Xcabal v2-buildr …r }r (h=Xcabal v2-buildh>j ubahFhžubh]X accepts all the flags that r …r }r (h=X accepts all the flags that hDNhRNhShh>j ubh–)r }r (h=X``cabal v2-configure``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]Xcabal v2-configurer …r }r (h=Xcabal v2-configureh>j ubahFhžubh]X© takes. Most of these flags are only taken into consideration when building local packages; however, some flags may cause extra store packages to be built (for example, r …r }r! (h=X© takes. Most of these flags are only taken into consideration when building local packages; however, some flags may cause extra store packages to be built (for example, hDNhRNhShh>j ubh–)r" }r# (h=X``--enable-profiling``hH}r$ (hJ]hK]hL]hM]hP]uh>j hT]r% h]X--enable-profilingr& …r' }r( (h=X--enable-profilingh>j" ubahFhžubh]Xk will automatically make sure profiling libraries for all transitive dependencies are built and installed.)r) …r* }r+ (h=Xk will automatically make sure profiling libraries for all transitive dependencies are built and installed.)hDNhRNhShh>j ubeubhp)r, }r- (h=X3In addition ``cabal v2-build`` accepts these flags:r. h>jmhDhEhFhthH}r/ (hJ]hK]hL]hM]hP]uhRM€hShhT]r0 (h]X In addition r1 …r2 }r3 (h=X In addition hDNhRNhShh>j, ubh–)r4 }r5 (h=X``cabal v2-build``hH}r6 (hJ]hK]hL]hM]hP]uh>j, hT]r7 h]Xcabal v2-buildr8 …r9 }r: (h=Xcabal v2-buildh>j4 ubahFhžubh]X accepts these flags:r; …r< }r= (h=X accepts these flags:hDNhRNhShh>j, ubeubh‚)r> }r? (h=Uh>jmhDhEhFh…hH}r@ (h‡X-hM]hL]hJ]hK]hP]uhRM‚hShhT]rA h‰)rB }rC (h=X``--only-configure``: When given we will forgoe performing a full build and abort after running the configure phase of each target package. h>j> hDhEhFhŒhH}rD (hJ]hK]hL]hM]hP]uhRNhShhT]rE hp)rF }rG (h=X‹``--only-configure``: When given we will forgoe performing a full build and abort after running the configure phase of each target package.h>jB hDhEhFhthH}rH (hJ]hK]hL]hM]hP]uhRM‚hT]rI (h–)rJ }rK (h=X``--only-configure``hH}rL (hJ]hK]hL]hM]hP]uh>jF hT]rM h]X--only-configurerN …rO }rP (h=X--only-configureh>jJ ubahFhžubh]Xw: When given we will forgoe performing a full build and abort after running the configure phase of each target package.rQ …rR }rS (h=Xw: When given we will forgoe performing a full build and abort after running the configure phase of each target package.h>jF ubeubaubaubeubhDhEhFh…hH}rT (h‡X-hM]hL]hJ]hK]hP]uhRMThShhT]rU (h‰)rV }rW (h=XäA package target: ``package``, which specifies that all enabled components of a package to be built. By default, test suites and benchmarks are *not* enabled, unless they are explicitly requested (e.g., via ``--enable-tests``.) h>jkhDhEhFhŒhH}rX (hJ]hK]hL]hM]hP]uhRNhShhT]rY hp)rZ }r[ (h=XãA package target: ``package``, which specifies that all enabled components of a package to be built. By default, test suites and benchmarks are *not* enabled, unless they are explicitly requested (e.g., via ``--enable-tests``.)h>jV hDhEhFhthH}r\ (hJ]hK]hL]hM]hP]uhRMThT]r] (h]XA package target: r^ …r_ }r` (h=XA package target: h>jZ ubh–)ra }rb (h=X ``package``hH}rc (hJ]hK]hL]hM]hP]uh>jZ hT]rd h]Xpackagere …rf }rg (h=Xpackageh>ja ubahFhžubh]Xs, which specifies that all enabled components of a package to be built. By default, test suites and benchmarks are rh …ri }rj (h=Xs, which specifies that all enabled components of a package to be built. By default, test suites and benchmarks are h>jZ ubj))rk }rl (h=X*not*hH}rm (hJ]hK]hL]hM]hP]uh>jZ hT]rn h]Xnotro …rp }rq (h=Xnoth>jk ubahFj1ubh]X: enabled, unless they are explicitly requested (e.g., via rr …rs }rt (h=X: enabled, unless they are explicitly requested (e.g., via h>jZ ubh–)ru }rv (h=X``--enable-tests``hH}rw (hJ]hK]hL]hM]hP]uh>jZ hT]rx h]X--enable-testsry …rz }r{ (h=X--enable-testsh>ju ubahFhžubh]X.)r| …r} }r~ (h=X.)h>jZ ubeubaubh‰)r }r€ (h=XžA component target: ``[package:][ctype:]component``, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built. h>jkhDhEhFhŒhH}r (hJ]hK]hL]hM]hP]uhRNhShhT]r‚ hp)rƒ }r„ (h=XA component target: ``[package:][ctype:]component``, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built.h>j hDhEhFhthH}r… (hJ]hK]hL]hM]hP]uhRMYhT]r† (h]XA component target: r‡ …rˆ }r‰ (h=XA component target: h>jƒ ubh–)rŠ }r‹ (h=X``[package:][ctype:]component``hH}rŒ (hJ]hK]hL]hM]hP]uh>jƒ hT]r h]Xackage:][ctype:]componentrŽ …r }r (h=Xackage:][ctype:]componenth>jŠ ubahFhžubh]Xj, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built.r‘ …r’ }r“ (h=Xj, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built.h>jƒ ubeubaubh‰)r” }r• (h=XHAll packages: ``all``, which specifies all packages within the project. h>jkhDhEhFhŒhH}r– (hJ]hK]hL]hM]hP]uhRNhShhT]r— hp)r˜ }r™ (h=XGAll packages: ``all``, which specifies all packages within the project.h>j” hDhEhFhthH}rš (hJ]hK]hL]hM]hP]uhRM]hT]r› (h]XAll packages: rœ …r }rž (h=XAll packages: h>j˜ ubh–)rŸ }r  (h=X``all``hH}r¡ (hJ]hK]hL]hM]hP]uh>j˜ hT]r¢ h]Xallr£ …r¤ }r¥ (h=Xallh>jŸ ubahFhžubh]X2, which specifies all packages within the project.r¦ …r§ }r¨ (h=X2, which specifies all packages within the project.h>j˜ ubeubaubjieubhDhEhFhŒhH}r© (hJ]hK]hL]hM]hP]uhRNhShhT]rª (hp)r« }r¬ (h=X’Components of a particular type: ``package:ctypes``, ``all:ctypes``: which specifies all components of the given type. Where valid ``ctypes`` are:h>jihDhEhFhthH}r­ (hJ]hK]hL]hM]hP]uhRM_hT]r® (h]X!Components of a particular type: r¯ …r° }r± (h=X!Components of a particular type: h>j« ubh–)r² }r³ (h=X``package:ctypes``hH}r´ (hJ]hK]hL]hM]hP]uh>j« hT]rµ h]Xpackage:ctypesr¶ …r· }r¸ (h=Xpackage:ctypesh>j² ubahFhžubh]X, r¹ …rº }r» (h=X, h>j« ubh–)r¼ }r½ (h=X``all:ctypes``hH}r¾ (hJ]hK]hL]hM]hP]uh>j« hT]r¿ h]X all:ctypesrÀ …rÁ }r (h=X all:ctypesh>j¼ ubahFhžubh]X@: which specifies all components of the given type. Where valid rà …rÄ }rÅ (h=X@: which specifies all components of the given type. Where valid h>j« ubh–)rÆ }rÇ (h=X ``ctypes``hH}rÈ (hJ]hK]hL]hM]hP]uh>j« hT]rÉ h]XctypesrÊ …rË }rÌ (h=Xctypesh>jÆ ubahFhžubh]X are:rÍ …rÎ }rÏ (h=X are:h>j« ubeubcdocutils.nodes block_quote rÐ )rÑ }rÒ (h=UhH}rÓ (hJ]hK]hL]hM]hP]uh>jihT]rÔ h‚)rÕ }rÖ (h=Uh>jÑ hDhEhFh…hH}r× (h‡X-hM]hL]hJ]hK]hP]uhRMbhT]rØ (h‰)rÙ }rÚ (h=X``libs``, ``libraries``,rÛ hH}rÜ (hJ]hK]hL]hM]hP]uh>jÕ hT]rÝ hp)rÞ }rß (h=jÛ h>jÙ hDhEhFhthH}rà (hJ]hK]hL]hM]hP]uhRMbhT]rá (h–)râ }rã (h=X``libs``hH}rä (hJ]hK]hL]hM]hP]uh>jÞ hT]rå h]Xlibsræ …rç }rè (h=Xlibsh>jâ ubahFhžubh]X, ré …rê }rë (h=X, h>jÞ ubh–)rì }rí (h=X ``libraries``hH}rî (hJ]hK]hL]hM]hP]uh>jÞ hT]rï h]X librariesrð …rñ }rò (h=X librariesh>jì ubahFhžubh]X,…ró }rô (h=X,h>jÞ ubeubahFhŒubh‰)rõ }rö (h=X!``flibs``, ``foreign-libraries``,r÷ hH}rø (hJ]hK]hL]hM]hP]uh>jÕ hT]rù hp)rú }rû (h=j÷ h>jõ hDhEhFhthH}rü (hJ]hK]hL]hM]hP]uhRMchT]rý (h–)rþ }rÿ (h=X ``flibs``hH}r (hJ]hK]hL]hM]hP]uh>jú hT]r h]Xflibsr …r }r (h=Xflibsh>jþ ubahFhžubh]X, r …r }r (h=X, h>jú ubh–)r }r (h=X``foreign-libraries``hH}r (hJ]hK]hL]hM]hP]uh>jú hT]r h]Xforeign-librariesr …r }r (h=Xforeign-librariesh>j ubahFhžubh]X,…r }r (h=X,h>jú ubeubahFhŒubh‰)r }r (h=X``exes``, ``executables``,r hH}r (hJ]hK]hL]hM]hP]uh>jÕ hT]r hp)r }r (h=j h>j hDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRMdhT]r (h–)r }r (h=X``exes``hH}r (hJ]hK]hL]hM]hP]uh>j hT]r h]Xexesr …r }r (h=Xexesh>j ubahFhžubh]X, r! …r" }r# (h=X, h>j ubh–)r$ }r% (h=X``executables``hH}r& (hJ]hK]hL]hM]hP]uh>j hT]r' h]X executablesr( …r) }r* (h=X executablesh>j$ ubahFhžubh]X,…r+ }r, (h=X,h>j ubeubahFhŒubh‰)r- }r. (h=X ``tests``,r/ hH}r0 (hJ]hK]hL]hM]hP]uh>jÕ hT]r1 hp)r2 }r3 (h=j/ h>j- hDhEhFhthH}r4 (hJ]hK]hL]hM]hP]uhRMehT]r5 (h–)r6 }r7 (h=X ``tests``hH}r8 (hJ]hK]hL]hM]hP]uh>j2 hT]r9 h]Xtestsr: …r; }r< (h=Xtestsh>j6 ubahFhžubh]X,…r= }r> (h=X,h>j2 ubeubahFhŒubh‰)r? }r@ (h=X``benches``, ``benchmarks``. hH}rA (hJ]hK]hL]hM]hP]uh>jÕ hT]rB hp)rC }rD (h=X``benches``, ``benchmarks``.rE h>j? hDhEhFhthH}rF (hJ]hK]hL]hM]hP]uhRMfhT]rG (h–)rH }rI (h=X ``benches``hH}rJ (hJ]hK]hL]hM]hP]uh>jC hT]rK h]XbenchesrL …rM }rN (h=Xbenchesh>jH ubahFhžubh]X, rO …rP }rQ (h=X, h>jC ubh–)rR }rS (h=X``benchmarks``hH}rT (hJ]hK]hL]hM]hP]uh>jC hT]rU h]X benchmarksrV …rW }rX (h=X benchmarksh>jR ubahFhžubh]X.…rY }rZ (h=X.h>jC ubeubahFhŒubeubahFU block_quoter[ ubeubhT]r\ hp)r] }r^ (h=XUnexpected indentation.hH}r_ (hJ]hK]hL]hM]hP]uh>jehT]r` h]XUnexpected indentation.ra …rb }rc (h=Uh>j] ubahFhtubahFjZubh:)rd }re (h=Uh>h?)rf }rg (h=Uh>h?)rh }ri (h=Uh>hhDhEhFhGhH}rj (hJ]hK]hL]hM]rk U%configuring-builds-with-cabal-projectrl ahP]rm hauhRM‘hShhT]rn (hV)ro }rp (h=X%Configuring builds with cabal.projectrq h>jh hDhEhFhZhH}rr (hJ]hK]hL]hM]hP]uhRM‘hShhT]rs h]X%Configuring builds with cabal.projectrt …ru }rv (h=jq hDNhRNhShh>jo ubaubhp)rw }rx (h=Xó``cabal.project`` files support a variety of options which configure the details of your build. The general syntax of a ``cabal.project`` file is similar to that of a Cabal file: there are a number of fields, some of which live inside stanzas:h>jh hDhEhFhthH}ry (hJ]hK]hL]hM]hP]uhRM“hShhT]rz (h–)r{ }r| (h=X``cabal.project``hH}r} (hJ]hK]hL]hM]hP]uh>jw hT]r~ h]X cabal.projectr …r€ }r (h=X cabal.projecth>j{ ubahFhžubh]Xg files support a variety of options which configure the details of your build. The general syntax of a r‚ …rƒ }r„ (h=Xg files support a variety of options which configure the details of your build. The general syntax of a hDNhRNhShh>jw ubh–)r… }r† (h=X``cabal.project``hH}r‡ (hJ]hK]hL]hM]hP]uh>jw hT]rˆ h]X cabal.projectr‰ …rŠ }r‹ (h=X cabal.projecth>j… ubahFhžubh]Xj file is similar to that of a Cabal file: there are a number of fields, some of which live inside stanzas:rŒ …r }rŽ (h=Xj file is similar to that of a Cabal file: there are a number of fields, some of which live inside stanzas:hDNhRNhShh>jw ubeubj)r }r (h=Xcpackages: */*.cabal with-compiler: /opt/ghc/8.0.1/bin/ghc package cryptohash optimization: Falseh>jh hDhEhFjhH}r‘ (jjhM]hL]hJ]hK]hP]uhRMšhShhT]r’ h]Xcpackages: */*.cabal with-compiler: /opt/ghc/8.0.1/bin/ghc package cryptohash optimization: Falser“ …r” }r• (h=Uh>j ubaubhp)r– }r— (h=XñIn general, the accepted field names coincide with the accepted command line flags that ``cabal install`` and other commands take. For example, ``cabal v2-configure --enable-profiling`` will write out a project file with ``profiling: True``.h>jh hDhEhFhthH}r˜ (hJ]hK]hL]hM]hP]uhRM hShhT]r™ (h]XXIn general, the accepted field names coincide with the accepted command line flags that rš …r› }rœ (h=XXIn general, the accepted field names coincide with the accepted command line flags that hDNhRNhShh>j– ubh–)r }rž (h=X``cabal install``hH}rŸ (hJ]hK]hL]hM]hP]uh>j– hT]r  h]X cabal installr¡ …r¢ }r£ (h=X cabal installh>j ubahFhžubh]X' and other commands take. For example, r¤ …r¥ }r¦ (h=X' and other commands take. For example, hDNhRNhShh>j– ubh–)r§ }r¨ (h=X)``cabal v2-configure --enable-profiling``hH}r© (hJ]hK]hL]hM]hP]uh>j– hT]rª h]X%cabal v2-configure --enable-profilingr« …r¬ }r­ (h=X%cabal v2-configure --enable-profilingh>j§ ubahFhžubh]X$ will write out a project file with r® …r¯ }r° (h=X$ will write out a project file with hDNhRNhShh>j– ubh–)r± }r² (h=X``profiling: True``hH}r³ (hJ]hK]hL]hM]hP]uh>j– hT]r´ h]Xprofiling: Truerµ …r¶ }r· (h=Xprofiling: Trueh>j± ubahFhžubh]X.…r¸ }r¹ (h=X.hDNhRNhShh>j– ubeubhp)rº }r» (h=X{The full configuration of a project is determined by combining the following sources (later entries override earlier ones):r¼ h>jh hDhEhFhthH}r½ (hJ]hK]hL]hM]hP]uhRM¥hShhT]r¾ h]X{The full configuration of a project is determined by combining the following sources (later entries override earlier ones):r¿ …rÀ }rÁ (h=j¼ hDNhRNhShh>jº ubaubjb)r }rà (h=Uh>jh hDhEhFjehH}rÄ (jgU.hM]hL]hJ]jhUhK]hP]jijjuhRM¨hShhT]rÅ (h‰)rÆ }rÇ (h=X9``~/.cabal/config`` (the user-wide global configuration) h>j hDhEhFhŒhH}rÈ (hJ]hK]hL]hM]hP]uhRNhShhT]rÉ hp)rÊ }rË (h=X8``~/.cabal/config`` (the user-wide global configuration)h>jÆ hDhEhFhthH}rÌ (hJ]hK]hL]hM]hP]uhRM¨hT]rÍ (h–)rÎ }rÏ (h=X``~/.cabal/config``hH}rÐ (hJ]hK]hL]hM]hP]uh>jÊ hT]rÑ h]X~/.cabal/configrÒ …rÓ }rÔ (h=X~/.cabal/configh>jÎ ubahFhžubh]X% (the user-wide global configuration)rÕ …rÖ }r× (h=X% (the user-wide global configuration)h>jÊ ubeubaubh‰)rØ }rÙ (h=X.``cabal.project`` (the project configuration) h>j hDhEhFhŒhH}rÚ (hJ]hK]hL]hM]hP]uhRNhShhT]rÛ hp)rÜ }rÝ (h=X-``cabal.project`` (the project configuration)h>jØ hDhEhFhthH}rÞ (hJ]hK]hL]hM]hP]uhRMªhT]rß (h–)rà }rá (h=X``cabal.project``hH}râ (hJ]hK]hL]hM]hP]uh>jÜ hT]rã h]X cabal.projecträ …rå }ræ (h=X cabal.projecth>jà ubahFhžubh]X (the project configuration)rç …rè }ré (h=X (the project configuration)h>jÜ ubeubaubh‰)rê }rë (h=X=``cabal.project.freeze`` (the output of ``cabal v2-freeze``) h>j hDhEhFhŒhH}rì (hJ]hK]hL]hM]hP]uhRNhShhT]rí hp)rî }rï (h=X<``cabal.project.freeze`` (the output of ``cabal v2-freeze``)h>jê hDhEhFhthH}rð (hJ]hK]hL]hM]hP]uhRM¬hT]rñ (h–)rò }ró (h=X``cabal.project.freeze``hH}rô (hJ]hK]hL]hM]hP]uh>jî hT]rõ h]Xcabal.project.freezerö …r÷ }rø (h=Xcabal.project.freezeh>jò ubahFhžubh]X (the output of rù …rú }rû (h=X (the output of h>jî ubh–)rü }rý (h=X``cabal v2-freeze``hH}rþ (hJ]hK]hL]hM]hP]uh>jî hT]rÿ h]Xcabal v2-freezer…r}r(h=Xcabal v2-freezeh>jü ubahFhžubh]X)…r}r(h=X)h>jî ubeubaubh‰)r}r(h=X@``cabal.project.local`` (the output of ``cabal v2-configure``) h>j hDhEhFhŒhH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rhp)r }r (h=X>``cabal.project.local`` (the output of ``cabal v2-configure``)h>jhDhEhFhthH}r (hJ]hK]hL]hM]hP]uhRM®hT]r (h–)r }r(h=X``cabal.project.local``hH}r(hJ]hK]hL]hM]hP]uh>j hT]rh]Xcabal.project.localr…r}r(h=Xcabal.project.localh>j ubahFhžubh]X (the output of r…r}r(h=X (the output of h>j ubh–)r}r(h=X``cabal v2-configure``hH}r(hJ]hK]hL]hM]hP]uh>j hT]rh]Xcabal v2-configurer…r}r(h=Xcabal v2-configureh>jubahFhžubh]X)…r}r(h=X)h>j ubeubaubeubh?)r }r!(h=Uh>jh hDhEhFhGhH}r"(hJ]hK]hL]hM]r#Uspecifying-the-local-packagesr$ahP]r%hauhRM²hShhT]r&(hV)r'}r((h=XSpecifying the local packagesr)h>j hDhEhFhZhH}r*(hJ]hK]hL]hM]hP]uhRM²hShhT]r+h]XSpecifying the local packagesr,…r-}r.(h=j)hDNhRNhShh>j'ubaubhp)r/}r0(h=XQThe following top-level options specify what the local packages of a project are:r1h>j hDhEhFhthH}r2(hJ]hK]hL]hM]hP]uhRM´hShhT]r3h]XQThe following top-level options specify what the local packages of a project are:r4…r5}r6(h=j1hDNhRNhShh>j/ubaubcsphinx.addnodes index r7)r8}r9(h=Uh>j hDhEhFUindexr:hH}r;(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubcsphinx.addnodes desc r<)r=}r>(h=Uh>j hDhEhFUdescr?hH}r@(UnoindexrA‰UdomainrBXcabalhM]hL]hJ]hK]hP]UobjtyperCX cfg-fieldrDUdesctyperEjDuhRNhShhT]rF(csphinx.addnodes desc_signature rG)rH}rI(h=X:packages: package location list (space or comma separated)h>j=hDhEhFUdesc_signaturerJhH}rK(hM]rLXcfg-field-packagesrMahL]hJ]hK]hP]UfirstrN‰uhRNhShhT]rO(j7)rP}rQ(h=Uh>jHhDhEhFj:hH}rR(hM]hL]hJ]hK]hP]Uentries]rS(UpairrTXpackages ; cabal project optionjMUNtrUauhRNhShhT]ubcsphinx.addnodes desc_name rV)rW}rX(h=XpackagesrYh>jHhDhEhFU desc_namerZhH}r[(jjhM]hL]hJ]hK]hP]uhRNhShhT]r\h]Xpackagesr]…r^}r_(h=UhDNhRNhShh>jWubaubcsphinx.addnodes desc_addname r`)ra}rb(h=U: rch>jHhDhEhFU desc_addnamerdhH}re(jjhM]hL]hJ]hK]hP]uhRNhShhT]rfh]X: rg…rh}ri(h=UhDNhRNhShh>jaubaubcsphinx.addnodes desc_annotation rj)rk}rl(h=X0package location list (space or comma separated)h>jHhDhEhFUdesc_annotationrmhH}rn(jjhM]hL]hJ]hK]hP]uhRNhShhT]roh]X0package location list (space or comma separated)rp…rq}rr(h=UhDNhRNhShh>jkubaubeubcsphinx.addnodes desc_content rs)rt}ru(h=Uh>j=hDhEhFU desc_contentrvhH}rw(hJ]hK]hL]hM]hP]uhRNhShhT]rx(cdocutils.nodes field_list ry)rz}r{(h=Uh>jthDhEhFU field_listr|hH}r}(hJ]hK]hL]hM]hP]uhRNhShhT]r~cdocutils.nodes field r)r€}r(h=UhH}r‚(hJ]hK]hL]hM]hP]uh>jzhT]rƒ(cdocutils.nodes field_name r„)r…}r†(h=X Default valueh>j€hDhEhFU field_namer‡hH}rˆ(hJ]hK]hL]hM]hP]uhRKhT]r‰h]X Default valuerŠ…r‹}rŒ(h=Uh>j…ubaubcdocutils.nodes field_body r)rŽ}r(h=UhH}r(hJ]hK]hL]hM]hP]uh>j€hT]r‘hp)r’}r“(h=X ./*.cabalhH}r”(hJ]hK]hL]hM]hP]uh>jŽhT]r•h–)r–}r—(h=X ``./*.cabal``h>j’hDhEhFhžhH}r˜(hJ]hK]hL]hM]hP]uhRNhShhT]r™h]X ./*.cabalrš…r›}rœ(h=X ./*.cabalhDNhRNhShh>j–ubaubahFhtubahFU field_bodyrubehFUfieldržubaubhp)rŸ}r (h=X•Specifies the list of package locations which contain the local packages to be built by this project. Package locations can take the following forms:r¡h>jthDhEhFhthH}r¢(hJ]hK]hL]hM]hP]uhRM¼hShhT]r£h]X•Specifies the list of package locations which contain the local packages to be built by this project. Package locations can take the following forms:r¤…r¥}r¦(h=j¡hDNhRNhShh>jŸubaubjb)r§}r¨(h=Uh>jthDhEhFjehH}r©(jgU.hM]hL]hJ]jhUhK]hP]jijjuhRMÀhShhT]rª(h‰)r«}r¬(h=X„They can specify a Cabal file, or a directory containing a Cabal file, e.g., ``packages: Cabal cabal-install/cabal-install.cabal``. h>j§hDhEhFhŒhH}r­(hJ]hK]hL]hM]hP]uhRNhShhT]r®hp)r¯}r°(h=XƒThey can specify a Cabal file, or a directory containing a Cabal file, e.g., ``packages: Cabal cabal-install/cabal-install.cabal``.h>j«hDhEhFhthH}r±(hJ]hK]hL]hM]hP]uhRMÀhT]r²(h]XMThey can specify a Cabal file, or a directory containing a Cabal file, e.g., r³…r´}rµ(h=XMThey can specify a Cabal file, or a directory containing a Cabal file, e.g., h>j¯ubh–)r¶}r·(h=X5``packages: Cabal cabal-install/cabal-install.cabal``hH}r¸(hJ]hK]hL]hM]hP]uh>j¯hT]r¹h]X1packages: Cabal cabal-install/cabal-install.cabalrº…r»}r¼(h=X1packages: Cabal cabal-install/cabal-install.cabalh>j¶ubahFhžubh]X.…r½}r¾(h=X.h>j¯ubeubaubh‰)r¿}rÀ(h=XšThey can specify a glob-style wildcards, which must match one or more (a) directories containing a (single) Cabal file, (b) Cabal files (extension ``.cabal``), or (c) tarballs which contain Cabal packages (extension ``.tar.gz``). For example, to match all Cabal files in all subdirectories, as well as the Cabal projects in the parent directories ``foo`` and ``bar``, use ``packages: */*.cabal ../{foo,bar}/`` h>j§hDhEhFhŒhH}rÁ(hJ]hK]hL]hM]hP]uhRNhShhT]rÂhp)rÃ}rÄ(h=X™They can specify a glob-style wildcards, which must match one or more (a) directories containing a (single) Cabal file, (b) Cabal files (extension ``.cabal``), or (c) tarballs which contain Cabal packages (extension ``.tar.gz``). For example, to match all Cabal files in all subdirectories, as well as the Cabal projects in the parent directories ``foo`` and ``bar``, use ``packages: */*.cabal ../{foo,bar}/``h>j¿hDhEhFhthH}rÅ(hJ]hK]hL]hM]hP]uhRMÃhT]rÆ(h]X“They can specify a glob-style wildcards, which must match one or more (a) directories containing a (single) Cabal file, (b) Cabal files (extension rÇ…rÈ}rÉ(h=X“They can specify a glob-style wildcards, which must match one or more (a) directories containing a (single) Cabal file, (b) Cabal files (extension h>jÃubh–)rÊ}rË(h=X ``.cabal``hH}rÌ(hJ]hK]hL]hM]hP]uh>jÃhT]rÍh]X.cabalrÎ…rÏ}rÐ(h=X.cabalh>jÊubahFhžubh]X;), or (c) tarballs which contain Cabal packages (extension rÑ…rÒ}rÓ(h=X;), or (c) tarballs which contain Cabal packages (extension h>jÃubh–)rÔ}rÕ(h=X ``.tar.gz``hH}rÖ(hJ]hK]hL]hM]hP]uh>jÃhT]r×h]X.tar.gzrØ…rÙ}rÚ(h=X.tar.gzh>jÔubahFhžubh]Xx). For example, to match all Cabal files in all subdirectories, as well as the Cabal projects in the parent directories rÛ…rÜ}rÝ(h=Xx). For example, to match all Cabal files in all subdirectories, as well as the Cabal projects in the parent directories h>jÃubh–)rÞ}rß(h=X``foo``hH}rà(hJ]hK]hL]hM]hP]uh>jÃhT]ráh]Xfoorâ…rã}rä(h=Xfooh>jÞubahFhžubh]X and rå…ræ}rç(h=X and h>jÃubh–)rè}ré(h=X``bar``hH}rê(hJ]hK]hL]hM]hP]uh>jÃhT]rëh]Xbarrì…rí}rî(h=Xbarh>jèubahFhžubh]X, use rï…rð}rñ(h=X, use h>jÃubh–)rò}ró(h=X%``packages: */*.cabal ../{foo,bar}/``hH}rô(hJ]hK]hL]hM]hP]uh>jÃhT]rõh]X!packages: */*.cabal ../{foo,bar}/rö…r÷}rø(h=X!packages: */*.cabal ../{foo,bar}/h>jòubahFhžubeubaubh‰)rù}rú(h=XThey can specify an ``http``, ``https`` or ``file`` URL, representing the path to a remote tarball to be downloaded and built. h>j§hDhEhFhŒhH}rû(hJ]hK]hL]hM]hP]uhRNhShhT]rühp)rý}rþ(h=X~They can specify an ``http``, ``https`` or ``file`` URL, representing the path to a remote tarball to be downloaded and built.h>jùhDhEhFhthH}rÿ(hJ]hK]hL]hM]hP]uhRMÌhT]r(h]XThey can specify an r…r}r(h=XThey can specify an h>jýubh–)r}r(h=X``http``hH}r(hJ]hK]hL]hM]hP]uh>jýhT]rh]Xhttpr…r }r (h=Xhttph>jubahFhžubh]X, r …r }r (h=X, h>jýubh–)r}r(h=X ``https``hH}r(hJ]hK]hL]hM]hP]uh>jýhT]rh]Xhttpsr…r}r(h=Xhttpsh>jubahFhžubh]X or r…r}r(h=X or h>jýubh–)r}r(h=X``file``hH}r(hJ]hK]hL]hM]hP]uh>jýhT]rh]Xfiler…r}r(h=Xfileh>jubahFhžubh]XK URL, representing the path to a remote tarball to be downloaded and built.r…r }r!(h=XK URL, representing the path to a remote tarball to be downloaded and built.h>jýubeubaubeubhp)r"}r#(h=XBThere is no command line variant of this field; see :issue:`3585`.h>jthDhEhFhthH}r$(hJ]hK]hL]hM]hP]uhRMÐhShhT]r%(h]X4There is no command line variant of this field; see r&…r'}r((h=X4There is no command line variant of this field; see hDNhRNhShh>j"ubjæ)r)}r*(h=X#3585hH}r+(UrefuriX,https://github.com/haskell/cabal/issues/3585hM]hL]hJ]hK]hP]Uinternal‰uh>j"hT]r,h]X#3585r-…r.}r/(h=X3585h>j)ubahFjïubh]X.…r0}r1(h=X.hDNhRNhShh>j"ubeubeubeubj7)r2}r3(h=Uh>j hDhEhFj:hH}r4(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r5}r6(h=Uh>j hDhEhFj?hH}r7(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr8jEj8uhRNhShhT]r9(jG)r:}r;(h=XCoptional-packages: package location list (space or comma-separated)h>j5hDhEhFjJhH}r<(hM]r=Xcfg-field-optional-packagesr>ahL]hJ]hK]hP]jN‰uhRNhShhT]r?(j7)r@}rA(h=Uh>j:hDhEhFj:hH}rB(hM]hL]hJ]hK]hP]Uentries]rC(jTX(optional-packages ; cabal project optionj>UNtrDauhRNhShhT]ubjV)rE}rF(h=Xoptional-packagesrGh>j:hDhEhFjZhH}rH(jjhM]hL]hJ]hK]hP]uhRNhShhT]rIh]Xoptional-packagesrJ…rK}rL(h=UhDNhRNhShh>jEubaubj`)rM}rN(h=jch>j:hDhEhFjdhH}rO(jjhM]hL]hJ]hK]hP]uhRNhShhT]rPh]X: rQ…rR}rS(h=UhDNhRNhShh>jMubaubjj)rT}rU(h=X0package location list (space or comma-separated)h>j:hDhEhFjmhH}rV(jjhM]hL]hJ]hK]hP]uhRNhShhT]rWh]X0package location list (space or comma-separated)rX…rY}rZ(h=UhDNhRNhShh>jTubaubeubjs)r[}r\(h=Uh>j5hDhEhFjvhH}r](hJ]hK]hL]hM]hP]uhRNhShhT]r^(jy)r_}r`(h=Uh>j[hDhEhFj|hH}ra(hJ]hK]hL]hM]hP]uhRNhShhT]rbj)rc}rd(h=UhH}re(hJ]hK]hL]hM]hP]uh>j_hT]rf(j„)rg}rh(h=X Default valueh>jchDhEhFj‡hH}ri(hJ]hK]hL]hM]hP]uhRKhT]rjh]X Default valuerk…rl}rm(h=Uh>jgubaubj)rn}ro(h=UhH}rp(hJ]hK]hL]hM]hP]uh>jchT]rqhp)rr}rs(h=X ./*/*.cabalhH}rt(hJ]hK]hL]hM]hP]uh>jnhT]ruh–)rv}rw(h=X``./*/*.cabal``h>jrhDhEhFhžhH}rx(hJ]hK]hL]hM]hP]uhRNhShhT]ryh]X ./*/*.cabalrz…r{}r|(h=X ./*/*.cabalhDNhRNhShh>jvubaubahFhtubahFjubehFjžubaubhp)r}}r~(h=X¨Like :cfg-field:`packages`, specifies a list of package locations containing local packages to be built. Unlike :cfg-field:`packages`, if we glob for a package, it is permissible for the glob to match against zero packages. The intended use-case for :cfg-field:`optional-packages` is to make it so that vendored packages can be automatically picked up if they are placed in a subdirectory, but not error if there aren't any.h>j[hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM×hShhT]r€(h]XLike r…r‚}rƒ(h=XLike hDNhRNhShh>j}ubjä)r„}r…(h=X:cfg-field:`packages`h>j}hDhEhFjçhH}r†(UreftypeX cfg-fieldjéˆjêXpackagesr‡U refdomainXcabalrˆhM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM×hT]r‰h–)rŠ}r‹(h=j‡hH}rŒ(hJ]hK]r(jôjˆXcabal-cfg-fieldrŽehL]hM]hP]uh>j„hT]rh]Xpackagesr…r‘}r’(h=Uh>jŠubahFhžubaubh]XV, specifies a list of package locations containing local packages to be built. Unlike r“…r”}r•(h=XV, specifies a list of package locations containing local packages to be built. Unlike hDNhRNhShh>j}ubjä)r–}r—(h=X:cfg-field:`packages`h>j}hDhEhFjçhH}r˜(UreftypeX cfg-fieldjéˆjêXpackagesr™U refdomainXcabalršhM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM×hT]r›h–)rœ}r(h=j™hH}rž(hJ]hK]rŸ(jôjšXcabal-cfg-fieldr ehL]hM]hP]uh>j–hT]r¡h]Xpackagesr¢…r£}r¤(h=Uh>jœubahFhžubaubh]Xu, if we glob for a package, it is permissible for the glob to match against zero packages. The intended use-case for r¥…r¦}r§(h=Xu, if we glob for a package, it is permissible for the glob to match against zero packages. The intended use-case for hDNhRNhShh>j}ubjä)r¨}r©(h=X:cfg-field:`optional-packages`h>j}hDhEhFjçhH}rª(UreftypeX cfg-fieldjéˆjêXoptional-packagesr«U refdomainXcabalr¬hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM×hT]r­h–)r®}r¯(h=j«hH}r°(hJ]hK]r±(jôj¬Xcabal-cfg-fieldr²ehL]hM]hP]uh>j¨hT]r³h]Xoptional-packagesr´…rµ}r¶(h=Uh>j®ubahFhžubaubh]X’ is to make it so that vendored packages can be automatically picked up if they are placed in a subdirectory, but not error if there aren’t any.r·…r¸}r¹(h=X is to make it so that vendored packages can be automatically picked up if they are placed in a subdirectory, but not error if there aren't any.hDNhRNhShh>j}ubeubhp)rº}r»(h=X/There is no command line variant of this field.r¼h>j[hDhEhFhthH}r½(hJ]hK]hL]hM]hP]uhRMÞhShhT]r¾h]X/There is no command line variant of this field.r¿…rÀ}rÁ(h=j¼hDNhRNhShh>jºubaubeubeubj7)rÂ}rÃ(h=Uh>j hDhEhFj:hH}rÄ(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rÅ}rÆ(h=Uh>j hDhEhFj?hH}rÇ(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrÈjEjÈuhRNhShhT]rÉ(jG)rÊ}rË(h=XBextra-packages: package list with version bounds (comma separated)h>jÅhDhEhFjJhH}rÌ(hM]rÍXcfg-field-extra-packagesrÎahL]hJ]hK]hP]jN‰uhRNhShhT]rÏ(j7)rÐ}rÑ(h=Uh>jÊhDhEhFj:hH}rÒ(hM]hL]hJ]hK]hP]Uentries]rÓ(jTX%extra-packages ; cabal project optionjÎUNtrÔauhRNhShhT]ubjV)rÕ}rÖ(h=Xextra-packagesr×h>jÊhDhEhFjZhH}rØ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÙh]Xextra-packagesrÚ…rÛ}rÜ(h=UhDNhRNhShh>jÕubaubj`)rÝ}rÞ(h=jch>jÊhDhEhFjdhH}rß(jjhM]hL]hJ]hK]hP]uhRNhShhT]ràh]X: rá…râ}rã(h=UhDNhRNhShh>jÝubaubjj)rä}rå(h=X2package list with version bounds (comma separated)h>jÊhDhEhFjmhH}ræ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rçh]X2package list with version bounds (comma separated)rè…ré}rê(h=UhDNhRNhShh>jäubaubeubjs)rë}rì(h=Uh>jÅhDhEhFjvhH}rí(hJ]hK]hL]hM]hP]uhRNhShhT]rî(hp)rï}rð(h=X{[STRIKEOUT:Specifies a list of external packages from Hackage which should be considered local packages.] (Not implemented)rñh>jëhDhEhFhthH}rò(hJ]hK]hL]hM]hP]uhRMãhShhT]róh]X{[STRIKEOUT:Specifies a list of external packages from Hackage which should be considered local packages.] (Not implemented)rô…rõ}rö(h=jñhDNhRNhShh>jïubaubhp)r÷}rø(h=X/There is no command line variant of this field.rùh>jëhDhEhFhthH}rú(hJ]hK]hL]hM]hP]uhRMæhShhT]rûh]X/There is no command line variant of this field.rü…rý}rþ(h=jùhDNhRNhShh>j÷ubaubeubeubhp)rÿ}r(h=XôAll local packages are *vendored*, in the sense that if other packages (including external ones from Hackage) depend on a package with the name of a local package, the local package is preferentially used. This motivates the default settings::h>j hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMêhShhT]r(h]XAll local packages are r…r}r(h=XAll local packages are hDNhRNhShh>jÿubj))r}r(h=X *vendored*hH}r(hJ]hK]hL]hM]hP]uh>jÿhT]r h]Xvendoredr …r }r (h=Xvendoredh>jubahFj1ubh]XÒ, in the sense that if other packages (including external ones from Hackage) depend on a package with the name of a local package, the local package is preferentially used. This motivates the default settings:r …r}r(h=XÒ, in the sense that if other packages (including external ones from Hackage) depend on a package with the name of a local package, the local package is preferentially used. This motivates the default settings:hDNhRNhShh>jÿubeubj)r}r(h=X2packages: ./*.cabal optional-packages: ./*/*.cabalh>j hDhEhFjhH}r(jjhM]hL]hJ]hK]hP]uhRMïhShhT]rh]X2packages: ./*.cabal optional-packages: ./*/*.cabalr…r}r(h=Uh>jubaubhp)r}r(h=X—...any package can be vendored simply by making a checkout in the top-level project directory, as might be seen in this hypothetical directory layout::h>j hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMòhShhT]rh]X–…any package can be vendored simply by making a checkout in the top-level project directory, as might be seen in this hypothetical directory layout:r…r}r(h=X–...any package can be vendored simply by making a checkout in the top-level project directory, as might be seen in this hypothetical directory layout:hDNhRNhShh>jubaubj)r}r(h=XUfoo.cabal foo-helper/ # local package unix/ # vendored external packageh>j hDhEhFjhH}r (jjhM]hL]hJ]hK]hP]uhRMöhShhT]r!h]XUfoo.cabal foo-helper/ # local package unix/ # vendored external packager"…r#}r$(h=Uh>jubaubhp)r%}r&(h=XOAll of these options support globs. ``cabal v2-build`` has its own glob format:h>j hDhEhFhthH}r'(hJ]hK]hL]hM]hP]uhRMúhShhT]r((h]X$All of these options support globs. r)…r*}r+(h=X$All of these options support globs. hDNhRNhShh>j%ubh–)r,}r-(h=X``cabal v2-build``hH}r.(hJ]hK]hL]hM]hP]uh>j%hT]r/h]Xcabal v2-buildr0…r1}r2(h=Xcabal v2-buildh>j,ubahFhžubh]X has its own glob format:r3…r4}r5(h=X has its own glob format:hDNhRNhShh>j%ubeubh‚)r6}r7(h=Uh>j hDhEhFh…hH}r8(h‡X-hM]hL]hJ]hK]hP]uhRMýhShhT]r9(h‰)r:}r;(h=X_Anywhere in a path, as many times as you like, you can specify an asterisk ``*`` wildcard. E.g., ``*/*.cabal`` matches all ``.cabal`` files in all immediate subdirectories. Like in glob(7), asterisks do not match hidden files unless there is an explicit period, e.g., ``.*/foo.cabal`` will match ``.private/foo.cabal`` (but ``*/foo.cabal`` will not). h>j6hDhEhFhŒhH}r<(hJ]hK]hL]hM]hP]uhRNhShhT]r=hp)r>}r?(h=X^Anywhere in a path, as many times as you like, you can specify an asterisk ``*`` wildcard. E.g., ``*/*.cabal`` matches all ``.cabal`` files in all immediate subdirectories. Like in glob(7), asterisks do not match hidden files unless there is an explicit period, e.g., ``.*/foo.cabal`` will match ``.private/foo.cabal`` (but ``*/foo.cabal`` will not).h>j:hDhEhFhthH}r@(hJ]hK]hL]hM]hP]uhRMýhT]rA(h]XKAnywhere in a path, as many times as you like, you can specify an asterisk rB…rC}rD(h=XKAnywhere in a path, as many times as you like, you can specify an asterisk h>j>ubh–)rE}rF(h=X``*``hH}rG(hJ]hK]hL]hM]hP]uh>j>hT]rHh]X*…rI}rJ(h=X*h>jEubahFhžubh]X wildcard. E.g., rK…rL}rM(h=X wildcard. E.g., h>j>ubh–)rN}rO(h=X ``*/*.cabal``hH}rP(hJ]hK]hL]hM]hP]uh>j>hT]rQh]X */*.cabalrR…rS}rT(h=X */*.cabalh>jNubahFhžubh]X matches all rU…rV}rW(h=X matches all h>j>ubh–)rX}rY(h=X ``.cabal``hH}rZ(hJ]hK]hL]hM]hP]uh>j>hT]r[h]X.cabalr\…r]}r^(h=X.cabalh>jXubahFhžubh]X‡ files in all immediate subdirectories. Like in glob(7), asterisks do not match hidden files unless there is an explicit period, e.g., r_…r`}ra(h=X‡ files in all immediate subdirectories. Like in glob(7), asterisks do not match hidden files unless there is an explicit period, e.g., h>j>ubh–)rb}rc(h=X``.*/foo.cabal``hH}rd(hJ]hK]hL]hM]hP]uh>j>hT]reh]X .*/foo.cabalrf…rg}rh(h=X .*/foo.cabalh>jbubahFhžubh]X will match ri…rj}rk(h=X will match h>j>ubh–)rl}rm(h=X``.private/foo.cabal``hH}rn(hJ]hK]hL]hM]hP]uh>j>hT]roh]X.private/foo.cabalrp…rq}rr(h=X.private/foo.cabalh>jlubahFhžubh]X (but rs…rt}ru(h=X (but h>j>ubh–)rv}rw(h=X``*/foo.cabal``hH}rx(hJ]hK]hL]hM]hP]uh>j>hT]ryh]X */foo.cabalrz…r{}r|(h=X */foo.cabalh>jvubahFhžubh]X will not).r}…r~}r(h=X will not).h>j>ubeubaubh‰)r€}r(h=X›You can use braces to specify specific directories; e.g., ``{vendor,pkgs}/*.cabal`` matches all Cabal files in the ``vendor`` and ``pkgs`` subdirectories. h>j6hDhEhFhŒhH}r‚(hJ]hK]hL]hM]hP]uhRNhShhT]rƒhp)r„}r…(h=XšYou can use braces to specify specific directories; e.g., ``{vendor,pkgs}/*.cabal`` matches all Cabal files in the ``vendor`` and ``pkgs`` subdirectories.h>j€hDhEhFhthH}r†(hJ]hK]hL]hM]hP]uhRMhT]r‡(h]X:You can use braces to specify specific directories; e.g., rˆ…r‰}rŠ(h=X:You can use braces to specify specific directories; e.g., h>j„ubh–)r‹}rŒ(h=X``{vendor,pkgs}/*.cabal``hH}r(hJ]hK]hL]hM]hP]uh>j„hT]rŽh]X{vendor,pkgs}/*.cabalr…r}r‘(h=X{vendor,pkgs}/*.cabalh>j‹ubahFhžubh]X matches all Cabal files in the r’…r“}r”(h=X matches all Cabal files in the h>j„ubh–)r•}r–(h=X ``vendor``hH}r—(hJ]hK]hL]hM]hP]uh>j„hT]r˜h]Xvendorr™…rš}r›(h=Xvendorh>j•ubahFhžubh]X and rœ…r}rž(h=X and h>j„ubh–)rŸ}r (h=X``pkgs``hH}r¡(hJ]hK]hL]hM]hP]uh>j„hT]r¢h]Xpkgsr£…r¤}r¥(h=Xpkgsh>jŸubahFhžubh]X subdirectories.r¦…r§}r¨(h=X subdirectories.h>j„ubeubaubeubhp)r©}rª(h=X4Formally, the format described by the following BNF:r«h>j hDhEhFhthH}r¬(hJ]hK]hL]hM]hP]uhRMhShhT]r­h]X4Formally, the format described by the following BNF:r®…r¯}r°(h=j«hDNhRNhShh>j©ubaubjý)r±}r²(h=Uh>j hDhEhFjhH}r³(hM]hL]hJ]hK]hP]jUindex-1r´uhRNhShhT]ubj)rµ}r¶(h=X/convert globbing grammar to proper ABNF_ syntaxr·h>j hDhEj}hFj hH}r¸(j Xnix-local-build:index-1r¹hM]rºj´ahL]hJ]hK]r»jahP]uhRM hShj}r¼j´j±shT]r½(hV)r¾}r¿(h=XTodorÀh>jµhDhEhFhZhH}rÁ(hJ]hK]hL]hM]hP]uhRM hT]rÂh]XTodorÃ…rÄ}rÅ(h=Uh>j¾ubaubhp)rÆ}rÇ(h=j·h>jµhDhEhFhthH}rÈ(hJ]hK]hL]hM]hP]uhRM hT]rÉ(h]X#convert globbing grammar to proper rÊ…rË}rÌ(h=X#convert globbing grammar to proper rÍh>jÆubjæ)rÎ}rÏ(h=XABNF_rÐUresolvedrÑKh>jÆhFjïhH}rÒ(UnameXABNFrÓjêX#https://tools.ietf.org/html/rfc5234rÔhM]hL]hJ]hK]hP]uhT]rÕh]XABNFrÖ…r×}rØ(h=jÓh>jÎubaubh]X syntaxrÙ…rÚ}rÛ(h=X syntaxrÜh>jÆubeubeubj)rÝ}rÞ(h=XâFilePathGlob ::= FilePathRoot FilePathGlobRel FilePathRoot ::= {- empty -} # relative to cabal.project | "/" # Unix root | [a-zA-Z] ":" [/\\] # Windows root | "~" # home directory FilePathGlobRel ::= Glob "/" FilePathGlobRel # Unix directory | Glob "\\" FilePathGlobRel # Windows directory | Glob # file | {- empty -} # trailing slash Glob ::= GlobPiece * GlobPiece ::= "*" # wildcard | [^*{},/\\] * # literal string | "\\" [*{},] # escaped reserved character | "{" Glob "," ... "," Glob "}" # union (match any of these)h>j hDhEhFjhH}rß(Ulinenosrà‰UlanguageráXabnfjjhM]hL]hJ]Uhighlight_argsrâ}hK]hP]uhRM hShhT]rãh]XâFilePathGlob ::= FilePathRoot FilePathGlobRel FilePathRoot ::= {- empty -} # relative to cabal.project | "/" # Unix root | [a-zA-Z] ":" [/\\] # Windows root | "~" # home directory FilePathGlobRel ::= Glob "/" FilePathGlobRel # Unix directory | Glob "\\" FilePathGlobRel # Windows directory | Glob # file | {- empty -} # trailing slash Glob ::= GlobPiece * GlobPiece ::= "*" # wildcard | [^*{},/\\] * # literal string | "\\" [*{},] # escaped reserved character | "{" Glob "," ... "," Glob "}" # union (match any of these)rä…rå}ræ(h=Uh>jÝubaubh?)rç}rè(h=Uh>j hDhEhFhGhH}ré(hJ]hK]hL]hM]rêU9specifying-packages-from-remote-version-control-locationsrëahP]rìh&auhRM hShhT]rí(hV)rî}rï(h=X9Specifying Packages from Remote Version Control Locationsrðh>jçhDhEhFhZhH}rñ(hJ]hK]hL]hM]hP]uhRM hShhT]ròh]X9Specifying Packages from Remote Version Control Locationsró…rô}rõ(h=jðhDNhRNhShh>jîubaubhp)rö}r÷(h=XªStarting with Cabal 2.4, there is now a stanza ``source-repository-package`` for specifying packages from an external version control which supports the following fields:h>jçhDhEhFhthH}rø(hJ]hK]hL]hM]hP]uhRM"hShhT]rù(h]X/Starting with Cabal 2.4, there is now a stanza rú…rû}rü(h=X/Starting with Cabal 2.4, there is now a stanza hDNhRNhShh>jöubh–)rý}rþ(h=X``source-repository-package``hH}rÿ(hJ]hK]hL]hM]hP]uh>jöhT]rh]Xsource-repository-packager…r}r(h=Xsource-repository-packageh>jýubahFhžubh]X^ for specifying packages from an external version control which supports the following fields:r…r}r(h=X^ for specifying packages from an external version control which supports the following fields:hDNhRNhShh>jöubeubh‚)r}r(h=Uh>jçhDhEhFh…hH}r (h‡X-hM]hL]hJ]hK]hP]uhRM&hShhT]r (h‰)r }r (h=X#:pkg-field:`source-repository:type`r h>jhDhEhFhŒhH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rhp)r}r(h=j h>j hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM&hT]rjä)r}r(h=j h>jhDhEhFjçhH}r(UreftypeX pkg-fieldjéˆjêXtypeU refdomainXcabalrhM]hL]U refexplicit‰hJ]hK]hP]jìjíUcabal:pkg-sectionrXsource-repositoryuhRM&hT]rh–)r}r(h=Xsource-repository:typehH}r(hJ]hK]r(jôjXcabal-pkg-fieldrehL]hM]hP]uh>jhT]rh]Xsource-repository:typer …r!}r"(h=Uh>jubahFhžubaubaubaubh‰)r#}r$(h=X':pkg-field:`source-repository:location`r%h>jhDhEhFhŒhH}r&(hJ]hK]hL]hM]hP]uhRNhShhT]r'hp)r(}r)(h=j%h>j#hDhEhFhthH}r*(hJ]hK]hL]hM]hP]uhRM'hT]r+jä)r,}r-(h=j%h>j(hDhEhFjçhH}r.(UreftypeX pkg-fieldjéˆjêXlocationU refdomainXcabalr/hM]hL]U refexplicit‰hJ]hK]hP]jìjíjXsource-repositoryuhRM'hT]r0h–)r1}r2(h=Xsource-repository:locationhH}r3(hJ]hK]r4(jôj/Xcabal-pkg-fieldr5ehL]hM]hP]uh>j,hT]r6h]Xsource-repository:locationr7…r8}r9(h=Uh>j1ubahFhžubaubaubaubh‰)r:}r;(h=X":pkg-field:`source-repository:tag`r<h>jhDhEhFhŒhH}r=(hJ]hK]hL]hM]hP]uhRNhShhT]r>hp)r?}r@(h=j<h>j:hDhEhFhthH}rA(hJ]hK]hL]hM]hP]uhRM(hT]rBjä)rC}rD(h=j<h>j?hDhEhFjçhH}rE(UreftypeX pkg-fieldjéˆjêXtagU refdomainXcabalrFhM]hL]U refexplicit‰hJ]hK]hP]jìjíjXsource-repositoryuhRM(hT]rGh–)rH}rI(h=Xsource-repository:taghH}rJ(hJ]hK]rK(jôjFXcabal-pkg-fieldrLehL]hM]hP]uh>jChT]rMh]Xsource-repository:tagrN…rO}rP(h=Uh>jHubahFhžubaubaubaubh‰)rQ}rR(h=X&:pkg-field:`source-repository:subdir` h>jhDhEhFhŒhH}rS(hJ]hK]hL]hM]hP]uhRNhShhT]rThp)rU}rV(h=X%:pkg-field:`source-repository:subdir`rWh>jQhDhEhFhthH}rX(hJ]hK]hL]hM]hP]uhRM)hT]rYjä)rZ}r[(h=jWh>jUhDhEhFjçhH}r\(UreftypeX pkg-fieldjéˆjêXsubdirU refdomainXcabalr]hM]hL]U refexplicit‰hJ]hK]hP]jìjíjXsource-repositoryuhRM)hT]r^h–)r_}r`(h=Xsource-repository:subdirhH}ra(hJ]hK]rb(jôj]Xcabal-pkg-fieldrcehL]hM]hP]uh>jZhT]rdh]Xsource-repository:subdirre…rf}rg(h=Uh>j_ubahFhžubaubaubaubeubhp)rh}ri(h=X A simple example is shown below:rjh>jçhDhEhFhthH}rk(hJ]hK]hL]hM]hP]uhRM+hShhT]rlh]X A simple example is shown below:rm…rn}ro(h=jjhDNhRNhShh>jhubaubj)rp}rq(h=X5packages: . source-repository-package type: git location: https://github.com/hvr/HsYAML.git tag: e70cf0c171c9a586b62b3f75d72f1591e4e6aaa1 source-repository-package type: git location: https://github.com/well-typed/cborg tag: 3d274c14ca3077c3a081ba7ad57c5182da65c8c1 subdir: cborgh>jçhDhEhFjhH}rr(jà‰jáXcabaljjhM]hL]hJ]jâ}hK]hP]uhRM-hShhT]rsh]X5packages: . source-repository-package type: git location: https://github.com/hvr/HsYAML.git tag: e70cf0c171c9a586b62b3f75d72f1591e4e6aaa1 source-repository-package type: git location: https://github.com/well-typed/cborg tag: 3d274c14ca3077c3a081ba7ad57c5182da65c8c1 subdir: cborgrt…ru}rv(h=Uh>jpubaubeubeubh?)rw}rx(h=Uh>jh hDhEhFhGhH}ry(hJ]hK]hL]hM]rzUglobal-configuration-optionsr{ahP]r|h/auhRM=hShhT]r}(hV)r~}r(h=XGlobal configuration optionsr€h>jwhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRM=hShhT]r‚h]XGlobal configuration optionsrƒ…r„}r…(h=j€hDNhRNhShh>j~ubaubhp)r†}r‡(h=XgThe following top-level configuration options are not specific to any package, and thus apply globally:rˆh>jwhDhEhFhthH}r‰(hJ]hK]hL]hM]hP]uhRM?hShhT]rŠh]XgThe following top-level configuration options are not specific to any package, and thus apply globally:r‹…rŒ}r(h=jˆhDNhRNhShh>j†ubaubj7)rŽ}r(h=Uh>jwhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r‘}r’(h=Uh>jwhDhEhFj?hH}r“(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr”jEj”uhRNhShhT]r•(jG)r–}r—(h=X verbose: nath>j‘hDhEhFjJhH}r˜(hM]r™Xcfg-field-verboseršahL]hJ]hK]hP]jN‰uhRNhShhT]r›(j7)rœ}r(h=Uh>j–hDhEhFj:hH}rž(hM]hL]hJ]hK]hP]Uentries]rŸ(jTXverbose ; cabal project optionjšUNtr auhRNhShhT]ubjV)r¡}r¢(h=Xverboser£h>j–hDhEhFjZhH}r¤(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¥h]Xverboser¦…r§}r¨(h=UhDNhRNhShh>j¡ubaubj`)r©}rª(h=jch>j–hDhEhFjdhH}r«(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¬h]X: r­…r®}r¯(h=UhDNhRNhShh>j©ubaubjj)r°}r±(h=Xnath>j–hDhEhFjmhH}r²(jjhM]hL]hJ]hK]hP]uhRNhShhT]r³h]Xnatr´…rµ}r¶(h=UhDNhRNhShh>j°ubaubeubjG)r·}r¸(h=X--verbose=n, -vnh>j‘hDhEhFjJhH}r¹(hM]rºXcfg-flag---verboser»ahL]hJ]hK]hP]jN‰uhRNhShhT]r¼(j7)r½}r¾(h=Uh>j·hDhEhFj:hH}r¿(hM]hL]hJ]hK]hP]Uentries]rÀ(jTX--verbose; cabal project optionj»UNtrÁauhRNhShhT]ubjV)rÂ}rÃ(h=X --verboserÄh>j·hDhEhFjZhH}rÅ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÆh]X --verboserÇ…rÈ}rÉ(h=UhDNhRNhShh>jÂubaubj`)rÊ}rË(h=X=nh>j·hDhEhFjdhH}rÌ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÍh]X=nrÎ…rÏ}rÐ(h=UhDNhRNhShh>jÊubaubjV)rÑ}rÒ(h=U, rÓh>j·hDhEhFjZhH}rÔ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÕh]X, rÖ…r×}rØ(h=UhDNhRNhShh>jÑubaubjV)rÙ}rÚ(h=X-vnh>j·hDhEhFjZhH}rÛ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÜh]X-vnrÝ…rÞ}rß(h=UhDNhRNhShh>jÙubaubj`)rà}rá(h=U h>j·hDhEhFjdhH}râ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rãh]X …rä}rå(h=UhDNhRNhShh>jàubaubeubjs)ræ}rç(h=Uh>j‘hDhEhFjvhH}rè(hJ]hK]hL]hM]hP]uhRNhShhT]ré(jy)rê}rë(h=Uh>jæhDhEhFj|hH}rì(hJ]hK]hL]hM]hP]uhRNhShhT]ríj)rî}rï(h=UhH}rð(hJ]hK]hL]hM]hP]uh>jêhT]rñ(j„)rò}ró(h=X Default valueh>jîhDhEhFj‡hH}rô(hJ]hK]hL]hM]hP]uhRKhT]rõh]X Default valuerö…r÷}rø(h=Uh>jòubaubj)rù}rú(h=UhH}rû(hJ]hK]hL]hM]hP]uh>jîhT]rühp)rý}rþ(h=X1hH}rÿ(hJ]hK]hL]hM]hP]uh>jùhT]rh]X1…r}r(h=X1hDNhRNhShh>jýubahFhtubahFjubehFjžubaubhp)r}r(h=XJControl the verbosity of ``cabal`` commands, valid values are from 0 to 3.h>jæhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMIhShhT]r(h]XControl the verbosity of r…r}r (h=XControl the verbosity of hDNhRNhShh>jubh–)r }r (h=X ``cabal``hH}r (hJ]hK]hL]hM]hP]uh>jhT]r h]Xcabalr…r}r(h=Xcabalh>j ubahFhžubh]X( commands, valid values are from 0 to 3.r…r}r(h=X( commands, valid values are from 0 to 3.hDNhRNhShh>jubeubhp)r}r(h=XbThe command line variant of this field is ``--verbose=2``; a short form ``-v2`` is also supported.h>jæhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMLhShhT]r(h]X*The command line variant of this field is r…r}r(h=X*The command line variant of this field is hDNhRNhShh>jubh–)r}r(h=X``--verbose=2``hH}r(hJ]hK]hL]hM]hP]uh>jhT]rh]X --verbose=2r…r }r!(h=X --verbose=2h>jubahFhžubh]X; a short form r"…r#}r$(h=X; a short form hDNhRNhShh>jubh–)r%}r&(h=X``-v2``hH}r'(hJ]hK]hL]hM]hP]uh>jhT]r(h]X-v2r)…r*}r+(h=X-v2h>j%ubahFhžubh]X is also supported.r,…r-}r.(h=X is also supported.hDNhRNhShh>jubeubeubeubj7)r/}r0(h=Uh>jwhDhEhFj:hH}r1(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r2}r3(h=Uh>jwhDhEhFj?hH}r4(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr5jEj5uhRNhShhT]r6(jG)r7}r8(h=Xjobs: nat or $ncpush>j2hDhEhFjJhH}r9(hM]r:Xcfg-field-jobsr;ahL]hJ]hK]hP]jN‰uhRNhShhT]r<(j7)r=}r>(h=Uh>j7hDhEhFj:hH}r?(hM]hL]hJ]hK]hP]Uentries]r@(jTXjobs ; cabal project optionj;UNtrAauhRNhShhT]ubjV)rB}rC(h=XjobsrDh>j7hDhEhFjZhH}rE(jjhM]hL]hJ]hK]hP]uhRNhShhT]rFh]XjobsrG…rH}rI(h=UhDNhRNhShh>jBubaubj`)rJ}rK(h=jch>j7hDhEhFjdhH}rL(jjhM]hL]hJ]hK]hP]uhRNhShhT]rMh]X: rN…rO}rP(h=UhDNhRNhShh>jJubaubjj)rQ}rR(h=X nat or $ncpush>j7hDhEhFjmhH}rS(jjhM]hL]hJ]hK]hP]uhRNhShhT]rTh]X nat or $ncpusrU…rV}rW(h=UhDNhRNhShh>jQubaubeubjG)rX}rY(h=X--jobs=n, -jn, --jobs=$ncpush>j2hDhEhFjJhH}rZ(hM]r[Xcfg-flag---jobsr\ahL]hJ]hK]hP]jN‰uhRNhShhT]r](j7)r^}r_(h=Uh>jXhDhEhFj:hH}r`(hM]hL]hJ]hK]hP]Uentries]ra(jTX--jobs; cabal project optionj\UNtrbauhRNhShhT]ubjV)rc}rd(h=X--jobsreh>jXhDhEhFjZhH}rf(jjhM]hL]hJ]hK]hP]uhRNhShhT]rgh]X--jobsrh…ri}rj(h=UhDNhRNhShh>jcubaubj`)rk}rl(h=X=nh>jXhDhEhFjdhH}rm(jjhM]hL]hJ]hK]hP]uhRNhShhT]rnh]X=nro…rp}rq(h=UhDNhRNhShh>jkubaubjV)rr}rs(h=jÓh>jXhDhEhFjZhH}rt(jjhM]hL]hJ]hK]hP]uhRNhShhT]ruh]X, rv…rw}rx(h=UhDNhRNhShh>jrubaubjV)ry}rz(h=X-jnh>jXhDhEhFjZhH}r{(jjhM]hL]hJ]hK]hP]uhRNhShhT]r|h]X-jnr}…r~}r(h=UhDNhRNhShh>jyubaubj`)r€}r(h=U h>jXhDhEhFjdhH}r‚(jjhM]hL]hJ]hK]hP]uhRNhShhT]rƒh]X …r„}r…(h=UhDNhRNhShh>j€ubaubjV)r†}r‡(h=jÓh>jXhDhEhFjZhH}rˆ(jjhM]hL]hJ]hK]hP]uhRNhShhT]r‰h]X, rŠ…r‹}rŒ(h=UhDNhRNhShh>j†ubaubjV)r}rŽ(h=X--jobsh>jXhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X--jobsr‘…r’}r“(h=UhDNhRNhShh>jubaubj`)r”}r•(h=X=$ncpush>jXhDhEhFjdhH}r–(jjhM]hL]hJ]hK]hP]uhRNhShhT]r—h]X=$ncpusr˜…r™}rš(h=UhDNhRNhShh>j”ubaubeubjs)r›}rœ(h=Uh>j2hDhEhFjvhH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rž(jy)rŸ}r (h=Uh>j›hDhEhFj|hH}r¡(hJ]hK]hL]hM]hP]uhRNhShhT]r¢j)r£}r¤(h=UhH}r¥(hJ]hK]hL]hM]hP]uh>jŸhT]r¦(j„)r§}r¨(h=X Default valueh>j£hDhEhFj‡hH}r©(hJ]hK]hL]hM]hP]uhRKhT]rªh]X Default valuer«…r¬}r­(h=Uh>j§ubaubj)r®}r¯(h=UhH}r°(hJ]hK]hL]hM]hP]uh>j£hT]r±hp)r²}r³(h=X1hH}r´(hJ]hK]hL]hM]hP]uh>j®hT]rµh]X1…r¶}r·(h=X1hDNhRNhShh>j²ubahFhtubahFjubehFjžubaubhp)r¸}r¹(h=XæRun *nat* jobs simultaneously when building. If ``$ncpus`` is specified, run the number of jobs equal to the number of CPUs. Package building is often quite parallel, so turning on parallelism can speed up build times quite a bit!h>j›hDhEhFhthH}rº(hJ]hK]hL]hM]hP]uhRMUhShhT]r»(h]XRun r¼…r½}r¾(h=XRun hDNhRNhShh>j¸ubj))r¿}rÀ(h=X*nat*hH}rÁ(hJ]hK]hL]hM]hP]uh>j¸hT]rÂh]XnatrÃ…rÄ}rÅ(h=Xnath>j¿ubahFj1ubh]X' jobs simultaneously when building. If rÆ…rÇ}rÈ(h=X' jobs simultaneously when building. If hDNhRNhShh>j¸ubh–)rÉ}rÊ(h=X ``$ncpus``hH}rË(hJ]hK]hL]hM]hP]uh>j¸hT]rÌh]X$ncpusrÍ…rÎ}rÏ(h=X$ncpush>jÉubahFhžubh]X¬ is specified, run the number of jobs equal to the number of CPUs. Package building is often quite parallel, so turning on parallelism can speed up build times quite a bit!rÐ…rÑ}rÒ(h=X¬ is specified, run the number of jobs equal to the number of CPUs. Package building is often quite parallel, so turning on parallelism can speed up build times quite a bit!hDNhRNhShh>j¸ubeubhp)rÓ}rÔ(h=XŸThe command line variant of this field is ``--jobs=2``; a short form ``-j2`` is also supported; a bare ``--jobs`` or ``-j`` is equivalent to ``--jobs=$ncpus``.h>j›hDhEhFhthH}rÕ(hJ]hK]hL]hM]hP]uhRMZhShhT]rÖ(h]X*The command line variant of this field is r×…rØ}rÙ(h=X*The command line variant of this field is hDNhRNhShh>jÓubh–)rÚ}rÛ(h=X ``--jobs=2``hH}rÜ(hJ]hK]hL]hM]hP]uh>jÓhT]rÝh]X--jobs=2rÞ…rß}rà(h=X--jobs=2h>jÚubahFhžubh]X; a short form rá…râ}rã(h=X; a short form hDNhRNhShh>jÓubh–)rä}rå(h=X``-j2``hH}ræ(hJ]hK]hL]hM]hP]uh>jÓhT]rçh]X-j2rè…ré}rê(h=X-j2h>jäubahFhžubh]X is also supported; a bare rë…rì}rí(h=X is also supported; a bare hDNhRNhShh>jÓubh–)rî}rï(h=X ``--jobs``hH}rð(hJ]hK]hL]hM]hP]uh>jÓhT]rñh]X--jobsrò…ró}rô(h=X--jobsh>jîubahFhžubh]X or rõ…rö}r÷(h=X or hDNhRNhShh>jÓubh–)rø}rù(h=X``-j``hH}rú(hJ]hK]hL]hM]hP]uh>jÓhT]rûh]X-jrü…rý}rþ(h=X-jh>jøubahFhžubh]X is equivalent to rÿ…r}r(h=X is equivalent to hDNhRNhShh>jÓubh–)r}r(h=X``--jobs=$ncpus``hH}r(hJ]hK]hL]hM]hP]uh>jÓhT]rh]X --jobs=$ncpusr…r}r(h=X --jobs=$ncpush>jubahFhžubh]X.…r }r (h=X.hDNhRNhShh>jÓubeubeubeubj7)r }r (h=Uh>jwhDhEhFj:hH}r (hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r}r(h=Uh>jwhDhEhFj?hH}r(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrjEjuhRNhShhT]r(jG)r}r(h=Xkeep-going: booleanh>jhDhEhFjJhH}r(hM]rXcfg-field-keep-goingrahL]hJ]hK]hP]jN‰uhRNhShhT]r(j7)r}r(h=Uh>jhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]r(jTX!keep-going ; cabal project optionjUNtrauhRNhShhT]ubjV)r}r(h=X keep-goingr h>jhDhEhFjZhH}r!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r"h]X keep-goingr#…r$}r%(h=UhDNhRNhShh>jubaubj`)r&}r'(h=jch>jhDhEhFjdhH}r((jjhM]hL]hJ]hK]hP]uhRNhShhT]r)h]X: r*…r+}r,(h=UhDNhRNhShh>j&ubaubjj)r-}r.(h=Xbooleanh>jhDhEhFjmhH}r/(jjhM]hL]hJ]hK]hP]uhRNhShhT]r0h]Xbooleanr1…r2}r3(h=UhDNhRNhShh>j-ubaubeubjG)r4}r5(h=X --keep-goingr6h>jhDhEhFjJhH}r7(hM]r8Xcfg-flag---keep-goingr9ahL]hJ]hK]hP]jN‰uhRNhShhT]r:(j7)r;}r<(h=Uh>j4hDhEhFj:hH}r=(hM]hL]hJ]hK]hP]Uentries]r>(jTX"--keep-going; cabal project optionj9UNtr?auhRNhShhT]ubjV)r@}rA(h=j6h>j4hDhEhFjZhH}rB(jjhM]hL]hJ]hK]hP]uhRNhShhT]rCh]X --keep-goingrD…rE}rF(h=UhDNhRNhShh>j@ubaubj`)rG}rH(h=U h>j4hDhEhFjdhH}rI(jjhM]hL]hJ]hK]hP]uhRNhShhT]rJh]X …rK}rL(h=UhDNhRNhShh>jGubaubeubjs)rM}rN(h=Uh>jhDhEhFjvhH}rO(hJ]hK]hL]hM]hP]uhRNhShhT]rP(jy)rQ}rR(h=Uh>jMhDhEhFj|hH}rS(hJ]hK]hL]hM]hP]uhRNhShhT]rTj)rU}rV(h=UhH}rW(hJ]hK]hL]hM]hP]uh>jQhT]rX(j„)rY}rZ(h=X Default valueh>jUhDhEhFj‡hH}r[(hJ]hK]hL]hM]hP]uhRKhT]r\h]X Default valuer]…r^}r_(h=Uh>jYubaubj)r`}ra(h=UhH}rb(hJ]hK]hL]hM]hP]uh>jUhT]rchp)rd}re(h=XFalsehH}rf(hJ]hK]hL]hM]hP]uh>j`hT]rgh]XFalserh…ri}rj(h=XFalsehDNhRNhShh>jdubahFhtubahFjubehFjžubaubhp)rk}rl(h=XLIf true, after a build failure, continue to build other unaffected packages.rmh>jMhDhEhFhthH}rn(hJ]hK]hL]hM]hP]uhRMdhShhT]roh]XLIf true, after a build failure, continue to build other unaffected packages.rp…rq}rr(h=jmhDNhRNhShh>jkubaubhp)rs}rt(h=X;The command line variant of this field is ``--keep-going``.h>jMhDhEhFhthH}ru(hJ]hK]hL]hM]hP]uhRMghShhT]rv(h]X*The command line variant of this field is rw…rx}ry(h=X*The command line variant of this field is hDNhRNhShh>jsubh–)rz}r{(h=X``--keep-going``hH}r|(hJ]hK]hL]hM]hP]uh>jshT]r}h]X --keep-goingr~…r}r€(h=X --keep-goingh>jzubahFhžubh]X.…r}r‚(h=X.hDNhRNhShh>jsubeubeubeubj7)rƒ}r„(h=Uh>jwhDhEhFj:hH}r…(hM]hL]hJ]hK]hP]Uentries]r†(jTX#command line option; --builddir=DIRUcmdoption-builddirr‡UNtrˆauhRNhShhT]ubj<)r‰}rŠ(h=Uh>jwhDhEhFj?hH}r‹(jA‰jBXstdhM]hL]hJ]hK]hP]jCXoptionrŒjEjŒuhRNhShhT]r(jG)rŽ}r(h=X--builddir=DIRh>j‰hDhEhFjJhH}r(Uallnamesr‘]r’X --builddirr“ahM]r”j‡ahL]hJ]hK]hP]r•h"ajN‰uhRMrhShhT]r–(jV)r—}r˜(h=j“h>jŽhDhEhFjZhH}r™(jjhM]hL]hJ]hK]hP]uhRMrhShhT]ršh]X --builddirr›…rœ}r(h=UhDNhRNhShh>j—ubaubj`)rž}rŸ(h=X=DIRh>jŽhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRMrhShhT]r¡h]X=DIRr¢…r£}r¤(h=UhDNhRNhShh>jžubaubeubjs)r¥}r¦(h=Uh>j‰hDhEhFjvhH}r§(hJ]hK]hL]hM]hP]uhRMrhShhT]r¨(hp)r©}rª(h=XSpecifies the name of the directory where build products for build will be stored; defaults to ``dist-newstyle``. If a relative name is specified, this directory is resolved relative to the root of the project (i.e., where the ``cabal.project`` file lives.)h>j¥hDhEhFhthH}r«(hJ]hK]hL]hM]hP]uhRMkhShhT]r¬(h]X_Specifies the name of the directory where build products for build will be stored; defaults to r­…r®}r¯(h=X_Specifies the name of the directory where build products for build will be stored; defaults to hDNhRNhShh>j©ubh–)r°}r±(h=X``dist-newstyle``hH}r²(hJ]hK]hL]hM]hP]uh>j©hT]r³h]X dist-newstyler´…rµ}r¶(h=X dist-newstyleh>j°ubahFhžubh]Xt. If a relative name is specified, this directory is resolved relative to the root of the project (i.e., where the r·…r¸}r¹(h=Xt. If a relative name is specified, this directory is resolved relative to the root of the project (i.e., where the hDNhRNhShh>j©ubh–)rº}r»(h=X``cabal.project``hH}r¼(hJ]hK]hL]hM]hP]uh>j©hT]r½h]X cabal.projectr¾…r¿}rÀ(h=X cabal.projecth>jºubahFhžubh]X file lives.)rÁ…rÂ}rÃ(h=X file lives.)hDNhRNhShh>j©ubeubhp)rÄ}rÅ(h=X=This option cannot be specified via a ``cabal.project`` file.h>j¥hDhEhFhthH}rÆ(hJ]hK]hL]hM]hP]uhRMqhShhT]rÇ(h]X&This option cannot be specified via a rÈ…rÉ}rÊ(h=X&This option cannot be specified via a hDNhRNhShh>jÄubh–)rË}rÌ(h=X``cabal.project``hH}rÍ(hJ]hK]hL]hM]hP]uh>jÄhT]rÎh]X cabal.projectrÏ…rÐ}rÑ(h=X cabal.projecth>jËubahFhžubh]X file.rÒ…rÓ}rÔ(h=X file.hDNhRNhShh>jÄubeubeubeubjý)rÕ}rÖ(h=X.. _cmdoption-project-file:h>jwhDhEhFjhH}r×(hJ]hK]hL]hM]rØUcmdoption-project-filerÙahP]rÚh auhRMshShhT]ubj7)rÛ}rÜ(h=Uh>jwhDhEhFj:hH}rÝ(hM]hL]hJ]hK]hP]Uentries]rÞ(jTX(command line option; --project-file=FILEUid1rßUNtràauhRNhShhT]ubj<)rá}râ(h=Uh>jwhDhEhFj?hH}rã(jA‰jBXstdhM]hL]hJ]hK]hP]jCXoptionräjEjäuhRNhShhT]rå(jG)ræ}rç(h=X--project-file=FILEh>jáhDhEhFjJhH}rè(j‘]réX--project-filerêahM]rëjßahL]hJ]hK]hP]rìhajN‰uhRM„hShhT]rí(jV)rî}rï(h=jêh>jæhDhEhFjZhH}rð(jjhM]hL]hJ]hK]hP]uhRM„hShhT]rñh]X--project-filerò…ró}rô(h=UhDNhRNhShh>jîubaubj`)rõ}rö(h=X=FILEh>jæhDhEhFjdhH}r÷(jjhM]hL]hJ]hK]hP]uhRM„hShhT]røh]X=FILErù…rú}rû(h=UhDNhRNhShh>jõubaubeubjs)rü}rý(h=Uh>jáhDhEhFjvhH}rþ(hJ]hK]hL]hM]hP]uhRM„hShhT]rÿ(hp)r}r(h=X±Specifies the name of the project file used to specify the rest of the top-level configuration; defaults to ``cabal.project``. This name not only specifies the name of the main project file, but also the auxiliary project files ``cabal.project.freeze`` and ``cabal.project.local``; for example, if you specify ``--project-file=my.project``, then the other files that will be probed are ``my.project.freeze`` and ``my.project.local``.h>jühDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMvhShhT]r(h]XlSpecifies the name of the project file used to specify the rest of the top-level configuration; defaults to r…r}r(h=XlSpecifies the name of the project file used to specify the rest of the top-level configuration; defaults to hDNhRNhShh>jubh–)r}r(h=X``cabal.project``hH}r (hJ]hK]hL]hM]hP]uh>jhT]r h]X cabal.projectr …r }r (h=X cabal.projecth>jubahFhžubh]Xg. This name not only specifies the name of the main project file, but also the auxiliary project files r…r}r(h=Xg. This name not only specifies the name of the main project file, but also the auxiliary project files hDNhRNhShh>jubh–)r}r(h=X``cabal.project.freeze``hH}r(hJ]hK]hL]hM]hP]uh>jhT]rh]Xcabal.project.freezer…r}r(h=Xcabal.project.freezeh>jubahFhžubh]X and r…r}r(h=X and hDNhRNhShh>jubh–)r}r(h=X``cabal.project.local``hH}r(hJ]hK]hL]hM]hP]uh>jhT]rh]Xcabal.project.localr…r }r!(h=Xcabal.project.localh>jubahFhžubh]X; for example, if you specify r"…r#}r$(h=X; for example, if you specify hDNhRNhShh>jubh–)r%}r&(h=X``--project-file=my.project``hH}r'(hJ]hK]hL]hM]hP]uh>jhT]r(h]X--project-file=my.projectr)…r*}r+(h=X--project-file=my.projecth>j%ubahFhžubh]X/, then the other files that will be probed are r,…r-}r.(h=X/, then the other files that will be probed are hDNhRNhShh>jubh–)r/}r0(h=X``my.project.freeze``hH}r1(hJ]hK]hL]hM]hP]uh>jhT]r2h]Xmy.project.freezer3…r4}r5(h=Xmy.project.freezeh>j/ubahFhžubh]X and r6…r7}r8(h=X and hDNhRNhShh>jubh–)r9}r:(h=X``my.project.local``hH}r;(hJ]hK]hL]hM]hP]uh>jhT]r<h]Xmy.project.localr=…r>}r?(h=Xmy.project.localh>j9ubahFhžubh]X.…r@}rA(h=X.hDNhRNhShh>jubeubhp)rB}rC(h=XîIf the specified project file is a relative path, we will look for the file relative to the current working directory, and then for the parent directory, until the project file is found or we have hit the top of the user's home directory.rDh>jühDhEhFhthH}rE(hJ]hK]hL]hM]hP]uhRM~hShhT]rFh]XðIf the specified project file is a relative path, we will look for the file relative to the current working directory, and then for the parent directory, until the project file is found or we have hit the top of the user’s home directory.rG…rH}rI(h=jDhDNhRNhShh>jBubaubhp)rJ}rK(h=X=This option cannot be specified via a ``cabal.project`` file.h>jühDhEhFhthH}rL(hJ]hK]hL]hM]hP]uhRMƒhShhT]rM(h]X&This option cannot be specified via a rN…rO}rP(h=X&This option cannot be specified via a hDNhRNhShh>jJubh–)rQ}rR(h=X``cabal.project``hH}rS(hJ]hK]hL]hM]hP]uh>jJhT]rTh]X cabal.projectrU…rV}rW(h=X cabal.projecth>jQubahFhžubh]X file.rX…rY}rZ(h=X file.hDNhRNhShh>jJubeubeubeubj7)r[}r\(h=Uh>jwhDhEhFj:hH}r](hM]hL]hJ]hK]hP]Uentries]r^(jTX$command line option; --store-dir=DIRUcmdoption-store-dirr_UNtr`auhRNhShhT]ubj<)ra}rb(h=Uh>jwhDhEhFj?hH}rc(jA‰jBXstdhM]hL]hJ]hK]hP]jCXoptionrdjEjduhRNhShhT]re(jG)rf}rg(h=X--store-dir=DIRh>jahDhEhFjJhH}rh(j‘]riX --store-dirrjahM]rkj_ahL]hJ]hK]hP]rlh ajN‰uhRMˆhShhT]rm(jV)rn}ro(h=jjh>jfhDhEhFjZhH}rp(jjhM]hL]hJ]hK]hP]uhRMˆhShhT]rqh]X --store-dirrr…rs}rt(h=UhDNhRNhShh>jnubaubj`)ru}rv(h=X=DIRh>jfhDhEhFjdhH}rw(jjhM]hL]hJ]hK]hP]uhRMˆhShhT]rxh]X=DIRry…rz}r{(h=UhDNhRNhShh>juubaubeubjs)r|}r}(h=Uh>jahDhEhFjvhH}r~(hJ]hK]hL]hM]hP]uhRMˆhShhT]rhp)r€}r(h=X@Specifies the name of the directory of the global package store.r‚h>j|hDhEhFhthH}rƒ(hJ]hK]hL]hM]hP]uhRM‡hShhT]r„h]X@Specifies the name of the directory of the global package store.r……r†}r‡(h=j‚hDNhRNhShh>j€ubaubaubeubeubh?)rˆ}r‰(h=Uh>jh hDhEhFhGhH}rŠ(hJ]hK]hL]hM]r‹Usolver-configuration-optionsrŒahP]rhauhRMŠhShhT]rŽ(hV)r}r(h=XSolver configuration optionsr‘h>jˆhDhEhFhZhH}r’(hJ]hK]hL]hM]hP]uhRMŠhShhT]r“h]XSolver configuration optionsr”…r•}r–(h=j‘hDNhRNhShh>jubaubhp)r—}r˜(h=XEThe following settings control the behavior of the dependency solver:r™h>jˆhDhEhFhthH}rš(hJ]hK]hL]hM]hP]uhRMŒhShhT]r›h]XEThe following settings control the behavior of the dependency solver:rœ…r}rž(h=j™hDNhRNhShh>j—ubaubj7)rŸ}r (h=Uh>jˆhDhEhFj:hH}r¡(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r¢}r£(h=Uh>jˆhDhEhFj?hH}r¤(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr¥jEj¥uhRNhShhT]r¦(jG)r§}r¨(h=X/constraints: constraints list (comma separated)h>j¢hDhEhFjJhH}r©(hM]rªXcfg-field-constraintsr«ahL]hJ]hK]hP]jN‰uhRNhShhT]r¬(j7)r­}r®(h=Uh>j§hDhEhFj:hH}r¯(hM]hL]hJ]hK]hP]Uentries]r°(jTX"constraints ; cabal project optionj«UNtr±auhRNhShhT]ubjV)r²}r³(h=X constraintsr´h>j§hDhEhFjZhH}rµ(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¶h]X constraintsr·…r¸}r¹(h=UhDNhRNhShh>j²ubaubj`)rº}r»(h=jch>j§hDhEhFjdhH}r¼(jjhM]hL]hJ]hK]hP]uhRNhShhT]r½h]X: r¾…r¿}rÀ(h=UhDNhRNhShh>jºubaubjj)rÁ}rÂ(h=X"constraints list (comma separated)h>j§hDhEhFjmhH}rÃ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÄh]X"constraints list (comma separated)rÅ…rÆ}rÇ(h=UhDNhRNhShh>jÁubaubeubjG)rÈ}rÉ(h=X--constraint="pkg >= 2.0"h>j¢hDhEhFjJhH}rÊ(hM]rËXcfg-flag---constraintrÌahL]hJ]hK]hP]jN‰uhRNhShhT]rÍ(j7)rÎ}rÏ(h=Uh>jÈhDhEhFj:hH}rÐ(hM]hL]hJ]hK]hP]Uentries]rÑ(jTX"--constraint; cabal project optionjÌUNtrÒauhRNhShhT]ubjV)rÓ}rÔ(h=X --constraintrÕh>jÈhDhEhFjZhH}rÖ(jjhM]hL]hJ]hK]hP]uhRNhShhT]r×h]X --constraintrØ…rÙ}rÚ(h=UhDNhRNhShh>jÓubaubj`)rÛ}rÜ(h=X ="pkg > 2.0"h>jÈhDhEhFjdhH}rÝ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÞh]X ="pkg > 2.0"rß…rà}rá(h=UhDNhRNhShh>jÛubaubeubjs)râ}rã(h=Uh>j¢hDhEhFjvhH}rä(hJ]hK]hL]hM]hP]uhRNhShhT]rå(hp)ræ}rç(h=X~Add extra constraints to the version bounds, flag settings, and other properties a solver can pick for a package. For example:rèh>jâhDhEhFhthH}ré(hJ]hK]hL]hM]hP]uhRM’hShhT]rêh]X~Add extra constraints to the version bounds, flag settings, and other properties a solver can pick for a package. For example:rë…rì}rí(h=jèhDNhRNhShh>jæubaubj)rî}rï(h=Xconstraints: bar == 2.1h>jâhDhEhFjhH}rð(jjhM]hL]hJ]hK]hP]uhRM˜hShhT]rñh]Xconstraints: bar == 2.1rò…ró}rô(h=Uh>jîubaubhp)rõ}rö(h=X&A package can be specified multiple times in ``constraints``, in which case the specified constraints are intersected. This is useful, since the syntax does not allow you to specify multiple constraints at once. For example, to specify both version bounds and flag assignments, you would write:h>jâhDhEhFhthH}r÷(hJ]hK]hL]hM]hP]uhRMšhShhT]rø(h]X-A package can be specified multiple times in rù…rú}rû(h=X-A package can be specified multiple times in hDNhRNhShh>jõubh–)rü}rý(h=X``constraints``hH}rþ(hJ]hK]hL]hM]hP]uh>jõhT]rÿh]X constraintsr…r}r(h=X constraintsh>jüubahFhžubh]Xê, in which case the specified constraints are intersected. This is useful, since the syntax does not allow you to specify multiple constraints at once. For example, to specify both version bounds and flag assignments, you would write:r…r}r(h=Xê, in which case the specified constraints are intersected. This is useful, since the syntax does not allow you to specify multiple constraints at once. For example, to specify both version bounds and flag assignments, you would write:hDNhRNhShh>jõubeubj)r}r(h=X3constraints: bar == 2.1, bar +foo -bazh>jâhDhEhFjhH}r(jjhM]hL]hJ]hK]hP]uhRM¢hShhT]r h]X3constraints: bar == 2.1, bar +foo -bazr …r }r (h=Uh>jubaubhp)r }r(h=X“Valid constraints take the same form as for the `constraint command line option `__.h>jâhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM¥hShhT]r(h]X0Valid constraints take the same form as for the r…r}r(h=X0Valid constraints take the same form as for the hDNhRNhShh>j ubjæ)r}r(h=Xb`constraint command line option `__hH}r(UnameXconstraint command line optionjêX=installing-packages.html#cmdoption-setup-configure-constrainthM]hL]hJ]hK]hP]uh>j hT]rh]Xconstraint command line optionr…r}r(h=Xconstraint command line optionh>jubahFjïubh]X.…r}r(h=X.hDNhRNhShh>j ubeubeubeubj7)r}r(h=Uh>jˆhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r }r!(h=Uh>jˆhDhEhFj?hH}r"(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr#jEj#uhRNhShhT]r$(jG)r%}r&(h=X)preferences: preference (comma separated)h>j hDhEhFjJhH}r'(hM]r(Xcfg-field-preferencesr)ahL]hJ]hK]hP]jN‰uhRNhShhT]r*(j7)r+}r,(h=Uh>j%hDhEhFj:hH}r-(hM]hL]hJ]hK]hP]Uentries]r.(jTX"preferences ; cabal project optionj)UNtr/auhRNhShhT]ubjV)r0}r1(h=X preferencesr2h>j%hDhEhFjZhH}r3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r4h]X preferencesr5…r6}r7(h=UhDNhRNhShh>j0ubaubj`)r8}r9(h=jch>j%hDhEhFjdhH}r:(jjhM]hL]hJ]hK]hP]uhRNhShhT]r;h]X: r<…r=}r>(h=UhDNhRNhShh>j8ubaubjj)r?}r@(h=Xpreference (comma separated)h>j%hDhEhFjmhH}rA(jjhM]hL]hJ]hK]hP]uhRNhShhT]rBh]Xpreference (comma separated)rC…rD}rE(h=UhDNhRNhShh>j?ubaubeubjG)rF}rG(h=X--preference="pkg >= 2.0"h>j hDhEhFjJhH}rH(hM]rIXcfg-flag---preferencerJahL]hJ]hK]hP]jN‰uhRNhShhT]rK(j7)rL}rM(h=Uh>jFhDhEhFj:hH}rN(hM]hL]hJ]hK]hP]Uentries]rO(jTX"--preference; cabal project optionjJUNtrPauhRNhShhT]ubjV)rQ}rR(h=X --preferencerSh>jFhDhEhFjZhH}rT(jjhM]hL]hJ]hK]hP]uhRNhShhT]rUh]X --preferencerV…rW}rX(h=UhDNhRNhShh>jQubaubj`)rY}rZ(h=X ="pkg > 2.0"h>jFhDhEhFjdhH}r[(jjhM]hL]hJ]hK]hP]uhRNhShhT]r\h]X ="pkg > 2.0"r]…r^}r_(h=UhDNhRNhShh>jYubaubeubjs)r`}ra(h=Uh>j hDhEhFjvhH}rb(hJ]hK]hL]hM]hP]uhRNhShhT]rc(hp)rd}re(h=X0Like :cfg-field:`constraints`, but the solver will attempt to satisfy these preferences on a best-effort basis. The resulting install is locally optimal with respect to preferences; specifically, no single package could be replaced with a more preferred version that still satisfies the hard constraints.h>j`hDhEhFhthH}rf(hJ]hK]hL]hM]hP]uhRM­hShhT]rg(h]XLike rh…ri}rj(h=XLike hDNhRNhShh>jdubjä)rk}rl(h=X:cfg-field:`constraints`h>jdhDhEhFjçhH}rm(UreftypeX cfg-fieldjéˆjêX constraintsrnU refdomainXcabalrohM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM­hT]rph–)rq}rr(h=jnhH}rs(hJ]hK]rt(jôjoXcabal-cfg-fieldruehL]hM]hP]uh>jkhT]rvh]X constraintsrw…rx}ry(h=Uh>jqubahFhžubaubh]X, but the solver will attempt to satisfy these preferences on a best-effort basis. The resulting install is locally optimal with respect to preferences; specifically, no single package could be replaced with a more preferred version that still satisfies the hard constraints.rz…r{}r|(h=X, but the solver will attempt to satisfy these preferences on a best-effort basis. The resulting install is locally optimal with respect to preferences; specifically, no single package could be replaced with a more preferred version that still satisfies the hard constraints.hDNhRNhShh>jdubeubhp)r}}r~(h=X›Operationally, preferences can cause the solver to attempt certain version choices of a package before others, which can improve dependency solver runtime.rh>j`hDhEhFhthH}r€(hJ]hK]hL]hM]hP]uhRM³hShhT]rh]X›Operationally, preferences can cause the solver to attempt certain version choices of a package before others, which can improve dependency solver runtime.r‚…rƒ}r„(h=jhDNhRNhShh>j}ubaubhp)r…}r†(h=X]One way to use :cfg-field:`preferences` is to take a known working set of constraints (e.g., via ``cabal v2-freeze``) and record them as preferences. In this case, the solver will first attempt to use this configuration, and if this violates hard constraints, it will try to find the minimal number of upgrades to satisfy the hard constraints again.h>j`hDhEhFhthH}r‡(hJ]hK]hL]hM]hP]uhRM·hShhT]rˆ(h]XOne way to use r‰…rŠ}r‹(h=XOne way to use hDNhRNhShh>j…ubjä)rŒ}r(h=X:cfg-field:`preferences`h>j…hDhEhFjçhH}rŽ(UreftypeX cfg-fieldjéˆjêX preferencesrU refdomainXcabalrhM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM·hT]r‘h–)r’}r“(h=jhH}r”(hJ]hK]r•(jôjXcabal-cfg-fieldr–ehL]hM]hP]uh>jŒhT]r—h]X preferencesr˜…r™}rš(h=Uh>j’ubahFhžubaubh]X: is to take a known working set of constraints (e.g., via r›…rœ}r(h=X: is to take a known working set of constraints (e.g., via hDNhRNhShh>j…ubh–)rž}rŸ(h=X``cabal v2-freeze``hH}r (hJ]hK]hL]hM]hP]uh>j…hT]r¡h]Xcabal v2-freezer¢…r£}r¤(h=Xcabal v2-freezeh>jžubahFhžubh]Xé) and record them as preferences. In this case, the solver will first attempt to use this configuration, and if this violates hard constraints, it will try to find the minimal number of upgrades to satisfy the hard constraints again.r¥…r¦}r§(h=Xé) and record them as preferences. In this case, the solver will first attempt to use this configuration, and if this violates hard constraints, it will try to find the minimal number of upgrades to satisfy the hard constraints again.hDNhRNhShh>j…ubeubhp)r¨}r©(h=X‡The command line variant of this field is ``--preference="pkg >= 2.0"``; to specify multiple preferences, pass the flag multiple times.h>j`hDhEhFhthH}rª(hJ]hK]hL]hM]hP]uhRM¾hShhT]r«(h]X*The command line variant of this field is r¬…r­}r®(h=X*The command line variant of this field is hDNhRNhShh>j¨ubh–)r¯}r°(h=X``--preference="pkg >= 2.0"``hH}r±(hJ]hK]hL]hM]hP]uh>j¨hT]r²h]X--preference="pkg >= 2.0"r³…r´}rµ(h=X--preference="pkg >= 2.0"h>j¯ubahFhžubh]X@; to specify multiple preferences, pass the flag multiple times.r¶…r·}r¸(h=X@; to specify multiple preferences, pass the flag multiple times.hDNhRNhShh>j¨ubeubeubeubj7)r¹}rº(h=Uh>jˆhDhEhFj:hH}r»(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r¼}r½(h=Uh>jˆhDhEhFj?hH}r¾(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr¿jEj¿uhRNhShhT]rÀ(jG)rÁ}rÂ(h=XQallow-newer: none, all or list of scoped package names (space or comma separated)h>j¼hDhEhFjJhH}rÃ(hM]rÄXcfg-field-allow-newerrÅahL]hJ]hK]hP]jN‰uhRNhShhT]rÆ(j7)rÇ}rÈ(h=Uh>jÁhDhEhFj:hH}rÉ(hM]hL]hJ]hK]hP]Uentries]rÊ(jTX"allow-newer ; cabal project optionjÅUNtrËauhRNhShhT]ubjV)rÌ}rÍ(h=X allow-newerrÎh>jÁhDhEhFjZhH}rÏ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÐh]X allow-newerrÑ…rÒ}rÓ(h=UhDNhRNhShh>jÌubaubj`)rÔ}rÕ(h=jch>jÁhDhEhFjdhH}rÖ(jjhM]hL]hJ]hK]hP]uhRNhShhT]r×h]X: rØ…rÙ}rÚ(h=UhDNhRNhShh>jÔubaubjj)rÛ}rÜ(h=XDnone, all or list of scoped package names (space or comma separated)h>jÁhDhEhFjmhH}rÝ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÞh]XDnone, all or list of scoped package names (space or comma separated)rß…rà}rá(h=UhDNhRNhShh>jÛubaubeubjG)râ}rã(h=X6--allow-newer, --allow-newer=[none,all,[scope:][^]pkg]h>j¼hDhEhFjJhH}rä(hM]råXcfg-flag---allow-newerræahL]hJ]hK]hP]jN‰uhRNhShhT]rç(j7)rè}ré(h=Uh>jâhDhEhFj:hH}rê(hM]hL]hJ]hK]hP]Uentries]rë(jTX#--allow-newer; cabal project optionjæUNtrìauhRNhShhT]ubjV)rí}rî(h=X --allow-newerrïh>jâhDhEhFjZhH}rð(jjhM]hL]hJ]hK]hP]uhRNhShhT]rñh]X --allow-newerrò…ró}rô(h=UhDNhRNhShh>jíubaubj`)rõ}rö(h=U h>jâhDhEhFjdhH}r÷(jjhM]hL]hJ]hK]hP]uhRNhShhT]røh]X …rù}rú(h=UhDNhRNhShh>jõubaubjV)rû}rü(h=jÓh>jâhDhEhFjZhH}rý(jjhM]hL]hJ]hK]hP]uhRNhShhT]rþh]X, rÿ…r}r(h=UhDNhRNhShh>jûubaubjV)r}r(h=X --allow-newerh>jâhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X --allow-newerr…r}r(h=UhDNhRNhShh>jubaubj`)r }r (h=X=[noneh>jâhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r h]X=[noner …r}r(h=UhDNhRNhShh>j ubaubjV)r}r(h=jÓh>jâhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X, r…r}r(h=UhDNhRNhShh>jubaubjV)r}r(h=Xallh>jâhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]Xallr…r}r(h=UhDNhRNhShh>jubaubj`)r}r(h=U h>jâhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r!h]X …r"}r#(h=UhDNhRNhShh>jubaubjV)r$}r%(h=jÓh>jâhDhEhFjZhH}r&(jjhM]hL]hJ]hK]hP]uhRNhShhT]r'h]X, r(…r)}r*(h=UhDNhRNhShh>j$ubaubjV)r+}r,(h=X[scope:][^]pkg]h>jâhDhEhFjZhH}r-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r.h]X[scope:][^]pkg]r/…r0}r1(h=UhDNhRNhShh>j+ubaubj`)r2}r3(h=U h>jâhDhEhFjdhH}r4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r5h]X …r6}r7(h=UhDNhRNhShh>j2ubaubeubjs)r8}r9(h=Uh>j¼hDhEhFjvhH}r:(hJ]hK]hL]hM]hP]uhRNhShhT]r;(jy)r<}r=(h=Uh>j8hDhEhFj|hH}r>(hJ]hK]hL]hM]hP]uhRNhShhT]r?j)r@}rA(h=UhH}rB(hJ]hK]hL]hM]hP]uh>j<hT]rC(j„)rD}rE(h=X Default valueh>j@hDhEhFj‡hH}rF(hJ]hK]hL]hM]hP]uhRKhT]rGh]X Default valuerH…rI}rJ(h=Uh>jDubaubj)rK}rL(h=UhH}rM(hJ]hK]hL]hM]hP]uh>j@hT]rNhp)rO}rP(h=XnonehH}rQ(hJ]hK]hL]hM]hP]uh>jKhT]rRh–)rS}rT(h=X``none``h>jOhDhEhFhžhH}rU(hJ]hK]hL]hM]hP]uhRNhShhT]rVh]XnonerW…rX}rY(h=XnonehDNhRNhShh>jSubaubahFhtubahFjubehFjžubaubhp)rZ}r[(h=X Allow the solver to pick an newer version of some packages than would normally be permitted by than the :pkg-field:`build-depends` bounds of packages in the install plan. This option may be useful if the dependency solver cannot otherwise find a valid install plan.h>j8hDhEhFhthH}r\(hJ]hK]hL]hM]hP]uhRMÈhShhT]r](h]XhAllow the solver to pick an newer version of some packages than would normally be permitted by than the r^…r_}r`(h=XhAllow the solver to pick an newer version of some packages than would normally be permitted by than the hDNhRNhShh>jZubjä)ra}rb(h=X:pkg-field:`build-depends`h>jZhDhEhFjçhH}rc(UreftypeX pkg-fieldjéˆjêX build-dependsrdU refdomainXcabalrehM]hL]U refexplicit‰hJ]hK]hP]jìjíjNuhRMÈhT]rfh–)rg}rh(h=jdhH}ri(hJ]hK]rj(jôjeXcabal-pkg-fieldrkehL]hM]hP]uh>jahT]rlh]X build-dependsrm…rn}ro(h=Uh>jgubahFhžubaubh]X‡ bounds of packages in the install plan. This option may be useful if the dependency solver cannot otherwise find a valid install plan.rp…rq}rr(h=X‡ bounds of packages in the install plan. This option may be useful if the dependency solver cannot otherwise find a valid install plan.hDNhRNhShh>jZubeubhp)rs}rt(h=X€For example, to relax ``pkg``\ s :pkg-field:`build-depends` upper bound on ``dep-pkg``, write a scoped package name of the form:h>j8hDhEhFhthH}ru(hJ]hK]hL]hM]hP]uhRMÍhShhT]rv(h]XFor example, to relax rw…rx}ry(h=XFor example, to relax hDNhRNhShh>jsubh–)rz}r{(h=X``pkg``hH}r|(hJ]hK]hL]hM]hP]uh>jshT]r}h]Xpkgr~…r}r€(h=Xpkgh>jzubahFhžubh]Xs r…r‚}rƒ(h=X\ s hDNhRNhShh>jsubjä)r„}r…(h=X:pkg-field:`build-depends`h>jshDhEhFjçhH}r†(UreftypeX pkg-fieldjéˆjêX build-dependsr‡U refdomainXcabalrˆhM]hL]U refexplicit‰hJ]hK]hP]jìjíjNuhRMÍhT]r‰h–)rŠ}r‹(h=j‡hH}rŒ(hJ]hK]r(jôjˆXcabal-pkg-fieldrŽehL]hM]hP]uh>j„hT]rh]X build-dependsr…r‘}r’(h=Uh>jŠubahFhžubaubh]X upper bound on r“…r”}r•(h=X upper bound on hDNhRNhShh>jsubh–)r–}r—(h=X ``dep-pkg``hH}r˜(hJ]hK]hL]hM]hP]uh>jshT]r™h]Xdep-pkgrš…r›}rœ(h=Xdep-pkgh>j–ubahFhžubh]X*, write a scoped package name of the form:r…rž}rŸ(h=X*, write a scoped package name of the form:hDNhRNhShh>jsubeubj)r }r¡(h=Xallow-newer: pkg:dep-pkgh>j8hDhEhFjhH}r¢(jjhM]hL]hJ]hK]hP]uhRMÒhShhT]r£h]Xallow-newer: pkg:dep-pkgr¤…r¥}r¦(h=Uh>j ubaubhp)r§}r¨(h=XVIf the scope shall be limited to specific releases of ``pkg``, the extended form as inh>j8hDhEhFhthH}r©(hJ]hK]hL]hM]hP]uhRMÔhShhT]rª(h]X6If the scope shall be limited to specific releases of r«…r¬}r­(h=X6If the scope shall be limited to specific releases of hDNhRNhShh>j§ubh–)r®}r¯(h=X``pkg``hH}r°(hJ]hK]hL]hM]hP]uh>j§hT]r±h]Xpkgr²…r³}r´(h=Xpkgh>j®ubahFhžubh]X, the extended form as inrµ…r¶}r·(h=X, the extended form as inhDNhRNhShh>j§ubeubj)r¸}r¹(h=X1allow-newer: pkg-1.2.3:dep-pkg, pkg-1.1.2:dep-pkgh>j8hDhEhFjhH}rº(jjhM]hL]hJ]hK]hP]uhRMÙhShhT]r»h]X1allow-newer: pkg-1.2.3:dep-pkg, pkg-1.1.2:dep-pkgr¼…r½}r¾(h=Uh>j¸ubaubhp)r¿}rÀ(h=Xxcan be used to limit the relaxation of dependencies on ``dep-pkg`` by the ``pkg-1.2.3`` and ``pkg-1.1.2`` releases only.h>j8hDhEhFhthH}rÁ(hJ]hK]hL]hM]hP]uhRMÛhShhT]rÂ(h]X7can be used to limit the relaxation of dependencies on rÃ…rÄ}rÅ(h=X7can be used to limit the relaxation of dependencies on hDNhRNhShh>j¿ubh–)rÆ}rÇ(h=X ``dep-pkg``hH}rÈ(hJ]hK]hL]hM]hP]uh>j¿hT]rÉh]Xdep-pkgrÊ…rË}rÌ(h=Xdep-pkgh>jÆubahFhžubh]X by the rÍ…rÎ}rÏ(h=X by the hDNhRNhShh>j¿ubh–)rÐ}rÑ(h=X ``pkg-1.2.3``hH}rÒ(hJ]hK]hL]hM]hP]uh>j¿hT]rÓh]X pkg-1.2.3rÔ…rÕ}rÖ(h=X pkg-1.2.3h>jÐubahFhžubh]X and r×…rØ}rÙ(h=X and hDNhRNhShh>j¿ubh–)rÚ}rÛ(h=X ``pkg-1.1.2``hH}rÜ(hJ]hK]hL]hM]hP]uh>j¿hT]rÝh]X pkg-1.1.2rÞ…rß}rà(h=X pkg-1.1.2h>jÚubahFhžubh]X releases only.rá…râ}rã(h=X releases only.hDNhRNhShh>j¿ubeubhp)rä}rå(h=XThe scoped syntax is recommended, as it is often only a single package whose upper bound is misbehaving. In this case, the upper bounds of other packages should still be respected; indeed, relaxing the bound can break some packages which test the selected version of packages.ræh>j8hDhEhFhthH}rç(hJ]hK]hL]hM]hP]uhRMÞhShhT]rèh]XThe scoped syntax is recommended, as it is often only a single package whose upper bound is misbehaving. In this case, the upper bounds of other packages should still be respected; indeed, relaxing the bound can break some packages which test the selected version of packages.ré…rê}rë(h=jæhDNhRNhShh>jäubaubhp)rì}rí(h=X\The syntax also allows to prefix the dependee package with a modifier symbol to modify the scope/semantic of the relaxation transformation in a additional ways. Currently only one modifier symbol is defined, i.e. ``^`` (i.e. caret) which causes the relaxation to be applied only to ``^>=`` operators and leave all other version operators untouched.h>j8hDhEhFhthH}rî(hJ]hK]hL]hM]hP]uhRMãhShhT]rï(h]XÕThe syntax also allows to prefix the dependee package with a modifier symbol to modify the scope/semantic of the relaxation transformation in a additional ways. Currently only one modifier symbol is defined, i.e. rð…rñ}rò(h=XÕThe syntax also allows to prefix the dependee package with a modifier symbol to modify the scope/semantic of the relaxation transformation in a additional ways. Currently only one modifier symbol is defined, i.e. hDNhRNhShh>jìubh–)ró}rô(h=X``^``hH}rõ(hJ]hK]hL]hM]hP]uh>jìhT]röh]X^…r÷}rø(h=X^h>jóubahFhžubh]X@ (i.e. caret) which causes the relaxation to be applied only to rù…rú}rû(h=X@ (i.e. caret) which causes the relaxation to be applied only to hDNhRNhShh>jìubh–)rü}rý(h=X``^>=``hH}rþ(hJ]hK]hL]hM]hP]uh>jìhT]rÿh]X^>=r…r}r(h=X^>=h>jüubahFhžubh]X; operators and leave all other version operators untouched.r…r}r(h=X; operators and leave all other version operators untouched.hDNhRNhShh>jìubeubhp)r}r(h=X!However, in some situations (e.g., when attempting to build packages on a new version of GHC), it is useful to disregard *all* upper-bounds, with respect to a package or all packages. This can be done by specifying just a package name, or using the keyword ``all`` to specify all packages:h>j8hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMêhShhT]r (h]XyHowever, in some situations (e.g., when attempting to build packages on a new version of GHC), it is useful to disregard r …r }r (h=XyHowever, in some situations (e.g., when attempting to build packages on a new version of GHC), it is useful to disregard hDNhRNhShh>jubj))r }r(h=X*all*hH}r(hJ]hK]hL]hM]hP]uh>jhT]rh]Xallr…r}r(h=Xallh>j ubahFj1ubh]Xƒ upper-bounds, with respect to a package or all packages. This can be done by specifying just a package name, or using the keyword r…r}r(h=Xƒ upper-bounds, with respect to a package or all packages. This can be done by specifying just a package name, or using the keyword hDNhRNhShh>jubh–)r}r(h=X``all``hH}r(hJ]hK]hL]hM]hP]uh>jhT]rh]Xallr…r}r(h=Xallh>jubahFhžubh]X to specify all packages:r…r}r (h=X to specify all packages:hDNhRNhShh>jubeubj)r!}r"(h=XF-- Disregard upper bounds involving the dependencies on -- packages bar, baz. For quux only, relax -- 'quux ^>= ...'-style constraints only. allow-newer: bar, baz, ^quux -- Disregard all upper bounds when dependency solving allow-newer: all -- Disregard all `^>=`-style upper bounds when dependency solving allow-newer: ^allh>j8hDhEhFjhH}r#(jjhM]hL]hJ]hK]hP]uhRMòhShhT]r$h]XF-- Disregard upper bounds involving the dependencies on -- packages bar, baz. For quux only, relax -- 'quux ^>= ...'-style constraints only. allow-newer: bar, baz, ^quux -- Disregard all upper bounds when dependency solving allow-newer: all -- Disregard all `^>=`-style upper bounds when dependency solving allow-newer: ^allr%…r&}r'(h=Uh>j!ubaubhp)r(}r)(h=X¿For consistency, there is also the explicit wildcard scope syntax ``*`` (or its alphabetic synonym ``all``). Consequently, the examples above are equivalent to the explicitly scoped variants:h>j8hDhEhFhthH}r*(hJ]hK]hL]hM]hP]uhRMþhShhT]r+(h]XBFor consistency, there is also the explicit wildcard scope syntax r,…r-}r.(h=XBFor consistency, there is also the explicit wildcard scope syntax hDNhRNhShh>j(ubh–)r/}r0(h=X``*``hH}r1(hJ]hK]hL]hM]hP]uh>j(hT]r2h]X*…r3}r4(h=X*h>j/ubahFhžubh]X (or its alphabetic synonym r5…r6}r7(h=X (or its alphabetic synonym hDNhRNhShh>j(ubh–)r8}r9(h=X``all``hH}r:(hJ]hK]hL]hM]hP]uh>j(hT]r;h]Xallr<…r=}r>(h=Xallh>j8ubahFhžubh]XU). Consequently, the examples above are equivalent to the explicitly scoped variants:r?…r@}rA(h=XU). Consequently, the examples above are equivalent to the explicitly scoped variants:hDNhRNhShh>j(ubeubj)rB}rC(h=Xtallow-newer: all:bar, *:baz, *:^quux allow-newer: *:* allow-newer: all:all allow-newer: *:^* allow-newer: all:^allh>j8hDhEhFjhH}rD(jjhM]hL]hJ]hK]hP]uhRMhShhT]rEh]Xtallow-newer: all:bar, *:baz, *:^quux allow-newer: *:* allow-newer: all:all allow-newer: *:^* allow-newer: all:^allrF…rG}rH(h=Uh>jBubaubhp)rI}rJ(h=X‚In order to ignore all bounds specified by a package ``pkg-1.2.3`` you can combine scoping with a right-hand-side wildcard like soh>j8hDhEhFhthH}rK(hJ]hK]hL]hM]hP]uhRM hShhT]rL(h]X5In order to ignore all bounds specified by a package rM…rN}rO(h=X5In order to ignore all bounds specified by a package hDNhRNhShh>jIubh–)rP}rQ(h=X ``pkg-1.2.3``hH}rR(hJ]hK]hL]hM]hP]uh>jIhT]rSh]X pkg-1.2.3rT…rU}rV(h=X pkg-1.2.3h>jPubahFhžubh]X@ you can combine scoping with a right-hand-side wildcard like sorW…rX}rY(h=X@ you can combine scoping with a right-hand-side wildcard like sohDNhRNhShh>jIubeubj)rZ}r[(h=X -- Disregard any upper bounds specified by pkg-1.2.3 allow-newer: pkg-1.2.3:* -- Disregard only `^>=`-style upper bounds in pkg-1.2.3 allow-newer: pkg-1.2.3:^*h>j8hDhEhFjhH}r\(jjhM]hL]hJ]hK]hP]uhRMhShhT]r]h]X -- Disregard any upper bounds specified by pkg-1.2.3 allow-newer: pkg-1.2.3:* -- Disregard only `^>=`-style upper bounds in pkg-1.2.3 allow-newer: pkg-1.2.3:^*r^…r_}r`(h=Uh>jZubaubhp)ra}rb(h=X«:cfg-field:`allow-newer` is often used in conjunction with a constraint (in the cfg-field:`constraints` field) forcing the usage of a specific, newer version of a package.h>j8hDhEhFhthH}rc(hJ]hK]hL]hM]hP]uhRMhShhT]rd(jä)re}rf(h=X:cfg-field:`allow-newer`h>jahDhEhFjçhH}rg(UreftypeX cfg-fieldjéˆjêX allow-newerrhU refdomainXcabalrihM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMhT]rjh–)rk}rl(h=jhhH}rm(hJ]hK]rn(jôjiXcabal-cfg-fieldroehL]hM]hP]uh>jehT]rph]X allow-newerrq…rr}rs(h=Uh>jkubahFhžubaubh]XB is often used in conjunction with a constraint (in the cfg-field:rt…ru}rv(h=XB is often used in conjunction with a constraint (in the cfg-field:hDNhRNhShh>jaubj)rw}rx(h=X `constraints`hH}ry(hJ]hK]hL]hM]hP]uh>jahT]rzh]X constraintsr{…r|}r}(h=X constraintsh>jwubahFj ubh]XD field) forcing the usage of a specific, newer version of a package.r~…r}r€(h=XD field) forcing the usage of a specific, newer version of a package.hDNhRNhShh>jaubeubhp)r}r‚(h=X†The command line variant of this field is e.g. ``--allow-newer=bar``. A bare ``--allow-newer`` is equivalent to ``--allow-newer=all``.h>j8hDhEhFhthH}rƒ(hJ]hK]hL]hM]hP]uhRMhShhT]r„(h]X/The command line variant of this field is e.g. r……r†}r‡(h=X/The command line variant of this field is e.g. hDNhRNhShh>jubh–)rˆ}r‰(h=X``--allow-newer=bar``hH}rŠ(hJ]hK]hL]hM]hP]uh>jhT]r‹h]X--allow-newer=barrŒ…r}rŽ(h=X--allow-newer=barh>jˆubahFhžubh]X . A bare r…r}r‘(h=X . A bare hDNhRNhShh>jubh–)r’}r“(h=X``--allow-newer``hH}r”(hJ]hK]hL]hM]hP]uh>jhT]r•h]X --allow-newerr–…r—}r˜(h=X --allow-newerh>j’ubahFhžubh]X is equivalent to r™…rš}r›(h=X is equivalent to hDNhRNhShh>jubh–)rœ}r(h=X``--allow-newer=all``hH}rž(hJ]hK]hL]hM]hP]uh>jhT]rŸh]X--allow-newer=allr …r¡}r¢(h=X--allow-newer=allh>jœubahFhžubh]X.…r£}r¤(h=X.hDNhRNhShh>jubeubeubeubj7)r¥}r¦(h=Uh>jˆhDhEhFj:hH}r§(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r¨}r©(h=Uh>jˆhDhEhFj?hH}rª(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr«jEj«uhRNhShhT]r¬(jG)r­}r®(h=XOallow-older: none, all, list of scoped package names (space or comma separated)h>j¨hDhEhFjJhH}r¯(hM]r°Xcfg-field-allow-olderr±ahL]hJ]hK]hP]jN‰uhRNhShhT]r²(j7)r³}r´(h=Uh>j­hDhEhFj:hH}rµ(hM]hL]hJ]hK]hP]Uentries]r¶(jTX"allow-older ; cabal project optionj±UNtr·auhRNhShhT]ubjV)r¸}r¹(h=X allow-olderrºh>j­hDhEhFjZhH}r»(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¼h]X allow-olderr½…r¾}r¿(h=UhDNhRNhShh>j¸ubaubj`)rÀ}rÁ(h=jch>j­hDhEhFjdhH}rÂ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÃh]X: rÄ…rÅ}rÆ(h=UhDNhRNhShh>jÀubaubjj)rÇ}rÈ(h=XBnone, all, list of scoped package names (space or comma separated)h>j­hDhEhFjmhH}rÉ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÊh]XBnone, all, list of scoped package names (space or comma separated)rË…rÌ}rÍ(h=UhDNhRNhShh>jÇubaubeubjG)rÎ}rÏ(h=X6--allow-older, --allow-older=[none,all,[scope:][^]pkg]h>j¨hDhEhFjJhH}rÐ(hM]rÑXcfg-flag---allow-olderrÒahL]hJ]hK]hP]jN‰uhRNhShhT]rÓ(j7)rÔ}rÕ(h=Uh>jÎhDhEhFj:hH}rÖ(hM]hL]hJ]hK]hP]Uentries]r×(jTX#--allow-older; cabal project optionjÒUNtrØauhRNhShhT]ubjV)rÙ}rÚ(h=X --allow-olderrÛh>jÎhDhEhFjZhH}rÜ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÝh]X --allow-olderrÞ…rß}rà(h=UhDNhRNhShh>jÙubaubj`)rá}râ(h=U h>jÎhDhEhFjdhH}rã(jjhM]hL]hJ]hK]hP]uhRNhShhT]räh]X …rå}ræ(h=UhDNhRNhShh>jáubaubjV)rç}rè(h=jÓh>jÎhDhEhFjZhH}ré(jjhM]hL]hJ]hK]hP]uhRNhShhT]rêh]X, rë…rì}rí(h=UhDNhRNhShh>jçubaubjV)rî}rï(h=X --allow-olderh>jÎhDhEhFjZhH}rð(jjhM]hL]hJ]hK]hP]uhRNhShhT]rñh]X --allow-olderrò…ró}rô(h=UhDNhRNhShh>jîubaubj`)rõ}rö(h=X=[noneh>jÎhDhEhFjdhH}r÷(jjhM]hL]hJ]hK]hP]uhRNhShhT]røh]X=[nonerù…rú}rû(h=UhDNhRNhShh>jõubaubjV)rü}rý(h=jÓh>jÎhDhEhFjZhH}rþ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÿh]X, r…r}r(h=UhDNhRNhShh>jüubaubjV)r}r(h=Xallh>jÎhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]Xallr…r}r (h=UhDNhRNhShh>jubaubj`)r }r (h=U h>jÎhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r h]X …r}r(h=UhDNhRNhShh>j ubaubjV)r}r(h=jÓh>jÎhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X, r…r}r(h=UhDNhRNhShh>jubaubjV)r}r(h=X[scope:][^]pkg]h>jÎhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X[scope:][^]pkg]r…r}r(h=UhDNhRNhShh>jubaubj`)r}r(h=U h>jÎhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r!h]X …r"}r#(h=UhDNhRNhShh>jubaubeubjs)r$}r%(h=Uh>j¨hDhEhFjvhH}r&(hJ]hK]hL]hM]hP]uhRNhShhT]r'(jy)r(}r)(h=Uh>j$hDhEhFj|hH}r*(hJ]hK]hL]hM]hP]uhRNhShhT]r+(j)r,}r-(h=Uh>j(hDhEhFjžhH}r.(hJ]hK]hL]hM]hP]uhRNhShhT]r/(j„)r0}r1(h=USincer2h>j,hDhEhFj‡hH}r3(hJ]hK]hL]hM]hP]uhRKhT]r4h]XSincer5…r6}r7(h=Uh>j0ubaubj)r8}r9(h=U Cabal 2.0r:hH}r;(hJ]hK]hL]hM]hP]uh>j,hT]r<hp)r=}r>(h=j:hH}r?(hJ]hK]hL]hM]hP]uh>j8hT]r@h]X Cabal 2.0rA…rB}rC(h=Uh>j=ubahFhtubahFjubeubj)rD}rE(h=UhH}rF(hJ]hK]hL]hM]hP]uh>j(hT]rG(j„)rH}rI(h=X Default valueh>jDhDhEhFj‡hH}rJ(hJ]hK]hL]hM]hP]uhRKhT]rKh]X Default valuerL…rM}rN(h=Uh>jHubaubj)rO}rP(h=UhH}rQ(hJ]hK]hL]hM]hP]uh>jDhT]rRhp)rS}rT(h=XnonehH}rU(hJ]hK]hL]hM]hP]uh>jOhT]rVh–)rW}rX(h=X``none``rYh>jShDhEhFhžhH}rZ(hJ]hK]hL]hM]hP]uhRNhShhT]r[h]Xnoner\…r]}r^(h=XnonehDNhRNhShh>jWubaubahFhtubahFjubehFjžubeubhp)r_}r`(h=XTLike :cfg-field:`allow-newer`, but applied to lower bounds rather than upper bounds.h>j$hDhEhFhthH}ra(hJ]hK]hL]hM]hP]uhRM&hShhT]rb(h]XLike rc…rd}re(h=XLike hDNhRNhShh>j_ubjä)rf}rg(h=X:cfg-field:`allow-newer`h>j_hDhEhFjçhH}rh(UreftypeX cfg-fieldjéˆjêX allow-newerriU refdomainXcabalrjhM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM&hT]rkh–)rl}rm(h=jihH}rn(hJ]hK]ro(jôjjXcabal-cfg-fieldrpehL]hM]hP]uh>jfhT]rqh]X allow-newerrr…rs}rt(h=Uh>jlubahFhžubaubh]X7, but applied to lower bounds rather than upper bounds.ru…rv}rw(h=X7, but applied to lower bounds rather than upper bounds.hDNhRNhShh>j_ubeubhp)rx}ry(h=XThe command line variant of this field is ``--allow-older=all``. A bare ``--allow-older`` is equivalent to ``--allow-older=all``.h>j$hDhEhFhthH}rz(hJ]hK]hL]hM]hP]uhRM)hShhT]r{(h]X*The command line variant of this field is r|…r}}r~(h=X*The command line variant of this field is hDNhRNhShh>jxubh–)r}r€(h=X``--allow-older=all``hH}r(hJ]hK]hL]hM]hP]uh>jxhT]r‚h]X--allow-older=allrƒ…r„}r…(h=X--allow-older=allh>jubahFhžubh]X . A bare r†…r‡}rˆ(h=X . A bare hDNhRNhShh>jxubh–)r‰}rŠ(h=X``--allow-older``hH}r‹(hJ]hK]hL]hM]hP]uh>jxhT]rŒh]X --allow-olderr…rŽ}r(h=X --allow-olderh>j‰ubahFhžubh]X is equivalent to r…r‘}r’(h=X is equivalent to hDNhRNhShh>jxubh–)r“}r”(h=X``--allow-older=all``hH}r•(hJ]hK]hL]hM]hP]uh>jxhT]r–h]X--allow-older=allr—…r˜}r™(h=X--allow-older=allh>j“ubahFhžubh]X.…rš}r›(h=X.hDNhRNhShh>jxubeubeubeubj7)rœ}r(h=Uh>jˆhDhEhFj:hH}rž(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rŸ}r (h=Uh>jˆhDhEhFj?hH}r¡(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr¢jEj¢uhRNhShhT]r£(jG)r¤}r¥(h=X9index-state: HEAD, unix-timestamp, ISO8601 UTC timestamp.h>jŸhDhEhFjJhH}r¦(hM]r§Xcfg-field-index-stater¨ahL]hJ]hK]hP]jN‰uhRNhShhT]r©(j7)rª}r«(h=Uh>j¤hDhEhFj:hH}r¬(hM]hL]hJ]hK]hP]Uentries]r­(jTX"index-state ; cabal project optionj¨UNtr®auhRNhShhT]ubjV)r¯}r°(h=X index-stater±h>j¤hDhEhFjZhH}r²(jjhM]hL]hJ]hK]hP]uhRNhShhT]r³h]X index-stater´…rµ}r¶(h=UhDNhRNhShh>j¯ubaubj`)r·}r¸(h=jch>j¤hDhEhFjdhH}r¹(jjhM]hL]hJ]hK]hP]uhRNhShhT]rºh]X: r»…r¼}r½(h=UhDNhRNhShh>j·ubaubjj)r¾}r¿(h=X,HEAD, unix-timestamp, ISO8601 UTC timestamp.h>j¤hDhEhFjmhH}rÀ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÁh]X,HEAD, unix-timestamp, ISO8601 UTC timestamp.rÂ…rÃ}rÄ(h=UhDNhRNhShh>j¾ubaubeubjs)rÅ}rÆ(h=Uh>jŸhDhEhFjvhH}rÇ(hJ]hK]hL]hM]hP]uhRNhShhT]rÈ(jy)rÉ}rÊ(h=Uh>jÅhDhEhFj|hH}rË(hJ]hK]hL]hM]hP]uhRNhShhT]rÌ(j)rÍ}rÎ(h=Uh>jÉhDhEhFjžhH}rÏ(hJ]hK]hL]hM]hP]uhRNhShhT]rÐ(j„)rÑ}rÒ(h=j2h>jÍhDhEhFj‡hH}rÓ(hJ]hK]hL]hM]hP]uhRKhT]rÔh]XSincerÕ…rÖ}r×(h=Uh>jÑubaubj)rØ}rÙ(h=U Cabal 2.0rÚhH}rÛ(hJ]hK]hL]hM]hP]uh>jÍhT]rÜhp)rÝ}rÞ(h=jÚhH}rß(hJ]hK]hL]hM]hP]uh>jØhT]ràh]X Cabal 2.0rá…râ}rã(h=Uh>jÝubahFhtubahFjubeubj)rä}rå(h=UhH}ræ(hJ]hK]hL]hM]hP]uh>jÉhT]rç(j„)rè}ré(h=X Default valueh>jähDhEhFj‡hH}rê(hJ]hK]hL]hM]hP]uhRKhT]rëh]X Default valuerì…rí}rî(h=Uh>jèubaubj)rï}rð(h=UhH}rñ(hJ]hK]hL]hM]hP]uh>jähT]ròhp)ró}rô(h=XHEADhH}rõ(hJ]hK]hL]hM]hP]uh>jïhT]röh–)r÷}rø(h=X``HEAD``h>jóhDhEhFhžhH}rù(hJ]hK]hL]hM]hP]uhRNhShhT]rúh]XHEADrû…rü}rý(h=XHEADhDNhRNhShh>j÷ubaubahFhtubahFjubehFjžubeubhp)rþ}rÿ(h=XÿThis allows to change the source package index state the solver uses to compute install-plans. This is particularly useful in combination with freeze-files in order to also freeze the state the package index was in at the time the install-plan was frozen.rh>jÅhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM3hShhT]rh]XÿThis allows to change the source package index state the solver uses to compute install-plans. This is particularly useful in combination with freeze-files in order to also freeze the state the package index was in at the time the install-plan was frozen.r…r}r(h=jhDNhRNhShh>jþubaubj)r}r(h=XÚ-- UNIX timestamp format example index-state: @1474739268 -- ISO8601 UTC timestamp format example -- This format is used by 'cabal v2-configure' -- for storing `--index-state` values. index-state: 2016-09-24T17:47:48Zh>jÅhDhEhFjhH}r(jjhM]hL]hJ]hK]hP]uhRM:hShhT]r h]XÚ-- UNIX timestamp format example index-state: @1474739268 -- ISO8601 UTC timestamp format example -- This format is used by 'cabal v2-configure' -- for storing `--index-state` values. index-state: 2016-09-24T17:47:48Zr …r }r (h=Uh>jubaubeubeubj7)r }r(h=Uh>jˆhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r}r(h=Uh>jˆhDhEhFj?hH}r(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrjEjuhRNhShhT]r(jG)r}r(h=X,reject-unconstrained-dependencies: all, noneh>jhDhEhFjJhH}r(hM]rX+cfg-field-reject-unconstrained-dependenciesrahL]hJ]hK]hP]jN‰uhRNhShhT]r(j7)r}r(h=Uh>jhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]r(jTX8reject-unconstrained-dependencies ; cabal project optionjUNtrauhRNhShhT]ubjV)r }r!(h=X!reject-unconstrained-dependenciesr"h>jhDhEhFjZhH}r#(jjhM]hL]hJ]hK]hP]uhRNhShhT]r$h]X!reject-unconstrained-dependenciesr%…r&}r'(h=UhDNhRNhShh>j ubaubj`)r(}r)(h=jch>jhDhEhFjdhH}r*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r+h]X: r,…r-}r.(h=UhDNhRNhShh>j(ubaubjj)r/}r0(h=X all, noneh>jhDhEhFjmhH}r1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r2h]X all, noner3…r4}r5(h=UhDNhRNhShh>j/ubaubeubjG)r6}r7(h=X.--reject-unconstrained-dependencies=[all|none]h>jhDhEhFjJhH}r8(hM]r9X,cfg-flag---reject-unconstrained-dependenciesr:ahL]hJ]hK]hP]jN‰uhRNhShhT]r;(j7)r<}r=(h=Uh>j6hDhEhFj:hH}r>(hM]hL]hJ]hK]hP]Uentries]r?(jTX9--reject-unconstrained-dependencies; cabal project optionj:UNtr@auhRNhShhT]ubjV)rA}rB(h=X#--reject-unconstrained-dependenciesrCh>j6hDhEhFjZhH}rD(jjhM]hL]hJ]hK]hP]uhRNhShhT]rEh]X#--reject-unconstrained-dependenciesrF…rG}rH(h=UhDNhRNhShh>jAubaubj`)rI}rJ(h=X =[all|none]h>j6hDhEhFjdhH}rK(jjhM]hL]hJ]hK]hP]uhRNhShhT]rLh]X =[all|none]rM…rN}rO(h=UhDNhRNhShh>jIubaubeubjs)rP}rQ(h=Uh>jhDhEhFjvhH}rR(hJ]hK]hL]hM]hP]uhRNhShhT]rS(jy)rT}rU(h=Uh>jPhDhEhFj|hH}rV(hJ]hK]hL]hM]hP]uhRNhShhT]rW(j)rX}rY(h=UhH}rZ(hJ]hK]hL]hM]hP]uh>jThT]r[(j„)r\}r](h=X Default valueh>jXhDhEhFj‡hH}r^(hJ]hK]hL]hM]hP]uhRKhT]r_h]X Default valuer`…ra}rb(h=Uh>j\ubaubj)rc}rd(h=UhH}re(hJ]hK]hL]hM]hP]uh>jXhT]rfhp)rg}rh(h=XnonehH}ri(hJ]hK]hL]hM]hP]uh>jchT]rjh]Xnonerk…rl}rm(h=XnonehDNhRNhShh>jgubahFhtubahFjubehFjžubj)rn}ro(h=Uh>jThDhEhFjžhH}rp(hJ]hK]hL]hM]hP]uhRMHhShhT]rq(j„)rr}rs(h=Xsinceh>jnhDhEhFj‡hH}rt(hJ]hK]hL]hM]hP]uhRKhT]ruh]XSincerv…rw}rx(h=Uh>jrubaubj)ry}rz(h=X2.6 hH}r{(hJ]hK]hL]hM]hP]uh>jnhT]r|hp)r}}r~(h=X2.6rh>jyhDhEhFhthH}r€(hJ]hK]hL]hM]hP]uhRMHhT]rh]X2.6r‚…rƒ}r„(h=jh>j}ubaubahFjubeubeubhp)r…}r†(h=XËBy default, the dependency solver can include any package that it's aware of in a build plan. If you wish to restrict the build plan to a closed set of packages (e.g., from a freeze file), use this flag.r‡h>jPhDhEhFhthH}rˆ(hJ]hK]hL]hM]hP]uhRMJhShhT]r‰h]XÍBy default, the dependency solver can include any package that it’s aware of in a build plan. If you wish to restrict the build plan to a closed set of packages (e.g., from a freeze file), use this flag.rŠ…r‹}rŒ(h=j‡hDNhRNhShh>j…ubaubhp)r}rŽ(h=X–When set to `all`, all non-local packages that aren't goals must be explicitly constrained. When set to `none`, the solver will consider all packages.h>jPhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMNhShhT]r(h]X When set to r‘…r’}r“(h=X When set to hDNhRNhShh>jubj)r”}r•(h=X`all`hH}r–(hJ]hK]hL]hM]hP]uh>jhT]r—h]Xallr˜…r™}rš(h=Xallh>j”ubahFj ubh]XY, all non-local packages that aren’t goals must be explicitly constrained. When set to r›…rœ}r(h=XW, all non-local packages that aren't goals must be explicitly constrained. When set to hDNhRNhShh>jubj)rž}rŸ(h=X`none`hH}r (hJ]hK]hL]hM]hP]uh>jhT]r¡h]Xnoner¢…r£}r¤(h=Xnoneh>jžubahFj ubh]X(, the solver will consider all packages.r¥…r¦}r§(h=X(, the solver will consider all packages.hDNhRNhShh>jubeubeubeubeubjf h?)r¨}r©(h=Uh>jh hDhEhFhGhH}rª(hJ]hK]hL]hM]r«U%advanced-global-configuration-optionsr¬ahP]r­hauhRMœhShhT]r®(hV)r¯}r°(h=X%Advanced global configuration optionsr±h>j¨hDhEhFhZhH}r²(hJ]hK]hL]hM]hP]uhRMœhShhT]r³h]X%Advanced global configuration optionsr´…rµ}r¶(h=j±hDNhRNhShh>j¯ubaubj7)r·}r¸(h=Uh>j¨hDhEhFj:hH}r¹(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rº}r»(h=Uh>j¨hDhEhFj?hH}r¼(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr½jEj½uhRNhShhT]r¾(jG)r¿}rÀ(h=X8write-ghc-environment-files: always, never, or ghc8.4.4+h>jºhDhEhFjJhH}rÁ(hM]rÂX%cfg-field-write-ghc-environment-filesrÃahL]hJ]hK]hP]jN‰uhRNhShhT]rÄ(j7)rÅ}rÆ(h=Uh>j¿hDhEhFj:hH}rÇ(hM]hL]hJ]hK]hP]Uentries]rÈ(jTX2write-ghc-environment-files ; cabal project optionjÃUNtrÉauhRNhShhT]ubjV)rÊ}rË(h=Xwrite-ghc-environment-filesrÌh>j¿hDhEhFjZhH}rÍ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÎh]Xwrite-ghc-environment-filesrÏ…rÐ}rÑ(h=UhDNhRNhShh>jÊubaubj`)rÒ}rÓ(h=jch>j¿hDhEhFjdhH}rÔ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÕh]X: rÖ…r×}rØ(h=UhDNhRNhShh>jÒubaubjj)rÙ}rÚ(h=Xalways, never, or ghc8.4.4+h>j¿hDhEhFjmhH}rÛ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÜh]Xalways, never, or ghc8.4.4+rÝ…rÞ}rß(h=UhDNhRNhShh>jÙubaubeubjG)rà}rá(h=X$--write-ghc-environment-files=policyh>jºhDhEhFjJhH}râ(hM]rãX&cfg-flag---write-ghc-environment-filesräahL]hJ]hK]hP]jN‰uhRNhShhT]rå(j7)ræ}rç(h=Uh>jàhDhEhFj:hH}rè(hM]hL]hJ]hK]hP]Uentries]ré(jTX3--write-ghc-environment-files; cabal project optionjäUNtrêauhRNhShhT]ubjV)rë}rì(h=X--write-ghc-environment-filesríh>jàhDhEhFjZhH}rî(jjhM]hL]hJ]hK]hP]uhRNhShhT]rïh]X--write-ghc-environment-filesrð…rñ}rò(h=UhDNhRNhShh>jëubaubj`)ró}rô(h=X=policyh>jàhDhEhFjdhH}rõ(jjhM]hL]hJ]hK]hP]uhRNhShhT]röh]X=policyr÷…rø}rù(h=UhDNhRNhShh>jóubaubeubjs)rú}rû(h=Uh>jºhDhEhFjvhH}rü(hJ]hK]hL]hM]hP]uhRNhShhT]rý(jy)rþ}rÿ(h=Uh>júhDhEhFj|hH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rj)r}r(h=UhH}r(hJ]hK]hL]hM]hP]uh>jþhT]r(j„)r}r(h=X Default valueh>jhDhEhFj‡hH}r(hJ]hK]hL]hM]hP]uhRKhT]r h]X Default valuer …r }r (h=Uh>jubaubj)r }r(h=UhH}r(hJ]hK]hL]hM]hP]uh>jhT]rhp)r}r(h=XneverhH}r(hJ]hK]hL]hM]hP]uh>j hT]rh–)r}r(h=X ``never``h>jhDhEhFhžhH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rh]Xneverr…r}r(h=XneverhDNhRNhShh>jubaubahFhtubahFjubehFjžubaubhp)r}r(h=X°Whether a `GHC package environment file `_ should be created after a successful build.h>júhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRM¤hShhT]r(h]X Whether a r …r!}r"(h=X Whether a hDNhRNhShh>jubjæ)r#}r$(h=Xz`GHC package environment file `_hH}r%(UnameXGHC package environment filejêXXhttps://downloads.haskell.org/~ghc/master/users-guide/packages.html#package-environmentsr&hM]hL]hJ]hK]hP]uh>jhT]r'h]XGHC package environment filer(…r)}r*(h=XGHC package environment fileh>j#ubahFjïubjý)r+}r,(h=X[ j? Kh>jhFjhH}r-(Urefurij&hM]r.Ughc-package-environment-filer/ahL]hJ]hK]hP]r0hauhT]ubh]X, should be created after a successful build.r1…r2}r3(h=X, should be created after a successful build.hDNhRNhShh>jubeubhp)r4}r5(h=X0Since Cabal 3.0, defaults to ``never``. Before that, defaulted to creating them only when compiling with GHC 8.4.4 and older (GHC 8.4.4 `is the first version `_ that supports the ``-package-env -`` option that allows ignoring the package environment files).h>júhDhEhFhthH}r6(hJ]hK]hL]hM]hP]uhRM§hShhT]r7(h]XSince Cabal 3.0, defaults to r8…r9}r:(h=XSince Cabal 3.0, defaults to hDNhRNhShh>j4ubh–)r;}r<(h=X ``never``hH}r=(hJ]hK]hL]hM]hP]uh>j4hT]r>h]Xneverr?…r@}rA(h=Xneverh>j;ubahFhžubh]Xb. Before that, defaulted to creating them only when compiling with GHC 8.4.4 and older (GHC 8.4.4 rB…rC}rD(h=Xb. Before that, defaulted to creating them only when compiling with GHC 8.4.4 and older (GHC 8.4.4 hDNhRNhShh>j4ubjæ)rE}rF(h=XG`is the first version `_hH}rG(UnameXis the first versionjêX-https://ghc.haskell.org/trac/ghc/ticket/13753rHhM]hL]hJ]hK]hP]uh>j4hT]rIh]Xis the first versionrJ…rK}rL(h=Xis the first versionh>jEubahFjïubjý)rM}rN(h=X0 j? Kh>j4hFjhH}rO(UrefurijHhM]rPUis-the-first-versionrQahL]hJ]hK]hP]rRh auhT]ubh]X that supports the rS…rT}rU(h=X that supports the hDNhRNhShh>j4ubh–)rV}rW(h=X``-package-env -``hH}rX(hJ]hK]hL]hM]hP]uh>j4hT]rYh]X-package-env -rZ…r[}r\(h=X-package-env -h>jVubahFhžubh]X< option that allows ignoring the package environment files).r]…r^}r_(h=X< option that allows ignoring the package environment files).hDNhRNhShh>j4ubeubeubeubj7)r`}ra(h=Uh>j¨hDhEhFj:hH}rb(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rc}rd(h=Uh>j¨hDhEhFj?hH}re(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrfjEjfuhRNhShhT]rg(jG)rh}ri(h=X5http-transport: curl, wget, powershell, or plain-httph>jchDhEhFjJhH}rj(hM]rkXcfg-field-http-transportrlahL]hJ]hK]hP]jN‰uhRNhShhT]rm(j7)rn}ro(h=Uh>jhhDhEhFj:hH}rp(hM]hL]hJ]hK]hP]Uentries]rq(jTX%http-transport ; cabal project optionjlUNtrrauhRNhShhT]ubjV)rs}rt(h=Xhttp-transportruh>jhhDhEhFjZhH}rv(jjhM]hL]hJ]hK]hP]uhRNhShhT]rwh]Xhttp-transportrx…ry}rz(h=UhDNhRNhShh>jsubaubj`)r{}r|(h=jch>jhhDhEhFjdhH}r}(jjhM]hL]hJ]hK]hP]uhRNhShhT]r~h]X: r…r€}r(h=UhDNhRNhShh>j{ubaubjj)r‚}rƒ(h=X%curl, wget, powershell, or plain-httph>jhhDhEhFjmhH}r„(jjhM]hL]hJ]hK]hP]uhRNhShhT]r…h]X%curl, wget, powershell, or plain-httpr†…r‡}rˆ(h=UhDNhRNhShh>j‚ubaubeubjG)r‰}rŠ(h=X--http-transport=transporth>jchDhEhFjJhH}r‹(hM]rŒXcfg-flag---http-transportrahL]hJ]hK]hP]jN‰uhRNhShhT]rŽ(j7)r}r(h=Uh>j‰hDhEhFj:hH}r‘(hM]hL]hJ]hK]hP]Uentries]r’(jTX&--http-transport; cabal project optionjUNtr“auhRNhShhT]ubjV)r”}r•(h=X--http-transportr–h>j‰hDhEhFjZhH}r—(jjhM]hL]hJ]hK]hP]uhRNhShhT]r˜h]X--http-transportr™…rš}r›(h=UhDNhRNhShh>j”ubaubj`)rœ}r(h=X =transporth>j‰hDhEhFjdhH}rž(jjhM]hL]hJ]hK]hP]uhRNhShhT]rŸh]X =transportr …r¡}r¢(h=UhDNhRNhShh>jœubaubeubjs)r£}r¤(h=Uh>jchDhEhFjvhH}r¥(hJ]hK]hL]hM]hP]uhRNhShhT]r¦(jy)r§}r¨(h=Uh>j£hDhEhFj|hH}r©(hJ]hK]hL]hM]hP]uhRNhShhT]rªj)r«}r¬(h=UhH}r­(hJ]hK]hL]hM]hP]uh>j§hT]r®(j„)r¯}r°(h=X Default valueh>j«hDhEhFj‡hH}r±(hJ]hK]hL]hM]hP]uhRKhT]r²h]X Default valuer³…r´}rµ(h=Uh>j¯ubaubj)r¶}r·(h=UhH}r¸(hJ]hK]hL]hM]hP]uh>j«hT]r¹hp)rº}r»(h=XcurlhH}r¼(hJ]hK]hL]hM]hP]uh>j¶hT]r½h–)r¾}r¿(h=X``curl``h>jºhDhEhFhžhH}rÀ(hJ]hK]hL]hM]hP]uhRNhShhT]rÁh]XcurlrÂ…rÃ}rÄ(h=XcurlhDNhRNhShh>j¾ubaubahFhtubahFjubehFjžubaubhp)rÅ}rÆ(h=X8Set a transport to be used when making http(s) requests.rÇh>j£hDhEhFhthH}rÈ(hJ]hK]hL]hM]hP]uhRMµhShhT]rÉh]X8Set a transport to be used when making http(s) requests.rÊ…rË}rÌ(h=jÇhDNhRNhShh>jÅubaubhp)rÍ}rÎ(h=XDThe command line variant of this field is ``--http-transport=curl``.h>j£hDhEhFhthH}rÏ(hJ]hK]hL]hM]hP]uhRM·hShhT]rÐ(h]X*The command line variant of this field is rÑ…rÒ}rÓ(h=X*The command line variant of this field is hDNhRNhShh>jÍubh–)rÔ}rÕ(h=X``--http-transport=curl``hH}rÖ(hJ]hK]hL]hM]hP]uh>jÍhT]r×h]X--http-transport=curlrØ…rÙ}rÚ(h=X--http-transport=curlh>jÔubahFhžubh]X.…rÛ}rÜ(h=X.hDNhRNhShh>jÍubeubeubeubj7)rÝ}rÞ(h=Uh>j¨hDhEhFj:hH}rß(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rà}rá(h=Uh>j¨hDhEhFj?hH}râ(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrãjEjãuhRNhShhT]rä(jG)rå}ræ(h=Xignore-expiry: booleanh>jàhDhEhFjJhH}rç(hM]rèXcfg-field-ignore-expiryréahL]hJ]hK]hP]jN‰uhRNhShhT]rê(j7)rë}rì(h=Uh>jåhDhEhFj:hH}rí(hM]hL]hJ]hK]hP]Uentries]rî(jTX$ignore-expiry ; cabal project optionjéUNtrïauhRNhShhT]ubjV)rð}rñ(h=X ignore-expiryròh>jåhDhEhFjZhH}ró(jjhM]hL]hJ]hK]hP]uhRNhShhT]rôh]X ignore-expiryrõ…rö}r÷(h=UhDNhRNhShh>jðubaubj`)rø}rù(h=jch>jåhDhEhFjdhH}rú(jjhM]hL]hJ]hK]hP]uhRNhShhT]rûh]X: rü…rý}rþ(h=UhDNhRNhShh>jøubaubjj)rÿ}r(h=Xbooleanh>jåhDhEhFjmhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]Xbooleanr…r}r(h=UhDNhRNhShh>jÿubaubeubjG)r}r(h=X--ignore-expiryrh>jàhDhEhFjJhH}r (hM]r Xcfg-flag---ignore-expiryr ahL]hJ]hK]hP]jN‰uhRNhShhT]r (j7)r }r(h=Uh>jhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]r(jTX%--ignore-expiry; cabal project optionj UNtrauhRNhShhT]ubjV)r}r(h=jh>jhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X--ignore-expiryr…r}r(h=UhDNhRNhShh>jubaubj`)r}r(h=U h>jhDhEhFjdhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X …r}r(h=UhDNhRNhShh>jubaubeubjs)r}r (h=Uh>jàhDhEhFjvhH}r!(hJ]hK]hL]hM]hP]uhRNhShhT]r"(jy)r#}r$(h=Uh>jhDhEhFj|hH}r%(hJ]hK]hL]hM]hP]uhRNhShhT]r&j)r'}r((h=UhH}r)(hJ]hK]hL]hM]hP]uh>j#hT]r*(j„)r+}r,(h=X Default valueh>j'hDhEhFj‡hH}r-(hJ]hK]hL]hM]hP]uhRKhT]r.h]X Default valuer/…r0}r1(h=Uh>j+ubaubj)r2}r3(h=UhH}r4(hJ]hK]hL]hM]hP]uh>j'hT]r5hp)r6}r7(h=XFalsehH}r8(hJ]hK]hL]hM]hP]uh>j2hT]r9h]XFalser:…r;}r<(h=XFalser=hDNhRNhShh>j6ubahFhtubahFjubehFjžubaubhp)r>}r?(h=XBIf ``True``, we will ignore expiry dates on metadata from Hackage.h>jhDhEhFhthH}r@(hJ]hK]hL]hM]hP]uhRM¿hShhT]rA(h]XIf rB…rC}rD(h=XIf hDNhRNhShh>j>ubh–)rE}rF(h=X``True``hH}rG(hJ]hK]hL]hM]hP]uh>j>hT]rHh]XTruerI…rJ}rK(h=XTrueh>jEubahFhžubh]X7, we will ignore expiry dates on metadata from Hackage.rL…rM}rN(h=X7, we will ignore expiry dates on metadata from Hackage.hDNhRNhShh>j>ubeubhp)rO}rP(h=X In general, you should not set this to ``True`` as it will leave you vulnerable to stale cache attacks. However, it may be temporarily useful if the main Hackage server is down, and we need to rely on mirrors which have not been updated for longer than the expiry period on the timestamp.h>jhDhEhFhthH}rQ(hJ]hK]hL]hM]hP]uhRMÁhShhT]rR(h]X'In general, you should not set this to rS…rT}rU(h=X'In general, you should not set this to hDNhRNhShh>jOubh–)rV}rW(h=X``True``hH}rX(hJ]hK]hL]hM]hP]uh>jOhT]rYh]XTruerZ…r[}r\(h=XTrueh>jVubahFhžubh]Xñ as it will leave you vulnerable to stale cache attacks. However, it may be temporarily useful if the main Hackage server is down, and we need to rely on mirrors which have not been updated for longer than the expiry period on the timestamp.r]…r^}r_(h=Xñ as it will leave you vulnerable to stale cache attacks. However, it may be temporarily useful if the main Hackage server is down, and we need to rely on mirrors which have not been updated for longer than the expiry period on the timestamp.hDNhRNhShh>jOubeubhp)r`}ra(h=X>The command line variant of this field is ``--ignore-expiry``.h>jhDhEhFhthH}rb(hJ]hK]hL]hM]hP]uhRMÇhShhT]rc(h]X*The command line variant of this field is rd…re}rf(h=X*The command line variant of this field is hDNhRNhShh>j`ubh–)rg}rh(h=X``--ignore-expiry``hH}ri(hJ]hK]hL]hM]hP]uh>j`hT]rjh]X--ignore-expiryrk…rl}rm(h=X--ignore-expiryh>jgubahFhžubh]X.…rn}ro(h=X.hDNhRNhShh>j`ubeubeubeubj7)rp}rq(h=Uh>j¨hDhEhFj:hH}rr(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rs}rt(h=Uh>j¨hDhEhFj?hH}ru(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrvjEjvuhRNhShhT]rw(jG)rx}ry(h=Xremote-repo-cache: directoryh>jshDhEhFjJhH}rz(hM]r{Xcfg-field-remote-repo-cacher|ahL]hJ]hK]hP]jN‰uhRNhShhT]r}(j7)r~}r(h=Uh>jxhDhEhFj:hH}r€(hM]hL]hJ]hK]hP]Uentries]r(jTX(remote-repo-cache ; cabal project optionj|UNtr‚auhRNhShhT]ubjV)rƒ}r„(h=Xremote-repo-cacher…h>jxhDhEhFjZhH}r†(jjhM]hL]hJ]hK]hP]uhRNhShhT]r‡h]Xremote-repo-cacherˆ…r‰}rŠ(h=UhDNhRNhShh>jƒubaubj`)r‹}rŒ(h=jch>jxhDhEhFjdhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rŽh]X: r…r}r‘(h=UhDNhRNhShh>j‹ubaubjj)r’}r“(h=X directoryh>jxhDhEhFjmhH}r”(jjhM]hL]hJ]hK]hP]uhRNhShhT]r•h]X directoryr–…r—}r˜(h=UhDNhRNhShh>j’ubaubeubjG)r™}rš(h=X--remote-repo-cache=DIRh>jshDhEhFjJhH}r›(hM]rœXcfg-flag---remote-repo-cacherahL]hJ]hK]hP]jN‰uhRNhShhT]rž(j7)rŸ}r (h=Uh>j™hDhEhFj:hH}r¡(hM]hL]hJ]hK]hP]Uentries]r¢(jTX)--remote-repo-cache; cabal project optionjUNtr£auhRNhShhT]ubjV)r¤}r¥(h=X--remote-repo-cacher¦h>j™hDhEhFjZhH}r§(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¨h]X--remote-repo-cacher©…rª}r«(h=UhDNhRNhShh>j¤ubaubj`)r¬}r­(h=X=DIRh>j™hDhEhFjdhH}r®(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¯h]X=DIRr°…r±}r²(h=UhDNhRNhShh>j¬ubaubeubjs)r³}r´(h=Uh>jshDhEhFjvhH}rµ(hJ]hK]hL]hM]hP]uhRNhShhT]r¶(jy)r·}r¸(h=Uh>j³hDhEhFj|hH}r¹(hJ]hK]hL]hM]hP]uhRNhShhT]rºj)r»}r¼(h=UhH}r½(hJ]hK]hL]hM]hP]uh>j·hT]r¾(j„)r¿}rÀ(h=X Default valueh>j»hDhEhFj‡hH}rÁ(hJ]hK]hL]hM]hP]uhRKhT]rÂh]X Default valuerÃ…rÄ}rÅ(h=Uh>j¿ubaubj)rÆ}rÇ(h=UhH}rÈ(hJ]hK]hL]hM]hP]uh>j»hT]rÉhp)rÊ}rË(h=X~/.cabal/packageshH}rÌ(hJ]hK]hL]hM]hP]uh>jÆhT]rÍh–)rÎ}rÏ(h=X``~/.cabal/packages``h>jÊhDhEhFhžhH}rÐ(hJ]hK]hL]hM]hP]uhRNhShhT]rÑh]X~/.cabal/packagesrÒ…rÓ}rÔ(h=X~/.cabal/packageshDNhRNhShh>jÎubaubahFhtubahFjubehFjžubaubhp)rÕ}rÖ(h=Xp[STRIKEOUT:The location where packages downloaded from remote repositories will be cached.] Not implemented yet.r×h>j³hDhEhFhthH}rØ(hJ]hK]hL]hM]hP]uhRMÏhShhT]rÙh]Xp[STRIKEOUT:The location where packages downloaded from remote repositories will be cached.] Not implemented yet.rÚ…rÛ}rÜ(h=j×hDNhRNhShh>jÕubaubhp)rÝ}rÞ(h=XEThe command line variant of this flag is ``--remote-repo-cache=DIR``.h>j³hDhEhFhthH}rß(hJ]hK]hL]hM]hP]uhRMÒhShhT]rà(h]X)The command line variant of this flag is rá…râ}rã(h=X)The command line variant of this flag is hDNhRNhShh>jÝubh–)rä}rå(h=X``--remote-repo-cache=DIR``hH}ræ(hJ]hK]hL]hM]hP]uh>jÝhT]rçh]X--remote-repo-cache=DIRrè…ré}rê(h=X--remote-repo-cache=DIRh>jäubahFhžubh]X.…rë}rì(h=X.hDNhRNhShh>jÝubeubeubeubj7)rí}rî(h=Uh>j¨hDhEhFj:hH}rï(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rð}rñ(h=Uh>j¨hDhEhFj?hH}rò(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrójEjóuhRNhShhT]rô(jG)rõ}rö(h=Xlogs-dir: directoryh>jðhDhEhFjJhH}r÷(hM]røXcfg-field-logs-dirrùahL]hJ]hK]hP]jN‰uhRNhShhT]rú(j7)rû}rü(h=Uh>jõhDhEhFj:hH}rý(hM]hL]hJ]hK]hP]Uentries]rþ(jTXlogs-dir ; cabal project optionjùUNtrÿauhRNhShhT]ubjV)r}r(h=Xlogs-dirrh>jõhDhEhFjZhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]Xlogs-dirr…r}r(h=UhDNhRNhShh>jubaubj`)r}r (h=jch>jõhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r h]X: r …r }r(h=UhDNhRNhShh>jubaubjj)r}r(h=X directoryh>jõhDhEhFjmhH}r(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X directoryr…r}r(h=UhDNhRNhShh>jubaubeubjG)r}r(h=X--logs-dir=DIRh>jðhDhEhFjJhH}r(hM]rXcfg-flag---logs-dirrahL]hJ]hK]hP]jN‰uhRNhShhT]r(j7)r}r(h=Uh>jhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]r(jTX --logs-dir; cabal project optionjUNtr auhRNhShhT]ubjV)r!}r"(h=X --logs-dirr#h>jhDhEhFjZhH}r$(jjhM]hL]hJ]hK]hP]uhRNhShhT]r%h]X --logs-dirr&…r'}r((h=UhDNhRNhShh>j!ubaubj`)r)}r*(h=X=DIRh>jhDhEhFjdhH}r+(jjhM]hL]hJ]hK]hP]uhRNhShhT]r,h]X=DIRr-…r.}r/(h=UhDNhRNhShh>j)ubaubeubjs)r0}r1(h=Uh>jðhDhEhFjvhH}r2(hJ]hK]hL]hM]hP]uhRNhShhT]r3(jy)r4}r5(h=Uh>j0hDhEhFj|hH}r6(hJ]hK]hL]hM]hP]uhRNhShhT]r7j)r8}r9(h=UhH}r:(hJ]hK]hL]hM]hP]uh>j4hT]r;(j„)r<}r=(h=X Default valueh>j8hDhEhFj‡hH}r>(hJ]hK]hL]hM]hP]uhRKhT]r?h]X Default valuer@…rA}rB(h=Uh>j<ubaubj)rC}rD(h=UhH}rE(hJ]hK]hL]hM]hP]uh>j8hT]rFhp)rG}rH(h=X ~/.cabal/logshH}rI(hJ]hK]hL]hM]hP]uh>jChT]rJh–)rK}rL(h=X``~/.cabal/logs``h>jGhDhEhFhžhH}rM(hJ]hK]hL]hM]hP]uhRNhShhT]rNh]X ~/.cabal/logsrO…rP}rQ(h=X ~/.cabal/logshDNhRNhShh>jKubaubahFhtubahFjubehFjžubaubhp)rR}rS(h=XW[STRIKEOUT:The location where build logs for packages are stored.] Not implemented yet.rTh>j0hDhEhFhthH}rU(hJ]hK]hL]hM]hP]uhRMÛhShhT]rVh]XW[STRIKEOUT:The location where build logs for packages are stored.] Not implemented yet.rW…rX}rY(h=jThDNhRNhShh>jRubaubhp)rZ}r[(h=X<The command line variant of this flag is ``--logs-dir=DIR``.h>j0hDhEhFhthH}r\(hJ]hK]hL]hM]hP]uhRMÞhShhT]r](h]X)The command line variant of this flag is r^…r_}r`(h=X)The command line variant of this flag is hDNhRNhShh>jZubh–)ra}rb(h=X``--logs-dir=DIR``hH}rc(hJ]hK]hL]hM]hP]uh>jZhT]rdh]X--logs-dir=DIRre…rf}rg(h=X--logs-dir=DIRh>jaubahFhžubh]X.…rh}ri(h=X.hDNhRNhShh>jZubeubeubeubj7)rj}rk(h=Uh>j¨hDhEhFj:hH}rl(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rm}rn(h=Uh>j¨hDhEhFj?hH}ro(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrpjEjpuhRNhShhT]rq(jG)rr}rs(h=X build-summary: template filepathh>jmhDhEhFjJhH}rt(hM]ruXcfg-field-build-summaryrvahL]hJ]hK]hP]jN‰uhRNhShhT]rw(j7)rx}ry(h=Uh>jrhDhEhFj:hH}rz(hM]hL]hJ]hK]hP]Uentries]r{(jTX$build-summary ; cabal project optionjvUNtr|auhRNhShhT]ubjV)r}}r~(h=X build-summaryrh>jrhDhEhFjZhH}r€(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X build-summaryr‚…rƒ}r„(h=UhDNhRNhShh>j}ubaubj`)r…}r†(h=jch>jrhDhEhFjdhH}r‡(jjhM]hL]hJ]hK]hP]uhRNhShhT]rˆh]X: r‰…rŠ}r‹(h=UhDNhRNhShh>j…ubaubjj)rŒ}r(h=Xtemplate filepathh>jrhDhEhFjmhH}rŽ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]Xtemplate filepathr…r‘}r’(h=UhDNhRNhShh>jŒubaubeubjG)r“}r”(h=X--build-summary=TEMPLATEh>jmhDhEhFjJhH}r•(hM]r–Xcfg-flag---build-summaryr—ahL]hJ]hK]hP]jN‰uhRNhShhT]r˜(j7)r™}rš(h=Uh>j“hDhEhFj:hH}r›(hM]hL]hJ]hK]hP]Uentries]rœ(jTX%--build-summary; cabal project optionj—UNtrauhRNhShhT]ubjV)rž}rŸ(h=X--build-summaryr h>j“hDhEhFjZhH}r¡(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¢h]X--build-summaryr£…r¤}r¥(h=UhDNhRNhShh>jžubaubj`)r¦}r§(h=X =TEMPLATEh>j“hDhEhFjdhH}r¨(jjhM]hL]hJ]hK]hP]uhRNhShhT]r©h]X =TEMPLATErª…r«}r¬(h=UhDNhRNhShh>j¦ubaubeubjs)r­}r®(h=Uh>jmhDhEhFjvhH}r¯(hJ]hK]hL]hM]hP]uhRNhShhT]r°(jy)r±}r²(h=Uh>j­hDhEhFj|hH}r³(hJ]hK]hL]hM]hP]uhRNhShhT]r´j)rµ}r¶(h=UhH}r·(hJ]hK]hL]hM]hP]uh>j±hT]r¸(j„)r¹}rº(h=X Default valueh>jµhDhEhFj‡hH}r»(hJ]hK]hL]hM]hP]uhRKhT]r¼h]X Default valuer½…r¾}r¿(h=Uh>j¹ubaubj)rÀ}rÁ(h=UhH}rÂ(hJ]hK]hL]hM]hP]uh>jµhT]rÃhp)rÄ}rÅ(h=X~/.cabal/logs/build.loghH}rÆ(hJ]hK]hL]hM]hP]uh>jÀhT]rÇh–)rÈ}rÉ(h=X``~/.cabal/logs/build.log``h>jÄhDhEhFhžhH}rÊ(hJ]hK]hL]hM]hP]uhRNhShhT]rËh]X~/.cabal/logs/build.logrÌ…rÍ}rÎ(h=X~/.cabal/logs/build.loghDNhRNhShh>jÈubaubahFhtubahFjubehFjžubaubhp)rÏ}rÐ(h=X¦[STRIKEOUT:The file to save build summaries. Valid variables which can be used in the path are ``$pkgid``, ``$compiler``, ``$os`` and ``$arch``.] Not implemented yet.h>j­hDhEhFhthH}rÑ(hJ]hK]hL]hM]hP]uhRMæhShhT]rÒ(h]X_[STRIKEOUT:The file to save build summaries. Valid variables which can be used in the path are rÓ…rÔ}rÕ(h=X_[STRIKEOUT:The file to save build summaries. Valid variables which can be used in the path are hDNhRNhShh>jÏubh–)rÖ}r×(h=X ``$pkgid``hH}rØ(hJ]hK]hL]hM]hP]uh>jÏhT]rÙh]X$pkgidrÚ…rÛ}rÜ(h=X$pkgidh>jÖubahFhžubh]X, rÝ…rÞ}rß(h=X, ràhDNhRNhShh>jÏubh–)rá}râ(h=X ``$compiler``hH}rã(hJ]hK]hL]hM]hP]uh>jÏhT]räh]X $compilerrå…ræ}rç(h=X $compilerh>jáubahFhžubh]X, rè…ré}rê(h=jàh>jÏubh–)rë}rì(h=X``$os``hH}rí(hJ]hK]hL]hM]hP]uh>jÏhT]rîh]X$osrï…rð}rñ(h=X$osh>jëubahFhžubh]X and rò…ró}rô(h=X and hDNhRNhShh>jÏubh–)rõ}rö(h=X ``$arch``hH}r÷(hJ]hK]hL]hM]hP]uh>jÏhT]røh]X$archrù…rú}rû(h=X$archh>jõubahFhžubh]X.] Not implemented yet.rü…rý}rþ(h=X.] Not implemented yet.hDNhRNhShh>jÏubeubhp)rÿ}r(h=XFThe command line variant of this flag is ``--build-summary=TEMPLATE``.h>j­hDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMêhShhT]r(h]X)The command line variant of this flag is r…r}r(h=X)The command line variant of this flag is hDNhRNhShh>jÿubh–)r}r(h=X``--build-summary=TEMPLATE``hH}r(hJ]hK]hL]hM]hP]uh>jÿhT]r h]X--build-summary=TEMPLATEr …r }r (h=X--build-summary=TEMPLATEh>jubahFhžubh]X.…r }r(h=X.hDNhRNhShh>jÿubeubeubeubj7)r}r(h=Uh>j¨hDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r}r(h=Uh>j¨hDhEhFj?hH}r(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrjEjuhRNhShhT]r(jG)r}r(h=Xlocal-repo: directoryh>jhDhEhFjJhH}r(hM]rXcfg-field-local-reporahL]hJ]hK]hP]jN‰uhRNhShhT]r(j7)r}r(h=Uh>jhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]r (jTX!local-repo ; cabal project optionjUNtr!auhRNhShhT]ubjV)r"}r#(h=X local-repor$h>jhDhEhFjZhH}r%(jjhM]hL]hJ]hK]hP]uhRNhShhT]r&h]X local-repor'…r(}r)(h=UhDNhRNhShh>j"ubaubj`)r*}r+(h=jch>jhDhEhFjdhH}r,(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-h]X: r.…r/}r0(h=UhDNhRNhShh>j*ubaubjj)r1}r2(h=X directoryh>jhDhEhFjmhH}r3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r4h]X directoryr5…r6}r7(h=UhDNhRNhShh>j1ubaubeubjG)r8}r9(h=X--local-repo=DIRh>jhDhEhFjJhH}r:(hM]r;Xcfg-flag---local-repor<ahL]hJ]hK]hP]jN‰uhRNhShhT]r=(j7)r>}r?(h=Uh>j8hDhEhFj:hH}r@(hM]hL]hJ]hK]hP]Uentries]rA(jTX"--local-repo; cabal project optionj<UNtrBauhRNhShhT]ubjV)rC}rD(h=X --local-reporEh>j8hDhEhFjZhH}rF(jjhM]hL]hJ]hK]hP]uhRNhShhT]rGh]X --local-reporH…rI}rJ(h=UhDNhRNhShh>jCubaubj`)rK}rL(h=X=DIRh>j8hDhEhFjdhH}rM(jjhM]hL]hJ]hK]hP]uhRNhShhT]rNh]X=DIRrO…rP}rQ(h=UhDNhRNhShh>jKubaubeubjs)rR}rS(h=Uh>jhDhEhFjvhH}rT(hJ]hK]hL]hM]hP]uhRNhShhT]rU(jy)rV}rW(h=Uh>jRhDhEhFj|hH}rX(hJ]hK]hL]hM]hP]uhRNhShhT]rYj)rZ}r[(h=Uh>jVhDhEhFjžhH}r\(hJ]hK]hL]hM]hP]uhRNhShhT]r](j„)r^}r_(h=U Deprecatedr`h>jZhDhEhFj‡hH}ra(hJ]hK]hL]hM]hP]uhRKhT]rbh]X Deprecatedrc…rd}re(h=Uh>j^ubaubj)rf}rg(h=UhH}rh(hJ]hK]hL]hM]hP]uh>jZhT]rihp)rj}rk(h=UhH}rl(hJ]hK]hL]hM]hP]uh>jfhT]hFhtubahFjubeubaubhp)rm}rn(h=XV[STRIKEOUT:The location of a local repository.] Deprecated. See "Legacy repositories."roh>jRhDhEhFhthH}rp(hJ]hK]hL]hM]hP]uhRMñhShhT]rqh]XZ[STRIKEOUT:The location of a local repository.] Deprecated. See “Legacy repositories.â€rr…rs}rt(h=johDNhRNhShh>jmubaubhp)ru}rv(h=X>The command line variant of this flag is ``--local-repo=DIR``.h>jRhDhEhFhthH}rw(hJ]hK]hL]hM]hP]uhRMôhShhT]rx(h]X)The command line variant of this flag is ry…rz}r{(h=X)The command line variant of this flag is hDNhRNhShh>juubh–)r|}r}(h=X``--local-repo=DIR``hH}r~(hJ]hK]hL]hM]hP]uh>juhT]rh]X--local-repo=DIRr€…r}r‚(h=X--local-repo=DIRh>j|ubahFhžubh]X.…rƒ}r„(h=X.hDNhRNhShh>juubeubeubeubj7)r…}r†(h=Uh>j¨hDhEhFj:hH}r‡(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rˆ}r‰(h=Uh>j¨hDhEhFj?hH}rŠ(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr‹jEj‹uhRNhShhT]rŒ(jG)r}rŽ(h=Xworld-file: pathh>jˆhDhEhFjJhH}r(hM]rXcfg-field-world-filer‘ahL]hJ]hK]hP]jN‰uhRNhShhT]r’(j7)r“}r”(h=Uh>jhDhEhFj:hH}r•(hM]hL]hJ]hK]hP]Uentries]r–(jTX!world-file ; cabal project optionj‘UNtr—auhRNhShhT]ubjV)r˜}r™(h=X world-fileršh>jhDhEhFjZhH}r›(jjhM]hL]hJ]hK]hP]uhRNhShhT]rœh]X world-filer…rž}rŸ(h=UhDNhRNhShh>j˜ubaubj`)r }r¡(h=jch>jhDhEhFjdhH}r¢(jjhM]hL]hJ]hK]hP]uhRNhShhT]r£h]X: r¤…r¥}r¦(h=UhDNhRNhShh>j ubaubjj)r§}r¨(h=Xpathh>jhDhEhFjmhH}r©(jjhM]hL]hJ]hK]hP]uhRNhShhT]rªh]Xpathr«…r¬}r­(h=UhDNhRNhShh>j§ubaubeubjG)r®}r¯(h=X--world-file=FILEh>jˆhDhEhFjJhH}r°(hM]r±Xcfg-flag---world-filer²ahL]hJ]hK]hP]jN‰uhRNhShhT]r³(j7)r´}rµ(h=Uh>j®hDhEhFj:hH}r¶(hM]hL]hJ]hK]hP]Uentries]r·(jTX"--world-file; cabal project optionj²UNtr¸auhRNhShhT]ubjV)r¹}rº(h=X --world-filer»h>j®hDhEhFjZhH}r¼(jjhM]hL]hJ]hK]hP]uhRNhShhT]r½h]X --world-filer¾…r¿}rÀ(h=UhDNhRNhShh>j¹ubaubj`)rÁ}rÂ(h=X=FILEh>j®hDhEhFjdhH}rÃ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÄh]X=FILErÅ…rÆ}rÇ(h=UhDNhRNhShh>jÁubaubeubjs)rÈ}rÉ(h=Uh>jˆhDhEhFjvhH}rÊ(hJ]hK]hL]hM]hP]uhRNhShhT]rË(jy)rÌ}rÍ(h=Uh>jÈhDhEhFj|hH}rÎ(hJ]hK]hL]hM]hP]uhRNhShhT]rÏj)rÐ}rÑ(h=Uh>jÌhDhEhFjžhH}rÒ(hJ]hK]hL]hM]hP]uhRNhShhT]rÓ(j„)rÔ}rÕ(h=j`h>jÐhDhEhFj‡hH}rÖ(hJ]hK]hL]hM]hP]uhRKhT]r×h]X DeprecatedrØ…rÙ}rÚ(h=Uh>jÔubaubj)rÛ}rÜ(h=UhH}rÝ(hJ]hK]hL]hM]hP]uh>jÐhT]rÞhp)rß}rà(h=UhH}rá(hJ]hK]hL]hM]hP]uh>jÛhT]hFhtubahFjubeubaubhp)râ}rã(h=X7[STRIKEOUT:The location of the world file.] Deprecated.räh>jÈhDhEhFhthH}rå(hJ]hK]hL]hM]hP]uhRMúhShhT]ræh]X7[STRIKEOUT:The location of the world file.] Deprecated.rç…rè}ré(h=jähDNhRNhShh>jâubaubhp)rê}rë(h=X?The command line variant of this flag is ``--world-file=FILE``.h>jÈhDhEhFhthH}rì(hJ]hK]hL]hM]hP]uhRMühShhT]rí(h]X)The command line variant of this flag is rî…rï}rð(h=X)The command line variant of this flag is hDNhRNhShh>jêubh–)rñ}rò(h=X``--world-file=FILE``hH}ró(hJ]hK]hL]hM]hP]uh>jêhT]rôh]X--world-file=FILErõ…rö}r÷(h=X--world-file=FILEh>jñubahFhžubh]X.…rø}rù(h=X.hDNhRNhShh>jêubeubeubeubhp)rú}rû(h=X˜Undocumented fields: ``root-cmd``, ``symlink-bindir``, ``build-log``, ``remote-build-reporting``, ``report-planned-failure``, ``one-shot``, ``offline``.h>j¨hDhEhFhthH}rü(hJ]hK]hL]hM]hP]uhRMþhShhT]rý(h]XUndocumented fields: rþ…rÿ}r(h=XUndocumented fields: hDNhRNhShh>júubh–)r}r(h=X ``root-cmd``hH}r(hJ]hK]hL]hM]hP]uh>júhT]rh]Xroot-cmdr…r}r(h=Xroot-cmdh>jubahFhžubh]X, r…r }r (h=X, r hDNhRNhShh>júubh–)r }r (h=X``symlink-bindir``hH}r(hJ]hK]hL]hM]hP]uh>júhT]rh]Xsymlink-bindirr…r}r(h=Xsymlink-bindirh>j ubahFhžubh]X, r…r}r(h=X, h>júubh–)r}r(h=X ``build-log``hH}r(hJ]hK]hL]hM]hP]uh>júhT]rh]X build-logr…r}r(h=X build-logh>jubahFhžubh]X, r…r}r(h=X, r hDNhRNhShh>júubh–)r!}r"(h=X``remote-build-reporting``hH}r#(hJ]hK]hL]hM]hP]uh>júhT]r$h]Xremote-build-reportingr%…r&}r'(h=Xremote-build-reportingh>j!ubahFhžubh]X, r(…r)}r*(h=X, h>júubh–)r+}r,(h=X``report-planned-failure``hH}r-(hJ]hK]hL]hM]hP]uh>júhT]r.h]Xreport-planned-failurer/…r0}r1(h=Xreport-planned-failureh>j+ubahFhžubh]X, r2…r3}r4(h=j h>júubh–)r5}r6(h=X ``one-shot``hH}r7(hJ]hK]hL]hM]hP]uh>júhT]r8h]Xone-shotr9…r:}r;(h=Xone-shoth>j5ubahFhžubh]X, r<…r=}r>(h=j h>júubh–)r?}r@(h=X ``offline``hH}rA(hJ]hK]hL]hM]hP]uh>júhT]rBh]XofflinerC…rD}rE(h=Xofflineh>j?ubahFhžubh]X.…rF}rG(h=X.hDNhRNhShh>júubeubhp)rH}rI(h=X&Most users generally won't need these.rJh>j¨hDhEhFhthH}rK(hJ]hK]hL]hM]hP]uhRMhShhT]rLh]X(Most users generally won’t need these.rM…rN}rO(h=jJhDNhRNhShh>jHubaubj7)rP}rQ(h=Uh>j¨hDhEhFj:hH}rR(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rS}rT(h=Uh>j¨hDhEhFj?hH}rU(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrVjEjVuhRNhShhT]rW(jG)rX}rY(h=Xsolver: modularh>jShDhEhFjJhH}rZ(hM]r[Xcfg-field-solverr\ahL]hJ]hK]hP]jN‰uhRNhShhT]r](j7)r^}r_(h=Uh>jXhDhEhFj:hH}r`(hM]hL]hJ]hK]hP]Uentries]ra(jTXsolver ; cabal project optionj\UNtrbauhRNhShhT]ubjV)rc}rd(h=Xsolverreh>jXhDhEhFjZhH}rf(jjhM]hL]hJ]hK]hP]uhRNhShhT]rgh]Xsolverrh…ri}rj(h=UhDNhRNhShh>jcubaubj`)rk}rl(h=jch>jXhDhEhFjdhH}rm(jjhM]hL]hJ]hK]hP]uhRNhShhT]rnh]X: ro…rp}rq(h=UhDNhRNhShh>jkubaubjj)rr}rs(h=Xmodularh>jXhDhEhFjmhH}rt(jjhM]hL]hJ]hK]hP]uhRNhShhT]ruh]Xmodularrv…rw}rx(h=UhDNhRNhShh>jrubaubeubjG)ry}rz(h=X--solver=modularh>jShDhEhFjJhH}r{(hM]r|Xcfg-flag---solverr}ahL]hJ]hK]hP]jN‰uhRNhShhT]r~(j7)r}r€(h=Uh>jyhDhEhFj:hH}r(hM]hL]hJ]hK]hP]Uentries]r‚(jTX--solver; cabal project optionj}UNtrƒauhRNhShhT]ubjV)r„}r…(h=X--solverr†h>jyhDhEhFjZhH}r‡(jjhM]hL]hJ]hK]hP]uhRNhShhT]rˆh]X--solverr‰…rŠ}r‹(h=UhDNhRNhShh>j„ubaubj`)rŒ}r(h=X=modularh>jyhDhEhFjdhH}rŽ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X=modularr…r‘}r’(h=UhDNhRNhShh>jŒubaubeubjs)r“}r”(h=Uh>jShDhEhFjvhH}r•(hJ]hK]hL]hM]hP]uhRNhShhT]r–(hp)r—}r˜(h=XŒThis field is reserved to allow the specification of alternative dependency solvers. At the moment, the only accepted option is ``modular``.h>j“hDhEhFhthH}r™(hJ]hK]hL]hM]hP]uhRM hShhT]rš(h]X€This field is reserved to allow the specification of alternative dependency solvers. At the moment, the only accepted option is r›…rœ}r(h=X€This field is reserved to allow the specification of alternative dependency solvers. At the moment, the only accepted option is hDNhRNhShh>j—ubh–)rž}rŸ(h=X ``modular``hH}r (hJ]hK]hL]hM]hP]uh>j—hT]r¡h]Xmodularr¢…r£}r¤(h=Xmodularh>jžubahFhžubh]X.…r¥}r¦(h=X.hDNhRNhShh>j—ubeubhp)r§}r¨(h=X?The command line variant of this field is ``--solver=modular``.h>j“hDhEhFhthH}r©(hJ]hK]hL]hM]hP]uhRMhShhT]rª(h]X*The command line variant of this field is r«…r¬}r­(h=X*The command line variant of this field is hDNhRNhShh>j§ubh–)r®}r¯(h=X``--solver=modular``hH}r°(hJ]hK]hL]hM]hP]uh>j§hT]r±h]X--solver=modularr²…r³}r´(h=X--solver=modularh>j®ubahFhžubh]X.…rµ}r¶(h=X.hDNhRNhShh>j§ubeubeubeubj7)r·}r¸(h=Uh>j¨hDhEhFj:hH}r¹(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rº}r»(h=Uh>j¨hDhEhFj?hH}r¼(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr½jEj½uhRNhShhT]r¾(jG)r¿}rÀ(h=Xmax-backjumps: nath>jºhDhEhFjJhH}rÁ(hM]rÂXcfg-field-max-backjumpsrÃahL]hJ]hK]hP]jN‰uhRNhShhT]rÄ(j7)rÅ}rÆ(h=Uh>j¿hDhEhFj:hH}rÇ(hM]hL]hJ]hK]hP]Uentries]rÈ(jTX$max-backjumps ; cabal project optionjÃUNtrÉauhRNhShhT]ubjV)rÊ}rË(h=X max-backjumpsrÌh>j¿hDhEhFjZhH}rÍ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÎh]X max-backjumpsrÏ…rÐ}rÑ(h=UhDNhRNhShh>jÊubaubj`)rÒ}rÓ(h=jch>j¿hDhEhFjdhH}rÔ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÕh]X: rÖ…r×}rØ(h=UhDNhRNhShh>jÒubaubjj)rÙ}rÚ(h=Xnath>j¿hDhEhFjmhH}rÛ(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÜh]XnatrÝ…rÞ}rß(h=UhDNhRNhShh>jÙubaubeubjG)rà}rá(h=X--max-backjumps=Nh>jºhDhEhFjJhH}râ(hM]rãXcfg-flag---max-backjumpsräahL]hJ]hK]hP]jN‰uhRNhShhT]rå(j7)ræ}rç(h=Uh>jàhDhEhFj:hH}rè(hM]hL]hJ]hK]hP]Uentries]ré(jTX%--max-backjumps; cabal project optionjäUNtrêauhRNhShhT]ubjV)rë}rì(h=X--max-backjumpsríh>jàhDhEhFjZhH}rî(jjhM]hL]hJ]hK]hP]uhRNhShhT]rïh]X--max-backjumpsrð…rñ}rò(h=UhDNhRNhShh>jëubaubj`)ró}rô(h=X=Nh>jàhDhEhFjdhH}rõ(jjhM]hL]hJ]hK]hP]uhRNhShhT]röh]X=Nr÷…rø}rù(h=UhDNhRNhShh>jóubaubeubjs)rú}rû(h=Uh>jºhDhEhFjvhH}rü(hJ]hK]hL]hM]hP]uhRNhShhT]rý(jy)rþ}rÿ(h=Uh>júhDhEhFj|hH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rj)r}r(h=UhH}r(hJ]hK]hL]hM]hP]uh>jþhT]r(j„)r}r(h=X Default valueh>jhDhEhFj‡hH}r(hJ]hK]hL]hM]hP]uhRKhT]r h]X Default valuer …r }r (h=Uh>jubaubj)r }r(h=UhH}r(hJ]hK]hL]hM]hP]uh>jhT]rhp)r}r(h=X4000hH}r(hJ]hK]hL]hM]hP]uh>j hT]rh]X4000r…r}r(h=X4000hDNhRNhShh>jubahFhtubahFjubehFjžubaubhp)r}r(h=X¢Maximum number of backjumps (backtracking multiple steps) allowed while solving. Set -1 to allow unlimited backtracking, and 0 to disable backtracking completely.rh>júhDhEhFhthH}r(hJ]hK]hL]hM]hP]uhRMhShhT]rh]X¢Maximum number of backjumps (backtracking multiple steps) allowed while solving. Set -1 to allow unlimited backtracking, and 0 to disable backtracking completely.r…r}r(h=jhDNhRNhShh>jubaubhp)r }r!(h=XCThe command line variant of this field is ``--max-backjumps=4000``.h>júhDhEhFhthH}r"(hJ]hK]hL]hM]hP]uhRMhShhT]r#(h]X*The command line variant of this field is r$…r%}r&(h=X*The command line variant of this field is hDNhRNhShh>j ubh–)r'}r((h=X``--max-backjumps=4000``hH}r)(hJ]hK]hL]hM]hP]uh>j hT]r*h]X--max-backjumps=4000r+…r,}r-(h=X--max-backjumps=4000h>j'ubahFhžubh]X.…r.}r/(h=X.hDNhRNhShh>j ubeubeubeubj7)r0}r1(h=Uh>j¨hDhEhFj:hH}r2(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r3}r4(h=Uh>j¨hDhEhFj?hH}r5(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr6jEj6uhRNhShhT]r7(jG)r8}r9(h=Xreorder-goals: booleanh>j3hDhEhFjJhH}r:(hM]r;Xcfg-field-reorder-goalsr<ahL]hJ]hK]hP]jN‰uhRNhShhT]r=(j7)r>}r?(h=Uh>j8hDhEhFj:hH}r@(hM]hL]hJ]hK]hP]Uentries]rA(jTX$reorder-goals ; cabal project optionj<UNtrBauhRNhShhT]ubjV)rC}rD(h=X reorder-goalsrEh>j8hDhEhFjZhH}rF(jjhM]hL]hJ]hK]hP]uhRNhShhT]rGh]X reorder-goalsrH…rI}rJ(h=UhDNhRNhShh>jCubaubj`)rK}rL(h=jch>j8hDhEhFjdhH}rM(jjhM]hL]hJ]hK]hP]uhRNhShhT]rNh]X: rO…rP}rQ(h=UhDNhRNhShh>jKubaubjj)rR}rS(h=Xbooleanh>j8hDhEhFjmhH}rT(jjhM]hL]hJ]hK]hP]uhRNhShhT]rUh]XbooleanrV…rW}rX(h=UhDNhRNhShh>jRubaubeubjG)rY}rZ(h=X--reorder-goalsr[h>j3hDhEhFjJhH}r\(hM]r]Xcfg-flag---reorder-goalsr^ahL]hJ]hK]hP]jN‰uhRNhShhT]r_(j7)r`}ra(h=Uh>jYhDhEhFj:hH}rb(hM]hL]hJ]hK]hP]Uentries]rc(jTX%--reorder-goals; cabal project optionj^UNtrdauhRNhShhT]ubjV)re}rf(h=j[h>jYhDhEhFjZhH}rg(jjhM]hL]hJ]hK]hP]uhRNhShhT]rhh]X--reorder-goalsri…rj}rk(h=UhDNhRNhShh>jeubaubj`)rl}rm(h=U h>jYhDhEhFjdhH}rn(jjhM]hL]hJ]hK]hP]uhRNhShhT]roh]X …rp}rq(h=UhDNhRNhShh>jlubaubeubjG)rr}rs(h=X--no-reorder-goalsrth>j3hDhEhFjJhH}ru(hM]rvXcfg-flag---no-reorder-goalsrwahL]hJ]hK]hP]jN‰uhRNhShhT]rx(j7)ry}rz(h=Uh>jrhDhEhFj:hH}r{(hM]hL]hJ]hK]hP]Uentries]r|(jTX(--no-reorder-goals; cabal project optionjwUNtr}auhRNhShhT]ubjV)r~}r(h=jth>jrhDhEhFjZhH}r€(jjhM]hL]hJ]hK]hP]uhRNhShhT]rh]X--no-reorder-goalsr‚…rƒ}r„(h=UhDNhRNhShh>j~ubaubj`)r…}r†(h=U h>jrhDhEhFjdhH}r‡(jjhM]hL]hJ]hK]hP]uhRNhShhT]rˆh]X …r‰}rŠ(h=UhDNhRNhShh>j…ubaubeubjs)r‹}rŒ(h=Uh>j3hDhEhFjvhH}r(hJ]hK]hL]hM]hP]uhRNhShhT]rŽ(jy)r}r(h=Uh>j‹hDhEhFj|hH}r‘(hJ]hK]hL]hM]hP]uhRNhShhT]r’j)r“}r”(h=UhH}r•(hJ]hK]hL]hM]hP]uh>jhT]r–(j„)r—}r˜(h=X Default valueh>j“hDhEhFj‡hH}r™(hJ]hK]hL]hM]hP]uhRKhT]ršh]X Default valuer›…rœ}r(h=Uh>j—ubaubj)rž}rŸ(h=UhH}r (hJ]hK]hL]hM]hP]uh>j“hT]r¡hp)r¢}r£(h=XFalsehH}r¤(hJ]hK]hL]hM]hP]uh>jžhT]r¥h]XFalser¦…r§}r¨(h=XFalsehDNhRNhShh>j¢ubahFhtubahFjubehFjžubaubhp)r©}rª(h=XJWhen enabled, the solver will reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. It's unlikely to help for small projects, but for big install plans it may help you find a plan when otherwise this is not possible. See :issue:`1780` for more commentary.h>j‹hDhEhFhthH}r«(hJ]hK]hL]hM]hP]uhRM$hShhT]r¬(h]X*When enabled, the solver will reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. It’s unlikely to help for small projects, but for big install plans it may help you find a plan when otherwise this is not possible. See r­…r®}r¯(h=X(When enabled, the solver will reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. It's unlikely to help for small projects, but for big install plans it may help you find a plan when otherwise this is not possible. See hDNhRNhShh>j©ubjæ)r°}r±(h=X#1780hH}r²(UrefuriX,https://github.com/haskell/cabal/issues/1780hM]hL]hJ]hK]hP]Uinternal‰uh>j©hT]r³h]X#1780r´…rµ}r¶(h=X1780h>j°ubahFjïubh]X for more commentary.r·…r¸}r¹(h=X for more commentary.hDNhRNhShh>j©ubeubhp)rº}r»(h=XCThe command line variant of this field is ``--(no-)reorder-goals``.h>j‹hDhEhFhthH}r¼(hJ]hK]hL]hM]hP]uhRM*hShhT]r½(h]X*The command line variant of this field is r¾…r¿}rÀ(h=X*The command line variant of this field is hDNhRNhShh>jºubh–)rÁ}rÂ(h=X``--(no-)reorder-goals``hH}rÃ(hJ]hK]hL]hM]hP]uh>jºhT]rÄh]X--(no-)reorder-goalsrÅ…rÆ}rÇ(h=X--(no-)reorder-goalsh>jÁubahFhžubh]X.…rÈ}rÉ(h=X.hDNhRNhShh>jºubeubeubeubj7)rÊ}rË(h=Uh>j¨hDhEhFj:hH}rÌ(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rÍ}rÎ(h=Uh>j¨hDhEhFj?hH}rÏ(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrÐjEjÐuhRNhShhT]rÑ(jG)rÒ}rÓ(h=Xcount-conflicts: booleanh>jÍhDhEhFjJhH}rÔ(hM]rÕXcfg-field-count-conflictsrÖahL]hJ]hK]hP]jN‰uhRNhShhT]r×(j7)rØ}rÙ(h=Uh>jÒhDhEhFj:hH}rÚ(hM]hL]hJ]hK]hP]Uentries]rÛ(jTX&count-conflicts ; cabal project optionjÖUNtrÜauhRNhShhT]ubjV)rÝ}rÞ(h=Xcount-conflictsrßh>jÒhDhEhFjZhH}rà(jjhM]hL]hJ]hK]hP]uhRNhShhT]ráh]Xcount-conflictsrâ…rã}rä(h=UhDNhRNhShh>jÝubaubj`)rå}ræ(h=jch>jÒhDhEhFjdhH}rç(jjhM]hL]hJ]hK]hP]uhRNhShhT]rèh]X: ré…rê}rë(h=UhDNhRNhShh>jåubaubjj)rì}rí(h=Xbooleanh>jÒhDhEhFjmhH}rî(jjhM]hL]hJ]hK]hP]uhRNhShhT]rïh]Xbooleanrð…rñ}rò(h=UhDNhRNhShh>jìubaubeubjG)ró}rô(h=X--count-conflictsrõh>jÍhDhEhFjJhH}rö(hM]r÷Xcfg-flag---count-conflictsrøahL]hJ]hK]hP]jN‰uhRNhShhT]rù(j7)rú}rû(h=Uh>jóhDhEhFj:hH}rü(hM]hL]hJ]hK]hP]Uentries]rý(jTX'--count-conflicts; cabal project optionjøUNtrþauhRNhShhT]ubjV)rÿ}r (h=jõh>jóhDhEhFjZhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r h]X--count-conflictsr …r }r (h=UhDNhRNhShh>jÿubaubj`)r }r (h=U h>jóhDhEhFjdhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r h]X …r }r (h=UhDNhRNhShh>j ubaubeubjG)r }r (h=X--no-count-conflictsr h>jÍhDhEhFjJhH}r (hM]r Xcfg-flag---no-count-conflictsr ahL]hJ]hK]hP]jN‰uhRNhShhT]r (j7)r }r (h=Uh>j hDhEhFj:hH}r (hM]hL]hJ]hK]hP]Uentries]r (jTX*--no-count-conflicts; cabal project optionj UNtr auhRNhShhT]ubjV)r }r (h=j h>j hDhEhFjZhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r h]X--no-count-conflictsr …r }r (h=UhDNhRNhShh>j ubaubj`)r }r (h=U h>j hDhEhFjdhH}r! (jjhM]hL]hJ]hK]hP]uhRNhShhT]r" h]X …r# }r$ (h=UhDNhRNhShh>j ubaubeubjs)r% }r& (h=Uh>jÍhDhEhFjvhH}r' (hJ]hK]hL]hM]hP]uhRNhShhT]r( (jy)r) }r* (h=Uh>j% hDhEhFj|hH}r+ (hJ]hK]hL]hM]hP]uhRNhShhT]r, j)r- }r. (h=UhH}r/ (hJ]hK]hL]hM]hP]uh>j) hT]r0 (j„)r1 }r2 (h=X Default valueh>j- hDhEhFj‡hH}r3 (hJ]hK]hL]hM]hP]uhRKhT]r4 h]X Default valuer5 …r6 }r7 (h=Uh>j1 ubaubj)r8 }r9 (h=UhH}r: (hJ]hK]hL]hM]hP]uh>j- hT]r; hp)r< }r= (h=XTruehH}r> (hJ]hK]hL]hM]hP]uh>j8 hT]r? h]XTruer@ …rA }rB (h=XTruehDNhRNhShh>j< ubahFhtubahFjubehFjžubaubhp)rC }rD (h=XTTry to speed up solving by preferring goals that are involved in a lot of conflicts.rE h>j% hDhEhFhthH}rF (hJ]hK]hL]hM]hP]uhRM3hShhT]rG h]XTTry to speed up solving by preferring goals that are involved in a lot of conflicts.rH …rI }rJ (h=jE hDNhRNhShh>jC ubaubhp)rK }rL (h=XEThe command line variant of this field is ``--(no-)count-conflicts``.h>j% hDhEhFhthH}rM (hJ]hK]hL]hM]hP]uhRM6hShhT]rN (h]X*The command line variant of this field is rO …rP }rQ (h=X*The command line variant of this field is hDNhRNhShh>jK ubh–)rR }rS (h=X``--(no-)count-conflicts``hH}rT (hJ]hK]hL]hM]hP]uh>jK hT]rU h]X--(no-)count-conflictsrV …rW }rX (h=X--(no-)count-conflictsh>jR ubahFhžubh]X.…rY }rZ (h=X.hDNhRNhShh>jK ubeubeubeubj7)r[ }r\ (h=Uh>j¨hDhEhFj:hH}r] (hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r^ }r_ (h=Uh>j¨hDhEhFj?hH}r` (jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldra jEja uhRNhShhT]rb (jG)rc }rd (h=Xminimize-conflict-set: booleanh>j^ hDhEhFjJhH}re (hM]rf Xcfg-field-minimize-conflict-setrg ahL]hJ]hK]hP]jN‰uhRNhShhT]rh (j7)ri }rj (h=Uh>jc hDhEhFj:hH}rk (hM]hL]hJ]hK]hP]Uentries]rl (jTX,minimize-conflict-set ; cabal project optionjg UNtrm auhRNhShhT]ubjV)rn }ro (h=Xminimize-conflict-setrp h>jc hDhEhFjZhH}rq (jjhM]hL]hJ]hK]hP]uhRNhShhT]rr h]Xminimize-conflict-setrs …rt }ru (h=UhDNhRNhShh>jn ubaubj`)rv }rw (h=jch>jc hDhEhFjdhH}rx (jjhM]hL]hJ]hK]hP]uhRNhShhT]ry h]X: rz …r{ }r| (h=UhDNhRNhShh>jv ubaubjj)r} }r~ (h=Xbooleanh>jc hDhEhFjmhH}r (jjhM]hL]hJ]hK]hP]uhRNhShhT]r€ h]Xbooleanr …r‚ }rƒ (h=UhDNhRNhShh>j} ubaubeubjG)r„ }r… (h=X--minimize-conflict-setr† h>j^ hDhEhFjJhH}r‡ (hM]rˆ X cfg-flag---minimize-conflict-setr‰ ahL]hJ]hK]hP]jN‰uhRNhShhT]rŠ (j7)r‹ }rŒ (h=Uh>j„ hDhEhFj:hH}r (hM]hL]hJ]hK]hP]Uentries]rŽ (jTX---minimize-conflict-set; cabal project optionj‰ UNtr auhRNhShhT]ubjV)r }r‘ (h=j† h>j„ hDhEhFjZhH}r’ (jjhM]hL]hJ]hK]hP]uhRNhShhT]r“ h]X--minimize-conflict-setr” …r• }r– (h=UhDNhRNhShh>j ubaubj`)r— }r˜ (h=U h>j„ hDhEhFjdhH}r™ (jjhM]hL]hJ]hK]hP]uhRNhShhT]rš h]X …r› }rœ (h=UhDNhRNhShh>j— ubaubeubjG)r }rž (h=X--no-minimize-conflict-setrŸ h>j^ hDhEhFjJhH}r  (hM]r¡ X#cfg-flag---no-minimize-conflict-setr¢ ahL]hJ]hK]hP]jN‰uhRNhShhT]r£ (j7)r¤ }r¥ (h=Uh>j hDhEhFj:hH}r¦ (hM]hL]hJ]hK]hP]Uentries]r§ (jTX0--no-minimize-conflict-set; cabal project optionj¢ UNtr¨ auhRNhShhT]ubjV)r© }rª (h=jŸ h>j hDhEhFjZhH}r« (jjhM]hL]hJ]hK]hP]uhRNhShhT]r¬ h]X--no-minimize-conflict-setr­ …r® }r¯ (h=UhDNhRNhShh>j© ubaubj`)r° }r± (h=U h>j hDhEhFjdhH}r² (jjhM]hL]hJ]hK]hP]uhRNhShhT]r³ h]X …r´ }rµ (h=UhDNhRNhShh>j° ubaubeubjs)r¶ }r· (h=Uh>j^ hDhEhFjvhH}r¸ (hJ]hK]hL]hM]hP]uhRNhShhT]r¹ (jy)rº }r» (h=Uh>j¶ hDhEhFj|hH}r¼ (hJ]hK]hL]hM]hP]uhRNhShhT]r½ j)r¾ }r¿ (h=UhH}rÀ (hJ]hK]hL]hM]hP]uh>jº hT]rÁ (j„)r }rà (h=X Default valueh>j¾ hDhEhFj‡hH}rÄ (hJ]hK]hL]hM]hP]uhRKhT]rÅ h]X Default valuerÆ …rÇ }rÈ (h=Uh>j ubaubj)rÉ }rÊ (h=UhH}rË (hJ]hK]hL]hM]hP]uh>j¾ hT]rÌ hp)rÍ }rÎ (h=XFalsehH}rÏ (hJ]hK]hL]hM]hP]uh>jÉ hT]rÐ h]XFalserÑ …rÒ }rÓ (h=XFalsehDNhRNhShh>jÍ ubahFhtubahFjubehFjžubaubhp)rÔ }rÕ (h=X¯When there is no solution, try to improve the solver error message by finding a minimal conflict set. This option may increase run time significantly, so it is off by default.rÖ h>j¶ hDhEhFhthH}r× (hJ]hK]hL]hM]hP]uhRMAhShhT]rØ h]X¯When there is no solution, try to improve the solver error message by finding a minimal conflict set. This option may increase run time significantly, so it is off by default.rÙ …rÚ }rÛ (h=jÖ hDNhRNhShh>jÔ ubaubhp)rÜ }rÝ (h=XKThe command line variant of this field is ``--(no-)minimize-conflict-set``.h>j¶ hDhEhFhthH}rÞ (hJ]hK]hL]hM]hP]uhRMEhShhT]rß (h]X*The command line variant of this field is rà …rá }râ (h=X*The command line variant of this field is hDNhRNhShh>jÜ ubh–)rã }rä (h=X ``--(no-)minimize-conflict-set``hH}rå (hJ]hK]hL]hM]hP]uh>jÜ hT]ræ h]X--(no-)minimize-conflict-setrç …rè }ré (h=X--(no-)minimize-conflict-seth>jã ubahFhžubh]X.…rê }rë (h=X.hDNhRNhShh>jÜ ubeubeubeubj7)rì }rí (h=Uh>j¨hDhEhFj:hH}rî (hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rï }rð (h=Uh>j¨hDhEhFj?hH}rñ (jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrò jEjò uhRNhShhT]ró (jG)rô }rõ (h=Xstrong-flags: booleanh>jï hDhEhFjJhH}rö (hM]r÷ Xcfg-field-strong-flagsrø ahL]hJ]hK]hP]jN‰uhRNhShhT]rù (j7)rú }rû (h=Uh>jô hDhEhFj:hH}rü (hM]hL]hJ]hK]hP]Uentries]rý (jTX#strong-flags ; cabal project optionjø UNtrþ auhRNhShhT]ubjV)rÿ }r!(h=X strong-flagsr!h>jô hDhEhFjZhH}r!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r!h]X strong-flagsr!…r!}r!(h=UhDNhRNhShh>jÿ ubaubj`)r!}r!(h=jch>jô hDhEhFjdhH}r !(jjhM]hL]hJ]hK]hP]uhRNhShhT]r !h]X: r !…r !}r !(h=UhDNhRNhShh>j!ubaubjj)r!}r!(h=Xbooleanh>jô hDhEhFjmhH}r!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r!h]Xbooleanr!…r!}r!(h=UhDNhRNhShh>j!ubaubeubjG)r!}r!(h=X--strong-flagsr!h>jï hDhEhFjJhH}r!(hM]r!Xcfg-flag---strong-flagsr!ahL]hJ]hK]hP]jN‰uhRNhShhT]r!(j7)r!}r!(h=Uh>j!hDhEhFj:hH}r!(hM]hL]hJ]hK]hP]Uentries]r!(jTX$--strong-flags; cabal project optionj!UNtr !auhRNhShhT]ubjV)r!!}r"!(h=j!h>j!hDhEhFjZhH}r#!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r$!h]X--strong-flagsr%!…r&!}r'!(h=UhDNhRNhShh>j!!ubaubj`)r(!}r)!(h=U h>j!hDhEhFjdhH}r*!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r+!h]X …r,!}r-!(h=UhDNhRNhShh>j(!ubaubeubjG)r.!}r/!(h=X--no-strong-flagsr0!h>jï hDhEhFjJhH}r1!(hM]r2!Xcfg-flag---no-strong-flagsr3!ahL]hJ]hK]hP]jN‰uhRNhShhT]r4!(j7)r5!}r6!(h=Uh>j.!hDhEhFj:hH}r7!(hM]hL]hJ]hK]hP]Uentries]r8!(jTX'--no-strong-flags; cabal project optionj3!UNtr9!auhRNhShhT]ubjV)r:!}r;!(h=j0!h>j.!hDhEhFjZhH}r!…r?!}r@!(h=UhDNhRNhShh>j:!ubaubj`)rA!}rB!(h=U h>j.!hDhEhFjdhH}rC!(jjhM]hL]hJ]hK]hP]uhRNhShhT]rD!h]X …rE!}rF!(h=UhDNhRNhShh>jA!ubaubeubjs)rG!}rH!(h=Uh>jï hDhEhFjvhH}rI!(hJ]hK]hL]hM]hP]uhRNhShhT]rJ!(jy)rK!}rL!(h=Uh>jG!hDhEhFj|hH}rM!(hJ]hK]hL]hM]hP]uhRNhShhT]rN!j)rO!}rP!(h=UhH}rQ!(hJ]hK]hL]hM]hP]uh>jK!hT]rR!(j„)rS!}rT!(h=X Default valueh>jO!hDhEhFj‡hH}rU!(hJ]hK]hL]hM]hP]uhRKhT]rV!h]X Default valuerW!…rX!}rY!(h=Uh>jS!ubaubj)rZ!}r[!(h=UhH}r\!(hJ]hK]hL]hM]hP]uh>jO!hT]r]!hp)r^!}r_!(h=XFalsehH}r`!(hJ]hK]hL]hM]hP]uh>jZ!hT]ra!h]XFalserb!…rc!}rd!(h=XFalsehDNhRNhShh>j^!ubahFhtubahFjubehFjžubaubhp)re!}rf!(h=X8Do not defer flag choices. (TODO: Better documentation.)rg!h>jG!hDhEhFhthH}rh!(hJ]hK]hL]hM]hP]uhRMOhShhT]ri!h]X8Do not defer flag choices. (TODO: Better documentation.)rj!…rk!}rl!(h=jg!hDNhRNhShh>je!ubaubhp)rm!}rn!(h=XBThe command line variant of this field is ``--(no-)strong-flags``.h>jG!hDhEhFhthH}ro!(hJ]hK]hL]hM]hP]uhRMQhShhT]rp!(h]X*The command line variant of this field is rq!…rr!}rs!(h=X*The command line variant of this field is hDNhRNhShh>jm!ubh–)rt!}ru!(h=X``--(no-)strong-flags``hH}rv!(hJ]hK]hL]hM]hP]uh>jm!hT]rw!h]X--(no-)strong-flagsrx!…ry!}rz!(h=X--(no-)strong-flagsh>jt!ubahFhžubh]X.…r{!}r|!(h=X.hDNhRNhShh>jm!ubeubeubeubj7)r}!}r~!(h=Uh>j¨hDhEhFj:hH}r!(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r€!}r!(h=Uh>j¨hDhEhFj?hH}r‚!(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrƒ!jEjƒ!uhRNhShhT]r„!(jG)r…!}r†!(h=X$allow-boot-library-installs: booleanh>j€!hDhEhFjJhH}r‡!(hM]rˆ!X%cfg-field-allow-boot-library-installsr‰!ahL]hJ]hK]hP]jN‰uhRNhShhT]rŠ!(j7)r‹!}rŒ!(h=Uh>j…!hDhEhFj:hH}r!(hM]hL]hJ]hK]hP]Uentries]rŽ!(jTX2allow-boot-library-installs ; cabal project optionj‰!UNtr!auhRNhShhT]ubjV)r!}r‘!(h=Xallow-boot-library-installsr’!h>j…!hDhEhFjZhH}r“!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r”!h]Xallow-boot-library-installsr•!…r–!}r—!(h=UhDNhRNhShh>j!ubaubj`)r˜!}r™!(h=jch>j…!hDhEhFjdhH}rš!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r›!h]X: rœ!…r!}rž!(h=UhDNhRNhShh>j˜!ubaubjj)rŸ!}r !(h=Xbooleanh>j…!hDhEhFjmhH}r¡!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¢!h]Xbooleanr£!…r¤!}r¥!(h=UhDNhRNhShh>jŸ!ubaubeubjG)r¦!}r§!(h=X--allow-boot-library-installsr¨!h>j€!hDhEhFjJhH}r©!(hM]rª!X&cfg-flag---allow-boot-library-installsr«!ahL]hJ]hK]hP]jN‰uhRNhShhT]r¬!(j7)r­!}r®!(h=Uh>j¦!hDhEhFj:hH}r¯!(hM]hL]hJ]hK]hP]Uentries]r°!(jTX3--allow-boot-library-installs; cabal project optionj«!UNtr±!auhRNhShhT]ubjV)r²!}r³!(h=j¨!h>j¦!hDhEhFjZhH}r´!(jjhM]hL]hJ]hK]hP]uhRNhShhT]rµ!h]X--allow-boot-library-installsr¶!…r·!}r¸!(h=UhDNhRNhShh>j²!ubaubj`)r¹!}rº!(h=U h>j¦!hDhEhFjdhH}r»!(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¼!h]X …r½!}r¾!(h=UhDNhRNhShh>j¹!ubaubeubjG)r¿!}rÀ!(h=X --no-allow-boot-library-installsrÁ!h>j€!hDhEhFjJhH}rÂ!(hM]rÃ!X)cfg-flag---no-allow-boot-library-installsrÄ!ahL]hJ]hK]hP]jN‰uhRNhShhT]rÅ!(j7)rÆ!}rÇ!(h=Uh>j¿!hDhEhFj:hH}rÈ!(hM]hL]hJ]hK]hP]Uentries]rÉ!(jTX6--no-allow-boot-library-installs; cabal project optionjÄ!UNtrÊ!auhRNhShhT]ubjV)rË!}rÌ!(h=jÁ!h>j¿!hDhEhFjZhH}rÍ!(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÎ!h]X --no-allow-boot-library-installsrÏ!…rÐ!}rÑ!(h=UhDNhRNhShh>jË!ubaubj`)rÒ!}rÓ!(h=U h>j¿!hDhEhFjdhH}rÔ!(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÕ!h]X …rÖ!}r×!(h=UhDNhRNhShh>jÒ!ubaubeubjs)rØ!}rÙ!(h=Uh>j€!hDhEhFjvhH}rÚ!(hJ]hK]hL]hM]hP]uhRNhShhT]rÛ!(jy)rÜ!}rÝ!(h=Uh>jØ!hDhEhFj|hH}rÞ!(hJ]hK]hL]hM]hP]uhRNhShhT]rß!j)rà!}rá!(h=UhH}râ!(hJ]hK]hL]hM]hP]uh>jÜ!hT]rã!(j„)rä!}rå!(h=X Default valueh>jà!hDhEhFj‡hH}ræ!(hJ]hK]hL]hM]hP]uhRKhT]rç!h]X Default valuerè!…ré!}rê!(h=Uh>jä!ubaubj)rë!}rì!(h=UhH}rí!(hJ]hK]hL]hM]hP]uh>jà!hT]rî!hp)rï!}rð!(h=XFalsehH}rñ!(hJ]hK]hL]hM]hP]uh>jë!hT]rò!h]XFalseró!…rô!}rõ!(h=XFalserö!hDNhRNhShh>jï!ubahFhtubahFjubehFjžubaubhp)r÷!}rø!(h=XÅBy default, the dependency solver doesn't allow ``base``, ``ghc-prim``, ``integer-simple``, ``integer-gmp``, and ``template-haskell`` to be installed or upgraded. This flag removes the restriction.h>jØ!hDhEhFhthH}rù!(hJ]hK]hL]hM]hP]uhRMZhShhT]rú!(h]X2By default, the dependency solver doesn’t allow rû!…rü!}rý!(h=X0By default, the dependency solver doesn't allow hDNhRNhShh>j÷!ubh–)rþ!}rÿ!(h=X``base``hH}r"(hJ]hK]hL]hM]hP]uh>j÷!hT]r"h]Xbaser"…r"}r"(h=Xbaseh>jþ!ubahFhžubh]X, r"…r"}r"(h=X, hDNhRNhShh>j÷!ubh–)r"}r "(h=X ``ghc-prim``hH}r "(hJ]hK]hL]hM]hP]uh>j÷!hT]r "h]Xghc-primr "…r "}r"(h=Xghc-primh>j"ubahFhžubh]X, r"…r"}r"(h=X, r"hDNhRNhShh>j÷!ubh–)r"}r"(h=X``integer-simple``hH}r"(hJ]hK]hL]hM]hP]uh>j÷!hT]r"h]Xinteger-simpler"…r"}r"(h=Xinteger-simpleh>j"ubahFhžubh]X, r"…r"}r"(h=j"h>j÷!ubh–)r"}r"(h=X``integer-gmp``hH}r"(hJ]hK]hL]hM]hP]uh>j÷!hT]r "h]X integer-gmpr!"…r""}r#"(h=X integer-gmph>j"ubahFhžubh]X, and r$"…r%"}r&"(h=X, and hDNhRNhShh>j÷!ubh–)r'"}r("(h=X``template-haskell``hH}r)"(hJ]hK]hL]hM]hP]uh>j÷!hT]r*"h]Xtemplate-haskellr+"…r,"}r-"(h=Xtemplate-haskellh>j'"ubahFhžubh]X@ to be installed or upgraded. This flag removes the restriction.r."…r/"}r0"(h=X@ to be installed or upgraded. This flag removes the restriction.hDNhRNhShh>j÷!ubeubhp)r1"}r2"(h=XQThe command line variant of this field is ``--(no-)allow-boot-library-installs``.h>jØ!hDhEhFhthH}r3"(hJ]hK]hL]hM]hP]uhRM_hShhT]r4"(h]X*The command line variant of this field is r5"…r6"}r7"(h=X*The command line variant of this field is hDNhRNhShh>j1"ubh–)r8"}r9"(h=X&``--(no-)allow-boot-library-installs``hH}r:"(hJ]hK]hL]hM]hP]uh>j1"hT]r;"h]X"--(no-)allow-boot-library-installsr<"…r="}r>"(h=X"--(no-)allow-boot-library-installsh>j8"ubahFhžubh]X.…r?"}r@"(h=X.hDNhRNhShh>j1"ubeubeubeubj7)rA"}rB"(h=Uh>j¨hDhEhFj:hH}rC"(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rD"}rE"(h=Uh>j¨hDhEhFj?hH}rF"(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrG"jEjG"uhRNhShhT]rH"(jG)rI"}rJ"(h=Xcabal-lib-version: versionh>jD"hDhEhFjJhH}rK"(hM]rL"Xcfg-field-cabal-lib-versionrM"ahL]hJ]hK]hP]jN‰uhRNhShhT]rN"(j7)rO"}rP"(h=Uh>jI"hDhEhFj:hH}rQ"(hM]hL]hJ]hK]hP]Uentries]rR"(jTX(cabal-lib-version ; cabal project optionjM"UNtrS"auhRNhShhT]ubjV)rT"}rU"(h=Xcabal-lib-versionrV"h>jI"hDhEhFjZhH}rW"(jjhM]hL]hJ]hK]hP]uhRNhShhT]rX"h]Xcabal-lib-versionrY"…rZ"}r["(h=UhDNhRNhShh>jT"ubaubj`)r\"}r]"(h=jch>jI"hDhEhFjdhH}r^"(jjhM]hL]hJ]hK]hP]uhRNhShhT]r_"h]X: r`"…ra"}rb"(h=UhDNhRNhShh>j\"ubaubjj)rc"}rd"(h=Xversionh>jI"hDhEhFjmhH}re"(jjhM]hL]hJ]hK]hP]uhRNhShhT]rf"h]Xversionrg"…rh"}ri"(h=UhDNhRNhShh>jc"ubaubeubjG)rj"}rk"(h=X--cabal-lib-version=versionh>jD"hDhEhFjJhH}rl"(hM]rm"Xcfg-flag---cabal-lib-versionrn"ahL]hJ]hK]hP]jN‰uhRNhShhT]ro"(j7)rp"}rq"(h=Uh>jj"hDhEhFj:hH}rr"(hM]hL]hJ]hK]hP]Uentries]rs"(jTX)--cabal-lib-version; cabal project optionjn"UNtrt"auhRNhShhT]ubjV)ru"}rv"(h=X--cabal-lib-versionrw"h>jj"hDhEhFjZhH}rx"(jjhM]hL]hJ]hK]hP]uhRNhShhT]ry"h]X--cabal-lib-versionrz"…r{"}r|"(h=UhDNhRNhShh>ju"ubaubj`)r}"}r~"(h=X=versionh>jj"hDhEhFjdhH}r"(jjhM]hL]hJ]hK]hP]uhRNhShhT]r€"h]X=versionr"…r‚"}rƒ"(h=UhDNhRNhShh>j}"ubaubeubjs)r„"}r…"(h=Uh>jD"hDhEhFjvhH}r†"(hJ]hK]hL]hM]hP]uhRNhShhT]r‡"(hp)rˆ"}r‰"(h=X(This field selects the version of the Cabal library which should be used to build packages. This option is intended primarily for internal development use (e.g., forcing a package to build with a newer version of Cabal, to test a new version of Cabal.) (TODO: Specify its semantics more clearly.)rŠ"h>j„"hDhEhFhthH}r‹"(hJ]hK]hL]hM]hP]uhRMfhShhT]rŒ"h]X(This field selects the version of the Cabal library which should be used to build packages. This option is intended primarily for internal development use (e.g., forcing a package to build with a newer version of Cabal, to test a new version of Cabal.) (TODO: Specify its semantics more clearly.)r"…rŽ"}r"(h=jŠ"hDNhRNhShh>jˆ"ubaubhp)r"}r‘"(h=XKThe command line variant of this field is ``--cabal-lib-version=1.24.0.1``.h>j„"hDhEhFhthH}r’"(hJ]hK]hL]hM]hP]uhRMlhShhT]r“"(h]X*The command line variant of this field is r”"…r•"}r–"(h=X*The command line variant of this field is hDNhRNhShh>j"ubh–)r—"}r˜"(h=X ``--cabal-lib-version=1.24.0.1``hH}r™"(hJ]hK]hL]hM]hP]uh>j"hT]rš"h]X--cabal-lib-version=1.24.0.1r›"…rœ"}r"(h=X--cabal-lib-version=1.24.0.1h>j—"ubahFhžubh]X.…rž"}rŸ"(h=X.hDNhRNhShh>j"ubeubeubeubcdocutils.nodes comment r ")r¡"}r¢"(h=X[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyh>j¨hDcdocutils.nodes reprunicode r£"Xdoc/references.incr¤"…r¥"}r¦"bhFUcommentr§"hH}r¨"(jjhM]hL]hJ]hK]hP]uhRKhShhT]r©"h]X[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyrª"…r«"}r¬"(h=Uh>j¡"ubaubjý)r­"}r®"(h=X .. _`Package Versioning Policy`:h>j¨hDj¥"hFjhH}r¯"(hM]hL]hJ]hK]hP]jUpackage-versioning-policyr°"uhRMuhShhT]ubjý)r±"}r²"(h=X .. _PVP: http://pvp.haskell.org/h>j¨hDj¥"j}r³"h j­"shFjhH}r´"(jêXhttp://pvp.haskell.org/hM]rµ"(Upvpr¶"j°"ehL]hJ]hK]hP]r·"(h%h euhRMvhShj}r¸"j°"j­"shT]ubjý)r¹"}rº"(h=X(.. _Hackage: http://hackage.haskell.org/h>j¨hDj¥"hFjhH}r»"(jêXhttp://hackage.haskell.org/hM]r¼"Uhackager½"ahL]hJ]hK]hP]r¾"hauhRMxhShhT]ubjý)r¿"}rÀ"(h=X$.. _Haskell: http://www.haskell.org/h>j¨hDj¥"hFjhH}rÁ"(jêXhttp://www.haskell.org/hM]rÂ"UhaskellrÃ"ahL]hJ]hK]hP]rÄ"h!auhRMzhShhT]ubjý)rÅ"}rÆ"(h=X,.. _Haddock: http://www.haskell.org/haddock/h>j¨hDj¥"hFjhH}rÇ"(jêXhttp://www.haskell.org/haddock/hM]rÈ"UhaddockrÉ"ahL]hJ]hK]hP]rÊ"h1auhRM|hShhT]ubjý)rË"}rÌ"(h=X&.. _Alex: http://www.haskell.org/alex/h>j¨hDj¥"hFjhH}rÍ"(jêXhttp://www.haskell.org/alex/hM]rÎ"UalexrÏ"ahL]hJ]hK]hP]rÐ"h-auhRM~hShhT]ubjý)rÑ"}rÒ"(h=X(.. _Happy: http://www.haskell.org/happy/h>j¨hDj¥"hFjhH}rÓ"(jêXhttp://www.haskell.org/happy/hM]rÔ"UhappyrÕ"ahL]hJ]hK]hP]rÖ"hauhRM€hShhT]ubjý)r×"}rØ"(h=X*.. _Hoogle: http://www.haskell.org/hoogle/j? Kh>j¨hDj¥"hFjhH}rÙ"(jêXhttp://www.haskell.org/hoogle/rÚ"hM]rÛ"UhooglerÜ"ahL]hJ]hK]hP]rÝ"hauhRM‚hShhT]ubjý)rÞ"}rß"(h=X9.. _HsColour: http://www.cs.york.ac.uk/fp/darcs/hscolour/j? Kh>j¨hDj¥"hFjhH}rà"(jêX+http://www.cs.york.ac.uk/fp/darcs/hscolour/rá"hM]râ"Uhscolourrã"ahL]hJ]hK]hP]rä"hauhRM„hShhT]ubjý)rå"}ræ"(h=X-.. _cpphs: http://projects.haskell.org/cpphs/h>j¨hDj¥"hFjhH}rç"(jêX"http://projects.haskell.org/cpphs/hM]rè"Ucpphsré"ahL]hJ]hK]hP]rê"hauhRM†hShhT]ubjý)rë"}rì"(h=X-.. _ABNF: https://tools.ietf.org/html/rfc5234j? Kh>j¨hDj¥"hFjhH}rí"(jêjÔhM]rî"Uabnfrï"ahL]hJ]hK]hP]rð"h)auhRMˆhShhT]ubjý)rñ"}rò"(h=X<.. _Backpack: https://ghc.haskell.org/trac/ghc/wiki/Backpackh>j¨hDj¥"hFjhH}ró"(jêX.https://ghc.haskell.org/trac/ghc/wiki/BackpackhM]rô"Ubackpackrõ"ahL]hJ]hK]hP]rö"hauhRMŠhShhT]ubeubeubhDhEhFhGhH}r÷"(hJ]hK]hL]hM]rø"Upackage-configuration-optionsrù"ahP]rú"h3auhRMThShhT]rû"(hV)rü"}rý"(h=XPackage configuration optionsrþ"h>jf hDhEhFhZhH}rÿ"(hJ]hK]hL]hM]hP]uhRMThShhT]r#h]XPackage configuration optionsr#…r#}r#(h=jþ"hDNhRNhShh>jü"ubaubhp)r#}r#(h=XqPackage options affect the building of specific packages. There are three ways a package option can be specified:r#h>jf hDhEhFhthH}r#(hJ]hK]hL]hM]hP]uhRMVhShhT]r#h]XqPackage options affect the building of specific packages. There are three ways a package option can be specified:r #…r #}r #(h=j#hDNhRNhShh>j#ubaubh‚)r #}r #(h=Uh>jf hDhEhFh…hH}r#(h‡X-hM]hL]hJ]hK]hP]uhRMYhShhT]r#(h‰)r#}r#(h=X_They can be specified at the top-level, in which case they apply only to **local package**, or h>j #hDhEhFhŒhH}r#(hJ]hK]hL]hM]hP]uhRNhShhT]r#hp)r#}r#(h=X^They can be specified at the top-level, in which case they apply only to **local package**, orh>j#hDhEhFhthH}r#(hJ]hK]hL]hM]hP]uhRMYhT]r#(h]XIThey can be specified at the top-level, in which case they apply only to r#…r#}r#(h=XIThey can be specified at the top-level, in which case they apply only to h>j#ubjw)r#}r#(h=X**local package**hH}r#(hJ]hK]hL]hM]hP]uh>j#hT]r#h]X local packager#…r #}r!#(h=X local packageh>j#ubahFjubh]X, orr"#…r##}r$#(h=X, orh>j#ubeubaubh‰)r%#}r&#(h=X‘They can be specified inside a ``package`` stanza, in which case they apply to the build of the package, whether or not it is local or external. h>j #hDhEhFhŒhH}r'#(hJ]hK]hL]hM]hP]uhRNhShhT]r(#hp)r)#}r*#(h=XThey can be specified inside a ``package`` stanza, in which case they apply to the build of the package, whether or not it is local or external.h>j%#hDhEhFhthH}r+#(hJ]hK]hL]hM]hP]uhRM\hT]r,#(h]XThey can be specified inside a r-#…r.#}r/#(h=XThey can be specified inside a h>j)#ubh–)r0#}r1#(h=X ``package``hH}r2#(hJ]hK]hL]hM]hP]uh>j)#hT]r3#h]Xpackager4#…r5#}r6#(h=Xpackageh>j0#ubahFhžubh]Xf stanza, in which case they apply to the build of the package, whether or not it is local or external.r7#…r8#}r9#(h=Xf stanza, in which case they apply to the build of the package, whether or not it is local or external.h>j)#ubeubaubh‰)r:#}r;#(h=XThey can be specified inside an ``package *`` stanza, in which case they apply to all packages, local ones from the project and also external dependencies. h>j #hDhEhFhŒhH}r<#(hJ]hK]hL]hM]hP]uhRNhShhT]r=#hp)r>#}r?#(h=X›They can be specified inside an ``package *`` stanza, in which case they apply to all packages, local ones from the project and also external dependencies.h>j:#hDhEhFhthH}r@#(hJ]hK]hL]hM]hP]uhRM`hT]rA#(h]X They can be specified inside an rB#…rC#}rD#(h=X They can be specified inside an h>j>#ubh–)rE#}rF#(h=X ``package *``hH}rG#(hJ]hK]hL]hM]hP]uh>j>#hT]rH#h]X package *rI#…rJ#}rK#(h=X package *h>jE#ubahFhžubh]Xn stanza, in which case they apply to all packages, local ones from the project and also external dependencies.rL#…rM#}rN#(h=Xn stanza, in which case they apply to all packages, local ones from the project and also external dependencies.h>j>#ubeubaubeubhp)rO#}rP#(h=XÛFor example, the following options specify that :cfg-field:`optimization` should be turned off for all local packages, and that ``bytestring`` (possibly an external dependency) should be built with ``-fno-state-hack``::h>jf hDhEhFhthH}rQ#(hJ]hK]hL]hM]hP]uhRMehShhT]rR#(h]X0For example, the following options specify that rS#…rT#}rU#(h=X0For example, the following options specify that hDNhRNhShh>jO#ubjä)rV#}rW#(h=X:cfg-field:`optimization`h>jO#hDhEhFjçhH}rX#(UreftypeX cfg-fieldjéˆjêX optimizationrY#U refdomainXcabalrZ#hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMehT]r[#h–)r\#}r]#(h=jY#hH}r^#(hJ]hK]r_#(jôjZ#Xcabal-cfg-fieldr`#ehL]hM]hP]uh>jV#hT]ra#h]X optimizationrb#…rc#}rd#(h=Uh>j\#ubahFhžubaubh]X7 should be turned off for all local packages, and that re#…rf#}rg#(h=X7 should be turned off for all local packages, and that hDNhRNhShh>jO#ubh–)rh#}ri#(h=X``bytestring``hH}rj#(hJ]hK]hL]hM]hP]uh>jO#hT]rk#h]X bytestringrl#…rm#}rn#(h=X bytestringh>jh#ubahFhžubh]X8 (possibly an external dependency) should be built with ro#…rp#}rq#(h=X8 (possibly an external dependency) should be built with hDNhRNhShh>jO#ubh–)rr#}rs#(h=X``-fno-state-hack``hH}rt#(hJ]hK]hL]hM]hP]uh>jO#hT]ru#h]X-fno-state-hackrv#…rw#}rx#(h=X-fno-state-hackh>jr#ubahFhžubh]X:…ry#}rz#(h=X:hDNhRNhShh>jO#ubeubj)r{#}r|#(h=XHoptimization: False package bytestring ghc-options: -fno-state-hackh>jf hDhEhFjhH}r}#(jjhM]hL]hJ]hK]hP]uhRMihShhT]r~#h]XHoptimization: False package bytestring ghc-options: -fno-state-hackr#…r€#}r#(h=Uh>j{#ubaubhp)r‚#}rƒ#(h=X)``ghc-options`` is not specifically described in this documentation, but is one of many fields for configuring programs. They take the form ``progname-options`` and ``progname-location``, and can only be set inside package stanzas. (TODO: They are not supported at top-level, see :issue:`3579`.)h>jf hDhEhFhthH}r„#(hJ]hK]hL]hM]hP]uhRMnhShhT]r…#(h–)r†#}r‡#(h=X``ghc-options``hH}rˆ#(hJ]hK]hL]hM]hP]uh>j‚#hT]r‰#h]X ghc-optionsrŠ#…r‹#}rŒ#(h=X ghc-optionsh>j†#ubahFhžubh]X~ is not specifically described in this documentation, but is one of many fields for configuring programs. They take the form r#…rŽ#}r#(h=X~ is not specifically described in this documentation, but is one of many fields for configuring programs. They take the form hDNhRNhShh>j‚#ubh–)r#}r‘#(h=X``progname-options``hH}r’#(hJ]hK]hL]hM]hP]uh>j‚#hT]r“#h]Xprogname-optionsr”#…r•#}r–#(h=Xprogname-optionsh>j#ubahFhžubh]X and r—#…r˜#}r™#(h=X and hDNhRNhShh>j‚#ubh–)rš#}r›#(h=X``progname-location``hH}rœ#(hJ]hK]hL]hM]hP]uh>j‚#hT]r#h]Xprogname-locationrž#…rŸ#}r #(h=Xprogname-locationh>jš#ubahFhžubh]X_, and can only be set inside package stanzas. (TODO: They are not supported at top-level, see r¡#…r¢#}r£#(h=X_, and can only be set inside package stanzas. (TODO: They are not supported at top-level, see hDNhRNhShh>j‚#ubjæ)r¤#}r¥#(h=X#3579hH}r¦#(UrefuriX,https://github.com/haskell/cabal/issues/3579hM]hL]hJ]hK]hP]Uinternal‰uh>j‚#hT]r§#h]X#3579r¨#…r©#}rª#(h=X3579h>j¤#ubahFjïubh]X.)r«#…r¬#}r­#(h=X.)hDNhRNhShh>j‚#ubeubhp)r®#}r¯#(h=XAt the moment, there is no way to specify an option to apply to all external packages or all inplace packages. Additionally, it is only possible to specify these options on the command line for all local packages (there is no per-package command line interface.)r°#h>jf hDhEhFhthH}r±#(hJ]hK]hL]hM]hP]uhRMthShhT]r²#h]XAt the moment, there is no way to specify an option to apply to all external packages or all inplace packages. Additionally, it is only possible to specify these options on the command line for all local packages (there is no per-package command line interface.)r³#…r´#}rµ#(h=j°#hDNhRNhShh>j®#ubaubhp)r¶#}r·#(h=XèSome flags were added by more recent versions of the Cabal library. This means that they are NOT supported by packages which use Custom setup scripts that require a version of the Cabal library older than when the feature was added.r¸#h>jf hDhEhFhthH}r¹#(hJ]hK]hL]hM]hP]uhRMyhShhT]rº#h]XèSome flags were added by more recent versions of the Cabal library. This means that they are NOT supported by packages which use Custom setup scripts that require a version of the Cabal library older than when the feature was added.r»#…r¼#}r½#(h=j¸#hDNhRNhShh>j¶#ubaubj7)r¾#}r¿#(h=Uh>jf hDhEhFj:hH}rÀ#(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rÁ#}rÂ#(h=Uh>jf hDhEhFj?hH}rÃ#(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrÄ#jEjÄ#uhRNhShhT]rÅ#(jG)rÆ#}rÇ#(h=X7flags: list of +flagname or -flagname (space separated)h>jÁ#hDhEhFjJhH}rÈ#(hM]rÉ#Xcfg-field-flagsrÊ#ahL]hJ]hK]hP]jN‰uhRNhShhT]rË#(j7)rÌ#}rÍ#(h=Uh>jÆ#hDhEhFj:hH}rÎ#(hM]hL]hJ]hK]hP]Uentries]rÏ#(jTXflags ; cabal project optionjÊ#UNtrÐ#auhRNhShhT]ubjV)rÑ#}rÒ#(h=XflagsrÓ#h>jÆ#hDhEhFjZhH}rÔ#(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÕ#h]XflagsrÖ#…r×#}rØ#(h=UhDNhRNhShh>jÑ#ubaubj`)rÙ#}rÚ#(h=jch>jÆ#hDhEhFjdhH}rÛ#(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÜ#h]X: rÝ#…rÞ#}rß#(h=UhDNhRNhShh>jÙ#ubaubjj)rà#}rá#(h=X0list of +flagname or -flagname (space separated)h>jÆ#hDhEhFjmhH}râ#(jjhM]hL]hJ]hK]hP]uhRNhShhT]rã#h]X0list of +flagname or -flagname (space separated)rä#…rå#}ræ#(h=UhDNhRNhShh>jà#ubaubeubjG)rç#}rè#(h=X"--flags="+foo -bar", -ffoo, -f-barh>jÁ#hDhEhFjJhH}ré#(hM]rê#Xcfg-flag---flagsrë#ahL]hJ]hK]hP]jN‰uhRNhShhT]rì#(j7)rí#}rî#(h=Uh>jç#hDhEhFj:hH}rï#(hM]hL]hJ]hK]hP]Uentries]rð#(jTX--flags; cabal project optionjë#UNtrñ#auhRNhShhT]ubjV)rò#}ró#(h=X--flagsrô#h>jç#hDhEhFjZhH}rõ#(jjhM]hL]hJ]hK]hP]uhRNhShhT]rö#h]X--flagsr÷#…rø#}rù#(h=UhDNhRNhShh>jò#ubaubj`)rú#}rû#(h=X ="+foo -bar"h>jç#hDhEhFjdhH}rü#(jjhM]hL]hJ]hK]hP]uhRNhShhT]rý#h]X ="+foo -bar"rþ#…rÿ#}r$(h=UhDNhRNhShh>jú#ubaubjV)r$}r$(h=jÓh>jç#hDhEhFjZhH}r$(jjhM]hL]hJ]hK]hP]uhRNhShhT]r$h]X, r$…r$}r$(h=UhDNhRNhShh>j$ubaubjV)r$}r $(h=X-ffooh>jç#hDhEhFjZhH}r $(jjhM]hL]hJ]hK]hP]uhRNhShhT]r $h]X-ffoor $…r $}r$(h=UhDNhRNhShh>j$ubaubj`)r$}r$(h=U h>jç#hDhEhFjdhH}r$(jjhM]hL]hJ]hK]hP]uhRNhShhT]r$h]X …r$}r$(h=UhDNhRNhShh>j$ubaubjV)r$}r$(h=jÓh>jç#hDhEhFjZhH}r$(jjhM]hL]hJ]hK]hP]uhRNhShhT]r$h]X, r$…r$}r$(h=UhDNhRNhShh>j$ubaubjV)r$}r$(h=X-f-barh>jç#hDhEhFjZhH}r$(jjhM]hL]hJ]hK]hP]uhRNhShhT]r$h]X-f-barr $…r!$}r"$(h=UhDNhRNhShh>j$ubaubj`)r#$}r$$(h=U h>jç#hDhEhFjdhH}r%$(jjhM]hL]hJ]hK]hP]uhRNhShhT]r&$h]X …r'$}r($(h=UhDNhRNhShh>j#$ubaubeubjs)r)$}r*$(h=Uh>jÁ#hDhEhFjvhH}r+$(hJ]hK]hL]hM]hP]uhRNhShhT]r,$(hp)r-$}r.$(h=X®Force all flags specified as ``+flagname`` to be true, and all flags specified as ``-flagname`` to be false. For example, to enable the flag ``foo`` and disable ``bar``, set:h>j)$hDhEhFhthH}r/$(hJ]hK]hL]hM]hP]uhRM‚hShhT]r0$(h]XForce all flags specified as r1$…r2$}r3$(h=XForce all flags specified as hDNhRNhShh>j-$ubh–)r4$}r5$(h=X ``+flagname``hH}r6$(hJ]hK]hL]hM]hP]uh>j-$hT]r7$h]X +flagnamer8$…r9$}r:$(h=X +flagnameh>j4$ubahFhžubh]X( to be true, and all flags specified as r;$…r<$}r=$(h=X( to be true, and all flags specified as hDNhRNhShh>j-$ubh–)r>$}r?$(h=X ``-flagname``hH}r@$(hJ]hK]hL]hM]hP]uh>j-$hT]rA$h]X -flagnamerB$…rC$}rD$(h=X -flagnameh>j>$ubahFhžubh]X. to be false. For example, to enable the flag rE$…rF$}rG$(h=X. to be false. For example, to enable the flag hDNhRNhShh>j-$ubh–)rH$}rI$(h=X``foo``hH}rJ$(hJ]hK]hL]hM]hP]uh>j-$hT]rK$h]XfoorL$…rM$}rN$(h=Xfooh>jH$ubahFhžubh]X and disable rO$…rP$}rQ$(h=X and disable hDNhRNhShh>j-$ubh–)rR$}rS$(h=X``bar``hH}rT$(hJ]hK]hL]hM]hP]uh>j-$hT]rU$h]XbarrV$…rW$}rX$(h=Xbarh>jR$ubahFhžubh]X, set:rY$…rZ$}r[$(h=X, set:hDNhRNhShh>j-$ubeubj)r\$}r]$(h=Xflags: +foo -barh>j)$hDhEhFjhH}r^$(jjhM]hL]hJ]hK]hP]uhRMˆhShhT]r_$h]Xflags: +foo -barr`$…ra$}rb$(h=Uh>j\$ubaubhp)rc$}rd$(h=XlIf there is no leading punctuation, it is assumed that the flag should be enabled; e.g., this is equivalent:re$h>j)$hDhEhFhthH}rf$(hJ]hK]hL]hM]hP]uhRMŠhShhT]rg$h]XlIf there is no leading punctuation, it is assumed that the flag should be enabled; e.g., this is equivalent:rh$…ri$}rj$(h=je$hDNhRNhShh>jc$ubaubj)rk$}rl$(h=Xflags: foo -barh>j)$hDhEhFjhH}rm$(jjhM]hL]hJ]hK]hP]uhRMhShhT]rn$h]Xflags: foo -barro$…rp$}rq$(h=Uh>jk$ubaubhp)rr$}rs$(h=XëFlags are *per-package*, so it doesn't make much sense to specify flags at the top-level, unless you happen to know that *all* of your local packages support the same named flags. If a flag is not supported by a package, it is ignored.h>j)$hDhEhFhthH}rt$(hJ]hK]hL]hM]hP]uhRM‘hShhT]ru$(h]X Flags are rv$…rw$}rx$(h=X Flags are hDNhRNhShh>jr$ubj))ry$}rz$(h=X *per-package*hH}r{$(hJ]hK]hL]hM]hP]uh>jr$hT]r|$h]X per-packager}$…r~$}r$(h=X per-packageh>jy$ubahFj1ubh]Xd, so it doesn’t make much sense to specify flags at the top-level, unless you happen to know that r€$…r$}r‚$(h=Xb, so it doesn't make much sense to specify flags at the top-level, unless you happen to know that hDNhRNhShh>jr$ubj))rƒ$}r„$(h=X*all*hH}r…$(hJ]hK]hL]hM]hP]uh>jr$hT]r†$h]Xallr‡$…rˆ$}r‰$(h=Xallh>jƒ$ubahFj1ubh]Xm of your local packages support the same named flags. If a flag is not supported by a package, it is ignored.rŠ$…r‹$}rŒ$(h=Xm of your local packages support the same named flags. If a flag is not supported by a package, it is ignored.hDNhRNhShh>jr$ubeubhp)r$}rŽ$(h=XASee also the solver configuration field :cfg-field:`constraints`.h>j)$hDhEhFhthH}r$(hJ]hK]hL]hM]hP]uhRM–hShhT]r$(h]X(See also the solver configuration field r‘$…r’$}r“$(h=X(See also the solver configuration field hDNhRNhShh>j$ubjä)r”$}r•$(h=X:cfg-field:`constraints`h>j$hDhEhFjçhH}r–$(UreftypeX cfg-fieldjéˆjêX constraintsr—$U refdomainXcabalr˜$hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM–hT]r™$h–)rš$}r›$(h=j—$hH}rœ$(hJ]hK]r$(jôj˜$Xcabal-cfg-fieldrž$ehL]hM]hP]uh>j”$hT]rŸ$h]X constraintsr $…r¡$}r¢$(h=Uh>jš$ubahFhžubaubh]X.…r£$}r¤$(h=X.hDNhRNhShh>j$ubeubhp)r¥$}r¦$(h=XfThe command line variant of this flag is ``--flags``. There is also a shortened form ``-ffoo -f-bar``.h>j)$hDhEhFhthH}r§$(hJ]hK]hL]hM]hP]uhRM˜hShhT]r¨$(h]X)The command line variant of this flag is r©$…rª$}r«$(h=X)The command line variant of this flag is hDNhRNhShh>j¥$ubh–)r¬$}r­$(h=X ``--flags``hH}r®$(hJ]hK]hL]hM]hP]uh>j¥$hT]r¯$h]X--flagsr°$…r±$}r²$(h=X--flagsh>j¬$ubahFhžubh]X!. There is also a shortened form r³$…r´$}rµ$(h=X!. There is also a shortened form hDNhRNhShh>j¥$ubh–)r¶$}r·$(h=X``-ffoo -f-bar``hH}r¸$(hJ]hK]hL]hM]hP]uh>j¥$hT]r¹$h]X -ffoo -f-barrº$…r»$}r¼$(h=X -ffoo -f-barh>j¶$ubahFhžubh]X.…r½$}r¾$(h=X.hDNhRNhShh>j¥$ubeubhp)r¿$}rÀ$(h=X1A common mistake is to say ``cabal v2-build -fhans``, where ``hans`` is a flag for a transitive dependency that is not in the local package; in this case, the flag will be silently ignored. If ``haskell-tor`` is the package you want this flag to apply to, try ``--constraint="haskell-tor +hans"`` instead.h>j)$hDhEhFhthH}rÁ$(hJ]hK]hL]hM]hP]uhRM›hShhT]rÂ$(h]XA common mistake is to say rÃ$…rÄ$}rÅ$(h=XA common mistake is to say hDNhRNhShh>j¿$ubh–)rÆ$}rÇ$(h=X``cabal v2-build -fhans``hH}rÈ$(hJ]hK]hL]hM]hP]uh>j¿$hT]rÉ$h]Xcabal v2-build -fhansrÊ$…rË$}rÌ$(h=Xcabal v2-build -fhansh>jÆ$ubahFhžubh]X, where rÍ$…rÎ$}rÏ$(h=X, where hDNhRNhShh>j¿$ubh–)rÐ$}rÑ$(h=X``hans``hH}rÒ$(hJ]hK]hL]hM]hP]uh>j¿$hT]rÓ$h]XhansrÔ$…rÕ$}rÖ$(h=Xhansh>jÐ$ubahFhžubh]X} is a flag for a transitive dependency that is not in the local package; in this case, the flag will be silently ignored. If r×$…rØ$}rÙ$(h=X} is a flag for a transitive dependency that is not in the local package; in this case, the flag will be silently ignored. If hDNhRNhShh>j¿$ubh–)rÚ$}rÛ$(h=X``haskell-tor``hH}rÜ$(hJ]hK]hL]hM]hP]uh>j¿$hT]rÝ$h]X haskell-torrÞ$…rß$}rà$(h=X haskell-torh>jÚ$ubahFhžubh]X4 is the package you want this flag to apply to, try rá$…râ$}rã$(h=X4 is the package you want this flag to apply to, try hDNhRNhShh>j¿$ubh–)rä$}rå$(h=X$``--constraint="haskell-tor +hans"``hH}ræ$(hJ]hK]hL]hM]hP]uh>j¿$hT]rç$h]X --constraint="haskell-tor +hans"rè$…ré$}rê$(h=X --constraint="haskell-tor +hans"h>jä$ubahFhžubh]X instead.rë$…rì$}rí$(h=X instead.hDNhRNhShh>j¿$ubeubeubeubj7)rî$}rï$(h=Uh>jf hDhEhFj:hH}rð$(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rñ$}rò$(h=Uh>jf hDhEhFj?hH}ró$(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrô$jEjô$uhRNhShhT]rõ$(jG)rö$}r÷$(h=Xwith-compiler: executableh>jñ$hDhEhFjJhH}rø$(hM]rù$Xcfg-field-with-compilerrú$ahL]hJ]hK]hP]jN‰uhRNhShhT]rû$(j7)rü$}rý$(h=Uh>jö$hDhEhFj:hH}rþ$(hM]hL]hJ]hK]hP]Uentries]rÿ$(jTX$with-compiler ; cabal project optionjú$UNtr%auhRNhShhT]ubjV)r%}r%(h=X with-compilerr%h>jö$hDhEhFjZhH}r%(jjhM]hL]hJ]hK]hP]uhRNhShhT]r%h]X with-compilerr%…r%}r%(h=UhDNhRNhShh>j%ubaubj`)r %}r %(h=jch>jö$hDhEhFjdhH}r %(jjhM]hL]hJ]hK]hP]uhRNhShhT]r %h]X: r %…r%}r%(h=UhDNhRNhShh>j %ubaubjj)r%}r%(h=X executableh>jö$hDhEhFjmhH}r%(jjhM]hL]hJ]hK]hP]uhRNhShhT]r%h]X executabler%…r%}r%(h=UhDNhRNhShh>j%ubaubeubjG)r%}r%(h=X--with-compiler=executableh>jñ$hDhEhFjJhH}r%(hM]r%Xcfg-flag---with-compilerr%ahL]hJ]hK]hP]jN‰uhRNhShhT]r%(j7)r%}r%(h=Uh>j%hDhEhFj:hH}r%(hM]hL]hJ]hK]hP]Uentries]r %(jTX%--with-compiler; cabal project optionj%UNtr!%auhRNhShhT]ubjV)r"%}r#%(h=X--with-compilerr$%h>j%hDhEhFjZhH}r%%(jjhM]hL]hJ]hK]hP]uhRNhShhT]r&%h]X--with-compilerr'%…r(%}r)%(h=UhDNhRNhShh>j"%ubaubj`)r*%}r+%(h=X =executableh>j%hDhEhFjdhH}r,%(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-%h]X =executabler.%…r/%}r0%(h=UhDNhRNhShh>j*%ubaubeubjs)r1%}r2%(h=Uh>jñ$hDhEhFjvhH}r3%(hJ]hK]hL]hM]hP]uhRNhShhT]r4%(hp)r5%}r6%(h=XSpecify the path to a particular compiler to be used. If not an absolute path, it will be resolved according to the :envvar:`PATH` environment. The type of the compiler (GHC, GHCJS, etc) must be consistent with the setting of the :cfg-field:`compiler` field.h>j1%hDhEhFhthH}r7%(hJ]hK]hL]hM]hP]uhRM¥hShhT]r8%(h]XtSpecify the path to a particular compiler to be used. If not an absolute path, it will be resolved according to the r9%…r:%}r;%(h=XtSpecify the path to a particular compiler to be used. If not an absolute path, it will be resolved according to the hDNhRNhShh>j5%ubj7)r<%}r=%(h=UhH}r>%(hM]hL]hJ]hK]hP]Uentriesr?%]r@%((UsinglerA%XPATHrB%Uindex-2rC%UNtrD%(jA%Xenvironment variable; PATHjC%UNtrE%euh>j5%hT]hFj:ubjý)rF%}rG%(h=UhH}rH%(hJ]hK]hL]hM]rI%jC%ahP]uh>j5%hT]hFjubjä)rJ%}rK%(h=X:envvar:`PATH`rL%h>j5%hDhEhFjçhH}rM%(UreftypeXenvvarjé‰jêjB%U refdomainXstdrN%hM]hL]U refexplicit‰hJ]hK]hP]jìjíuhRM¥hT]rO%h–)rP%}rQ%(h=jL%hH}rR%(hJ]hK]rS%(jôjN%X std-envvarrT%ehL]hM]hP]uh>jJ%hT]rU%h]XPATHrV%…rW%}rX%(h=Uh>jP%ubahFhžubaubh]Xd environment. The type of the compiler (GHC, GHCJS, etc) must be consistent with the setting of the rY%…rZ%}r[%(h=Xd environment. The type of the compiler (GHC, GHCJS, etc) must be consistent with the setting of the hDNhRNhShh>j5%ubjä)r\%}r]%(h=X:cfg-field:`compiler`h>j5%hDhEhFjçhH}r^%(UreftypeX cfg-fieldjéˆjêXcompilerr_%U refdomainXcabalr`%hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM¥hT]ra%h–)rb%}rc%(h=j_%hH}rd%(hJ]hK]re%(jôj`%Xcabal-cfg-fieldrf%ehL]hM]hP]uh>j\%hT]rg%h]Xcompilerrh%…ri%}rj%(h=Uh>jb%ubahFhžubaubh]X field.rk%…rl%}rm%(h=X field.hDNhRNhShh>j5%ubeubhp)rn%}ro%(h=XÃThe most common use of this option is to specify a different version of your compiler to be used; e.g., if you have ``ghc-7.8`` in your path, you can specify ``with-compiler: ghc-7.8`` to use it.h>j1%hDhEhFhthH}rp%(hJ]hK]hL]hM]hP]uhRMªhShhT]rq%(h]XtThe most common use of this option is to specify a different version of your compiler to be used; e.g., if you have rr%…rs%}rt%(h=XtThe most common use of this option is to specify a different version of your compiler to be used; e.g., if you have hDNhRNhShh>jn%ubh–)ru%}rv%(h=X ``ghc-7.8``hH}rw%(hJ]hK]hL]hM]hP]uh>jn%hT]rx%h]Xghc-7.8ry%…rz%}r{%(h=Xghc-7.8h>ju%ubahFhžubh]X in your path, you can specify r|%…r}%}r~%(h=X in your path, you can specify hDNhRNhShh>jn%ubh–)r%}r€%(h=X``with-compiler: ghc-7.8``hH}r%(hJ]hK]hL]hM]hP]uh>jn%hT]r‚%h]Xwith-compiler: ghc-7.8rƒ%…r„%}r…%(h=Xwith-compiler: ghc-7.8h>j%ubahFhžubh]X to use it.r†%…r‡%}rˆ%(h=X to use it.hDNhRNhShh>jn%ubeubhp)r‰%}rŠ%(h=XUThis flag also sets the default value of :cfg-field:`with-hc-pkg`, using the heuristic that it is named ``ghc-pkg-7.8`` (if your executable name is suffixed with a version number), or is the executable named ``ghc-pkg`` in the same directory as the ``ghc`` directory. If this heuristic does not work, set :cfg-field:`with-hc-pkg` explicitly.h>j1%hDhEhFhthH}r‹%(hJ]hK]hL]hM]hP]uhRM®hShhT]rŒ%(h]X)This flag also sets the default value of r%…rŽ%}r%(h=X)This flag also sets the default value of hDNhRNhShh>j‰%ubjä)r%}r‘%(h=X:cfg-field:`with-hc-pkg`h>j‰%hDhEhFjçhH}r’%(UreftypeX cfg-fieldjéˆjêX with-hc-pkgr“%U refdomainXcabalr”%hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM®hT]r•%h–)r–%}r—%(h=j“%hH}r˜%(hJ]hK]r™%(jôj”%Xcabal-cfg-fieldrš%ehL]hM]hP]uh>j%hT]r›%h]X with-hc-pkgrœ%…r%}rž%(h=Uh>j–%ubahFhžubaubh]X', using the heuristic that it is named rŸ%…r %}r¡%(h=X', using the heuristic that it is named hDNhRNhShh>j‰%ubh–)r¢%}r£%(h=X``ghc-pkg-7.8``hH}r¤%(hJ]hK]hL]hM]hP]uh>j‰%hT]r¥%h]X ghc-pkg-7.8r¦%…r§%}r¨%(h=X ghc-pkg-7.8h>j¢%ubahFhžubh]XY (if your executable name is suffixed with a version number), or is the executable named r©%…rª%}r«%(h=XY (if your executable name is suffixed with a version number), or is the executable named hDNhRNhShh>j‰%ubh–)r¬%}r­%(h=X ``ghc-pkg``hH}r®%(hJ]hK]hL]hM]hP]uh>j‰%hT]r¯%h]Xghc-pkgr°%…r±%}r²%(h=Xghc-pkgh>j¬%ubahFhžubh]X in the same directory as the r³%…r´%}rµ%(h=X in the same directory as the hDNhRNhShh>j‰%ubh–)r¶%}r·%(h=X``ghc``hH}r¸%(hJ]hK]hL]hM]hP]uh>j‰%hT]r¹%h]Xghcrº%…r»%}r¼%(h=Xghch>j¶%ubahFhžubh]X1 directory. If this heuristic does not work, set r½%…r¾%}r¿%(h=X1 directory. If this heuristic does not work, set hDNhRNhShh>j‰%ubjä)rÀ%}rÁ%(h=X:cfg-field:`with-hc-pkg`h>j‰%hDhEhFjçhH}rÂ%(UreftypeX cfg-fieldjéˆjêX with-hc-pkgrÃ%U refdomainXcabalrÄ%hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM®hT]rÅ%h–)rÆ%}rÇ%(h=jÃ%hH}rÈ%(hJ]hK]rÉ%(jôjÄ%Xcabal-cfg-fieldrÊ%ehL]hM]hP]uh>jÀ%hT]rË%h]X with-hc-pkgrÌ%…rÍ%}rÎ%(h=Uh>jÆ%ubahFhžubaubh]X explicitly.rÏ%…rÐ%}rÑ%(h=X explicitly.hDNhRNhShh>j‰%ubeubhp)rÒ%}rÓ%(h=XÌFor inplace packages, ``cabal v2-build`` maintains a separate build directory for each version of GHC, so you can maintain multiple build trees for different versions of GHC without clobbering each other.h>j1%hDhEhFhthH}rÔ%(hJ]hK]hL]hM]hP]uhRM´hShhT]rÕ%(h]XFor inplace packages, rÖ%…r×%}rØ%(h=XFor inplace packages, hDNhRNhShh>jÒ%ubh–)rÙ%}rÚ%(h=X``cabal v2-build``hH}rÛ%(hJ]hK]hL]hM]hP]uh>jÒ%hT]rÜ%h]Xcabal v2-buildrÝ%…rÞ%}rß%(h=Xcabal v2-buildh>jÙ%ubahFhžubh]X¤ maintains a separate build directory for each version of GHC, so you can maintain multiple build trees for different versions of GHC without clobbering each other.rà%…rá%}râ%(h=X¤ maintains a separate build directory for each version of GHC, so you can maintain multiple build trees for different versions of GHC without clobbering each other.hDNhRNhShh>jÒ%ubeubhp)rã%}rä%(h=X¿At the moment, it's not possible to set :cfg-field:`with-compiler` on a per-package basis, but eventually we plan on relaxing this restriction. If this is something you need, give us a shout.h>j1%hDhEhFhthH}rå%(hJ]hK]hL]hM]hP]uhRM¹hShhT]ræ%(h]X*At the moment, it’s not possible to set rç%…rè%}ré%(h=X(At the moment, it's not possible to set hDNhRNhShh>jã%ubjä)rê%}rë%(h=X:cfg-field:`with-compiler`h>jã%hDhEhFjçhH}rì%(UreftypeX cfg-fieldjéˆjêX with-compilerrí%U refdomainXcabalrî%hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM¹hT]rï%h–)rð%}rñ%(h=jí%hH}rò%(hJ]hK]ró%(jôjî%Xcabal-cfg-fieldrô%ehL]hM]hP]uh>jê%hT]rõ%h]X with-compilerrö%…r÷%}rø%(h=Uh>jð%ubahFhžubaubh]X} on a per-package basis, but eventually we plan on relaxing this restriction. If this is something you need, give us a shout.rù%…rú%}rû%(h=X} on a per-package basis, but eventually we plan on relaxing this restriction. If this is something you need, give us a shout.hDNhRNhShh>jã%ubeubhp)rü%}rý%(h=XsThe command line variant of this flag is ``--with-compiler=ghc-7.8``; there is also a short version ``-w ghc-7.8``.h>j1%hDhEhFhthH}rþ%(hJ]hK]hL]hM]hP]uhRM½hShhT]rÿ%(h]X)The command line variant of this flag is r&…r&}r&(h=X)The command line variant of this flag is hDNhRNhShh>jü%ubh–)r&}r&(h=X``--with-compiler=ghc-7.8``hH}r&(hJ]hK]hL]hM]hP]uh>jü%hT]r&h]X--with-compiler=ghc-7.8r&…r&}r &(h=X--with-compiler=ghc-7.8h>j&ubahFhžubh]X ; there is also a short version r &…r &}r &(h=X ; there is also a short version hDNhRNhShh>jü%ubh–)r &}r&(h=X``-w ghc-7.8``hH}r&(hJ]hK]hL]hM]hP]uh>jü%hT]r&h]X -w ghc-7.8r&…r&}r&(h=X -w ghc-7.8h>j &ubahFhžubh]X.…r&}r&(h=X.hDNhRNhShh>jü%ubeubeubeubj7)r&}r&(h=Uh>jf hDhEhFj:hH}r&(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r&}r&(h=Uh>jf hDhEhFj?hH}r&(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr&jEj&uhRNhShhT]r&(jG)r&}r&(h=Xwith-hc-pkg: executableh>j&hDhEhFjJhH}r &(hM]r!&Xcfg-field-with-hc-pkgr"&ahL]hJ]hK]hP]jN‰uhRNhShhT]r#&(j7)r$&}r%&(h=Uh>j&hDhEhFj:hH}r&&(hM]hL]hJ]hK]hP]Uentries]r'&(jTX"with-hc-pkg ; cabal project optionj"&UNtr(&auhRNhShhT]ubjV)r)&}r*&(h=X with-hc-pkgr+&h>j&hDhEhFjZhH}r,&(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-&h]X with-hc-pkgr.&…r/&}r0&(h=UhDNhRNhShh>j)&ubaubj`)r1&}r2&(h=jch>j&hDhEhFjdhH}r3&(jjhM]hL]hJ]hK]hP]uhRNhShhT]r4&h]X: r5&…r6&}r7&(h=UhDNhRNhShh>j1&ubaubjj)r8&}r9&(h=X executableh>j&hDhEhFjmhH}r:&(jjhM]hL]hJ]hK]hP]uhRNhShhT]r;&h]X executabler<&…r=&}r>&(h=UhDNhRNhShh>j8&ubaubeubjG)r?&}r@&(h=X--with-hc-pkg=executableh>j&hDhEhFjJhH}rA&(hM]rB&Xcfg-flag---with-hc-pkgrC&ahL]hJ]hK]hP]jN‰uhRNhShhT]rD&(j7)rE&}rF&(h=Uh>j?&hDhEhFj:hH}rG&(hM]hL]hJ]hK]hP]Uentries]rH&(jTX#--with-hc-pkg; cabal project optionjC&UNtrI&auhRNhShhT]ubjV)rJ&}rK&(h=X --with-hc-pkgrL&h>j?&hDhEhFjZhH}rM&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rN&h]X --with-hc-pkgrO&…rP&}rQ&(h=UhDNhRNhShh>jJ&ubaubj`)rR&}rS&(h=X =executableh>j?&hDhEhFjdhH}rT&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rU&h]X =executablerV&…rW&}rX&(h=UhDNhRNhShh>jR&ubaubeubjs)rY&}rZ&(h=Uh>j&hDhEhFjvhH}r[&(hJ]hK]hL]hM]hP]uhRNhShhT]r\&(hp)r]&}r^&(h=XQSpecify the path to the package tool, e.g., ``ghc-pkg``. This package tool must be compatible with the compiler specified by :cfg-field:`with-compiler` (generally speaking, it should be precisely the tool that was distributed with the compiler). If this option is omitted, the default value is determined from :cfg-field:`with-compiler`.h>jY&hDhEhFhthH}r_&(hJ]hK]hL]hM]hP]uhRMÅhShhT]r`&(h]X,Specify the path to the package tool, e.g., ra&…rb&}rc&(h=X,Specify the path to the package tool, e.g., hDNhRNhShh>j]&ubh–)rd&}re&(h=X ``ghc-pkg``hH}rf&(hJ]hK]hL]hM]hP]uh>j]&hT]rg&h]Xghc-pkgrh&…ri&}rj&(h=Xghc-pkgh>jd&ubahFhžubh]XF. This package tool must be compatible with the compiler specified by rk&…rl&}rm&(h=XF. This package tool must be compatible with the compiler specified by hDNhRNhShh>j]&ubjä)rn&}ro&(h=X:cfg-field:`with-compiler`h>j]&hDhEhFjçhH}rp&(UreftypeX cfg-fieldjéˆjêX with-compilerrq&U refdomainXcabalrr&hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÅhT]rs&h–)rt&}ru&(h=jq&hH}rv&(hJ]hK]rw&(jôjr&Xcabal-cfg-fieldrx&ehL]hM]hP]uh>jn&hT]ry&h]X with-compilerrz&…r{&}r|&(h=Uh>jt&ubahFhžubaubh]XŸ (generally speaking, it should be precisely the tool that was distributed with the compiler). If this option is omitted, the default value is determined from r}&…r~&}r&(h=XŸ (generally speaking, it should be precisely the tool that was distributed with the compiler). If this option is omitted, the default value is determined from hDNhRNhShh>j]&ubjä)r€&}r&(h=X:cfg-field:`with-compiler`h>j]&hDhEhFjçhH}r‚&(UreftypeX cfg-fieldjéˆjêX with-compilerrƒ&U refdomainXcabalr„&hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÅhT]r…&h–)r†&}r‡&(h=jƒ&hH}rˆ&(hJ]hK]r‰&(jôj„&Xcabal-cfg-fieldrŠ&ehL]hM]hP]uh>j€&hT]r‹&h]X with-compilerrŒ&…r&}rŽ&(h=Uh>j†&ubahFhžubaubh]X.…r&}r&(h=X.hDNhRNhShh>j]&ubeubhp)r‘&}r’&(h=XGThe command line variant of this flag is ``--with-hc-pkg=ghc-pkg-7.8``.h>jY&hDhEhFhthH}r“&(hJ]hK]hL]hM]hP]uhRMËhShhT]r”&(h]X)The command line variant of this flag is r•&…r–&}r—&(h=X)The command line variant of this flag is hDNhRNhShh>j‘&ubh–)r˜&}r™&(h=X``--with-hc-pkg=ghc-pkg-7.8``hH}rš&(hJ]hK]hL]hM]hP]uh>j‘&hT]r›&h]X--with-hc-pkg=ghc-pkg-7.8rœ&…r&}rž&(h=X--with-hc-pkg=ghc-pkg-7.8h>j˜&ubahFhžubh]X.…rŸ&}r &(h=X.hDNhRNhShh>j‘&ubeubeubeubj7)r¡&}r¢&(h=Uh>jf hDhEhFj:hH}r£&(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r¤&}r¥&(h=Uh>jf hDhEhFj?hH}r¦&(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr§&jEj§&uhRNhShhT]r¨&(jG)r©&}rª&(h=Xoptimization: nath>j¤&hDhEhFjJhH}r«&(hM]r¬&Xcfg-field-optimizationr­&ahL]hJ]hK]hP]jN‰uhRNhShhT]r®&(j7)r¯&}r°&(h=Uh>j©&hDhEhFj:hH}r±&(hM]hL]hJ]hK]hP]Uentries]r²&(jTX#optimization ; cabal project optionj­&UNtr³&auhRNhShhT]ubjV)r´&}rµ&(h=X optimizationr¶&h>j©&hDhEhFjZhH}r·&(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¸&h]X optimizationr¹&…rº&}r»&(h=UhDNhRNhShh>j´&ubaubj`)r¼&}r½&(h=jch>j©&hDhEhFjdhH}r¾&(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¿&h]X: rÀ&…rÁ&}rÂ&(h=UhDNhRNhShh>j¼&ubaubjj)rÃ&}rÄ&(h=Xnath>j©&hDhEhFjmhH}rÅ&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÆ&h]XnatrÇ&…rÈ&}rÉ&(h=UhDNhRNhShh>jÃ&ubaubeubjG)rÊ&}rË&(h=X--enable-optimizationrÌ&h>j¤&hDhEhFjJhH}rÍ&(hM]rÎ&Xcfg-flag---enable-optimizationrÏ&ahL]hJ]hK]hP]jN‰uhRNhShhT]rÐ&(j7)rÑ&}rÒ&(h=Uh>jÊ&hDhEhFj:hH}rÓ&(hM]hL]hJ]hK]hP]Uentries]rÔ&(jTX+--enable-optimization; cabal project optionjÏ&UNtrÕ&auhRNhShhT]ubjV)rÖ&}r×&(h=jÌ&h>jÊ&hDhEhFjZhH}rØ&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÙ&h]X--enable-optimizationrÚ&…rÛ&}rÜ&(h=UhDNhRNhShh>jÖ&ubaubj`)rÝ&}rÞ&(h=U h>jÊ&hDhEhFjdhH}rß&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rà&h]X …rá&}râ&(h=UhDNhRNhShh>jÝ&ubaubeubjG)rã&}rä&(h=X--disable-optimizationrå&h>j¤&hDhEhFjJhH}ræ&(hM]rç&Xcfg-flag---disable-optimizationrè&ahL]hJ]hK]hP]jN‰uhRNhShhT]ré&(j7)rê&}rë&(h=Uh>jã&hDhEhFj:hH}rì&(hM]hL]hJ]hK]hP]Uentries]rí&(jTX,--disable-optimization; cabal project optionjè&UNtrî&auhRNhShhT]ubjV)rï&}rð&(h=jå&h>jã&hDhEhFjZhH}rñ&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rò&h]X--disable-optimizationró&…rô&}rõ&(h=UhDNhRNhShh>jï&ubaubj`)rö&}r÷&(h=U h>jã&hDhEhFjdhH}rø&(jjhM]hL]hJ]hK]hP]uhRNhShhT]rù&h]X …rú&}rû&(h=UhDNhRNhShh>jö&ubaubeubjs)rü&}rý&(h=Uh>j¤&hDhEhFjvhH}rþ&(hJ]hK]hL]hM]hP]uhRNhShhT]rÿ&(jy)r'}r'(h=Uh>jü&hDhEhFj|hH}r'(hJ]hK]hL]hM]hP]uhRNhShhT]r'j)r'}r'(h=UhH}r'(hJ]hK]hL]hM]hP]uh>j'hT]r'(j„)r'}r '(h=X Default valueh>j'hDhEhFj‡hH}r '(hJ]hK]hL]hM]hP]uhRKhT]r 'h]X Default valuer '…r '}r'(h=Uh>j'ubaubj)r'}r'(h=UhH}r'(hJ]hK]hL]hM]hP]uh>j'hT]r'hp)r'}r'(h=X1hH}r'(hJ]hK]hL]hM]hP]uh>j'hT]r'h–)r'}r'(h=X``1``h>j'hDhEhFhžhH}r'(hJ]hK]hL]hM]hP]uhRNhShhT]r'h]X1…r'}r'(h=X1hDNhRNhShh>j'ubaubahFhtubahFjubehFjžubaubhp)r'}r'(h=XyBuild with optimization. This is appropriate for production use, taking more time to build faster libraries and programs.r'h>jü&hDhEhFhthH}r '(hJ]hK]hL]hM]hP]uhRMÕhShhT]r!'h]XyBuild with optimization. This is appropriate for production use, taking more time to build faster libraries and programs.r"'…r#'}r$'(h=j'hDNhRNhShh>j'ubaubhp)r%'}r&'(h=XÎThe optional *nat* value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 disables optimization, level 1 is the default. Level 2 is higher optimisation if the compiler supports it. Level 2 is likely to lead to longer compile times and bigger generated code. If you are not planning to run code, turning off optimization will lead to better build times and less code to be rebuilt when a module changes.h>jü&hDhEhFhthH}r''(hJ]hK]hL]hM]hP]uhRMØhShhT]r('(h]X The optional r)'…r*'}r+'(h=X The optional hDNhRNhShh>j%'ubj))r,'}r-'(h=X*nat*hH}r.'(hJ]hK]hL]hM]hP]uh>j%'hT]r/'h]Xnatr0'…r1'}r2'(h=Xnath>j,'ubahFj1ubh]X¼ value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 disables optimization, level 1 is the default. Level 2 is higher optimisation if the compiler supports it. Level 2 is likely to lead to longer compile times and bigger generated code. If you are not planning to run code, turning off optimization will lead to better build times and less code to be rebuilt when a module changes.r3'…r4'}r5'(h=X¼ value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 disables optimization, level 1 is the default. Level 2 is higher optimisation if the compiler supports it. Level 2 is likely to lead to longer compile times and bigger generated code. If you are not planning to run code, turning off optimization will lead to better build times and less code to be rebuilt when a module changes.hDNhRNhShh>j%'ubeubhp)r6'}r7'(h=XGWhen optimizations are enabled, Cabal passes ``-O2`` to the C compiler.h>jü&hDhEhFhthH}r8'(hJ]hK]hL]hM]hP]uhRMàhShhT]r9'(h]X-When optimizations are enabled, Cabal passes r:'…r;'}r<'(h=X-When optimizations are enabled, Cabal passes hDNhRNhShh>j6'ubh–)r='}r>'(h=X``-O2``hH}r?'(hJ]hK]hL]hM]hP]uh>j6'hT]r@'h]X-O2rA'…rB'}rC'(h=X-O2h>j='ubahFhžubh]X to the C compiler.rD'…rE'}rF'(h=X to the C compiler.hDNhRNhShh>j6'ubeubhp)rG'}rH'(h=XJWe also accept ``True`` (equivalent to 1) and ``False`` (equivalent to 0).h>jü&hDhEhFhthH}rI'(hJ]hK]hL]hM]hP]uhRMâhShhT]rJ'(h]XWe also accept rK'…rL'}rM'(h=XWe also accept hDNhRNhShh>jG'ubh–)rN'}rO'(h=X``True``hH}rP'(hJ]hK]hL]hM]hP]uh>jG'hT]rQ'h]XTruerR'…rS'}rT'(h=XTrueh>jN'ubahFhžubh]X (equivalent to 1) and rU'…rV'}rW'(h=X (equivalent to 1) and hDNhRNhShh>jG'ubh–)rX'}rY'(h=X ``False``hH}rZ'(hJ]hK]hL]hM]hP]uh>jG'hT]r['h]XFalser\'…r]'}r^'(h=XFalseh>jX'ubahFhžubh]X (equivalent to 0).r_'…r`'}ra'(h=X (equivalent to 0).hDNhRNhShh>jG'ubeubhp)rb'}rc'(h=X Note that as of GHC 8.0, GHC does not recompile when optimization levels change (see :ghc-ticket:`10923`), so if you change the optimization level for a local package you may need to blow away your old build products in order to rebuild with the new optimization level.h>jü&hDhEhFhthH}rd'(hJ]hK]hL]hM]hP]uhRMåhShhT]re'(h]XUNote that as of GHC 8.0, GHC does not recompile when optimization levels change (see rf'…rg'}rh'(h=XUNote that as of GHC 8.0, GHC does not recompile when optimization levels change (see hDNhRNhShh>jb'ubjæ)ri'}rj'(h=X GHC #10923hH}rk'(UrefuriX,http://ghc.haskell.org/trac/ghc/ticket/10923hM]hL]hJ]hK]hP]Uinternal‰uh>jb'hT]rl'h]X GHC #10923rm'…rn'}ro'(h=X10923h>ji'ubahFjïubh]X¥), so if you change the optimization level for a local package you may need to blow away your old build products in order to rebuild with the new optimization level.rp'…rq'}rr'(h=X¥), so if you change the optimization level for a local package you may need to blow away your old build products in order to rebuild with the new optimization level.hDNhRNhShh>jb'ubeubhp)rs'}rt'(h=X±The command line variant of this flag is ``-O2`` (with ``-O1`` equivalent to ``-O``). There are also long-form variants ``--enable-optimization`` and ``--disable-optimization``.h>jü&hDhEhFhthH}ru'(hJ]hK]hL]hM]hP]uhRMëhShhT]rv'(h]X)The command line variant of this flag is rw'…rx'}ry'(h=X)The command line variant of this flag is hDNhRNhShh>js'ubh–)rz'}r{'(h=X``-O2``hH}r|'(hJ]hK]hL]hM]hP]uh>js'hT]r}'h]X-O2r~'…r'}r€'(h=X-O2h>jz'ubahFhžubh]X (with r'…r‚'}rƒ'(h=X (with hDNhRNhShh>js'ubh–)r„'}r…'(h=X``-O1``hH}r†'(hJ]hK]hL]hM]hP]uh>js'hT]r‡'h]X-O1rˆ'…r‰'}rŠ'(h=X-O1h>j„'ubahFhžubh]X equivalent to r‹'…rŒ'}r'(h=X equivalent to hDNhRNhShh>js'ubh–)rŽ'}r'(h=X``-O``hH}r'(hJ]hK]hL]hM]hP]uh>js'hT]r‘'h]X-Or’'…r“'}r”'(h=X-Oh>jŽ'ubahFhžubh]X%). There are also long-form variants r•'…r–'}r—'(h=X%). There are also long-form variants hDNhRNhShh>js'ubh–)r˜'}r™'(h=X``--enable-optimization``hH}rš'(hJ]hK]hL]hM]hP]uh>js'hT]r›'h]X--enable-optimizationrœ'…r'}rž'(h=X--enable-optimizationh>j˜'ubahFhžubh]X and rŸ'…r '}r¡'(h=X and hDNhRNhShh>js'ubh–)r¢'}r£'(h=X``--disable-optimization``hH}r¤'(hJ]hK]hL]hM]hP]uh>js'hT]r¥'h]X--disable-optimizationr¦'…r§'}r¨'(h=X--disable-optimizationh>j¢'ubahFhžubh]X.…r©'}rª'(h=X.hDNhRNhShh>js'ubeubeubeubj7)r«'}r¬'(h=Uh>jf hDhEhFj:hH}r­'(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r®'}r¯'(h=Uh>jf hDhEhFj?hH}r°'(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr±'jEj±'uhRNhShhT]r²'(jG)r³'}r´'(h=X)configure-options: args (space separated)h>j®'hDhEhFjJhH}rµ'(hM]r¶'Xcfg-field-configure-optionsr·'ahL]hJ]hK]hP]jN‰uhRNhShhT]r¸'(j7)r¹'}rº'(h=Uh>j³'hDhEhFj:hH}r»'(hM]hL]hJ]hK]hP]Uentries]r¼'(jTX(configure-options ; cabal project optionj·'UNtr½'auhRNhShhT]ubjV)r¾'}r¿'(h=Xconfigure-optionsrÀ'h>j³'hDhEhFjZhH}rÁ'(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÂ'h]Xconfigure-optionsrÃ'…rÄ'}rÅ'(h=UhDNhRNhShh>j¾'ubaubj`)rÆ'}rÇ'(h=jch>j³'hDhEhFjdhH}rÈ'(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÉ'h]X: rÊ'…rË'}rÌ'(h=UhDNhRNhShh>jÆ'ubaubjj)rÍ'}rÎ'(h=Xargs (space separated)h>j³'hDhEhFjmhH}rÏ'(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÐ'h]Xargs (space separated)rÑ'…rÒ'}rÓ'(h=UhDNhRNhShh>jÍ'ubaubeubjG)rÔ'}rÕ'(h=X--configure-option=argh>j®'hDhEhFjJhH}rÖ'(hM]r×'Xcfg-flag---configure-optionrØ'ahL]hJ]hK]hP]jN‰uhRNhShhT]rÙ'(j7)rÚ'}rÛ'(h=Uh>jÔ'hDhEhFj:hH}rÜ'(hM]hL]hJ]hK]hP]Uentries]rÝ'(jTX(--configure-option; cabal project optionjØ'UNtrÞ'auhRNhShhT]ubjV)rß'}rà'(h=X--configure-optionrá'h>jÔ'hDhEhFjZhH}râ'(jjhM]hL]hJ]hK]hP]uhRNhShhT]rã'h]X--configure-optionrä'…rå'}ræ'(h=UhDNhRNhShh>jß'ubaubj`)rç'}rè'(h=X=argh>jÔ'hDhEhFjdhH}ré'(jjhM]hL]hJ]hK]hP]uhRNhShhT]rê'h]X=argrë'…rì'}rí'(h=UhDNhRNhShh>jç'ubaubeubjs)rî'}rï'(h=Uh>j®'hDhEhFjvhH}rð'(hJ]hK]hL]hM]hP]uhRNhShhT]rñ'(hp)rò'}ró'(h=XA list of extra arguments to pass to the external ``./configure`` script, if one is used. This is only useful for packages which have the ``Configure`` build type. See also the section on `system-dependent parameters `__.h>jî'hDhEhFhthH}rô'(hJ]hK]hL]hM]hP]uhRMóhShhT]rõ'(h]X2A list of extra arguments to pass to the external rö'…r÷'}rø'(h=X2A list of extra arguments to pass to the external hDNhRNhShh>jò'ubh–)rù'}rú'(h=X``./configure``hH}rû'(hJ]hK]hL]hM]hP]uh>jò'hT]rü'h]X ./configurerý'…rþ'}rÿ'(h=X ./configureh>jù'ubahFhžubh]XI script, if one is used. This is only useful for packages which have the r(…r(}r((h=XI script, if one is used. This is only useful for packages which have the hDNhRNhShh>jò'ubh–)r(}r((h=X ``Configure``hH}r((hJ]hK]hL]hM]hP]uh>jò'hT]r(h]X Configurer(…r(}r ((h=X Configureh>j(ubahFhžubh]X% build type. See also the section on r (…r (}r ((h=X% build type. See also the section on hDNhRNhShh>jò'ubjæ)r (}r((h=XV`system-dependent parameters `__hH}r((UnameXsystem-dependent parametersjêX4developing-packages.html#system-dependent-parametershM]hL]hJ]hK]hP]uh>jò'hT]r(h]Xsystem-dependent parametersr(…r(}r((h=Xsystem-dependent parametersh>j (ubahFjïubh]X.…r(}r((h=X.hDNhRNhShh>jò'ubeubhp)r(}r((h=X„The command line variant of this flag is ``--configure-option=arg``, which can be specified multiple times to pass multiple options.h>jî'hDhEhFhthH}r((hJ]hK]hL]hM]hP]uhRMùhShhT]r((h]X)The command line variant of this flag is r(…r(}r((h=X)The command line variant of this flag is hDNhRNhShh>j(ubh–)r(}r((h=X``--configure-option=arg``hH}r((hJ]hK]hL]hM]hP]uh>j(hT]r (h]X--configure-option=argr!(…r"(}r#((h=X--configure-option=argh>j(ubahFhžubh]XA, which can be specified multiple times to pass multiple options.r$(…r%(}r&((h=XA, which can be specified multiple times to pass multiple options.hDNhRNhShh>j(ubeubeubeubj7)r'(}r(((h=Uh>jf hDhEhFj:hH}r)((hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r*(}r+((h=Uh>jf hDhEhFj?hH}r,((jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr-(jEj-(uhRNhShhT]r.((jG)r/(}r0((h=X4compiler: ghc, ghcjs, jhc, lhc, uhc or haskell-suiteh>j*(hDhEhFjJhH}r1((hM]r2(Xcfg-field-compilerr3(ahL]hJ]hK]hP]jN‰uhRNhShhT]r4((j7)r5(}r6((h=Uh>j/(hDhEhFj:hH}r7((hM]hL]hJ]hK]hP]Uentries]r8((jTXcompiler ; cabal project optionj3(UNtr9(auhRNhShhT]ubjV)r:(}r;((h=Xcompilerr<(h>j/(hDhEhFjZhH}r=((jjhM]hL]hJ]hK]hP]uhRNhShhT]r>(h]Xcompilerr?(…r@(}rA((h=UhDNhRNhShh>j:(ubaubj`)rB(}rC((h=jch>j/(hDhEhFjdhH}rD((jjhM]hL]hJ]hK]hP]uhRNhShhT]rE(h]X: rF(…rG(}rH((h=UhDNhRNhShh>jB(ubaubjj)rI(}rJ((h=X*ghc, ghcjs, jhc, lhc, uhc or haskell-suiteh>j/(hDhEhFjmhH}rK((jjhM]hL]hJ]hK]hP]uhRNhShhT]rL(h]X*ghc, ghcjs, jhc, lhc, uhc or haskell-suiterM(…rN(}rO((h=UhDNhRNhShh>jI(ubaubeubjG)rP(}rQ((h=X--compiler=compilerh>j*(hDhEhFjJhH}rR((hM]rS(Xcfg-flag---compilerrT(ahL]hJ]hK]hP]jN‰uhRNhShhT]rU((j7)rV(}rW((h=Uh>jP(hDhEhFj:hH}rX((hM]hL]hJ]hK]hP]Uentries]rY((jTX --compiler; cabal project optionjT(UNtrZ(auhRNhShhT]ubjV)r[(}r\((h=X --compilerr](h>jP(hDhEhFjZhH}r^((jjhM]hL]hJ]hK]hP]uhRNhShhT]r_(h]X --compilerr`(…ra(}rb((h=UhDNhRNhShh>j[(ubaubj`)rc(}rd((h=X =compilerh>jP(hDhEhFjdhH}re((jjhM]hL]hJ]hK]hP]uhRNhShhT]rf(h]X =compilerrg(…rh(}ri((h=UhDNhRNhShh>jc(ubaubeubjs)rj(}rk((h=Uh>j*(hDhEhFjvhH}rl((hJ]hK]hL]hM]hP]uhRNhShhT]rm((jy)rn(}ro((h=Uh>jj(hDhEhFj|hH}rp((hJ]hK]hL]hM]hP]uhRNhShhT]rq(j)rr(}rs((h=UhH}rt((hJ]hK]hL]hM]hP]uh>jn(hT]ru((j„)rv(}rw((h=X Default valueh>jr(hDhEhFj‡hH}rx((hJ]hK]hL]hM]hP]uhRKhT]ry(h]X Default valuerz(…r{(}r|((h=Uh>jv(ubaubj)r}(}r~((h=UhH}r((hJ]hK]hL]hM]hP]uh>jr(hT]r€(hp)r(}r‚((h=XghchH}rƒ((hJ]hK]hL]hM]hP]uh>j}(hT]r„(h–)r…(}r†((h=X``ghc``h>j(hDhEhFhžhH}r‡((hJ]hK]hL]hM]hP]uhRNhShhT]rˆ(h]Xghcr‰(…rŠ(}r‹((h=XghchDNhRNhShh>j…(ubaubahFhtubahFjubehFjžubaubhp)rŒ(}r((h=X“Specify which compiler toolchain to be used. This is independent of ``with-compiler``, because the choice of toolchain affects Cabal's build logic.h>jj(hDhEhFhthH}rŽ((hJ]hK]hL]hM]hP]uhRMhShhT]r((h]XDSpecify which compiler toolchain to be used. This is independent of r(…r‘(}r’((h=XDSpecify which compiler toolchain to be used. This is independent of hDNhRNhShh>jŒ(ubh–)r“(}r”((h=X``with-compiler``hH}r•((hJ]hK]hL]hM]hP]uh>jŒ(hT]r–(h]X with-compilerr—(…r˜(}r™((h=X with-compilerh>j“(ubahFhžubh]X@, because the choice of toolchain affects Cabal’s build logic.rš(…r›(}rœ((h=X>, because the choice of toolchain affects Cabal's build logic.hDNhRNhShh>jŒ(ubeubhp)r(}rž((h=X<The command line variant of this flag is ``--compiler=ghc``.h>jj(hDhEhFhthH}rŸ((hJ]hK]hL]hM]hP]uhRMhShhT]r ((h]X)The command line variant of this flag is r¡(…r¢(}r£((h=X)The command line variant of this flag is hDNhRNhShh>j(ubh–)r¤(}r¥((h=X``--compiler=ghc``hH}r¦((hJ]hK]hL]hM]hP]uh>j(hT]r§(h]X--compiler=ghcr¨(…r©(}rª((h=X--compiler=ghch>j¤(ubahFhžubh]X.…r«(}r¬((h=X.hDNhRNhShh>j(ubeubeubeubj7)r­(}r®((h=Uh>jf hDhEhFj:hH}r¯((hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r°(}r±((h=Uh>jf hDhEhFj?hH}r²((jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr³(jEj³(uhRNhShhT]r´((jG)rµ(}r¶((h=Xtests: booleanh>j°(hDhEhFjJhH}r·((hM]r¸(Xcfg-field-testsr¹(ahL]hJ]hK]hP]jN‰uhRNhShhT]rº((j7)r»(}r¼((h=Uh>jµ(hDhEhFj:hH}r½((hM]hL]hJ]hK]hP]Uentries]r¾((jTXtests ; cabal project optionj¹(UNtr¿(auhRNhShhT]ubjV)rÀ(}rÁ((h=XtestsrÂ(h>jµ(hDhEhFjZhH}rÃ((jjhM]hL]hJ]hK]hP]uhRNhShhT]rÄ(h]XtestsrÅ(…rÆ(}rÇ((h=UhDNhRNhShh>jÀ(ubaubj`)rÈ(}rÉ((h=jch>jµ(hDhEhFjdhH}rÊ((jjhM]hL]hJ]hK]hP]uhRNhShhT]rË(h]X: rÌ(…rÍ(}rÎ((h=UhDNhRNhShh>jÈ(ubaubjj)rÏ(}rÐ((h=Xbooleanh>jµ(hDhEhFjmhH}rÑ((jjhM]hL]hJ]hK]hP]uhRNhShhT]rÒ(h]XbooleanrÓ(…rÔ(}rÕ((h=UhDNhRNhShh>jÏ(ubaubeubjG)rÖ(}r×((h=X--enable-testsrØ(h>j°(hDhEhFjJhH}rÙ((hM]rÚ(Xcfg-flag---enable-testsrÛ(ahL]hJ]hK]hP]jN‰uhRNhShhT]rÜ((j7)rÝ(}rÞ((h=Uh>jÖ(hDhEhFj:hH}rß((hM]hL]hJ]hK]hP]Uentries]rà((jTX$--enable-tests; cabal project optionjÛ(UNtrá(auhRNhShhT]ubjV)râ(}rã((h=jØ(h>jÖ(hDhEhFjZhH}rä((jjhM]hL]hJ]hK]hP]uhRNhShhT]rå(h]X--enable-testsræ(…rç(}rè((h=UhDNhRNhShh>jâ(ubaubj`)ré(}rê((h=U h>jÖ(hDhEhFjdhH}rë((jjhM]hL]hJ]hK]hP]uhRNhShhT]rì(h]X …rí(}rî((h=UhDNhRNhShh>jé(ubaubeubjG)rï(}rð((h=X--disable-testsrñ(h>j°(hDhEhFjJhH}rò((hM]ró(Xcfg-flag---disable-testsrô(ahL]hJ]hK]hP]jN‰uhRNhShhT]rõ((j7)rö(}r÷((h=Uh>jï(hDhEhFj:hH}rø((hM]hL]hJ]hK]hP]Uentries]rù((jTX%--disable-tests; cabal project optionjô(UNtrú(auhRNhShhT]ubjV)rû(}rü((h=jñ(h>jï(hDhEhFjZhH}rý((jjhM]hL]hJ]hK]hP]uhRNhShhT]rþ(h]X--disable-testsrÿ(…r)}r)(h=UhDNhRNhShh>jû(ubaubj`)r)}r)(h=U h>jï(hDhEhFjdhH}r)(jjhM]hL]hJ]hK]hP]uhRNhShhT]r)h]X …r)}r)(h=UhDNhRNhShh>j)ubaubeubjs)r)}r )(h=Uh>j°(hDhEhFjvhH}r )(hJ]hK]hL]hM]hP]uhRNhShhT]r )(jy)r )}r )(h=Uh>j)hDhEhFj|hH}r)(hJ]hK]hL]hM]hP]uhRNhShhT]r)j)r)}r)(h=UhH}r)(hJ]hK]hL]hM]hP]uh>j )hT]r)(j„)r)}r)(h=X Default valueh>j)hDhEhFj‡hH}r)(hJ]hK]hL]hM]hP]uhRKhT]r)h]X Default valuer)…r)}r)(h=Uh>j)ubaubj)r)}r)(h=UhH}r)(hJ]hK]hL]hM]hP]uh>j)hT]r)hp)r)}r )(h=XFalsehH}r!)(hJ]hK]hL]hM]hP]uh>j)hT]r")h–)r#)}r$)(h=X ``False``h>j)hDhEhFhžhH}r%)(hJ]hK]hL]hM]hP]uhRNhShhT]r&)h]XFalser')…r()}r))(h=XFalsehDNhRNhShh>j#)ubaubahFhtubahFjubehFjžubaubhp)r*)}r+)(h=XForce test suites to be enabled. For most users this should not be needed, as we always attempt to solve for test suite dependencies, even when this value is ``False``; furthermore, test suites are automatically enabled if they are requested as a built target.h>j)hDhEhFhthH}r,)(hJ]hK]hL]hM]hP]uhRMhShhT]r-)(h]XžForce test suites to be enabled. For most users this should not be needed, as we always attempt to solve for test suite dependencies, even when this value is r.)…r/)}r0)(h=XžForce test suites to be enabled. For most users this should not be needed, as we always attempt to solve for test suite dependencies, even when this value is hDNhRNhShh>j*)ubh–)r1)}r2)(h=X ``False``hH}r3)(hJ]hK]hL]hM]hP]uh>j*)hT]r4)h]XFalser5)…r6)}r7)(h=XFalseh>j1)ubahFhžubh]X]; furthermore, test suites are automatically enabled if they are requested as a built target.r8)…r9)}r:)(h=X]; furthermore, test suites are automatically enabled if they are requested as a built target.hDNhRNhShh>j*)ubeubhp)r;)}r<)(h=XTThe command line variant of this flag is ``--enable-tests`` and ``--disable-tests``.h>j)hDhEhFhthH}r=)(hJ]hK]hL]hM]hP]uhRMhShhT]r>)(h]X)The command line variant of this flag is r?)…r@)}rA)(h=X)The command line variant of this flag is hDNhRNhShh>j;)ubh–)rB)}rC)(h=X``--enable-tests``hH}rD)(hJ]hK]hL]hM]hP]uh>j;)hT]rE)h]X--enable-testsrF)…rG)}rH)(h=X--enable-testsh>jB)ubahFhžubh]X and rI)…rJ)}rK)(h=X and hDNhRNhShh>j;)ubh–)rL)}rM)(h=X``--disable-tests``hH}rN)(hJ]hK]hL]hM]hP]uh>j;)hT]rO)h]X--disable-testsrP)…rQ)}rR)(h=X--disable-testsh>jL)ubahFhžubh]X.…rS)}rT)(h=X.hDNhRNhShh>j;)ubeubeubeubj7)rU)}rV)(h=Uh>jf hDhEhFj:hH}rW)(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rX)}rY)(h=Uh>jf hDhEhFj?hH}rZ)(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr[)jEj[)uhRNhShhT]r\)(jG)r])}r^)(h=Xbenchmarks: booleanh>jX)hDhEhFjJhH}r_)(hM]r`)Xcfg-field-benchmarksra)ahL]hJ]hK]hP]jN‰uhRNhShhT]rb)(j7)rc)}rd)(h=Uh>j])hDhEhFj:hH}re)(hM]hL]hJ]hK]hP]Uentries]rf)(jTX!benchmarks ; cabal project optionja)UNtrg)auhRNhShhT]ubjV)rh)}ri)(h=X benchmarksrj)h>j])hDhEhFjZhH}rk)(jjhM]hL]hJ]hK]hP]uhRNhShhT]rl)h]X benchmarksrm)…rn)}ro)(h=UhDNhRNhShh>jh)ubaubj`)rp)}rq)(h=jch>j])hDhEhFjdhH}rr)(jjhM]hL]hJ]hK]hP]uhRNhShhT]rs)h]X: rt)…ru)}rv)(h=UhDNhRNhShh>jp)ubaubjj)rw)}rx)(h=Xbooleanh>j])hDhEhFjmhH}ry)(jjhM]hL]hJ]hK]hP]uhRNhShhT]rz)h]Xbooleanr{)…r|)}r})(h=UhDNhRNhShh>jw)ubaubeubjG)r~)}r)(h=X--enable-benchmarksr€)h>jX)hDhEhFjJhH}r)(hM]r‚)Xcfg-flag---enable-benchmarksrƒ)ahL]hJ]hK]hP]jN‰uhRNhShhT]r„)(j7)r…)}r†)(h=Uh>j~)hDhEhFj:hH}r‡)(hM]hL]hJ]hK]hP]Uentries]rˆ)(jTX)--enable-benchmarks; cabal project optionjƒ)UNtr‰)auhRNhShhT]ubjV)rŠ)}r‹)(h=j€)h>j~)hDhEhFjZhH}rŒ)(jjhM]hL]hJ]hK]hP]uhRNhShhT]r)h]X--enable-benchmarksrŽ)…r)}r)(h=UhDNhRNhShh>jŠ)ubaubj`)r‘)}r’)(h=U h>j~)hDhEhFjdhH}r“)(jjhM]hL]hJ]hK]hP]uhRNhShhT]r”)h]X …r•)}r–)(h=UhDNhRNhShh>j‘)ubaubeubjG)r—)}r˜)(h=X--disable-benchmarksr™)h>jX)hDhEhFjJhH}rš)(hM]r›)Xcfg-flag---disable-benchmarksrœ)ahL]hJ]hK]hP]jN‰uhRNhShhT]r)(j7)rž)}rŸ)(h=Uh>j—)hDhEhFj:hH}r )(hM]hL]hJ]hK]hP]Uentries]r¡)(jTX*--disable-benchmarks; cabal project optionjœ)UNtr¢)auhRNhShhT]ubjV)r£)}r¤)(h=j™)h>j—)hDhEhFjZhH}r¥)(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¦)h]X--disable-benchmarksr§)…r¨)}r©)(h=UhDNhRNhShh>j£)ubaubj`)rª)}r«)(h=U h>j—)hDhEhFjdhH}r¬)(jjhM]hL]hJ]hK]hP]uhRNhShhT]r­)h]X …r®)}r¯)(h=UhDNhRNhShh>jª)ubaubeubjs)r°)}r±)(h=Uh>jX)hDhEhFjvhH}r²)(hJ]hK]hL]hM]hP]uhRNhShhT]r³)(jy)r´)}rµ)(h=Uh>j°)hDhEhFj|hH}r¶)(hJ]hK]hL]hM]hP]uhRNhShhT]r·)j)r¸)}r¹)(h=UhH}rº)(hJ]hK]hL]hM]hP]uh>j´)hT]r»)(j„)r¼)}r½)(h=X Default valueh>j¸)hDhEhFj‡hH}r¾)(hJ]hK]hL]hM]hP]uhRKhT]r¿)h]X Default valuerÀ)…rÁ)}rÂ)(h=Uh>j¼)ubaubj)rÃ)}rÄ)(h=UhH}rÅ)(hJ]hK]hL]hM]hP]uh>j¸)hT]rÆ)hp)rÇ)}rÈ)(h=XFalsehH}rÉ)(hJ]hK]hL]hM]hP]uh>jÃ)hT]rÊ)h–)rË)}rÌ)(h=X ``False``h>jÇ)hDhEhFhžhH}rÍ)(hJ]hK]hL]hM]hP]uhRNhShhT]rÎ)h]XFalserÏ)…rÐ)}rÑ)(h=XFalsehDNhRNhShh>jË)ubaubahFhtubahFjubehFjžubaubhp)rÒ)}rÓ)(h=XForce benchmarks to be enabled. For most users this should not be needed, as we always attempt to solve for benchmark dependencies, even when this value is ``False``; furthermore, benchmarks are automatically enabled if they are requested as a built target.h>j°)hDhEhFhthH}rÔ)(hJ]hK]hL]hM]hP]uhRMhShhT]rÕ)(h]XœForce benchmarks to be enabled. For most users this should not be needed, as we always attempt to solve for benchmark dependencies, even when this value is rÖ)…r×)}rØ)(h=XœForce benchmarks to be enabled. For most users this should not be needed, as we always attempt to solve for benchmark dependencies, even when this value is hDNhRNhShh>jÒ)ubh–)rÙ)}rÚ)(h=X ``False``hH}rÛ)(hJ]hK]hL]hM]hP]uh>jÒ)hT]rÜ)h]XFalserÝ)…rÞ)}rß)(h=XFalseh>jÙ)ubahFhžubh]X\; furthermore, benchmarks are automatically enabled if they are requested as a built target.rà)…rá)}râ)(h=X\; furthermore, benchmarks are automatically enabled if they are requested as a built target.hDNhRNhShh>jÒ)ubeubhp)rã)}rä)(h=X^The command line variant of this flag is ``--enable-benchmarks`` and ``--disable-benchmarks``.h>j°)hDhEhFhthH}rå)(hJ]hK]hL]hM]hP]uhRM#hShhT]ræ)(h]X)The command line variant of this flag is rç)…rè)}ré)(h=X)The command line variant of this flag is hDNhRNhShh>jã)ubh–)rê)}rë)(h=X``--enable-benchmarks``hH}rì)(hJ]hK]hL]hM]hP]uh>jã)hT]rí)h]X--enable-benchmarksrî)…rï)}rð)(h=X--enable-benchmarksh>jê)ubahFhžubh]X and rñ)…rò)}ró)(h=X and hDNhRNhShh>jã)ubh–)rô)}rõ)(h=X``--disable-benchmarks``hH}rö)(hJ]hK]hL]hM]hP]uh>jã)hT]r÷)h]X--disable-benchmarksrø)…rù)}rú)(h=X--disable-benchmarksh>jô)ubahFhžubh]X.…rû)}rü)(h=X.hDNhRNhShh>jã)ubeubeubeubj7)rý)}rþ)(h=Uh>jf hDhEhFj:hH}rÿ)(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r*}r*(h=Uh>jf hDhEhFj?hH}r*(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr*jEj*uhRNhShhT]r*(jG)r*}r*(h=X3extra-prog-path: paths (newline or comma separated)h>j*hDhEhFjJhH}r*(hM]r*Xcfg-field-extra-prog-pathr *ahL]hJ]hK]hP]jN‰uhRNhShhT]r *(j7)r *}r *(h=Uh>j*hDhEhFj:hH}r *(hM]hL]hJ]hK]hP]Uentries]r*(jTX&extra-prog-path ; cabal project optionj *UNtr*auhRNhShhT]ubjV)r*}r*(h=Xextra-prog-pathr*h>j*hDhEhFjZhH}r*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r*h]Xextra-prog-pathr*…r*}r*(h=UhDNhRNhShh>j*ubaubj`)r*}r*(h=jch>j*hDhEhFjdhH}r*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r*h]X: r*…r*}r*(h=UhDNhRNhShh>j*ubaubjj)r*}r *(h=X"paths (newline or comma separated)h>j*hDhEhFjmhH}r!*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r"*h]X"paths (newline or comma separated)r#*…r$*}r%*(h=UhDNhRNhShh>j*ubaubeubjG)r&*}r'*(h=X--extra-prog-path=PATHh>j*hDhEhFjJhH}r(*(hM]r)*Xcfg-flag---extra-prog-pathr**ahL]hJ]hK]hP]jN‰uhRNhShhT]r+*(j7)r,*}r-*(h=Uh>j&*hDhEhFj:hH}r.*(hM]hL]hJ]hK]hP]Uentries]r/*(jTX'--extra-prog-path; cabal project optionj**UNtr0*auhRNhShhT]ubjV)r1*}r2*(h=X--extra-prog-pathr3*h>j&*hDhEhFjZhH}r4*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r5*h]X--extra-prog-pathr6*…r7*}r8*(h=UhDNhRNhShh>j1*ubaubj`)r9*}r:*(h=X=PATHh>j&*hDhEhFjdhH}r;*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r<*h]X=PATHr=*…r>*}r?*(h=UhDNhRNhShh>j9*ubaubeubjs)r@*}rA*(h=Uh>j*hDhEhFjvhH}rB*(hJ]hK]hL]hM]hP]uhRNhShhT]rC*(jy)rD*}rE*(h=Uh>j@*hDhEhFj|hH}rF*(hJ]hK]hL]hM]hP]uhRNhShhT]rG*j)rH*}rI*(h=Uh>jD*hDhEhFjžhH}rJ*(hJ]hK]hL]hM]hP]uhRNhShhT]rK*(j„)rL*}rM*(h=j2h>jH*hDhEhFj‡hH}rN*(hJ]hK]hL]hM]hP]uhRKhT]rO*h]XSincerP*…rQ*}rR*(h=Uh>jL*ubaubj)rS*}rT*(h=U Cabal 1.18rU*hH}rV*(hJ]hK]hL]hM]hP]uh>jH*hT]rW*hp)rX*}rY*(h=jU*hH}rZ*(hJ]hK]hL]hM]hP]uh>jS*hT]r[*h]X Cabal 1.18r\*…r]*}r^*(h=Uh>jX*ubahFhtubahFjubeubaubhp)r_*}r`*(h=XA list of directories to search for extra required programs. Most users should not need this, as programs like ``happy`` and ``alex`` will automatically be installed and added to the path. This can be useful if a ``Custom`` setup script relies on an exotic extra program.h>j@*hDhEhFhthH}ra*(hJ]hK]hL]hM]hP]uhRM+hShhT]rb*(h]XoA list of directories to search for extra required programs. Most users should not need this, as programs like rc*…rd*}re*(h=XoA list of directories to search for extra required programs. Most users should not need this, as programs like hDNhRNhShh>j_*ubh–)rf*}rg*(h=X ``happy``hH}rh*(hJ]hK]hL]hM]hP]uh>j_*hT]ri*h]Xhappyrj*…rk*}rl*(h=Xhappyh>jf*ubahFhžubh]X and rm*…rn*}ro*(h=X and hDNhRNhShh>j_*ubh–)rp*}rq*(h=X``alex``hH}rr*(hJ]hK]hL]hM]hP]uh>j_*hT]rs*h]Xalexrt*…ru*}rv*(h=Xalexh>jp*ubahFhžubh]XP will automatically be installed and added to the path. This can be useful if a rw*…rx*}ry*(h=XP will automatically be installed and added to the path. This can be useful if a hDNhRNhShh>j_*ubh–)rz*}r{*(h=X ``Custom``hH}r|*(hJ]hK]hL]hM]hP]uh>j_*hT]r}*h]XCustomr~*…r*}r€*(h=XCustomh>jz*ubahFhžubh]X0 setup script relies on an exotic extra program.r*…r‚*}rƒ*(h=X0 setup script relies on an exotic extra program.hDNhRNhShh>j_*ubeubhp)r„*}r…*(h=XkThe command line variant of this flag is ``--extra-prog-path=PATH``, which can be specified multiple times.h>j@*hDhEhFhthH}r†*(hJ]hK]hL]hM]hP]uhRM1hShhT]r‡*(h]X)The command line variant of this flag is rˆ*…r‰*}rŠ*(h=X)The command line variant of this flag is hDNhRNhShh>j„*ubh–)r‹*}rŒ*(h=X``--extra-prog-path=PATH``hH}r*(hJ]hK]hL]hM]hP]uh>j„*hT]rŽ*h]X--extra-prog-path=PATHr*…r*}r‘*(h=X--extra-prog-path=PATHh>j‹*ubahFhžubh]X(, which can be specified multiple times.r’*…r“*}r”*(h=X(, which can be specified multiple times.hDNhRNhShh>j„*ubeubeubeubj7)r•*}r–*(h=Uh>jf hDhEhFj:hH}r—*(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r˜*}r™*(h=Uh>jf hDhEhFj?hH}rš*(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr›*jEj›*uhRNhShhT]rœ*(jG)r*}rž*(h=Xrun-tests: booleanh>j˜*hDhEhFjJhH}rŸ*(hM]r *Xcfg-field-run-testsr¡*ahL]hJ]hK]hP]jN‰uhRNhShhT]r¢*(j7)r£*}r¤*(h=Uh>j*hDhEhFj:hH}r¥*(hM]hL]hJ]hK]hP]Uentries]r¦*(jTX run-tests ; cabal project optionj¡*UNtr§*auhRNhShhT]ubjV)r¨*}r©*(h=X run-testsrª*h>j*hDhEhFjZhH}r«*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¬*h]X run-testsr­*…r®*}r¯*(h=UhDNhRNhShh>j¨*ubaubj`)r°*}r±*(h=jch>j*hDhEhFjdhH}r²*(jjhM]hL]hJ]hK]hP]uhRNhShhT]r³*h]X: r´*…rµ*}r¶*(h=UhDNhRNhShh>j°*ubaubjj)r·*}r¸*(h=Xbooleanh>j*hDhEhFjmhH}r¹*(jjhM]hL]hJ]hK]hP]uhRNhShhT]rº*h]Xbooleanr»*…r¼*}r½*(h=UhDNhRNhShh>j·*ubaubeubjG)r¾*}r¿*(h=X --run-testsrÀ*h>j˜*hDhEhFjJhH}rÁ*(hM]rÂ*Xcfg-flag---run-testsrÃ*ahL]hJ]hK]hP]jN‰uhRNhShhT]rÄ*(j7)rÅ*}rÆ*(h=Uh>j¾*hDhEhFj:hH}rÇ*(hM]hL]hJ]hK]hP]Uentries]rÈ*(jTX!--run-tests; cabal project optionjÃ*UNtrÉ*auhRNhShhT]ubjV)rÊ*}rË*(h=jÀ*h>j¾*hDhEhFjZhH}rÌ*(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÍ*h]X --run-testsrÎ*…rÏ*}rÐ*(h=UhDNhRNhShh>jÊ*ubaubj`)rÑ*}rÒ*(h=U h>j¾*hDhEhFjdhH}rÓ*(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÔ*h]X …rÕ*}rÖ*(h=UhDNhRNhShh>jÑ*ubaubeubjs)r×*}rØ*(h=Uh>j˜*hDhEhFjvhH}rÙ*(hJ]hK]hL]hM]hP]uhRNhShhT]rÚ*(jy)rÛ*}rÜ*(h=Uh>j×*hDhEhFj|hH}rÝ*(hJ]hK]hL]hM]hP]uhRNhShhT]rÞ*j)rß*}rà*(h=UhH}rá*(hJ]hK]hL]hM]hP]uh>jÛ*hT]râ*(j„)rã*}rä*(h=X Default valueh>jß*hDhEhFj‡hH}rå*(hJ]hK]hL]hM]hP]uhRKhT]ræ*h]X Default valuerç*…rè*}ré*(h=Uh>jã*ubaubj)rê*}rë*(h=UhH}rì*(hJ]hK]hL]hM]hP]uh>jß*hT]rí*hp)rî*}rï*(h=XFalsehH}rð*(hJ]hK]hL]hM]hP]uh>jê*hT]rñ*h–)rò*}ró*(h=X ``False``rô*h>jî*hDhEhFhžhH}rõ*(hJ]hK]hL]hM]hP]uhRNhShhT]rö*h]XFalser÷*…rø*}rù*(h=XFalsehDNhRNhShh>jò*ubaubahFhtubahFjubehFjžubaubhp)rú*}rû*(h=X¾Run the package test suite upon installation. This is useful for saying "When this package is installed, check that the test suite passes, terminating the rest of the build if it is broken."rü*h>j×*hDhEhFhthH}rý*(hJ]hK]hL]hM]hP]uhRM:hShhT]rþ*h]XÂRun the package test suite upon installation. This is useful for saying “When this package is installed, check that the test suite passes, terminating the rest of the build if it is broken.â€rÿ*…r+}r+(h=jü*hDNhRNhShh>jú*ubaubcdocutils.nodes warning r+)r+}r+(h=XOne deficiency: the :cfg-field:`run-tests` setting of a package is NOT recorded as part of the hash, so if you install something without :cfg-field:`run-tests` and then turn on ``run-tests``, we won't subsequently test the package. If this is causing you problems, give us a shout.h>j×*hDhEhFUwarningr+hH}r+(hJ]hK]hL]hM]hP]uhRNhShhT]r+hp)r+}r +(h=XOne deficiency: the :cfg-field:`run-tests` setting of a package is NOT recorded as part of the hash, so if you install something without :cfg-field:`run-tests` and then turn on ``run-tests``, we won't subsequently test the package. If this is causing you problems, give us a shout.h>j+hDhEhFhthH}r +(hJ]hK]hL]hM]hP]uhRM@hT]r +(h]XOne deficiency: the r +…r +}r+(h=XOne deficiency: the h>j+ubjä)r+}r+(h=X:cfg-field:`run-tests`h>j+hDhEhFjçhH}r+(UreftypeX cfg-fieldjéˆjêX run-testsr+U refdomainXcabalr+hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM@hT]r+h–)r+}r+(h=j+hH}r+(hJ]hK]r+(jôj+Xcabal-cfg-fieldr+ehL]hM]hP]uh>j+hT]r+h]X run-testsr+…r+}r+(h=Uh>j+ubahFhžubaubh]X_ setting of a package is NOT recorded as part of the hash, so if you install something without r+…r+}r +(h=X_ setting of a package is NOT recorded as part of the hash, so if you install something without h>j+ubjä)r!+}r"+(h=X:cfg-field:`run-tests`h>j+hDhEhFjçhH}r#+(UreftypeX cfg-fieldjéˆjêX run-testsr$+U refdomainXcabalr%+hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM@hT]r&+h–)r'+}r(+(h=j$+hH}r)+(hJ]hK]r*+(jôj%+Xcabal-cfg-fieldr++ehL]hM]hP]uh>j!+hT]r,+h]X run-testsr-+…r.+}r/+(h=Uh>j'+ubahFhžubaubh]X and then turn on r0+…r1+}r2+(h=X and then turn on h>j+ubh–)r3+}r4+(h=X ``run-tests``hH}r5+(hJ]hK]hL]hM]hP]uh>j+hT]r6+h]X run-testsr7+…r8+}r9+(h=X run-testsh>j3+ubahFhžubh]X], we won’t subsequently test the package. If this is causing you problems, give us a shout.r:+…r;+}r<+(h=X[, we won't subsequently test the package. If this is causing you problems, give us a shout.h>j+ubeubaubhp)r=+}r>+(h=X9The command line variant of this flag is ``--run-tests``.h>j×*hDhEhFhthH}r?+(hJ]hK]hL]hM]hP]uhRMFhShhT]r@+(h]X)The command line variant of this flag is rA+…rB+}rC+(h=X)The command line variant of this flag is hDNhRNhShh>j=+ubh–)rD+}rE+(h=X``--run-tests``hH}rF+(hJ]hK]hL]hM]hP]uh>j=+hT]rG+h]X --run-testsrH+…rI+}rJ+(h=X --run-testsh>jD+ubahFhžubh]X.…rK+}rL+(h=X.hDNhRNhShh>j=+ubeubeubeubj7)rM+}rN+(h=Uh>jf hDhEhFj:hH}rO+(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rP+}rQ+(h=Uh>jf hDhEhFj?hH}rR+(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrS+jEjS+uhRNhShhT]rT+(jG)rU+}rV+(h=Xdebug-info: integerh>jP+hDhEhFjJhH}rW+(hM]rX+Xcfg-field-debug-inforY+ahL]hJ]hK]hP]jN‰uhRNhShhT]rZ+(j7)r[+}r\+(h=Uh>jU+hDhEhFj:hH}r]+(hM]hL]hJ]hK]hP]Uentries]r^+(jTX!debug-info ; cabal project optionjY+UNtr_+auhRNhShhT]ubjV)r`+}ra+(h=X debug-inforb+h>jU+hDhEhFjZhH}rc+(jjhM]hL]hJ]hK]hP]uhRNhShhT]rd+h]X debug-infore+…rf+}rg+(h=UhDNhRNhShh>j`+ubaubj`)rh+}ri+(h=jch>jU+hDhEhFjdhH}rj+(jjhM]hL]hJ]hK]hP]uhRNhShhT]rk+h]X: rl+…rm+}rn+(h=UhDNhRNhShh>jh+ubaubjj)ro+}rp+(h=Xintegerh>jU+hDhEhFjmhH}rq+(jjhM]hL]hJ]hK]hP]uhRNhShhT]rr+h]Xintegerrs+…rt+}ru+(h=UhDNhRNhShh>jo+ubaubeubjG)rv+}rw+(h=X--enable-debug-info=h>jP+hDhEhFjJhH}rx+(hM]ry+Xcfg-flag---enable-debug-inforz+ahL]hJ]hK]hP]jN‰uhRNhShhT]r{+(j7)r|+}r}+(h=Uh>jv+hDhEhFj:hH}r~+(hM]hL]hJ]hK]hP]Uentries]r+(jTX)--enable-debug-info; cabal project optionjz+UNtr€+auhRNhShhT]ubjV)r+}r‚+(h=X--enable-debug-inforƒ+h>jv+hDhEhFjZhH}r„+(jjhM]hL]hJ]hK]hP]uhRNhShhT]r…+h]X--enable-debug-infor†+…r‡+}rˆ+(h=UhDNhRNhShh>j+ubaubj`)r‰+}rŠ+(h=X=⟨n⟩h>jv+hDhEhFjdhH}r‹+(jjhM]hL]hJ]hK]hP]uhRNhShhT]rŒ+h]X=⟨n⟩r+…rŽ+}r+(h=UhDNhRNhShh>j‰+ubaubeubjG)r+}r‘+(h=X--disable-debug-infor’+h>jP+hDhEhFjJhH}r“+(hM]r”+Xcfg-flag---disable-debug-infor•+ahL]hJ]hK]hP]jN‰uhRNhShhT]r–+(j7)r—+}r˜+(h=Uh>j+hDhEhFj:hH}r™+(hM]hL]hJ]hK]hP]Uentries]rš+(jTX*--disable-debug-info; cabal project optionj•+UNtr›+auhRNhShhT]ubjV)rœ+}r+(h=j’+h>j+hDhEhFjZhH}rž+(jjhM]hL]hJ]hK]hP]uhRNhShhT]rŸ+h]X--disable-debug-infor +…r¡+}r¢+(h=UhDNhRNhShh>jœ+ubaubj`)r£+}r¤+(h=U h>j+hDhEhFjdhH}r¥+(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¦+h]X …r§+}r¨+(h=UhDNhRNhShh>j£+ubaubeubjs)r©+}rª+(h=Uh>jP+hDhEhFjvhH}r«+(hJ]hK]hL]hM]hP]uhRNhShhT]r¬+(jy)r­+}r®+(h=Uh>j©+hDhEhFj|hH}r¯+(hJ]hK]hL]hM]hP]uhRNhShhT]r°+(j)r±+}r²+(h=Uh>j­+hDhEhFjžhH}r³+(hJ]hK]hL]hM]hP]uhRNhShhT]r´+(j„)rµ+}r¶+(h=j2h>j±+hDhEhFj‡hH}r·+(hJ]hK]hL]hM]hP]uhRKhT]r¸+h]XSincer¹+…rº+}r»+(h=Uh>jµ+ubaubj)r¼+}r½+(h=U Cabal 1.22r¾+hH}r¿+(hJ]hK]hL]hM]hP]uh>j±+hT]rÀ+hp)rÁ+}rÂ+(h=j¾+hH}rÃ+(hJ]hK]hL]hM]hP]uh>j¼+hT]rÄ+h]X Cabal 1.22rÅ+…rÆ+}rÇ+(h=Uh>jÁ+ubahFhtubahFjubeubj)rÈ+}rÉ+(h=UhH}rÊ+(hJ]hK]hL]hM]hP]uh>j­+hT]rË+(j„)rÌ+}rÍ+(h=X Default valueh>jÈ+hDhEhFj‡hH}rÎ+(hJ]hK]hL]hM]hP]uhRKhT]rÏ+h]X Default valuerÐ+…rÑ+}rÒ+(h=Uh>jÌ+ubaubj)rÓ+}rÔ+(h=UhH}rÕ+(hJ]hK]hL]hM]hP]uh>jÈ+hT]rÖ+hp)r×+}rØ+(h=XFalsehH}rÙ+(hJ]hK]hL]hM]hP]uh>jÓ+hT]rÚ+h]XFalserÛ+…rÜ+}rÝ+(h=XFalsehDNhRNhShh>j×+ubahFhtubahFjubehFjžubeubhp)rÞ+}rß+(h=XíIf the compiler (e.g., GHC 7.10 and later) supports outputing OS native debug info (e.g., DWARF), setting ``debug-info: True`` will instruct it to do so. See the GHC wiki page on :ghc-wiki:`DWARF` for more information about this feature.h>j©+hDhEhFhthH}rà+(hJ]hK]hL]hM]hP]uhRMShShhT]rá+(h]XjIf the compiler (e.g., GHC 7.10 and later) supports outputing OS native debug info (e.g., DWARF), setting râ+…rã+}rä+(h=XjIf the compiler (e.g., GHC 7.10 and later) supports outputing OS native debug info (e.g., DWARF), setting hDNhRNhShh>jÞ+ubh–)rå+}ræ+(h=X``debug-info: True``hH}rç+(hJ]hK]hL]hM]hP]uh>jÞ+hT]rè+h]Xdebug-info: Trueré+…rê+}rë+(h=Xdebug-info: Trueh>jå+ubahFhžubh]X5 will instruct it to do so. See the GHC wiki page on rì+…rí+}rî+(h=X5 will instruct it to do so. See the GHC wiki page on hDNhRNhShh>jÞ+ubjæ)rï+}rð+(h=XDWARFrñ+hH}rò+(UrefuriX*http://ghc.haskell.org/trac/ghc/wiki/DWARFhM]hL]hJ]hK]hP]Uinternal‰uh>jÞ+hT]ró+h]XDWARFrô+…rõ+}rö+(h=jñ+h>jï+ubahFjïubh]X) for more information about this feature.r÷+…rø+}rù+(h=X) for more information about this feature.hDNhRNhShh>jÞ+ubeubhp)rú+}rû+(h=XT(This field also accepts numeric syntax, but until GHC 8.2 this didn't do anything.)rü+h>j©+hDhEhFhthH}rý+(hJ]hK]hL]hM]hP]uhRMXhShhT]rþ+h]XV(This field also accepts numeric syntax, but until GHC 8.2 this didn’t do anything.)rÿ+…r,}r,(h=jü+hDNhRNhShh>jú+ubaubhp)r,}r,(h=X^The command line variant of this flag is ``--enable-debug-info`` and ``--disable-debug-info``.h>j©+hDhEhFhthH}r,(hJ]hK]hL]hM]hP]uhRM[hShhT]r,(h]X)The command line variant of this flag is r,…r,}r,(h=X)The command line variant of this flag is hDNhRNhShh>j,ubh–)r ,}r ,(h=X``--enable-debug-info``hH}r ,(hJ]hK]hL]hM]hP]uh>j,hT]r ,h]X--enable-debug-infor ,…r,}r,(h=X--enable-debug-infoh>j ,ubahFhžubh]X and r,…r,}r,(h=X and hDNhRNhShh>j,ubh–)r,}r,(h=X``--disable-debug-info``hH}r,(hJ]hK]hL]hM]hP]uh>j,hT]r,h]X--disable-debug-infor,…r,}r,(h=X--disable-debug-infoh>j,ubahFhžubh]X.…r,}r,(h=X.hDNhRNhShh>j,ubeubeubeubj7)r,}r,(h=Uh>jf hDhEhFj:hH}r,(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r,}r ,(h=Uh>jf hDhEhFj?hH}r!,(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr",jEj",uhRNhShhT]r#,(jG)r$,}r%,(h=Xsplit-sections: booleanh>j,hDhEhFjJhH}r&,(hM]r',Xcfg-field-split-sectionsr(,ahL]hJ]hK]hP]jN‰uhRNhShhT]r),(j7)r*,}r+,(h=Uh>j$,hDhEhFj:hH}r,,(hM]hL]hJ]hK]hP]Uentries]r-,(jTX%split-sections ; cabal project optionj(,UNtr.,auhRNhShhT]ubjV)r/,}r0,(h=Xsplit-sectionsr1,h>j$,hDhEhFjZhH}r2,(jjhM]hL]hJ]hK]hP]uhRNhShhT]r3,h]Xsplit-sectionsr4,…r5,}r6,(h=UhDNhRNhShh>j/,ubaubj`)r7,}r8,(h=jch>j$,hDhEhFjdhH}r9,(jjhM]hL]hJ]hK]hP]uhRNhShhT]r:,h]X: r;,…r<,}r=,(h=UhDNhRNhShh>j7,ubaubjj)r>,}r?,(h=Xbooleanh>j$,hDhEhFjmhH}r@,(jjhM]hL]hJ]hK]hP]uhRNhShhT]rA,h]XbooleanrB,…rC,}rD,(h=UhDNhRNhShh>j>,ubaubeubjG)rE,}rF,(h=X--enable-split-sectionsrG,h>j,hDhEhFjJhH}rH,(hM]rI,X cfg-flag---enable-split-sectionsrJ,ahL]hJ]hK]hP]jN‰uhRNhShhT]rK,(j7)rL,}rM,(h=Uh>jE,hDhEhFj:hH}rN,(hM]hL]hJ]hK]hP]Uentries]rO,(jTX---enable-split-sections; cabal project optionjJ,UNtrP,auhRNhShhT]ubjV)rQ,}rR,(h=jG,h>jE,hDhEhFjZhH}rS,(jjhM]hL]hJ]hK]hP]uhRNhShhT]rT,h]X--enable-split-sectionsrU,…rV,}rW,(h=UhDNhRNhShh>jQ,ubaubj`)rX,}rY,(h=U h>jE,hDhEhFjdhH}rZ,(jjhM]hL]hJ]hK]hP]uhRNhShhT]r[,h]X …r\,}r],(h=UhDNhRNhShh>jX,ubaubeubjG)r^,}r_,(h=X--disable-split-sectionsr`,h>j,hDhEhFjJhH}ra,(hM]rb,X!cfg-flag---disable-split-sectionsrc,ahL]hJ]hK]hP]jN‰uhRNhShhT]rd,(j7)re,}rf,(h=Uh>j^,hDhEhFj:hH}rg,(hM]hL]hJ]hK]hP]Uentries]rh,(jTX.--disable-split-sections; cabal project optionjc,UNtri,auhRNhShhT]ubjV)rj,}rk,(h=j`,h>j^,hDhEhFjZhH}rl,(jjhM]hL]hJ]hK]hP]uhRNhShhT]rm,h]X--disable-split-sectionsrn,…ro,}rp,(h=UhDNhRNhShh>jj,ubaubj`)rq,}rr,(h=U h>j^,hDhEhFjdhH}rs,(jjhM]hL]hJ]hK]hP]uhRNhShhT]rt,h]X …ru,}rv,(h=UhDNhRNhShh>jq,ubaubeubjs)rw,}rx,(h=Uh>j,hDhEhFjvhH}ry,(hJ]hK]hL]hM]hP]uhRNhShhT]rz,(jy)r{,}r|,(h=Uh>jw,hDhEhFj|hH}r},(hJ]hK]hL]hM]hP]uhRNhShhT]r~,(j)r,}r€,(h=Uh>j{,hDhEhFjžhH}r,(hJ]hK]hL]hM]hP]uhRNhShhT]r‚,(j„)rƒ,}r„,(h=j2h>j,hDhEhFj‡hH}r…,(hJ]hK]hL]hM]hP]uhRKhT]r†,h]XSincer‡,…rˆ,}r‰,(h=Uh>jƒ,ubaubj)rŠ,}r‹,(h=U Cabal 2.2rŒ,hH}r,(hJ]hK]hL]hM]hP]uh>j,hT]rŽ,hp)r,}r,(h=jŒ,hH}r‘,(hJ]hK]hL]hM]hP]uh>jŠ,hT]r’,h]X Cabal 2.2r“,…r”,}r•,(h=Uh>j,ubahFhtubahFjubeubj)r–,}r—,(h=UhH}r˜,(hJ]hK]hL]hM]hP]uh>j{,hT]r™,(j„)rš,}r›,(h=X Default valueh>j–,hDhEhFj‡hH}rœ,(hJ]hK]hL]hM]hP]uhRKhT]r,h]X Default valuerž,…rŸ,}r ,(h=Uh>jš,ubaubj)r¡,}r¢,(h=UhH}r£,(hJ]hK]hL]hM]hP]uh>j–,hT]r¤,hp)r¥,}r¦,(h=XFalsehH}r§,(hJ]hK]hL]hM]hP]uh>j¡,hT]r¨,h]XFalser©,…rª,}r«,(h=XFalsehDNhRNhShh>j¥,ubahFhtubahFjubehFjžubeubhp)r¬,}r­,(h=X3Use the GHC ``-split-sections`` feature when building the library. This reduces the final size of the executables that use the library by allowing them to link with only the bits that they use rather than the entire library. The downside is that building the library takes longer and uses a bit more memory.h>jw,hDhEhFhthH}r®,(hJ]hK]hL]hM]hP]uhRMfhShhT]r¯,(h]X Use the GHC r°,…r±,}r²,(h=X Use the GHC hDNhRNhShh>j¬,ubh–)r³,}r´,(h=X``-split-sections``hH}rµ,(hJ]hK]hL]hM]hP]uh>j¬,hT]r¶,h]X-split-sectionsr·,…r¸,}r¹,(h=X-split-sectionsh>j³,ubahFhžubh]X feature when building the library. This reduces the final size of the executables that use the library by allowing them to link with only the bits that they use rather than the entire library. The downside is that building the library takes longer and uses a bit more memory.rº,…r»,}r¼,(h=X feature when building the library. This reduces the final size of the executables that use the library by allowing them to link with only the bits that they use rather than the entire library. The downside is that building the library takes longer and uses a bit more memory.hDNhRNhShh>j¬,ubeubhp)r½,}r¾,(h=X/This feature is supported by GHC 8.0 and later.r¿,h>jw,hDhEhFhthH}rÀ,(hJ]hK]hL]hM]hP]uhRMlhShhT]rÁ,h]X/This feature is supported by GHC 8.0 and later.rÂ,…rÃ,}rÄ,(h=j¿,hDNhRNhShh>j½,ubaubhp)rÅ,}rÆ,(h=XfThe command line variant of this flag is ``--enable-split-sections`` and ``--disable-split-sections``.h>jw,hDhEhFhthH}rÇ,(hJ]hK]hL]hM]hP]uhRMnhShhT]rÈ,(h]X)The command line variant of this flag is rÉ,…rÊ,}rË,(h=X)The command line variant of this flag is hDNhRNhShh>jÅ,ubh–)rÌ,}rÍ,(h=X``--enable-split-sections``hH}rÎ,(hJ]hK]hL]hM]hP]uh>jÅ,hT]rÏ,h]X--enable-split-sectionsrÐ,…rÑ,}rÒ,(h=X--enable-split-sectionsh>jÌ,ubahFhžubh]X and rÓ,…rÔ,}rÕ,(h=X and hDNhRNhShh>jÅ,ubh–)rÖ,}r×,(h=X``--disable-split-sections``hH}rØ,(hJ]hK]hL]hM]hP]uh>jÅ,hT]rÙ,h]X--disable-split-sectionsrÚ,…rÛ,}rÜ,(h=X--disable-split-sectionsh>jÖ,ubahFhžubh]X.…rÝ,}rÞ,(h=X.hDNhRNhShh>jÅ,ubeubeubeubj7)rß,}rà,(h=Uh>jf hDhEhFj:hH}rá,(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)râ,}rã,(h=Uh>jf hDhEhFj?hH}rä,(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrå,jEjå,uhRNhShhT]ræ,(jG)rç,}rè,(h=Xsplit-objs: booleanh>jâ,hDhEhFjJhH}ré,(hM]rê,Xcfg-field-split-objsrë,ahL]hJ]hK]hP]jN‰uhRNhShhT]rì,(j7)rí,}rî,(h=Uh>jç,hDhEhFj:hH}rï,(hM]hL]hJ]hK]hP]Uentries]rð,(jTX!split-objs ; cabal project optionjë,UNtrñ,auhRNhShhT]ubjV)rò,}ró,(h=X split-objsrô,h>jç,hDhEhFjZhH}rõ,(jjhM]hL]hJ]hK]hP]uhRNhShhT]rö,h]X split-objsr÷,…rø,}rù,(h=UhDNhRNhShh>jò,ubaubj`)rú,}rû,(h=jch>jç,hDhEhFjdhH}rü,(jjhM]hL]hJ]hK]hP]uhRNhShhT]rý,h]X: rþ,…rÿ,}r-(h=UhDNhRNhShh>jú,ubaubjj)r-}r-(h=Xbooleanh>jç,hDhEhFjmhH}r-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-h]Xbooleanr-…r-}r-(h=UhDNhRNhShh>j-ubaubeubjG)r-}r -(h=X--enable-split-objsr -h>jâ,hDhEhFjJhH}r -(hM]r -Xcfg-flag---enable-split-objsr -ahL]hJ]hK]hP]jN‰uhRNhShhT]r-(j7)r-}r-(h=Uh>j-hDhEhFj:hH}r-(hM]hL]hJ]hK]hP]Uentries]r-(jTX)--enable-split-objs; cabal project optionj -UNtr-auhRNhShhT]ubjV)r-}r-(h=j -h>j-hDhEhFjZhH}r-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-h]X--enable-split-objsr-…r-}r-(h=UhDNhRNhShh>j-ubaubj`)r-}r-(h=U h>j-hDhEhFjdhH}r-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-h]X …r-}r -(h=UhDNhRNhShh>j-ubaubeubjG)r!-}r"-(h=X--disable-split-objsr#-h>jâ,hDhEhFjJhH}r$-(hM]r%-Xcfg-flag---disable-split-objsr&-ahL]hJ]hK]hP]jN‰uhRNhShhT]r'-(j7)r(-}r)-(h=Uh>j!-hDhEhFj:hH}r*-(hM]hL]hJ]hK]hP]Uentries]r+-(jTX*--disable-split-objs; cabal project optionj&-UNtr,-auhRNhShhT]ubjV)r--}r.-(h=j#-h>j!-hDhEhFjZhH}r/-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r0-h]X--disable-split-objsr1-…r2-}r3-(h=UhDNhRNhShh>j--ubaubj`)r4-}r5-(h=U h>j!-hDhEhFjdhH}r6-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r7-h]X …r8-}r9-(h=UhDNhRNhShh>j4-ubaubeubjs)r:-}r;-(h=Uh>jâ,hDhEhFjvhH}r<-(hJ]hK]hL]hM]hP]uhRNhShhT]r=-(jy)r>-}r?-(h=Uh>j:-hDhEhFj|hH}r@-(hJ]hK]hL]hM]hP]uhRNhShhT]rA-j)rB-}rC-(h=UhH}rD-(hJ]hK]hL]hM]hP]uh>j>-hT]rE-(j„)rF-}rG-(h=X Default valueh>jB-hDhEhFj‡hH}rH-(hJ]hK]hL]hM]hP]uhRKhT]rI-h]X Default valuerJ-…rK-}rL-(h=Uh>jF-ubaubj)rM-}rN-(h=UhH}rO-(hJ]hK]hL]hM]hP]uh>jB-hT]rP-hp)rQ-}rR-(h=XFalsehH}rS-(hJ]hK]hL]hM]hP]uh>jM-hT]rT-h]XFalserU-…rV-}rW-(h=XFalsehDNhRNhShh>jQ-ubahFhtubahFjubehFjžubaubhp)rX-}rY-(h=X6Use the GHC ``-split-objs`` feature when building the library. This reduces the final size of the executables that use the library by allowing them to link with only the bits that they use rather than the entire library. The downside is that building the library takes longer and uses considerably more memory.h>j:-hDhEhFhthH}rZ-(hJ]hK]hL]hM]hP]uhRMxhShhT]r[-(h]X Use the GHC r\-…r]-}r^-(h=X Use the GHC hDNhRNhShh>jX-ubh–)r_-}r`-(h=X``-split-objs``hH}ra-(hJ]hK]hL]hM]hP]uh>jX-hT]rb-h]X -split-objsrc-…rd-}re-(h=X -split-objsh>j_-ubahFhžubh]X feature when building the library. This reduces the final size of the executables that use the library by allowing them to link with only the bits that they use rather than the entire library. The downside is that building the library takes longer and uses considerably more memory.rf-…rg-}rh-(h=X feature when building the library. This reduces the final size of the executables that use the library by allowing them to link with only the bits that they use rather than the entire library. The downside is that building the library takes longer and uses considerably more memory.hDNhRNhShh>jX-ubeubhp)ri-}rj-(h=XcIt is generally recommend that you use ``split-sections`` instead of ``split-objs`` where possible.h>j:-hDhEhFhthH}rk-(hJ]hK]hL]hM]hP]uhRM~hShhT]rl-(h]X'It is generally recommend that you use rm-…rn-}ro-(h=X'It is generally recommend that you use hDNhRNhShh>ji-ubh–)rp-}rq-(h=X``split-sections``hH}rr-(hJ]hK]hL]hM]hP]uh>ji-hT]rs-h]Xsplit-sectionsrt-…ru-}rv-(h=Xsplit-sectionsh>jp-ubahFhžubh]X instead of rw-…rx-}ry-(h=X instead of hDNhRNhShh>ji-ubh–)rz-}r{-(h=X``split-objs``hH}r|-(hJ]hK]hL]hM]hP]uh>ji-hT]r}-h]X split-objsr~-…r-}r€-(h=X split-objsh>jz-ubahFhžubh]X where possible.r-…r‚-}rƒ-(h=X where possible.hDNhRNhShh>ji-ubeubhp)r„-}r…-(h=X^The command line variant of this flag is ``--enable-split-objs`` and ``--disable-split-objs``.h>j:-hDhEhFhthH}r†-(hJ]hK]hL]hM]hP]uhRMhShhT]r‡-(h]X)The command line variant of this flag is rˆ-…r‰-}rŠ-(h=X)The command line variant of this flag is hDNhRNhShh>j„-ubh–)r‹-}rŒ-(h=X``--enable-split-objs``hH}r-(hJ]hK]hL]hM]hP]uh>j„-hT]rŽ-h]X--enable-split-objsr-…r-}r‘-(h=X--enable-split-objsh>j‹-ubahFhžubh]X and r’-…r“-}r”-(h=X and hDNhRNhShh>j„-ubh–)r•-}r–-(h=X``--disable-split-objs``hH}r—-(hJ]hK]hL]hM]hP]uh>j„-hT]r˜-h]X--disable-split-objsr™-…rš-}r›-(h=X--disable-split-objsh>j•-ubahFhžubh]X.…rœ-}r-(h=X.hDNhRNhShh>j„-ubeubeubeubj7)rž-}rŸ-(h=Uh>jf hDhEhFj:hH}r -(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r¡-}r¢-(h=Uh>jf hDhEhFj?hH}r£-(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr¤-jEj¤-uhRNhShhT]r¥-(jG)r¦-}r§-(h=Xexecutable-stripping: booleanh>j¡-hDhEhFjJhH}r¨-(hM]r©-Xcfg-field-executable-strippingrª-ahL]hJ]hK]hP]jN‰uhRNhShhT]r«-(j7)r¬-}r­-(h=Uh>j¦-hDhEhFj:hH}r®-(hM]hL]hJ]hK]hP]Uentries]r¯-(jTX+executable-stripping ; cabal project optionjª-UNtr°-auhRNhShhT]ubjV)r±-}r²-(h=Xexecutable-strippingr³-h>j¦-hDhEhFjZhH}r´-(jjhM]hL]hJ]hK]hP]uhRNhShhT]rµ-h]Xexecutable-strippingr¶-…r·-}r¸-(h=UhDNhRNhShh>j±-ubaubj`)r¹-}rº-(h=jch>j¦-hDhEhFjdhH}r»-(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¼-h]X: r½-…r¾-}r¿-(h=UhDNhRNhShh>j¹-ubaubjj)rÀ-}rÁ-(h=Xbooleanh>j¦-hDhEhFjmhH}rÂ-(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÃ-h]XbooleanrÄ-…rÅ-}rÆ-(h=UhDNhRNhShh>jÀ-ubaubeubjG)rÇ-}rÈ-(h=X--enable-executable-strippingrÉ-h>j¡-hDhEhFjJhH}rÊ-(hM]rË-X&cfg-flag---enable-executable-strippingrÌ-ahL]hJ]hK]hP]jN‰uhRNhShhT]rÍ-(j7)rÎ-}rÏ-(h=Uh>jÇ-hDhEhFj:hH}rÐ-(hM]hL]hJ]hK]hP]Uentries]rÑ-(jTX3--enable-executable-stripping; cabal project optionjÌ-UNtrÒ-auhRNhShhT]ubjV)rÓ-}rÔ-(h=jÉ-h>jÇ-hDhEhFjZhH}rÕ-(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÖ-h]X--enable-executable-strippingr×-…rØ-}rÙ-(h=UhDNhRNhShh>jÓ-ubaubj`)rÚ-}rÛ-(h=U h>jÇ-hDhEhFjdhH}rÜ-(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÝ-h]X …rÞ-}rß-(h=UhDNhRNhShh>jÚ-ubaubeubjG)rà-}rá-(h=X--disable-executable-strippingrâ-h>j¡-hDhEhFjJhH}rã-(hM]rä-X'cfg-flag---disable-executable-strippingrå-ahL]hJ]hK]hP]jN‰uhRNhShhT]ræ-(j7)rç-}rè-(h=Uh>jà-hDhEhFj:hH}ré-(hM]hL]hJ]hK]hP]Uentries]rê-(jTX4--disable-executable-stripping; cabal project optionjå-UNtrë-auhRNhShhT]ubjV)rì-}rí-(h=jâ-h>jà-hDhEhFjZhH}rî-(jjhM]hL]hJ]hK]hP]uhRNhShhT]rï-h]X--disable-executable-strippingrð-…rñ-}rò-(h=UhDNhRNhShh>jì-ubaubj`)ró-}rô-(h=U h>jà-hDhEhFjdhH}rõ-(jjhM]hL]hJ]hK]hP]uhRNhShhT]rö-h]X …r÷-}rø-(h=UhDNhRNhShh>jó-ubaubeubjs)rù-}rú-(h=Uh>j¡-hDhEhFjvhH}rû-(hJ]hK]hL]hM]hP]uhRNhShhT]rü-(jy)rý-}rþ-(h=Uh>jù-hDhEhFj|hH}rÿ-(hJ]hK]hL]hM]hP]uhRNhShhT]r.j)r.}r.(h=UhH}r.(hJ]hK]hL]hM]hP]uh>jý-hT]r.(j„)r.}r.(h=X Default valueh>j.hDhEhFj‡hH}r.(hJ]hK]hL]hM]hP]uhRKhT]r.h]X Default valuer .…r .}r .(h=Uh>j.ubaubj)r .}r .(h=UhH}r.(hJ]hK]hL]hM]hP]uh>j.hT]r.hp)r.}r.(h=XTruehH}r.(hJ]hK]hL]hM]hP]uh>j .hT]r.h]XTruer.…r.}r.(h=XTruehDNhRNhShh>j.ubahFhtubahFjubehFjžubaubhp)r.}r.(h=XÕWhen installing binary executable programs, run the ``strip`` program on the binary. This can considerably reduce the size of the executable binary file. It does this by removing debugging information and symbols.h>jù-hDhEhFhthH}r.(hJ]hK]hL]hM]hP]uhRM‹hShhT]r.(h]X4When installing binary executable programs, run the r.…r.}r.(h=X4When installing binary executable programs, run the hDNhRNhShh>j.ubh–)r.}r.(h=X ``strip``hH}r .(hJ]hK]hL]hM]hP]uh>j.hT]r!.h]Xstripr".…r#.}r$.(h=Xstriph>j.ubahFhžubh]X˜ program on the binary. This can considerably reduce the size of the executable binary file. It does this by removing debugging information and symbols.r%.…r&.}r'.(h=X˜ program on the binary. This can considerably reduce the size of the executable binary file. It does this by removing debugging information and symbols.hDNhRNhShh>j.ubeubhp)r(.}r).(h=XmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.r*.h>jù-hDhEhFhthH}r+.(hJ]hK]hL]hM]hP]uhRMhShhT]r,.h]XmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.r-.…r..}r/.(h=j*.hDNhRNhShh>j(.ubaubhp)r0.}r1.(h=XŠIf ``debug-info`` is set explicitly then ``executable-stripping`` is set to ``False`` as otherwise all the debug symbols will be stripped.h>jù-hDhEhFhthH}r2.(hJ]hK]hL]hM]hP]uhRM“hShhT]r3.(h]XIf r4.…r5.}r6.(h=XIf hDNhRNhShh>j0.ubh–)r7.}r8.(h=X``debug-info``hH}r9.(hJ]hK]hL]hM]hP]uh>j0.hT]r:.h]X debug-infor;.…r<.}r=.(h=X debug-infoh>j7.ubahFhžubh]X is set explicitly then r>.…r?.}r@.(h=X is set explicitly then hDNhRNhShh>j0.ubh–)rA.}rB.(h=X``executable-stripping``hH}rC.(hJ]hK]hL]hM]hP]uh>j0.hT]rD.h]Xexecutable-strippingrE.…rF.}rG.(h=Xexecutable-strippingh>jA.ubahFhžubh]X is set to rH.…rI.}rJ.(h=X is set to hDNhRNhShh>j0.ubh–)rK.}rL.(h=X ``False``hH}rM.(hJ]hK]hL]hM]hP]uh>j0.hT]rN.h]XFalserO.…rP.}rQ.(h=XFalseh>jK.ubahFhžubh]X5 as otherwise all the debug symbols will be stripped.rR.…rS.}rT.(h=X5 as otherwise all the debug symbols will be stripped.hDNhRNhShh>j0.ubeubhp)rU.}rV.(h=XrThe command line variant of this flag is ``--enable-executable-stripping`` and ``--disable-executable-stripping``.h>jù-hDhEhFhthH}rW.(hJ]hK]hL]hM]hP]uhRM–hShhT]rX.(h]X)The command line variant of this flag is rY.…rZ.}r[.(h=X)The command line variant of this flag is hDNhRNhShh>jU.ubh–)r\.}r].(h=X!``--enable-executable-stripping``hH}r^.(hJ]hK]hL]hM]hP]uh>jU.hT]r_.h]X--enable-executable-strippingr`.…ra.}rb.(h=X--enable-executable-strippingh>j\.ubahFhžubh]X and rc.…rd.}re.(h=X and hDNhRNhShh>jU.ubh–)rf.}rg.(h=X"``--disable-executable-stripping``hH}rh.(hJ]hK]hL]hM]hP]uh>jU.hT]ri.h]X--disable-executable-strippingrj.…rk.}rl.(h=X--disable-executable-strippingh>jf.ubahFhžubh]X.…rm.}rn.(h=X.hDNhRNhShh>jU.ubeubeubeubj7)ro.}rp.(h=Uh>jf hDhEhFj:hH}rq.(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rr.}rs.(h=Uh>jf hDhEhFj?hH}rt.(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldru.jEju.uhRNhShhT]rv.(jG)rw.}rx.(h=Xlibrary-stripping: booleanh>jr.hDhEhFjJhH}ry.(hM]rz.Xcfg-field-library-strippingr{.ahL]hJ]hK]hP]jN‰uhRNhShhT]r|.(j7)r}.}r~.(h=Uh>jw.hDhEhFj:hH}r.(hM]hL]hJ]hK]hP]Uentries]r€.(jTX(library-stripping ; cabal project optionj{.UNtr.auhRNhShhT]ubjV)r‚.}rƒ.(h=Xlibrary-strippingr„.h>jw.hDhEhFjZhH}r….(jjhM]hL]hJ]hK]hP]uhRNhShhT]r†.h]Xlibrary-strippingr‡.…rˆ.}r‰.(h=UhDNhRNhShh>j‚.ubaubj`)rŠ.}r‹.(h=jch>jw.hDhEhFjdhH}rŒ.(jjhM]hL]hJ]hK]hP]uhRNhShhT]r.h]X: rŽ.…r.}r.(h=UhDNhRNhShh>jŠ.ubaubjj)r‘.}r’.(h=Xbooleanh>jw.hDhEhFjmhH}r“.(jjhM]hL]hJ]hK]hP]uhRNhShhT]r”.h]Xbooleanr•.…r–.}r—.(h=UhDNhRNhShh>j‘.ubaubeubjG)r˜.}r™.(h=X--enable-library-strippingrš.h>jr.hDhEhFjJhH}r›.(hM]rœ.X#cfg-flag---enable-library-strippingr.ahL]hJ]hK]hP]jN‰uhRNhShhT]rž.(j7)rŸ.}r .(h=Uh>j˜.hDhEhFj:hH}r¡.(hM]hL]hJ]hK]hP]Uentries]r¢.(jTX0--enable-library-stripping; cabal project optionj.UNtr£.auhRNhShhT]ubjV)r¤.}r¥.(h=jš.h>j˜.hDhEhFjZhH}r¦.(jjhM]hL]hJ]hK]hP]uhRNhShhT]r§.h]X--enable-library-strippingr¨.…r©.}rª.(h=UhDNhRNhShh>j¤.ubaubj`)r«.}r¬.(h=U h>j˜.hDhEhFjdhH}r­.(jjhM]hL]hJ]hK]hP]uhRNhShhT]r®.h]X …r¯.}r°.(h=UhDNhRNhShh>j«.ubaubeubjG)r±.}r².(h=X--disable-library-strippingr³.h>jr.hDhEhFjJhH}r´.(hM]rµ.X$cfg-flag---disable-library-strippingr¶.ahL]hJ]hK]hP]jN‰uhRNhShhT]r·.(j7)r¸.}r¹.(h=Uh>j±.hDhEhFj:hH}rº.(hM]hL]hJ]hK]hP]Uentries]r».(jTX1--disable-library-stripping; cabal project optionj¶.UNtr¼.auhRNhShhT]ubjV)r½.}r¾.(h=j³.h>j±.hDhEhFjZhH}r¿.(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÀ.h]X--disable-library-strippingrÁ.…rÂ.}rÃ.(h=UhDNhRNhShh>j½.ubaubj`)rÄ.}rÅ.(h=U h>j±.hDhEhFjdhH}rÆ.(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÇ.h]X …rÈ.}rÉ.(h=UhDNhRNhShh>jÄ.ubaubeubjs)rÊ.}rË.(h=Uh>jr.hDhEhFjvhH}rÌ.(hJ]hK]hL]hM]hP]uhRNhShhT]rÍ.(jy)rÎ.}rÏ.(h=Uh>jÊ.hDhEhFj|hH}rÐ.(hJ]hK]hL]hM]hP]uhRNhShhT]rÑ.j)rÒ.}rÓ.(h=Uh>jÎ.hDhEhFjžhH}rÔ.(hJ]hK]hL]hM]hP]uhRNhShhT]rÕ.(j„)rÖ.}r×.(h=j2h>jÒ.hDhEhFj‡hH}rØ.(hJ]hK]hL]hM]hP]uhRKhT]rÙ.h]XSincerÚ.…rÛ.}rÜ.(h=Uh>jÖ.ubaubj)rÝ.}rÞ.(h=U Cabal 1.20rß.hH}rà.(hJ]hK]hL]hM]hP]uh>jÒ.hT]rá.hp)râ.}rã.(h=jß.hH}rä.(hJ]hK]hL]hM]hP]uh>jÝ.hT]rå.h]X Cabal 1.20ræ.…rç.}rè.(h=Uh>jâ.ubahFhtubahFjubeubaubhp)ré.}rê.(h=XŽWhen installing binary libraries, run the ``strip`` program on the binary, saving space on the file system. See also ``executable-stripping``.h>jÊ.hDhEhFhthH}rë.(hJ]hK]hL]hM]hP]uhRM hShhT]rì.(h]X*When installing binary libraries, run the rí.…rî.}rï.(h=X*When installing binary libraries, run the hDNhRNhShh>jé.ubh–)rð.}rñ.(h=X ``strip``hH}rò.(hJ]hK]hL]hM]hP]uh>jé.hT]ró.h]Xstriprô.…rõ.}rö.(h=Xstriph>jð.ubahFhžubh]XB program on the binary, saving space on the file system. See also r÷.…rø.}rù.(h=XB program on the binary, saving space on the file system. See also hDNhRNhShh>jé.ubh–)rú.}rû.(h=X``executable-stripping``hH}rü.(hJ]hK]hL]hM]hP]uh>jé.hT]rý.h]Xexecutable-strippingrþ.…rÿ.}r/(h=Xexecutable-strippingh>jú.ubahFhžubh]X.…r/}r/(h=X.hDNhRNhShh>jé.ubeubhp)r/}r/(h=X‡If ``debug-info`` is set explicitly then ``library-stripping`` is set to ``False`` as otherwise all the debug symbols will be stripped.h>jÊ.hDhEhFhthH}r/(hJ]hK]hL]hM]hP]uhRM¤hShhT]r/(h]XIf r/…r/}r /(h=XIf hDNhRNhShh>j/ubh–)r /}r /(h=X``debug-info``hH}r /(hJ]hK]hL]hM]hP]uh>j/hT]r /h]X debug-infor/…r/}r/(h=X debug-infoh>j /ubahFhžubh]X is set explicitly then r/…r/}r/(h=X is set explicitly then hDNhRNhShh>j/ubh–)r/}r/(h=X``library-stripping``hH}r/(hJ]hK]hL]hM]hP]uh>j/hT]r/h]Xlibrary-strippingr/…r/}r/(h=Xlibrary-strippingh>j/ubahFhžubh]X is set to r/…r/}r/(h=X is set to hDNhRNhShh>j/ubh–)r/}r/(h=X ``False``hH}r /(hJ]hK]hL]hM]hP]uh>j/hT]r!/h]XFalser"/…r#/}r$/(h=XFalseh>j/ubahFhžubh]X5 as otherwise all the debug symbols will be stripped.r%/…r&/}r'/(h=X5 as otherwise all the debug symbols will be stripped.hDNhRNhShh>j/ubeubhp)r(/}r)/(h=XlThe command line variant of this flag is ``--enable-library-stripping`` and ``--disable-library-stripping``.h>jÊ.hDhEhFhthH}r*/(hJ]hK]hL]hM]hP]uhRM§hShhT]r+/(h]X)The command line variant of this flag is r,/…r-/}r./(h=X)The command line variant of this flag is hDNhRNhShh>j(/ubh–)r//}r0/(h=X``--enable-library-stripping``hH}r1/(hJ]hK]hL]hM]hP]uh>j(/hT]r2/h]X--enable-library-strippingr3/…r4/}r5/(h=X--enable-library-strippingh>j//ubahFhžubh]X and r6/…r7/}r8/(h=X and hDNhRNhShh>j(/ubh–)r9/}r:/(h=X``--disable-library-stripping``hH}r;/(hJ]hK]hL]hM]hP]uh>j(/hT]r/}r?/(h=X--disable-library-strippingh>j9/ubahFhžubh]X.…r@/}rA/(h=X.hDNhRNhShh>j(/ubeubeubeubj7)rB/}rC/(h=Uh>jf hDhEhFj:hH}rD/(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rE/}rF/(h=Uh>jf hDhEhFj?hH}rG/(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrH/jEjH/uhRNhShhT]rI/(jG)rJ/}rK/(h=Xprogram-prefix: prefixh>jE/hDhEhFjJhH}rL/(hM]rM/Xcfg-field-program-prefixrN/ahL]hJ]hK]hP]jN‰uhRNhShhT]rO/(j7)rP/}rQ/(h=Uh>jJ/hDhEhFj:hH}rR/(hM]hL]hJ]hK]hP]Uentries]rS/(jTX%program-prefix ; cabal project optionjN/UNtrT/auhRNhShhT]ubjV)rU/}rV/(h=Xprogram-prefixrW/h>jJ/hDhEhFjZhH}rX/(jjhM]hL]hJ]hK]hP]uhRNhShhT]rY/h]Xprogram-prefixrZ/…r[/}r\/(h=UhDNhRNhShh>jU/ubaubj`)r]/}r^/(h=jch>jJ/hDhEhFjdhH}r_/(jjhM]hL]hJ]hK]hP]uhRNhShhT]r`/h]X: ra/…rb/}rc/(h=UhDNhRNhShh>j]/ubaubjj)rd/}re/(h=Xprefixh>jJ/hDhEhFjmhH}rf/(jjhM]hL]hJ]hK]hP]uhRNhShhT]rg/h]Xprefixrh/…ri/}rj/(h=UhDNhRNhShh>jd/ubaubeubjG)rk/}rl/(h=X--program-prefix=prefixh>jE/hDhEhFjJhH}rm/(hM]rn/Xcfg-flag---program-prefixro/ahL]hJ]hK]hP]jN‰uhRNhShhT]rp/(j7)rq/}rr/(h=Uh>jk/hDhEhFj:hH}rs/(hM]hL]hJ]hK]hP]Uentries]rt/(jTX&--program-prefix; cabal project optionjo/UNtru/auhRNhShhT]ubjV)rv/}rw/(h=X--program-prefixrx/h>jk/hDhEhFjZhH}ry/(jjhM]hL]hJ]hK]hP]uhRNhShhT]rz/h]X--program-prefixr{/…r|/}r}/(h=UhDNhRNhShh>jv/ubaubj`)r~/}r/(h=X=prefixh>jk/hDhEhFjdhH}r€/(jjhM]hL]hJ]hK]hP]uhRNhShhT]r/h]X=prefixr‚/…rƒ/}r„/(h=UhDNhRNhShh>j~/ubaubeubjs)r…/}r†/(h=Uh>jE/hDhEhFjvhH}r‡/(hJ]hK]hL]hM]hP]uhRNhShhT]rˆ/(hp)r‰/}rŠ/(h=X™[STRIKEOUT:Prepend *prefix* to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)h>j…/hDhEhFhthH}r‹/(hJ]hK]hL]hM]hP]uhRM±hShhT]rŒ/(h]X[STRIKEOUT:Prepend r/…rŽ/}r/(h=X[STRIKEOUT:Prepend hDNhRNhShh>j‰/ubj))r/}r‘/(h=X*prefix*hH}r’/(hJ]hK]hL]hM]hP]uh>j‰/hT]r“/h]Xprefixr”/…r•/}r–/(h=Xprefixh>j/ubahFj1ubh]X~ to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)r—/…r˜/}r™/(h=X~ to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)hDNhRNhShh>j‰/ubeubhp)rš/}r›/(h=X*prefix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``h>j…/hDhEhFhthH}rœ/(hJ]hK]hL]hM]hP]uhRMµhShhT]r/(j))rž/}rŸ/(h=X*prefix*hH}r /(hJ]hK]hL]hM]hP]uh>jš/hT]r¡/h]Xprefixr¢/…r£/}r¤/(h=Xprefixh>jž/ubahFj1ubh]X+ may contain the following path variables: r¥/…r¦/}r§/(h=X+ may contain the following path variables: hDNhRNhShh>jš/ubh–)r¨/}r©/(h=X ``$pkgid``hH}rª/(hJ]hK]hL]hM]hP]uh>jš/hT]r«/h]X$pkgidr¬/…r­/}r®/(h=X$pkgidh>j¨/ubahFhžubh]X, r¯/…r°/}r±/(h=X, r²/hDNhRNhShh>jš/ubh–)r³/}r´/(h=X``$pkg``hH}rµ/(hJ]hK]hL]hM]hP]uh>jš/hT]r¶/h]X$pkgr·/…r¸/}r¹/(h=X$pkgh>j³/ubahFhžubh]X, rº/…r»/}r¼/(h=X, r½/hDNhRNhShh>jš/ubh–)r¾/}r¿/(h=X ``$version``hH}rÀ/(hJ]hK]hL]hM]hP]uh>jš/hT]rÁ/h]X$versionrÂ/…rÃ/}rÄ/(h=X$versionh>j¾/ubahFhžubh]X, rÅ/…rÆ/}rÇ/(h=X, h>jš/ubh–)rÈ/}rÉ/(h=X ``$compiler``hH}rÊ/(hJ]hK]hL]hM]hP]uh>jš/hT]rË/h]X $compilerrÌ/…rÍ/}rÎ/(h=X $compilerh>jÈ/ubahFhžubh]X, rÏ/…rÐ/}rÑ/(h=X, h>jš/ubh–)rÒ/}rÓ/(h=X``$os``hH}rÔ/(hJ]hK]hL]hM]hP]uh>jš/hT]rÕ/h]X$osrÖ/…r×/}rØ/(h=X$osh>jÒ/ubahFhžubh]X, rÙ/…rÚ/}rÛ/(h=X, h>jš/ubh–)rÜ/}rÝ/(h=X ``$arch``hH}rÞ/(hJ]hK]hL]hM]hP]uh>jš/hT]rß/h]X$archrà/…rá/}râ/(h=X$archh>jÜ/ubahFhžubh]X, rã/…rä/}rå/(h=j½/h>jš/ubh–)ræ/}rç/(h=X``$abi``hH}rè/(hJ]hK]hL]hM]hP]uh>jš/hT]ré/h]X$abirê/…rë/}rì/(h=X$abih>jæ/ubahFhžubh]X, rí/…rî/}rï/(h=j²/h>jš/ubh–)rð/}rñ/(h=X ``$abitag``hH}rò/(hJ]hK]hL]hM]hP]uh>jš/hT]ró/h]X$abitagrô/…rõ/}rö/(h=X$abitagh>jð/ubahFhžubeubhp)r÷/}rø/(h=XCThe command line variant of this flag is ``--program-prefix=foo-``.h>j…/hDhEhFhthH}rù/(hJ]hK]hL]hM]hP]uhRM¹hShhT]rú/(h]X)The command line variant of this flag is rû/…rü/}rý/(h=X)The command line variant of this flag is hDNhRNhShh>j÷/ubh–)rþ/}rÿ/(h=X``--program-prefix=foo-``hH}r0(hJ]hK]hL]hM]hP]uh>j÷/hT]r0h]X--program-prefix=foo-r0…r0}r0(h=X--program-prefix=foo-h>jþ/ubahFhžubh]X.…r0}r0(h=X.hDNhRNhShh>j÷/ubeubeubeubj7)r0}r0(h=Uh>jf hDhEhFj:hH}r 0(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r 0}r 0(h=Uh>jf hDhEhFj?hH}r 0(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr 0jEj 0uhRNhShhT]r0(jG)r0}r0(h=Xprogram-suffix: suffixh>j 0hDhEhFjJhH}r0(hM]r0Xcfg-field-program-suffixr0ahL]hJ]hK]hP]jN‰uhRNhShhT]r0(j7)r0}r0(h=Uh>j0hDhEhFj:hH}r0(hM]hL]hJ]hK]hP]Uentries]r0(jTX%program-suffix ; cabal project optionj0UNtr0auhRNhShhT]ubjV)r0}r0(h=Xprogram-suffixr0h>j0hDhEhFjZhH}r0(jjhM]hL]hJ]hK]hP]uhRNhShhT]r0h]Xprogram-suffixr0…r 0}r!0(h=UhDNhRNhShh>j0ubaubj`)r"0}r#0(h=jch>j0hDhEhFjdhH}r$0(jjhM]hL]hJ]hK]hP]uhRNhShhT]r%0h]X: r&0…r'0}r(0(h=UhDNhRNhShh>j"0ubaubjj)r)0}r*0(h=Xsuffixh>j0hDhEhFjmhH}r+0(jjhM]hL]hJ]hK]hP]uhRNhShhT]r,0h]Xsuffixr-0…r.0}r/0(h=UhDNhRNhShh>j)0ubaubeubjG)r00}r10(h=X--program-suffix=suffixh>j 0hDhEhFjJhH}r20(hM]r30Xcfg-flag---program-suffixr40ahL]hJ]hK]hP]jN‰uhRNhShhT]r50(j7)r60}r70(h=Uh>j00hDhEhFj:hH}r80(hM]hL]hJ]hK]hP]Uentries]r90(jTX&--program-suffix; cabal project optionj40UNtr:0auhRNhShhT]ubjV)r;0}r<0(h=X--program-suffixr=0h>j00hDhEhFjZhH}r>0(jjhM]hL]hJ]hK]hP]uhRNhShhT]r?0h]X--program-suffixr@0…rA0}rB0(h=UhDNhRNhShh>j;0ubaubj`)rC0}rD0(h=X=suffixh>j00hDhEhFjdhH}rE0(jjhM]hL]hJ]hK]hP]uhRNhShhT]rF0h]X=suffixrG0…rH0}rI0(h=UhDNhRNhShh>jC0ubaubeubjs)rJ0}rK0(h=Uh>j 0hDhEhFjvhH}rL0(hJ]hK]hL]hM]hP]uhRNhShhT]rM0(hp)rN0}rO0(h=X˜[STRIKEOUT:Append *suffix* to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)h>jJ0hDhEhFhthH}rP0(hJ]hK]hL]hM]hP]uhRM¿hShhT]rQ0(h]X[STRIKEOUT:Append rR0…rS0}rT0(h=X[STRIKEOUT:Append hDNhRNhShh>jN0ubj))rU0}rV0(h=X*suffix*hH}rW0(hJ]hK]hL]hM]hP]uh>jN0hT]rX0h]XsuffixrY0…rZ0}r[0(h=Xsuffixh>jU0ubahFj1ubh]X~ to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)r\0…r]0}r^0(h=X~ to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)hDNhRNhShh>jN0ubeubhp)r_0}r`0(h=X«The most obvious use for this is to append the program's version number to make it possible to install several versions of a program at once: ``program-suffix: $version``.h>jJ0hDhEhFhthH}ra0(hJ]hK]hL]hM]hP]uhRMÃhShhT]rb0(h]XThe most obvious use for this is to append the program’s version number to make it possible to install several versions of a program at once: rc0…rd0}re0(h=XŽThe most obvious use for this is to append the program's version number to make it possible to install several versions of a program at once: hDNhRNhShh>j_0ubh–)rf0}rg0(h=X``program-suffix: $version``hH}rh0(hJ]hK]hL]hM]hP]uh>j_0hT]ri0h]Xprogram-suffix: $versionrj0…rk0}rl0(h=Xprogram-suffix: $versionh>jf0ubahFhžubh]X.…rm0}rn0(h=X.hDNhRNhShh>j_0ubeubhp)ro0}rp0(h=X*suffix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``h>jJ0hDhEhFhthH}rq0(hJ]hK]hL]hM]hP]uhRMÇhShhT]rr0(j))rs0}rt0(h=X*suffix*hH}ru0(hJ]hK]hL]hM]hP]uh>jo0hT]rv0h]Xsuffixrw0…rx0}ry0(h=Xsuffixh>js0ubahFj1ubh]X+ may contain the following path variables: rz0…r{0}r|0(h=X+ may contain the following path variables: hDNhRNhShh>jo0ubh–)r}0}r~0(h=X ``$pkgid``hH}r0(hJ]hK]hL]hM]hP]uh>jo0hT]r€0h]X$pkgidr0…r‚0}rƒ0(h=X$pkgidh>j}0ubahFhžubh]X, r„0…r…0}r†0(h=X, r‡0hDNhRNhShh>jo0ubh–)rˆ0}r‰0(h=X``$pkg``hH}rŠ0(hJ]hK]hL]hM]hP]uh>jo0hT]r‹0h]X$pkgrŒ0…r0}rŽ0(h=X$pkgh>jˆ0ubahFhžubh]X, r0…r0}r‘0(h=X, r’0hDNhRNhShh>jo0ubh–)r“0}r”0(h=X ``$version``hH}r•0(hJ]hK]hL]hM]hP]uh>jo0hT]r–0h]X$versionr—0…r˜0}r™0(h=X$versionh>j“0ubahFhžubh]X, rš0…r›0}rœ0(h=X, h>jo0ubh–)r0}rž0(h=X ``$compiler``hH}rŸ0(hJ]hK]hL]hM]hP]uh>jo0hT]r 0h]X $compilerr¡0…r¢0}r£0(h=X $compilerh>j0ubahFhžubh]X, r¤0…r¥0}r¦0(h=X, h>jo0ubh–)r§0}r¨0(h=X``$os``hH}r©0(hJ]hK]hL]hM]hP]uh>jo0hT]rª0h]X$osr«0…r¬0}r­0(h=X$osh>j§0ubahFhžubh]X, r®0…r¯0}r°0(h=X, h>jo0ubh–)r±0}r²0(h=X ``$arch``hH}r³0(hJ]hK]hL]hM]hP]uh>jo0hT]r´0h]X$archrµ0…r¶0}r·0(h=X$archh>j±0ubahFhžubh]X, r¸0…r¹0}rº0(h=j’0h>jo0ubh–)r»0}r¼0(h=X``$abi``hH}r½0(hJ]hK]hL]hM]hP]uh>jo0hT]r¾0h]X$abir¿0…rÀ0}rÁ0(h=X$abih>j»0ubahFhžubh]X, rÂ0…rÃ0}rÄ0(h=j‡0h>jo0ubh–)rÅ0}rÆ0(h=X ``$abitag``hH}rÇ0(hJ]hK]hL]hM]hP]uh>jo0hT]rÈ0h]X$abitagrÉ0…rÊ0}rË0(h=X$abitagh>jÅ0ubahFhžubeubhp)rÌ0}rÍ0(h=XIThe command line variant of this flag is ``--program-suffix='$version'``.h>jJ0hDhEhFhthH}rÎ0(hJ]hK]hL]hM]hP]uhRMËhShhT]rÏ0(h]X)The command line variant of this flag is rÐ0…rÑ0}rÒ0(h=X)The command line variant of this flag is hDNhRNhShh>jÌ0ubh–)rÓ0}rÔ0(h=X``--program-suffix='$version'``hH}rÕ0(hJ]hK]hL]hM]hP]uh>jÌ0hT]rÖ0h]X--program-suffix='$version'r×0…rØ0}rÙ0(h=X--program-suffix='$version'h>jÓ0ubahFhžubh]X.…rÚ0}rÛ0(h=X.hDNhRNhShh>jÌ0ubeubeubeubj7)rÜ0}rÝ0(h=Uh>jf hDhEhFj:hH}rÞ0(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rß0}rà0(h=Uh>jf hDhEhFj?hH}rá0(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrâ0jEjâ0uhRNhShhT]rã0(jG)rä0}rå0(h=Xshared: booleanh>jß0hDhEhFjJhH}ræ0(hM]rç0Xcfg-field-sharedrè0ahL]hJ]hK]hP]jN‰uhRNhShhT]ré0(j7)rê0}rë0(h=Uh>jä0hDhEhFj:hH}rì0(hM]hL]hJ]hK]hP]Uentries]rí0(jTXshared ; cabal project optionjè0UNtrî0auhRNhShhT]ubjV)rï0}rð0(h=Xsharedrñ0h>jä0hDhEhFjZhH}rò0(jjhM]hL]hJ]hK]hP]uhRNhShhT]ró0h]Xsharedrô0…rõ0}rö0(h=UhDNhRNhShh>jï0ubaubj`)r÷0}rø0(h=jch>jä0hDhEhFjdhH}rù0(jjhM]hL]hJ]hK]hP]uhRNhShhT]rú0h]X: rû0…rü0}rý0(h=UhDNhRNhShh>j÷0ubaubjj)rþ0}rÿ0(h=Xbooleanh>jä0hDhEhFjmhH}r1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r1h]Xbooleanr1…r1}r1(h=UhDNhRNhShh>jþ0ubaubeubjG)r1}r1(h=X--enable-sharedr1h>jß0hDhEhFjJhH}r1(hM]r 1Xcfg-flag---enable-sharedr 1ahL]hJ]hK]hP]jN‰uhRNhShhT]r 1(j7)r 1}r 1(h=Uh>j1hDhEhFj:hH}r1(hM]hL]hJ]hK]hP]Uentries]r1(jTX%--enable-shared; cabal project optionj 1UNtr1auhRNhShhT]ubjV)r1}r1(h=j1h>j1hDhEhFjZhH}r1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r1h]X--enable-sharedr1…r1}r1(h=UhDNhRNhShh>j1ubaubj`)r1}r1(h=U h>j1hDhEhFjdhH}r1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r1h]X …r1}r1(h=UhDNhRNhShh>j1ubaubeubjG)r1}r1(h=X--disable-sharedr 1h>jß0hDhEhFjJhH}r!1(hM]r"1Xcfg-flag---disable-sharedr#1ahL]hJ]hK]hP]jN‰uhRNhShhT]r$1(j7)r%1}r&1(h=Uh>j1hDhEhFj:hH}r'1(hM]hL]hJ]hK]hP]Uentries]r(1(jTX&--disable-shared; cabal project optionj#1UNtr)1auhRNhShhT]ubjV)r*1}r+1(h=j 1h>j1hDhEhFjZhH}r,1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r-1h]X--disable-sharedr.1…r/1}r01(h=UhDNhRNhShh>j*1ubaubj`)r11}r21(h=U h>j1hDhEhFjdhH}r31(jjhM]hL]hJ]hK]hP]uhRNhShhT]r41h]X …r51}r61(h=UhDNhRNhShh>j11ubaubeubjs)r71}r81(h=Uh>jß0hDhEhFjvhH}r91(hJ]hK]hL]hM]hP]uhRNhShhT]r:1(jy)r;1}r<1(h=Uh>j71hDhEhFj|hH}r=1(hJ]hK]hL]hM]hP]uhRNhShhT]r>1j)r?1}r@1(h=UhH}rA1(hJ]hK]hL]hM]hP]uh>j;1hT]rB1(j„)rC1}rD1(h=X Default valueh>j?1hDhEhFj‡hH}rE1(hJ]hK]hL]hM]hP]uhRKhT]rF1h]X Default valuerG1…rH1}rI1(h=Uh>jC1ubaubj)rJ1}rK1(h=UhH}rL1(hJ]hK]hL]hM]hP]uh>j?1hT]rM1hp)rN1}rO1(h=XFalsehH}rP1(hJ]hK]hL]hM]hP]uh>jJ1hT]rQ1h]XFalserR1…rS1}rT1(h=XFalsehDNhRNhShh>jN1ubahFhtubahFjubehFjžubaubhp)rU1}rV1(h=XBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rW1h>j71hDhEhFhthH}rX1(hJ]hK]hL]hM]hP]uhRMØhShhT]rY1h]XBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rZ1…r[1}r\1(h=jW1hDNhRNhShh>jU1ubaubhp)r]1}r^1(h=XVThe command line variant of this flag is ``--enable-shared`` and ``--disable-shared``.h>j71hDhEhFhthH}r_1(hJ]hK]hL]hM]hP]uhRMÛhShhT]r`1(h]X)The command line variant of this flag is ra1…rb1}rc1(h=X)The command line variant of this flag is hDNhRNhShh>j]1ubh–)rd1}re1(h=X``--enable-shared``hH}rf1(hJ]hK]hL]hM]hP]uh>j]1hT]rg1h]X--enable-sharedrh1…ri1}rj1(h=X--enable-sharedh>jd1ubahFhžubh]X and rk1…rl1}rm1(h=X and hDNhRNhShh>j]1ubh–)rn1}ro1(h=X``--disable-shared``hH}rp1(hJ]hK]hL]hM]hP]uh>j]1hT]rq1h]X--disable-sharedrr1…rs1}rt1(h=X--disable-sharedh>jn1ubahFhžubh]X.…ru1}rv1(h=X.hDNhRNhShh>j]1ubeubeubeubj7)rw1}rx1(h=Uh>jf hDhEhFj:hH}ry1(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rz1}r{1(h=Uh>jf hDhEhFj?hH}r|1(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr}1jEj}1uhRNhShhT]r~1(jG)r1}r€1(h=Xexecutable-dynamic: booleanh>jz1hDhEhFjJhH}r1(hM]r‚1Xcfg-field-executable-dynamicrƒ1ahL]hJ]hK]hP]jN‰uhRNhShhT]r„1(j7)r…1}r†1(h=Uh>j1hDhEhFj:hH}r‡1(hM]hL]hJ]hK]hP]Uentries]rˆ1(jTX)executable-dynamic ; cabal project optionjƒ1UNtr‰1auhRNhShhT]ubjV)rŠ1}r‹1(h=Xexecutable-dynamicrŒ1h>j1hDhEhFjZhH}r1(jjhM]hL]hJ]hK]hP]uhRNhShhT]rŽ1h]Xexecutable-dynamicr1…r1}r‘1(h=UhDNhRNhShh>jŠ1ubaubj`)r’1}r“1(h=jch>j1hDhEhFjdhH}r”1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r•1h]X: r–1…r—1}r˜1(h=UhDNhRNhShh>j’1ubaubjj)r™1}rš1(h=Xbooleanh>j1hDhEhFjmhH}r›1(jjhM]hL]hJ]hK]hP]uhRNhShhT]rœ1h]Xbooleanr1…rž1}rŸ1(h=UhDNhRNhShh>j™1ubaubeubjG)r 1}r¡1(h=X--enable-executable-dynamicr¢1h>jz1hDhEhFjJhH}r£1(hM]r¤1X$cfg-flag---enable-executable-dynamicr¥1ahL]hJ]hK]hP]jN‰uhRNhShhT]r¦1(j7)r§1}r¨1(h=Uh>j 1hDhEhFj:hH}r©1(hM]hL]hJ]hK]hP]Uentries]rª1(jTX1--enable-executable-dynamic; cabal project optionj¥1UNtr«1auhRNhShhT]ubjV)r¬1}r­1(h=j¢1h>j 1hDhEhFjZhH}r®1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¯1h]X--enable-executable-dynamicr°1…r±1}r²1(h=UhDNhRNhShh>j¬1ubaubj`)r³1}r´1(h=U h>j 1hDhEhFjdhH}rµ1(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¶1h]X …r·1}r¸1(h=UhDNhRNhShh>j³1ubaubeubjG)r¹1}rº1(h=X--disable-executable-dynamicr»1h>jz1hDhEhFjJhH}r¼1(hM]r½1X%cfg-flag---disable-executable-dynamicr¾1ahL]hJ]hK]hP]jN‰uhRNhShhT]r¿1(j7)rÀ1}rÁ1(h=Uh>j¹1hDhEhFj:hH}rÂ1(hM]hL]hJ]hK]hP]Uentries]rÃ1(jTX2--disable-executable-dynamic; cabal project optionj¾1UNtrÄ1auhRNhShhT]ubjV)rÅ1}rÆ1(h=j»1h>j¹1hDhEhFjZhH}rÇ1(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÈ1h]X--disable-executable-dynamicrÉ1…rÊ1}rË1(h=UhDNhRNhShh>jÅ1ubaubj`)rÌ1}rÍ1(h=U h>j¹1hDhEhFjdhH}rÎ1(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÏ1h]X …rÐ1}rÑ1(h=UhDNhRNhShh>jÌ1ubaubeubjs)rÒ1}rÓ1(h=Uh>jz1hDhEhFjvhH}rÔ1(hJ]hK]hL]hM]hP]uhRNhShhT]rÕ1(jy)rÖ1}r×1(h=Uh>jÒ1hDhEhFj|hH}rØ1(hJ]hK]hL]hM]hP]uhRNhShhT]rÙ1j)rÚ1}rÛ1(h=UhH}rÜ1(hJ]hK]hL]hM]hP]uh>jÖ1hT]rÝ1(j„)rÞ1}rß1(h=X Default valueh>jÚ1hDhEhFj‡hH}rà1(hJ]hK]hL]hM]hP]uhRKhT]rá1h]X Default valuerâ1…rã1}rä1(h=Uh>jÞ1ubaubj)rå1}ræ1(h=UhH}rç1(hJ]hK]hL]hM]hP]uh>jÚ1hT]rè1hp)ré1}rê1(h=XFalsehH}rë1(hJ]hK]hL]hM]hP]uh>jå1hT]rì1h]XFalserí1…rî1}rï1(h=XFalsehDNhRNhShh>jé1ubahFhtubahFjubehFjžubaubhp)rð1}rñ1(h=X¶Link executables dynamically. The executable's library dependencies should be built as shared objects. This implies ``shared: True`` unless ``shared: False`` is explicitly specified.h>jÒ1hDhEhFhthH}rò1(hJ]hK]hL]hM]hP]uhRMåhShhT]ró1(h]XvLink executables dynamically. The executable’s library dependencies should be built as shared objects. This implies rô1…rõ1}rö1(h=XtLink executables dynamically. The executable's library dependencies should be built as shared objects. This implies hDNhRNhShh>jð1ubh–)r÷1}rø1(h=X``shared: True``hH}rù1(hJ]hK]hL]hM]hP]uh>jð1hT]rú1h]X shared: Truerû1…rü1}rý1(h=X shared: Trueh>j÷1ubahFhžubh]X unless rþ1…rÿ1}r2(h=X unless hDNhRNhShh>jð1ubh–)r2}r2(h=X``shared: False``hH}r2(hJ]hK]hL]hM]hP]uh>jð1hT]r2h]X shared: Falser2…r2}r2(h=X shared: Falseh>j2ubahFhžubh]X is explicitly specified.r2…r 2}r 2(h=X is explicitly specified.hDNhRNhShh>jð1ubeubhp)r 2}r 2(h=XnThe command line variant of this flag is ``--enable-executable-dynamic`` and ``--disable-executable-dynamic``.h>jÒ1hDhEhFhthH}r 2(hJ]hK]hL]hM]hP]uhRMéhShhT]r2(h]X)The command line variant of this flag is r2…r2}r2(h=X)The command line variant of this flag is hDNhRNhShh>j 2ubh–)r2}r2(h=X``--enable-executable-dynamic``hH}r2(hJ]hK]hL]hM]hP]uh>j 2hT]r2h]X--enable-executable-dynamicr2…r2}r2(h=X--enable-executable-dynamich>j2ubahFhžubh]X and r2…r2}r2(h=X and hDNhRNhShh>j 2ubh–)r2}r2(h=X ``--disable-executable-dynamic``hH}r2(hJ]hK]hL]hM]hP]uh>j 2hT]r2h]X--disable-executable-dynamicr 2…r!2}r"2(h=X--disable-executable-dynamich>j2ubahFhžubh]X.…r#2}r$2(h=X.hDNhRNhShh>j 2ubeubeubeubj7)r%2}r&2(h=Uh>jf hDhEhFj:hH}r'2(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r(2}r)2(h=Uh>jf hDhEhFj?hH}r*2(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr+2jEj+2uhRNhShhT]r,2(jG)r-2}r.2(h=Xlibrary-for-ghci: booleanh>j(2hDhEhFjJhH}r/2(hM]r02Xcfg-field-library-for-ghcir12ahL]hJ]hK]hP]jN‰uhRNhShhT]r22(j7)r32}r42(h=Uh>j-2hDhEhFj:hH}r52(hM]hL]hJ]hK]hP]Uentries]r62(jTX'library-for-ghci ; cabal project optionj12UNtr72auhRNhShhT]ubjV)r82}r92(h=Xlibrary-for-ghcir:2h>j-2hDhEhFjZhH}r;2(jjhM]hL]hJ]hK]hP]uhRNhShhT]r<2h]Xlibrary-for-ghcir=2…r>2}r?2(h=UhDNhRNhShh>j82ubaubj`)r@2}rA2(h=jch>j-2hDhEhFjdhH}rB2(jjhM]hL]hJ]hK]hP]uhRNhShhT]rC2h]X: rD2…rE2}rF2(h=UhDNhRNhShh>j@2ubaubjj)rG2}rH2(h=Xbooleanh>j-2hDhEhFjmhH}rI2(jjhM]hL]hJ]hK]hP]uhRNhShhT]rJ2h]XbooleanrK2…rL2}rM2(h=UhDNhRNhShh>jG2ubaubeubjG)rN2}rO2(h=X--enable-library-for-ghcirP2h>j(2hDhEhFjJhH}rQ2(hM]rR2X"cfg-flag---enable-library-for-ghcirS2ahL]hJ]hK]hP]jN‰uhRNhShhT]rT2(j7)rU2}rV2(h=Uh>jN2hDhEhFj:hH}rW2(hM]hL]hJ]hK]hP]Uentries]rX2(jTX/--enable-library-for-ghci; cabal project optionjS2UNtrY2auhRNhShhT]ubjV)rZ2}r[2(h=jP2h>jN2hDhEhFjZhH}r\2(jjhM]hL]hJ]hK]hP]uhRNhShhT]r]2h]X--enable-library-for-ghcir^2…r_2}r`2(h=UhDNhRNhShh>jZ2ubaubj`)ra2}rb2(h=U h>jN2hDhEhFjdhH}rc2(jjhM]hL]hJ]hK]hP]uhRNhShhT]rd2h]X …re2}rf2(h=UhDNhRNhShh>ja2ubaubeubjG)rg2}rh2(h=X--disable-library-for-ghciri2h>j(2hDhEhFjJhH}rj2(hM]rk2X#cfg-flag---disable-library-for-ghcirl2ahL]hJ]hK]hP]jN‰uhRNhShhT]rm2(j7)rn2}ro2(h=Uh>jg2hDhEhFj:hH}rp2(hM]hL]hJ]hK]hP]Uentries]rq2(jTX0--disable-library-for-ghci; cabal project optionjl2UNtrr2auhRNhShhT]ubjV)rs2}rt2(h=ji2h>jg2hDhEhFjZhH}ru2(jjhM]hL]hJ]hK]hP]uhRNhShhT]rv2h]X--disable-library-for-ghcirw2…rx2}ry2(h=UhDNhRNhShh>js2ubaubj`)rz2}r{2(h=U h>jg2hDhEhFjdhH}r|2(jjhM]hL]hJ]hK]hP]uhRNhShhT]r}2h]X …r~2}r2(h=UhDNhRNhShh>jz2ubaubeubjs)r€2}r2(h=Uh>j(2hDhEhFjvhH}r‚2(hJ]hK]hL]hM]hP]uhRNhShhT]rƒ2(jy)r„2}r…2(h=Uh>j€2hDhEhFj|hH}r†2(hJ]hK]hL]hM]hP]uhRNhShhT]r‡2j)rˆ2}r‰2(h=UhH}rŠ2(hJ]hK]hL]hM]hP]uh>j„2hT]r‹2(j„)rŒ2}r2(h=X Default valueh>jˆ2hDhEhFj‡hH}rŽ2(hJ]hK]hL]hM]hP]uhRKhT]r2h]X Default valuer2…r‘2}r’2(h=Uh>jŒ2ubaubj)r“2}r”2(h=UhH}r•2(hJ]hK]hL]hM]hP]uh>jˆ2hT]r–2hp)r—2}r˜2(h=XTruehH}r™2(hJ]hK]hL]hM]hP]uh>j“2hT]rš2h]XTruer›2…rœ2}r2(h=XTruehDNhRNhShh>j—2ubahFhtubahFjubehFjžubaubhp)rž2}rŸ2(h=X`Build libraries suitable for use with GHCi. This involves an extra linking step after the build.r 2h>j€2hDhEhFhthH}r¡2(hJ]hK]hL]hM]hP]uhRMôhShhT]r¢2h]X`Build libraries suitable for use with GHCi. This involves an extra linking step after the build.r£2…r¤2}r¥2(h=j 2hDNhRNhShh>jž2ubaubhp)r¦2}r§2(h=XšNot all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases, consider setting ``library-for-ghci: False``.h>j€2hDhEhFhthH}r¨2(hJ]hK]hL]hM]hP]uhRM÷hShhT]r©2(h]X~Not all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases, consider setting rª2…r«2}r¬2(h=X~Not all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases, consider setting hDNhRNhShh>j¦2ubh–)r­2}r®2(h=X``library-for-ghci: False``hH}r¯2(hJ]hK]hL]hM]hP]uh>j¦2hT]r°2h]Xlibrary-for-ghci: Falser±2…r²2}r³2(h=Xlibrary-for-ghci: Falseh>j­2ubahFhžubh]X.…r´2}rµ2(h=X.hDNhRNhShh>j¦2ubeubhp)r¶2}r·2(h=XjThe command line variant of this flag is ``--enable-library-for-ghci`` and ``--disable-library-for-ghci``.h>j€2hDhEhFhthH}r¸2(hJ]hK]hL]hM]hP]uhRMûhShhT]r¹2(h]X)The command line variant of this flag is rº2…r»2}r¼2(h=X)The command line variant of this flag is hDNhRNhShh>j¶2ubh–)r½2}r¾2(h=X``--enable-library-for-ghci``hH}r¿2(hJ]hK]hL]hM]hP]uh>j¶2hT]rÀ2h]X--enable-library-for-ghcirÁ2…rÂ2}rÃ2(h=X--enable-library-for-ghcih>j½2ubahFhžubh]X and rÄ2…rÅ2}rÆ2(h=X and hDNhRNhShh>j¶2ubh–)rÇ2}rÈ2(h=X``--disable-library-for-ghci``hH}rÉ2(hJ]hK]hL]hM]hP]uh>j¶2hT]rÊ2h]X--disable-library-for-ghcirË2…rÌ2}rÍ2(h=X--disable-library-for-ghcih>jÇ2ubahFhžubh]X.…rÎ2}rÏ2(h=X.hDNhRNhShh>j¶2ubeubeubeubj7)rÐ2}rÑ2(h=Uh>jf hDhEhFj:hH}rÒ2(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rÓ2}rÔ2(h=Uh>jf hDhEhFj?hH}rÕ2(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrÖ2jEjÖ2uhRNhShhT]r×2(jG)rØ2}rÙ2(h=X relocatable:h>jÓ2hDhEhFjJhH}rÚ2(hM]rÛ2Xcfg-field-relocatablerÜ2ahL]hJ]hK]hP]jN‰uhRNhShhT]rÝ2(j7)rÞ2}rß2(h=Uh>jØ2hDhEhFj:hH}rà2(hM]hL]hJ]hK]hP]Uentries]rá2(jTX"relocatable ; cabal project optionjÜ2UNtrâ2auhRNhShhT]ubjV)rã2}rä2(h=X relocatablerå2h>jØ2hDhEhFjZhH}ræ2(jjhM]hL]hJ]hK]hP]uhRNhShhT]rç2h]X relocatablerè2…ré2}rê2(h=UhDNhRNhShh>jã2ubaubj`)rë2}rì2(h=jch>jØ2hDhEhFjdhH}rí2(jjhM]hL]hJ]hK]hP]uhRNhShhT]rî2h]X: rï2…rð2}rñ2(h=UhDNhRNhShh>jë2ubaubjj)rò2}ró2(h=Uh>jØ2hDhEhFjmhH}rô2(jjhM]hL]hJ]hK]hP]uhRNhShhT]ubeubjG)rõ2}rö2(h=X --relocatabler÷2h>jÓ2hDhEhFjJhH}rø2(hM]rù2Xcfg-flag---relocatablerú2ahL]hJ]hK]hP]jN‰uhRNhShhT]rû2(j7)rü2}rý2(h=Uh>jõ2hDhEhFj:hH}rþ2(hM]hL]hJ]hK]hP]Uentries]rÿ2(jTX#--relocatable; cabal project optionjú2UNtr3auhRNhShhT]ubjV)r3}r3(h=j÷2h>jõ2hDhEhFjZhH}r3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r3h]X --relocatabler3…r3}r3(h=UhDNhRNhShh>j3ubaubj`)r3}r 3(h=U h>jõ2hDhEhFjdhH}r 3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r 3h]X …r 3}r 3(h=UhDNhRNhShh>j3ubaubeubjs)r3}r3(h=Uh>jÓ2hDhEhFjvhH}r3(hJ]hK]hL]hM]hP]uhRNhShhT]r3(jy)r3}r3(h=Uh>j3hDhEhFj|hH}r3(hJ]hK]hL]hM]hP]uhRNhShhT]r3(j)r3}r3(h=Uh>j3hDhEhFjžhH}r3(hJ]hK]hL]hM]hP]uhRNhShhT]r3(j„)r3}r3(h=j2h>j3hDhEhFj‡hH}r3(hJ]hK]hL]hM]hP]uhRKhT]r3h]XSincer3…r3}r 3(h=Uh>j3ubaubj)r!3}r"3(h=U Cabal 1.22r#3hH}r$3(hJ]hK]hL]hM]hP]uh>j3hT]r%3hp)r&3}r'3(h=j#3hH}r(3(hJ]hK]hL]hM]hP]uh>j!3hT]r)3h]X Cabal 1.22r*3…r+3}r,3(h=Uh>j&3ubahFhtubahFjubeubj)r-3}r.3(h=UhH}r/3(hJ]hK]hL]hM]hP]uh>j3hT]r03(j„)r13}r23(h=X Default valueh>j-3hDhEhFj‡hH}r33(hJ]hK]hL]hM]hP]uhRKhT]r43h]X Default valuer53…r63}r73(h=Uh>j13ubaubj)r83}r93(h=UhH}r:3(hJ]hK]hL]hM]hP]uh>j-3hT]r;3hp)r<3}r=3(h=XFalsehH}r>3(hJ]hK]hL]hM]hP]uh>j83hT]r?3h]XFalser@3…rA3}rB3(h=XFalsehDNhRNhShh>j<3ubahFhtubahFjubehFjžubeubhp)rC3}rD3(h=Xy[STRIKEOUT:Build a package which is relocatable.] (TODO: It is not clear what this actually does, or if it works at all.)rE3h>j3hDhEhFhthH}rF3(hJ]hK]hL]hM]hP]uhRMhShhT]rG3h]Xy[STRIKEOUT:Build a package which is relocatable.] (TODO: It is not clear what this actually does, or if it works at all.)rH3…rI3}rJ3(h=jE3hDNhRNhShh>jC3ubaubhp)rK3}rL3(h=X;The command line variant of this flag is ``--relocatable``.h>j3hDhEhFhthH}rM3(hJ]hK]hL]hM]hP]uhRMhShhT]rN3(h]X)The command line variant of this flag is rO3…rP3}rQ3(h=X)The command line variant of this flag is hDNhRNhShh>jK3ubh–)rR3}rS3(h=X``--relocatable``hH}rT3(hJ]hK]hL]hM]hP]uh>jK3hT]rU3h]X --relocatablerV3…rW3}rX3(h=X --relocatableh>jR3ubahFhžubh]X.…rY3}rZ3(h=X.hDNhRNhShh>jK3ubeubeubeubj7)r[3}r\3(h=Uh>jf hDhEhFj:hH}r]3(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r^3}r_3(h=Uh>jf hDhEhFj?hH}r`3(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldra3jEja3uhRNhShhT]rb3(jG)rc3}rd3(h=Xstatic: booleanh>j^3hDhEhFjJhH}re3(hM]rf3Xcfg-field-staticrg3ahL]hJ]hK]hP]jN‰uhRNhShhT]rh3(j7)ri3}rj3(h=Uh>jc3hDhEhFj:hH}rk3(hM]hL]hJ]hK]hP]Uentries]rl3(jTXstatic ; cabal project optionjg3UNtrm3auhRNhShhT]ubjV)rn3}ro3(h=Xstaticrp3h>jc3hDhEhFjZhH}rq3(jjhM]hL]hJ]hK]hP]uhRNhShhT]rr3h]Xstaticrs3…rt3}ru3(h=UhDNhRNhShh>jn3ubaubj`)rv3}rw3(h=jch>jc3hDhEhFjdhH}rx3(jjhM]hL]hJ]hK]hP]uhRNhShhT]ry3h]X: rz3…r{3}r|3(h=UhDNhRNhShh>jv3ubaubjj)r}3}r~3(h=Xbooleanh>jc3hDhEhFjmhH}r3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r€3h]Xbooleanr3…r‚3}rƒ3(h=UhDNhRNhShh>j}3ubaubeubjG)r„3}r…3(h=X--enable-staticr†3h>j^3hDhEhFjJhH}r‡3(hM]rˆ3Xcfg-flag---enable-staticr‰3ahL]hJ]hK]hP]jN‰uhRNhShhT]rŠ3(j7)r‹3}rŒ3(h=Uh>j„3hDhEhFj:hH}r3(hM]hL]hJ]hK]hP]Uentries]rŽ3(jTX%--enable-static; cabal project optionj‰3UNtr3auhRNhShhT]ubjV)r3}r‘3(h=j†3h>j„3hDhEhFjZhH}r’3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r“3h]X--enable-staticr”3…r•3}r–3(h=UhDNhRNhShh>j3ubaubj`)r—3}r˜3(h=U h>j„3hDhEhFjdhH}r™3(jjhM]hL]hJ]hK]hP]uhRNhShhT]rš3h]X …r›3}rœ3(h=UhDNhRNhShh>j—3ubaubeubjG)r3}rž3(h=X--disable-staticrŸ3h>j^3hDhEhFjJhH}r 3(hM]r¡3Xcfg-flag---disable-staticr¢3ahL]hJ]hK]hP]jN‰uhRNhShhT]r£3(j7)r¤3}r¥3(h=Uh>j3hDhEhFj:hH}r¦3(hM]hL]hJ]hK]hP]Uentries]r§3(jTX&--disable-static; cabal project optionj¢3UNtr¨3auhRNhShhT]ubjV)r©3}rª3(h=jŸ3h>j3hDhEhFjZhH}r«3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¬3h]X--disable-staticr­3…r®3}r¯3(h=UhDNhRNhShh>j©3ubaubj`)r°3}r±3(h=U h>j3hDhEhFjdhH}r²3(jjhM]hL]hJ]hK]hP]uhRNhShhT]r³3h]X …r´3}rµ3(h=UhDNhRNhShh>j°3ubaubeubjs)r¶3}r·3(h=Uh>j^3hDhEhFjvhH}r¸3(hJ]hK]hL]hM]hP]uhRNhShhT]r¹3(jy)rº3}r»3(h=Uh>j¶3hDhEhFj|hH}r¼3(hJ]hK]hL]hM]hP]uhRNhShhT]r½3j)r¾3}r¿3(h=UhH}rÀ3(hJ]hK]hL]hM]hP]uh>jº3hT]rÁ3(j„)rÂ3}rÃ3(h=X Default valueh>j¾3hDhEhFj‡hH}rÄ3(hJ]hK]hL]hM]hP]uhRKhT]rÅ3h]X Default valuerÆ3…rÇ3}rÈ3(h=Uh>jÂ3ubaubj)rÉ3}rÊ3(h=UhH}rË3(hJ]hK]hL]hM]hP]uh>j¾3hT]rÌ3hp)rÍ3}rÎ3(h=XFalsehH}rÏ3(hJ]hK]hL]hM]hP]uh>jÉ3hT]rÐ3h]XFalserÑ3…rÒ3}rÓ3(h=XFalserÔ3hDNhRNhShh>jÍ3ubahFhtubahFjubehFjžubaubhp)rÕ3}rÖ3(h=X¼Roll this and all dependent libraries into a combined ``.a`` archive. This uses GHCs ``-staticlib`` flag, which is available for iOS and with GHC 8.4 and later for other platforms as well.h>j¶3hDhEhFhthH}r×3(hJ]hK]hL]hM]hP]uhRMhShhT]rØ3(h]X6Roll this and all dependent libraries into a combined rÙ3…rÚ3}rÛ3(h=X6Roll this and all dependent libraries into a combined hDNhRNhShh>jÕ3ubh–)rÜ3}rÝ3(h=X``.a``hH}rÞ3(hJ]hK]hL]hM]hP]uh>jÕ3hT]rß3h]X.arà3…rá3}râ3(h=X.ah>jÜ3ubahFhžubh]X archive. This uses GHCs rã3…rä3}rå3(h=X archive. This uses GHCs hDNhRNhShh>jÕ3ubh–)ræ3}rç3(h=X``-staticlib``hH}rè3(hJ]hK]hL]hM]hP]uh>jÕ3hT]ré3h]X -staticlibrê3…rë3}rì3(h=X -staticlibh>jæ3ubahFhžubh]XY flag, which is available for iOS and with GHC 8.4 and later for other platforms as well.rí3…rî3}rï3(h=XY flag, which is available for iOS and with GHC 8.4 and later for other platforms as well.hDNhRNhShh>jÕ3ubeubeubeubj7)rð3}rñ3(h=Uh>jf hDhEhFj:hH}rò3(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)ró3}rô3(h=Uh>jf hDhEhFj?hH}rõ3(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrö3jEjö3uhRNhShhT]r÷3(jG)rø3}rù3(h=Xexecutable-static: booleanh>jó3hDhEhFjJhH}rú3(hM]rû3Xcfg-field-executable-staticrü3ahL]hJ]hK]hP]jN‰uhRNhShhT]rý3(j7)rþ3}rÿ3(h=Uh>jø3hDhEhFj:hH}r4(hM]hL]hJ]hK]hP]Uentries]r4(jTX(executable-static ; cabal project optionjü3UNtr4auhRNhShhT]ubjV)r4}r4(h=Xexecutable-staticr4h>jø3hDhEhFjZhH}r4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r4h]Xexecutable-staticr4…r 4}r 4(h=UhDNhRNhShh>j4ubaubj`)r 4}r 4(h=jch>jø3hDhEhFjdhH}r 4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r4h]X: r4…r4}r4(h=UhDNhRNhShh>j 4ubaubjj)r4}r4(h=Xbooleanh>jø3hDhEhFjmhH}r4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r4h]Xbooleanr4…r4}r4(h=UhDNhRNhShh>j4ubaubeubjG)r4}r4(h=X--enable-executable-staticr4h>jó3hDhEhFjJhH}r4(hM]r4X#cfg-flag---enable-executable-staticr4ahL]hJ]hK]hP]jN‰uhRNhShhT]r4(j7)r 4}r!4(h=Uh>j4hDhEhFj:hH}r"4(hM]hL]hJ]hK]hP]Uentries]r#4(jTX0--enable-executable-static; cabal project optionj4UNtr$4auhRNhShhT]ubjV)r%4}r&4(h=j4h>j4hDhEhFjZhH}r'4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r(4h]X--enable-executable-staticr)4…r*4}r+4(h=UhDNhRNhShh>j%4ubaubj`)r,4}r-4(h=U h>j4hDhEhFjdhH}r.4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r/4h]X …r04}r14(h=UhDNhRNhShh>j,4ubaubeubjG)r24}r34(h=X--disable-executable-staticr44h>jó3hDhEhFjJhH}r54(hM]r64X$cfg-flag---disable-executable-staticr74ahL]hJ]hK]hP]jN‰uhRNhShhT]r84(j7)r94}r:4(h=Uh>j24hDhEhFj:hH}r;4(hM]hL]hJ]hK]hP]Uentries]r<4(jTX1--disable-executable-static; cabal project optionj74UNtr=4auhRNhShhT]ubjV)r>4}r?4(h=j44h>j24hDhEhFjZhH}r@4(jjhM]hL]hJ]hK]hP]uhRNhShhT]rA4h]X--disable-executable-staticrB4…rC4}rD4(h=UhDNhRNhShh>j>4ubaubj`)rE4}rF4(h=U h>j24hDhEhFjdhH}rG4(jjhM]hL]hJ]hK]hP]uhRNhShhT]rH4h]X …rI4}rJ4(h=UhDNhRNhShh>jE4ubaubeubjs)rK4}rL4(h=Uh>jó3hDhEhFjvhH}rM4(hJ]hK]hL]hM]hP]uhRNhShhT]rN4(jy)rO4}rP4(h=Uh>jK4hDhEhFj|hH}rQ4(hJ]hK]hL]hM]hP]uhRNhShhT]rR4j)rS4}rT4(h=UhH}rU4(hJ]hK]hL]hM]hP]uh>jO4hT]rV4(j„)rW4}rX4(h=X Default valueh>jS4hDhEhFj‡hH}rY4(hJ]hK]hL]hM]hP]uhRKhT]rZ4h]X Default valuer[4…r\4}r]4(h=Uh>jW4ubaubj)r^4}r_4(h=UhH}r`4(hJ]hK]hL]hM]hP]uh>jS4hT]ra4hp)rb4}rc4(h=XFalsehH}rd4(hJ]hK]hL]hM]hP]uh>j^4hT]re4h]XFalserf4…rg4}rh4(h=XFalsehDNhRNhShh>jb4ubahFhtubahFjubehFjžubaubhp)ri4}rj4(h=X¤Build fully static executables. This link all dependent libraries into executables statically, including libc. This passes ``-static`` and ``-optl=-static`` to GHC.h>jK4hDhEhFhthH}rk4(hJ]hK]hL]hM]hP]uhRM!hShhT]rl4(h]X{Build fully static executables. This link all dependent libraries into executables statically, including libc. This passes rm4…rn4}ro4(h=X{Build fully static executables. This link all dependent libraries into executables statically, including libc. This passes hDNhRNhShh>ji4ubh–)rp4}rq4(h=X ``-static``hH}rr4(hJ]hK]hL]hM]hP]uh>ji4hT]rs4h]X-staticrt4…ru4}rv4(h=X-statich>jp4ubahFhžubh]X and rw4…rx4}ry4(h=X and hDNhRNhShh>ji4ubh–)rz4}r{4(h=X``-optl=-static``hH}r|4(hJ]hK]hL]hM]hP]uh>ji4hT]r}4h]X -optl=-staticr~4…r4}r€4(h=X -optl=-statich>jz4ubahFhžubh]X to GHC.r4…r‚4}rƒ4(h=X to GHC.hDNhRNhShh>ji4ubeubeubeubj7)r„4}r…4(h=Uh>jf hDhEhFj:hH}r†4(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r‡4}rˆ4(h=Uh>jf hDhEhFj?hH}r‰4(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrŠ4jEjŠ4uhRNhShhT]r‹4(jG)rŒ4}r4(h=XAextra-include-dirs: directories (comma or newline separated list)h>j‡4hDhEhFjJhH}rŽ4(hM]r4Xcfg-field-extra-include-dirsr4ahL]hJ]hK]hP]jN‰uhRNhShhT]r‘4(j7)r’4}r“4(h=Uh>jŒ4hDhEhFj:hH}r”4(hM]hL]hJ]hK]hP]Uentries]r•4(jTX)extra-include-dirs ; cabal project optionj4UNtr–4auhRNhShhT]ubjV)r—4}r˜4(h=Xextra-include-dirsr™4h>jŒ4hDhEhFjZhH}rš4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r›4h]Xextra-include-dirsrœ4…r4}rž4(h=UhDNhRNhShh>j—4ubaubj`)rŸ4}r 4(h=jch>jŒ4hDhEhFjdhH}r¡4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¢4h]X: r£4…r¤4}r¥4(h=UhDNhRNhShh>jŸ4ubaubjj)r¦4}r§4(h=X-directories (comma or newline separated list)h>jŒ4hDhEhFjmhH}r¨4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r©4h]X-directories (comma or newline separated list)rª4…r«4}r¬4(h=UhDNhRNhShh>j¦4ubaubeubjG)r­4}r®4(h=X--extra-include-dirs=DIRh>j‡4hDhEhFjJhH}r¯4(hM]r°4Xcfg-flag---extra-include-dirsr±4ahL]hJ]hK]hP]jN‰uhRNhShhT]r²4(j7)r³4}r´4(h=Uh>j­4hDhEhFj:hH}rµ4(hM]hL]hJ]hK]hP]Uentries]r¶4(jTX*--extra-include-dirs; cabal project optionj±4UNtr·4auhRNhShhT]ubjV)r¸4}r¹4(h=X--extra-include-dirsrº4h>j­4hDhEhFjZhH}r»4(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¼4h]X--extra-include-dirsr½4…r¾4}r¿4(h=UhDNhRNhShh>j¸4ubaubj`)rÀ4}rÁ4(h=X=DIRh>j­4hDhEhFjdhH}rÂ4(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÃ4h]X=DIRrÄ4…rÅ4}rÆ4(h=UhDNhRNhShh>jÀ4ubaubeubjs)rÇ4}rÈ4(h=Uh>j‡4hDhEhFjvhH}rÉ4(hJ]hK]hL]hM]hP]uhRNhShhT]rÊ4(hp)rË4}rÌ4(h=XsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rÍ4h>jÇ4hDhEhFhthH}rÎ4(hJ]hK]hL]hM]hP]uhRM-hShhT]rÏ4h]XsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rÐ4…rÑ4}rÒ4(h=jÍ4hDNhRNhShh>jË4ubaubhp)rÓ4}rÔ4(h=XYYou might need to use this flag if you have standard system header files in a non-standard location that is not mentioned in the package's ``.cabal`` file. Using this option has the same affect as appending the directory *dir* to the :pkg-field:`include-dirs` field in each library and executable in the package's ``.cabal`` file. The advantage of course is that you do not have to modify the package at all. These extra directories will be used while building the package and for libraries it is also saved in the package registration information and used when compiling modules that use the library.h>jÇ4hDhEhFhthH}rÕ4(hJ]hK]hL]hM]hP]uhRM0hShhT]rÖ4(h]XYou might need to use this flag if you have standard system header files in a non-standard location that is not mentioned in the package’s r×4…rØ4}rÙ4(h=X‹You might need to use this flag if you have standard system header files in a non-standard location that is not mentioned in the package's hDNhRNhShh>jÓ4ubh–)rÚ4}rÛ4(h=X ``.cabal``hH}rÜ4(hJ]hK]hL]hM]hP]uh>jÓ4hT]rÝ4h]X.cabalrÞ4…rß4}rà4(h=X.cabalh>jÚ4ubahFhžubh]XH file. Using this option has the same affect as appending the directory rá4…râ4}rã4(h=XH file. Using this option has the same affect as appending the directory hDNhRNhShh>jÓ4ubj))rä4}rå4(h=X*dir*hH}ræ4(hJ]hK]hL]hM]hP]uh>jÓ4hT]rç4h]Xdirrè4…ré4}rê4(h=Xdirh>jä4ubahFj1ubh]X to the rë4…rì4}rí4(h=X to the hDNhRNhShh>jÓ4ubjä)rî4}rï4(h=X:pkg-field:`include-dirs`h>jÓ4hDhEhFjçhH}rð4(UreftypeX pkg-fieldjéˆjêX include-dirsrñ4U refdomainXcabalrò4hM]hL]U refexplicit‰hJ]hK]hP]jìjíjNuhRM0hT]ró4h–)rô4}rõ4(h=jñ4hH}rö4(hJ]hK]r÷4(jôjò4Xcabal-pkg-fieldrø4ehL]hM]hP]uh>jî4hT]rù4h]X include-dirsrú4…rû4}rü4(h=Uh>jô4ubahFhžubaubh]X9 field in each library and executable in the package’s rý4…rþ4}rÿ4(h=X7 field in each library and executable in the package's hDNhRNhShh>jÓ4ubh–)r5}r5(h=X ``.cabal``hH}r5(hJ]hK]hL]hM]hP]uh>jÓ4hT]r5h]X.cabalr5…r5}r5(h=X.cabalh>j5ubahFhžubh]X file. The advantage of course is that you do not have to modify the package at all. These extra directories will be used while building the package and for libraries it is also saved in the package registration information and used when compiling modules that use the library.r5…r5}r 5(h=X file. The advantage of course is that you do not have to modify the package at all. These extra directories will be used while building the package and for libraries it is also saved in the package registration information and used when compiling modules that use the library.hDNhRNhShh>jÓ4ubeubhp)r 5}r 5(h=XmThe command line variant of this flag is ``--extra-include-dirs=DIR``, which can be specified multiple times.h>jÇ4hDhEhFhthH}r 5(hJ]hK]hL]hM]hP]uhRM:hShhT]r 5(h]X)The command line variant of this flag is r5…r5}r5(h=X)The command line variant of this flag is hDNhRNhShh>j 5ubh–)r5}r5(h=X``--extra-include-dirs=DIR``hH}r5(hJ]hK]hL]hM]hP]uh>j 5hT]r5h]X--extra-include-dirs=DIRr5…r5}r5(h=X--extra-include-dirs=DIRh>j5ubahFhžubh]X(, which can be specified multiple times.r5…r5}r5(h=X(, which can be specified multiple times.hDNhRNhShh>j 5ubeubeubeubj7)r5}r5(h=Uh>jf hDhEhFj:hH}r5(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r5}r5(h=Uh>jf hDhEhFj?hH}r 5(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr!5jEj!5uhRNhShhT]r"5(jG)r#5}r$5(h=X=extra-lib-dirs: directories (comma or newline separated list)h>j5hDhEhFjJhH}r%5(hM]r&5Xcfg-field-extra-lib-dirsr'5ahL]hJ]hK]hP]jN‰uhRNhShhT]r(5(j7)r)5}r*5(h=Uh>j#5hDhEhFj:hH}r+5(hM]hL]hJ]hK]hP]Uentries]r,5(jTX%extra-lib-dirs ; cabal project optionj'5UNtr-5auhRNhShhT]ubjV)r.5}r/5(h=Xextra-lib-dirsr05h>j#5hDhEhFjZhH}r15(jjhM]hL]hJ]hK]hP]uhRNhShhT]r25h]Xextra-lib-dirsr35…r45}r55(h=UhDNhRNhShh>j.5ubaubj`)r65}r75(h=jch>j#5hDhEhFjdhH}r85(jjhM]hL]hJ]hK]hP]uhRNhShhT]r95h]X: r:5…r;5}r<5(h=UhDNhRNhShh>j65ubaubjj)r=5}r>5(h=X-directories (comma or newline separated list)h>j#5hDhEhFjmhH}r?5(jjhM]hL]hJ]hK]hP]uhRNhShhT]r@5h]X-directories (comma or newline separated list)rA5…rB5}rC5(h=UhDNhRNhShh>j=5ubaubeubjG)rD5}rE5(h=X--extra-lib-dirs=DIRh>j5hDhEhFjJhH}rF5(hM]rG5Xcfg-flag---extra-lib-dirsrH5ahL]hJ]hK]hP]jN‰uhRNhShhT]rI5(j7)rJ5}rK5(h=Uh>jD5hDhEhFj:hH}rL5(hM]hL]hJ]hK]hP]Uentries]rM5(jTX&--extra-lib-dirs; cabal project optionjH5UNtrN5auhRNhShhT]ubjV)rO5}rP5(h=X--extra-lib-dirsrQ5h>jD5hDhEhFjZhH}rR5(jjhM]hL]hJ]hK]hP]uhRNhShhT]rS5h]X--extra-lib-dirsrT5…rU5}rV5(h=UhDNhRNhShh>jO5ubaubj`)rW5}rX5(h=X=DIRh>jD5hDhEhFjdhH}rY5(jjhM]hL]hJ]hK]hP]uhRNhShhT]rZ5h]X=DIRr[5…r\5}r]5(h=UhDNhRNhShh>jW5ubaubeubjs)r^5}r_5(h=Uh>j5hDhEhFjvhH}r`5(hJ]hK]hL]hM]hP]uhRNhShhT]ra5(hp)rb5}rc5(h=X8An extra directory to search for system libraries files.rd5h>j^5hDhEhFhthH}re5(hJ]hK]hL]hM]hP]uhRMAhShhT]rf5h]X8An extra directory to search for system libraries files.rg5…rh5}ri5(h=jd5hDNhRNhShh>jb5ubaubhp)rj5}rk5(h=XiThe command line variant of this flag is ``--extra-lib-dirs=DIR``, which can be specified multiple times.h>j^5hDhEhFhthH}rl5(hJ]hK]hL]hM]hP]uhRMChShhT]rm5(h]X)The command line variant of this flag is rn5…ro5}rp5(h=X)The command line variant of this flag is hDNhRNhShh>jj5ubh–)rq5}rr5(h=X``--extra-lib-dirs=DIR``hH}rs5(hJ]hK]hL]hM]hP]uh>jj5hT]rt5h]X--extra-lib-dirs=DIRru5…rv5}rw5(h=X--extra-lib-dirs=DIRh>jq5ubahFhžubh]X(, which can be specified multiple times.rx5…ry5}rz5(h=X(, which can be specified multiple times.hDNhRNhShh>jj5ubeubeubeubj7)r{5}r|5(h=Uh>jf hDhEhFj:hH}r}5(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r~5}r5(h=Uh>jf hDhEhFj?hH}r€5(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr5jEj5uhRNhShhT]r‚5(jG)rƒ5}r„5(h=XCextra-framework-dirs: directories (comma or newline separated list)h>j~5hDhEhFjJhH}r…5(hM]r†5Xcfg-field-extra-framework-dirsr‡5ahL]hJ]hK]hP]jN‰uhRNhShhT]rˆ5(j7)r‰5}rŠ5(h=Uh>jƒ5hDhEhFj:hH}r‹5(hM]hL]hJ]hK]hP]Uentries]rŒ5(jTX+extra-framework-dirs ; cabal project optionj‡5UNtr5auhRNhShhT]ubjV)rŽ5}r5(h=Xextra-framework-dirsr5h>jƒ5hDhEhFjZhH}r‘5(jjhM]hL]hJ]hK]hP]uhRNhShhT]r’5h]Xextra-framework-dirsr“5…r”5}r•5(h=UhDNhRNhShh>jŽ5ubaubj`)r–5}r—5(h=jch>jƒ5hDhEhFjdhH}r˜5(jjhM]hL]hJ]hK]hP]uhRNhShhT]r™5h]X: rš5…r›5}rœ5(h=UhDNhRNhShh>j–5ubaubjj)r5}rž5(h=X-directories (comma or newline separated list)h>jƒ5hDhEhFjmhH}rŸ5(jjhM]hL]hJ]hK]hP]uhRNhShhT]r 5h]X-directories (comma or newline separated list)r¡5…r¢5}r£5(h=UhDNhRNhShh>j5ubaubeubjG)r¤5}r¥5(h=X--extra-framework-dirs=DIRh>j~5hDhEhFjJhH}r¦5(hM]r§5Xcfg-flag---extra-framework-dirsr¨5ahL]hJ]hK]hP]jN‰uhRNhShhT]r©5(j7)rª5}r«5(h=Uh>j¤5hDhEhFj:hH}r¬5(hM]hL]hJ]hK]hP]Uentries]r­5(jTX,--extra-framework-dirs; cabal project optionj¨5UNtr®5auhRNhShhT]ubjV)r¯5}r°5(h=X--extra-framework-dirsr±5h>j¤5hDhEhFjZhH}r²5(jjhM]hL]hJ]hK]hP]uhRNhShhT]r³5h]X--extra-framework-dirsr´5…rµ5}r¶5(h=UhDNhRNhShh>j¯5ubaubj`)r·5}r¸5(h=X=DIRh>j¤5hDhEhFjdhH}r¹5(jjhM]hL]hJ]hK]hP]uhRNhShhT]rº5h]X=DIRr»5…r¼5}r½5(h=UhDNhRNhShh>j·5ubaubeubjs)r¾5}r¿5(h=Uh>j~5hDhEhFjvhH}rÀ5(hJ]hK]hL]hM]hP]uhRNhShhT]rÁ5(hp)rÂ5}rÃ5(h=X8An extra directory to search for frameworks (OS X only).rÄ5h>j¾5hDhEhFhthH}rÅ5(hJ]hK]hL]hM]hP]uhRMJhShhT]rÆ5h]X8An extra directory to search for frameworks (OS X only).rÇ5…rÈ5}rÉ5(h=jÄ5hDNhRNhShh>jÂ5ubaubhp)rÊ5}rË5(h=XXYou might need to use this flag if you have standard system libraries in a non-standard location that is not mentioned in the package's ``.cabal`` file. Using this option has the same affect as appending the directory *dir* to the :cfg-field:`extra-lib-dirs` field in each library and executable in the package's ``.cabal`` file. The advantage of course is that you do not have to modify the package at all. These extra directories will be used while building the package and for libraries it is also saved in the package registration information and used when compiling modules that use the library.h>j¾5hDhEhFhthH}rÌ5(hJ]hK]hL]hM]hP]uhRMLhShhT]rÍ5(h]XŠYou might need to use this flag if you have standard system libraries in a non-standard location that is not mentioned in the package’s rÎ5…rÏ5}rÐ5(h=XˆYou might need to use this flag if you have standard system libraries in a non-standard location that is not mentioned in the package's hDNhRNhShh>jÊ5ubh–)rÑ5}rÒ5(h=X ``.cabal``hH}rÓ5(hJ]hK]hL]hM]hP]uh>jÊ5hT]rÔ5h]X.cabalrÕ5…rÖ5}r×5(h=X.cabalh>jÑ5ubahFhžubh]XH file. Using this option has the same affect as appending the directory rØ5…rÙ5}rÚ5(h=XH file. Using this option has the same affect as appending the directory hDNhRNhShh>jÊ5ubj))rÛ5}rÜ5(h=X*dir*hH}rÝ5(hJ]hK]hL]hM]hP]uh>jÊ5hT]rÞ5h]Xdirrß5…rà5}rá5(h=Xdirh>jÛ5ubahFj1ubh]X to the râ5…rã5}rä5(h=X to the hDNhRNhShh>jÊ5ubjä)rå5}ræ5(h=X:cfg-field:`extra-lib-dirs`h>jÊ5hDhEhFjçhH}rç5(UreftypeX cfg-fieldjéˆjêXextra-lib-dirsrè5U refdomainXcabalré5hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMLhT]rê5h–)rë5}rì5(h=jè5hH}rí5(hJ]hK]rî5(jôjé5Xcabal-cfg-fieldrï5ehL]hM]hP]uh>jå5hT]rð5h]Xextra-lib-dirsrñ5…rò5}ró5(h=Uh>jë5ubahFhžubaubh]X9 field in each library and executable in the package’s rô5…rõ5}rö5(h=X7 field in each library and executable in the package's hDNhRNhShh>jÊ5ubh–)r÷5}rø5(h=X ``.cabal``hH}rù5(hJ]hK]hL]hM]hP]uh>jÊ5hT]rú5h]X.cabalrû5…rü5}rý5(h=X.cabalh>j÷5ubahFhžubh]X file. The advantage of course is that you do not have to modify the package at all. These extra directories will be used while building the package and for libraries it is also saved in the package registration information and used when compiling modules that use the library.rþ5…rÿ5}r6(h=X file. The advantage of course is that you do not have to modify the package at all. These extra directories will be used while building the package and for libraries it is also saved in the package registration information and used when compiling modules that use the library.hDNhRNhShh>jÊ5ubeubhp)r6}r6(h=XoThe command line variant of this flag is ``--extra-framework-dirs=DIR``, which can be specified multiple times.h>j¾5hDhEhFhthH}r6(hJ]hK]hL]hM]hP]uhRMVhShhT]r6(h]X)The command line variant of this flag is r6…r6}r6(h=X)The command line variant of this flag is hDNhRNhShh>j6ubh–)r6}r 6(h=X``--extra-framework-dirs=DIR``hH}r 6(hJ]hK]hL]hM]hP]uh>j6hT]r 6h]X--extra-framework-dirs=DIRr 6…r 6}r6(h=X--extra-framework-dirs=DIRh>j6ubahFhžubh]X(, which can be specified multiple times.r6…r6}r6(h=X(, which can be specified multiple times.hDNhRNhShh>j6ubeubeubeubj7)r6}r6(h=Uh>jf hDhEhFj:hH}r6(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r6}r6(h=Uh>jf hDhEhFj?hH}r6(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr6jEj6uhRNhShhT]r6(jG)r6}r6(h=Xprofiling: booleanh>j6hDhEhFjJhH}r6(hM]r6Xcfg-field-profilingr6ahL]hJ]hK]hP]jN‰uhRNhShhT]r6(j7)r 6}r!6(h=Uh>j6hDhEhFj:hH}r"6(hM]hL]hJ]hK]hP]Uentries]r#6(jTX profiling ; cabal project optionj6UNtr$6auhRNhShhT]ubjV)r%6}r&6(h=X profilingr'6h>j6hDhEhFjZhH}r(6(jjhM]hL]hJ]hK]hP]uhRNhShhT]r)6h]X profilingr*6…r+6}r,6(h=UhDNhRNhShh>j%6ubaubj`)r-6}r.6(h=jch>j6hDhEhFjdhH}r/6(jjhM]hL]hJ]hK]hP]uhRNhShhT]r06h]X: r16…r26}r36(h=UhDNhRNhShh>j-6ubaubjj)r46}r56(h=Xbooleanh>j6hDhEhFjmhH}r66(jjhM]hL]hJ]hK]hP]uhRNhShhT]r76h]Xbooleanr86…r96}r:6(h=UhDNhRNhShh>j46ubaubeubjG)r;6}r<6(h=X--enable-profilingr=6h>j6hDhEhFjJhH}r>6(hM]r?6Xcfg-flag---enable-profilingr@6ahL]hJ]hK]hP]jN‰uhRNhShhT]rA6(j7)rB6}rC6(h=Uh>j;6hDhEhFj:hH}rD6(hM]hL]hJ]hK]hP]Uentries]rE6(jTX(--enable-profiling; cabal project optionj@6UNtrF6auhRNhShhT]ubjV)rG6}rH6(h=j=6h>j;6hDhEhFjZhH}rI6(jjhM]hL]hJ]hK]hP]uhRNhShhT]rJ6h]X--enable-profilingrK6…rL6}rM6(h=UhDNhRNhShh>jG6ubaubj`)rN6}rO6(h=U h>j;6hDhEhFjdhH}rP6(jjhM]hL]hJ]hK]hP]uhRNhShhT]rQ6h]X …rR6}rS6(h=UhDNhRNhShh>jN6ubaubeubjG)rT6}rU6(h=X--disable-profilingrV6h>j6hDhEhFjJhH}rW6(hM]rX6Xcfg-flag---disable-profilingrY6ahL]hJ]hK]hP]jN‰uhRNhShhT]rZ6(j7)r[6}r\6(h=Uh>jT6hDhEhFj:hH}r]6(hM]hL]hJ]hK]hP]Uentries]r^6(jTX)--disable-profiling; cabal project optionjY6UNtr_6auhRNhShhT]ubjV)r`6}ra6(h=jV6h>jT6hDhEhFjZhH}rb6(jjhM]hL]hJ]hK]hP]uhRNhShhT]rc6h]X--disable-profilingrd6…re6}rf6(h=UhDNhRNhShh>j`6ubaubj`)rg6}rh6(h=U h>jT6hDhEhFjdhH}ri6(jjhM]hL]hJ]hK]hP]uhRNhShhT]rj6h]X …rk6}rl6(h=UhDNhRNhShh>jg6ubaubeubjs)rm6}rn6(h=Uh>j6hDhEhFjvhH}ro6(hJ]hK]hL]hM]hP]uhRNhShhT]rp6(jy)rq6}rr6(h=Uh>jm6hDhEhFj|hH}rs6(hJ]hK]hL]hM]hP]uhRNhShhT]rt6(j)ru6}rv6(h=Uh>jq6hDhEhFjžhH}rw6(hJ]hK]hL]hM]hP]uhRNhShhT]rx6(j„)ry6}rz6(h=j2h>ju6hDhEhFj‡hH}r{6(hJ]hK]hL]hM]hP]uhRKhT]r|6h]XSincer}6…r~6}r6(h=Uh>jy6ubaubj)r€6}r6(h=U Cabal 1.22r‚6hH}rƒ6(hJ]hK]hL]hM]hP]uh>ju6hT]r„6hp)r…6}r†6(h=j‚6hH}r‡6(hJ]hK]hL]hM]hP]uh>j€6hT]rˆ6h]X Cabal 1.22r‰6…rŠ6}r‹6(h=Uh>j…6ubahFhtubahFjubeubj)rŒ6}r6(h=UhH}rŽ6(hJ]hK]hL]hM]hP]uh>jq6hT]r6(j„)r6}r‘6(h=X Default valueh>jŒ6hDhEhFj‡hH}r’6(hJ]hK]hL]hM]hP]uhRKhT]r“6h]X Default valuer”6…r•6}r–6(h=Uh>j6ubaubj)r—6}r˜6(h=UhH}r™6(hJ]hK]hL]hM]hP]uh>jŒ6hT]rš6hp)r›6}rœ6(h=XFalsehH}r6(hJ]hK]hL]hM]hP]uh>j—6hT]rž6h]XFalserŸ6…r 6}r¡6(h=XFalsehDNhRNhShh>j›6ubahFhtubahFjubehFjžubeubhp)r¢6}r£6(h=X?Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). It is only necessary to specify :cfg-field:`profiling` for the specific package you want to profile; ``cabal v2-build`` will ensure that all of its transitive dependencies are built with profiling enabled.h>jm6hDhEhFhthH}r¤6(hJ]hK]hL]hM]hP]uhRMehShhT]r¥6(h]X’Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). It is only necessary to specify r¦6…r§6}r¨6(h=X’Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). It is only necessary to specify hDNhRNhShh>j¢6ubjä)r©6}rª6(h=X:cfg-field:`profiling`h>j¢6hDhEhFjçhH}r«6(UreftypeX cfg-fieldjéˆjêX profilingr¬6U refdomainXcabalr­6hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMehT]r®6h–)r¯6}r°6(h=j¬6hH}r±6(hJ]hK]r²6(jôj­6Xcabal-cfg-fieldr³6ehL]hM]hP]uh>j©6hT]r´6h]X profilingrµ6…r¶6}r·6(h=Uh>j¯6ubahFhžubaubh]X/ for the specific package you want to profile; r¸6…r¹6}rº6(h=X/ for the specific package you want to profile; hDNhRNhShh>j¢6ubh–)r»6}r¼6(h=X``cabal v2-build``hH}r½6(hJ]hK]hL]hM]hP]uh>j¢6hT]r¾6h]Xcabal v2-buildr¿6…rÀ6}rÁ6(h=Xcabal v2-buildh>j»6ubahFhžubh]XV will ensure that all of its transitive dependencies are built with profiling enabled.rÂ6…rÃ6}rÄ6(h=XV will ensure that all of its transitive dependencies are built with profiling enabled.hDNhRNhShh>j¢6ubeubhp)rÅ6}rÆ6(h=X€To enable profiling for only libraries or executables, see :cfg-field:`library-profiling` and :cfg-field:`executable-profiling`.h>jm6hDhEhFhthH}rÇ6(hJ]hK]hL]hM]hP]uhRMkhShhT]rÈ6(h]X;To enable profiling for only libraries or executables, see rÉ6…rÊ6}rË6(h=X;To enable profiling for only libraries or executables, see hDNhRNhShh>jÅ6ubjä)rÌ6}rÍ6(h=X:cfg-field:`library-profiling`h>jÅ6hDhEhFjçhH}rÎ6(UreftypeX cfg-fieldjéˆjêXlibrary-profilingrÏ6U refdomainXcabalrÐ6hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMkhT]rÑ6h–)rÒ6}rÓ6(h=jÏ6hH}rÔ6(hJ]hK]rÕ6(jôjÐ6Xcabal-cfg-fieldrÖ6ehL]hM]hP]uh>jÌ6hT]r×6h]Xlibrary-profilingrØ6…rÙ6}rÚ6(h=Uh>jÒ6ubahFhžubaubh]X and rÛ6…rÜ6}rÝ6(h=X and hDNhRNhShh>jÅ6ubjä)rÞ6}rß6(h=X!:cfg-field:`executable-profiling`h>jÅ6hDhEhFjçhH}rà6(UreftypeX cfg-fieldjéˆjêXexecutable-profilingrá6U refdomainXcabalrâ6hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMkhT]rã6h–)rä6}rå6(h=já6hH}ræ6(hJ]hK]rç6(jôjâ6Xcabal-cfg-fieldrè6ehL]hM]hP]uh>jÞ6hT]ré6h]Xexecutable-profilingrê6…rë6}rì6(h=Uh>jä6ubahFhžubaubh]X.…rí6}rî6(h=X.hDNhRNhShh>jÅ6ubeubhp)rï6}rð6(h=X‚For useful profiling, it can be important to control precisely what cost centers are allocated; see :cfg-field:`profiling-detail`.h>jm6hDhEhFhthH}rñ6(hJ]hK]hL]hM]hP]uhRMnhShhT]rò6(h]XdFor useful profiling, it can be important to control precisely what cost centers are allocated; see ró6…rô6}rõ6(h=XdFor useful profiling, it can be important to control precisely what cost centers are allocated; see hDNhRNhShh>jï6ubjä)rö6}r÷6(h=X:cfg-field:`profiling-detail`h>jï6hDhEhFjçhH}rø6(UreftypeX cfg-fieldjéˆjêXprofiling-detailrù6U refdomainXcabalrú6hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMnhT]rû6h–)rü6}rý6(h=jù6hH}rþ6(hJ]hK]rÿ6(jôjú6Xcabal-cfg-fieldr7ehL]hM]hP]uh>jö6hT]r7h]Xprofiling-detailr7…r7}r7(h=Uh>jü6ubahFhžubaubh]X.…r7}r7(h=X.hDNhRNhShh>jï6ubeubhp)r7}r7(h=X\The command line variant of this flag is ``--enable-profiling`` and ``--disable-profiling``.h>jm6hDhEhFhthH}r 7(hJ]hK]hL]hM]hP]uhRMqhShhT]r 7(h]X)The command line variant of this flag is r 7…r 7}r 7(h=X)The command line variant of this flag is hDNhRNhShh>j7ubh–)r7}r7(h=X``--enable-profiling``hH}r7(hJ]hK]hL]hM]hP]uh>j7hT]r7h]X--enable-profilingr7…r7}r7(h=X--enable-profilingh>j7ubahFhžubh]X and r7…r7}r7(h=X and hDNhRNhShh>j7ubh–)r7}r7(h=X``--disable-profiling``hH}r7(hJ]hK]hL]hM]hP]uh>j7hT]r7h]X--disable-profilingr7…r7}r7(h=X--disable-profilingh>j7ubahFhžubh]X.…r7}r 7(h=X.hDNhRNhShh>j7ubeubeubeubj7)r!7}r"7(h=Uh>jf hDhEhFj:hH}r#7(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r$7}r%7(h=Uh>jf hDhEhFj?hH}r&7(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr'7jEj'7uhRNhShhT]r(7(jG)r)7}r*7(h=Xprofiling-detail: levelh>j$7hDhEhFjJhH}r+7(hM]r,7Xcfg-field-profiling-detailr-7ahL]hJ]hK]hP]jN‰uhRNhShhT]r.7(j7)r/7}r07(h=Uh>j)7hDhEhFj:hH}r17(hM]hL]hJ]hK]hP]Uentries]r27(jTX'profiling-detail ; cabal project optionj-7UNtr37auhRNhShhT]ubjV)r47}r57(h=Xprofiling-detailr67h>j)7hDhEhFjZhH}r77(jjhM]hL]hJ]hK]hP]uhRNhShhT]r87h]Xprofiling-detailr97…r:7}r;7(h=UhDNhRNhShh>j47ubaubj`)r<7}r=7(h=jch>j)7hDhEhFjdhH}r>7(jjhM]hL]hJ]hK]hP]uhRNhShhT]r?7h]X: r@7…rA7}rB7(h=UhDNhRNhShh>j<7ubaubjj)rC7}rD7(h=Xlevelh>j)7hDhEhFjmhH}rE7(jjhM]hL]hJ]hK]hP]uhRNhShhT]rF7h]XlevelrG7…rH7}rI7(h=UhDNhRNhShh>jC7ubaubeubjG)rJ7}rK7(h=X--profiling-detail=levelh>j$7hDhEhFjJhH}rL7(hM]rM7Xcfg-flag---profiling-detailrN7ahL]hJ]hK]hP]jN‰uhRNhShhT]rO7(j7)rP7}rQ7(h=Uh>jJ7hDhEhFj:hH}rR7(hM]hL]hJ]hK]hP]Uentries]rS7(jTX(--profiling-detail; cabal project optionjN7UNtrT7auhRNhShhT]ubjV)rU7}rV7(h=X--profiling-detailrW7h>jJ7hDhEhFjZhH}rX7(jjhM]hL]hJ]hK]hP]uhRNhShhT]rY7h]X--profiling-detailrZ7…r[7}r\7(h=UhDNhRNhShh>jU7ubaubj`)r]7}r^7(h=X=levelh>jJ7hDhEhFjdhH}r_7(jjhM]hL]hJ]hK]hP]uhRNhShhT]r`7h]X=levelra7…rb7}rc7(h=UhDNhRNhShh>j]7ubaubeubjs)rd7}re7(h=Uh>j$7hDhEhFjvhH}rf7(hJ]hK]hL]hM]hP]uhRNhShhT]rg7(jy)rh7}ri7(h=Uh>jd7hDhEhFj|hH}rj7(hJ]hK]hL]hM]hP]uhRNhShhT]rk7j)rl7}rm7(h=Uh>jh7hDhEhFjžhH}rn7(hJ]hK]hL]hM]hP]uhRNhShhT]ro7(j„)rp7}rq7(h=j2h>jl7hDhEhFj‡hH}rr7(hJ]hK]hL]hM]hP]uhRKhT]rs7h]XSincert7…ru7}rv7(h=Uh>jp7ubaubj)rw7}rx7(h=U Cabal 1.24ry7hH}rz7(hJ]hK]hL]hM]hP]uh>jl7hT]r{7hp)r|7}r}7(h=jy7hH}r~7(hJ]hK]hL]hM]hP]uh>jw7hT]r7h]X Cabal 1.24r€7…r7}r‚7(h=Uh>j|7ubahFhtubahFjubeubaubhp)rƒ7}r„7(h=XGSome compilers that support profiling, notably GHC, can allocate costs to different parts of the program and there are different levels of granularity or detail with which this can be done. In particular for GHC this concept is called "cost centers", and GHC can automatically add cost centers, and can do so in different ways.r…7h>jd7hDhEhFhthH}r†7(hJ]hK]hL]hM]hP]uhRMyhShhT]r‡7h]XKSome compilers that support profiling, notably GHC, can allocate costs to different parts of the program and there are different levels of granularity or detail with which this can be done. In particular for GHC this concept is called “cost centersâ€, and GHC can automatically add cost centers, and can do so in different ways.rˆ7…r‰7}rŠ7(h=j…7hDNhRNhShh>jƒ7ubaubhp)r‹7}rŒ7(h=XqThis flag covers both libraries and executables, but can be overridden by the ``library-profiling-detail`` field.h>jd7hDhEhFhthH}r7(hJ]hK]hL]hM]hP]uhRMhShhT]rŽ7(h]XNThis flag covers both libraries and executables, but can be overridden by the r7…r7}r‘7(h=XNThis flag covers both libraries and executables, but can be overridden by the hDNhRNhShh>j‹7ubh–)r’7}r“7(h=X``library-profiling-detail``hH}r”7(hJ]hK]hL]hM]hP]uh>j‹7hT]r•7h]Xlibrary-profiling-detailr–7…r—7}r˜7(h=Xlibrary-profiling-detailh>j’7ubahFhžubh]X field.r™7…rš7}r›7(h=X field.hDNhRNhShh>j‹7ubeubhp)rœ7}r7(h=XmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:rž7h>jd7hDhEhFhthH}rŸ7(hJ]hK]hL]hM]hP]uhRM‚hShhT]r 7h]XmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:r¡7…r¢7}r£7(h=jž7hDNhRNhShh>jœ7ubaubj)r¤7}r¥7(h=Uh>jd7hDhEhFj…hH}r¦7(hJ]hK]hL]hM]hP]uhRNhShhT]r§7(j)r¨7}r©7(h=Xjdefault For GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.h>j¤7hDhEhFjhH}rª7(hJ]hK]hL]hM]hP]uhRM†hT]r«7(j )r¬7}r­7(h=Xdefaultr®7h>j¨7hDhEhFjhH}r¯7(hJ]hK]hL]hM]hP]uhRM†hT]r°7h]Xdefaultr±7…r²7}r³7(h=j®7h>j¬7ubaubj)r´7}rµ7(h=UhH}r¶7(hJ]hK]hL]hM]hP]uh>j¨7hT]r·7hp)r¸7}r¹7(h=XbFor GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.h>j´7hDhEhFhthH}rº7(hJ]hK]hL]hM]hP]uhRM†hT]r»7(h]XFor GHC this uses r¼7…r½7}r¾7(h=XFor GHC this uses h>j¸7ubh–)r¿7}rÀ7(h=X``exported-functions``hH}rÁ7(hJ]hK]hL]hM]hP]uh>j¸7hT]rÂ7h]Xexported-functionsrÃ7…rÄ7}rÅ7(h=Xexported-functionsh>j¿7ubahFhžubh]X for libraries and rÆ7…rÇ7}rÈ7(h=X for libraries and h>j¸7ubh–)rÉ7}rÊ7(h=X``toplevel-functions``hH}rË7(hJ]hK]hL]hM]hP]uh>j¸7hT]rÌ7h]Xtoplevel-functionsrÍ7…rÎ7}rÏ7(h=Xtoplevel-functionsh>jÉ7ubahFhžubh]X for executables.rÐ7…rÑ7}rÒ7(h=X for executables.h>j¸7ubeubahFj„ubeubj)rÓ7}rÔ7(h=XAnone No costs will be assigned to any code within this component.h>j¤7hDhEhFjhH}rÕ7(hJ]hK]hL]hM]hP]uhRMˆhShhT]rÖ7(j )r×7}rØ7(h=XnonerÙ7h>jÓ7hDhEhFjhH}rÚ7(hJ]hK]hL]hM]hP]uhRMˆhT]rÛ7h]XnonerÜ7…rÝ7}rÞ7(h=jÙ7h>j×7ubaubj)rß7}rà7(h=UhH}rá7(hJ]hK]hL]hM]hP]uh>jÓ7hT]râ7hp)rã7}rä7(h=X<No costs will be assigned to any code within this component.rå7h>jß7hDhEhFhthH}ræ7(hJ]hK]hL]hM]hP]uhRM‰hT]rç7h]X<No costs will be assigned to any code within this component.rè7…ré7}rê7(h=jå7h>jã7ubaubahFj„ubeubj)rë7}rì7(h=XÆexported-functions Costs will be assigned at the granularity of all top level functions exported from each module. In GHC, this is for non-inline functions. Corresponds to ``-fprof-auto-exported``.h>j¤7hDhEhFjhH}rí7(hJ]hK]hL]hM]hP]uhRMŒhShhT]rî7(j )rï7}rð7(h=Xexported-functionsrñ7h>jë7hDhEhFjhH}rò7(hJ]hK]hL]hM]hP]uhRMŒhT]ró7h]Xexported-functionsrô7…rõ7}rö7(h=jñ7h>jï7ubaubj)r÷7}rø7(h=UhH}rù7(hJ]hK]hL]hM]hP]uh>jë7hT]rú7hp)rû7}rü7(h=X³Costs will be assigned at the granularity of all top level functions exported from each module. In GHC, this is for non-inline functions. Corresponds to ``-fprof-auto-exported``.h>j÷7hDhEhFhthH}rý7(hJ]hK]hL]hM]hP]uhRM‹hT]rþ7(h]XšCosts will be assigned at the granularity of all top level functions exported from each module. In GHC, this is for non-inline functions. Corresponds to rÿ7…r8}r8(h=XšCosts will be assigned at the granularity of all top level functions exported from each module. In GHC, this is for non-inline functions. Corresponds to h>jû7ubh–)r8}r8(h=X``-fprof-auto-exported``hH}r8(hJ]hK]hL]hM]hP]uh>jû7hT]r8h]X-fprof-auto-exportedr8…r8}r8(h=X-fprof-auto-exportedh>j8ubahFhžubh]X.…r 8}r 8(h=X.h>jû7ubeubahFj„ubeubj)r 8}r 8(h=Xõtoplevel-functions Costs will be assigned at the granularity of all top level functions in each module, whether they are exported from the module or not. In GHC specifically, this is for non-inline functions. Corresponds to ``-fprof-auto-top``.h>j¤7hDhEhFjhH}r 8(hJ]hK]hL]hM]hP]uhRM‘hShhT]r8(j )r8}r8(h=Xtoplevel-functionsr8h>j 8hDhEhFjhH}r8(hJ]hK]hL]hM]hP]uhRM‘hT]r8h]Xtoplevel-functionsr8…r8}r8(h=j8h>j8ubaubj)r8}r8(h=UhH}r8(hJ]hK]hL]hM]hP]uh>j 8hT]r8hp)r8}r8(h=XâCosts will be assigned at the granularity of all top level functions in each module, whether they are exported from the module or not. In GHC specifically, this is for non-inline functions. Corresponds to ``-fprof-auto-top``.h>j8hDhEhFhthH}r8(hJ]hK]hL]hM]hP]uhRMhT]r8(h]XÎCosts will be assigned at the granularity of all top level functions in each module, whether they are exported from the module or not. In GHC specifically, this is for non-inline functions. Corresponds to r8…r 8}r!8(h=XÎCosts will be assigned at the granularity of all top level functions in each module, whether they are exported from the module or not. In GHC specifically, this is for non-inline functions. Corresponds to h>j8ubh–)r"8}r#8(h=X``-fprof-auto-top``hH}r$8(hJ]hK]hL]hM]hP]uh>j8hT]r%8h]X-fprof-auto-topr&8…r'8}r(8(h=X-fprof-auto-toph>j"8ubahFhžubh]X.…r)8}r*8(h=X.h>j8ubeubahFj„ubeubj)r+8}r,8(h=Xïall-functions Costs will be assigned at the granularity of all functions in each module, whether top level or local. In GHC specifically, this is for non-inline toplevel or where-bound functions or values. Corresponds to ``-fprof-auto``. h>j¤7hDhEhFjhH}r-8(hJ]hK]hL]hM]hP]uhRM—hShhT]r.8(j )r/8}r08(h=X all-functionsr18h>j+8hDhEhFjhH}r28(hJ]hK]hL]hM]hP]uhRM—hT]r38h]X all-functionsr48…r58}r68(h=j18h>j/8ubaubj)r78}r88(h=UhH}r98(hJ]hK]hL]hM]hP]uh>j+8hT]r:8hp)r;8}r<8(h=XàCosts will be assigned at the granularity of all functions in each module, whether top level or local. In GHC specifically, this is for non-inline toplevel or where-bound functions or values. Corresponds to ``-fprof-auto``.h>j78hDhEhFhthH}r=8(hJ]hK]hL]hM]hP]uhRM”hT]r>8(h]XÐCosts will be assigned at the granularity of all functions in each module, whether top level or local. In GHC specifically, this is for non-inline toplevel or where-bound functions or values. Corresponds to r?8…r@8}rA8(h=XÐCosts will be assigned at the granularity of all functions in each module, whether top level or local. In GHC specifically, this is for non-inline toplevel or where-bound functions or values. Corresponds to h>j;8ubh–)rB8}rC8(h=X``-fprof-auto``hH}rD8(hJ]hK]hL]hM]hP]uh>j;8hT]rE8h]X -fprof-autorF8…rG8}rH8(h=X -fprof-autoh>jB8ubahFhžubh]X.…rI8}rJ8(h=X.h>j;8ubeubahFj„ubeubeubhp)rK8}rL8(h=XEThe command line variant of this flag is ``--profiling-detail=none``.h>jd7hDhEhFhthH}rM8(hJ]hK]hL]hM]hP]uhRM™hShhT]rN8(h]X)The command line variant of this flag is rO8…rP8}rQ8(h=X)The command line variant of this flag is hDNhRNhShh>jK8ubh–)rR8}rS8(h=X``--profiling-detail=none``hH}rT8(hJ]hK]hL]hM]hP]uh>jK8hT]rU8h]X--profiling-detail=nonerV8…rW8}rX8(h=X--profiling-detail=noneh>jR8ubahFhžubh]X.…rY8}rZ8(h=X.hDNhRNhShh>jK8ubeubeubeubj7)r[8}r\8(h=Uh>jf hDhEhFj:hH}r]8(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r^8}r_8(h=Uh>jf hDhEhFj?hH}r`8(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldra8jEja8uhRNhShhT]rb8(jG)rc8}rd8(h=Xlibrary-profiling-detail: levelh>j^8hDhEhFjJhH}re8(hM]rf8X"cfg-field-library-profiling-detailrg8ahL]hJ]hK]hP]jN‰uhRNhShhT]rh8(j7)ri8}rj8(h=Uh>jc8hDhEhFj:hH}rk8(hM]hL]hJ]hK]hP]Uentries]rl8(jTX/library-profiling-detail ; cabal project optionjg8UNtrm8auhRNhShhT]ubjV)rn8}ro8(h=Xlibrary-profiling-detailrp8h>jc8hDhEhFjZhH}rq8(jjhM]hL]hJ]hK]hP]uhRNhShhT]rr8h]Xlibrary-profiling-detailrs8…rt8}ru8(h=UhDNhRNhShh>jn8ubaubj`)rv8}rw8(h=jch>jc8hDhEhFjdhH}rx8(jjhM]hL]hJ]hK]hP]uhRNhShhT]ry8h]X: rz8…r{8}r|8(h=UhDNhRNhShh>jv8ubaubjj)r}8}r~8(h=Xlevelh>jc8hDhEhFjmhH}r8(jjhM]hL]hJ]hK]hP]uhRNhShhT]r€8h]Xlevelr8…r‚8}rƒ8(h=UhDNhRNhShh>j}8ubaubeubjG)r„8}r…8(h=X --library-profiling-detail=levelh>j^8hDhEhFjJhH}r†8(hM]r‡8X#cfg-flag---library-profiling-detailrˆ8ahL]hJ]hK]hP]jN‰uhRNhShhT]r‰8(j7)rŠ8}r‹8(h=Uh>j„8hDhEhFj:hH}rŒ8(hM]hL]hJ]hK]hP]Uentries]r8(jTX0--library-profiling-detail; cabal project optionjˆ8UNtrŽ8auhRNhShhT]ubjV)r8}r8(h=X--library-profiling-detailr‘8h>j„8hDhEhFjZhH}r’8(jjhM]hL]hJ]hK]hP]uhRNhShhT]r“8h]X--library-profiling-detailr”8…r•8}r–8(h=UhDNhRNhShh>j8ubaubj`)r—8}r˜8(h=X=levelh>j„8hDhEhFjdhH}r™8(jjhM]hL]hJ]hK]hP]uhRNhShhT]rš8h]X=levelr›8…rœ8}r8(h=UhDNhRNhShh>j—8ubaubeubjs)rž8}rŸ8(h=Uh>j^8hDhEhFjvhH}r 8(hJ]hK]hL]hM]hP]uhRNhShhT]r¡8(jy)r¢8}r£8(h=Uh>jž8hDhEhFj|hH}r¤8(hJ]hK]hL]hM]hP]uhRNhShhT]r¥8j)r¦8}r§8(h=Uh>j¢8hDhEhFjžhH}r¨8(hJ]hK]hL]hM]hP]uhRNhShhT]r©8(j„)rª8}r«8(h=j2h>j¦8hDhEhFj‡hH}r¬8(hJ]hK]hL]hM]hP]uhRKhT]r­8h]XSincer®8…r¯8}r°8(h=Uh>jª8ubaubj)r±8}r²8(h=U Cabal 1.24r³8hH}r´8(hJ]hK]hL]hM]hP]uh>j¦8hT]rµ8hp)r¶8}r·8(h=j³8hH}r¸8(hJ]hK]hL]hM]hP]uh>j±8hT]r¹8h]X Cabal 1.24rº8…r»8}r¼8(h=Uh>j¶8ubahFhtubahFjubeubaubhp)r½8}r¾8(h=XALike :cfg-field:`profiling-detail`, but applied only to librariesh>jž8hDhEhFhthH}r¿8(hJ]hK]hL]hM]hP]uhRM¡hShhT]rÀ8(h]XLike rÁ8…rÂ8}rÃ8(h=XLike hDNhRNhShh>j½8ubjä)rÄ8}rÅ8(h=X:cfg-field:`profiling-detail`h>j½8hDhEhFjçhH}rÆ8(UreftypeX cfg-fieldjéˆjêXprofiling-detailrÇ8U refdomainXcabalrÈ8hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM¡hT]rÉ8h–)rÊ8}rË8(h=jÇ8hH}rÌ8(hJ]hK]rÍ8(jôjÈ8Xcabal-cfg-fieldrÎ8ehL]hM]hP]uh>jÄ8hT]rÏ8h]Xprofiling-detailrÐ8…rÑ8}rÒ8(h=Uh>jÊ8ubahFhžubaubh]X, but applied only to librariesrÓ8…rÔ8}rÕ8(h=X, but applied only to librarieshDNhRNhShh>j½8ubeubhp)rÖ8}r×8(h=XMThe command line variant of this flag is ``--library-profiling-detail=none``.h>jž8hDhEhFhthH}rØ8(hJ]hK]hL]hM]hP]uhRM£hShhT]rÙ8(h]X)The command line variant of this flag is rÚ8…rÛ8}rÜ8(h=X)The command line variant of this flag is hDNhRNhShh>jÖ8ubh–)rÝ8}rÞ8(h=X#``--library-profiling-detail=none``hH}rß8(hJ]hK]hL]hM]hP]uh>jÖ8hT]rà8h]X--library-profiling-detail=nonerá8…râ8}rã8(h=X--library-profiling-detail=noneh>jÝ8ubahFhžubh]X.…rä8}rå8(h=X.hDNhRNhShh>jÖ8ubeubeubeubj7)ræ8}rç8(h=Uh>jf hDhEhFj:hH}rè8(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)ré8}rê8(h=Uh>jf hDhEhFj?hH}rë8(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrì8jEjì8uhRNhShhT]rí8(jG)rî8}rï8(h=Xlibrary-vanilla: booleanh>jé8hDhEhFjJhH}rð8(hM]rñ8Xcfg-field-library-vanillarò8ahL]hJ]hK]hP]jN‰uhRNhShhT]ró8(j7)rô8}rõ8(h=Uh>jî8hDhEhFj:hH}rö8(hM]hL]hJ]hK]hP]Uentries]r÷8(jTX&library-vanilla ; cabal project optionjò8UNtrø8auhRNhShhT]ubjV)rù8}rú8(h=Xlibrary-vanillarû8h>jî8hDhEhFjZhH}rü8(jjhM]hL]hJ]hK]hP]uhRNhShhT]rý8h]Xlibrary-vanillarþ8…rÿ8}r9(h=UhDNhRNhShh>jù8ubaubj`)r9}r9(h=jch>jî8hDhEhFjdhH}r9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r9h]X: r9…r9}r9(h=UhDNhRNhShh>j9ubaubjj)r9}r 9(h=Xbooleanh>jî8hDhEhFjmhH}r 9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r 9h]Xbooleanr 9…r 9}r9(h=UhDNhRNhShh>j9ubaubeubjG)r9}r9(h=X--enable-library-vanillar9h>jé8hDhEhFjJhH}r9(hM]r9X!cfg-flag---enable-library-vanillar9ahL]hJ]hK]hP]jN‰uhRNhShhT]r9(j7)r9}r9(h=Uh>j9hDhEhFj:hH}r9(hM]hL]hJ]hK]hP]Uentries]r9(jTX.--enable-library-vanilla; cabal project optionj9UNtr9auhRNhShhT]ubjV)r9}r9(h=j9h>j9hDhEhFjZhH}r9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r9h]X--enable-library-vanillar9…r 9}r!9(h=UhDNhRNhShh>j9ubaubj`)r"9}r#9(h=U h>j9hDhEhFjdhH}r$9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r%9h]X …r&9}r'9(h=UhDNhRNhShh>j"9ubaubeubjG)r(9}r)9(h=X--disable-library-vanillar*9h>jé8hDhEhFjJhH}r+9(hM]r,9X"cfg-flag---disable-library-vanillar-9ahL]hJ]hK]hP]jN‰uhRNhShhT]r.9(j7)r/9}r09(h=Uh>j(9hDhEhFj:hH}r19(hM]hL]hJ]hK]hP]Uentries]r29(jTX/--disable-library-vanilla; cabal project optionj-9UNtr39auhRNhShhT]ubjV)r49}r59(h=j*9h>j(9hDhEhFjZhH}r69(jjhM]hL]hJ]hK]hP]uhRNhShhT]r79h]X--disable-library-vanillar89…r99}r:9(h=UhDNhRNhShh>j49ubaubj`)r;9}r<9(h=U h>j(9hDhEhFjdhH}r=9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r>9h]X …r?9}r@9(h=UhDNhRNhShh>j;9ubaubeubjs)rA9}rB9(h=Uh>jé8hDhEhFjvhH}rC9(hJ]hK]hL]hM]hP]uhRNhShhT]rD9(jy)rE9}rF9(h=Uh>jA9hDhEhFj|hH}rG9(hJ]hK]hL]hM]hP]uhRNhShhT]rH9j)rI9}rJ9(h=UhH}rK9(hJ]hK]hL]hM]hP]uh>jE9hT]rL9(j„)rM9}rN9(h=X Default valueh>jI9hDhEhFj‡hH}rO9(hJ]hK]hL]hM]hP]uhRKhT]rP9h]X Default valuerQ9…rR9}rS9(h=Uh>jM9ubaubj)rT9}rU9(h=UhH}rV9(hJ]hK]hL]hM]hP]uh>jI9hT]rW9hp)rX9}rY9(h=XTruehH}rZ9(hJ]hK]hL]hM]hP]uh>jT9hT]r[9h]XTruer\9…r]9}r^9(h=XTruehDNhRNhShh>jX9ubahFhtubahFjubehFjžubaubhp)r_9}r`9(h=XœBuild ordinary libraries (as opposed to profiling libraries). Mostly, you can set this to False to avoid building ordinary libraries when you are profiling.ra9h>jA9hDhEhFhthH}rb9(hJ]hK]hL]hM]hP]uhRM­hShhT]rc9h]XœBuild ordinary libraries (as opposed to profiling libraries). Mostly, you can set this to False to avoid building ordinary libraries when you are profiling.rd9…re9}rf9(h=ja9hDNhRNhShh>j_9ubaubhp)rg9}rh9(h=XhThe command line variant of this flag is ``--enable-library-vanilla`` and ``--disable-library-vanilla``.h>jA9hDhEhFhthH}ri9(hJ]hK]hL]hM]hP]uhRM±hShhT]rj9(h]X)The command line variant of this flag is rk9…rl9}rm9(h=X)The command line variant of this flag is hDNhRNhShh>jg9ubh–)rn9}ro9(h=X``--enable-library-vanilla``hH}rp9(hJ]hK]hL]hM]hP]uh>jg9hT]rq9h]X--enable-library-vanillarr9…rs9}rt9(h=X--enable-library-vanillah>jn9ubahFhžubh]X and ru9…rv9}rw9(h=X and hDNhRNhShh>jg9ubh–)rx9}ry9(h=X``--disable-library-vanilla``hH}rz9(hJ]hK]hL]hM]hP]uh>jg9hT]r{9h]X--disable-library-vanillar|9…r}9}r~9(h=X--disable-library-vanillah>jx9ubahFhžubh]X.…r9}r€9(h=X.hDNhRNhShh>jg9ubeubeubeubj7)r9}r‚9(h=Uh>jf hDhEhFj:hH}rƒ9(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r„9}r…9(h=Uh>jf hDhEhFj?hH}r†9(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr‡9jEj‡9uhRNhShhT]rˆ9(jG)r‰9}rŠ9(h=Xlibrary-profiling: booleanh>j„9hDhEhFjJhH}r‹9(hM]rŒ9Xcfg-field-library-profilingr9ahL]hJ]hK]hP]jN‰uhRNhShhT]rŽ9(j7)r9}r9(h=Uh>j‰9hDhEhFj:hH}r‘9(hM]hL]hJ]hK]hP]Uentries]r’9(jTX(library-profiling ; cabal project optionj9UNtr“9auhRNhShhT]ubjV)r”9}r•9(h=Xlibrary-profilingr–9h>j‰9hDhEhFjZhH}r—9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r˜9h]Xlibrary-profilingr™9…rš9}r›9(h=UhDNhRNhShh>j”9ubaubj`)rœ9}r9(h=jch>j‰9hDhEhFjdhH}rž9(jjhM]hL]hJ]hK]hP]uhRNhShhT]rŸ9h]X: r 9…r¡9}r¢9(h=UhDNhRNhShh>jœ9ubaubjj)r£9}r¤9(h=Xbooleanh>j‰9hDhEhFjmhH}r¥9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¦9h]Xbooleanr§9…r¨9}r©9(h=UhDNhRNhShh>j£9ubaubeubjG)rª9}r«9(h=X--enable-library-profilingr¬9h>j„9hDhEhFjJhH}r­9(hM]r®9X#cfg-flag---enable-library-profilingr¯9ahL]hJ]hK]hP]jN‰uhRNhShhT]r°9(j7)r±9}r²9(h=Uh>jª9hDhEhFj:hH}r³9(hM]hL]hJ]hK]hP]Uentries]r´9(jTX0--enable-library-profiling; cabal project optionj¯9UNtrµ9auhRNhShhT]ubjV)r¶9}r·9(h=j¬9h>jª9hDhEhFjZhH}r¸9(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¹9h]X--enable-library-profilingrº9…r»9}r¼9(h=UhDNhRNhShh>j¶9ubaubj`)r½9}r¾9(h=U h>jª9hDhEhFjdhH}r¿9(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÀ9h]X …rÁ9}rÂ9(h=UhDNhRNhShh>j½9ubaubeubjG)rÃ9}rÄ9(h=X--disable-library-profilingrÅ9h>j„9hDhEhFjJhH}rÆ9(hM]rÇ9X$cfg-flag---disable-library-profilingrÈ9ahL]hJ]hK]hP]jN‰uhRNhShhT]rÉ9(j7)rÊ9}rË9(h=Uh>jÃ9hDhEhFj:hH}rÌ9(hM]hL]hJ]hK]hP]Uentries]rÍ9(jTX1--disable-library-profiling; cabal project optionjÈ9UNtrÎ9auhRNhShhT]ubjV)rÏ9}rÐ9(h=jÅ9h>jÃ9hDhEhFjZhH}rÑ9(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÒ9h]X--disable-library-profilingrÓ9…rÔ9}rÕ9(h=UhDNhRNhShh>jÏ9ubaubj`)rÖ9}r×9(h=U h>jÃ9hDhEhFjdhH}rØ9(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÙ9h]X …rÚ9}rÛ9(h=UhDNhRNhShh>jÖ9ubaubeubjs)rÜ9}rÝ9(h=Uh>j„9hDhEhFjvhH}rÞ9(hJ]hK]hL]hM]hP]uhRNhShhT]rß9(jy)rà9}rá9(h=Uh>jÜ9hDhEhFj|hH}râ9(hJ]hK]hL]hM]hP]uhRNhShhT]rã9(j)rä9}rå9(h=Uh>jà9hDhEhFjžhH}ræ9(hJ]hK]hL]hM]hP]uhRNhShhT]rç9(j„)rè9}ré9(h=j2h>jä9hDhEhFj‡hH}rê9(hJ]hK]hL]hM]hP]uhRKhT]rë9h]XSincerì9…rí9}rî9(h=Uh>jè9ubaubj)rï9}rð9(h=U Cabal 1.22rñ9hH}rò9(hJ]hK]hL]hM]hP]uh>jä9hT]ró9hp)rô9}rõ9(h=jñ9hH}rö9(hJ]hK]hL]hM]hP]uh>jï9hT]r÷9h]X Cabal 1.22rø9…rù9}rú9(h=Uh>jô9ubahFhtubahFjubeubj)rû9}rü9(h=UhH}rý9(hJ]hK]hL]hM]hP]uh>jà9hT]rþ9(j„)rÿ9}r:(h=X Default valueh>jû9hDhEhFj‡hH}r:(hJ]hK]hL]hM]hP]uhRKhT]r:h]X Default valuer:…r:}r:(h=Uh>jÿ9ubaubj)r:}r:(h=UhH}r:(hJ]hK]hL]hM]hP]uh>jû9hT]r :hp)r :}r :(h=XFalsehH}r :(hJ]hK]hL]hM]hP]uh>j:hT]r :h]XFalser:…r:}r:(h=XFalsehDNhRNhShh>j :ubahFhtubahFjubehFjžubeubhp)r:}r:(h=XaBuild libraries with profiling enabled. You probably want to use :cfg-field:`profiling` instead.h>jÜ9hDhEhFhthH}r:(hJ]hK]hL]hM]hP]uhRM¼hShhT]r:(h]XBBuild libraries with profiling enabled. You probably want to use r:…r:}r:(h=XBBuild libraries with profiling enabled. You probably want to use hDNhRNhShh>j:ubjä)r:}r:(h=X:cfg-field:`profiling`h>j:hDhEhFjçhH}r:(UreftypeX cfg-fieldjéˆjêX profilingr:U refdomainXcabalr:hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRM¼hT]r:h–)r:}r:(h=j:hH}r :(hJ]hK]r!:(jôj:Xcabal-cfg-fieldr":ehL]hM]hP]uh>j:hT]r#:h]X profilingr$:…r%:}r&:(h=Uh>j:ubahFhžubaubh]X instead.r':…r(:}r):(h=X instead.hDNhRNhShh>j:ubeubhp)r*:}r+:(h=XlThe command line variant of this flag is ``--enable-library-profiling`` and ``--disable-library-profiling``.h>jÜ9hDhEhFhthH}r,:(hJ]hK]hL]hM]hP]uhRM¿hShhT]r-:(h]X)The command line variant of this flag is r.:…r/:}r0:(h=X)The command line variant of this flag is hDNhRNhShh>j*:ubh–)r1:}r2:(h=X``--enable-library-profiling``hH}r3:(hJ]hK]hL]hM]hP]uh>j*:hT]r4:h]X--enable-library-profilingr5:…r6:}r7:(h=X--enable-library-profilingh>j1:ubahFhžubh]X and r8:…r9:}r::(h=X and hDNhRNhShh>j*:ubh–)r;:}r<:(h=X``--disable-library-profiling``hH}r=:(hJ]hK]hL]hM]hP]uh>j*:hT]r>:h]X--disable-library-profilingr?:…r@:}rA:(h=X--disable-library-profilingh>j;:ubahFhžubh]X.…rB:}rC:(h=X.hDNhRNhShh>j*:ubeubeubeubj7)rD:}rE:(h=Uh>jf hDhEhFj:hH}rF:(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rG:}rH:(h=Uh>jf hDhEhFj?hH}rI:(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrJ:jEjJ:uhRNhShhT]rK:(jG)rL:}rM:(h=Xexecutable-profiling: booleanh>jG:hDhEhFjJhH}rN:(hM]rO:Xcfg-field-executable-profilingrP:ahL]hJ]hK]hP]jN‰uhRNhShhT]rQ:(j7)rR:}rS:(h=Uh>jL:hDhEhFj:hH}rT:(hM]hL]hJ]hK]hP]Uentries]rU:(jTX+executable-profiling ; cabal project optionjP:UNtrV:auhRNhShhT]ubjV)rW:}rX:(h=Xexecutable-profilingrY:h>jL:hDhEhFjZhH}rZ:(jjhM]hL]hJ]hK]hP]uhRNhShhT]r[:h]Xexecutable-profilingr\:…r]:}r^:(h=UhDNhRNhShh>jW:ubaubj`)r_:}r`:(h=jch>jL:hDhEhFjdhH}ra:(jjhM]hL]hJ]hK]hP]uhRNhShhT]rb:h]X: rc:…rd:}re:(h=UhDNhRNhShh>j_:ubaubjj)rf:}rg:(h=Xbooleanh>jL:hDhEhFjmhH}rh:(jjhM]hL]hJ]hK]hP]uhRNhShhT]ri:h]Xbooleanrj:…rk:}rl:(h=UhDNhRNhShh>jf:ubaubeubjG)rm:}rn:(h=X--enable-executable-profilingro:h>jG:hDhEhFjJhH}rp:(hM]rq:X&cfg-flag---enable-executable-profilingrr:ahL]hJ]hK]hP]jN‰uhRNhShhT]rs:(j7)rt:}ru:(h=Uh>jm:hDhEhFj:hH}rv:(hM]hL]hJ]hK]hP]Uentries]rw:(jTX3--enable-executable-profiling; cabal project optionjr:UNtrx:auhRNhShhT]ubjV)ry:}rz:(h=jo:h>jm:hDhEhFjZhH}r{:(jjhM]hL]hJ]hK]hP]uhRNhShhT]r|:h]X--enable-executable-profilingr}:…r~:}r:(h=UhDNhRNhShh>jy:ubaubj`)r€:}r:(h=U h>jm:hDhEhFjdhH}r‚:(jjhM]hL]hJ]hK]hP]uhRNhShhT]rƒ:h]X …r„:}r…:(h=UhDNhRNhShh>j€:ubaubeubjG)r†:}r‡:(h=X--disable-executable-profilingrˆ:h>jG:hDhEhFjJhH}r‰:(hM]rŠ:X'cfg-flag---disable-executable-profilingr‹:ahL]hJ]hK]hP]jN‰uhRNhShhT]rŒ:(j7)r:}rŽ:(h=Uh>j†:hDhEhFj:hH}r:(hM]hL]hJ]hK]hP]Uentries]r:(jTX4--disable-executable-profiling; cabal project optionj‹:UNtr‘:auhRNhShhT]ubjV)r’:}r“:(h=jˆ:h>j†:hDhEhFjZhH}r”:(jjhM]hL]hJ]hK]hP]uhRNhShhT]r•:h]X--disable-executable-profilingr–:…r—:}r˜:(h=UhDNhRNhShh>j’:ubaubj`)r™:}rš:(h=U h>j†:hDhEhFjdhH}r›:(jjhM]hL]hJ]hK]hP]uhRNhShhT]rœ:h]X …r:}rž:(h=UhDNhRNhShh>j™:ubaubeubjs)rŸ:}r :(h=Uh>jG:hDhEhFjvhH}r¡:(hJ]hK]hL]hM]hP]uhRNhShhT]r¢:(jy)r£:}r¤:(h=Uh>jŸ:hDhEhFj|hH}r¥:(hJ]hK]hL]hM]hP]uhRNhShhT]r¦:(j)r§:}r¨:(h=Uh>j£:hDhEhFjžhH}r©:(hJ]hK]hL]hM]hP]uhRNhShhT]rª:(j„)r«:}r¬:(h=j2h>j§:hDhEhFj‡hH}r­:(hJ]hK]hL]hM]hP]uhRKhT]r®:h]XSincer¯:…r°:}r±:(h=Uh>j«:ubaubj)r²:}r³:(h=U Cabal 1.22r´:hH}rµ:(hJ]hK]hL]hM]hP]uh>j§:hT]r¶:hp)r·:}r¸:(h=j´:hH}r¹:(hJ]hK]hL]hM]hP]uh>j²:hT]rº:h]X Cabal 1.22r»:…r¼:}r½:(h=Uh>j·:ubahFhtubahFjubeubj)r¾:}r¿:(h=UhH}rÀ:(hJ]hK]hL]hM]hP]uh>j£:hT]rÁ:(j„)rÂ:}rÃ:(h=X Default valueh>j¾:hDhEhFj‡hH}rÄ:(hJ]hK]hL]hM]hP]uhRKhT]rÅ:h]X Default valuerÆ:…rÇ:}rÈ:(h=Uh>jÂ:ubaubj)rÉ:}rÊ:(h=UhH}rË:(hJ]hK]hL]hM]hP]uh>j¾:hT]rÌ:hp)rÍ:}rÎ:(h=XFalsehH}rÏ:(hJ]hK]hL]hM]hP]uh>jÉ:hT]rÐ:h]XFalserÑ:…rÒ:}rÓ:(h=XFalsehDNhRNhShh>jÍ:ubahFhtubahFjubehFjžubeubhp)rÔ:}rÕ:(h=XbBuild executables with profiling enabled. You probably want to use :cfg-field:`profiling` instead.h>jŸ:hDhEhFhthH}rÖ:(hJ]hK]hL]hM]hP]uhRMÊhShhT]r×:(h]XCBuild executables with profiling enabled. You probably want to use rØ:…rÙ:}rÚ:(h=XCBuild executables with profiling enabled. You probably want to use hDNhRNhShh>jÔ:ubjä)rÛ:}rÜ:(h=X:cfg-field:`profiling`h>jÔ:hDhEhFjçhH}rÝ:(UreftypeX cfg-fieldjéˆjêX profilingrÞ:U refdomainXcabalrß:hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÊhT]rà:h–)rá:}râ:(h=jÞ:hH}rã:(hJ]hK]rä:(jôjß:Xcabal-cfg-fieldrå:ehL]hM]hP]uh>jÛ:hT]ræ:h]X profilingrç:…rè:}ré:(h=Uh>já:ubahFhžubaubh]X instead.rê:…rë:}rì:(h=X instead.hDNhRNhShh>jÔ:ubeubhp)rí:}rî:(h=XrThe command line variant of this flag is ``--enable-executable-profiling`` and ``--disable-executable-profiling``.h>jŸ:hDhEhFhthH}rï:(hJ]hK]hL]hM]hP]uhRMÍhShhT]rð:(h]X)The command line variant of this flag is rñ:…rò:}ró:(h=X)The command line variant of this flag is hDNhRNhShh>jí:ubh–)rô:}rõ:(h=X!``--enable-executable-profiling``hH}rö:(hJ]hK]hL]hM]hP]uh>jí:hT]r÷:h]X--enable-executable-profilingrø:…rù:}rú:(h=X--enable-executable-profilingh>jô:ubahFhžubh]X and rû:…rü:}rý:(h=X and hDNhRNhShh>jí:ubh–)rþ:}rÿ:(h=X"``--disable-executable-profiling``hH}r;(hJ]hK]hL]hM]hP]uh>jí:hT]r;h]X--disable-executable-profilingr;…r;}r;(h=X--disable-executable-profilingh>jþ:ubahFhžubh]X.…r;}r;(h=X.hDNhRNhShh>jí:ubeubeubeubj7)r;}r;(h=Uh>jf hDhEhFj:hH}r ;(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r ;}r ;(h=Uh>jf hDhEhFj?hH}r ;(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr ;jEj ;uhRNhShhT]r;(jG)r;}r;(h=Xcoverage: booleanh>j ;hDhEhFjJhH}r;(hM]r;Xcfg-field-coverager;ahL]hJ]hK]hP]jN‰uhRNhShhT]r;(j7)r;}r;(h=Uh>j;hDhEhFj:hH}r;(hM]hL]hJ]hK]hP]Uentries]r;(jTXcoverage ; cabal project optionj;UNtr;auhRNhShhT]ubjV)r;}r;(h=Xcoverager;h>j;hDhEhFjZhH}r;(jjhM]hL]hJ]hK]hP]uhRNhShhT]r;h]Xcoverager;…r ;}r!;(h=UhDNhRNhShh>j;ubaubj`)r";}r#;(h=jch>j;hDhEhFjdhH}r$;(jjhM]hL]hJ]hK]hP]uhRNhShhT]r%;h]X: r&;…r';}r(;(h=UhDNhRNhShh>j";ubaubjj)r);}r*;(h=Xbooleanh>j;hDhEhFjmhH}r+;(jjhM]hL]hJ]hK]hP]uhRNhShhT]r,;h]Xbooleanr-;…r.;}r/;(h=UhDNhRNhShh>j);ubaubeubjG)r0;}r1;(h=X--enable-coverager2;h>j ;hDhEhFjJhH}r3;(hM]r4;Xcfg-flag---enable-coverager5;ahL]hJ]hK]hP]jN‰uhRNhShhT]r6;(j7)r7;}r8;(h=Uh>j0;hDhEhFj:hH}r9;(hM]hL]hJ]hK]hP]Uentries]r:;(jTX'--enable-coverage; cabal project optionj5;UNtr;;auhRNhShhT]ubjV)r<;}r=;(h=j2;h>j0;hDhEhFjZhH}r>;(jjhM]hL]hJ]hK]hP]uhRNhShhT]r?;h]X--enable-coverager@;…rA;}rB;(h=UhDNhRNhShh>j<;ubaubj`)rC;}rD;(h=U h>j0;hDhEhFjdhH}rE;(jjhM]hL]hJ]hK]hP]uhRNhShhT]rF;h]X …rG;}rH;(h=UhDNhRNhShh>jC;ubaubeubjG)rI;}rJ;(h=X--disable-coveragerK;h>j ;hDhEhFjJhH}rL;(hM]rM;Xcfg-flag---disable-coveragerN;ahL]hJ]hK]hP]jN‰uhRNhShhT]rO;(j7)rP;}rQ;(h=Uh>jI;hDhEhFj:hH}rR;(hM]hL]hJ]hK]hP]Uentries]rS;(jTX(--disable-coverage; cabal project optionjN;UNtrT;auhRNhShhT]ubjV)rU;}rV;(h=jK;h>jI;hDhEhFjZhH}rW;(jjhM]hL]hJ]hK]hP]uhRNhShhT]rX;h]X--disable-coveragerY;…rZ;}r[;(h=UhDNhRNhShh>jU;ubaubj`)r\;}r];(h=U h>jI;hDhEhFjdhH}r^;(jjhM]hL]hJ]hK]hP]uhRNhShhT]r_;h]X …r`;}ra;(h=UhDNhRNhShh>j\;ubaubeubjs)rb;}rc;(h=Uh>j ;hDhEhFjvhH}rd;(hJ]hK]hL]hM]hP]uhRNhShhT]re;(jy)rf;}rg;(h=Uh>jb;hDhEhFj|hH}rh;(hJ]hK]hL]hM]hP]uhRNhShhT]ri;(j)rj;}rk;(h=Uh>jf;hDhEhFjžhH}rl;(hJ]hK]hL]hM]hP]uhRNhShhT]rm;(j„)rn;}ro;(h=j2h>jj;hDhEhFj‡hH}rp;(hJ]hK]hL]hM]hP]uhRKhT]rq;h]XSincerr;…rs;}rt;(h=Uh>jn;ubaubj)ru;}rv;(h=U Cabal 1.22rw;hH}rx;(hJ]hK]hL]hM]hP]uh>jj;hT]ry;hp)rz;}r{;(h=jw;hH}r|;(hJ]hK]hL]hM]hP]uh>ju;hT]r};h]X Cabal 1.22r~;…r;}r€;(h=Uh>jz;ubahFhtubahFjubeubj)r;}r‚;(h=UhH}rƒ;(hJ]hK]hL]hM]hP]uh>jf;hT]r„;(j„)r…;}r†;(h=X Default valueh>j;hDhEhFj‡hH}r‡;(hJ]hK]hL]hM]hP]uhRKhT]rˆ;h]X Default valuer‰;…rŠ;}r‹;(h=Uh>j…;ubaubj)rŒ;}r;(h=UhH}rŽ;(hJ]hK]hL]hM]hP]uh>j;hT]r;hp)r;}r‘;(h=XFalsehH}r’;(hJ]hK]hL]hM]hP]uh>jŒ;hT]r“;h]XFalser”;…r•;}r–;(h=XFalsehDNhRNhShh>j;ubahFhtubahFjubehFjžubeubhp)r—;}r˜;(h=X­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.r™;h>jb;hDhEhFhthH}rš;(hJ]hK]hL]hM]hP]uhRMÜhShhT]r›;h]X­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.rœ;…r;}rž;(h=j™;hDNhRNhShh>j—;ubaubhp)rŸ;}r ;(h=XZThe command line variant of this flag is ``--enable-coverage`` and ``--disable-coverage``.h>jb;hDhEhFhthH}r¡;(hJ]hK]hL]hM]hP]uhRMàhShhT]r¢;(h]X)The command line variant of this flag is r£;…r¤;}r¥;(h=X)The command line variant of this flag is hDNhRNhShh>jŸ;ubh–)r¦;}r§;(h=X``--enable-coverage``hH}r¨;(hJ]hK]hL]hM]hP]uh>jŸ;hT]r©;h]X--enable-coveragerª;…r«;}r¬;(h=X--enable-coverageh>j¦;ubahFhžubh]X and r­;…r®;}r¯;(h=X and hDNhRNhShh>jŸ;ubh–)r°;}r±;(h=X``--disable-coverage``hH}r²;(hJ]hK]hL]hM]hP]uh>jŸ;hT]r³;h]X--disable-coverager´;…rµ;}r¶;(h=X--disable-coverageh>j°;ubahFhžubh]X.…r·;}r¸;(h=X.hDNhRNhShh>jŸ;ubeubeubeubj7)r¹;}rº;(h=Uh>jf hDhEhFj:hH}r»;(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r¼;}r½;(h=Uh>jf hDhEhFj?hH}r¾;(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr¿;jEj¿;uhRNhShhT]rÀ;(jG)rÁ;}rÂ;(h=Xlibrary-coverage: booleanh>j¼;hDhEhFjJhH}rÃ;(hM]rÄ;Xcfg-field-library-coveragerÅ;ahL]hJ]hK]hP]jN‰uhRNhShhT]rÆ;(j7)rÇ;}rÈ;(h=Uh>jÁ;hDhEhFj:hH}rÉ;(hM]hL]hJ]hK]hP]Uentries]rÊ;(jTX'library-coverage ; cabal project optionjÅ;UNtrË;auhRNhShhT]ubjV)rÌ;}rÍ;(h=Xlibrary-coveragerÎ;h>jÁ;hDhEhFjZhH}rÏ;(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÐ;h]Xlibrary-coveragerÑ;…rÒ;}rÓ;(h=UhDNhRNhShh>jÌ;ubaubj`)rÔ;}rÕ;(h=jch>jÁ;hDhEhFjdhH}rÖ;(jjhM]hL]hJ]hK]hP]uhRNhShhT]r×;h]X: rØ;…rÙ;}rÚ;(h=UhDNhRNhShh>jÔ;ubaubjj)rÛ;}rÜ;(h=Xbooleanh>jÁ;hDhEhFjmhH}rÝ;(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÞ;h]Xbooleanrß;…rà;}rá;(h=UhDNhRNhShh>jÛ;ubaubeubjG)râ;}rã;(h=X--enable-library-coveragerä;h>j¼;hDhEhFjJhH}rå;(hM]ræ;X"cfg-flag---enable-library-coveragerç;ahL]hJ]hK]hP]jN‰uhRNhShhT]rè;(j7)ré;}rê;(h=Uh>jâ;hDhEhFj:hH}rë;(hM]hL]hJ]hK]hP]Uentries]rì;(jTX/--enable-library-coverage; cabal project optionjç;UNtrí;auhRNhShhT]ubjV)rî;}rï;(h=jä;h>jâ;hDhEhFjZhH}rð;(jjhM]hL]hJ]hK]hP]uhRNhShhT]rñ;h]X--enable-library-coveragerò;…ró;}rô;(h=UhDNhRNhShh>jî;ubaubj`)rõ;}rö;(h=U h>jâ;hDhEhFjdhH}r÷;(jjhM]hL]hJ]hK]hP]uhRNhShhT]rø;h]X …rù;}rú;(h=UhDNhRNhShh>jõ;ubaubeubjG)rû;}rü;(h=X--disable-library-coveragerý;h>j¼;hDhEhFjJhH}rþ;(hM]rÿ;X#cfg-flag---disable-library-coverager<ahL]hJ]hK]hP]jN‰uhRNhShhT]r<(j7)r<}r<(h=Uh>jû;hDhEhFj:hH}r<(hM]hL]hJ]hK]hP]Uentries]r<(jTX0--disable-library-coverage; cabal project optionj<UNtr<auhRNhShhT]ubjV)r<}r<(h=jý;h>jû;hDhEhFjZhH}r <(jjhM]hL]hJ]hK]hP]uhRNhShhT]r <h]X--disable-library-coverager <…r <}r <(h=UhDNhRNhShh>j<ubaubj`)r<}r<(h=U h>jû;hDhEhFjdhH}r<(jjhM]hL]hJ]hK]hP]uhRNhShhT]r<h]X …r<}r<(h=UhDNhRNhShh>j<ubaubeubjs)r<}r<(h=Uh>j¼;hDhEhFjvhH}r<(hJ]hK]hL]hM]hP]uhRNhShhT]r<(jy)r<}r<(h=Uh>j<hDhEhFj|hH}r<(hJ]hK]hL]hM]hP]uhRNhShhT]r<(j)r<}r<(h=Uh>j<hDhEhFjžhH}r<(hJ]hK]hL]hM]hP]uhRNhShhT]r<(j„)r <}r!<(h=j`h>j<hDhEhFj‡hH}r"<(hJ]hK]hL]hM]hP]uhRKhT]r#<h]X Deprecatedr$<…r%<}r&<(h=Uh>j <ubaubj)r'<}r(<(h=UhH}r)<(hJ]hK]hL]hM]hP]uh>j<hT]r*<hp)r+<}r,<(h=UhH}r-<(hJ]hK]hL]hM]hP]uh>j'<hT]hFhtubahFjubeubj)r.<}r/<(h=Uh>j<hDhEhFjžhH}r0<(hJ]hK]hL]hM]hP]uhRNhShhT]r1<(j„)r2<}r3<(h=j2h>j.<hDhEhFj‡hH}r4<(hJ]hK]hL]hM]hP]uhRKhT]r5<h]XSincer6<…r7<}r8<(h=Uh>j2<ubaubj)r9<}r:<(h=U Cabal 1.22r;<hH}r<<(hJ]hK]hL]hM]hP]uh>j.<hT]r=<hp)r><}r?<(h=j;<hH}r@<(hJ]hK]hL]hM]hP]uh>j9<hT]rA<h]X Cabal 1.22rB<…rC<}rD<(h=Uh>j><ubahFhtubahFjubeubj)rE<}rF<(h=UhH}rG<(hJ]hK]hL]hM]hP]uh>j<hT]rH<(j„)rI<}rJ<(h=X Default valueh>jE<hDhEhFj‡hH}rK<(hJ]hK]hL]hM]hP]uhRKhT]rL<h]X Default valuerM<…rN<}rO<(h=Uh>jI<ubaubj)rP<}rQ<(h=UhH}rR<(hJ]hK]hL]hM]hP]uh>jE<hT]rS<hp)rT<}rU<(h=XFalsehH}rV<(hJ]hK]hL]hM]hP]uh>jP<hT]rW<h]XFalserX<…rY<}rZ<(h=XFalsehDNhRNhShh>jT<ubahFhtubahFjubehFjžubeubhp)r[<}r\<(h=X&Deprecated, use :cfg-field:`coverage`.h>j<hDhEhFhthH}r]<(hJ]hK]hL]hM]hP]uhRMëhShhT]r^<(h]XDeprecated, use r_<…r`<}ra<(h=XDeprecated, use hDNhRNhShh>j[<ubjä)rb<}rc<(h=X:cfg-field:`coverage`h>j[<hDhEhFjçhH}rd<(UreftypeX cfg-fieldjéˆjêXcoveragere<U refdomainXcabalrf<hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMëhT]rg<h–)rh<}ri<(h=je<hH}rj<(hJ]hK]rk<(jôjf<Xcabal-cfg-fieldrl<ehL]hM]hP]uh>jb<hT]rm<h]Xcoveragern<…ro<}rp<(h=Uh>jh<ubahFhžubaubh]X.…rq<}rr<(h=X.hDNhRNhShh>j[<ubeubhp)rs<}rt<(h=XjThe command line variant of this flag is ``--enable-library-coverage`` and ``--disable-library-coverage``.h>j<hDhEhFhthH}ru<(hJ]hK]hL]hM]hP]uhRMíhShhT]rv<(h]X)The command line variant of this flag is rw<…rx<}ry<(h=X)The command line variant of this flag is hDNhRNhShh>js<ubh–)rz<}r{<(h=X``--enable-library-coverage``hH}r|<(hJ]hK]hL]hM]hP]uh>js<hT]r}<h]X--enable-library-coverager~<…r<}r€<(h=X--enable-library-coverageh>jz<ubahFhžubh]X and r<…r‚<}rƒ<(h=X and hDNhRNhShh>js<ubh–)r„<}r…<(h=X``--disable-library-coverage``hH}r†<(hJ]hK]hL]hM]hP]uh>js<hT]r‡<h]X--disable-library-coveragerˆ<…r‰<}rŠ<(h=X--disable-library-coverageh>j„<ubahFhžubh]X.…r‹<}rŒ<(h=X.hDNhRNhShh>js<ubeubeubeubj7)r<}rŽ<(h=Uh>jf hDhEhFj:hH}r<(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r<}r‘<(h=Uh>jf hDhEhFj?hH}r’<(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr“<jEj“<uhRNhShhT]r”<(jG)r•<}r–<(h=Xdocumentation: booleanh>j<hDhEhFjJhH}r—<(hM]r˜<Xcfg-field-documentationr™<ahL]hJ]hK]hP]jN‰uhRNhShhT]rš<(j7)r›<}rœ<(h=Uh>j•<hDhEhFj:hH}r<(hM]hL]hJ]hK]hP]Uentries]rž<(jTX$documentation ; cabal project optionj™<UNtrŸ<auhRNhShhT]ubjV)r <}r¡<(h=X documentationr¢<h>j•<hDhEhFjZhH}r£<(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¤<h]X documentationr¥<…r¦<}r§<(h=UhDNhRNhShh>j <ubaubj`)r¨<}r©<(h=jch>j•<hDhEhFjdhH}rª<(jjhM]hL]hJ]hK]hP]uhRNhShhT]r«<h]X: r¬<…r­<}r®<(h=UhDNhRNhShh>j¨<ubaubjj)r¯<}r°<(h=Xbooleanh>j•<hDhEhFjmhH}r±<(jjhM]hL]hJ]hK]hP]uhRNhShhT]r²<h]Xbooleanr³<…r´<}rµ<(h=UhDNhRNhShh>j¯<ubaubeubjG)r¶<}r·<(h=X--enable-documentationr¸<h>j<hDhEhFjJhH}r¹<(hM]rº<Xcfg-flag---enable-documentationr»<ahL]hJ]hK]hP]jN‰uhRNhShhT]r¼<(j7)r½<}r¾<(h=Uh>j¶<hDhEhFj:hH}r¿<(hM]hL]hJ]hK]hP]Uentries]rÀ<(jTX,--enable-documentation; cabal project optionj»<UNtrÁ<auhRNhShhT]ubjV)rÂ<}rÃ<(h=j¸<h>j¶<hDhEhFjZhH}rÄ<(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÅ<h]X--enable-documentationrÆ<…rÇ<}rÈ<(h=UhDNhRNhShh>jÂ<ubaubj`)rÉ<}rÊ<(h=U h>j¶<hDhEhFjdhH}rË<(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÌ<h]X …rÍ<}rÎ<(h=UhDNhRNhShh>jÉ<ubaubeubjG)rÏ<}rÐ<(h=X--disable-documentationrÑ<h>j<hDhEhFjJhH}rÒ<(hM]rÓ<X cfg-flag---disable-documentationrÔ<ahL]hJ]hK]hP]jN‰uhRNhShhT]rÕ<(j7)rÖ<}r×<(h=Uh>jÏ<hDhEhFj:hH}rØ<(hM]hL]hJ]hK]hP]Uentries]rÙ<(jTX---disable-documentation; cabal project optionjÔ<UNtrÚ<auhRNhShhT]ubjV)rÛ<}rÜ<(h=jÑ<h>jÏ<hDhEhFjZhH}rÝ<(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÞ<h]X--disable-documentationrß<…rà<}rá<(h=UhDNhRNhShh>jÛ<ubaubj`)râ<}rã<(h=U h>jÏ<hDhEhFjdhH}rä<(jjhM]hL]hJ]hK]hP]uhRNhShhT]rå<h]X …ræ<}rç<(h=UhDNhRNhShh>jâ<ubaubeubjs)rè<}ré<(h=Uh>j<hDhEhFjvhH}rê<(hJ]hK]hL]hM]hP]uhRNhShhT]rë<(jy)rì<}rí<(h=Uh>jè<hDhEhFj|hH}rî<(hJ]hK]hL]hM]hP]uhRNhShhT]rï<j)rð<}rñ<(h=UhH}rò<(hJ]hK]hL]hM]hP]uh>jì<hT]ró<(j„)rô<}rõ<(h=X Default valueh>jð<hDhEhFj‡hH}rö<(hJ]hK]hL]hM]hP]uhRKhT]r÷<h]X Default valuerø<…rù<}rú<(h=Uh>jô<ubaubj)rû<}rü<(h=UhH}rý<(hJ]hK]hL]hM]hP]uh>jð<hT]rþ<hp)rÿ<}r=(h=XFalsehH}r=(hJ]hK]hL]hM]hP]uh>jû<hT]r=h]XFalser=…r=}r=(h=XFalser=hDNhRNhShh>jÿ<ubahFhtubahFjubehFjžubaubhp)r=}r=(h=X)Enables building of Haddock documentationr =h>jè<hDhEhFhthH}r =(hJ]hK]hL]hM]hP]uhRMúhShhT]r =h]X)Enables building of Haddock documentationr =…r =}r=(h=j =hDNhRNhShh>j=ubaubhp)r=}r=(h=XdThe command line variant of this flag is ``--enable-documentation`` and ``--disable-documentation``.h>jè<hDhEhFhthH}r=(hJ]hK]hL]hM]hP]uhRMühShhT]r=(h]X)The command line variant of this flag is r=…r=}r=(h=X)The command line variant of this flag is hDNhRNhShh>j=ubh–)r=}r=(h=X``--enable-documentation``hH}r=(hJ]hK]hL]hM]hP]uh>j=hT]r=h]X--enable-documentationr=…r=}r=(h=X--enable-documentationh>j=ubahFhžubh]X and r=…r=}r=(h=X and hDNhRNhShh>j=ubh–)r =}r!=(h=X``--disable-documentation``hH}r"=(hJ]hK]hL]hM]hP]uh>j=hT]r#=h]X--disable-documentationr$=…r%=}r&=(h=X--disable-documentationh>j =ubahFhžubh]X.…r'=}r(=(h=X.hDNhRNhShh>j=ubeubhp)r)=}r*=(h=XÔ`documentation: true` does not imply :cfg-field:`haddock-benchmarks`, :cfg-field:`haddock-executables`, :cfg-field:`haddock-internal` or :cfg-field:`haddock-tests`. These need to be enabled separately if desired.h>jè<hDhEhFhthH}r+=(hJ]hK]hL]hM]hP]uhRMÿhShhT]r,=(j)r-=}r.=(h=X`documentation: true`hH}r/=(hJ]hK]hL]hM]hP]uh>j)=hT]r0=h]Xdocumentation: truer1=…r2=}r3=(h=Xdocumentation: trueh>j-=ubahFj ubh]X does not imply r4=…r5=}r6=(h=X does not imply hDNhRNhShh>j)=ubjä)r7=}r8=(h=X:cfg-field:`haddock-benchmarks`h>j)=hDhEhFjçhH}r9=(UreftypeX cfg-fieldjéˆjêXhaddock-benchmarksr:=U refdomainXcabalr;=hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÿhT]r<=h–)r==}r>=(h=j:=hH}r?=(hJ]hK]r@=(jôj;=Xcabal-cfg-fieldrA=ehL]hM]hP]uh>j7=hT]rB=h]Xhaddock-benchmarksrC=…rD=}rE=(h=Uh>j==ubahFhžubaubh]X, rF=…rG=}rH=(h=X, hDNhRNhShh>j)=ubjä)rI=}rJ=(h=X :cfg-field:`haddock-executables`h>j)=hDhEhFjçhH}rK=(UreftypeX cfg-fieldjéˆjêXhaddock-executablesrL=U refdomainXcabalrM=hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÿhT]rN=h–)rO=}rP=(h=jL=hH}rQ=(hJ]hK]rR=(jôjM=Xcabal-cfg-fieldrS=ehL]hM]hP]uh>jI=hT]rT=h]Xhaddock-executablesrU=…rV=}rW=(h=Uh>jO=ubahFhžubaubh]X, rX=…rY=}rZ=(h=X, hDNhRNhShh>j)=ubjä)r[=}r\=(h=X:cfg-field:`haddock-internal`h>j)=hDhEhFjçhH}r]=(UreftypeX cfg-fieldjéˆjêXhaddock-internalr^=U refdomainXcabalr_=hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÿhT]r`=h–)ra=}rb=(h=j^=hH}rc=(hJ]hK]rd=(jôj_=Xcabal-cfg-fieldre=ehL]hM]hP]uh>j[=hT]rf=h]Xhaddock-internalrg=…rh=}ri=(h=Uh>ja=ubahFhžubaubh]X or rj=…rk=}rl=(h=X or hDNhRNhShh>j)=ubjä)rm=}rn=(h=X:cfg-field:`haddock-tests`h>j)=hDhEhFjçhH}ro=(UreftypeX cfg-fieldjéˆjêX haddock-testsrp=U refdomainXcabalrq=hM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRMÿhT]rr=h–)rs=}rt=(h=jp=hH}ru=(hJ]hK]rv=(jôjq=Xcabal-cfg-fieldrw=ehL]hM]hP]uh>jm=hT]rx=h]X haddock-testsry=…rz=}r{=(h=Uh>js=ubahFhžubaubh]X1. These need to be enabled separately if desired.r|=…r}=}r~=(h=X1. These need to be enabled separately if desired.hDNhRNhShh>j)=ubeubeubeubj7)r=}r€=(h=Uh>jf hDhEhFj:hH}r=(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r‚=}rƒ=(h=Uh>jf hDhEhFj?hH}r„=(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr…=jEj…=uhRNhShhT]r†=(jG)r‡=}rˆ=(h=Xdoc-index-file: templated pathh>j‚=hDhEhFjJhH}r‰=(hM]rŠ=Xcfg-field-doc-index-filer‹=ahL]hJ]hK]hP]jN‰uhRNhShhT]rŒ=(j7)r=}rŽ=(h=Uh>j‡=hDhEhFj:hH}r=(hM]hL]hJ]hK]hP]Uentries]r=(jTX%doc-index-file ; cabal project optionj‹=UNtr‘=auhRNhShhT]ubjV)r’=}r“=(h=Xdoc-index-filer”=h>j‡=hDhEhFjZhH}r•=(jjhM]hL]hJ]hK]hP]uhRNhShhT]r–=h]Xdoc-index-filer—=…r˜=}r™=(h=UhDNhRNhShh>j’=ubaubj`)rš=}r›=(h=jch>j‡=hDhEhFjdhH}rœ=(jjhM]hL]hJ]hK]hP]uhRNhShhT]r=h]X: rž=…rŸ=}r =(h=UhDNhRNhShh>jš=ubaubjj)r¡=}r¢=(h=Xtemplated pathh>j‡=hDhEhFjmhH}r£=(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¤=h]Xtemplated pathr¥=…r¦=}r§=(h=UhDNhRNhShh>j¡=ubaubeubjG)r¨=}r©=(h=X--doc-index-file=TEMPLATEh>j‚=hDhEhFjJhH}rª=(hM]r«=Xcfg-flag---doc-index-filer¬=ahL]hJ]hK]hP]jN‰uhRNhShhT]r­=(j7)r®=}r¯=(h=Uh>j¨=hDhEhFj:hH}r°=(hM]hL]hJ]hK]hP]Uentries]r±=(jTX&--doc-index-file; cabal project optionj¬=UNtr²=auhRNhShhT]ubjV)r³=}r´=(h=X--doc-index-filerµ=h>j¨=hDhEhFjZhH}r¶=(jjhM]hL]hJ]hK]hP]uhRNhShhT]r·=h]X--doc-index-filer¸=…r¹=}rº=(h=UhDNhRNhShh>j³=ubaubj`)r»=}r¼=(h=X =TEMPLATEh>j¨=hDhEhFjdhH}r½=(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¾=h]X =TEMPLATEr¿=…rÀ=}rÁ=(h=UhDNhRNhShh>j»=ubaubeubjs)rÂ=}rÃ=(h=Uh>j‚=hDhEhFjvhH}rÄ=(hJ]hK]hL]hM]hP]uhRNhShhT]rÅ=(hp)rÆ=}rÇ=(h=XA central index of Haddock API documentation (template cannot use ``$pkgid``), which should be updated as documentation is built.h>jÂ=hDhEhFhthH}rÈ=(hJ]hK]hL]hM]hP]uhRMhShhT]rÉ=(h]XBA central index of Haddock API documentation (template cannot use rÊ=…rË=}rÌ=(h=XBA central index of Haddock API documentation (template cannot use hDNhRNhShh>jÆ=ubh–)rÍ=}rÎ=(h=X ``$pkgid``hH}rÏ=(hJ]hK]hL]hM]hP]uh>jÆ=hT]rÐ=h]X$pkgidrÑ=…rÒ=}rÓ=(h=X$pkgidh>jÍ=ubahFhžubh]X5), which should be updated as documentation is built.rÔ=…rÕ=}rÖ=(h=X5), which should be updated as documentation is built.hDNhRNhShh>jÆ=ubeubhp)r×=}rØ=(h=XFThe command line variant of this flag is ``--doc-index-file=TEMPLATE``h>jÂ=hDhEhFhthH}rÙ=(hJ]hK]hL]hM]hP]uhRM hShhT]rÚ=(h]X)The command line variant of this flag is rÛ=…rÜ=}rÝ=(h=X)The command line variant of this flag is hDNhRNhShh>j×=ubh–)rÞ=}rß=(h=X``--doc-index-file=TEMPLATE``hH}rà=(hJ]hK]hL]hM]hP]uh>j×=hT]rá=h]X--doc-index-file=TEMPLATErâ=…rã=}rä=(h=X--doc-index-file=TEMPLATEh>jÞ=ubahFhžubeubeubeubhp)rå=}ræ=(h=XThe following commands are equivalent to ones that would be passed when running ``setup haddock``. (TODO: Where does the documentation get put.)h>jf hDhEhFhthH}rç=(hJ]hK]hL]hM]hP]uhRMhShhT]rè=(h]XPThe following commands are equivalent to ones that would be passed when running ré=…rê=}rë=(h=XPThe following commands are equivalent to ones that would be passed when running hDNhRNhShh>jå=ubh–)rì=}rí=(h=X``setup haddock``hH}rî=(hJ]hK]hL]hM]hP]uh>jå=hT]rï=h]X setup haddockrð=…rñ=}rò=(h=X setup haddockh>jì=ubahFhžubh]X/. (TODO: Where does the documentation get put.)ró=…rô=}rõ=(h=X/. (TODO: Where does the documentation get put.)hDNhRNhShh>jå=ubeubj7)rö=}r÷=(h=Uh>jf hDhEhFj:hH}rø=(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rù=}rú=(h=Uh>jf hDhEhFj?hH}rû=(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrü=jEjü=uhRNhShhT]rý=(jG)rþ=}rÿ=(h=Xhaddock-hoogle: booleanh>jù=hDhEhFjJhH}r>(hM]r>Xcfg-field-haddock-hoogler>ahL]hJ]hK]hP]jN‰uhRNhShhT]r>(j7)r>}r>(h=Uh>jþ=hDhEhFj:hH}r>(hM]hL]hJ]hK]hP]Uentries]r>(jTX%haddock-hoogle ; cabal project optionj>UNtr>auhRNhShhT]ubjV)r >}r >(h=Xhaddock-hoogler >h>jþ=hDhEhFjZhH}r >(jjhM]hL]hJ]hK]hP]uhRNhShhT]r >h]Xhaddock-hoogler>…r>}r>(h=UhDNhRNhShh>j >ubaubj`)r>}r>(h=jch>jþ=hDhEhFjdhH}r>(jjhM]hL]hJ]hK]hP]uhRNhShhT]r>h]X: r>…r>}r>(h=UhDNhRNhShh>j>ubaubjj)r>}r>(h=Xbooleanh>jþ=hDhEhFjmhH}r>(jjhM]hL]hJ]hK]hP]uhRNhShhT]r>h]Xbooleanr>…r>}r>(h=UhDNhRNhShh>j>ubaubeubjs)r>}r >(h=Uh>jù=hDhEhFjvhH}r!>(hJ]hK]hL]hM]hP]uhRNhShhT]r">(jy)r#>}r$>(h=Uh>j>hDhEhFj|hH}r%>(hJ]hK]hL]hM]hP]uhRNhShhT]r&>j)r'>}r(>(h=UhH}r)>(hJ]hK]hL]hM]hP]uh>j#>hT]r*>(j„)r+>}r,>(h=X Default valueh>j'>hDhEhFj‡hH}r->(hJ]hK]hL]hM]hP]uhRKhT]r.>h]X Default valuer/>…r0>}r1>(h=Uh>j+>ubaubj)r2>}r3>(h=UhH}r4>(hJ]hK]hL]hM]hP]uh>j'>hT]r5>hp)r6>}r7>(h=XFalsehH}r8>(hJ]hK]hL]hM]hP]uh>j2>hT]r9>h]XFalser:>…r;>}r<>(h=XFalsehDNhRNhShh>j6>ubahFhtubahFjubehFjžubaubhp)r=>}r>>(h=X›Generate a text file which can be converted by Hoogle_ into a database for searching. This is equivalent to running ``haddock`` with the ``--hoogle`` flag.h>j>hDhEhFhthH}r?>(hJ]hK]hL]hM]hP]uhRMhShhT]r@>(h]X/Generate a text file which can be converted by rA>…rB>}rC>(h=X/Generate a text file which can be converted by hDNhRNhShh>j=>ubjæ)rD>}rE>(h=XHoogle_jÑKh>j=>hFjïhH}rF>(UnameXHooglerG>jêjÚ"hM]hL]hJ]hK]hP]uhT]rH>h]XHooglerI>…rJ>}rK>(h=jG>h>jD>ubaubh]X> into a database for searching. This is equivalent to running rL>…rM>}rN>(h=X> into a database for searching. This is equivalent to running hDNhRNhShh>j=>ubh–)rO>}rP>(h=X ``haddock``hH}rQ>(hJ]hK]hL]hM]hP]uh>j=>hT]rR>h]XhaddockrS>…rT>}rU>(h=Xhaddockh>jO>ubahFhžubh]X with the rV>…rW>}rX>(h=X with the hDNhRNhShh>j=>ubh–)rY>}rZ>(h=X ``--hoogle``hH}r[>(hJ]hK]hL]hM]hP]uh>j=>hT]r\>h]X--hoogler]>…r^>}r_>(h=X--hoogleh>jY>ubahFhžubh]X flag.r`>…ra>}rb>(h=X flag.hDNhRNhShh>j=>ubeubhp)rc>}rd>(h=XTThe command line variant of this flag is ``--hoogle`` (for the ``haddock`` command).h>j>hDhEhFhthH}re>(hJ]hK]hL]hM]hP]uhRMhShhT]rf>(h]X)The command line variant of this flag is rg>…rh>}ri>(h=X)The command line variant of this flag is hDNhRNhShh>jc>ubh–)rj>}rk>(h=X ``--hoogle``hH}rl>(hJ]hK]hL]hM]hP]uh>jc>hT]rm>h]X--hooglern>…ro>}rp>(h=X--hoogleh>jj>ubahFhžubh]X (for the rq>…rr>}rs>(h=X (for the hDNhRNhShh>jc>ubh–)rt>}ru>(h=X ``haddock``hH}rv>(hJ]hK]hL]hM]hP]uh>jc>hT]rw>h]Xhaddockrx>…ry>}rz>(h=Xhaddockh>jt>ubahFhžubh]X command).r{>…r|>}r}>(h=X command).hDNhRNhShh>jc>ubeubeubeubj7)r~>}r>(h=Uh>jf hDhEhFj:hH}r€>(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r>}r‚>(h=Uh>jf hDhEhFj?hH}rƒ>(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr„>jEj„>uhRNhShhT]r…>(jG)r†>}r‡>(h=Xhaddock-html: booleanh>j>hDhEhFjJhH}rˆ>(hM]r‰>Xcfg-field-haddock-htmlrŠ>ahL]hJ]hK]hP]jN‰uhRNhShhT]r‹>(j7)rŒ>}r>(h=Uh>j†>hDhEhFj:hH}rŽ>(hM]hL]hJ]hK]hP]Uentries]r>(jTX#haddock-html ; cabal project optionjŠ>UNtr>auhRNhShhT]ubjV)r‘>}r’>(h=X haddock-htmlr“>h>j†>hDhEhFjZhH}r”>(jjhM]hL]hJ]hK]hP]uhRNhShhT]r•>h]X haddock-htmlr–>…r—>}r˜>(h=UhDNhRNhShh>j‘>ubaubj`)r™>}rš>(h=jch>j†>hDhEhFjdhH}r›>(jjhM]hL]hJ]hK]hP]uhRNhShhT]rœ>h]X: r>…rž>}rŸ>(h=UhDNhRNhShh>j™>ubaubjj)r >}r¡>(h=Xbooleanh>j†>hDhEhFjmhH}r¢>(jjhM]hL]hJ]hK]hP]uhRNhShhT]r£>h]Xbooleanr¤>…r¥>}r¦>(h=UhDNhRNhShh>j >ubaubeubjs)r§>}r¨>(h=Uh>j>hDhEhFjvhH}r©>(hJ]hK]hL]hM]hP]uhRNhShhT]rª>(jy)r«>}r¬>(h=Uh>j§>hDhEhFj|hH}r­>(hJ]hK]hL]hM]hP]uhRNhShhT]r®>j)r¯>}r°>(h=UhH}r±>(hJ]hK]hL]hM]hP]uh>j«>hT]r²>(j„)r³>}r´>(h=X Default valueh>j¯>hDhEhFj‡hH}rµ>(hJ]hK]hL]hM]hP]uhRKhT]r¶>h]X Default valuer·>…r¸>}r¹>(h=Uh>j³>ubaubj)rº>}r»>(h=UhH}r¼>(hJ]hK]hL]hM]hP]uh>j¯>hT]r½>hp)r¾>}r¿>(h=XTruehH}rÀ>(hJ]hK]hL]hM]hP]uh>jº>hT]rÁ>h]XTruerÂ>…rÃ>}rÄ>(h=XTruehDNhRNhShh>j¾>ubahFhtubahFjubehFjžubaubhp)rÅ>}rÆ>(h=XBuild HTML documentation.rÇ>h>j§>hDhEhFhthH}rÈ>(hJ]hK]hL]hM]hP]uhRM"hShhT]rÉ>h]XBuild HTML documentation.rÊ>…rË>}rÌ>(h=jÇ>hDNhRNhShh>jÅ>ubaubhp)rÍ>}rÎ>(h=XRThe command line variant of this flag is ``--html`` (for the ``haddock`` command).h>j§>hDhEhFhthH}rÏ>(hJ]hK]hL]hM]hP]uhRM$hShhT]rÐ>(h]X)The command line variant of this flag is rÑ>…rÒ>}rÓ>(h=X)The command line variant of this flag is hDNhRNhShh>jÍ>ubh–)rÔ>}rÕ>(h=X ``--html``hH}rÖ>(hJ]hK]hL]hM]hP]uh>jÍ>hT]r×>h]X--htmlrØ>…rÙ>}rÚ>(h=X--htmlh>jÔ>ubahFhžubh]X (for the rÛ>…rÜ>}rÝ>(h=X (for the hDNhRNhShh>jÍ>ubh–)rÞ>}rß>(h=X ``haddock``hH}rà>(hJ]hK]hL]hM]hP]uh>jÍ>hT]rá>h]Xhaddockrâ>…rã>}rä>(h=Xhaddockh>jÞ>ubahFhžubh]X command).rå>…ræ>}rç>(h=X command).hDNhRNhShh>jÍ>ubeubeubeubj7)rè>}ré>(h=Uh>jf hDhEhFj:hH}rê>(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rë>}rì>(h=Uh>jf hDhEhFj?hH}rí>(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrî>jEjî>uhRNhShhT]rï>(jG)rð>}rñ>(h=X%haddock-html-location: templated pathh>jë>hDhEhFjJhH}rò>(hM]ró>Xcfg-field-haddock-html-locationrô>ahL]hJ]hK]hP]jN‰uhRNhShhT]rõ>(j7)rö>}r÷>(h=Uh>jð>hDhEhFj:hH}rø>(hM]hL]hJ]hK]hP]Uentries]rù>(jTX,haddock-html-location ; cabal project optionjô>UNtrú>auhRNhShhT]ubjV)rû>}rü>(h=Xhaddock-html-locationrý>h>jð>hDhEhFjZhH}rþ>(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÿ>h]Xhaddock-html-locationr?…r?}r?(h=UhDNhRNhShh>jû>ubaubj`)r?}r?(h=jch>jð>hDhEhFjdhH}r?(jjhM]hL]hJ]hK]hP]uhRNhShhT]r?h]X: r?…r?}r ?(h=UhDNhRNhShh>j?ubaubjj)r ?}r ?(h=Xtemplated pathh>jð>hDhEhFjmhH}r ?(jjhM]hL]hJ]hK]hP]uhRNhShhT]r ?h]Xtemplated pathr?…r?}r?(h=UhDNhRNhShh>j ?ubaubeubjs)r?}r?(h=Uh>jë>hDhEhFjvhH}r?(hJ]hK]hL]hM]hP]uhRNhShhT]r?(hp)r?}r?(h=X:Specify a template for the location of HTML documentation for prerequisite packages. The substitutions are applied to the template to obtain a location for each package, which will be used by hyperlinks in the generated documentation. For example, the following command generates links pointing at [Hackage] pages:r?h>j?hDhEhFhthH}r?(hJ]hK]hL]hM]hP]uhRM*hShhT]r?h]X:Specify a template for the location of HTML documentation for prerequisite packages. The substitutions are applied to the template to obtain a location for each package, which will be used by hyperlinks in the generated documentation. For example, the following command generates links pointing at [Hackage] pages:r?…r?}r?(h=j?hDNhRNhShh>j?ubaubj)r?}r?(h=XQhtml-location: 'http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'h>j?hDhEhFjhH}r?(jjhM]hL]hJ]hK]hP]uhRM2hShhT]r ?h]XQhtml-location: 'http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'r!?…r"?}r#?(h=Uh>j?ubaubhp)r$?}r%?(h=X±Here the argument is quoted to prevent substitution by the shell. If this option is omitted, the location for each package is obtained using the package tool (e.g. ``ghc-pkg``).h>j?hDhEhFhthH}r&?(hJ]hK]hL]hM]hP]uhRM4hShhT]r'?(h]X¤Here the argument is quoted to prevent substitution by the shell. If this option is omitted, the location for each package is obtained using the package tool (e.g. r(?…r)?}r*?(h=X¤Here the argument is quoted to prevent substitution by the shell. If this option is omitted, the location for each package is obtained using the package tool (e.g. hDNhRNhShh>j$?ubh–)r+?}r,?(h=X ``ghc-pkg``hH}r-?(hJ]hK]hL]hM]hP]uh>j$?hT]r.?h]Xghc-pkgr/?…r0?}r1?(h=Xghc-pkgh>j+?ubahFhžubh]X).r2?…r3?}r4?(h=X).hDNhRNhShh>j$?ubeubhp)r5?}r6?(h=X^The command line variant of this flag is ``--html-location`` (for the ``haddock`` subcommand).h>j?hDhEhFhthH}r7?(hJ]hK]hL]hM]hP]uhRM8hShhT]r8?(h]X)The command line variant of this flag is r9?…r:?}r;?(h=X)The command line variant of this flag is hDNhRNhShh>j5?ubh–)r?(hJ]hK]hL]hM]hP]uh>j5?hT]r??h]X--html-locationr@?…rA?}rB?(h=X--html-locationh>jj5?ubh–)rF?}rG?(h=X ``haddock``hH}rH?(hJ]hK]hL]hM]hP]uh>j5?hT]rI?h]XhaddockrJ?…rK?}rL?(h=Xhaddockh>jF?ubahFhžubh]X subcommand).rM?…rN?}rO?(h=X subcommand).hDNhRNhShh>j5?ubeubeubeubj7)rP?}rQ?(h=Uh>jf hDhEhFj:hH}rR?(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rS?}rT?(h=Uh>jf hDhEhFj?hH}rU?(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrV?jEjV?uhRNhShhT]rW?(jG)rX?}rY?(h=Xhaddock-executables: booleanh>jS?hDhEhFjJhH}rZ?(hM]r[?Xcfg-field-haddock-executablesr\?ahL]hJ]hK]hP]jN‰uhRNhShhT]r]?(j7)r^?}r_?(h=Uh>jX?hDhEhFj:hH}r`?(hM]hL]hJ]hK]hP]Uentries]ra?(jTX*haddock-executables ; cabal project optionj\?UNtrb?auhRNhShhT]ubjV)rc?}rd?(h=Xhaddock-executablesre?h>jX?hDhEhFjZhH}rf?(jjhM]hL]hJ]hK]hP]uhRNhShhT]rg?h]Xhaddock-executablesrh?…ri?}rj?(h=UhDNhRNhShh>jc?ubaubj`)rk?}rl?(h=jch>jX?hDhEhFjdhH}rm?(jjhM]hL]hJ]hK]hP]uhRNhShhT]rn?h]X: ro?…rp?}rq?(h=UhDNhRNhShh>jk?ubaubjj)rr?}rs?(h=Xbooleanh>jX?hDhEhFjmhH}rt?(jjhM]hL]hJ]hK]hP]uhRNhShhT]ru?h]Xbooleanrv?…rw?}rx?(h=UhDNhRNhShh>jr?ubaubeubjs)ry?}rz?(h=Uh>jS?hDhEhFjvhH}r{?(hJ]hK]hL]hM]hP]uhRNhShhT]r|?(jy)r}?}r~?(h=Uh>jy?hDhEhFj|hH}r?(hJ]hK]hL]hM]hP]uhRNhShhT]r€?j)r?}r‚?(h=UhH}rƒ?(hJ]hK]hL]hM]hP]uh>j}?hT]r„?(j„)r…?}r†?(h=X Default valueh>j?hDhEhFj‡hH}r‡?(hJ]hK]hL]hM]hP]uhRKhT]rˆ?h]X Default valuer‰?…rŠ?}r‹?(h=Uh>j…?ubaubj)rŒ?}r?(h=UhH}rŽ?(hJ]hK]hL]hM]hP]uh>j?hT]r?hp)r?}r‘?(h=XFalsehH}r’?(hJ]hK]hL]hM]hP]uh>jŒ?hT]r“?h]XFalser”?…r•?}r–?(h=XFalsehDNhRNhShh>j?ubahFhtubahFjubehFjžubaubhp)r—?}r˜?(h=X'Run haddock on all executable programs.r™?h>jy?hDhEhFhthH}rš?(hJ]hK]hL]hM]hP]uhRM@hShhT]r›?h]X'Run haddock on all executable programs.rœ?…r?}rž?(h=j™?hDNhRNhShh>j—?ubaubhp)rŸ?}r ?(h=X\The command line variant of this flag is ``--executables`` (for the ``haddock`` subcommand).h>jy?hDhEhFhthH}r¡?(hJ]hK]hL]hM]hP]uhRMBhShhT]r¢?(h]X)The command line variant of this flag is r£?…r¤?}r¥?(h=X)The command line variant of this flag is hDNhRNhShh>jŸ?ubh–)r¦?}r§?(h=X``--executables``hH}r¨?(hJ]hK]hL]hM]hP]uh>jŸ?hT]r©?h]X --executablesrª?…r«?}r¬?(h=X --executablesh>j¦?ubahFhžubh]X (for the r­?…r®?}r¯?(h=X (for the hDNhRNhShh>jŸ?ubh–)r°?}r±?(h=X ``haddock``hH}r²?(hJ]hK]hL]hM]hP]uh>jŸ?hT]r³?h]Xhaddockr´?…rµ?}r¶?(h=Xhaddockh>j°?ubahFhžubh]X subcommand).r·?…r¸?}r¹?(h=X subcommand).hDNhRNhShh>jŸ?ubeubeubeubj7)rº?}r»?(h=Uh>jf hDhEhFj:hH}r¼?(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r½?}r¾?(h=Uh>jf hDhEhFj?hH}r¿?(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrÀ?jEjÀ?uhRNhShhT]rÁ?(jG)rÂ?}rÃ?(h=Xhaddock-tests: booleanh>j½?hDhEhFjJhH}rÄ?(hM]rÅ?Xcfg-field-haddock-testsrÆ?ahL]hJ]hK]hP]jN‰uhRNhShhT]rÇ?(j7)rÈ?}rÉ?(h=Uh>jÂ?hDhEhFj:hH}rÊ?(hM]hL]hJ]hK]hP]Uentries]rË?(jTX$haddock-tests ; cabal project optionjÆ?UNtrÌ?auhRNhShhT]ubjV)rÍ?}rÎ?(h=X haddock-testsrÏ?h>jÂ?hDhEhFjZhH}rÐ?(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÑ?h]X haddock-testsrÒ?…rÓ?}rÔ?(h=UhDNhRNhShh>jÍ?ubaubj`)rÕ?}rÖ?(h=jch>jÂ?hDhEhFjdhH}r×?(jjhM]hL]hJ]hK]hP]uhRNhShhT]rØ?h]X: rÙ?…rÚ?}rÛ?(h=UhDNhRNhShh>jÕ?ubaubjj)rÜ?}rÝ?(h=Xbooleanh>jÂ?hDhEhFjmhH}rÞ?(jjhM]hL]hJ]hK]hP]uhRNhShhT]rß?h]Xbooleanrà?…rá?}râ?(h=UhDNhRNhShh>jÜ?ubaubeubjs)rã?}rä?(h=Uh>j½?hDhEhFjvhH}rå?(hJ]hK]hL]hM]hP]uhRNhShhT]ræ?(jy)rç?}rè?(h=Uh>jã?hDhEhFj|hH}ré?(hJ]hK]hL]hM]hP]uhRNhShhT]rê?j)rë?}rì?(h=UhH}rí?(hJ]hK]hL]hM]hP]uh>jç?hT]rî?(j„)rï?}rð?(h=X Default valueh>jë?hDhEhFj‡hH}rñ?(hJ]hK]hL]hM]hP]uhRKhT]rò?h]X Default valueró?…rô?}rõ?(h=Uh>jï?ubaubj)rö?}r÷?(h=UhH}rø?(hJ]hK]hL]hM]hP]uh>jë?hT]rù?hp)rú?}rû?(h=XFalsehH}rü?(hJ]hK]hL]hM]hP]uh>jö?hT]rý?h]XFalserþ?…rÿ?}r@(h=XFalsehDNhRNhShh>jú?ubahFhtubahFjubehFjžubaubhp)r@}r@(h=XRun haddock on all test suites.r@h>jã?hDhEhFhthH}r@(hJ]hK]hL]hM]hP]uhRMJhShhT]r@h]XRun haddock on all test suites.r@…r@}r@(h=j@hDNhRNhShh>j@ubaubhp)r @}r @(h=XVThe command line variant of this flag is ``--tests`` (for the ``haddock`` subcommand).h>jã?hDhEhFhthH}r @(hJ]hK]hL]hM]hP]uhRMLhShhT]r @(h]X)The command line variant of this flag is r @…r@}r@(h=X)The command line variant of this flag is hDNhRNhShh>j @ubh–)r@}r@(h=X ``--tests``hH}r@(hJ]hK]hL]hM]hP]uh>j @hT]r@h]X--testsr@…r@}r@(h=X--testsh>j@ubahFhžubh]X (for the r@…r@}r@(h=X (for the hDNhRNhShh>j @ubh–)r@}r@(h=X ``haddock``hH}r@(hJ]hK]hL]hM]hP]uh>j @hT]r@h]Xhaddockr@…r@}r @(h=Xhaddockh>j@ubahFhžubh]X subcommand).r!@…r"@}r#@(h=X subcommand).hDNhRNhShh>j @ubeubeubeubj7)r$@}r%@(h=Uh>jf hDhEhFj:hH}r&@(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r'@}r(@(h=Uh>jf hDhEhFj?hH}r)@(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr*@jEj*@uhRNhShhT]r+@(jG)r,@}r-@(h=Xhaddock-benchmarks: booleanh>j'@hDhEhFjJhH}r.@(hM]r/@Xcfg-field-haddock-benchmarksr0@ahL]hJ]hK]hP]jN‰uhRNhShhT]r1@(j7)r2@}r3@(h=Uh>j,@hDhEhFj:hH}r4@(hM]hL]hJ]hK]hP]Uentries]r5@(jTX)haddock-benchmarks ; cabal project optionj0@UNtr6@auhRNhShhT]ubjV)r7@}r8@(h=Xhaddock-benchmarksr9@h>j,@hDhEhFjZhH}r:@(jjhM]hL]hJ]hK]hP]uhRNhShhT]r;@h]Xhaddock-benchmarksr<@…r=@}r>@(h=UhDNhRNhShh>j7@ubaubj`)r?@}r@@(h=jch>j,@hDhEhFjdhH}rA@(jjhM]hL]hJ]hK]hP]uhRNhShhT]rB@h]X: rC@…rD@}rE@(h=UhDNhRNhShh>j?@ubaubjj)rF@}rG@(h=Xbooleanh>j,@hDhEhFjmhH}rH@(jjhM]hL]hJ]hK]hP]uhRNhShhT]rI@h]XbooleanrJ@…rK@}rL@(h=UhDNhRNhShh>jF@ubaubeubjs)rM@}rN@(h=Uh>j'@hDhEhFjvhH}rO@(hJ]hK]hL]hM]hP]uhRNhShhT]rP@(jy)rQ@}rR@(h=Uh>jM@hDhEhFj|hH}rS@(hJ]hK]hL]hM]hP]uhRNhShhT]rT@j)rU@}rV@(h=UhH}rW@(hJ]hK]hL]hM]hP]uh>jQ@hT]rX@(j„)rY@}rZ@(h=X Default valueh>jU@hDhEhFj‡hH}r[@(hJ]hK]hL]hM]hP]uhRKhT]r\@h]X Default valuer]@…r^@}r_@(h=Uh>jY@ubaubj)r`@}ra@(h=UhH}rb@(hJ]hK]hL]hM]hP]uh>jU@hT]rc@hp)rd@}re@(h=XFalsehH}rf@(hJ]hK]hL]hM]hP]uh>j`@hT]rg@h]XFalserh@…ri@}rj@(h=XFalsehDNhRNhShh>jd@ubahFhtubahFjubehFjžubaubhp)rk@}rl@(h=XRun haddock on all benchmarks.rm@h>jM@hDhEhFhthH}rn@(hJ]hK]hL]hM]hP]uhRMThShhT]ro@h]XRun haddock on all benchmarks.rp@…rq@}rr@(h=jm@hDNhRNhShh>jk@ubaubhp)rs@}rt@(h=X[The command line variant of this flag is ``--benchmarks`` (for the ``haddock`` subcommand).h>jM@hDhEhFhthH}ru@(hJ]hK]hL]hM]hP]uhRMVhShhT]rv@(h]X)The command line variant of this flag is rw@…rx@}ry@(h=X)The command line variant of this flag is hDNhRNhShh>js@ubh–)rz@}r{@(h=X``--benchmarks``hH}r|@(hJ]hK]hL]hM]hP]uh>js@hT]r}@h]X --benchmarksr~@…r@}r€@(h=X --benchmarksh>jz@ubahFhžubh]X (for the r@…r‚@}rƒ@(h=X (for the hDNhRNhShh>js@ubh–)r„@}r…@(h=X ``haddock``hH}r†@(hJ]hK]hL]hM]hP]uh>js@hT]r‡@h]Xhaddockrˆ@…r‰@}rŠ@(h=Xhaddockh>j„@ubahFhžubh]X subcommand).r‹@…rŒ@}r@(h=X subcommand).hDNhRNhShh>js@ubeubeubeubj7)rŽ@}r@(h=Uh>jf hDhEhFj:hH}r@(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r‘@}r’@(h=Uh>jf hDhEhFj?hH}r“@(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr”@jEj”@uhRNhShhT]r•@(jG)r–@}r—@(h=Xhaddock-all: booleanh>j‘@hDhEhFjJhH}r˜@(hM]r™@Xcfg-field-haddock-allrš@ahL]hJ]hK]hP]jN‰uhRNhShhT]r›@(j7)rœ@}r@(h=Uh>j–@hDhEhFj:hH}rž@(hM]hL]hJ]hK]hP]Uentries]rŸ@(jTX"haddock-all ; cabal project optionjš@UNtr @auhRNhShhT]ubjV)r¡@}r¢@(h=X haddock-allr£@h>j–@hDhEhFjZhH}r¤@(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¥@h]X haddock-allr¦@…r§@}r¨@(h=UhDNhRNhShh>j¡@ubaubj`)r©@}rª@(h=jch>j–@hDhEhFjdhH}r«@(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¬@h]X: r­@…r®@}r¯@(h=UhDNhRNhShh>j©@ubaubjj)r°@}r±@(h=Xbooleanh>j–@hDhEhFjmhH}r²@(jjhM]hL]hJ]hK]hP]uhRNhShhT]r³@h]Xbooleanr´@…rµ@}r¶@(h=UhDNhRNhShh>j°@ubaubeubjs)r·@}r¸@(h=Uh>j‘@hDhEhFjvhH}r¹@(hJ]hK]hL]hM]hP]uhRNhShhT]rº@(jy)r»@}r¼@(h=Uh>j·@hDhEhFj|hH}r½@(hJ]hK]hL]hM]hP]uhRNhShhT]r¾@j)r¿@}rÀ@(h=UhH}rÁ@(hJ]hK]hL]hM]hP]uh>j»@hT]rÂ@(j„)rÃ@}rÄ@(h=X Default valueh>j¿@hDhEhFj‡hH}rÅ@(hJ]hK]hL]hM]hP]uhRKhT]rÆ@h]X Default valuerÇ@…rÈ@}rÉ@(h=Uh>jÃ@ubaubj)rÊ@}rË@(h=UhH}rÌ@(hJ]hK]hL]hM]hP]uh>j¿@hT]rÍ@hp)rÎ@}rÏ@(h=XFalsehH}rÐ@(hJ]hK]hL]hM]hP]uh>jÊ@hT]rÑ@h]XFalserÒ@…rÓ@}rÔ@(h=XFalsehDNhRNhShh>jÎ@ubahFhtubahFjubehFjžubaubhp)rÕ@}rÖ@(h=XRun haddock on all components.r×@h>j·@hDhEhFhthH}rØ@(hJ]hK]hL]hM]hP]uhRM^hShhT]rÙ@h]XRun haddock on all components.rÚ@…rÛ@}rÜ@(h=j×@hDNhRNhShh>jÕ@ubaubhp)rÝ@}rÞ@(h=XTThe command line variant of this flag is ``--all`` (for the ``haddock`` subcommand).h>j·@hDhEhFhthH}rß@(hJ]hK]hL]hM]hP]uhRM`hShhT]rà@(h]X)The command line variant of this flag is rá@…râ@}rã@(h=X)The command line variant of this flag is hDNhRNhShh>jÝ@ubh–)rä@}rå@(h=X ``--all``hH}ræ@(hJ]hK]hL]hM]hP]uh>jÝ@hT]rç@h]X--allrè@…ré@}rê@(h=X--allh>jä@ubahFhžubh]X (for the rë@…rì@}rí@(h=X (for the hDNhRNhShh>jÝ@ubh–)rî@}rï@(h=X ``haddock``hH}rð@(hJ]hK]hL]hM]hP]uh>jÝ@hT]rñ@h]Xhaddockrò@…ró@}rô@(h=Xhaddockh>jî@ubahFhžubh]X subcommand).rõ@…rö@}r÷@(h=X subcommand).hDNhRNhShh>jÝ@ubeubeubeubj7)rø@}rù@(h=Uh>jf hDhEhFj:hH}rú@(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rû@}rü@(h=Uh>jf hDhEhFj?hH}rý@(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrþ@jEjþ@uhRNhShhT]rÿ@(jG)rA}rA(h=Xhaddock-internal: booleanh>jû@hDhEhFjJhH}rA(hM]rAXcfg-field-haddock-internalrAahL]hJ]hK]hP]jN‰uhRNhShhT]rA(j7)rA}rA(h=Uh>jAhDhEhFj:hH}rA(hM]hL]hJ]hK]hP]Uentries]r A(jTX'haddock-internal ; cabal project optionjAUNtr AauhRNhShhT]ubjV)r A}r A(h=Xhaddock-internalr Ah>jAhDhEhFjZhH}rA(jjhM]hL]hJ]hK]hP]uhRNhShhT]rAh]Xhaddock-internalrA…rA}rA(h=UhDNhRNhShh>j Aubaubj`)rA}rA(h=jch>jAhDhEhFjdhH}rA(jjhM]hL]hJ]hK]hP]uhRNhShhT]rAh]X: rA…rA}rA(h=UhDNhRNhShh>jAubaubjj)rA}rA(h=Xbooleanh>jAhDhEhFjmhH}rA(jjhM]hL]hJ]hK]hP]uhRNhShhT]rAh]XbooleanrA…rA}r A(h=UhDNhRNhShh>jAubaubeubjs)r!A}r"A(h=Uh>jû@hDhEhFjvhH}r#A(hJ]hK]hL]hM]hP]uhRNhShhT]r$A(jy)r%A}r&A(h=Uh>j!AhDhEhFj|hH}r'A(hJ]hK]hL]hM]hP]uhRNhShhT]r(Aj)r)A}r*A(h=UhH}r+A(hJ]hK]hL]hM]hP]uh>j%AhT]r,A(j„)r-A}r.A(h=X Default valueh>j)AhDhEhFj‡hH}r/A(hJ]hK]hL]hM]hP]uhRKhT]r0Ah]X Default valuer1A…r2A}r3A(h=Uh>j-Aubaubj)r4A}r5A(h=UhH}r6A(hJ]hK]hL]hM]hP]uh>j)AhT]r7Ahp)r8A}r9A(h=XFalsehH}r:A(hJ]hK]hL]hM]hP]uh>j4AhT]r;Ah]XFalserA(h=XFalsehDNhRNhShh>j8AubahFhtubahFjubehFjžubaubhp)r?A}r@A(h=XIBuild haddock documentation which includes unexposed modules and symbols.rAAh>j!AhDhEhFhthH}rBA(hJ]hK]hL]hM]hP]uhRMhhShhT]rCAh]XIBuild haddock documentation which includes unexposed modules and symbols.rDA…rEA}rFA(h=jAAhDNhRNhShh>j?Aubaubhp)rGA}rHA(h=XYThe command line variant of this flag is ``--internal`` (for the ``haddock`` subcommand).h>j!AhDhEhFhthH}rIA(hJ]hK]hL]hM]hP]uhRMkhShhT]rJA(h]X)The command line variant of this flag is rKA…rLA}rMA(h=X)The command line variant of this flag is hDNhRNhShh>jGAubh–)rNA}rOA(h=X``--internal``hH}rPA(hJ]hK]hL]hM]hP]uh>jGAhT]rQAh]X --internalrRA…rSA}rTA(h=X --internalh>jNAubahFhžubh]X (for the rUA…rVA}rWA(h=X (for the hDNhRNhShh>jGAubh–)rXA}rYA(h=X ``haddock``hH}rZA(hJ]hK]hL]hM]hP]uh>jGAhT]r[Ah]Xhaddockr\A…r]A}r^A(h=Xhaddockh>jXAubahFhžubh]X subcommand).r_A…r`A}raA(h=X subcommand).hDNhRNhShh>jGAubeubeubeubj7)rbA}rcA(h=Uh>jf hDhEhFj:hH}rdA(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)reA}rfA(h=Uh>jf hDhEhFj?hH}rgA(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrhAjEjhAuhRNhShhT]riA(jG)rjA}rkA(h=Xhaddock-css: pathh>jeAhDhEhFjJhH}rlA(hM]rmAXcfg-field-haddock-cssrnAahL]hJ]hK]hP]jN‰uhRNhShhT]roA(j7)rpA}rqA(h=Uh>jjAhDhEhFj:hH}rrA(hM]hL]hJ]hK]hP]Uentries]rsA(jTX"haddock-css ; cabal project optionjnAUNtrtAauhRNhShhT]ubjV)ruA}rvA(h=X haddock-cssrwAh>jjAhDhEhFjZhH}rxA(jjhM]hL]hJ]hK]hP]uhRNhShhT]ryAh]X haddock-cssrzA…r{A}r|A(h=UhDNhRNhShh>juAubaubj`)r}A}r~A(h=jch>jjAhDhEhFjdhH}rA(jjhM]hL]hJ]hK]hP]uhRNhShhT]r€Ah]X: rA…r‚A}rƒA(h=UhDNhRNhShh>j}Aubaubjj)r„A}r…A(h=Xpathh>jjAhDhEhFjmhH}r†A(jjhM]hL]hJ]hK]hP]uhRNhShhT]r‡Ah]XpathrˆA…r‰A}rŠA(h=UhDNhRNhShh>j„Aubaubeubjs)r‹A}rŒA(h=Uh>jeAhDhEhFjvhH}rA(hJ]hK]hL]hM]hP]uhRNhShhT]rŽA(hp)rA}rA(h=XeThe CSS file that should be used to style the generated documentation (overriding haddock's default.)r‘Ah>j‹AhDhEhFhthH}r’A(hJ]hK]hL]hM]hP]uhRMqhShhT]r“Ah]XgThe CSS file that should be used to style the generated documentation (overriding haddock’s default.)r”A…r•A}r–A(h=j‘AhDNhRNhShh>jAubaubhp)r—A}r˜A(h=XTThe command line variant of this flag is ``--css`` (for the ``haddock`` subcommand).h>j‹AhDhEhFhthH}r™A(hJ]hK]hL]hM]hP]uhRMthShhT]ršA(h]X)The command line variant of this flag is r›A…rœA}rA(h=X)The command line variant of this flag is hDNhRNhShh>j—Aubh–)ržA}rŸA(h=X ``--css``hH}r A(hJ]hK]hL]hM]hP]uh>j—AhT]r¡Ah]X--cssr¢A…r£A}r¤A(h=X--cssh>jžAubahFhžubh]X (for the r¥A…r¦A}r§A(h=X (for the hDNhRNhShh>j—Aubh–)r¨A}r©A(h=X ``haddock``hH}rªA(hJ]hK]hL]hM]hP]uh>j—AhT]r«Ah]Xhaddockr¬A…r­A}r®A(h=Xhaddockh>j¨AubahFhžubh]X subcommand).r¯A…r°A}r±A(h=X subcommand).hDNhRNhShh>j—Aubeubeubeubj7)r²A}r³A(h=Uh>jf hDhEhFj:hH}r´A(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rµA}r¶A(h=Uh>jf hDhEhFj?hH}r·A(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr¸AjEj¸AuhRNhShhT]r¹A(jG)rºA}r»A(h=X!haddock-hyperlink-source: booleanh>jµAhDhEhFjJhH}r¼A(hM]r½AX"cfg-field-haddock-hyperlink-sourcer¾AahL]hJ]hK]hP]jN‰uhRNhShhT]r¿A(j7)rÀA}rÁA(h=Uh>jºAhDhEhFj:hH}rÂA(hM]hL]hJ]hK]hP]Uentries]rÃA(jTX/haddock-hyperlink-source ; cabal project optionj¾AUNtrÄAauhRNhShhT]ubjV)rÅA}rÆA(h=Xhaddock-hyperlink-sourcerÇAh>jºAhDhEhFjZhH}rÈA(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÉAh]Xhaddock-hyperlink-sourcerÊA…rËA}rÌA(h=UhDNhRNhShh>jÅAubaubj`)rÍA}rÎA(h=jch>jºAhDhEhFjdhH}rÏA(jjhM]hL]hJ]hK]hP]uhRNhShhT]rÐAh]X: rÑA…rÒA}rÓA(h=UhDNhRNhShh>jÍAubaubjj)rÔA}rÕA(h=Xbooleanh>jºAhDhEhFjmhH}rÖA(jjhM]hL]hJ]hK]hP]uhRNhShhT]r×Ah]XbooleanrØA…rÙA}rÚA(h=UhDNhRNhShh>jÔAubaubeubjs)rÛA}rÜA(h=Uh>jµAhDhEhFjvhH}rÝA(hJ]hK]hL]hM]hP]uhRNhShhT]rÞA(jy)rßA}ràA(h=Uh>jÛAhDhEhFj|hH}ráA(hJ]hK]hL]hM]hP]uhRNhShhT]râAj)rãA}räA(h=UhH}råA(hJ]hK]hL]hM]hP]uh>jßAhT]ræA(j„)rçA}rèA(h=X Default valueh>jãAhDhEhFj‡hH}réA(hJ]hK]hL]hM]hP]uhRKhT]rêAh]X Default valuerëA…rìA}ríA(h=Uh>jçAubaubj)rîA}rïA(h=UhH}rðA(hJ]hK]hL]hM]hP]uh>jãAhT]rñAhp)ròA}róA(h=XFalsehH}rôA(hJ]hK]hL]hM]hP]uh>jîAhT]rõAh]XFalseröA…r÷A}røA(h=XFalsehDNhRNhShh>jòAubahFhtubahFjubehFjžubaubhp)rùA}rúA(h=X_Generated hyperlinked source code using `HsColour`_, and have Haddock documentation link to it.h>jÛAhDhEhFhthH}rûA(hJ]hK]hL]hM]hP]uhRM|hShhT]rüA(h]X(Generated hyperlinked source code using rýA…rþA}rÿA(h=X(Generated hyperlinked source code using hDNhRNhShh>jùAubjæ)rB}rB(h=X `HsColour`_jÑKh>jùAhFjïhH}rB(UnameXHsColourrBjêjá"hM]hL]hJ]hK]hP]uhT]rBh]XHsColourrB…rB}rB(h=jBh>jBubaubh]X,, and have Haddock documentation link to it.rB…r B}r B(h=X,, and have Haddock documentation link to it.hDNhRNhShh>jùAubeubhp)r B}r B(h=XaThe command line variant of this flag is ``--hyperlink-source`` (for the ``haddock`` subcommand).h>jÛAhDhEhFhthH}r B(hJ]hK]hL]hM]hP]uhRMhShhT]rB(h]X)The command line variant of this flag is rB…rB}rB(h=X)The command line variant of this flag is hDNhRNhShh>j Bubh–)rB}rB(h=X``--hyperlink-source``hH}rB(hJ]hK]hL]hM]hP]uh>j BhT]rBh]X--hyperlink-sourcerB…rB}rB(h=X--hyperlink-sourceh>jBubahFhžubh]X (for the rB…rB}rB(h=X (for the hDNhRNhShh>j Bubh–)rB}rB(h=X ``haddock``hH}rB(hJ]hK]hL]hM]hP]uh>j BhT]rBh]Xhaddockr B…r!B}r"B(h=Xhaddockh>jBubahFhžubh]X subcommand).r#B…r$B}r%B(h=X subcommand).hDNhRNhShh>j Bubeubeubeubj7)r&B}r'B(h=Uh>jf hDhEhFj:hH}r(B(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)r)B}r*B(h=Uh>jf hDhEhFj?hH}r+B(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr,BjEj,BuhRNhShhT]r-B(jG)r.B}r/B(h=Xhaddock-hscolour-css: pathh>j)BhDhEhFjJhH}r0B(hM]r1BXcfg-field-haddock-hscolour-cssr2BahL]hJ]hK]hP]jN‰uhRNhShhT]r3B(j7)r4B}r5B(h=Uh>j.BhDhEhFj:hH}r6B(hM]hL]hJ]hK]hP]Uentries]r7B(jTX+haddock-hscolour-css ; cabal project optionj2BUNtr8BauhRNhShhT]ubjV)r9B}r:B(h=Xhaddock-hscolour-cssr;Bh>j.BhDhEhFjZhH}rB…r?B}r@B(h=UhDNhRNhShh>j9Bubaubj`)rAB}rBB(h=jch>j.BhDhEhFjdhH}rCB(jjhM]hL]hJ]hK]hP]uhRNhShhT]rDBh]X: rEB…rFB}rGB(h=UhDNhRNhShh>jABubaubjj)rHB}rIB(h=Xpathh>j.BhDhEhFjmhH}rJB(jjhM]hL]hJ]hK]hP]uhRNhShhT]rKBh]XpathrLB…rMB}rNB(h=UhDNhRNhShh>jHBubaubeubjs)rOB}rPB(h=Uh>j)BhDhEhFjvhH}rQB(hJ]hK]hL]hM]hP]uhRNhShhT]rRB(hp)rSB}rTB(h=XcThe CSS file that should be used to style the generated hyperlinked source code (from `HsColour`_).h>jOBhDhEhFhthH}rUB(hJ]hK]hL]hM]hP]uhRM…hShhT]rVB(h]XVThe CSS file that should be used to style the generated hyperlinked source code (from rWB…rXB}rYB(h=XVThe CSS file that should be used to style the generated hyperlinked source code (from hDNhRNhShh>jSBubjæ)rZB}r[B(h=X `HsColour`_jÑKh>jSBhFjïhH}r\B(UnameXHsColourr]Bjêjá"hM]hL]hJ]hK]hP]uhT]r^Bh]XHsColourr_B…r`B}raB(h=j]Bh>jZBubaubh]X).rbB…rcB}rdB(h=X).hDNhRNhShh>jSBubeubhp)reB}rfB(h=X]The command line variant of this flag is ``--hscolour-css`` (for the ``haddock`` subcommand).h>jOBhDhEhFhthH}rgB(hJ]hK]hL]hM]hP]uhRMˆhShhT]rhB(h]X)The command line variant of this flag is riB…rjB}rkB(h=X)The command line variant of this flag is hDNhRNhShh>jeBubh–)rlB}rmB(h=X``--hscolour-css``hH}rnB(hJ]hK]hL]hM]hP]uh>jeBhT]roBh]X--hscolour-cssrpB…rqB}rrB(h=X--hscolour-cssh>jlBubahFhžubh]X (for the rsB…rtB}ruB(h=X (for the hDNhRNhShh>jeBubh–)rvB}rwB(h=X ``haddock``hH}rxB(hJ]hK]hL]hM]hP]uh>jeBhT]ryBh]XhaddockrzB…r{B}r|B(h=Xhaddockh>jvBubahFhžubh]X subcommand).r}B…r~B}rB(h=X subcommand).hDNhRNhShh>jeBubeubeubeubj7)r€B}rB(h=Uh>jf hDhEhFj:hH}r‚B(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rƒB}r„B(h=Uh>jf hDhEhFj?hH}r…B(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldr†BjEj†BuhRNhShhT]r‡B(jG)rˆB}r‰B(h=Xhaddock-contents-location: URLh>jƒBhDhEhFjJhH}rŠB(hM]r‹BX#cfg-field-haddock-contents-locationrŒBahL]hJ]hK]hP]jN‰uhRNhShhT]rB(j7)rŽB}rB(h=Uh>jˆBhDhEhFj:hH}rB(hM]hL]hJ]hK]hP]Uentries]r‘B(jTX0haddock-contents-location ; cabal project optionjŒBUNtr’BauhRNhShhT]ubjV)r“B}r”B(h=Xhaddock-contents-locationr•Bh>jˆBhDhEhFjZhH}r–B(jjhM]hL]hJ]hK]hP]uhRNhShhT]r—Bh]Xhaddock-contents-locationr˜B…r™B}ršB(h=UhDNhRNhShh>j“Bubaubj`)r›B}rœB(h=jch>jˆBhDhEhFjdhH}rB(jjhM]hL]hJ]hK]hP]uhRNhShhT]ržBh]X: rŸB…r B}r¡B(h=UhDNhRNhShh>j›Bubaubjj)r¢B}r£B(h=XURLh>jˆBhDhEhFjmhH}r¤B(jjhM]hL]hJ]hK]hP]uhRNhShhT]r¥Bh]XURLr¦B…r§B}r¨B(h=UhDNhRNhShh>j¢Bubaubeubjs)r©B}rªB(h=Uh>jƒBhDhEhFjvhH}r«B(hJ]hK]hL]hM]hP]uhRNhShhT]r¬B(hp)r­B}r®B(h=X@A baked-in URL to be used as the location for the contents page.r¯Bh>j©BhDhEhFhthH}r°B(hJ]hK]hL]hM]hP]uhRMŽhShhT]r±Bh]X@A baked-in URL to be used as the location for the contents page.r²B…r³B}r´B(h=j¯BhDNhRNhShh>j­Bubaubhp)rµB}r¶B(h=XbThe command line variant of this flag is ``--contents-location`` (for the ``haddock`` subcommand).h>j©BhDhEhFhthH}r·B(hJ]hK]hL]hM]hP]uhRMhShhT]r¸B(h]X)The command line variant of this flag is r¹B…rºB}r»B(h=X)The command line variant of this flag is hDNhRNhShh>jµBubh–)r¼B}r½B(h=X``--contents-location``hH}r¾B(hJ]hK]hL]hM]hP]uh>jµBhT]r¿Bh]X--contents-locationrÀB…rÁB}rÂB(h=X--contents-locationh>j¼BubahFhžubh]X (for the rÃB…rÄB}rÅB(h=X (for the hDNhRNhShh>jµBubh–)rÆB}rÇB(h=X ``haddock``hH}rÈB(hJ]hK]hL]hM]hP]uh>jµBhT]rÉBh]XhaddockrÊB…rËB}rÌB(h=Xhaddockh>jÆBubahFhžubh]X subcommand).rÍB…rÎB}rÏB(h=X subcommand).hDNhRNhShh>jµBubeubeubeubj7)rÐB}rÑB(h=Uh>jf hDhEhFj:hH}rÒB(hM]hL]hJ]hK]hP]Uentries]uhRNhShhT]ubj<)rÓB}rÔB(h=Uh>jf hDhEhFj?hH}rÕB(jA‰jBXcabalhM]hL]hJ]hK]hP]jCX cfg-fieldrÖBjEjÖBuhRNhShhT]r×B(jG)rØB}rÙB(h=X haddock-keep-temp-files: booleanh>jÓBhDhEhFjJhH}rÚB(hM]rÛBX!cfg-field-haddock-keep-temp-filesrÜBahL]hJ]hK]hP]jN‰uhRNhShhT]rÝB(j7)rÞB}rßB(h=Uh>jØBhDhEhFj:hH}ràB(hM]hL]hJ]hK]hP]Uentries]ráB(jTX.haddock-keep-temp-files ; cabal project optionjÜBUNtrâBauhRNhShhT]ubjV)rãB}räB(h=Xhaddock-keep-temp-filesråBh>jØBhDhEhFjZhH}ræB(jjhM]hL]hJ]hK]hP]uhRNhShhT]rçBh]Xhaddock-keep-temp-filesrèB…réB}rêB(h=UhDNhRNhShh>jãBubaubj`)rëB}rìB(h=jch>jØBhDhEhFjdhH}ríB(jjhM]hL]hJ]hK]hP]uhRNhShhT]rîBh]X: rïB…rðB}rñB(h=UhDNhRNhShh>jëBubaubjj)ròB}róB(h=Xbooleanh>jØBhDhEhFjmhH}rôB(jjhM]hL]hJ]hK]hP]uhRNhShhT]rõBh]XbooleanröB…r÷B}røB(h=UhDNhRNhShh>jòBubaubeubjs)rùB}rúB(h=Uh>jÓBhDhEhFjvhH}rûB(hJ]hK]hL]hM]hP]uhRNhShhT]rüB(hp)rýB}rþB(h=XKeep temporary files.rÿBh>jùBhDhEhFhthH}rC(hJ]hK]hL]hM]hP]uhRM–hShhT]rCh]XKeep temporary files.rC…rC}rC(h=jÿBhDNhRNhShh>jýBubaubhp)rC}rC(h=X`The command line variant of this flag is ``--keep-temp-files`` (for the ``haddock`` subcommand).h>jùBhDhEhFhthH}rC(hJ]hK]hL]hM]hP]uhRM˜hShhT]rC(h]X)The command line variant of this flag is r C…r C}r C(h=X)The command line variant of this flag is hDNhRNhShh>jCubh–)r C}r C(h=X``--keep-temp-files``hH}rC(hJ]hK]hL]hM]hP]uh>jChT]rCh]X--keep-temp-filesrC…rC}rC(h=X--keep-temp-filesh>j CubahFhžubh]X (for the rC…rC}rC(h=X (for the hDNhRNhShh>jCubh–)rC}rC(h=X ``haddock``hH}rC(hJ]hK]hL]hM]hP]uh>jChT]rCh]XhaddockrC…rC}rC(h=Xhaddockh>jCubahFhžubh]X subcommand).rC…rC}rC(h=X subcommand).hDNhRNhShh>jCubeubeubeubeubhDhEhFjZhH}r C(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMHUtypeUSEVEREr!CuhRMIhShhT]r"C(hp)r#C}r$C(h=XTitle level inconsistent:hH}r%C(hJ]hK]hL]hM]hP]uh>jd hT]r&Ch]XTitle level inconsistent:r'C…r(C}r)C(h=Uh>j#CubahFhtubj)r*C}r+C(h=X'Object code options ^^^^^^^^^^^^^^^^^^^h>jd hDhEhFjhH}r,C(jjhM]hL]hJ]hK]hP]uhT]r-Ch]X'Object code options ^^^^^^^^^^^^^^^^^^^r.C…r/C}r0C(h=Uh>j*Cubaubeubh:)r1C}r2C(h=Uh>jf hDhEhFjZhH}r3C(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMªUtypej!CuhRM«hShhT]r4C(hp)r5C}r6C(h=XTitle level inconsistent:hH}r7C(hJ]hK]hL]hM]hP]uh>j1ChT]r8Ch]XTitle level inconsistent:r9C…r:C}r;C(h=Uh>j5CubahFhtubj)rj1ChDhEhFjhH}r>C(jjhM]hL]hJ]hK]hP]uhT]r?Ch]X%Executable options ^^^^^^^^^^^^^^^^^^r@C…rAC}rBC(h=Uh>jjf hDhEhFjZhH}rEC(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMÎUtypej!CuhRMÏhShhT]rFC(hp)rGC}rHC(h=XTitle level inconsistent:hH}rIC(hJ]hK]hL]hM]hP]uh>jCChT]rJCh]XTitle level inconsistent:rKC…rLC}rMC(h=Uh>jGCubahFhtubj)rNC}rOC(h=X/Dynamic linking options ^^^^^^^^^^^^^^^^^^^^^^^h>jCChDhEhFjhH}rPC(jjhM]hL]hJ]hK]hP]uhT]rQCh]X/Dynamic linking options ^^^^^^^^^^^^^^^^^^^^^^^rRC…rSC}rTC(h=Uh>jNCubaubeubh:)rUC}rVC(h=Uh>jf hDhEhFjZhH}rWC(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineM Utypej!CuhRM hShhT]rXC(hp)rYC}rZC(h=XTitle level inconsistent:hH}r[C(hJ]hK]hL]hM]hP]uh>jUChT]r\Ch]XTitle level inconsistent:r]C…r^C}r_C(h=Uh>jYCubahFhtubj)r`C}raC(h=X-Static linking options ^^^^^^^^^^^^^^^^^^^^^^h>jUChDhEhFjhH}rbC(jjhM]hL]hJ]hK]hP]uhT]rcCh]X-Static linking options ^^^^^^^^^^^^^^^^^^^^^^rdC…reC}rfC(h=Uh>j`Cubaubeubh:)rgC}rhC(h=Uh>jf hDhEhFjZhH}riC(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineM&Utypej!CuhRM'hShhT]rjC(hp)rkC}rlC(h=XTitle level inconsistent:hH}rmC(hJ]hK]hL]hM]hP]uh>jgChT]rnCh]XTitle level inconsistent:roC…rpC}rqC(h=Uh>jkCubahFhtubj)rrC}rsC(h=XEForeign function interface options ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^h>jgChDhEhFjhH}rtC(jjhM]hL]hJ]hK]hP]uhT]ruCh]XEForeign function interface options ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^rvC…rwC}rxC(h=Uh>jrCubaubeubh:)ryC}rzC(h=Uh>jf hDhEhFjZhH}r{C(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMZUtypej!CuhRM[hShhT]r|C(hp)r}C}r~C(h=XTitle level inconsistent:hH}rC(hJ]hK]hL]hM]hP]uh>jyChT]r€Ch]XTitle level inconsistent:rC…r‚C}rƒC(h=Uh>j}CubahFhtubj)r„C}r…C(h=X#Profiling options ^^^^^^^^^^^^^^^^^h>jyChDhEhFjhH}r†C(jjhM]hL]hJ]hK]hP]uhT]r‡Ch]X#Profiling options ^^^^^^^^^^^^^^^^^rˆC…r‰C}rŠC(h=Uh>j„Cubaubeubh:)r‹C}rŒC(h=Uh>jf hDhEhFjZhH}rC(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMÑUtypej!CuhRMÒhShhT]rŽC(hp)rC}rC(h=XTitle level inconsistent:hH}r‘C(hJ]hK]hL]hM]hP]uh>j‹ChT]r’Ch]XTitle level inconsistent:r“C…r”C}r•C(h=Uh>jCubahFhtubj)r–C}r—C(h=X!Coverage options ^^^^^^^^^^^^^^^^h>j‹ChDhEhFjhH}r˜C(jjhM]hL]hJ]hK]hP]uhT]r™Ch]X!Coverage options ^^^^^^^^^^^^^^^^ršC…r›C}rœC(h=Uh>j–Cubaubeubh:)rC}ržC(h=Uh>jf hDhEhFjZhH}rŸC(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMðUtypej!CuhRMñhShhT]r C(hp)r¡C}r¢C(h=XTitle level inconsistent:hH}r£C(hJ]hK]hL]hM]hP]uh>jChT]r¤Ch]XTitle level inconsistent:r¥C…r¦C}r§C(h=Uh>j¡CubahFhtubj)r¨C}r©C(h=XHaddock options ^^^^^^^^^^^^^^^h>jChDhEhFjhH}rªC(jjhM]hL]hJ]hK]hP]uhT]r«Ch]XHaddock options ^^^^^^^^^^^^^^^r¬C…r­C}r®C(h=Uh>j¨Cubaubeubh:)r¯C}r°C(h=Uh>j¨hDhEhFjZhH}r±C(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMUtypej!CuhRMhShhT]r²C(hp)r³C}r´C(h=XTitle level inconsistent:hH}rµC(hJ]hK]hL]hM]hP]uh>j¯ChT]r¶Ch]XTitle level inconsistent:r·C…r¸C}r¹C(h=Uh>j³CubahFhtubj)rºC}r»C(h=X/Advanced solver options ^^^^^^^^^^^^^^^^^^^^^^^h>j¯ChDhEhFjhH}r¼C(jjhM]hL]hJ]hK]hP]uhT]r½Ch]X/Advanced solver options ^^^^^^^^^^^^^^^^^^^^^^^r¾C…r¿C}rÀC(h=Uh>jºCubaubeubeUcurrent_sourcerÁCNU decorationrÂCNUautofootnote_startrÃCKUnameidsrÄC}rÅC(hjl hU(how-can-i-profile-my-library-applicationrÆChU quickstartrÇCh jQh jÙh j_h jPh j°"hjŒhjÜ"hj3hjã"hjl hjøhj¬hjõ"hj/hjßhjÛhj½"hj$hj/hj(hjé"hjŠhjÕ"h jøh!jÃ"h"j‡h#jmh$hOh%j¶"h&jëh'jJ h(Udeveloping-multiple-packagesrÈCh)jï"h*j– h+jsh,jB h-jÏ"h.j­h/j{h0heh1jÉ"h2jOh3jù"h4j’h5UcookbookrÉCuhT]rÊC(j)rËC}rÌC(h=Uh>hhDhEhFjhH}rÍC(UlangXconsoleUlinenothresholdI9223372036854775807 hM]hL]hJ]hK]hP]uhRKhShhT]ubh?)rÎC}rÏC(h=Uh>hhDhEhFhGhH}rÐC(hJ]hK]hL]hM]rÑCjÇCahP]rÒChauhRKhShhT]rÓC(hV)rÔC}rÕC(h=X QuickstartrÖCh>jÎChDhEhFhZhH}r×C(hJ]hK]hL]hM]hP]uhRKhShhT]rØCh]X QuickstartrÙC…rÚC}rÛC(h=jÖChDNhRNhShh>jÔCubaubhp)rÜC}rÝC(h=X@Suppose that you are in a directory containing a single Cabal package which you wish to build (if you haven't set up a package yet check out `developing packages `__ for instructions). You can configure and build it using Nix-style local builds with this command (configuring is not necessary):h>jÎChDhEhFhthH}rÞC(hJ]hK]hL]hM]hP]uhRKhShhT]rßC(h]XSuppose that you are in a directory containing a single Cabal package which you wish to build (if you haven’t set up a package yet check out ràC…ráC}râC(h=XSuppose that you are in a directory containing a single Cabal package which you wish to build (if you haven't set up a package yet check out hDNhRNhShh>jÜCubjæ)rãC}räC(h=X2`developing packages `__hH}råC(UnameXdeveloping packagesjêXdeveloping-packages.htmlhM]hL]hJ]hK]hP]uh>jÜChT]ræCh]Xdeveloping packagesrçC…rèC}réC(h=Xdeveloping packagesh>jãCubahFjïubh]X for instructions). You can configure and build it using Nix-style local builds with this command (configuring is not necessary):rêC…rëC}rìC(h=X for instructions). You can configure and build it using Nix-style local builds with this command (configuring is not necessary):hDNhRNhShh>jÜCubeubj)ríC}rîC(h=X$ cabal v2-buildh>jÎChDhEhFjhH}rïC(jjhM]hL]hJ]hK]hP]uhRKhShhT]rðCh]X$ cabal v2-buildrñC…ròC}róC(h=Uh>jíCubaubhp)rôC}rõC(h=X9To open a GHCi shell with this package, use this command:röCh>jÎChDhEhFhthH}r÷C(hJ]hK]hL]hM]hP]uhRKhShhT]røCh]X9To open a GHCi shell with this package, use this command:rùC…rúC}rûC(h=jöChDNhRNhShh>jôCubaubj)rüC}rýC(h=X$ cabal v2-replh>jÎChDhEhFjhH}rþC(jjhM]hL]hJ]hK]hP]uhRKhShhT]rÿCh]X$ cabal v2-replrD…rD}rD(h=Uh>jüCubaubhp)rD}rD(h=X?To run an executable defined in this package, use this command:rDh>jÎChDhEhFhthH}rD(hJ]hK]hL]hM]hP]uhRKhShhT]rDh]X?To run an executable defined in this package, use this command:rD…r D}r D(h=jDhDNhRNhShh>jDubaubj)r D}r D(h=X2$ cabal v2-run [executable args]h>jÎChDhEhFjhH}r D(jjhM]hL]hJ]hK]hP]uhRKhShhT]rDh]X2$ cabal v2-run [executable args]rD…rD}rD(h=Uh>j Dubaubh?)rD}rD(h=Uh>jÎChDhEhFhGhH}rD(hJ]hK]hL]hM]rDjÈCahP]rDh(auhRKhShhT]rD(hV)rD}rD(h=XDeveloping multiple packagesrDh>jDhDhEhFhZhH}rD(hJ]hK]hL]hM]hP]uhRKhShhT]rDh]XDeveloping multiple packagesrD…rD}rD(h=jDhDNhRNhShh>jDubaubhp)r D}r!D(h=X¶Many Cabal projects involve multiple packages which need to be built together. To build multiple Cabal packages, you need to first create a ``cabal.project`` file which declares where all the local package directories live. For example, in the Cabal repository, there is a root directory with a folder per package, e.g., the folders ``Cabal`` and ``cabal-install``. The ``cabal.project`` file specifies each folder as part of the project:h>jDhDhEhFhthH}r"D(hJ]hK]hL]hM]hP]uhRKhShhT]r#D(h]XŒMany Cabal projects involve multiple packages which need to be built together. To build multiple Cabal packages, you need to first create a r$D…r%D}r&D(h=XŒMany Cabal projects involve multiple packages which need to be built together. To build multiple Cabal packages, you need to first create a hDNhRNhShh>j Dubh–)r'D}r(D(h=X``cabal.project``hH}r)D(hJ]hK]hL]hM]hP]uh>j DhT]r*Dh]X cabal.projectr+D…r,D}r-D(h=X cabal.projecth>j'DubahFhžubh]X° file which declares where all the local package directories live. For example, in the Cabal repository, there is a root directory with a folder per package, e.g., the folders r.D…r/D}r0D(h=X° file which declares where all the local package directories live. For example, in the Cabal repository, there is a root directory with a folder per package, e.g., the folders hDNhRNhShh>j Dubh–)r1D}r2D(h=X ``Cabal``hH}r3D(hJ]hK]hL]hM]hP]uh>j DhT]r4Dh]XCabalr5D…r6D}r7D(h=XCabalh>j1DubahFhžubh]X and r8D…r9D}r:D(h=X and hDNhRNhShh>j Dubh–)r;D}rj DhT]r>Dh]X cabal-installr?D…r@D}rAD(h=X cabal-installh>j;DubahFhžubh]X. The rBD…rCD}rDD(h=X. The hDNhRNhShh>j Dubh–)rED}rFD(h=X``cabal.project``hH}rGD(hJ]hK]hL]hM]hP]uh>j DhT]rHDh]X cabal.projectrID…rJD}rKD(h=X cabal.projecth>jEDubahFhžubh]X3 file specifies each folder as part of the project:rLD…rMD}rND(h=X3 file specifies each folder as part of the project:hDNhRNhShh>j Dubeubj)rOD}rPD(h=X)packages: Cabal/ cabal-install/h>jDhDhEhFjhH}rQD(jà‰jáXcabaljjhM]hL]hJ]jâ}hK]hP]uhRK'hShhT]rRDh]X)packages: Cabal/ cabal-install/rSD…rTD}rUD(h=Uh>jODubaubhp)rVD}rWD(h=XîThe expectation is that a ``cabal.project`` is checked into your source control, to be used by all developers of a project. If you need to make local changes, they can be placed in ``cabal.project.local`` (which should not be checked in.)h>jDhDhEhFhthH}rXD(hJ]hK]hL]hM]hP]uhRK,hShhT]rYD(h]XThe expectation is that a rZD…r[D}r\D(h=XThe expectation is that a hDNhRNhShh>jVDubh–)r]D}r^D(h=X``cabal.project``hH}r_D(hJ]hK]hL]hM]hP]uh>jVDhT]r`Dh]X cabal.projectraD…rbD}rcD(h=X cabal.projecth>j]DubahFhžubh]XŠ is checked into your source control, to be used by all developers of a project. If you need to make local changes, they can be placed in rdD…reD}rfD(h=XŠ is checked into your source control, to be used by all developers of a project. If you need to make local changes, they can be placed in hDNhRNhShh>jVDubh–)rgD}rhD(h=X``cabal.project.local``hH}riD(hJ]hK]hL]hM]hP]uh>jVDhT]rjDh]Xcabal.project.localrkD…rlD}rmD(h=Xcabal.project.localh>jgDubahFhžubh]X" (which should not be checked in.)rnD…roD}rpD(h=X" (which should not be checked in.)hDNhRNhShh>jVDubeubhp)rqD}rrD(h=X…Then, to build every component of every package, from the top-level directory, run the command: (using cabal-install-2.0 or greater.)rsDh>jDhDhEhFhthH}rtD(hJ]hK]hL]hM]hP]uhRK1hShhT]ruDh]X…Then, to build every component of every package, from the top-level directory, run the command: (using cabal-install-2.0 or greater.)rvD…rwD}rxD(h=jsDhDNhRNhShh>jqDubaubj)ryD}rzD(h=X$ cabal v2-buildh>jDhDhEhFjhH}r{D(jjhM]hL]hJ]hK]hP]uhRK6hShhT]r|Dh]X$ cabal v2-buildr}D…r~D}rD(h=Uh>jyDubaubhp)r€D}rD(h=XkTo build a specific package, you can either run ``v2-build`` from the directory of the package in question:h>jDhDhEhFhthH}r‚D(hJ]hK]hL]hM]hP]uhRK8hShhT]rƒD(h]X0To build a specific package, you can either run r„D…r…D}r†D(h=X0To build a specific package, you can either run hDNhRNhShh>j€Dubh–)r‡D}rˆD(h=X ``v2-build``hH}r‰D(hJ]hK]hL]hM]hP]uh>j€DhT]rŠDh]Xv2-buildr‹D…rŒD}rD(h=Xv2-buildh>j‡DubahFhžubh]X/ from the directory of the package in question:rŽD…rD}rD(h=X/ from the directory of the package in question:hDNhRNhShh>j€Dubeubj)r‘D}r’D(h=X#$ cd cabal-install $ cabal v2-buildh>jDhDhEhFjhH}r“D(jjhM]hL]hJ]hK]hP]uhRK=hShhT]r”Dh]X#$ cd cabal-install $ cabal v2-buildr•D…r–D}r—D(h=Uh>j‘Dubaubhp)r˜D}r™D(h=X}or you can pass the name of the package as an argument to ``cabal v2-build`` (this works in any subdirectory of the project):h>jDhDhEhFhthH}ršD(hJ]hK]hL]hM]hP]uhRK@hShhT]r›D(h]X:or you can pass the name of the package as an argument to rœD…rD}ržD(h=X:or you can pass the name of the package as an argument to hDNhRNhShh>j˜Dubh–)rŸD}r D(h=X``cabal v2-build``hH}r¡D(hJ]hK]hL]hM]hP]uh>j˜DhT]r¢Dh]Xcabal v2-buildr£D…r¤D}r¥D(h=Xcabal v2-buildh>jŸDubahFhžubh]X1 (this works in any subdirectory of the project):r¦D…r§D}r¨D(h=X1 (this works in any subdirectory of the project):hDNhRNhShh>j˜Dubeubj)r©D}rªD(h=X$ cabal v2-build cabal-installh>jDhDhEhFjhH}r«D(jjhM]hL]hJ]hK]hP]uhRKEhShhT]r¬Dh]X$ cabal v2-build cabal-installr­D…r®D}r¯D(h=Uh>j©Dubaubhp)r°D}r±D(h=XYou can also specify a specific component of the package to build. For example, to build a test suite named ``package-tests``, use the command:h>jDhDhEhFhthH}r²D(hJ]hK]hL]hM]hP]uhRKGhShhT]r³D(h]XlYou can also specify a specific component of the package to build. For example, to build a test suite named r´D…rµD}r¶D(h=XlYou can also specify a specific component of the package to build. For example, to build a test suite named hDNhRNhShh>j°Dubh–)r·D}r¸D(h=X``package-tests``hH}r¹D(hJ]hK]hL]hM]hP]uh>j°DhT]rºDh]X package-testsr»D…r¼D}r½D(h=X package-testsh>j·DubahFhžubh]X, use the command:r¾D…r¿D}rÀD(h=X, use the command:hDNhRNhShh>j°Dubeubj)rÁD}rÂD(h=X$ cabal v2-build package-testsh>jDhDhEhFjhH}rÃD(jjhM]hL]hJ]hK]hP]uhRKLhShhT]rÄDh]X$ cabal v2-build package-testsrÅD…rÆD}rÇD(h=Uh>jÁDubaubhp)rÈD}rÉD(h=X‡Targets can be qualified with package names. So to request ``package-tests`` *from* the ``Cabal`` package, use ``Cabal:package-tests``.h>jDhDhEhFhthH}rÊD(hJ]hK]hL]hM]hP]uhRKNhShhT]rËD(h]X;Targets can be qualified with package names. So to request rÌD…rÍD}rÎD(h=X;Targets can be qualified with package names. So to request hDNhRNhShh>jÈDubh–)rÏD}rÐD(h=X``package-tests``hH}rÑD(hJ]hK]hL]hM]hP]uh>jÈDhT]rÒDh]X package-testsrÓD…rÔD}rÕD(h=X package-testsh>jÏDubahFhžubh]X …rÖD}r×D(h=X hDNhRNhShh>jÈDubj))rØD}rÙD(h=X*from*hH}rÚD(hJ]hK]hL]hM]hP]uh>jÈDhT]rÛDh]XfromrÜD…rÝD}rÞD(h=Xfromh>jØDubahFj1ubh]X the rßD…ràD}ráD(h=X the hDNhRNhShh>jÈDubh–)râD}rãD(h=X ``Cabal``hH}räD(hJ]hK]hL]hM]hP]uh>jÈDhT]råDh]XCabalræD…rçD}rèD(h=XCabalh>jâDubahFhžubh]X package, use réD…rêD}rëD(h=X package, use hDNhRNhShh>jÈDubh–)rìD}ríD(h=X``Cabal:package-tests``hH}rîD(hJ]hK]hL]hM]hP]uh>jÈDhT]rïDh]XCabal:package-testsrðD…rñD}ròD(h=XCabal:package-testsh>jìDubahFhžubh]X.…róD}rôD(h=X.hDNhRNhShh>jÈDubeubhp)rõD}röD(h=X¥Unlike sandboxes, there is no need to setup a sandbox or ``add-source`` projects; just check in ``cabal.project`` to your repository and ``v2-build`` will just work.h>jDhDhEhFhthH}r÷D(hJ]hK]hL]hM]hP]uhRKRhShhT]røD(h]X9Unlike sandboxes, there is no need to setup a sandbox or rùD…rúD}rûD(h=X9Unlike sandboxes, there is no need to setup a sandbox or hDNhRNhShh>jõDubh–)rüD}rýD(h=X``add-source``hH}rþD(hJ]hK]hL]hM]hP]uh>jõDhT]rÿDh]X add-sourcerE…rE}rE(h=X add-sourceh>jüDubahFhžubh]X projects; just check in rE…rE}rE(h=X projects; just check in hDNhRNhShh>jõDubh–)rE}rE(h=X``cabal.project``hH}rE(hJ]hK]hL]hM]hP]uh>jõDhT]r Eh]X cabal.projectr E…r E}r E(h=X cabal.projecth>jEubahFhžubh]X to your repository and r E…rE}rE(h=X to your repository and hDNhRNhShh>jõDubh–)rE}rE(h=X ``v2-build``hH}rE(hJ]hK]hL]hM]hP]uh>jõDhT]rEh]Xv2-buildrE…rE}rE(h=Xv2-buildh>jEubahFhžubh]X will just work.rE…rE}rE(h=X will just work.hDNhRNhShh>jõDubeubeubeubh?)rE}rE(h=Uh>hhDhEhFhGhH}rE(hJ]hK]hL]hM]rEjÉCahP]rEh5auhRKWhShhT]rE(hV)r E}r!E(h=XCookbookr"Eh>jEhDhEhFhZhH}r#E(hJ]hK]hL]hM]hP]uhRKWhShhT]r$Eh]XCookbookr%E…r&E}r'E(h=j"EhDNhRNhShh>j Eubaubh?)r(E}r)E(h=Uh>jEhDhEhFhGhH}r*E(hJ]hK]hL]hM]r+EjÆCahP]r,EhauhRKZhShhT]r-E(hV)r.E}r/E(h=X)How can I profile my library/application?r0Eh>j(EhDhEhFhZhH}r1E(hJ]hK]hL]hM]hP]uhRKZhShhT]r2Eh]X)How can I profile my library/application?r3E…r4E}r5E(h=j0EhDNhRNhShh>j.Eubaubhp)r6E}r7E(h=XHCreate or edit your ``cabal.project.local``, adding the following line::h>j(EhDhEhFhthH}r8E(hJ]hK]hL]hM]hP]uhRK\hShhT]r9E(h]XCreate or edit your r:E…r;E}rj6Eubh–)r=E}r>E(h=X``cabal.project.local``hH}r?E(hJ]hK]hL]hM]hP]uh>j6EhT]r@Eh]Xcabal.project.localrAE…rBE}rCE(h=Xcabal.project.localh>j=EubahFhžubh]X, adding the following line:rDE…rEE}rFE(h=X, adding the following line:hDNhRNhShh>j6Eubeubj)rGE}rHE(h=Xprofiling: Trueh>j(EhDhEhFjhH}rIE(jjhM]hL]hJ]hK]hP]uhRK_hShhT]rJEh]Xprofiling: TruerKE…rLE}rME(h=Uh>jGEubaubhp)rNE}rOE(h=X¿Now, ``cabal v2-build`` will automatically build all libraries and executables with profiling. You can fine-tune the profiling settings for each package using :cfg-field:`profiling-detail`::h>j(EhDhEhFhthH}rPE(hJ]hK]hL]hM]hP]uhRKahShhT]rQE(h]XNow, rRE…rSE}rTE(h=XNow, hDNhRNhShh>jNEubh–)rUE}rVE(h=X``cabal v2-build``hH}rWE(hJ]hK]hL]hM]hP]uh>jNEhT]rXEh]Xcabal v2-buildrYE…rZE}r[E(h=Xcabal v2-buildh>jUEubahFhžubh]X‰ will automatically build all libraries and executables with profiling. You can fine-tune the profiling settings for each package using r\E…r]E}r^E(h=X‰ will automatically build all libraries and executables with profiling. You can fine-tune the profiling settings for each package using hDNhRNhShh>jNEubjä)r_E}r`E(h=X:cfg-field:`profiling-detail`h>jNEhDhEhFjçhH}raE(UreftypeX cfg-fieldjéˆjêXprofiling-detailrbEU refdomainXcabalrcEhM]hL]U refexplicit‰hJ]hK]hP]jìjíj’NuhRKahT]rdEh–)reE}rfE(h=jbEhH}rgE(hJ]hK]rhE(jôjcEXcabal-cfg-fieldriEehL]hM]hP]uh>j_EhT]rjEh]Xprofiling-detailrkE…rlE}rmE(h=Uh>jeEubahFhžubaubh]X:…rnE}roE(h=X:hDNhRNhShh>jNEubeubj)rpE}rqE(h=X2package p profiling-detail: toplevel-functionsh>j(EhDhEhFjhH}rrE(jjhM]hL]hJ]hK]hP]uhRKehShhT]rsEh]X2package p profiling-detail: toplevel-functionsrtE…ruE}rvE(h=Uh>jpEubaubhp)rwE}rxE(h=XdAlternately, you can call ``cabal v2-build --enable-profiling`` to temporarily build with profiling.h>j(EhDhEhFhthH}ryE(hJ]hK]hL]hM]hP]uhRKhhShhT]rzE(h]XAlternately, you can call r{E…r|E}r}E(h=XAlternately, you can call hDNhRNhShh>jwEubh–)r~E}rE(h=X%``cabal v2-build --enable-profiling``hH}r€E(hJ]hK]hL]hM]hP]uh>jwEhT]rEh]X!cabal v2-build --enable-profilingr‚E…rƒE}r„E(h=X!cabal v2-build --enable-profilingh>j~EubahFhžubh]X% to temporarily build with profiling.r…E…r†E}r‡E(h=X% to temporarily build with profiling.hDNhRNhShh>jwEubeubeubeubhBjojh eh=UU transformerrˆENU footnote_refsr‰E}rŠEUrefnamesr‹E}rŒE(Xhscolour]rE(jBjZBeXabnf]rŽEjÎaXhoogle]rEjD>auUsymbol_footnotesrE]r‘EUautofootnote_refsr’E]r“EUsymbol_footnote_refsr”E]r•EU citationsr–E]r—EhShU current_liner˜ENUtransform_messagesr™E]ršE(h:)r›E}rœE(h=UhH}rE(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMUtypej\uhT]ržEhp)rŸE}r E(h=UhH}r¡E(hJ]hK]hL]hM]hP]uh>j›EhT]r¢Eh]X-Hyperlink target "index-0" is not referenced.r£E…r¤E}r¥E(h=Uh>jŸEubahFhtubahFjZubh:)r¦E}r§E(h=UhH}r¨E(hJ]UlevelKhM]hL]UsourcehEhK]hP]Utypej\uhT]r©Ehp)rªE}r«E(h=UhH}r¬E(hJ]hK]hL]hM]hP]uh>j¦EhT]r­Eh]X-Hyperlink target "index-1" is not referenced.r®E…r¯E}r°E(h=Uh>jªEubahFhtubahFjZubh:)r±E}r²E(h=UhH}r³E(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineMsUtypej\uhT]r´Ehp)rµE}r¶E(h=UhH}r·E(hJ]hK]hL]hM]hP]uh>j±EhT]r¸Eh]X<Hyperlink target "cmdoption-project-file" is not referenced.r¹E…rºE}r»E(h=Uh>jµEubahFhtubahFjZubh:)r¼E}r½E(h=UhH}r¾E(hJ]UlevelKhM]hL]UsourcehEhK]hP]UlineM¥Utypej\uhT]r¿Ehp)rÀE}rÁE(h=UhH}rÂE(hJ]hK]hL]hM]hP]uh>j¼EhT]rÃEh]X-Hyperlink target "index-2" is not referenced.rÄE…rÅE}rÆE(h=Uh>jÀEubahFhtubahFjZubh:)rÇE}rÈE(h=UhH}rÉE(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineMuUtypej\uhT]rÊEhp)rËE}rÌE(h=UhH}rÍE(hJ]hK]hL]hM]hP]uh>jÇEhT]rÎEh]X?Hyperlink target "package-versioning-policy" is not referenced.rÏE…rÐE}rÑE(h=Uh>jËEubahFhtubahFjZubh:)rÒE}rÓE(h=UhH}rÔE(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineMvUtypej\uhT]rÕEhp)rÖE}r×E(h=UhH}rØE(hJ]hK]hL]hM]hP]uh>jÒEhT]rÙEh]X)Hyperlink target "pvp" is not referenced.rÚE…rÛE}rÜE(h=Uh>jÖEubahFhtubahFjZubh:)rÝE}rÞE(h=UhH}rßE(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineMxUtypej\uhT]ràEhp)ráE}râE(h=UhH}rãE(hJ]hK]hL]hM]hP]uh>jÝEhT]räEh]X-Hyperlink target "hackage" is not referenced.råE…ræE}rçE(h=Uh>jáEubahFhtubahFjZubh:)rèE}réE(h=UhH}rêE(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineMzUtypej\uhT]rëEhp)rìE}ríE(h=UhH}rîE(hJ]hK]hL]hM]hP]uh>jèEhT]rïEh]X-Hyperlink target "haskell" is not referenced.rðE…rñE}ròE(h=Uh>jìEubahFhtubahFjZubh:)róE}rôE(h=UhH}rõE(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineM|Utypej\uhT]röEhp)r÷E}røE(h=UhH}rùE(hJ]hK]hL]hM]hP]uh>jóEhT]rúEh]X-Hyperlink target "haddock" is not referenced.rûE…rüE}rýE(h=Uh>j÷EubahFhtubahFjZubh:)rþE}rÿE(h=UhH}rF(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineM~Utypej\uhT]rFhp)rF}rF(h=UhH}rF(hJ]hK]hL]hM]hP]uh>jþEhT]rFh]X*Hyperlink target "alex" is not referenced.rF…rF}rF(h=Uh>jFubahFhtubahFjZubh:)r F}r F(h=UhH}r F(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineM€Utypej\uhT]r Fhp)r F}rF(h=UhH}rF(hJ]hK]hL]hM]hP]uh>j FhT]rFh]X+Hyperlink target "happy" is not referenced.rF…rF}rF(h=Uh>j FubahFhtubahFjZubh:)rF}rF(h=UhH}rF(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineM†Utypej\uhT]rFhp)rF}rF(h=UhH}rF(hJ]hK]hL]hM]hP]uh>jFhT]rFh]X+Hyperlink target "cpphs" is not referenced.rF…rF}rF(h=Uh>jFubahFhtubahFjZubh:)rF}r F(h=UhH}r!F(hJ]UlevelKhM]hL]Usourcej¥"hK]hP]UlineMŠUtypej\uhT]r"Fhp)r#F}r$F(h=UhH}r%F(hJ]hK]hL]hM]hP]uh>jFhT]r&Fh]X.Hyperlink target "backpack" is not referenced.r'F…r(F}r)F(h=Uh>j#FubahFhtubahFjZubeUreporterr*FNUid_startr+FKU autofootnotesr,F]r-FU citation_refsr.F}r/FUindirect_targetsr0F]r1FUsettingsr2F(cdocutils.frontend Values r3For4F}r5F(Ufootnote_backlinksr6FKUrecord_dependenciesr7FNU language_coder8FUenr9FU tracebackr:FˆUpep_referencesr;FNUstrip_commentsrFU rfc_base_urlr?FUhttps://tools.ietf.org/html/r@FU datestamprAFNU report_levelrBFKUsmartquotes_localesrCF]rDFU _destinationrEFNU halt_levelrFFKU strip_classesrGFNhZNUerror_encoding_error_handlerrHFUbackslashreplacerIFUdebugrJFNUembed_stylesheetrKF‰Uoutput_encoding_error_handlerrLFUstrictrMFU sectnum_xformrNFKUdump_transformsrOFNU docinfo_xformrPFKUwarning_streamrQFNUpep_file_url_templaterRFUpep-%04drSFUexit_status_levelrTFKUconfigrUFNUstrict_visitorrVFNUcloak_email_addressesrWFˆUtrim_footnote_reference_spacerXF‰UenvrYFNUdump_pseudo_xmlrZFNUexpose_internalsr[FNUsectsubtitle_xformr\F‰U source_linkr]FNUrfc_referencesr^FNUoutput_encodingr_FUutf-8r`FU source_urlraFNUinput_encodingrbFU utf-8-sigrcFU_disable_configrdFNU id_prefixreFUUcharacter_level_inline_markuprfF‰U tab_widthrgFKUerror_encodingrhFUUTF-8riFU_sourcerjFhEU generatorrkFNUdump_internalsrlFNU smart_quotesrmFˆU pep_base_urlrnFU https://www.python.org/dev/peps/roFUsyntax_highlightrpFUlongrqFUinput_encoding_error_handlerrrFjMFUauto_id_prefixrsFUidrtFUdoctitle_xformruF‰Ustrip_elements_with_classesrvFNU _config_filesrwF]Ufile_insertion_enabledrxFˆU raw_enabledryFKU dump_settingsrzFNubUsymbol_footnote_startr{FKUidsr|F}r}F(jnAjjAjäjàjjjœ)j—)j4j4jª-j¦-j}jyjS2jN2j½"j¹"j:j6j«j§jc,j^,j·'j³'jŒjˆjljhj\jXj3!j.!jõ"jñ"jM"jI"jéjåjÅ;jÁ;j‘jjš@j–@j´jµj"&j&jšj–jÌ-jÇ-j**j&*j<jû;jj‰j{.jw.jJ,jE,jN;jI;j_jfjú$jö$j(j$jQjMj²j®j‰ j„ jè&jã&jÏ"jË"j/j+j(,j$,j&-j!-jù"jf jé"jå"j3(j/(j 1j1j0j0jë,jç,j6j6j¶"j±"jøjôjˆ8j„8j•+j+jÜ2jØ2j%j%j|jxjëjçjã"jÞ"jÌjÈj¶.j±.jjj«!j¦!jP:jL:jwjrjßjæjØ'jÔ'jjjl jh jC%jF%j»<j¶<j -j-jƒ)j~)jJ jF jC&j?&j­j©hehajå-jà-jƒ1j1j9j4j°"j±"j­&j©&jz+jv+jæjâjÃ*j¾*j»j·j'5j#5j¯9jª9jô>jð>jPjLjùjõj¢ j jøjôj¨j¤j¬=j¨=j40j00j$j jú2jõ2jÎjÊjÙjÕjë#jç#j‰3j„3j±j­jmjijOh@j‰!j…!j¡*j*jÃ"j¿"jjj\?jX?jÜ"j×"j>jþ=jÜBjØBjÈ9jÃ9jo/jk/jvjrj12j-2jŠj†jn"jj"jï"jë"jÊ#jÆ#j/j+jN/jJ/jÄ!j¿!j74j24jl jmjg3jc3jr:jm:jÃj¿jÕ"jÑ"j‹=j‡=jJjFjl2jg2j>j:jsjojjj-7j)7jÛ(jÖ(j<j8j5;j0;j¾AjºAjB j= jN7jJ7j)j%j2Bj.Bj‹:j†:j9j9j¨5j¤5j.j˜.j-9j(9j{jwjŒBjˆBj¬j¨jÉ"jÅ"j¢3j3j‡jŽjøjójç;jâ;jÆCj(EjÇCjÎCjÏ&jÊ&j4jŒ4j¥1j 1jÅjÁjY6jT6jü3jø3jô(jï(jè0jä0j‡5jƒ5j@6j;6jäjàj j j9j‰9jŠ>j†>ja)j])j±4j­4j jj *j*jT(jP(jÃj¿jÈCjDj0@j,@jÖjÒj;j;jÆ?jÂ?jH5jD5j;j7jAjAjg8jc8j#1j1jÒjÎj™<j•<j– j’ jÔ<jÏ<j¹(jµ(jg jc j—j“j!j!j^jYjY+jU+jMjHjò8jî8jj™jø jô j¾1j¹1jÛj×j\jXj3j/j’jŽhOhBjÉCjEj<j8uUsubstitution_namesr~F}rFhFhShH}r€F(hJ]hM]hL]UsourcehEhK]hP]uU footnotesrF]r‚FUrefidsrƒF}r„F(j°"]r…Fj­"aj]r†Fjþaj´]r‡Fj±auub.